128e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org/* 228e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * libjingle 35f93d0a140515e3b8cdd1b9a4c6f5871144e5deejlmiller@webrtc.org * Copyright 2013 Google Inc. 428e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * 528e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * Redistribution and use in source and binary forms, with or without 628e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * modification, are permitted provided that the following conditions are met: 728e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * 828e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * 1. Redistributions of source code must retain the above copyright notice, 928e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * this list of conditions and the following disclaimer. 1028e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * 2. Redistributions in binary form must reproduce the above copyright notice, 1128e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * this list of conditions and the following disclaimer in the documentation 1228e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * and/or other materials provided with the distribution. 1328e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * 3. The name of the author may not be used to endorse or promote products 1428e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * derived from this software without specific prior written permission. 1528e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * 1628e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR IMPLIED 1728e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF 1828e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO 1928e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 2028e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 2128e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 2228e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 2328e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 2428e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 2528e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 2628e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org */ 2728e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org 2828e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org#include "talk/app/webrtc/mediaconstraintsinterface.h" 2928e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org 30d4e598d57aed714a599444a7eab5e8fdde52a950buildbot@webrtc.org#include "webrtc/base/stringencode.h" 3128e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org 3228e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.orgnamespace webrtc { 3328e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org 3428e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.orgconst char MediaConstraintsInterface::kValueTrue[] = "true"; 3528e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.orgconst char MediaConstraintsInterface::kValueFalse[] = "false"; 3628e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org 37aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org// Constraints declared as static members in mediastreaminterface.h 38aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org// Specified by draft-alvestrand-constraints-resolution-00b 39aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kMinAspectRatio[] = "minAspectRatio"; 40aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kMaxAspectRatio[] = "maxAspectRatio"; 41aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kMaxWidth[] = "maxWidth"; 42aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kMinWidth[] = "minWidth"; 43aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kMaxHeight[] = "maxHeight"; 44aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kMinHeight[] = "minHeight"; 45aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kMaxFrameRate[] = "maxFrameRate"; 46aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kMinFrameRate[] = "minFrameRate"; 47aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org 48aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org// Audio constraints. 49aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kEchoCancellation[] = 5039b31001d2d74373f1e60cdbc8e57e402bdf34e3tommi "echoCancellation"; 5170c7fe14ac322a3abac2726d29ae3264b956e3daTommiconst char MediaConstraintsInterface::kGoogEchoCancellation[] = 5270c7fe14ac322a3abac2726d29ae3264b956e3daTommi "googEchoCancellation"; 53441f6347311bcf2079435c3888d67e1fb321f9f8Henrik Lundinconst char MediaConstraintsInterface::kExtendedFilterEchoCancellation[] = 54441f6347311bcf2079435c3888d67e1fb321f9f8Henrik Lundin "googEchoCancellation2"; 55bf395c1fc0a29b54fac4b6f6e9f6c117762faa15Bjorn Volckerconst char MediaConstraintsInterface::kDAEchoCancellation[] = 56bf395c1fc0a29b54fac4b6f6e9f6c117762faa15Bjorn Volcker "googDAEchoCancellation"; 57aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kAutoGainControl[] = 58aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org "googAutoGainControl"; 59aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kExperimentalAutoGainControl[] = 60aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org "googAutoGainControl2"; 61aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kNoiseSuppression[] = 62aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org "googNoiseSuppression"; 639cf037b83184374230c6825e4aa407cdafaba434sergeyu@chromium.orgconst char MediaConstraintsInterface::kExperimentalNoiseSuppression[] = 649cf037b83184374230c6825e4aa407cdafaba434sergeyu@chromium.org "googNoiseSuppression2"; 65aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kHighpassFilter[] = 66aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org "googHighpassFilter"; 67aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kTypingNoiseDetection[] = 68aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org "googTypingNoiseDetection"; 69aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kAudioMirroring[] = "googAudioMirroring"; 701ba344a07060bf57db649299835ec4f093d58d40Bjorn Volckerconst char MediaConstraintsInterface::kAecDump[] = "audioDebugRecording"; 71aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org 72aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org// Google-specific constraint keys for a local video source (getUserMedia). 73aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kNoiseReduction[] = "googNoiseReduction"; 74aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org 75aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org// Constraint keys for CreateOffer / CreateAnswer defined in W3C specification. 76aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kOfferToReceiveAudio[] = 77aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org "OfferToReceiveAudio"; 78aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kOfferToReceiveVideo[] = 79aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org "OfferToReceiveVideo"; 80aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kVoiceActivityDetection[] = 81aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org "VoiceActivityDetection"; 82aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kIceRestart[] = 83aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org "IceRestart"; 84aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org// Google specific constraint for BUNDLE enable/disable. 85aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kUseRtpMux[] = 86aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org "googUseRtpMUX"; 87aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org 88aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org// Below constraints should be used during PeerConnection construction. 89aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kEnableDtlsSrtp[] = 90aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org "DtlsSrtpKeyAgreement"; 91aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kEnableRtpDataChannels[] = 92aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org "RtpDataChannels"; 93148149138dbc4c619230499b9a0a93b665285823wu@webrtc.org// Google-specific constraint keys. 94aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kEnableDscp[] = "googDscp"; 95aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.orgconst char MediaConstraintsInterface::kEnableIPv6[] = "googIPv6"; 966e3dbc2a77eb96b050c4909c4206348f1b15550chenrike@webrtc.orgconst char MediaConstraintsInterface::kEnableVideoSuspendBelowMinBitrate[] = 976e3dbc2a77eb96b050c4909c4206348f1b15550chenrike@webrtc.org "googSuspendBelowMinBitrate"; 9853df88c1bcd42d79d178f8c8da8d4d620f1c12cfbuildbot@webrtc.orgconst char MediaConstraintsInterface::kNumUnsignalledRecvStreams[] = 9953df88c1bcd42d79d178f8c8da8d4d620f1c12cfbuildbot@webrtc.org "googNumUnsignalledRecvStreams"; 100b4c7b09c1352174ecc1faf8c0cd93c66028a0485buildbot@webrtc.orgconst char MediaConstraintsInterface::kCombinedAudioVideoBwe[] = 101b4c7b09c1352174ecc1faf8c0cd93c66028a0485buildbot@webrtc.org "googCombinedAudioVideoBwe"; 102148149138dbc4c619230499b9a0a93b665285823wu@webrtc.orgconst char MediaConstraintsInterface::kScreencastMinBitrate[] = 103148149138dbc4c619230499b9a0a93b665285823wu@webrtc.org "googScreencastMinBitrate"; 104148149138dbc4c619230499b9a0a93b665285823wu@webrtc.org// TODO(ronghuawu): Remove once cpu overuse detection is stable. 105148149138dbc4c619230499b9a0a93b665285823wu@webrtc.orgconst char MediaConstraintsInterface::kCpuOveruseDetection[] = 106148149138dbc4c619230499b9a0a93b665285823wu@webrtc.org "googCpuOveruseDetection"; 107148149138dbc4c619230499b9a0a93b665285823wu@webrtc.orgconst char MediaConstraintsInterface::kCpuUnderuseThreshold[] = 108148149138dbc4c619230499b9a0a93b665285823wu@webrtc.org "googCpuUnderuseThreshold"; 109148149138dbc4c619230499b9a0a93b665285823wu@webrtc.orgconst char MediaConstraintsInterface::kCpuOveruseThreshold[] = 110148149138dbc4c619230499b9a0a93b665285823wu@webrtc.org "googCpuOveruseThreshold"; 11127626a6256878611fd2dd10a4e6e1c464fd79463buildbot@webrtc.orgconst char MediaConstraintsInterface::kCpuUnderuseEncodeRsdThreshold[] = 11227626a6256878611fd2dd10a4e6e1c464fd79463buildbot@webrtc.org "googCpuUnderuseEncodeRsdThreshold"; 11327626a6256878611fd2dd10a4e6e1c464fd79463buildbot@webrtc.orgconst char MediaConstraintsInterface::kCpuOveruseEncodeRsdThreshold[] = 11427626a6256878611fd2dd10a4e6e1c464fd79463buildbot@webrtc.org "googCpuOveruseEncodeRsdThreshold"; 115148149138dbc4c619230499b9a0a93b665285823wu@webrtc.orgconst char MediaConstraintsInterface::kCpuOveruseEncodeUsage[] = 116148149138dbc4c619230499b9a0a93b665285823wu@webrtc.org "googCpuOveruseEncodeUsage"; 117148149138dbc4c619230499b9a0a93b665285823wu@webrtc.orgconst char MediaConstraintsInterface::kHighStartBitrate[] = 118148149138dbc4c619230499b9a0a93b665285823wu@webrtc.org "googHighStartBitrate"; 11944a317a6983402c63db8b3cd44f69efc7245b815buildbot@webrtc.orgconst char MediaConstraintsInterface::kPayloadPadding[] = "googPayloadPadding"; 12044a317a6983402c63db8b3cd44f69efc7245b815buildbot@webrtc.org 121aebb1ade9d760841f243e380fa22b7ecff2d3ecchenrika@webrtc.org 12228e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org// Set |value| to the value associated with the first appearance of |key|, or 12328e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org// return false if |key| is not found. 12428e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.orgbool MediaConstraintsInterface::Constraints::FindFirst( 12528e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org const std::string& key, std::string* value) const { 12628e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org for (Constraints::const_iterator iter = begin(); iter != end(); ++iter) { 12728e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org if (iter->key == key) { 12828e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org *value = iter->value; 12928e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org return true; 13028e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org } 13128e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org } 13228e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org return false; 13328e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org} 13428e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org 13528e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org// Find the highest-priority instance of the boolean-valued constraint) named by 13628e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org// |key| and return its value as |value|. |constraints| can be null. 13728e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org// If |mandatory_constraints| is non-null, it is incremented if the key appears 13828e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org// among the mandatory constraints. 13928e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org// Returns true if the key was found and has a valid boolean value. 14028e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org// If the key appears multiple times as an optional constraint, appearances 14128e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org// after the first are ignored. 14228e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org// Note: Because this uses FindFirst, repeated optional constraints whose 14328e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org// first instance has an unrecognized value are not handled precisely in 14428e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org// accordance with the specification. 14528e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.orgbool FindConstraint(const MediaConstraintsInterface* constraints, 14628e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org const std::string& key, bool* value, 14728e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org size_t* mandatory_constraints) { 14828e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org std::string string_value; 14928e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org if (!constraints) { 15028e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org return false; 15128e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org } 15228e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org if (constraints->GetMandatory().FindFirst(key, &string_value)) { 15328e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org if (mandatory_constraints) 15428e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org ++*mandatory_constraints; 155d4e598d57aed714a599444a7eab5e8fdde52a950buildbot@webrtc.org return rtc::FromString(string_value, value); 15628e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org } 15728e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org if (constraints->GetOptional().FindFirst(key, &string_value)) { 158d4e598d57aed714a599444a7eab5e8fdde52a950buildbot@webrtc.org return rtc::FromString(string_value, value); 15928e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org } 16028e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org return false; 16128e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org} 16228e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org 16328e20752806a492f5a6a5d343c02f9556f39b1cdhenrike@webrtc.org} // namespace webrtc 164