/* * Copyright (C) 2011 Google Inc. All rights reserved. * Copyright (C) 2011, 2015 Ericsson AB. All rights reserved. * Copyright (C) 2013-2015 Apple Inc. All rights reserved. * Copyright (C) 2013 Nokia Corporation and/or its subsidiary(-ies). * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND ANY * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ #ifndef MediaStream_h #define MediaStream_h #if ENABLE(MEDIA_STREAM) #include "ContextDestructionObserver.h" #include "EventTarget.h" #include "ExceptionBase.h" #include "MediaStreamPrivate.h" #include "MediaStreamTrack.h" #include "ScriptWrappable.h" #include "Timer.h" #include "URLRegistry.h" #include #include #include namespace WebCore { class MediaStream final : public URLRegistrable, public EventTargetWithInlineData, public ContextDestructionObserver, public MediaStreamTrack::Observer, public MediaStreamPrivate::Observer, public RefCounted { public: class Observer { public: virtual ~Observer() { } virtual void didAddOrRemoveTrack() = 0; }; static Ref create(ScriptExecutionContext&); static Ref create(ScriptExecutionContext&, MediaStream*); static Ref create(ScriptExecutionContext&, const MediaStreamTrackVector&); static Ref create(ScriptExecutionContext&, RefPtr&&); virtual ~MediaStream(); String id() const { return m_private->id(); } void addTrack(RefPtr&&); void removeTrack(MediaStreamTrack*); MediaStreamTrack* getTrackById(String); MediaStreamTrackVector getAudioTracks() const; MediaStreamTrackVector getVideoTracks() const; MediaStreamTrackVector getTracks() const; RefPtr clone(); bool active() const { return m_isActive; } MediaStreamPrivate* privateStream() const { return m_private.get(); } // EventTarget virtual EventTargetInterface eventTargetInterface() const final { return MediaStreamEventTargetInterfaceType; } virtual ScriptExecutionContext* scriptExecutionContext() const final { return ContextDestructionObserver::scriptExecutionContext(); } using RefCounted::ref; using RefCounted::deref; // URLRegistrable virtual URLRegistry& registry() const override; void addObserver(Observer*); void removeObserver(Observer*); protected: MediaStream(ScriptExecutionContext&, const MediaStreamTrackVector&); MediaStream(ScriptExecutionContext&, RefPtr&&); // ContextDestructionObserver virtual void contextDestroyed() override final; private: enum class StreamModifier { DomAPI, Platform }; // EventTarget virtual void refEventTarget() override final { ref(); } virtual void derefEventTarget() override final { deref(); } // MediaStreamTrack::Observer virtual void trackDidEnd() override final; // MediaStreamPrivate::Observer virtual void activeStatusChanged() override final; virtual void didAddTrack(MediaStreamTrackPrivate&) override final; virtual void didRemoveTrack(MediaStreamTrackPrivate&) override final; bool internalAddTrack(RefPtr&&, StreamModifier); bool internalRemoveTrack(RefPtr&&, StreamModifier); void scheduleActiveStateChange(); void activityEventTimerFired(); void setIsActive(bool); MediaStreamTrackVector trackVectorForType(RealtimeMediaSource::Type) const; RefPtr m_private; bool m_isActive; HashMap> m_trackSet; Timer m_activityEventTimer; Vector> m_scheduledActivityEvents; Vector m_observers; }; } // namespace WebCore #endif // ENABLE(MEDIA_STREAM) #endif // MediaStream_h