1 /* 2 * Copyright (C) 2011 Google Inc. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions are 6 * met: 7 * 8 * * Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * * Redistributions in binary form must reproduce the above 11 * copyright notice, this list of conditions and the following disclaimer 12 * in the documentation and/or other materials provided with the 13 * distribution. 14 * * Neither the name of Google Inc. nor the names of its 15 * contributors may be used to endorse or promote products derived from 16 * this software without specific prior written permission. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 19 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 20 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 21 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 22 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 23 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 24 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 25 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 26 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 27 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 28 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 29 */ 30 31 #ifndef WebMediaStreamSource_h 32 #define WebMediaStreamSource_h 33 34 #include "WebCommon.h" 35 #include "WebNonCopyable.h" 36 #include "WebPrivatePtr.h" 37 #include "WebVector.h" 38 39 namespace WebCore { 40 class MediaStreamSource; 41 } 42 43 namespace blink { 44 class WebAudioDestinationConsumer; 45 class WebMediaConstraints; 46 class WebString; 47 48 class WebMediaStreamSource { 49 public: 50 class ExtraData { 51 public: ExtraData()52 ExtraData() : m_owner(0) { } ~ExtraData()53 virtual ~ExtraData() { } 54 55 BLINK_PLATFORM_EXPORT WebMediaStreamSource owner(); 56 57 #if INSIDE_BLINK 58 BLINK_PLATFORM_EXPORT void setOwner(WebCore::MediaStreamSource*); 59 #endif 60 61 private: 62 WebCore::MediaStreamSource* m_owner; 63 }; 64 65 enum Type { 66 TypeAudio, 67 TypeVideo 68 }; 69 70 enum ReadyState { 71 ReadyStateLive = 0, 72 ReadyStateMuted = 1, 73 ReadyStateEnded = 2 74 }; 75 WebMediaStreamSource()76 WebMediaStreamSource() { } WebMediaStreamSource(const WebMediaStreamSource & other)77 WebMediaStreamSource(const WebMediaStreamSource& other) { assign(other); } ~WebMediaStreamSource()78 ~WebMediaStreamSource() { reset(); } 79 80 WebMediaStreamSource& operator=(const WebMediaStreamSource& other) 81 { 82 assign(other); 83 return *this; 84 } 85 86 BLINK_PLATFORM_EXPORT void assign(const WebMediaStreamSource&); 87 88 BLINK_PLATFORM_EXPORT void initialize(const WebString& id, Type, const WebString& name); 89 BLINK_PLATFORM_EXPORT void reset(); isNull()90 bool isNull() const { return m_private.isNull(); } 91 92 BLINK_PLATFORM_EXPORT WebString id() const; 93 BLINK_PLATFORM_EXPORT Type type() const; 94 BLINK_PLATFORM_EXPORT WebString name() const; 95 96 BLINK_PLATFORM_EXPORT void setReadyState(ReadyState); 97 BLINK_PLATFORM_EXPORT ReadyState readyState() const; 98 99 // Extra data associated with this object. 100 // If non-null, the extra data pointer will be deleted when the object is destroyed. 101 // Setting the extra data pointer will cause any existing non-null 102 // extra data pointer to be deleted. 103 BLINK_PLATFORM_EXPORT ExtraData* extraData() const; 104 BLINK_PLATFORM_EXPORT void setExtraData(ExtraData*); 105 106 BLINK_PLATFORM_EXPORT WebMediaConstraints constraints(); 107 108 // Only used if if this is a WebAudio source. 109 // The WebAudioDestinationConsumer is not owned, and has to be disposed of separately 110 // after calling removeAudioConsumer. 111 BLINK_PLATFORM_EXPORT bool requiresAudioConsumer() const; 112 BLINK_PLATFORM_EXPORT void addAudioConsumer(WebAudioDestinationConsumer*); 113 BLINK_PLATFORM_EXPORT bool removeAudioConsumer(WebAudioDestinationConsumer*); 114 115 #if INSIDE_BLINK 116 BLINK_PLATFORM_EXPORT WebMediaStreamSource(const WTF::PassRefPtr<WebCore::MediaStreamSource>&); 117 BLINK_PLATFORM_EXPORT WebMediaStreamSource& operator=(WebCore::MediaStreamSource*); 118 BLINK_PLATFORM_EXPORT operator WTF::PassRefPtr<WebCore::MediaStreamSource>() const; 119 BLINK_PLATFORM_EXPORT operator WebCore::MediaStreamSource*() const; 120 #endif 121 122 private: 123 WebPrivatePtr<WebCore::MediaStreamSource> m_private; 124 }; 125 126 } // namespace blink 127 128 #endif // WebMediaStreamSource_h 129