| OLD | NEW |
| (Empty) |
| 1 /* | |
| 2 * libjingle | |
| 3 * Copyright 2013 Google Inc. | |
| 4 * | |
| 5 * Redistribution and use in source and binary forms, with or without | |
| 6 * modification, are permitted provided that the following conditions are met: | |
| 7 * | |
| 8 * 1. Redistributions of source code must retain the above copyright notice, | |
| 9 * this list of conditions and the following disclaimer. | |
| 10 * 2. Redistributions in binary form must reproduce the above copyright notice, | |
| 11 * this list of conditions and the following disclaimer in the documentation | |
| 12 * and/or other materials provided with the distribution. | |
| 13 * 3. The name of the author may not be used to endorse or promote products | |
| 14 * derived from this software without specific prior written permission. | |
| 15 * | |
| 16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED | |
| 17 * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF | |
| 18 * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO | |
| 19 * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, | |
| 20 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, | |
| 21 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; | |
| 22 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, | |
| 23 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR | |
| 24 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF | |
| 25 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
| 26 */ | |
| 27 | |
| 28 // This file contains the interface for MediaConstraints, corresponding to | |
| 29 // the definition at | |
| 30 // http://www.w3.org/TR/mediacapture-streams/#mediastreamconstraints and also | |
| 31 // used in WebRTC: http://dev.w3.org/2011/webrtc/editor/webrtc.html#constraints. | |
| 32 | |
| 33 #ifndef TALK_APP_WEBRTC_MEDIACONSTRAINTSINTERFACE_H_ | |
| 34 #define TALK_APP_WEBRTC_MEDIACONSTRAINTSINTERFACE_H_ | |
| 35 | |
| 36 #include <string> | |
| 37 #include <vector> | |
| 38 | |
| 39 namespace webrtc { | |
| 40 | |
| 41 // MediaConstraintsInterface | |
| 42 // Interface used for passing arguments about media constraints | |
| 43 // to the MediaStream and PeerConnection implementation. | |
| 44 class MediaConstraintsInterface { | |
| 45 public: | |
| 46 struct Constraint { | |
| 47 Constraint() {} | |
| 48 Constraint(const std::string& key, const std::string value) | |
| 49 : key(key), value(value) { | |
| 50 } | |
| 51 std::string key; | |
| 52 std::string value; | |
| 53 }; | |
| 54 | |
| 55 class Constraints : public std::vector<Constraint> { | |
| 56 public: | |
| 57 bool FindFirst(const std::string& key, std::string* value) const; | |
| 58 }; | |
| 59 | |
| 60 virtual const Constraints& GetMandatory() const = 0; | |
| 61 virtual const Constraints& GetOptional() const = 0; | |
| 62 | |
| 63 // Constraint keys used by a local video source. | |
| 64 // Specified by draft-alvestrand-constraints-resolution-00b | |
| 65 static const char kMinAspectRatio[]; // minAspectRatio | |
| 66 static const char kMaxAspectRatio[]; // maxAspectRatio | |
| 67 static const char kMaxWidth[]; // maxWidth | |
| 68 static const char kMinWidth[]; // minWidth | |
| 69 static const char kMaxHeight[]; // maxHeight | |
| 70 static const char kMinHeight[]; // minHeight | |
| 71 static const char kMaxFrameRate[]; // maxFrameRate | |
| 72 static const char kMinFrameRate[]; // minFrameRate | |
| 73 | |
| 74 // Constraint keys used by a local audio source. | |
| 75 static const char kEchoCancellation[]; // echoCancellation | |
| 76 | |
| 77 // These keys are google specific. | |
| 78 static const char kGoogEchoCancellation[]; // googEchoCancellation | |
| 79 | |
| 80 static const char kExtendedFilterEchoCancellation[]; // googEchoCancellation2 | |
| 81 static const char kDAEchoCancellation[]; // googDAEchoCancellation | |
| 82 static const char kAutoGainControl[]; // googAutoGainControl | |
| 83 static const char kExperimentalAutoGainControl[]; // googAutoGainControl2 | |
| 84 static const char kNoiseSuppression[]; // googNoiseSuppression | |
| 85 static const char kExperimentalNoiseSuppression[]; // googNoiseSuppression2 | |
| 86 static const char kHighpassFilter[]; // googHighpassFilter | |
| 87 static const char kTypingNoiseDetection[]; // googTypingNoiseDetection | |
| 88 static const char kAudioMirroring[]; // googAudioMirroring | |
| 89 static const char kAecDump[]; // audioDebugRecording | |
| 90 | |
| 91 // Google-specific constraint keys for a local video source | |
| 92 static const char kNoiseReduction[]; // googNoiseReduction | |
| 93 | |
| 94 // Constraint keys for CreateOffer / CreateAnswer | |
| 95 // Specified by the W3C PeerConnection spec | |
| 96 static const char kOfferToReceiveVideo[]; // OfferToReceiveVideo | |
| 97 static const char kOfferToReceiveAudio[]; // OfferToReceiveAudio | |
| 98 static const char kVoiceActivityDetection[]; // VoiceActivityDetection | |
| 99 static const char kIceRestart[]; // IceRestart | |
| 100 // These keys are google specific. | |
| 101 static const char kUseRtpMux[]; // googUseRtpMUX | |
| 102 | |
| 103 // Constraints values. | |
| 104 static const char kValueTrue[]; // true | |
| 105 static const char kValueFalse[]; // false | |
| 106 | |
| 107 // PeerConnection constraint keys. | |
| 108 // Temporary pseudo-constraints used to enable DTLS-SRTP | |
| 109 static const char kEnableDtlsSrtp[]; // Enable DTLS-SRTP | |
| 110 // Temporary pseudo-constraints used to enable DataChannels | |
| 111 static const char kEnableRtpDataChannels[]; // Enable RTP DataChannels | |
| 112 // Google-specific constraint keys. | |
| 113 // Temporary pseudo-constraint for enabling DSCP through JS. | |
| 114 static const char kEnableDscp[]; // googDscp | |
| 115 // Constraint to enable IPv6 through JS. | |
| 116 static const char kEnableIPv6[]; // googIPv6 | |
| 117 // Temporary constraint to enable suspend below min bitrate feature. | |
| 118 static const char kEnableVideoSuspendBelowMinBitrate[]; | |
| 119 // googSuspendBelowMinBitrate | |
| 120 // Constraint to enable combined audio+video bandwidth estimation. | |
| 121 static const char kCombinedAudioVideoBwe[]; // googCombinedAudioVideoBwe | |
| 122 static const char kScreencastMinBitrate[]; // googScreencastMinBitrate | |
| 123 static const char kCpuOveruseDetection[]; // googCpuOveruseDetection | |
| 124 static const char kPayloadPadding[]; // googPayloadPadding | |
| 125 | |
| 126 // The prefix of internal-only constraints whose JS set values should be | |
| 127 // stripped by Chrome before passed down to Libjingle. | |
| 128 static const char kInternalConstraintPrefix[]; | |
| 129 | |
| 130 protected: | |
| 131 // Dtor protected as objects shouldn't be deleted via this interface | |
| 132 virtual ~MediaConstraintsInterface() {} | |
| 133 }; | |
| 134 | |
| 135 bool FindConstraint(const MediaConstraintsInterface* constraints, | |
| 136 const std::string& key, bool* value, | |
| 137 size_t* mandatory_constraints); | |
| 138 | |
| 139 } // namespace webrtc | |
| 140 | |
| 141 #endif // TALK_APP_WEBRTC_MEDIACONSTRAINTSINTERFACE_H_ | |
| OLD | NEW |