/* * 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. */ #pragma once #if ENABLE(MEDIA_STREAM) #include "ContextDestructionObserver.h" #include "EventTarget.h" #include "ExceptionBase.h" #include "MediaCanStartListener.h" #include "MediaProducer.h" #include "MediaStreamPrivate.h" #include "MediaStreamTrack.h" #include "ScriptWrappable.h" #include "Timer.h" #include "URLRegistry.h" #include #include #include namespace WebCore { class Document; class MediaStream final : public URLRegistrable , public EventTargetWithInlineData , public ContextDestructionObserver , public MediaStreamTrack::Observer , public MediaStreamPrivate::Observer , private MediaProducer , private MediaCanStartListener , 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(MediaStreamTrack&); void removeTrack(MediaStreamTrack&); MediaStreamTrack* getTrackById(String); MediaStreamTrackVector getAudioTracks() const; MediaStreamTrackVector getVideoTracks() const; MediaStreamTrackVector getTracks() const; RefPtr clone(); bool active() const { return m_isActive; } bool muted() const { return m_isMuted; } MediaStreamPrivate* privateStream() const { return m_private.get(); } void startProducingData(); void stopProducingData(); // EventTarget EventTargetInterface eventTargetInterface() const final { return MediaStreamEventTargetInterfaceType; } ScriptExecutionContext* scriptExecutionContext() const final { return ContextDestructionObserver::scriptExecutionContext(); } using RefCounted::ref; using RefCounted::deref; // URLRegistrable URLRegistry& registry() const override; void addObserver(Observer*); void removeObserver(Observer*); protected: MediaStream(ScriptExecutionContext&, const MediaStreamTrackVector&); MediaStream(ScriptExecutionContext&, RefPtr&&); // ContextDestructionObserver void contextDestroyed() final; private: enum class StreamModifier { DomAPI, Platform }; // EventTarget void refEventTarget() final { ref(); } void derefEventTarget() final { deref(); } // MediaStreamTrack::Observer void trackDidEnd() final; // MediaStreamPrivate::Observer void activeStatusChanged() final; void didAddTrack(MediaStreamTrackPrivate&) final; void didRemoveTrack(MediaStreamTrackPrivate&) final; void characteristicsChanged() final; // MediaProducer void pageMutedStateDidChange() final; MediaProducer::MediaStateFlags mediaState() const final; // MediaCanStartListener void mediaCanStart(Document&) final; bool internalAddTrack(Ref&&, StreamModifier); bool internalRemoveTrack(const String&, StreamModifier); void scheduleActiveStateChange(); void activityEventTimerFired(); void setIsActive(bool); void statusDidChange(); Document* document() const; MediaStreamTrackVector trackVectorForType(RealtimeMediaSource::Type) const; RefPtr m_private; HashMap> m_trackSet; Timer m_activityEventTimer; Vector> m_scheduledActivityEvents; Vector m_observers; bool m_isActive { false }; bool m_isMuted { true }; bool m_externallyMuted { false }; bool m_isWaitingUntilMediaCanStart { false }; }; } // namespace WebCore #endif // ENABLE(MEDIA_STREAM)