Home | History | Annotate | Download | only in platform
      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 WebMediaStream_h
     26 #define WebMediaStream_h
     27 
     28 #include "WebCommon.h"
     29 #include "WebNonCopyable.h"
     30 #include "WebPrivatePtr.h"
     31 #include "WebVector.h"
     32 
     33 namespace blink {
     34 
     35 class MediaStreamDescriptor;
     36 class WebMediaStreamSource;
     37 class WebMediaStreamTrack;
     38 class WebString;
     39 
     40 class WebMediaStream {
     41 public:
     42     class ExtraData {
     43     public:
     44         virtual ~ExtraData() { }
     45     };
     46 
     47     WebMediaStream() { }
     48     WebMediaStream(const WebMediaStream& other) { assign(other); }
     49     ~WebMediaStream() { reset(); }
     50 
     51     WebMediaStream& operator=(const WebMediaStream& other)
     52     {
     53         assign(other);
     54         return *this;
     55     }
     56 
     57     BLINK_PLATFORM_EXPORT void assign(const WebMediaStream&);
     58 
     59     BLINK_PLATFORM_EXPORT void initialize(const WebVector<WebMediaStreamTrack>& audioTracks, const WebVector<WebMediaStreamTrack>& videoTracks);
     60     BLINK_PLATFORM_EXPORT void initialize(const WebString& label, const WebVector<WebMediaStreamTrack>& audioTracks, const WebVector<WebMediaStreamTrack>& videoTracks);
     61 
     62     BLINK_PLATFORM_EXPORT void reset();
     63     bool isNull() const { return m_private.isNull(); }
     64 
     65     BLINK_PLATFORM_EXPORT WebString id() const;
     66 
     67     BLINK_PLATFORM_EXPORT void audioTracks(WebVector<WebMediaStreamTrack>&) const;
     68     BLINK_PLATFORM_EXPORT void videoTracks(WebVector<WebMediaStreamTrack>&) const;
     69 
     70     BLINK_PLATFORM_EXPORT void addTrack(const WebMediaStreamTrack&);
     71     BLINK_PLATFORM_EXPORT void removeTrack(const WebMediaStreamTrack&);
     72 
     73     // Extra data associated with this WebMediaStream.
     74     // If non-null, the extra data pointer will be deleted when the object is destroyed.
     75     // Setting the extra data pointer will cause any existing non-null
     76     // extra data pointer to be deleted.
     77     BLINK_PLATFORM_EXPORT ExtraData* extraData() const;
     78     BLINK_PLATFORM_EXPORT void setExtraData(ExtraData*);
     79 
     80 #if INSIDE_BLINK
     81     BLINK_PLATFORM_EXPORT WebMediaStream(MediaStreamDescriptor*);
     82     BLINK_PLATFORM_EXPORT WebMediaStream(const WTF::PassRefPtr<MediaStreamDescriptor>&);
     83     BLINK_PLATFORM_EXPORT operator WTF::PassRefPtr<MediaStreamDescriptor>() const;
     84     BLINK_PLATFORM_EXPORT operator MediaStreamDescriptor*() const;
     85     BLINK_PLATFORM_EXPORT WebMediaStream& operator=(const WTF::PassRefPtr<MediaStreamDescriptor>&);
     86 #endif
     87 
     88 private:
     89     WebPrivatePtr<MediaStreamDescriptor> m_private;
     90 };
     91 
     92 } // namespace blink
     93 
     94 #endif // WebMediaStream_h
     95