1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
/*
* Copyright (C) 2011 Ericsson AB. All rights reserved.
* Copyright (C) 2013 Google Inc. All rights reserved.
*
* 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.
* 3. Neither the name of Ericsson nor the names of its contributors
* may be used to endorse or promote products derived from this
* software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND 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 THE COPYRIGHT
* OWNER OR 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 THIRD_PARTY_BLINK_RENDERER_PLATFORM_MEDIASTREAM_MEDIA_STREAM_COMPONENT_H_
#define THIRD_PARTY_BLINK_RENDERER_PLATFORM_MEDIASTREAM_MEDIA_STREAM_COMPONENT_H_
#include "third_party/blink/public/platform/modules/mediastream/web_media_stream_sink.h"
#include "third_party/blink/public/platform/modules/mediastream/web_media_stream_track.h"
#include "third_party/blink/public/web/modules/mediastream/media_stream_video_sink.h"
#include "third_party/blink/renderer/platform/audio/audio_source_provider.h"
#include "third_party/blink/renderer/platform/heap/collection_support/heap_vector.h"
#include "third_party/blink/renderer/platform/heap/garbage_collected.h"
#include "third_party/blink/renderer/platform/heap/prefinalizer.h"
#include "third_party/blink/renderer/platform/mediastream/media_stream_source.h"
#include "third_party/blink/renderer/platform/mediastream/media_stream_track_platform.h"
#include "third_party/blink/renderer/platform/wtf/text/wtf_string.h"
namespace blink {
class MediaStreamSource;
class WebLocalFrame;
// A MediaStreamComponent is a MediaStreamTrack.
// TODO(hta): Consider merging the two classes.
class PLATFORM_EXPORT MediaStreamComponent : public GarbageCollectedMixin {
public:
virtual MediaStreamComponent* Clone() const = 0;
virtual MediaStreamSource* Source() const = 0;
// This is the same as the id of the |MediaStreamTrack|. It is unique in most
// contexts but collisions can occur e.g. if tracks are created by different
// |RTCPeerConnection|s or a remote track ID is signaled to be added, removed
// and then re-added resulting in a new track object the second time around.
virtual String Id() const = 0;
// Uniquely identifies this component.
virtual int UniqueId() const = 0;
virtual MediaStreamSource::StreamType GetSourceType() const = 0;
virtual const String& GetSourceName() const = 0;
virtual MediaStreamSource::ReadyState GetReadyState() const = 0;
virtual bool Remote() const = 0;
virtual bool Enabled() const = 0;
virtual void SetEnabled(bool enabled) = 0;
virtual WebMediaStreamTrack::ContentHintType ContentHint() = 0;
virtual void SetContentHint(WebMediaStreamTrack::ContentHintType) = 0;
virtual MediaStreamTrackPlatform* GetPlatformTrack() const = 0;
// Add an audio sink to the underlying platform track. This function must only
// be called if the component has an audio platform track. It will trigger a
// OnSetFormat() call on the |sink| before the first chunk of audio is
// delivered.
// TODO(crbug.com/1354563) Create separate MSC types for audio and video
virtual void AddSink(WebMediaStreamAudioSink* sink) = 0;
// Add a video sink to the underlying platform track. This function must only
// be called if the component has a video platform track. The |sink| will
// receive video track state changes on the main render thread and video
// frames in the |callback| method on the IO-thread. |callback| will be reset
// on the render thread.
// TODO(crbug.com/1354563) Create separate MSC types for audio and video
virtual void AddSink(WebMediaStreamSink* sink,
const VideoCaptureDeliverFrameCB& callback,
MediaStreamVideoSink::IsSecure is_secure,
MediaStreamVideoSink::UsesAlpha uses_alpha) = 0;
virtual void GetSettings(MediaStreamTrackPlatform::Settings&) = 0;
virtual MediaStreamTrackPlatform::CaptureHandle GetCaptureHandle() = 0;
virtual WebLocalFrame* CreationFrame() = 0;
virtual void SetCreationFrameGetter(
base::RepeatingCallback<WebLocalFrame*()>) = 0;
virtual void AddSourceObserver(MediaStreamSource::Observer*) = 0;
virtual String ToString() const = 0;
};
class PLATFORM_EXPORT MediaStreamComponents final
: public GarbageCollected<MediaStreamComponents> {
public:
// At least one of audio_track / video_track must be non-null.
MediaStreamComponents(MediaStreamComponent* audio_track,
MediaStreamComponent* video_track);
void Trace(Visitor*) const;
Member<MediaStreamComponent> audio_track_;
Member<MediaStreamComponent> video_track_;
};
using MediaStreamComponentVector = HeapVector<Member<MediaStreamComponent>>;
using MediaStreamsComponentsVector = HeapVector<Member<MediaStreamComponents>>;
} // namespace blink
#endif // THIRD_PARTY_BLINK_RENDERER_PLATFORM_MEDIASTREAM_MEDIA_STREAM_COMPONENT_H_
|
