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
|
// Copyright (c) 2012 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CONTENT_COMMON_MEDIA_MEDIA_STREAM_OPTIONS_H_
#define CONTENT_COMMON_MEDIA_MEDIA_STREAM_OPTIONS_H_
#include <string>
#include <vector>
#include "content/common/content_export.h"
#include "content/public/common/media_stream_request.h"
namespace content {
// MediaStreamConstraint keys for constraints that are passed to getUserMedia.
CONTENT_EXPORT extern const char kMediaStreamSource[];
CONTENT_EXPORT extern const char kMediaStreamSourceId[];
CONTENT_EXPORT extern const char kMediaStreamSourceInfoId[];
CONTENT_EXPORT extern const char kMediaStreamSourceTab[];
CONTENT_EXPORT extern const char kMediaStreamSourceScreen[];
CONTENT_EXPORT extern const char kMediaStreamSourceDesktop[];
CONTENT_EXPORT extern const char kMediaStreamSourceSystem[];
// Experimental constraint to do device matching. When this optional constraint
// is set, WebRTC audio renderer will render audio from media streams to an
// output device that belongs to the same hardware as the requested source
// device belongs to.
CONTENT_EXPORT extern const char kMediaStreamRenderToAssociatedSink[];
// Controls whether ducking of audio is enabled on platforms that support it.
CONTENT_EXPORT extern const char kMediaStreamAudioDucking[];
// StreamOptions is a Chromium representation of constraints
// used in WebUserMediaRequest.
// It describes properties requested by JS in a request for a new
// media stream.
class CONTENT_EXPORT StreamOptions {
public:
StreamOptions();
StreamOptions(bool request_audio, bool request_video);
~StreamOptions();
struct CONTENT_EXPORT Constraint {
Constraint();
Constraint(const std::string& name,
const std::string& value);
std::string name;
std::string value;
};
typedef std::vector<Constraint> Constraints;
bool audio_requested;
Constraints mandatory_audio;
Constraints optional_audio;
bool video_requested;
Constraints mandatory_video;
Constraints optional_video;
// Fetches |value| from the first audio constraint with a name that matches
// |name| from |mandatory_audio| and |optional_audio|. First mandatory
// constraints are searched, then optional.
// |is_mandatory| may be NULL but if it is provided, it is set
// to true if the found constraint is mandatory.
// Returns false if no constraint is found.
bool GetFirstAudioConstraintByName(const std::string& name,
std::string* value,
bool* is_mandatory) const;
// Fetches |value| from the first video constraint with a name that matches
// |name| from |mandatory_video| and |optional_video|. First mandatory
// constraints are searched, then optional.
// |is_mandatory| may be NULL but if it is provided, it is set
// to true if the found constraint is mandatory.
// Returns false if no constraint is found.
bool GetFirstVideoConstraintByName(const std::string& name,
std::string* value,
bool* is_mandatory) const;
// Fetches |values| from all constraint with a name that matches |name|
// from |constraints|.
static void GetConstraintsByName(
const StreamOptions::Constraints& constraints,
const std::string& name,
std::vector<std::string>* values);
};
// StreamDeviceInfo describes information about a device.
struct CONTENT_EXPORT StreamDeviceInfo {
static const int kNoId;
StreamDeviceInfo();
StreamDeviceInfo(MediaStreamType service_param,
const std::string& name_param,
const std::string& device_param);
StreamDeviceInfo(MediaStreamType service_param,
const std::string& name_param,
const std::string& device_param,
int sample_rate,
int channel_layout,
int frames_per_buffer);
static bool IsEqual(const StreamDeviceInfo& first,
const StreamDeviceInfo& second);
MediaStreamDevice device;
// Id for this capture session. Unique for all sessions of the same type.
int session_id;
};
typedef std::vector<StreamDeviceInfo> StreamDeviceInfoArray;
} // namespace content
#endif // CONTENT_COMMON_MEDIA_MEDIA_STREAM_OPTIONS_H_
|
