1 /* 2 * Copyright (C) 2013 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 6 * are met: 7 * 1. Redistributions of source code must retain the above copyright 8 * notice, this list of conditions and the following disclaimer. 9 * 2. Redistributions in binary form must reproduce the above copyright 10 * notice, this list of conditions and the following disclaimer in the 11 * documentation and/or other materials provided with the distribution. 12 * 13 * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND ANY 14 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 15 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 16 * DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY 17 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 18 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 19 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON 20 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 21 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 22 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 23 */ 24 25 #ifndef WebMediaStreamTrack_h 26 #define WebMediaStreamTrack_h 27 28 #include "WebCommon.h" 29 #include "WebNonCopyable.h" 30 #include "WebPrivatePtr.h" 31 32 namespace blink { 33 34 class MediaStreamComponent; 35 class WebAudioSourceProvider; 36 class WebMediaStream; 37 class WebMediaStreamSource; 38 class WebString; 39 40 class WebMediaStreamTrack { 41 public: 42 class ExtraData { 43 public: ExtraData()44 ExtraData() : m_owner(0) { } ~ExtraData()45 virtual ~ExtraData() { } 46 47 BLINK_PLATFORM_EXPORT WebMediaStreamTrack owner(); 48 49 #if INSIDE_BLINK 50 BLINK_PLATFORM_EXPORT void setOwner(MediaStreamComponent*); 51 #endif 52 53 private: 54 MediaStreamComponent* m_owner; 55 }; 56 WebMediaStreamTrack()57 WebMediaStreamTrack() { } WebMediaStreamTrack(const WebMediaStreamTrack & other)58 WebMediaStreamTrack(const WebMediaStreamTrack& other) { assign(other); } ~WebMediaStreamTrack()59 ~WebMediaStreamTrack() { reset(); } 60 61 WebMediaStreamTrack& operator=(const WebMediaStreamTrack& other) 62 { 63 assign(other); 64 return *this; 65 } 66 BLINK_PLATFORM_EXPORT void assign(const WebMediaStreamTrack&); 67 68 BLINK_PLATFORM_EXPORT void initialize(const WebMediaStreamSource&); 69 BLINK_PLATFORM_EXPORT void initialize(const WebString& id, const WebMediaStreamSource&); 70 71 BLINK_PLATFORM_EXPORT void reset(); isNull()72 bool isNull() const { return m_private.isNull(); } 73 74 BLINK_PLATFORM_EXPORT WebString id() const; 75 76 BLINK_PLATFORM_EXPORT WebMediaStreamSource source() const; 77 BLINK_PLATFORM_EXPORT bool isEnabled() const; 78 79 // Extra data associated with this WebMediaStream. 80 // If non-null, the extra data pointer will be deleted when the object is destroyed. 81 // Setting the extra data pointer will cause any existing non-null 82 // extra data pointer to be deleted. 83 BLINK_PLATFORM_EXPORT ExtraData* extraData() const; 84 BLINK_PLATFORM_EXPORT void setExtraData(ExtraData*); 85 86 // The lifetime of the WebAudioSourceProvider should outlive the 87 // WebMediaStreamTrack, and clients are responsible for calling 88 // setSourceProvider(0) before the WebMediaStreamTrack is going away. 89 BLINK_PLATFORM_EXPORT void setSourceProvider(WebAudioSourceProvider*); 90 91 #if INSIDE_BLINK 92 BLINK_PLATFORM_EXPORT WebMediaStreamTrack(PassRefPtr<MediaStreamComponent>); 93 BLINK_PLATFORM_EXPORT WebMediaStreamTrack(MediaStreamComponent*); 94 BLINK_PLATFORM_EXPORT WebMediaStreamTrack& operator=(MediaStreamComponent*); 95 BLINK_PLATFORM_EXPORT operator WTF::PassRefPtr<MediaStreamComponent>() const; 96 BLINK_PLATFORM_EXPORT operator MediaStreamComponent*() const; 97 #endif 98 99 private: 100 WebPrivatePtr<MediaStreamComponent> m_private; 101 }; 102 103 } // namespace blink 104 105 #endif // WebMediaStreamTrack_h 106