henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 1 | /* |
kjellander | b24317b | 2016-02-10 07:54:43 -0800 | [diff] [blame] | 2 | * Copyright 2013 The WebRTC project authors. All Rights Reserved. |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 3 | * |
kjellander | b24317b | 2016-02-10 07:54:43 -0800 | [diff] [blame] | 4 | * Use of this source code is governed by a BSD-style license |
| 5 | * that can be found in the LICENSE file in the root of the source |
| 6 | * tree. An additional intellectual property rights grant can be found |
| 7 | * in the file PATENTS. All contributing project authors may |
| 8 | * be found in the AUTHORS file in the root of the source tree. |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 9 | */ |
| 10 | |
| 11 | // This file contains the interface for MediaConstraints, corresponding to |
| 12 | // the definition at |
| 13 | // http://www.w3.org/TR/mediacapture-streams/#mediastreamconstraints and also |
| 14 | // used in WebRTC: http://dev.w3.org/2011/webrtc/editor/webrtc.html#constraints. |
| 15 | |
hta | a2a49d9 | 2016-03-04 02:51:39 -0800 | [diff] [blame] | 16 | // This interface is being deprecated in Chrome, and may be removed |
| 17 | // from WebRTC too. |
| 18 | // https://bugs.chromium.org/p/webrtc/issues/detail?id=5617 |
| 19 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 20 | #ifndef API_MEDIACONSTRAINTSINTERFACE_H_ |
| 21 | #define API_MEDIACONSTRAINTSINTERFACE_H_ |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 22 | |
| 23 | #include <string> |
| 24 | #include <vector> |
| 25 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 26 | #include "api/optional.h" |
| 27 | #include "api/peerconnectioninterface.h" |
hta | a2a49d9 | 2016-03-04 02:51:39 -0800 | [diff] [blame] | 28 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 29 | namespace webrtc { |
| 30 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 31 | // Interface used for passing arguments about media constraints |
| 32 | // to the MediaStream and PeerConnection implementation. |
deadbeef | b10f32f | 2017-02-08 01:38:21 -0800 | [diff] [blame] | 33 | // |
| 34 | // Constraints may be either "mandatory", which means that unless satisfied, |
| 35 | // the method taking the constraints should fail, or "optional", which means |
| 36 | // they may not be satisfied.. |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 37 | class MediaConstraintsInterface { |
| 38 | public: |
| 39 | struct Constraint { |
| 40 | Constraint() {} |
| 41 | Constraint(const std::string& key, const std::string value) |
| 42 | : key(key), value(value) { |
| 43 | } |
| 44 | std::string key; |
| 45 | std::string value; |
| 46 | }; |
| 47 | |
| 48 | class Constraints : public std::vector<Constraint> { |
| 49 | public: |
| 50 | bool FindFirst(const std::string& key, std::string* value) const; |
| 51 | }; |
| 52 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 53 | // Constraint keys used by a local video source. |
| 54 | // Specified by draft-alvestrand-constraints-resolution-00b |
| 55 | static const char kMinAspectRatio[]; // minAspectRatio |
| 56 | static const char kMaxAspectRatio[]; // maxAspectRatio |
| 57 | static const char kMaxWidth[]; // maxWidth |
| 58 | static const char kMinWidth[]; // minWidth |
| 59 | static const char kMaxHeight[]; // maxHeight |
| 60 | static const char kMinHeight[]; // minHeight |
| 61 | static const char kMaxFrameRate[]; // maxFrameRate |
| 62 | static const char kMinFrameRate[]; // minFrameRate |
| 63 | |
| 64 | // Constraint keys used by a local audio source. |
tommi | 39b3100 | 2015-06-23 09:50:47 -0700 | [diff] [blame] | 65 | static const char kEchoCancellation[]; // echoCancellation |
| 66 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 67 | // These keys are google specific. |
Tommi | 70c7fe1 | 2015-06-15 09:14:03 +0200 | [diff] [blame] | 68 | static const char kGoogEchoCancellation[]; // googEchoCancellation |
| 69 | |
Henrik Lundin | 441f634 | 2015-06-09 16:03:13 +0200 | [diff] [blame] | 70 | static const char kExtendedFilterEchoCancellation[]; // googEchoCancellation2 |
Bjorn Volcker | bf395c1 | 2015-03-25 22:45:56 +0100 | [diff] [blame] | 71 | static const char kDAEchoCancellation[]; // googDAEchoCancellation |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 72 | static const char kAutoGainControl[]; // googAutoGainControl |
| 73 | static const char kExperimentalAutoGainControl[]; // googAutoGainControl2 |
| 74 | static const char kNoiseSuppression[]; // googNoiseSuppression |
sergeyu@chromium.org | 9cf037b | 2014-02-07 19:03:26 +0000 | [diff] [blame] | 75 | static const char kExperimentalNoiseSuppression[]; // googNoiseSuppression2 |
Alejandro Luebs | c9b0c26 | 2016-05-16 15:32:38 -0700 | [diff] [blame] | 76 | static const char kIntelligibilityEnhancer[]; // intelligibilityEnhancer |
peah | a3333bf | 2016-06-30 00:02:34 -0700 | [diff] [blame] | 77 | static const char kLevelControl[]; // levelControl |
aleloi | e33c5d9 | 2016-10-20 01:53:27 -0700 | [diff] [blame] | 78 | static const char |
| 79 | kLevelControlInitialPeakLevelDBFS[]; // levelControlInitialPeakLevelDBFS |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 80 | static const char kHighpassFilter[]; // googHighpassFilter |
sergeyu@chromium.org | a59696b | 2013-09-13 23:48:58 +0000 | [diff] [blame] | 81 | static const char kTypingNoiseDetection[]; // googTypingNoiseDetection |
wu@webrtc.org | 97077a3 | 2013-10-25 21:18:33 +0000 | [diff] [blame] | 82 | static const char kAudioMirroring[]; // googAudioMirroring |
minyue | ba41428 | 2016-12-11 02:17:52 -0800 | [diff] [blame] | 83 | static const char |
| 84 | kAudioNetworkAdaptorConfig[]; // goodAudioNetworkAdaptorConfig |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 85 | |
| 86 | // Google-specific constraint keys for a local video source |
| 87 | static const char kNoiseReduction[]; // googNoiseReduction |
henrike@webrtc.org | dce3feb | 2014-03-26 01:17:30 +0000 | [diff] [blame] | 88 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 89 | // Constraint keys for CreateOffer / CreateAnswer |
| 90 | // Specified by the W3C PeerConnection spec |
| 91 | static const char kOfferToReceiveVideo[]; // OfferToReceiveVideo |
| 92 | static const char kOfferToReceiveAudio[]; // OfferToReceiveAudio |
| 93 | static const char kVoiceActivityDetection[]; // VoiceActivityDetection |
| 94 | static const char kIceRestart[]; // IceRestart |
| 95 | // These keys are google specific. |
| 96 | static const char kUseRtpMux[]; // googUseRtpMUX |
| 97 | |
| 98 | // Constraints values. |
| 99 | static const char kValueTrue[]; // true |
| 100 | static const char kValueFalse[]; // false |
| 101 | |
wu@webrtc.org | 1481491 | 2014-04-02 23:25:15 +0000 | [diff] [blame] | 102 | // PeerConnection constraint keys. |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 103 | // Temporary pseudo-constraints used to enable DTLS-SRTP |
| 104 | static const char kEnableDtlsSrtp[]; // Enable DTLS-SRTP |
| 105 | // Temporary pseudo-constraints used to enable DataChannels |
| 106 | static const char kEnableRtpDataChannels[]; // Enable RTP DataChannels |
wu@webrtc.org | 1481491 | 2014-04-02 23:25:15 +0000 | [diff] [blame] | 107 | // Google-specific constraint keys. |
wu@webrtc.org | de30501 | 2013-10-31 15:40:38 +0000 | [diff] [blame] | 108 | // Temporary pseudo-constraint for enabling DSCP through JS. |
wu@webrtc.org | 1481491 | 2014-04-02 23:25:15 +0000 | [diff] [blame] | 109 | static const char kEnableDscp[]; // googDscp |
henrika@webrtc.org | aebb1ad | 2014-01-14 10:00:58 +0000 | [diff] [blame] | 110 | // Constraint to enable IPv6 through JS. |
wu@webrtc.org | 1481491 | 2014-04-02 23:25:15 +0000 | [diff] [blame] | 111 | static const char kEnableIPv6[]; // googIPv6 |
henrike@webrtc.org | 6e3dbc2 | 2014-03-25 17:09:47 +0000 | [diff] [blame] | 112 | // Temporary constraint to enable suspend below min bitrate feature. |
| 113 | static const char kEnableVideoSuspendBelowMinBitrate[]; |
wu@webrtc.org | 1481491 | 2014-04-02 23:25:15 +0000 | [diff] [blame] | 114 | // googSuspendBelowMinBitrate |
buildbot@webrtc.org | b4c7b09 | 2014-08-25 12:11:58 +0000 | [diff] [blame] | 115 | // Constraint to enable combined audio+video bandwidth estimation. |
| 116 | static const char kCombinedAudioVideoBwe[]; // googCombinedAudioVideoBwe |
wu@webrtc.org | 1481491 | 2014-04-02 23:25:15 +0000 | [diff] [blame] | 117 | static const char kScreencastMinBitrate[]; // googScreencastMinBitrate |
wu@webrtc.org | 1481491 | 2014-04-02 23:25:15 +0000 | [diff] [blame] | 118 | static const char kCpuOveruseDetection[]; // googCpuOveruseDetection |
buildbot@webrtc.org | 44a317a | 2014-06-17 07:49:15 +0000 | [diff] [blame] | 119 | static const char kPayloadPadding[]; // googPayloadPadding |
buildbot@webrtc.org | d27d9ae | 2014-06-19 01:56:46 +0000 | [diff] [blame] | 120 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 121 | // The prefix of internal-only constraints whose JS set values should be |
| 122 | // stripped by Chrome before passed down to Libjingle. |
| 123 | static const char kInternalConstraintPrefix[]; |
| 124 | |
Magnus Jedvert | 3ecdd0f | 2017-11-24 11:21:14 +0100 | [diff] [blame] | 125 | virtual ~MediaConstraintsInterface() = default; |
| 126 | |
| 127 | virtual const Constraints& GetMandatory() const = 0; |
| 128 | virtual const Constraints& GetOptional() const = 0; |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 129 | }; |
| 130 | |
| 131 | bool FindConstraint(const MediaConstraintsInterface* constraints, |
| 132 | const std::string& key, bool* value, |
| 133 | size_t* mandatory_constraints); |
| 134 | |
hta | a2a49d9 | 2016-03-04 02:51:39 -0800 | [diff] [blame] | 135 | bool FindConstraint(const MediaConstraintsInterface* constraints, |
| 136 | const std::string& key, |
| 137 | int* value, |
| 138 | size_t* mandatory_constraints); |
| 139 | |
| 140 | // Copy all relevant constraints into an RTCConfiguration object. |
| 141 | void CopyConstraintsIntoRtcConfiguration( |
| 142 | const MediaConstraintsInterface* constraints, |
| 143 | PeerConnectionInterface::RTCConfiguration* configuration); |
| 144 | |
deadbeef | fe0fd41 | 2017-01-13 11:47:56 -0800 | [diff] [blame] | 145 | // Copy all relevant constraints into an AudioOptions object. |
| 146 | void CopyConstraintsIntoAudioOptions( |
| 147 | const MediaConstraintsInterface* constraints, |
| 148 | cricket::AudioOptions* options); |
| 149 | |
henrike@webrtc.org | 28e2075 | 2013-07-10 00:45:36 +0000 | [diff] [blame] | 150 | } // namespace webrtc |
| 151 | |
Mirko Bonadei | 92ea95e | 2017-09-15 06:47:31 +0200 | [diff] [blame] | 152 | #endif // API_MEDIACONSTRAINTSINTERFACE_H_ |