blob: 4af121ddc30ffb530f6666cf34cdb23533e640d8 [file] [log] [blame]
henrike@webrtc.org28e20752013-07-10 00:45:361/*
kjellanderb24317b2016-02-10 15:54:432 * Copyright 2011 The WebRTC project authors. All Rights Reserved.
henrike@webrtc.org28e20752013-07-10 00:45:363 *
kjellanderb24317b2016-02-10 15:54:434 * 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.org28e20752013-07-10 00:45:369 */
10
Steve Anton10542f22019-01-11 17:11:0011#include "pc/webrtc_sdp.h"
henrike@webrtc.org28e20752013-07-10 00:45:3612
kjellandera96e2d72016-02-05 07:52:2813#include <ctype.h>
henrike@webrtc.org28e20752013-07-10 00:45:3614#include <limits.h>
15#include <stdio.h>
kwibergd1fe2812016-04-27 13:47:2916
henrike@webrtc.org28e20752013-07-10 00:45:3617#include <algorithm>
Steve Anton36b29d12017-10-30 16:57:4218#include <map>
kwibergd1fe2812016-04-27 13:47:2919#include <memory>
Steve Anton36b29d12017-10-30 16:57:4220#include <set>
henrike@webrtc.org28e20752013-07-10 00:45:3621#include <string>
deadbeef67cf2c12016-04-13 17:07:1622#include <unordered_map>
Steve Anton4905edb2018-10-16 02:27:4423#include <utility>
henrike@webrtc.org28e20752013-07-10 00:45:3624#include <vector>
25
Steve Anton64b626b2019-01-29 01:25:2626#include "absl/algorithm/container.h"
Niels Möller039743e2018-10-23 08:07:2527#include "absl/strings/match.h"
Patrik Höglunde2d6a062017-10-05 12:53:3328#include "api/candidate.h"
Steve Anton10542f22019-01-11 17:11:0029#include "api/crypto_params.h"
30#include "api/jsep_ice_candidate.h"
31#include "api/jsep_session_description.h"
32#include "api/media_types.h"
isheriff6f8d6862016-05-26 18:24:5533// for RtpExtension
Steve Anton10542f22019-01-11 17:11:0034#include "api/rtp_parameters.h"
Mirko Bonadei92ea95e2017-09-15 04:47:3135#include "media/base/codec.h"
Steve Anton10542f22019-01-11 17:11:0036#include "media/base/media_constants.h"
37#include "media/base/rtp_utils.h"
38#include "media/sctp/sctp_transport_internal.h"
39#include "p2p/base/p2p_constants.h"
Mirko Bonadei92ea95e2017-09-15 04:47:3140#include "p2p/base/port.h"
Steve Anton10542f22019-01-11 17:11:0041#include "pc/media_session.h"
42#include "pc/sdp_serializer.h"
Mirko Bonadei92ea95e2017-09-15 04:47:3143#include "rtc_base/arraysize.h"
44#include "rtc_base/checks.h"
45#include "rtc_base/logging.h"
Steve Anton10542f22019-01-11 17:11:0046#include "rtc_base/message_digest.h"
Niels Möller198cf002019-05-10 10:29:1347#include "rtc_base/string_utils.h"
Jonas Olssonec9e4922018-09-05 07:53:4948#include "rtc_base/strings/string_builder.h"
Piotr (Peter) Slatala13e570f2019-02-27 19:34:2649#include "rtc_base/third_party/base64/base64.h"
henrike@webrtc.org28e20752013-07-10 00:45:3650
51using cricket::AudioContentDescription;
52using cricket::Candidate;
53using cricket::Candidates;
henrike@webrtc.org28e20752013-07-10 00:45:3654using cricket::ContentInfo;
55using cricket::CryptoParams;
Harald Alvestrand141c0ad2019-05-05 19:00:0056using cricket::ICE_CANDIDATE_COMPONENT_RTCP;
Harald Alvestrand37f2b432019-05-09 07:19:5457using cricket::ICE_CANDIDATE_COMPONENT_RTP;
Taylor Brandstetteree8c2462020-07-27 22:52:0258using cricket::kApplicationSpecificBandwidth;
henrike@webrtc.org28e20752013-07-10 00:45:3659using cricket::kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:3660using cricket::kCodecParamMinPTime;
61using cricket::kCodecParamPTime;
Taylor Brandstetteree8c2462020-07-27 22:52:0262using cricket::kTransportSpecificBandwidth;
henrike@webrtc.org28e20752013-07-10 00:45:3663using cricket::MediaContentDescription;
Harald Alvestrand141c0ad2019-05-05 19:00:0064using cricket::MediaProtocolType;
Harald Alvestrand37f2b432019-05-09 07:19:5465using cricket::MediaType;
Harald Alvestrand141c0ad2019-05-05 19:00:0066using cricket::RidDescription;
Harald Alvestrand5fc28b12019-05-13 11:36:1667using cricket::RtpDataContentDescription;
Harald Alvestrand37f2b432019-05-09 07:19:5468using cricket::RtpHeaderExtensions;
Harald Alvestrand5fc28b12019-05-13 11:36:1669using cricket::SctpDataContentDescription;
Amit Hilbucha2012042018-12-03 19:35:0570using cricket::SimulcastDescription;
Amit Hilbuchc57d5732018-12-11 23:30:1171using cricket::SimulcastLayer;
72using cricket::SimulcastLayerList;
henrike@webrtc.org28e20752013-07-10 00:45:3673using cricket::SsrcGroup;
74using cricket::StreamParams;
75using cricket::StreamParamsVec;
76using cricket::TransportDescription;
77using cricket::TransportInfo;
78using cricket::VideoContentDescription;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:5279using rtc::SocketAddress;
henrike@webrtc.org28e20752013-07-10 00:45:3680
henrike@webrtc.org28e20752013-07-10 00:45:3681namespace cricket {
82class SessionDescription;
83}
84
deadbeef90f1e1e2017-02-10 20:35:0585// TODO(deadbeef): Switch to using anonymous namespace rather than declaring
86// everything "static".
henrike@webrtc.org28e20752013-07-10 00:45:3687namespace webrtc {
88
89// Line type
90// RFC 4566
91// An SDP session description consists of a number of lines of text of
92// the form:
93// <type>=<value>
94// where <type> MUST be exactly one case-significant character.
deadbeef9d3584c2016-02-17 01:54:1095static const int kLinePrefixLength = 2; // Length of <type>=
henrike@webrtc.org28e20752013-07-10 00:45:3696static const char kLineTypeVersion = 'v';
97static const char kLineTypeOrigin = 'o';
98static const char kLineTypeSessionName = 's';
99static const char kLineTypeSessionInfo = 'i';
100static const char kLineTypeSessionUri = 'u';
101static const char kLineTypeSessionEmail = 'e';
102static const char kLineTypeSessionPhone = 'p';
103static const char kLineTypeSessionBandwidth = 'b';
104static const char kLineTypeTiming = 't';
105static const char kLineTypeRepeatTimes = 'r';
106static const char kLineTypeTimeZone = 'z';
107static const char kLineTypeEncryptionKey = 'k';
108static const char kLineTypeMedia = 'm';
109static const char kLineTypeConnection = 'c';
110static const char kLineTypeAttributes = 'a';
111
112// Attributes
113static const char kAttributeGroup[] = "group";
114static const char kAttributeMid[] = "mid";
deadbeef9d3584c2016-02-17 01:54:10115static const char kAttributeMsid[] = "msid";
deadbeef25ed4352016-12-13 02:37:36116static const char kAttributeBundleOnly[] = "bundle-only";
henrike@webrtc.org28e20752013-07-10 00:45:36117static const char kAttributeRtcpMux[] = "rtcp-mux";
deadbeef13871492015-12-09 20:37:51118static const char kAttributeRtcpReducedSize[] = "rtcp-rsize";
henrike@webrtc.org28e20752013-07-10 00:45:36119static const char kAttributeSsrc[] = "ssrc";
120static const char kSsrcAttributeCname[] = "cname";
Johannes Kron0854eb62018-10-10 20:33:20121static const char kAttributeExtmapAllowMixed[] = "extmap-allow-mixed";
henrike@webrtc.org28e20752013-07-10 00:45:36122static const char kAttributeExtmap[] = "extmap";
123// draft-alvestrand-mmusic-msid-01
124// a=msid-semantic: WMS
Seth Hampson5b4f0752018-04-02 23:31:36125// This is a legacy field supported only for Plan B semantics.
henrike@webrtc.org28e20752013-07-10 00:45:36126static const char kAttributeMsidSemantics[] = "msid-semantic";
127static const char kMediaStreamSemantic[] = "WMS";
128static const char kSsrcAttributeMsid[] = "msid";
129static const char kDefaultMsid[] = "default";
Seth Hampson5b4f0752018-04-02 23:31:36130static const char kNoStreamMsid[] = "-";
Artem Titovf0a34f22020-03-16 17:52:04131static const char kSsrcAttributeMslabel[] = "mslabel";
132static const char kSSrcAttributeLabel[] = "label";
henrike@webrtc.org28e20752013-07-10 00:45:36133static const char kAttributeSsrcGroup[] = "ssrc-group";
134static const char kAttributeCrypto[] = "crypto";
135static const char kAttributeCandidate[] = "candidate";
136static const char kAttributeCandidateTyp[] = "typ";
137static const char kAttributeCandidateRaddr[] = "raddr";
138static const char kAttributeCandidateRport[] = "rport";
honghaiza54a0802015-12-17 02:37:23139static const char kAttributeCandidateUfrag[] = "ufrag";
140static const char kAttributeCandidatePwd[] = "pwd";
henrike@webrtc.org28e20752013-07-10 00:45:36141static const char kAttributeCandidateGeneration[] = "generation";
honghaiza0c44ea2016-03-23 23:07:48142static const char kAttributeCandidateNetworkId[] = "network-id";
honghaize1a0c942016-02-16 22:54:56143static const char kAttributeCandidateNetworkCost[] = "network-cost";
henrike@webrtc.org28e20752013-07-10 00:45:36144static const char kAttributeFingerprint[] = "fingerprint";
sergeyu@chromium.org0be6aa02013-08-23 23:21:25145static const char kAttributeSetup[] = "setup";
henrike@webrtc.org28e20752013-07-10 00:45:36146static const char kAttributeFmtp[] = "fmtp";
147static const char kAttributeRtpmap[] = "rtpmap";
wu@webrtc.org78187522013-10-07 23:32:02148static const char kAttributeSctpmap[] = "sctpmap";
henrike@webrtc.org28e20752013-07-10 00:45:36149static const char kAttributeRtcp[] = "rtcp";
150static const char kAttributeIceUfrag[] = "ice-ufrag";
151static const char kAttributeIcePwd[] = "ice-pwd";
152static const char kAttributeIceLite[] = "ice-lite";
153static const char kAttributeIceOption[] = "ice-options";
154static const char kAttributeSendOnly[] = "sendonly";
155static const char kAttributeRecvOnly[] = "recvonly";
156static const char kAttributeRtcpFb[] = "rtcp-fb";
157static const char kAttributeSendRecv[] = "sendrecv";
158static const char kAttributeInactive[] = "inactive";
Harald Alvestrand48cce4d2019-04-11 08:41:24159// draft-ietf-mmusic-sctp-sdp-26
160// a=sctp-port, a=max-message-size
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56161static const char kAttributeSctpPort[] = "sctp-port";
Harald Alvestrand48cce4d2019-04-11 08:41:24162static const char kAttributeMaxMessageSize[] = "max-message-size";
Harald Alvestrandfbb45bd2019-05-15 06:07:47163static const int kDefaultSctpMaxMessageSize = 65536;
Amit Hilbucha2012042018-12-03 19:35:05164// draft-ietf-mmusic-sdp-simulcast-13
165// a=simulcast
166static const char kAttributeSimulcast[] = "simulcast";
Amit Hilbuchc57d5732018-12-11 23:30:11167// draft-ietf-mmusic-rid-15
168// a=rid
169static const char kAttributeRid[] = "rid";
Mirta Dvornicic479a3c02019-06-04 13:38:50170static const char kAttributePacketization[] = "packetization";
henrike@webrtc.org28e20752013-07-10 00:45:36171
172// Experimental flags
173static const char kAttributeXGoogleFlag[] = "x-google-flag";
174static const char kValueConference[] = "conference";
henrike@webrtc.org28e20752013-07-10 00:45:36175
Sebastian Janssone1795f42019-07-24 09:38:03176static const char kAttributeRtcpRemoteEstimate[] = "remote-net-estimate";
177
henrike@webrtc.org28e20752013-07-10 00:45:36178// Candidate
179static const char kCandidateHost[] = "host";
180static const char kCandidateSrflx[] = "srflx";
Honghai Zhang7fb69db2016-03-14 18:59:18181static const char kCandidatePrflx[] = "prflx";
henrike@webrtc.org28e20752013-07-10 00:45:36182static const char kCandidateRelay[] = "relay";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20183static const char kTcpCandidateType[] = "tcptype";
henrike@webrtc.org28e20752013-07-10 00:45:36184
Jonas Olssonec9e4922018-09-05 07:53:49185// rtc::StringBuilder doesn't have a << overload for chars, while rtc::split and
186// rtc::tokenize_first both take a char delimiter. To handle both cases these
187// constants come in pairs of a chars and length-one strings.
188static const char kSdpDelimiterEqual[] = "=";
189static const char kSdpDelimiterEqualChar = '=';
190static const char kSdpDelimiterSpace[] = " ";
191static const char kSdpDelimiterSpaceChar = ' ';
192static const char kSdpDelimiterColon[] = ":";
193static const char kSdpDelimiterColonChar = ':';
194static const char kSdpDelimiterSemicolon[] = ";";
195static const char kSdpDelimiterSemicolonChar = ';';
196static const char kSdpDelimiterSlashChar = '/';
197static const char kNewLine[] = "\n";
198static const char kNewLineChar = '\n';
199static const char kReturnChar = '\r';
henrike@webrtc.org28e20752013-07-10 00:45:36200static const char kLineBreak[] = "\r\n";
201
Steve Anton36b29d12017-10-30 16:57:42202// TODO(deadbeef): Generate the Session and Time description
henrike@webrtc.org28e20752013-07-10 00:45:36203// instead of hardcoding.
204static const char kSessionVersion[] = "v=0";
205// RFC 4566
206static const char kSessionOriginUsername[] = "-";
207static const char kSessionOriginSessionId[] = "0";
208static const char kSessionOriginSessionVersion[] = "0";
209static const char kSessionOriginNettype[] = "IN";
210static const char kSessionOriginAddrtype[] = "IP4";
211static const char kSessionOriginAddress[] = "127.0.0.1";
212static const char kSessionName[] = "s=-";
213static const char kTimeDescription[] = "t=0 0";
214static const char kAttrGroup[] = "a=group:BUNDLE";
215static const char kConnectionNettype[] = "IN";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22216static const char kConnectionIpv4Addrtype[] = "IP4";
217static const char kConnectionIpv6Addrtype[] = "IP6";
henrike@webrtc.org28e20752013-07-10 00:45:36218static const char kMediaTypeVideo[] = "video";
219static const char kMediaTypeAudio[] = "audio";
220static const char kMediaTypeData[] = "application";
221static const char kMediaPortRejected[] = "0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22222// draft-ietf-mmusic-trickle-ice-01
223// When no candidates have been gathered, set the connection
224// address to IP6 ::.
perkj@webrtc.orgd105cc82014-11-07 11:22:06225// TODO(perkj): FF can not parse IP6 ::. See http://crbug/430333
226// Use IPV4 per default.
227static const char kDummyAddress[] = "0.0.0.0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22228static const char kDummyPort[] = "9";
henrike@webrtc.org28e20752013-07-10 00:45:36229
wu@webrtc.org78187522013-10-07 23:32:02230static const char kDefaultSctpmapProtocol[] = "webrtc-datachannel";
henrike@webrtc.org28e20752013-07-10 00:45:36231
pkasting@chromium.orgd3245462015-02-23 21:28:22232// RTP payload type is in the 0-127 range. Use -1 to indicate "all" payload
233// types.
234const int kWildcardPayloadType = -1;
235
henrike@webrtc.org28e20752013-07-10 00:45:36236struct SsrcInfo {
Peter Boström0c4e06b2015-10-07 10:23:21237 uint32_t ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36238 std::string cname;
deadbeef9d3584c2016-02-17 01:54:10239 std::string stream_id;
240 std::string track_id;
Artem Titovf0a34f22020-03-16 17:52:04241
242 // For backward compatibility.
243 // TODO(ronghuawu): Remove below 2 fields once all the clients support msid.
244 std::string label;
245 std::string mslabel;
henrike@webrtc.org28e20752013-07-10 00:45:36246};
247typedef std::vector<SsrcInfo> SsrcInfoVec;
248typedef std::vector<SsrcGroup> SsrcGroupVec;
249
henrike@webrtc.org28e20752013-07-10 00:45:36250template <class T>
251static void AddFmtpLine(const T& codec, std::string* message);
252static void BuildMediaDescription(const ContentInfo* content_info,
253 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 14:58:01254 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13255 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 20:22:16256 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36257 std::string* message);
deadbeef9d3584c2016-02-17 01:54:10258static void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 14:58:01259 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 20:22:16260 int msid_signaling,
deadbeef9d3584c2016-02-17 01:54:10261 std::string* message);
henrike@webrtc.org28e20752013-07-10 00:45:36262static void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 14:58:01263 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36264 std::string* message);
265static void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-17 02:37:23266 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36267 std::string* message);
268static void BuildIceOptions(const std::vector<std::string>& transport_options,
269 std::string* message);
zhihuang38989e52017-03-21 18:04:53270static bool ParseSessionDescription(const std::string& message,
271 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36272 std::string* session_id,
273 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36274 TransportDescription* session_td,
275 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 18:04:53276 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36277 cricket::SessionDescription* desc,
278 SdpParseError* error);
279static bool ParseGroupAttribute(const std::string& line,
280 cricket::SessionDescription* desc,
281 SdpParseError* error);
282static bool ParseMediaDescription(
283 const std::string& message,
284 const TransportDescription& session_td,
285 const RtpHeaderExtensions& session_extmaps,
zhihuang38989e52017-03-21 18:04:53286 size_t* pos,
287 const rtc::SocketAddress& session_connection_addr,
288 cricket::SessionDescription* desc,
Steve Anton5a1de872018-12-18 19:25:55289 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36290 SdpParseError* error);
Steve Anton5a1de872018-12-18 19:25:55291static bool ParseContent(
292 const std::string& message,
293 const cricket::MediaType media_type,
294 int mline_index,
295 const std::string& protocol,
296 const std::vector<int>& payload_types,
297 size_t* pos,
298 std::string* content_name,
299 bool* bundle_only,
300 int* msid_signaling,
301 MediaContentDescription* media_desc,
302 TransportDescription* transport,
303 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
304 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36305static bool ParseSsrcAttribute(const std::string& line,
306 SsrcInfoVec* ssrc_infos,
Steve Antone831b8c2018-02-01 20:22:16307 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36308 SdpParseError* error);
309static bool ParseSsrcGroupAttribute(const std::string& line,
310 SsrcGroupVec* ssrc_groups,
311 SdpParseError* error);
312static bool ParseCryptoAttribute(const std::string& line,
313 MediaContentDescription* media_desc,
314 SdpParseError* error);
315static bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 14:58:01316 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 17:07:16317 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36318 MediaContentDescription* media_desc,
319 SdpParseError* error);
320static bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 14:58:01321 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36322 MediaContentDescription* media_desc,
323 SdpParseError* error);
Yves Gerey665174f2018-06-19 13:03:05324static bool ParseFmtpParam(const std::string& line,
325 std::string* parameter,
326 std::string* value,
327 SdpParseError* error);
Mirta Dvornicic479a3c02019-06-04 13:38:50328static bool ParsePacketizationAttribute(const std::string& line,
329 const cricket::MediaType media_type,
330 MediaContentDescription* media_desc,
331 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36332static bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 14:58:01333 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36334 MediaContentDescription* media_desc,
335 SdpParseError* error);
336static bool ParseIceOptions(const std::string& line,
337 std::vector<std::string>* transport_options,
338 SdpParseError* error);
339static bool ParseExtmap(const std::string& line,
isheriff6f8d6862016-05-26 18:24:55340 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36341 SdpParseError* error);
Steve Anton4905edb2018-10-16 02:27:44342static bool ParseFingerprintAttribute(
343 const std::string& line,
344 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
345 SdpParseError* error);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25346static bool ParseDtlsSetup(const std::string& line,
347 cricket::ConnectionRole* role,
348 SdpParseError* error);
deadbeef9d3584c2016-02-17 01:54:10349static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 23:31:36350 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-17 01:54:10351 std::string* track_id,
352 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36353
Amit Hilbuchc57d5732018-12-11 23:30:11354static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
355 std::vector<RidDescription>* rids);
356
357static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
358 const std::set<std::string>& to_remove,
359 const SimulcastLayerList& layers);
360
361static void RemoveInvalidRidsFromSimulcast(
362 const std::vector<RidDescription>& rids,
363 SimulcastDescription* simulcast);
364
henrike@webrtc.org28e20752013-07-10 00:45:36365// Helper functions
366
367// Below ParseFailed*** functions output the line that caused the parsing
368// failure and the detailed reason (|description|) of the failure to |error|.
369// The functions always return false so that they can be used directly in the
370// following way when error happens:
371// "return ParseFailed***(...);"
372
373// The line starting at |line_start| of |message| is the failing line.
374// The reason for the failure should be provided in the |description|.
375// An example of a description could be "unknown character".
376static bool ParseFailed(const std::string& message,
377 size_t line_start,
378 const std::string& description,
379 SdpParseError* error) {
380 // Get the first line of |message| from |line_start|.
sergeyu@chromium.org5bc25c42013-12-05 00:24:06381 std::string first_line;
henrike@webrtc.org28e20752013-07-10 00:45:36382 size_t line_end = message.find(kNewLine, line_start);
383 if (line_end != std::string::npos) {
Jonas Olssonec9e4922018-09-05 07:53:49384 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36385 --line_end;
386 }
387 first_line = message.substr(line_start, (line_end - line_start));
sergeyu@chromium.org5bc25c42013-12-05 00:24:06388 } else {
389 first_line = message.substr(line_start);
henrike@webrtc.org28e20752013-07-10 00:45:36390 }
391
392 if (error) {
393 error->line = first_line;
394 error->description = description;
395 }
Mirko Bonadei675513b2017-11-09 10:09:25396 RTC_LOG(LS_ERROR) << "Failed to parse: \"" << first_line
397 << "\". Reason: " << description;
henrike@webrtc.org28e20752013-07-10 00:45:36398 return false;
399}
400
401// |line| is the failing line. The reason for the failure should be
402// provided in the |description|.
403static bool ParseFailed(const std::string& line,
404 const std::string& description,
405 SdpParseError* error) {
406 return ParseFailed(line, 0, description, error);
407}
408
409// Parses failure where the failing SDP line isn't know or there are multiple
410// failing lines.
Yves Gerey665174f2018-06-19 13:03:05411static bool ParseFailed(const std::string& description, SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36412 return ParseFailed("", description, error);
413}
414
415// |line| is the failing line. The failure is due to the fact that |line|
416// doesn't have |expected_fields| fields.
417static bool ParseFailedExpectFieldNum(const std::string& line,
418 int expected_fields,
419 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 07:53:49420 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36421 description << "Expects " << expected_fields << " fields.";
422 return ParseFailed(line, description.str(), error);
423}
424
425// |line| is the failing line. The failure is due to the fact that |line| has
426// less than |expected_min_fields| fields.
427static bool ParseFailedExpectMinFieldNum(const std::string& line,
428 int expected_min_fields,
429 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 07:53:49430 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36431 description << "Expects at least " << expected_min_fields << " fields.";
432 return ParseFailed(line, description.str(), error);
433}
434
435// |line| is the failing line. The failure is due to the fact that it failed to
436// get the value of |attribute|.
437static bool ParseFailedGetValue(const std::string& line,
438 const std::string& attribute,
439 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 07:53:49440 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36441 description << "Failed to get the value of attribute: " << attribute;
442 return ParseFailed(line, description.str(), error);
443}
444
445// The line starting at |line_start| of |message| is the failing line. The
446// failure is due to the line type (e.g. the "m" part of the "m-line")
447// not matching what is expected. The expected line type should be
448// provided as |line_type|.
449static bool ParseFailedExpectLine(const std::string& message,
450 size_t line_start,
451 const char line_type,
452 const std::string& line_value,
453 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 07:53:49454 rtc::StringBuilder description;
455 description << "Expect line: " << std::string(1, line_type) << "="
456 << line_value;
henrike@webrtc.org28e20752013-07-10 00:45:36457 return ParseFailed(message, line_start, description.str(), error);
458}
459
460static bool AddLine(const std::string& line, std::string* message) {
461 if (!message)
462 return false;
463
464 message->append(line);
465 message->append(kLineBreak);
466 return true;
467}
468
469static bool GetLine(const std::string& message,
470 size_t* pos,
471 std::string* line) {
472 size_t line_begin = *pos;
473 size_t line_end = message.find(kNewLine, line_begin);
474 if (line_end == std::string::npos) {
475 return false;
476 }
477 // Update the new start position
478 *pos = line_end + 1;
Jonas Olssonec9e4922018-09-05 07:53:49479 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36480 --line_end;
481 }
482 *line = message.substr(line_begin, (line_end - line_begin));
483 const char* cline = line->c_str();
484 // RFC 4566
485 // An SDP session description consists of a number of lines of text of
486 // the form:
487 // <type>=<value>
488 // where <type> MUST be exactly one case-significant character and
489 // <value> is structured text whose format depends on <type>.
490 // Whitespace MUST NOT be used on either side of the "=" sign.
Taylor Brandstetter93a7b242018-04-16 17:45:24491 //
492 // However, an exception to the whitespace rule is made for "s=", since
493 // RFC4566 also says:
494 //
495 // If a session has no meaningful name, the value "s= " SHOULD be used
496 // (i.e., a single space as the session name).
497 if (line->length() < 3 || !islower(cline[0]) ||
Jonas Olssonec9e4922018-09-05 07:53:49498 cline[1] != kSdpDelimiterEqualChar ||
499 (cline[0] != kLineTypeSessionName &&
500 cline[2] == kSdpDelimiterSpaceChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36501 *pos = line_begin;
502 return false;
503 }
504 return true;
505}
506
507// Init |os| to "|type|=|value|".
508static void InitLine(const char type,
509 const std::string& value,
Jonas Olssonec9e4922018-09-05 07:53:49510 rtc::StringBuilder* os) {
511 os->Clear();
512 *os << std::string(1, type) << kSdpDelimiterEqual << value;
henrike@webrtc.org28e20752013-07-10 00:45:36513}
514
515// Init |os| to "a=|attribute|".
Jonas Olssonec9e4922018-09-05 07:53:49516static void InitAttrLine(const std::string& attribute, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36517 InitLine(kLineTypeAttributes, attribute, os);
518}
519
520// Writes a SDP attribute line based on |attribute| and |value| to |message|.
Yves Gerey665174f2018-06-19 13:03:05521static void AddAttributeLine(const std::string& attribute,
522 int value,
henrike@webrtc.org28e20752013-07-10 00:45:36523 std::string* message) {
Jonas Olssonec9e4922018-09-05 07:53:49524 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36525 InitAttrLine(attribute, &os);
526 os << kSdpDelimiterColon << value;
527 AddLine(os.str(), message);
528}
529
henrike@webrtc.org28e20752013-07-10 00:45:36530static bool IsLineType(const std::string& message,
531 const char type,
532 size_t line_start) {
533 if (message.size() < line_start + kLinePrefixLength) {
534 return false;
535 }
536 const char* cmessage = message.c_str();
537 return (cmessage[line_start] == type &&
Jonas Olssonec9e4922018-09-05 07:53:49538 cmessage[line_start + 1] == kSdpDelimiterEqualChar);
henrike@webrtc.org28e20752013-07-10 00:45:36539}
540
Yves Gerey665174f2018-06-19 13:03:05541static bool IsLineType(const std::string& line, const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36542 return IsLineType(line, type, 0);
543}
544
Yves Gerey665174f2018-06-19 13:03:05545static bool GetLineWithType(const std::string& message,
546 size_t* pos,
547 std::string* line,
548 const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36549 if (!IsLineType(message, type, *pos)) {
550 return false;
551 }
552
553 if (!GetLine(message, pos, line))
554 return false;
555
556 return true;
557}
558
559static bool HasAttribute(const std::string& line,
560 const std::string& attribute) {
Johannes Kron211856b2018-09-06 10:12:28561 if (line.compare(kLinePrefixLength, attribute.size(), attribute) == 0) {
562 // Make sure that the match is not only a partial match. If length of
563 // strings doesn't match, the next character of the line must be ':' or ' '.
564 // This function is also used for media descriptions (e.g., "m=audio 9..."),
565 // hence the need to also allow space in the end.
566 RTC_CHECK_LE(kLinePrefixLength + attribute.size(), line.size());
567 if ((kLinePrefixLength + attribute.size()) == line.size() ||
568 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterColonChar ||
569 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterSpaceChar) {
570 return true;
571 }
572 }
573 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36574}
575
Peter Boström0c4e06b2015-10-07 10:23:21576static bool AddSsrcLine(uint32_t ssrc_id,
577 const std::string& attribute,
578 const std::string& value,
579 std::string* message) {
henrike@webrtc.org28e20752013-07-10 00:45:36580 // RFC 5576
581 // a=ssrc:<ssrc-id> <attribute>:<value>
Jonas Olssonec9e4922018-09-05 07:53:49582 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36583 InitAttrLine(kAttributeSsrc, &os);
Yves Gerey665174f2018-06-19 13:03:05584 os << kSdpDelimiterColon << ssrc_id << kSdpDelimiterSpace << attribute
585 << kSdpDelimiterColon << value;
henrike@webrtc.org28e20752013-07-10 00:45:36586 return AddLine(os.str(), message);
587}
588
henrike@webrtc.org28e20752013-07-10 00:45:36589// Get value only from <attribute>:<value>.
Yves Gerey665174f2018-06-19 13:03:05590static bool GetValue(const std::string& message,
591 const std::string& attribute,
592 std::string* value,
593 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36594 std::string leftpart;
Jonas Olssonec9e4922018-09-05 07:53:49595 if (!rtc::tokenize_first(message, kSdpDelimiterColonChar, &leftpart, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36596 return ParseFailedGetValue(message, attribute, error);
597 }
598 // The left part should end with the expected attribute.
599 if (leftpart.length() < attribute.length() ||
600 leftpart.compare(leftpart.length() - attribute.length(),
601 attribute.length(), attribute) != 0) {
602 return ParseFailedGetValue(message, attribute, error);
603 }
604 return true;
605}
606
607static bool CaseInsensitiveFind(std::string str1, std::string str2) {
Steve Anton64b626b2019-01-29 01:25:26608 absl::c_transform(str1, str1.begin(), ::tolower);
609 absl::c_transform(str2, str2.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36610 return str1.find(str2) != std::string::npos;
611}
612
wu@webrtc.org5e760e72014-04-02 23:19:09613template <class T>
614static bool GetValueFromString(const std::string& line,
615 const std::string& s,
616 T* t,
617 SdpParseError* error) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52618 if (!rtc::FromString(s, t)) {
Jonas Olssonec9e4922018-09-05 07:53:49619 rtc::StringBuilder description;
wu@webrtc.org5e760e72014-04-02 23:19:09620 description << "Invalid value: " << s << ".";
621 return ParseFailed(line, description.str(), error);
622 }
623 return true;
624}
625
pkasting@chromium.orge9facf82015-02-17 20:36:28626static bool GetPayloadTypeFromString(const std::string& line,
627 const std::string& s,
628 int* payload_type,
629 SdpParseError* error) {
630 return GetValueFromString(line, s, payload_type, error) &&
Yves Gerey665174f2018-06-19 13:03:05631 cricket::IsValidRtpPayloadType(*payload_type);
pkasting@chromium.orge9facf82015-02-17 20:36:28632}
633
Seth Hampson5897a6e2018-04-03 18:16:33634// Creates a StreamParams track in the case when no SSRC lines are signaled.
635// This is a track that does not contain SSRCs and only contains
636// stream_ids/track_id if it's signaled with a=msid lines.
637void CreateTrackWithNoSsrcs(const std::vector<std::string>& msid_stream_ids,
638 const std::string& msid_track_id,
Amit Hilbuchc57d5732018-12-11 23:30:11639 const std::vector<RidDescription>& rids,
Seth Hampson5897a6e2018-04-03 18:16:33640 StreamParamsVec* tracks) {
641 StreamParams track;
Amit Hilbuch6df49d82019-04-15 22:47:21642 if (msid_track_id.empty() && rids.empty()) {
Seth Hampson5897a6e2018-04-03 18:16:33643 // We only create an unsignaled track if a=msid lines were signaled.
Amit Hilbuch6df49d82019-04-15 22:47:21644 RTC_LOG(LS_INFO) << "MSID not signaled, skipping creation of StreamParams";
Seth Hampson5897a6e2018-04-03 18:16:33645 return;
646 }
647 track.set_stream_ids(msid_stream_ids);
648 track.id = msid_track_id;
Amit Hilbuchc57d5732018-12-11 23:30:11649 track.set_rids(rids);
Seth Hampson5897a6e2018-04-03 18:16:33650 tracks->push_back(track);
651}
652
653// Creates the StreamParams tracks, for the case when SSRC lines are signaled.
654// |msid_stream_ids| and |msid_track_id| represent the stream/track ID from the
Taylor Brandstetter5de6b752016-03-10 01:02:30655// "a=msid" attribute, if it exists. They are empty if the attribute does not
Seth Hampson5897a6e2018-04-03 18:16:33656// exist. We prioritize getting stream_ids/track_ids signaled in a=msid lines.
henrike@webrtc.org28e20752013-07-10 00:45:36657void CreateTracksFromSsrcInfos(const SsrcInfoVec& ssrc_infos,
Seth Hampson5b4f0752018-04-02 23:31:36658 const std::vector<std::string>& msid_stream_ids,
Taylor Brandstetter5de6b752016-03-10 01:02:30659 const std::string& msid_track_id,
Seth Hampson5b4f0752018-04-02 23:31:36660 StreamParamsVec* tracks,
661 int msid_signaling) {
nisseede5da42017-01-12 13:15:36662 RTC_DCHECK(tracks != NULL);
Steve Anton4daf66e2018-09-07 21:55:53663 for (const SsrcInfo& ssrc_info : ssrc_infos) {
Taylor Brandstetter4256df02020-02-18 22:05:07664 // According to https://tools.ietf.org/html/rfc5576#section-6.1, the CNAME
665 // attribute is mandatory, but we relax that restriction.
Steve Anton4daf66e2018-09-07 21:55:53666 if (ssrc_info.cname.empty()) {
Taylor Brandstetter4256df02020-02-18 22:05:07667 RTC_LOG(LS_WARNING) << "CNAME attribute missing for SSRC "
668 << ssrc_info.ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36669 }
Seth Hampson5b4f0752018-04-02 23:31:36670 std::vector<std::string> stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36671 std::string track_id;
Seth Hampson5b4f0752018-04-02 23:31:36672 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
673 // This is the case with Unified Plan SDP msid signaling.
674 stream_ids = msid_stream_ids;
Tomas Gunnarsson191bf5c2018-03-30 10:44:43675 track_id = msid_track_id;
Seth Hampson5b4f0752018-04-02 23:31:36676 } else if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
677 // This is the case with Plan B SDP msid signaling.
Steve Anton4daf66e2018-09-07 21:55:53678 stream_ids.push_back(ssrc_info.stream_id);
679 track_id = ssrc_info.track_id;
Artem Titovf0a34f22020-03-16 17:52:04680 } else if (!ssrc_info.mslabel.empty()) {
681 // Since there's no a=msid or a=ssrc msid signaling, this is a sdp from
682 // an older version of client that doesn't support msid.
683 // In that case, we use the mslabel and label to construct the track.
684 stream_ids.push_back(ssrc_info.mslabel);
685 track_id = ssrc_info.label;
Seth Hampson5b4f0752018-04-02 23:31:36686 } else {
687 // Since no media streams isn't supported with older SDP signaling, we
688 // use a default a stream id.
689 stream_ids.push_back(kDefaultMsid);
henrike@webrtc.org28e20752013-07-10 00:45:36690 }
Seth Hampson5b4f0752018-04-02 23:31:36691 // If a track ID wasn't populated from the SSRC attributes OR the
Taylor Brandstetter5de6b752016-03-10 01:02:30692 // msid attribute, use default/random values.
Taylor Brandstetter5de6b752016-03-10 01:02:30693 if (track_id.empty()) {
694 // TODO(ronghuawu): What should we do if the track id doesn't appear?
695 // Create random string (which will be used as track label later)?
696 track_id = rtc::CreateRandomString(8);
henrike@webrtc.org28e20752013-07-10 00:45:36697 }
698
Steve Anton64b626b2019-01-29 01:25:26699 auto track_it = absl::c_find_if(
700 *tracks,
Steve Anton4daf66e2018-09-07 21:55:53701 [track_id](const StreamParams& track) { return track.id == track_id; });
702 if (track_it == tracks->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36703 // If we don't find an existing track, create a new one.
704 tracks->push_back(StreamParams());
Steve Anton4daf66e2018-09-07 21:55:53705 track_it = tracks->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36706 }
Steve Anton4daf66e2018-09-07 21:55:53707 StreamParams& track = *track_it;
708 track.add_ssrc(ssrc_info.ssrc_id);
709 track.cname = ssrc_info.cname;
710 track.set_stream_ids(stream_ids);
711 track.id = track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36712 }
713}
714
Seth Hampson845e8782018-03-02 19:34:10715void GetMediaStreamIds(const ContentInfo* content,
716 std::set<std::string>* labels) {
Steve Antonb1c1de12017-12-21 23:14:30717 for (const StreamParams& stream_params :
718 content->media_description()->streams()) {
Seth Hampson845e8782018-03-02 19:34:10719 for (const std::string& stream_id : stream_params.stream_ids()) {
720 labels->insert(stream_id);
Steve Anton5a26a3a2018-02-28 19:38:47721 }
henrike@webrtc.org28e20752013-07-10 00:45:36722 }
723}
724
725// RFC 5245
726// It is RECOMMENDED that default candidates be chosen based on the
727// likelihood of those candidates to work with the peer that is being
728// contacted. It is RECOMMENDED that relayed > reflexive > host.
729static const int kPreferenceUnknown = 0;
730static const int kPreferenceHost = 1;
731static const int kPreferenceReflexive = 2;
732static const int kPreferenceRelayed = 3;
733
734static int GetCandidatePreferenceFromType(const std::string& type) {
735 int preference = kPreferenceUnknown;
736 if (type == cricket::LOCAL_PORT_TYPE) {
737 preference = kPreferenceHost;
738 } else if (type == cricket::STUN_PORT_TYPE) {
739 preference = kPreferenceReflexive;
740 } else if (type == cricket::RELAY_PORT_TYPE) {
741 preference = kPreferenceRelayed;
742 } else {
nissec80e7412017-01-11 13:56:46743 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36744 }
745 return preference;
746}
747
guoweis@webrtc.org57ac2c82015-02-06 00:45:13748// Get ip and port of the default destination from the |candidates| with the
749// given value of |component_id|. The default candidate should be the one most
750// likely to work, typically IPv4 relay.
henrike@webrtc.org28e20752013-07-10 00:45:36751// RFC 5245
752// The value of |component_id| currently supported are 1 (RTP) and 2 (RTCP).
Steve Anton36b29d12017-10-30 16:57:42753// TODO(deadbeef): Decide the default destination in webrtcsession and
henrike@webrtc.org28e20752013-07-10 00:45:36754// pass it down via SessionDescription.
Yves Gerey665174f2018-06-19 13:03:05755static void GetDefaultDestination(const std::vector<Candidate>& candidates,
756 int component_id,
757 std::string* port,
758 std::string* ip,
759 std::string* addr_type) {
perkj@webrtc.orgd105cc82014-11-07 11:22:06760 *addr_type = kConnectionIpv4Addrtype;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22761 *port = kDummyPort;
762 *ip = kDummyAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36763 int current_preference = kPreferenceUnknown;
guoweis@webrtc.org57ac2c82015-02-06 00:45:13764 int current_family = AF_UNSPEC;
Steve Anton4daf66e2018-09-07 21:55:53765 for (const Candidate& candidate : candidates) {
766 if (candidate.component() != component_id) {
henrike@webrtc.org28e20752013-07-10 00:45:36767 continue;
768 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13769 // Default destination should be UDP only.
Steve Anton4daf66e2018-09-07 21:55:53770 if (candidate.protocol() != cricket::UDP_PROTOCOL_NAME) {
henrike@webrtc.org28e20752013-07-10 00:45:36771 continue;
772 }
Steve Anton4daf66e2018-09-07 21:55:53773 const int preference = GetCandidatePreferenceFromType(candidate.type());
774 const int family = candidate.address().ipaddr().family();
guoweis@webrtc.org57ac2c82015-02-06 00:45:13775 // See if this candidate is more preferable then the current one if it's the
776 // same family. Or if the current family is IPv4 already so we could safely
777 // ignore all IPv6 ones. WebRTC bug 4269.
778 // http://code.google.com/p/webrtc/issues/detail?id=4269
779 if ((preference <= current_preference && current_family == family) ||
780 (current_family == AF_INET && family == AF_INET6)) {
781 continue;
782 }
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22783 if (family == AF_INET) {
784 addr_type->assign(kConnectionIpv4Addrtype);
785 } else if (family == AF_INET6) {
786 addr_type->assign(kConnectionIpv6Addrtype);
787 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13788 current_preference = preference;
789 current_family = family;
Steve Anton4daf66e2018-09-07 21:55:53790 *port = candidate.address().PortAsString();
791 *ip = candidate.address().ipaddr().ToString();
henrike@webrtc.org28e20752013-07-10 00:45:36792 }
henrike@webrtc.org28e20752013-07-10 00:45:36793}
794
wu@webrtc.org4c3e9912014-07-16 21:03:13795// Gets "a=rtcp" line if found default RTCP candidate from |candidates|.
796static std::string GetRtcpLine(const std::vector<Candidate>& candidates) {
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22797 std::string rtcp_line, rtcp_port, rtcp_ip, addr_type;
Yves Gerey665174f2018-06-19 13:03:05798 GetDefaultDestination(candidates, ICE_CANDIDATE_COMPONENT_RTCP, &rtcp_port,
799 &rtcp_ip, &addr_type);
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22800 // Found default RTCP candidate.
801 // RFC 5245
802 // If the agent is utilizing RTCP, it MUST encode the RTCP candidate
803 // using the a=rtcp attribute as defined in RFC 3605.
henrike@webrtc.org28e20752013-07-10 00:45:36804
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22805 // RFC 3605
806 // rtcp-attribute = "a=rtcp:" port [nettype space addrtype space
807 // connection-address] CRLF
Jonas Olssonec9e4922018-09-05 07:53:49808 rtc::StringBuilder os;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22809 InitAttrLine(kAttributeRtcp, &os);
Yves Gerey665174f2018-06-19 13:03:05810 os << kSdpDelimiterColon << rtcp_port << " " << kConnectionNettype << " "
811 << addr_type << " " << rtcp_ip;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22812 rtcp_line = os.str();
wu@webrtc.org4c3e9912014-07-16 21:03:13813 return rtcp_line;
henrike@webrtc.org28e20752013-07-10 00:45:36814}
815
816// Get candidates according to the mline index from SessionDescriptionInterface.
817static void GetCandidatesByMindex(const SessionDescriptionInterface& desci,
818 int mline_index,
819 std::vector<Candidate>* candidates) {
820 if (!candidates) {
821 return;
822 }
823 const IceCandidateCollection* cc = desci.candidates(mline_index);
824 for (size_t i = 0; i < cc->count(); ++i) {
825 const IceCandidateInterface* candidate = cc->at(i);
826 candidates->push_back(candidate->candidate());
827 }
828}
829
deadbeef90f1e1e2017-02-10 20:35:05830static bool IsValidPort(int port) {
831 return port >= 0 && port <= 65535;
832}
833
Steve Antone831b8c2018-02-01 20:22:16834std::string SdpSerialize(const JsepSessionDescription& jdesc) {
henrike@webrtc.org28e20752013-07-10 00:45:36835 const cricket::SessionDescription* desc = jdesc.description();
836 if (!desc) {
837 return "";
838 }
839
840 std::string message;
841
842 // Session Description.
843 AddLine(kSessionVersion, &message);
844 // Session Origin
845 // RFC 4566
846 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
847 // <unicast-address>
Jonas Olssonec9e4922018-09-05 07:53:49848 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36849 InitLine(kLineTypeOrigin, kSessionOriginUsername, &os);
Yves Gerey665174f2018-06-19 13:03:05850 const std::string& session_id =
851 jdesc.session_id().empty() ? kSessionOriginSessionId : jdesc.session_id();
852 const std::string& session_version = jdesc.session_version().empty()
853 ? kSessionOriginSessionVersion
854 : jdesc.session_version();
henrike@webrtc.org28e20752013-07-10 00:45:36855 os << " " << session_id << " " << session_version << " "
856 << kSessionOriginNettype << " " << kSessionOriginAddrtype << " "
857 << kSessionOriginAddress;
858 AddLine(os.str(), &message);
859 AddLine(kSessionName, &message);
860
861 // Time Description.
862 AddLine(kTimeDescription, &message);
863
864 // Group
865 if (desc->HasGroup(cricket::GROUP_TYPE_BUNDLE)) {
866 std::string group_line = kAttrGroup;
867 const cricket::ContentGroup* group =
868 desc->GetGroupByName(cricket::GROUP_TYPE_BUNDLE);
nisseede5da42017-01-12 13:15:36869 RTC_DCHECK(group != NULL);
Steve Anton4daf66e2018-09-07 21:55:53870 for (const std::string& content_name : group->content_names()) {
henrike@webrtc.org28e20752013-07-10 00:45:36871 group_line.append(" ");
Steve Anton4daf66e2018-09-07 21:55:53872 group_line.append(content_name);
henrike@webrtc.org28e20752013-07-10 00:45:36873 }
874 AddLine(group_line, &message);
875 }
876
Johannes Kron0854eb62018-10-10 20:33:20877 // Mixed one- and two-byte header extension.
Johannes Kron9581bc42018-10-23 08:17:39878 if (desc->extmap_allow_mixed()) {
Johannes Kron0854eb62018-10-10 20:33:20879 InitAttrLine(kAttributeExtmapAllowMixed, &os);
880 AddLine(os.str(), &message);
881 }
882
henrike@webrtc.org28e20752013-07-10 00:45:36883 // MediaStream semantics
884 InitAttrLine(kAttributeMsidSemantics, &os);
885 os << kSdpDelimiterColon << " " << kMediaStreamSemantic;
wu@webrtc.org4c3e9912014-07-16 21:03:13886
Seth Hampson845e8782018-03-02 19:34:10887 std::set<std::string> media_stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36888 const ContentInfo* audio_content = GetFirstAudioContent(desc);
889 if (audio_content)
Seth Hampson845e8782018-03-02 19:34:10890 GetMediaStreamIds(audio_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13891
henrike@webrtc.org28e20752013-07-10 00:45:36892 const ContentInfo* video_content = GetFirstVideoContent(desc);
893 if (video_content)
Seth Hampson845e8782018-03-02 19:34:10894 GetMediaStreamIds(video_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13895
Steve Anton4daf66e2018-09-07 21:55:53896 for (const std::string& id : media_stream_ids) {
897 os << " " << id;
henrike@webrtc.org28e20752013-07-10 00:45:36898 }
899 AddLine(os.str(), &message);
900
Taylor Brandstetter2f65ec52018-05-24 18:37:28901 // a=ice-lite
902 //
903 // TODO(deadbeef): It's weird that we need to iterate TransportInfos for
904 // this, when it's a session-level attribute. It really should be moved to a
905 // session-level structure like SessionDescription.
906 for (const cricket::TransportInfo& transport : desc->transport_infos()) {
907 if (transport.description.ice_mode == cricket::ICEMODE_LITE) {
908 InitAttrLine(kAttributeIceLite, &os);
909 AddLine(os.str(), &message);
910 break;
911 }
912 }
913
wu@webrtc.org4c3e9912014-07-16 21:03:13914 // Preserve the order of the media contents.
915 int mline_index = -1;
Steve Anton4daf66e2018-09-07 21:55:53916 for (const ContentInfo& content : desc->contents()) {
wu@webrtc.org4c3e9912014-07-16 21:03:13917 std::vector<Candidate> candidates;
918 GetCandidatesByMindex(jdesc, ++mline_index, &candidates);
Steve Anton4daf66e2018-09-07 21:55:53919 BuildMediaDescription(&content, desc->GetTransportInfoByName(content.name),
920 content.media_description()->type(), candidates,
921 desc->msid_signaling(), &message);
henrike@webrtc.org28e20752013-07-10 00:45:36922 }
henrike@webrtc.org28e20752013-07-10 00:45:36923 return message;
924}
925
926// Serializes the passed in IceCandidateInterface to a SDP string.
927// candidate - The candidate to be serialized.
Honghai Zhang7fb69db2016-03-14 18:59:18928std::string SdpSerializeCandidate(const IceCandidateInterface& candidate) {
929 return SdpSerializeCandidate(candidate.candidate());
930}
931
932// Serializes a cricket Candidate.
933std::string SdpSerializeCandidate(const cricket::Candidate& candidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36934 std::string message;
Honghai Zhang7fb69db2016-03-14 18:59:18935 std::vector<cricket::Candidate> candidates(1, candidate);
honghaiza54a0802015-12-17 02:37:23936 BuildCandidate(candidates, true, &message);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10937 // From WebRTC draft section 4.8.1.1 candidate-attribute will be
938 // just candidate:<candidate> not a=candidate:<blah>CRLF
nisseede5da42017-01-12 13:15:36939 RTC_DCHECK(message.find("a=") == 0);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10940 message.erase(0, 2);
nisseede5da42017-01-12 13:15:36941 RTC_DCHECK(message.find(kLineBreak) == message.size() - 2);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10942 message.resize(message.size() - 2);
henrike@webrtc.org28e20752013-07-10 00:45:36943 return message;
944}
945
946bool SdpDeserialize(const std::string& message,
947 JsepSessionDescription* jdesc,
948 SdpParseError* error) {
949 std::string session_id;
950 std::string session_version;
Peter Thatcher7cbd1882015-09-18 01:54:52951 TransportDescription session_td("", "");
henrike@webrtc.org28e20752013-07-10 00:45:36952 RtpHeaderExtensions session_extmaps;
zhihuang38989e52017-03-21 18:04:53953 rtc::SocketAddress session_connection_addr;
Mirko Bonadei317a1f02019-09-17 15:06:18954 auto desc = std::make_unique<cricket::SessionDescription>();
henrike@webrtc.org28e20752013-07-10 00:45:36955 size_t current_pos = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36956
957 // Session Description
958 if (!ParseSessionDescription(message, &current_pos, &session_id,
deadbeefc80741f2015-10-22 20:14:45959 &session_version, &session_td, &session_extmaps,
Steve Anton5a1de872018-12-18 19:25:55960 &session_connection_addr, desc.get(), error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36961 return false;
962 }
963
964 // Media Description
Steve Anton5a1de872018-12-18 19:25:55965 std::vector<std::unique_ptr<JsepIceCandidate>> candidates;
deadbeefc80741f2015-10-22 20:14:45966 if (!ParseMediaDescription(message, session_td, session_extmaps, &current_pos,
Steve Anton5a1de872018-12-18 19:25:55967 session_connection_addr, desc.get(), &candidates,
zhihuang38989e52017-03-21 18:04:53968 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36969 return false;
970 }
971
Harald Alvestrand4d7160e2019-04-12 05:01:29972 jdesc->Initialize(std::move(desc), session_id, session_version);
henrike@webrtc.org28e20752013-07-10 00:45:36973
Steve Anton5a1de872018-12-18 19:25:55974 for (const auto& candidate : candidates) {
975 jdesc->AddCandidate(candidate.get());
henrike@webrtc.org28e20752013-07-10 00:45:36976 }
977 return true;
978}
979
980bool SdpDeserializeCandidate(const std::string& message,
981 JsepIceCandidate* jcandidate,
982 SdpParseError* error) {
nisseede5da42017-01-12 13:15:36983 RTC_DCHECK(jcandidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36984 Candidate candidate;
985 if (!ParseCandidate(message, &candidate, error, true)) {
986 return false;
987 }
988 jcandidate->SetCandidate(candidate);
989 return true;
990}
991
Honghai Zhang7fb69db2016-03-14 18:59:18992bool SdpDeserializeCandidate(const std::string& transport_name,
993 const std::string& message,
994 cricket::Candidate* candidate,
995 SdpParseError* error) {
nisseede5da42017-01-12 13:15:36996 RTC_DCHECK(candidate != nullptr);
Honghai Zhang7fb69db2016-03-14 18:59:18997 if (!ParseCandidate(message, candidate, error, true)) {
998 return false;
999 }
1000 candidate->set_transport_name(transport_name);
1001 return true;
1002}
1003
Yves Gerey665174f2018-06-19 13:03:051004bool ParseCandidate(const std::string& message,
1005 Candidate* candidate,
1006 SdpParseError* error,
1007 bool is_raw) {
nisseede5da42017-01-12 13:15:361008 RTC_DCHECK(candidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:361009
1010 // Get the first line from |message|.
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:151011 std::string first_line = message;
1012 size_t pos = 0;
1013 GetLine(message, &pos, &first_line);
henrike@webrtc.org28e20752013-07-10 00:45:361014
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:151015 // Makes sure |message| contains only one line.
1016 if (message.size() > first_line.size()) {
1017 std::string left, right;
Jonas Olssonec9e4922018-09-05 07:53:491018 if (rtc::tokenize_first(message, kNewLineChar, &left, &right) &&
Donald Curtis0e07f922015-05-15 16:21:231019 !right.empty()) {
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:151020 return ParseFailed(message, 0, "Expect one line only", error);
1021 }
1022 }
1023
1024 // From WebRTC draft section 4.8.1.1 candidate-attribute should be
1025 // candidate:<candidate> when trickled, but we still support
1026 // a=candidate:<blah>CRLF for backward compatibility and for parsing a line
1027 // from the SDP.
1028 if (IsLineType(first_line, kLineTypeAttributes)) {
1029 first_line = first_line.substr(kLinePrefixLength);
1030 }
1031
1032 std::string attribute_candidate;
1033 std::string candidate_value;
1034
1035 // |first_line| must be in the form of "candidate:<value>".
Jonas Olssonec9e4922018-09-05 07:53:491036 if (!rtc::tokenize_first(first_line, kSdpDelimiterColonChar,
1037 &attribute_candidate, &candidate_value) ||
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:151038 attribute_candidate != kAttributeCandidate) {
henrike@webrtc.org28e20752013-07-10 00:45:361039 if (is_raw) {
Jonas Olssonec9e4922018-09-05 07:53:491040 rtc::StringBuilder description;
Jonas Olssonb2b20312020-01-14 11:11:311041 description << "Expect line: " << kAttributeCandidate
1042 << ":"
1043 "<candidate-str>";
henrike@webrtc.org28e20752013-07-10 00:45:361044 return ParseFailed(first_line, 0, description.str(), error);
1045 } else {
1046 return ParseFailedExpectLine(first_line, 0, kLineTypeAttributes,
1047 kAttributeCandidate, error);
1048 }
1049 }
1050
1051 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:491052 rtc::split(candidate_value, kSdpDelimiterSpaceChar, &fields);
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:151053
henrike@webrtc.org28e20752013-07-10 00:45:361054 // RFC 5245
1055 // a=candidate:<foundation> <component-id> <transport> <priority>
1056 // <connection-address> <port> typ <candidate-types>
1057 // [raddr <connection-address>] [rport <port>]
1058 // *(SP extension-att-name SP extension-att-value)
1059 const size_t expected_min_fields = 8;
1060 if (fields.size() < expected_min_fields ||
1061 (fields[6] != kAttributeCandidateTyp)) {
1062 return ParseFailedExpectMinFieldNum(first_line, expected_min_fields, error);
1063 }
jbauch083b73f2015-07-16 09:46:321064 const std::string& foundation = fields[0];
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:151065
wu@webrtc.org5e760e72014-04-02 23:19:091066 int component_id = 0;
1067 if (!GetValueFromString(first_line, fields[1], &component_id, error)) {
1068 return false;
1069 }
jbauch083b73f2015-07-16 09:46:321070 const std::string& transport = fields[2];
Peter Boström0c4e06b2015-10-07 10:23:211071 uint32_t priority = 0;
wu@webrtc.org5e760e72014-04-02 23:19:091072 if (!GetValueFromString(first_line, fields[3], &priority, error)) {
1073 return false;
1074 }
jbauch083b73f2015-07-16 09:46:321075 const std::string& connection_address = fields[4];
wu@webrtc.org5e760e72014-04-02 23:19:091076 int port = 0;
1077 if (!GetValueFromString(first_line, fields[5], &port, error)) {
1078 return false;
1079 }
deadbeef90f1e1e2017-02-10 20:35:051080 if (!IsValidPort(port)) {
1081 return ParseFailed(first_line, "Invalid port number.", error);
1082 }
henrike@webrtc.org28e20752013-07-10 00:45:361083 SocketAddress address(connection_address, port);
1084
1085 cricket::ProtocolType protocol;
hnslb68cc752016-12-13 18:33:411086 if (!StringToProto(transport.c_str(), &protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:361087 return ParseFailed(first_line, "Unsupported transport type.", error);
1088 }
Taylor Brandstetter8206bc02020-04-02 19:36:381089 bool tcp_protocol = false;
hnslb68cc752016-12-13 18:33:411090 switch (protocol) {
Taylor Brandstetter8206bc02020-04-02 19:36:381091 // Supported protocols.
hnslb68cc752016-12-13 18:33:411092 case cricket::PROTO_UDP:
Taylor Brandstetter8206bc02020-04-02 19:36:381093 break;
hnslb68cc752016-12-13 18:33:411094 case cricket::PROTO_TCP:
1095 case cricket::PROTO_SSLTCP:
Taylor Brandstetter8206bc02020-04-02 19:36:381096 tcp_protocol = true;
hnslb68cc752016-12-13 18:33:411097 break;
1098 default:
1099 return ParseFailed(first_line, "Unsupported transport type.", error);
1100 }
henrike@webrtc.org28e20752013-07-10 00:45:361101
1102 std::string candidate_type;
jbauch083b73f2015-07-16 09:46:321103 const std::string& type = fields[7];
henrike@webrtc.org28e20752013-07-10 00:45:361104 if (type == kCandidateHost) {
1105 candidate_type = cricket::LOCAL_PORT_TYPE;
1106 } else if (type == kCandidateSrflx) {
1107 candidate_type = cricket::STUN_PORT_TYPE;
1108 } else if (type == kCandidateRelay) {
1109 candidate_type = cricket::RELAY_PORT_TYPE;
Honghai Zhang7fb69db2016-03-14 18:59:181110 } else if (type == kCandidatePrflx) {
1111 candidate_type = cricket::PRFLX_PORT_TYPE;
henrike@webrtc.org28e20752013-07-10 00:45:361112 } else {
1113 return ParseFailed(first_line, "Unsupported candidate type.", error);
1114 }
1115
1116 size_t current_position = expected_min_fields;
1117 SocketAddress related_address;
1118 // The 2 optional fields for related address
1119 // [raddr <connection-address>] [rport <port>]
1120 if (fields.size() >= (current_position + 2) &&
1121 fields[current_position] == kAttributeCandidateRaddr) {
1122 related_address.SetIP(fields[++current_position]);
1123 ++current_position;
1124 }
1125 if (fields.size() >= (current_position + 2) &&
1126 fields[current_position] == kAttributeCandidateRport) {
wu@webrtc.org5e760e72014-04-02 23:19:091127 int port = 0;
Yves Gerey665174f2018-06-19 13:03:051128 if (!GetValueFromString(first_line, fields[++current_position], &port,
1129 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:091130 return false;
1131 }
deadbeef90f1e1e2017-02-10 20:35:051132 if (!IsValidPort(port)) {
1133 return ParseFailed(first_line, "Invalid port number.", error);
1134 }
wu@webrtc.org5e760e72014-04-02 23:19:091135 related_address.SetPort(port);
henrike@webrtc.org28e20752013-07-10 00:45:361136 ++current_position;
1137 }
1138
mallinath@webrtc.org2d60c5e2014-08-08 22:29:201139 // If this is a TCP candidate, it has additional extension as defined in
1140 // RFC 6544.
1141 std::string tcptype;
1142 if (fields.size() >= (current_position + 2) &&
1143 fields[current_position] == kTcpCandidateType) {
1144 tcptype = fields[++current_position];
1145 ++current_position;
1146
1147 if (tcptype != cricket::TCPTYPE_ACTIVE_STR &&
1148 tcptype != cricket::TCPTYPE_PASSIVE_STR &&
1149 tcptype != cricket::TCPTYPE_SIMOPEN_STR) {
1150 return ParseFailed(first_line, "Invalid TCP candidate type.", error);
1151 }
1152
Taylor Brandstetter8206bc02020-04-02 19:36:381153 if (!tcp_protocol) {
mallinath@webrtc.org2d60c5e2014-08-08 22:29:201154 return ParseFailed(first_line, "Invalid non-TCP candidate", error);
1155 }
Taylor Brandstetter8206bc02020-04-02 19:36:381156 } else if (tcp_protocol) {
1157 // We allow the tcptype to be missing, for backwards compatibility,
1158 // treating it as a passive candidate.
1159 // TODO(bugs.webrtc.org/11466): Treat a missing tcptype as an error?
1160 tcptype = cricket::TCPTYPE_PASSIVE_STR;
mallinath@webrtc.org2d60c5e2014-08-08 22:29:201161 }
1162
henrike@webrtc.org28e20752013-07-10 00:45:361163 // Extension
honghaiza54a0802015-12-17 02:37:231164 // Though non-standard, we support the ICE ufrag and pwd being signaled on
1165 // the candidate to avoid issues with confusing which generation a candidate
1166 // belongs to when trickling multiple generations at the same time.
henrike@webrtc.org28e20752013-07-10 00:45:361167 std::string username;
1168 std::string password;
Peter Boström0c4e06b2015-10-07 10:23:211169 uint32_t generation = 0;
honghaiza0c44ea2016-03-23 23:07:481170 uint16_t network_id = 0;
1171 uint16_t network_cost = 0;
henrike@webrtc.org28e20752013-07-10 00:45:361172 for (size_t i = current_position; i + 1 < fields.size(); ++i) {
1173 // RFC 5245
1174 // *(SP extension-att-name SP extension-att-value)
1175 if (fields[i] == kAttributeCandidateGeneration) {
wu@webrtc.org5e760e72014-04-02 23:19:091176 if (!GetValueFromString(first_line, fields[++i], &generation, error)) {
1177 return false;
1178 }
honghaiza54a0802015-12-17 02:37:231179 } else if (fields[i] == kAttributeCandidateUfrag) {
henrike@webrtc.org28e20752013-07-10 00:45:361180 username = fields[++i];
honghaiza54a0802015-12-17 02:37:231181 } else if (fields[i] == kAttributeCandidatePwd) {
henrike@webrtc.org28e20752013-07-10 00:45:361182 password = fields[++i];
honghaiza0c44ea2016-03-23 23:07:481183 } else if (fields[i] == kAttributeCandidateNetworkId) {
1184 if (!GetValueFromString(first_line, fields[++i], &network_id, error)) {
1185 return false;
1186 }
honghaize1a0c942016-02-16 22:54:561187 } else if (fields[i] == kAttributeCandidateNetworkCost) {
1188 if (!GetValueFromString(first_line, fields[++i], &network_cost, error)) {
1189 return false;
1190 }
Honghai Zhang351d77b2016-05-20 22:08:291191 network_cost = std::min(network_cost, rtc::kNetworkCostMax);
henrike@webrtc.org28e20752013-07-10 00:45:361192 } else {
1193 // Skip the unknown extension.
1194 ++i;
1195 }
1196 }
1197
guoweis@webrtc.org61c12472015-01-15 06:53:071198 *candidate = Candidate(component_id, cricket::ProtoToString(protocol),
guoweis@webrtc.org950c5182014-12-16 23:01:311199 address, priority, username, password, candidate_type,
honghaiza0c44ea2016-03-23 23:07:481200 generation, foundation, network_id, network_cost);
henrike@webrtc.org28e20752013-07-10 00:45:361201 candidate->set_related_address(related_address);
mallinath@webrtc.org2d60c5e2014-08-08 22:29:201202 candidate->set_tcptype(tcptype);
henrike@webrtc.org28e20752013-07-10 00:45:361203 return true;
1204}
1205
1206bool ParseIceOptions(const std::string& line,
1207 std::vector<std::string>* transport_options,
1208 SdpParseError* error) {
1209 std::string ice_options;
1210 if (!GetValue(line, kAttributeIceOption, &ice_options, error)) {
1211 return false;
1212 }
1213 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:491214 rtc::split(ice_options, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:361215 for (size_t i = 0; i < fields.size(); ++i) {
1216 transport_options->push_back(fields[i]);
1217 }
1218 return true;
1219}
1220
jiayl@webrtc.orgddb85ab2014-09-05 16:31:561221bool ParseSctpPort(const std::string& line,
1222 int* sctp_port,
1223 SdpParseError* error) {
Harald Alvestrand48cce4d2019-04-11 08:41:241224 // draft-ietf-mmusic-sctp-sdp-26
jiayl@webrtc.orgddb85ab2014-09-05 16:31:561225 // a=sctp-port
1226 std::vector<std::string> fields;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:561227 const size_t expected_min_fields = 2;
Jonas Olssonec9e4922018-09-05 07:53:491228 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
lally69f57602015-10-08 17:15:041229 if (fields.size() < expected_min_fields) {
1230 fields.resize(0);
Jonas Olssonec9e4922018-09-05 07:53:491231 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
lally69f57602015-10-08 17:15:041232 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:561233 if (fields.size() < expected_min_fields) {
1234 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1235 }
1236 if (!rtc::FromString(fields[1], sctp_port)) {
lally69f57602015-10-08 17:15:041237 return ParseFailed(line, "Invalid sctp port value.", error);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:561238 }
1239 return true;
1240}
1241
Harald Alvestrand48cce4d2019-04-11 08:41:241242bool ParseSctpMaxMessageSize(const std::string& line,
1243 int* max_message_size,
1244 SdpParseError* error) {
1245 // draft-ietf-mmusic-sctp-sdp-26
1246 // a=max-message-size:199999
1247 std::vector<std::string> fields;
1248 const size_t expected_min_fields = 2;
1249 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
1250 if (fields.size() < expected_min_fields) {
1251 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1252 }
1253 if (!rtc::FromString(fields[1], max_message_size)) {
1254 return ParseFailed(line, "Invalid SCTP max message size.", error);
1255 }
1256 return true;
1257}
1258
isheriff6f8d6862016-05-26 18:24:551259bool ParseExtmap(const std::string& line,
1260 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:361261 SdpParseError* error) {
1262 // RFC 5285
1263 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1264 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:491265 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:361266 const size_t expected_min_fields = 2;
1267 if (fields.size() < expected_min_fields) {
1268 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1269 }
1270 std::string uri = fields[1];
1271
1272 std::string value_direction;
1273 if (!GetValue(fields[0], kAttributeExtmap, &value_direction, error)) {
1274 return false;
1275 }
1276 std::vector<std::string> sub_fields;
Jonas Olssonec9e4922018-09-05 07:53:491277 rtc::split(value_direction, kSdpDelimiterSlashChar, &sub_fields);
wu@webrtc.org5e760e72014-04-02 23:19:091278 int value = 0;
1279 if (!GetValueFromString(line, sub_fields[0], &value, error)) {
1280 return false;
1281 }
henrike@webrtc.org28e20752013-07-10 00:45:361282
jbauch5869f502017-06-29 19:31:361283 bool encrypted = false;
1284 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1285 // RFC 6904
Steve Anton36b29d12017-10-30 16:57:421286 // a=extmap:<value["/"<direction>] urn:ietf:params:rtp-hdrext:encrypt <URI>
1287 // <extensionattributes>
jbauch5869f502017-06-29 19:31:361288 const size_t expected_min_fields_encrypted = expected_min_fields + 1;
1289 if (fields.size() < expected_min_fields_encrypted) {
1290 return ParseFailedExpectMinFieldNum(line, expected_min_fields_encrypted,
Yves Gerey665174f2018-06-19 13:03:051291 error);
jbauch5869f502017-06-29 19:31:361292 }
1293
1294 encrypted = true;
1295 uri = fields[2];
1296 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1297 return ParseFailed(line, "Recursive encrypted header.", error);
1298 }
1299 }
1300
1301 *extmap = RtpExtension(uri, value, encrypted);
henrike@webrtc.org28e20752013-07-10 00:45:361302 return true;
1303}
1304
Harald Alvestrandfbb45bd2019-05-15 06:07:471305static void BuildSctpContentAttributes(
1306 std::string* message,
1307 const cricket::SctpDataContentDescription* data_desc) {
1308 rtc::StringBuilder os;
1309 if (data_desc->use_sctpmap()) {
1310 // draft-ietf-mmusic-sctp-sdp-04
1311 // a=sctpmap:sctpmap-number protocol [streams]
1312 rtc::StringBuilder os;
1313 InitAttrLine(kAttributeSctpmap, &os);
1314 os << kSdpDelimiterColon << data_desc->port() << kSdpDelimiterSpace
1315 << kDefaultSctpmapProtocol << kSdpDelimiterSpace
1316 << cricket::kMaxSctpStreams;
1317 AddLine(os.str(), message);
1318 } else {
1319 // draft-ietf-mmusic-sctp-sdp-23
1320 // a=sctp-port:<port>
1321 InitAttrLine(kAttributeSctpPort, &os);
1322 os << kSdpDelimiterColon << data_desc->port();
1323 AddLine(os.str(), message);
1324 if (data_desc->max_message_size() != kDefaultSctpMaxMessageSize) {
1325 InitAttrLine(kAttributeMaxMessageSize, &os);
1326 os << kSdpDelimiterColon << data_desc->max_message_size();
1327 AddLine(os.str(), message);
1328 }
1329 }
1330}
1331
henrike@webrtc.org28e20752013-07-10 00:45:361332void BuildMediaDescription(const ContentInfo* content_info,
1333 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 14:58:011334 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:131335 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 20:22:161336 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:361337 std::string* message) {
nisseede5da42017-01-12 13:15:361338 RTC_DCHECK(message != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:361339 if (content_info == NULL || message == NULL) {
1340 return;
1341 }
Jonas Olssonec9e4922018-09-05 07:53:491342 rtc::StringBuilder os;
Steve Antonb1c1de12017-12-21 23:14:301343 const MediaContentDescription* media_desc = content_info->media_description();
1344 RTC_DCHECK(media_desc);
henrike@webrtc.org28e20752013-07-10 00:45:361345
henrike@webrtc.org28e20752013-07-10 00:45:361346 // RFC 4566
1347 // m=<media> <port> <proto> <fmt>
1348 // fmt is a list of payload type numbers that MAY be used in the session.
1349 const char* type = NULL;
1350 if (media_type == cricket::MEDIA_TYPE_AUDIO)
1351 type = kMediaTypeAudio;
1352 else if (media_type == cricket::MEDIA_TYPE_VIDEO)
1353 type = kMediaTypeVideo;
1354 else if (media_type == cricket::MEDIA_TYPE_DATA)
1355 type = kMediaTypeData;
1356 else
nissec80e7412017-01-11 13:56:461357 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:361358
1359 std::string fmt;
1360 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 23:14:301361 const VideoContentDescription* video_desc = media_desc->as_video();
Steve Anton4daf66e2018-09-07 21:55:531362 for (const cricket::VideoCodec& codec : video_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:361363 fmt.append(" ");
Steve Anton4daf66e2018-09-07 21:55:531364 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:361365 }
1366 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 23:14:301367 const AudioContentDescription* audio_desc = media_desc->as_audio();
Steve Anton4daf66e2018-09-07 21:55:531368 for (const cricket::AudioCodec& codec : audio_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:361369 fmt.append(" ");
Steve Anton4daf66e2018-09-07 21:55:531370 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:361371 }
1372 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 11:36:161373 const cricket::SctpDataContentDescription* sctp_data_desc =
1374 media_desc->as_sctp();
1375 if (sctp_data_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:361376 fmt.append(" ");
jiayl@webrtc.org9c16c392014-05-01 18:30:301377
Harald Alvestrand5fc28b12019-05-13 11:36:161378 if (sctp_data_desc->use_sctpmap()) {
1379 fmt.append(rtc::ToString(sctp_data_desc->port()));
zstein4b2e0822017-02-18 03:48:381380 } else {
1381 fmt.append(kDefaultSctpmapProtocol);
1382 }
henrike@webrtc.org28e20752013-07-10 00:45:361383 } else {
Harald Alvestrand5fc28b12019-05-13 11:36:161384 const RtpDataContentDescription* rtp_data_desc =
1385 media_desc->as_rtp_data();
1386 for (const cricket::RtpDataCodec& codec : rtp_data_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:361387 fmt.append(" ");
Steve Anton4daf66e2018-09-07 21:55:531388 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:361389 }
1390 }
1391 }
1392 // The fmt must never be empty. If no codecs are found, set the fmt attribute
1393 // to 0.
1394 if (fmt.empty()) {
1395 fmt = " 0";
1396 }
1397
deadbeef25ed4352016-12-13 02:37:361398 // The port number in the m line will be updated later when associated with
henrike@webrtc.org28e20752013-07-10 00:45:361399 // the candidates.
deadbeef25ed4352016-12-13 02:37:361400 //
1401 // A port value of 0 indicates that the m= section is rejected.
henrike@webrtc.org28e20752013-07-10 00:45:361402 // RFC 3264
1403 // To reject an offered stream, the port number in the corresponding stream in
1404 // the answer MUST be set to zero.
deadbeef25ed4352016-12-13 02:37:361405 //
1406 // However, the BUNDLE draft adds a new meaning to port zero, when used along
1407 // with a=bundle-only.
zhihuang38989e52017-03-21 18:04:531408 std::string port = kDummyPort;
1409 if (content_info->rejected || content_info->bundle_only) {
1410 port = kMediaPortRejected;
1411 } else if (!media_desc->connection_address().IsNil()) {
1412 port = rtc::ToString(media_desc->connection_address().port());
1413 }
henrike@webrtc.org28e20752013-07-10 00:45:361414
Yves Gerey665174f2018-06-19 13:03:051415 rtc::SSLFingerprint* fp =
1416 (transport_info) ? transport_info->description.identity_fingerprint.get()
1417 : NULL;
henrike@webrtc.org28e20752013-07-10 00:45:361418
wu@webrtc.org4c3e9912014-07-16 21:03:131419 // Add the m and c lines.
henrike@webrtc.org28e20752013-07-10 00:45:361420 InitLine(kLineTypeMedia, type, &os);
1421 os << " " << port << " " << media_desc->protocol() << fmt;
zhihuang38989e52017-03-21 18:04:531422 AddLine(os.str(), message);
1423
1424 InitLine(kLineTypeConnection, kConnectionNettype, &os);
1425 if (media_desc->connection_address().IsNil()) {
1426 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
1427 } else if (media_desc->connection_address().family() == AF_INET) {
1428 os << " " << kConnectionIpv4Addrtype << " "
1429 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 20:53:061430 } else if (media_desc->connection_address().family() == AF_INET6) {
zhihuang38989e52017-03-21 18:04:531431 os << " " << kConnectionIpv6Addrtype << " "
1432 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 20:53:061433 } else {
1434 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
zhihuang38989e52017-03-21 18:04:531435 }
1436 AddLine(os.str(), message);
wu@webrtc.org4c3e9912014-07-16 21:03:131437
1438 // RFC 4566
Taylor Brandstetteree8c2462020-07-27 22:52:021439 // b=AS:<bandwidth> or
1440 // b=TIAS:<bandwidth>
1441 int bandwidth = media_desc->bandwidth();
1442 std::string bandwidth_type = media_desc->bandwidth_type();
1443 if (bandwidth_type == kApplicationSpecificBandwidth && bandwidth >= 1000) {
1444 InitLine(kLineTypeSessionBandwidth, bandwidth_type, &os);
1445 bandwidth /= 1000;
1446 os << kSdpDelimiterColon << bandwidth;
1447 AddLine(os.str(), message);
1448 } else if (bandwidth_type == kTransportSpecificBandwidth && bandwidth > 0) {
1449 InitLine(kLineTypeSessionBandwidth, bandwidth_type, &os);
1450 os << kSdpDelimiterColon << bandwidth;
wu@webrtc.org4c3e9912014-07-16 21:03:131451 AddLine(os.str(), message);
1452 }
1453
deadbeef25ed4352016-12-13 02:37:361454 // Add the a=bundle-only line.
1455 if (content_info->bundle_only) {
1456 InitAttrLine(kAttributeBundleOnly, &os);
1457 AddLine(os.str(), message);
1458 }
1459
wu@webrtc.org4c3e9912014-07-16 21:03:131460 // Add the a=rtcp line.
Harald Alvestrand5fc28b12019-05-13 11:36:161461 if (cricket::IsRtpProtocol(media_desc->protocol())) {
wu@webrtc.org4c3e9912014-07-16 21:03:131462 std::string rtcp_line = GetRtcpLine(candidates);
1463 if (!rtcp_line.empty()) {
1464 AddLine(rtcp_line, message);
1465 }
1466 }
1467
honghaiza54a0802015-12-17 02:37:231468 // Build the a=candidate lines. We don't include ufrag and pwd in the
1469 // candidates in the SDP to avoid redundancy.
1470 BuildCandidate(candidates, false, message);
henrike@webrtc.org28e20752013-07-10 00:45:361471
1472 // Use the transport_info to build the media level ice-ufrag and ice-pwd.
1473 if (transport_info) {
1474 // RFC 5245
1475 // ice-pwd-att = "ice-pwd" ":" password
1476 // ice-ufrag-att = "ice-ufrag" ":" ufrag
1477 // ice-ufrag
deadbeef3f7219b2015-12-28 23:17:141478 if (!transport_info->description.ice_ufrag.empty()) {
1479 InitAttrLine(kAttributeIceUfrag, &os);
1480 os << kSdpDelimiterColon << transport_info->description.ice_ufrag;
1481 AddLine(os.str(), message);
1482 }
henrike@webrtc.org28e20752013-07-10 00:45:361483 // ice-pwd
deadbeef3f7219b2015-12-28 23:17:141484 if (!transport_info->description.ice_pwd.empty()) {
1485 InitAttrLine(kAttributeIcePwd, &os);
1486 os << kSdpDelimiterColon << transport_info->description.ice_pwd;
1487 AddLine(os.str(), message);
1488 }
henrike@webrtc.org28e20752013-07-10 00:45:361489
1490 // draft-petithuguenin-mmusic-ice-attributes-level-03
1491 BuildIceOptions(transport_info->description.transport_options, message);
1492
1493 // RFC 4572
1494 // fingerprint-attribute =
1495 // "fingerprint" ":" hash-func SP fingerprint
1496 if (fp) {
1497 // Insert the fingerprint attribute.
1498 InitAttrLine(kAttributeFingerprint, &os);
Yves Gerey665174f2018-06-19 13:03:051499 os << kSdpDelimiterColon << fp->algorithm << kSdpDelimiterSpace
henrike@webrtc.org28e20752013-07-10 00:45:361500 << fp->GetRfc4572Fingerprint();
henrike@webrtc.org28e20752013-07-10 00:45:361501 AddLine(os.str(), message);
sergeyu@chromium.org0be6aa02013-08-23 23:21:251502
1503 // Inserting setup attribute.
1504 if (transport_info->description.connection_role !=
Yves Gerey665174f2018-06-19 13:03:051505 cricket::CONNECTIONROLE_NONE) {
sergeyu@chromium.org0be6aa02013-08-23 23:21:251506 // Making sure we are not using "passive" mode.
1507 cricket::ConnectionRole role =
1508 transport_info->description.connection_role;
mallinath@webrtc.org19f27e62013-10-13 17:18:271509 std::string dtls_role_str;
nissec16fa5e2017-02-07 15:18:431510 const bool success =
1511 cricket::ConnectionRoleToString(role, &dtls_role_str);
1512 RTC_DCHECK(success);
sergeyu@chromium.org0be6aa02013-08-23 23:21:251513 InitAttrLine(kAttributeSetup, &os);
sergeyu@chromium.org0be6aa02013-08-23 23:21:251514 os << kSdpDelimiterColon << dtls_role_str;
1515 AddLine(os.str(), message);
1516 }
henrike@webrtc.org28e20752013-07-10 00:45:361517 }
1518 }
1519
1520 // RFC 3388
1521 // mid-attribute = "a=mid:" identification-tag
1522 // identification-tag = token
1523 // Use the content name as the mid identification-tag.
1524 InitAttrLine(kAttributeMid, &os);
1525 os << kSdpDelimiterColon << content_info->name;
1526 AddLine(os.str(), message);
1527
Harald Alvestrand5fc28b12019-05-13 11:36:161528 if (cricket::IsDtlsSctp(media_desc->protocol())) {
1529 const cricket::SctpDataContentDescription* data_desc =
1530 media_desc->as_sctp();
Harald Alvestrandfbb45bd2019-05-15 06:07:471531 BuildSctpContentAttributes(message, data_desc);
Harald Alvestrand5fc28b12019-05-13 11:36:161532 } else if (cricket::IsRtpProtocol(media_desc->protocol())) {
Steve Antone831b8c2018-02-01 20:22:161533 BuildRtpContentAttributes(media_desc, media_type, msid_signaling, message);
henrike@webrtc.org28e20752013-07-10 00:45:361534 }
1535}
1536
deadbeef9d3584c2016-02-17 01:54:101537void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 14:58:011538 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 20:22:161539 int msid_signaling,
deadbeef9d3584c2016-02-17 01:54:101540 std::string* message) {
Amit Hilbuchc57d5732018-12-11 23:30:111541 SdpSerializer serializer;
Jonas Olssonec9e4922018-09-05 07:53:491542 rtc::StringBuilder os;
Johannes Kron0854eb62018-10-10 20:33:201543 // RFC 8285
1544 // a=extmap-allow-mixed
1545 // The attribute MUST be either on session level or media level. We support
1546 // responding on both levels, however, we don't respond on media level if it's
1547 // set on session level.
Johannes Kron9581bc42018-10-23 08:17:391548 if (media_desc->extmap_allow_mixed_enum() ==
Johannes Kron0854eb62018-10-10 20:33:201549 MediaContentDescription::kMedia) {
1550 InitAttrLine(kAttributeExtmapAllowMixed, &os);
1551 AddLine(os.str(), message);
1552 }
1553 // RFC 8285
henrike@webrtc.org28e20752013-07-10 00:45:361554 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1555 // The definitions MUST be either all session level or all media level. This
1556 // implementation uses all media level.
1557 for (size_t i = 0; i < media_desc->rtp_header_extensions().size(); ++i) {
jbauch5869f502017-06-29 19:31:361558 const RtpExtension& extension = media_desc->rtp_header_extensions()[i];
henrike@webrtc.org28e20752013-07-10 00:45:361559 InitAttrLine(kAttributeExtmap, &os);
jbauch5869f502017-06-29 19:31:361560 os << kSdpDelimiterColon << extension.id;
1561 if (extension.encrypt) {
1562 os << kSdpDelimiterSpace << RtpExtension::kEncryptHeaderExtensionsUri;
1563 }
1564 os << kSdpDelimiterSpace << extension.uri;
henrike@webrtc.org28e20752013-07-10 00:45:361565 AddLine(os.str(), message);
1566 }
1567
1568 // RFC 3264
1569 // a=sendrecv || a=sendonly || a=sendrecv || a=inactive
deadbeefc80741f2015-10-22 20:14:451570 switch (media_desc->direction()) {
Harald Alvestrand6060df52020-08-11 07:54:021571 // Special case that for sdp purposes should be treated same as inactive.
1572 case RtpTransceiverDirection::kStopped:
Steve Anton4e70a722017-11-28 22:57:101573 case RtpTransceiverDirection::kInactive:
henrike@webrtc.org28e20752013-07-10 00:45:361574 InitAttrLine(kAttributeInactive, &os);
1575 break;
Steve Anton4e70a722017-11-28 22:57:101576 case RtpTransceiverDirection::kSendOnly:
henrike@webrtc.org28e20752013-07-10 00:45:361577 InitAttrLine(kAttributeSendOnly, &os);
1578 break;
Steve Anton4e70a722017-11-28 22:57:101579 case RtpTransceiverDirection::kRecvOnly:
henrike@webrtc.org28e20752013-07-10 00:45:361580 InitAttrLine(kAttributeRecvOnly, &os);
1581 break;
Steve Anton4e70a722017-11-28 22:57:101582 case RtpTransceiverDirection::kSendRecv:
Markus Handell45c104b2020-03-11 09:51:131583 InitAttrLine(kAttributeSendRecv, &os);
1584 break;
henrike@webrtc.org28e20752013-07-10 00:45:361585 default:
Markus Handell45c104b2020-03-11 09:51:131586 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:361587 InitAttrLine(kAttributeSendRecv, &os);
1588 break;
1589 }
1590 AddLine(os.str(), message);
1591
Seth Hampson5b4f0752018-04-02 23:31:361592 // Specified in https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
1593 // a=msid:<msid-id> <msid-appdata>
1594 // The msid-id is a 1*64 token char representing the media stream id, and the
1595 // msid-appdata is a 1*64 token char representing the track id. There is a
1596 // line for every media stream, with a special msid-id value of "-"
1597 // representing no streams. The value of "msid-appdata" MUST be identical for
1598 // all lines.
Steve Antone831b8c2018-02-01 20:22:161599 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
1600 const StreamParamsVec& streams = media_desc->streams();
1601 if (streams.size() == 1u) {
1602 const StreamParams& track = streams[0];
Seth Hampson5b4f0752018-04-02 23:31:361603 std::vector<std::string> stream_ids = track.stream_ids();
1604 if (stream_ids.empty()) {
1605 stream_ids.push_back(kNoStreamMsid);
1606 }
1607 for (const std::string& stream_id : stream_ids) {
1608 InitAttrLine(kAttributeMsid, &os);
1609 os << kSdpDelimiterColon << stream_id << kSdpDelimiterSpace << track.id;
1610 AddLine(os.str(), message);
1611 }
Steve Antone831b8c2018-02-01 20:22:161612 } else if (streams.size() > 1u) {
1613 RTC_LOG(LS_WARNING)
1614 << "Trying to serialize Unified Plan SDP with more than "
Jonas Olsson45cc8902018-02-13 09:37:071615 "one track in a media section. Omitting 'a=msid'.";
deadbeef9d3584c2016-02-17 01:54:101616 }
1617 }
1618
henrike@webrtc.org28e20752013-07-10 00:45:361619 // RFC 5761
1620 // a=rtcp-mux
1621 if (media_desc->rtcp_mux()) {
1622 InitAttrLine(kAttributeRtcpMux, &os);
1623 AddLine(os.str(), message);
1624 }
1625
deadbeef13871492015-12-09 20:37:511626 // RFC 5506
1627 // a=rtcp-rsize
1628 if (media_desc->rtcp_reduced_size()) {
1629 InitAttrLine(kAttributeRtcpReducedSize, &os);
1630 AddLine(os.str(), message);
1631 }
1632
deadbeefd45aea82017-09-16 08:24:291633 if (media_desc->conference_mode()) {
1634 InitAttrLine(kAttributeXGoogleFlag, &os);
1635 os << kSdpDelimiterColon << kValueConference;
1636 AddLine(os.str(), message);
1637 }
1638
Sebastian Janssone1795f42019-07-24 09:38:031639 if (media_desc->remote_estimate()) {
1640 InitAttrLine(kAttributeRtcpRemoteEstimate, &os);
1641 AddLine(os.str(), message);
1642 }
1643
henrike@webrtc.org28e20752013-07-10 00:45:361644 // RFC 4568
1645 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
Steve Anton4daf66e2018-09-07 21:55:531646 for (const CryptoParams& crypto_params : media_desc->cryptos()) {
henrike@webrtc.org28e20752013-07-10 00:45:361647 InitAttrLine(kAttributeCrypto, &os);
Steve Anton4daf66e2018-09-07 21:55:531648 os << kSdpDelimiterColon << crypto_params.tag << " "
1649 << crypto_params.cipher_suite << " " << crypto_params.key_params;
1650 if (!crypto_params.session_params.empty()) {
1651 os << " " << crypto_params.session_params;
henrike@webrtc.org28e20752013-07-10 00:45:361652 }
1653 AddLine(os.str(), message);
1654 }
1655
1656 // RFC 4566
1657 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1658 // [/<encodingparameters>]
1659 BuildRtpMap(media_desc, media_type, message);
1660
Steve Anton4daf66e2018-09-07 21:55:531661 for (const StreamParams& track : media_desc->streams()) {
henrike@webrtc.org28e20752013-07-10 00:45:361662 // Build the ssrc-group lines.
Steve Anton4daf66e2018-09-07 21:55:531663 for (const SsrcGroup& ssrc_group : track.ssrc_groups) {
henrike@webrtc.org28e20752013-07-10 00:45:361664 // RFC 5576
1665 // a=ssrc-group:<semantics> <ssrc-id> ...
Steve Anton4daf66e2018-09-07 21:55:531666 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:361667 continue;
1668 }
henrike@webrtc.org28e20752013-07-10 00:45:361669 InitAttrLine(kAttributeSsrcGroup, &os);
Steve Anton4daf66e2018-09-07 21:55:531670 os << kSdpDelimiterColon << ssrc_group.semantics;
1671 for (uint32_t ssrc : ssrc_group.ssrcs) {
1672 os << kSdpDelimiterSpace << rtc::ToString(ssrc);
henrike@webrtc.org28e20752013-07-10 00:45:361673 }
1674 AddLine(os.str(), message);
1675 }
1676 // Build the ssrc lines for each ssrc.
Steve Anton4daf66e2018-09-07 21:55:531677 for (uint32_t ssrc : track.ssrcs) {
henrike@webrtc.org28e20752013-07-10 00:45:361678 // RFC 5576
1679 // a=ssrc:<ssrc-id> cname:<value>
Steve Anton4daf66e2018-09-07 21:55:531680 AddSsrcLine(ssrc, kSsrcAttributeCname, track.cname, message);
henrike@webrtc.org28e20752013-07-10 00:45:361681
Steve Antone831b8c2018-02-01 20:22:161682 if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
1683 // draft-alvestrand-mmusic-msid-00
1684 // a=ssrc:<ssrc-id> msid:identifier [appdata]
1685 // The appdata consists of the "id" attribute of a MediaStreamTrack,
1686 // which corresponds to the "id" attribute of StreamParams.
Seth Hampson5b4f0752018-04-02 23:31:361687 // Since a=ssrc msid signaling is used in Plan B SDP semantics, and
1688 // multiple stream ids are not supported for Plan B, we are only adding
1689 // a line for the first media stream id here.
Seth Hampson7fa6ee62018-10-17 17:25:281690 const std::string& track_stream_id = track.first_stream_id();
1691 // We use a special msid-id value of "-" to represent no streams,
1692 // for Unified Plan compatibility. Plan B will always have a
1693 // track_stream_id.
1694 const std::string& stream_id =
1695 track_stream_id.empty() ? kNoStreamMsid : track_stream_id;
Steve Antone831b8c2018-02-01 20:22:161696 InitAttrLine(kAttributeSsrc, &os);
1697 os << kSdpDelimiterColon << ssrc << kSdpDelimiterSpace
1698 << kSsrcAttributeMsid << kSdpDelimiterColon << stream_id
Steve Anton4daf66e2018-09-07 21:55:531699 << kSdpDelimiterSpace << track.id;
Steve Antone831b8c2018-02-01 20:22:161700 AddLine(os.str(), message);
Artem Titovf0a34f22020-03-16 17:52:041701
1702 // TODO(ronghuawu): Remove below code which is for backward
1703 // compatibility.
1704 // draft-alvestrand-rtcweb-mid-01
1705 // a=ssrc:<ssrc-id> mslabel:<value>
1706 // The label isn't yet defined.
1707 // a=ssrc:<ssrc-id> label:<value>
1708 AddSsrcLine(ssrc, kSsrcAttributeMslabel, stream_id, message);
1709 AddSsrcLine(ssrc, kSSrcAttributeLabel, track.id, message);
Steve Antone831b8c2018-02-01 20:22:161710 }
henrike@webrtc.org28e20752013-07-10 00:45:361711 }
Amit Hilbuchc57d5732018-12-11 23:30:111712
1713 // Build the rid lines for each layer of the track
1714 for (const RidDescription& rid_description : track.rids()) {
1715 InitAttrLine(kAttributeRid, &os);
1716 os << kSdpDelimiterColon
1717 << serializer.SerializeRidDescription(rid_description);
1718 AddLine(os.str(), message);
1719 }
1720 }
1721
Florent Castellib60141b2019-07-03 10:47:541722 for (const RidDescription& rid_description : media_desc->receive_rids()) {
1723 InitAttrLine(kAttributeRid, &os);
1724 os << kSdpDelimiterColon
1725 << serializer.SerializeRidDescription(rid_description);
1726 AddLine(os.str(), message);
1727 }
1728
Amit Hilbucha2012042018-12-03 19:35:051729 // Simulcast (a=simulcast)
1730 // https://tools.ietf.org/html/draft-ietf-mmusic-sdp-simulcast-13#section-5.1
Amit Hilbuchc57d5732018-12-11 23:30:111731 if (media_desc->HasSimulcast()) {
1732 const auto& simulcast = media_desc->simulcast_description();
Amit Hilbucha2012042018-12-03 19:35:051733 InitAttrLine(kAttributeSimulcast, &os);
Amit Hilbucha2012042018-12-03 19:35:051734 os << kSdpDelimiterColon
1735 << serializer.SerializeSimulcastDescription(simulcast);
1736 AddLine(os.str(), message);
1737 }
henrike@webrtc.org28e20752013-07-10 00:45:361738}
1739
Jonas Olssonec9e4922018-09-05 07:53:491740void WriteFmtpHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:361741 // fmtp header: a=fmtp:|payload_type| <parameters>
1742 // Add a=fmtp
1743 InitAttrLine(kAttributeFmtp, os);
1744 // Add :|payload_type|
1745 *os << kSdpDelimiterColon << payload_type;
1746}
1747
Mirta Dvornicic479a3c02019-06-04 13:38:501748void WritePacketizationHeader(int payload_type, rtc::StringBuilder* os) {
1749 // packetization header: a=packetization:|payload_type| <packetization_format>
1750 // Add a=packetization
1751 InitAttrLine(kAttributePacketization, os);
1752 // Add :|payload_type|
1753 *os << kSdpDelimiterColon << payload_type;
1754}
1755
Jonas Olssonec9e4922018-09-05 07:53:491756void WriteRtcpFbHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:361757 // rtcp-fb header: a=rtcp-fb:|payload_type|
1758 // <parameters>/<ccm <ccm_parameters>>
1759 // Add a=rtcp-fb
1760 InitAttrLine(kAttributeRtcpFb, os);
1761 // Add :
1762 *os << kSdpDelimiterColon;
1763 if (payload_type == kWildcardPayloadType) {
1764 *os << "*";
1765 } else {
1766 *os << payload_type;
1767 }
1768}
1769
1770void WriteFmtpParameter(const std::string& parameter_name,
1771 const std::string& parameter_value,
Jonas Olssonec9e4922018-09-05 07:53:491772 rtc::StringBuilder* os) {
Philipp Hanckef2a4ec12020-07-01 19:07:321773 if (parameter_name == "") {
1774 // RFC 2198 and RFC 4733 don't use key-value pairs.
1775 *os << parameter_value;
1776 } else {
1777 // fmtp parameters: |parameter_name|=|parameter_value|
1778 *os << parameter_name << kSdpDelimiterEqual << parameter_value;
1779 }
henrike@webrtc.org28e20752013-07-10 00:45:361780}
1781
henrike@webrtc.org28e20752013-07-10 00:45:361782bool IsFmtpParam(const std::string& name) {
ossuaa4b0772017-01-30 15:41:181783 // RFC 4855, section 3 specifies the mapping of media format parameters to SDP
1784 // parameters. Only ptime, maxptime, channels and rate are placed outside of
1785 // the fmtp line. In WebRTC, channels and rate are already handled separately
1786 // and thus not included in the CodecParameterMap.
1787 return name != kCodecParamPTime && name != kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:361788}
1789
Johannes Kron72d69152020-02-10 13:05:551790bool WriteFmtpParameters(const cricket::CodecParameterMap& parameters,
1791 rtc::StringBuilder* os) {
1792 bool empty = true;
1793 const char* delimiter = ""; // No delimiter before first parameter.
1794 for (const auto& entry : parameters) {
Steve Anton4daf66e2018-09-07 21:55:531795 const std::string& key = entry.first;
1796 const std::string& value = entry.second;
Johannes Kron72d69152020-02-10 13:05:551797
Steve Anton4daf66e2018-09-07 21:55:531798 if (IsFmtpParam(key)) {
Johannes Kron72d69152020-02-10 13:05:551799 *os << delimiter;
1800 // A semicolon before each subsequent parameter.
1801 delimiter = kSdpDelimiterSemicolon;
1802 WriteFmtpParameter(key, value, os);
1803 empty = false;
henrike@webrtc.org28e20752013-07-10 00:45:361804 }
1805 }
Johannes Kron72d69152020-02-10 13:05:551806
1807 return !empty;
henrike@webrtc.org28e20752013-07-10 00:45:361808}
1809
1810template <class T>
1811void AddFmtpLine(const T& codec, std::string* message) {
Jonas Olssonec9e4922018-09-05 07:53:491812 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:361813 WriteFmtpHeader(codec.id, &os);
Johannes Kron72d69152020-02-10 13:05:551814 os << kSdpDelimiterSpace;
1815 // Create FMTP line and check that it's nonempty.
1816 if (WriteFmtpParameters(codec.params, &os)) {
1817 AddLine(os.str(), message);
1818 }
henrike@webrtc.org28e20752013-07-10 00:45:361819 return;
1820}
1821
1822template <class T>
Mirta Dvornicic479a3c02019-06-04 13:38:501823void AddPacketizationLine(const T& codec, std::string* message) {
1824 if (!codec.packetization) {
1825 return;
1826 }
1827 rtc::StringBuilder os;
1828 WritePacketizationHeader(codec.id, &os);
1829 os << " " << *codec.packetization;
1830 AddLine(os.str(), message);
1831}
1832
1833template <class T>
henrike@webrtc.org28e20752013-07-10 00:45:361834void AddRtcpFbLines(const T& codec, std::string* message) {
Steve Anton4daf66e2018-09-07 21:55:531835 for (const cricket::FeedbackParam& param : codec.feedback_params.params()) {
Jonas Olssonec9e4922018-09-05 07:53:491836 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:361837 WriteRtcpFbHeader(codec.id, &os);
Steve Anton4daf66e2018-09-07 21:55:531838 os << " " << param.id();
1839 if (!param.param().empty()) {
1840 os << " " << param.param();
henrike@webrtc.org28e20752013-07-10 00:45:361841 }
1842 AddLine(os.str(), message);
1843 }
1844}
1845
1846bool GetMinValue(const std::vector<int>& values, int* value) {
1847 if (values.empty()) {
1848 return false;
1849 }
Steve Anton64b626b2019-01-29 01:25:261850 auto it = absl::c_min_element(values);
1851 *value = *it;
henrike@webrtc.org28e20752013-07-10 00:45:361852 return true;
1853}
1854
1855bool GetParameter(const std::string& name,
Yves Gerey665174f2018-06-19 13:03:051856 const cricket::CodecParameterMap& params,
1857 int* value) {
1858 std::map<std::string, std::string>::const_iterator found = params.find(name);
henrike@webrtc.org28e20752013-07-10 00:45:361859 if (found == params.end()) {
1860 return false;
1861 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:521862 if (!rtc::FromString(found->second, value)) {
wu@webrtc.org5e760e72014-04-02 23:19:091863 return false;
1864 }
henrike@webrtc.org28e20752013-07-10 00:45:361865 return true;
1866}
1867
1868void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 14:58:011869 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:361870 std::string* message) {
nisseede5da42017-01-12 13:15:361871 RTC_DCHECK(message != NULL);
1872 RTC_DCHECK(media_desc != NULL);
Jonas Olssonec9e4922018-09-05 07:53:491873 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:361874 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Anton4daf66e2018-09-07 21:55:531875 for (const cricket::VideoCodec& codec : media_desc->as_video()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:361876 // RFC 4566
1877 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1878 // [/<encodingparameters>]
Steve Anton4daf66e2018-09-07 21:55:531879 if (codec.id != kWildcardPayloadType) {
henrike@webrtc.org28e20752013-07-10 00:45:361880 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 21:55:531881 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
deadbeefe814a0d2017-02-26 02:15:091882 << cricket::kVideoCodecClockrate;
henrike@webrtc.org28e20752013-07-10 00:45:361883 AddLine(os.str(), message);
1884 }
Mirta Dvornicic479a3c02019-06-04 13:38:501885 AddPacketizationLine(codec, message);
Steve Anton4daf66e2018-09-07 21:55:531886 AddRtcpFbLines(codec, message);
1887 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:361888 }
1889 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
henrike@webrtc.org28e20752013-07-10 00:45:361890 std::vector<int> ptimes;
1891 std::vector<int> maxptimes;
1892 int max_minptime = 0;
Steve Anton4daf66e2018-09-07 21:55:531893 for (const cricket::AudioCodec& codec : media_desc->as_audio()->codecs()) {
1894 RTC_DCHECK(!codec.name.empty());
henrike@webrtc.org28e20752013-07-10 00:45:361895 // RFC 4566
1896 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1897 // [/<encodingparameters>]
1898 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 21:55:531899 os << kSdpDelimiterColon << codec.id << " ";
1900 os << codec.name << "/" << codec.clockrate;
1901 if (codec.channels != 1) {
1902 os << "/" << codec.channels;
henrike@webrtc.org28e20752013-07-10 00:45:361903 }
1904 AddLine(os.str(), message);
Steve Anton4daf66e2018-09-07 21:55:531905 AddRtcpFbLines(codec, message);
1906 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:361907 int minptime = 0;
Steve Anton4daf66e2018-09-07 21:55:531908 if (GetParameter(kCodecParamMinPTime, codec.params, &minptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:361909 max_minptime = std::max(minptime, max_minptime);
1910 }
1911 int ptime;
Steve Anton4daf66e2018-09-07 21:55:531912 if (GetParameter(kCodecParamPTime, codec.params, &ptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:361913 ptimes.push_back(ptime);
1914 }
1915 int maxptime;
Steve Anton4daf66e2018-09-07 21:55:531916 if (GetParameter(kCodecParamMaxPTime, codec.params, &maxptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:361917 maxptimes.push_back(maxptime);
1918 }
1919 }
1920 // Populate the maxptime attribute with the smallest maxptime of all codecs
1921 // under the same m-line.
1922 int min_maxptime = INT_MAX;
1923 if (GetMinValue(maxptimes, &min_maxptime)) {
1924 AddAttributeLine(kCodecParamMaxPTime, min_maxptime, message);
1925 }
nisseede5da42017-01-12 13:15:361926 RTC_DCHECK(min_maxptime > max_minptime);
henrike@webrtc.org28e20752013-07-10 00:45:361927 // Populate the ptime attribute with the smallest ptime or the largest
1928 // minptime, whichever is the largest, for all codecs under the same m-line.
1929 int ptime = INT_MAX;
1930 if (GetMinValue(ptimes, &ptime)) {
1931 ptime = std::min(ptime, min_maxptime);
1932 ptime = std::max(ptime, max_minptime);
1933 AddAttributeLine(kCodecParamPTime, ptime, message);
1934 }
1935 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 11:36:161936 if (media_desc->as_rtp_data()) {
1937 for (const cricket::RtpDataCodec& codec :
1938 media_desc->as_rtp_data()->codecs()) {
1939 // RFC 4566
1940 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1941 // [/<encodingparameters>]
1942 InitAttrLine(kAttributeRtpmap, &os);
1943 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
1944 << codec.clockrate;
1945 AddLine(os.str(), message);
1946 }
henrike@webrtc.org28e20752013-07-10 00:45:361947 }
1948 }
1949}
1950
1951void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-17 02:37:231952 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:361953 std::string* message) {
Jonas Olssonec9e4922018-09-05 07:53:491954 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:361955
Steve Anton4daf66e2018-09-07 21:55:531956 for (const Candidate& candidate : candidates) {
henrike@webrtc.org28e20752013-07-10 00:45:361957 // RFC 5245
1958 // a=candidate:<foundation> <component-id> <transport> <priority>
1959 // <connection-address> <port> typ <candidate-types>
1960 // [raddr <connection-address>] [rport <port>]
1961 // *(SP extension-att-name SP extension-att-value)
1962 std::string type;
1963 // Map the cricket candidate type to "host" / "srflx" / "prflx" / "relay"
Steve Anton4daf66e2018-09-07 21:55:531964 if (candidate.type() == cricket::LOCAL_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:361965 type = kCandidateHost;
Steve Anton4daf66e2018-09-07 21:55:531966 } else if (candidate.type() == cricket::STUN_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:361967 type = kCandidateSrflx;
Steve Anton4daf66e2018-09-07 21:55:531968 } else if (candidate.type() == cricket::RELAY_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:361969 type = kCandidateRelay;
Steve Anton4daf66e2018-09-07 21:55:531970 } else if (candidate.type() == cricket::PRFLX_PORT_TYPE) {
Honghai Zhang7fb69db2016-03-14 18:59:181971 type = kCandidatePrflx;
1972 // Peer reflexive candidate may be signaled for being removed.
henrike@webrtc.org28e20752013-07-10 00:45:361973 } else {
nissec80e7412017-01-11 13:56:461974 RTC_NOTREACHED();
Peter Thatcher019087f2015-04-28 16:06:261975 // Never write out candidates if we don't know the type.
1976 continue;
henrike@webrtc.org28e20752013-07-10 00:45:361977 }
1978
1979 InitAttrLine(kAttributeCandidate, &os);
Steve Anton4daf66e2018-09-07 21:55:531980 os << kSdpDelimiterColon << candidate.foundation() << " "
1981 << candidate.component() << " " << candidate.protocol() << " "
1982 << candidate.priority() << " "
1983 << (candidate.address().ipaddr().IsNil()
1984 ? candidate.address().hostname()
1985 : candidate.address().ipaddr().ToString())
1986 << " " << candidate.address().PortAsString() << " "
1987 << kAttributeCandidateTyp << " " << type << " ";
henrike@webrtc.org28e20752013-07-10 00:45:361988
1989 // Related address
Steve Anton4daf66e2018-09-07 21:55:531990 if (!candidate.related_address().IsNil()) {
henrike@webrtc.org28e20752013-07-10 00:45:361991 os << kAttributeCandidateRaddr << " "
Steve Anton4daf66e2018-09-07 21:55:531992 << candidate.related_address().ipaddr().ToString() << " "
henrike@webrtc.org28e20752013-07-10 00:45:361993 << kAttributeCandidateRport << " "
Steve Anton4daf66e2018-09-07 21:55:531994 << candidate.related_address().PortAsString() << " ";
henrike@webrtc.org28e20752013-07-10 00:45:361995 }
1996
Taylor Brandstetter8206bc02020-04-02 19:36:381997 // Note that we allow the tcptype to be missing, for backwards
1998 // compatibility; the implementation treats this as a passive candidate.
1999 // TODO(bugs.webrtc.org/11466): Treat a missing tcptype as an error?
2000 if (candidate.protocol() == cricket::TCP_PROTOCOL_NAME &&
2001 !candidate.tcptype().empty()) {
Steve Anton4daf66e2018-09-07 21:55:532002 os << kTcpCandidateType << " " << candidate.tcptype() << " ";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:202003 }
2004
henrike@webrtc.org28e20752013-07-10 00:45:362005 // Extensions
Steve Anton4daf66e2018-09-07 21:55:532006 os << kAttributeCandidateGeneration << " " << candidate.generation();
2007 if (include_ufrag && !candidate.username().empty()) {
2008 os << " " << kAttributeCandidateUfrag << " " << candidate.username();
honghaiza54a0802015-12-17 02:37:232009 }
Steve Anton4daf66e2018-09-07 21:55:532010 if (candidate.network_id() > 0) {
2011 os << " " << kAttributeCandidateNetworkId << " "
2012 << candidate.network_id();
honghaiza0c44ea2016-03-23 23:07:482013 }
Steve Anton4daf66e2018-09-07 21:55:532014 if (candidate.network_cost() > 0) {
2015 os << " " << kAttributeCandidateNetworkCost << " "
2016 << candidate.network_cost();
honghaize1a0c942016-02-16 22:54:562017 }
henrike@webrtc.org28e20752013-07-10 00:45:362018
2019 AddLine(os.str(), message);
2020 }
2021}
2022
2023void BuildIceOptions(const std::vector<std::string>& transport_options,
2024 std::string* message) {
2025 if (!transport_options.empty()) {
Jonas Olssonec9e4922018-09-05 07:53:492026 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:362027 InitAttrLine(kAttributeIceOption, &os);
2028 os << kSdpDelimiterColon << transport_options[0];
2029 for (size_t i = 1; i < transport_options.size(); ++i) {
2030 os << kSdpDelimiterSpace << transport_options[i];
2031 }
2032 AddLine(os.str(), message);
2033 }
2034}
2035
zhihuang38989e52017-03-21 18:04:532036bool ParseConnectionData(const std::string& line,
2037 rtc::SocketAddress* addr,
2038 SdpParseError* error) {
2039 // Parse the line from left to right.
2040 std::string token;
2041 std::string rightpart;
2042 // RFC 4566
2043 // c=<nettype> <addrtype> <connection-address>
2044 // Skip the "c="
Jonas Olssonec9e4922018-09-05 07:53:492045 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, &token, &rightpart)) {
zhihuang38989e52017-03-21 18:04:532046 return ParseFailed(line, "Failed to parse the network type.", error);
2047 }
2048
2049 // Extract and verify the <nettype>
Jonas Olssonec9e4922018-09-05 07:53:492050 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2051 &rightpart) ||
zhihuang38989e52017-03-21 18:04:532052 token != kConnectionNettype) {
2053 return ParseFailed(line,
2054 "Failed to parse the connection data. The network type "
2055 "is not currently supported.",
2056 error);
2057 }
2058
2059 // Extract the "<addrtype>" and "<connection-address>".
Jonas Olssonec9e4922018-09-05 07:53:492060 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2061 &rightpart)) {
zhihuang38989e52017-03-21 18:04:532062 return ParseFailed(line, "Failed to parse the address type.", error);
2063 }
2064
2065 // The rightpart part should be the IP address without the slash which is used
2066 // for multicast.
2067 if (rightpart.find('/') != std::string::npos) {
2068 return ParseFailed(line,
2069 "Failed to parse the connection data. Multicast is not "
2070 "currently supported.",
2071 error);
2072 }
2073 addr->SetIP(rightpart);
2074
2075 // Verify that the addrtype matches the type of the parsed address.
2076 if ((addr->family() == AF_INET && token != "IP4") ||
2077 (addr->family() == AF_INET6 && token != "IP6")) {
2078 addr->Clear();
2079 return ParseFailed(
2080 line,
2081 "Failed to parse the connection data. The address type is mismatching.",
2082 error);
2083 }
2084 return true;
2085}
2086
2087bool ParseSessionDescription(const std::string& message,
2088 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:362089 std::string* session_id,
2090 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:362091 TransportDescription* session_td,
2092 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 18:04:532093 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:362094 cricket::SessionDescription* desc,
2095 SdpParseError* error) {
2096 std::string line;
2097
deadbeefc80741f2015-10-22 20:14:452098 desc->set_msid_supported(false);
Johannes Kron9581bc42018-10-23 08:17:392099 desc->set_extmap_allow_mixed(false);
henrike@webrtc.org28e20752013-07-10 00:45:362100 // RFC 4566
2101 // v= (protocol version)
2102 if (!GetLineWithType(message, pos, &line, kLineTypeVersion)) {
Yves Gerey665174f2018-06-19 13:03:052103 return ParseFailedExpectLine(message, *pos, kLineTypeVersion, std::string(),
2104 error);
henrike@webrtc.org28e20752013-07-10 00:45:362105 }
2106 // RFC 4566
2107 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
2108 // <unicast-address>
2109 if (!GetLineWithType(message, pos, &line, kLineTypeOrigin)) {
Yves Gerey665174f2018-06-19 13:03:052110 return ParseFailedExpectLine(message, *pos, kLineTypeOrigin, std::string(),
2111 error);
henrike@webrtc.org28e20752013-07-10 00:45:362112 }
2113 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:492114 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:362115 const size_t expected_fields = 6;
2116 if (fields.size() != expected_fields) {
2117 return ParseFailedExpectFieldNum(line, expected_fields, error);
2118 }
2119 *session_id = fields[1];
2120 *session_version = fields[2];
2121
2122 // RFC 4566
2123 // s= (session name)
2124 if (!GetLineWithType(message, pos, &line, kLineTypeSessionName)) {
2125 return ParseFailedExpectLine(message, *pos, kLineTypeSessionName,
2126 std::string(), error);
2127 }
2128
Danil Chapovalov66cadcc2018-06-19 14:47:432129 // absl::optional lines
henrike@webrtc.org28e20752013-07-10 00:45:362130 // Those are the optional lines, so shouldn't return false if not present.
2131 // RFC 4566
2132 // i=* (session information)
2133 GetLineWithType(message, pos, &line, kLineTypeSessionInfo);
2134
2135 // RFC 4566
2136 // u=* (URI of description)
2137 GetLineWithType(message, pos, &line, kLineTypeSessionUri);
2138
2139 // RFC 4566
2140 // e=* (email address)
2141 GetLineWithType(message, pos, &line, kLineTypeSessionEmail);
2142
2143 // RFC 4566
2144 // p=* (phone number)
2145 GetLineWithType(message, pos, &line, kLineTypeSessionPhone);
2146
2147 // RFC 4566
2148 // c=* (connection information -- not required if included in
2149 // all media)
zhihuang38989e52017-03-21 18:04:532150 if (GetLineWithType(message, pos, &line, kLineTypeConnection)) {
2151 if (!ParseConnectionData(line, connection_addr, error)) {
2152 return false;
2153 }
2154 }
henrike@webrtc.org28e20752013-07-10 00:45:362155
2156 // RFC 4566
2157 // b=* (zero or more bandwidth information lines)
2158 while (GetLineWithType(message, pos, &line, kLineTypeSessionBandwidth)) {
2159 // By pass zero or more b lines.
2160 }
2161
2162 // RFC 4566
2163 // One or more time descriptions ("t=" and "r=" lines; see below)
2164 // t= (time the session is active)
2165 // r=* (zero or more repeat times)
2166 // Ensure there's at least one time description
2167 if (!GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2168 return ParseFailedExpectLine(message, *pos, kLineTypeTiming, std::string(),
2169 error);
2170 }
2171
2172 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2173 // By pass zero or more r lines.
2174 }
2175
2176 // Go through the rest of the time descriptions
2177 while (GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2178 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2179 // By pass zero or more r lines.
2180 }
2181 }
2182
2183 // RFC 4566
2184 // z=* (time zone adjustments)
2185 GetLineWithType(message, pos, &line, kLineTypeTimeZone);
2186
2187 // RFC 4566
2188 // k=* (encryption key)
2189 GetLineWithType(message, pos, &line, kLineTypeEncryptionKey);
2190
2191 // RFC 4566
2192 // a=* (zero or more session attribute lines)
2193 while (GetLineWithType(message, pos, &line, kLineTypeAttributes)) {
2194 if (HasAttribute(line, kAttributeGroup)) {
2195 if (!ParseGroupAttribute(line, desc, error)) {
2196 return false;
2197 }
2198 } else if (HasAttribute(line, kAttributeIceUfrag)) {
Yves Gerey665174f2018-06-19 13:03:052199 if (!GetValue(line, kAttributeIceUfrag, &(session_td->ice_ufrag),
2200 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:362201 return false;
2202 }
2203 } else if (HasAttribute(line, kAttributeIcePwd)) {
2204 if (!GetValue(line, kAttributeIcePwd, &(session_td->ice_pwd), error)) {
2205 return false;
2206 }
2207 } else if (HasAttribute(line, kAttributeIceLite)) {
2208 session_td->ice_mode = cricket::ICEMODE_LITE;
2209 } else if (HasAttribute(line, kAttributeIceOption)) {
2210 if (!ParseIceOptions(line, &(session_td->transport_options), error)) {
2211 return false;
2212 }
2213 } else if (HasAttribute(line, kAttributeFingerprint)) {
2214 if (session_td->identity_fingerprint.get()) {
2215 return ParseFailed(
2216 line,
2217 "Can't have multiple fingerprint attributes at the same level.",
2218 error);
2219 }
Steve Anton4905edb2018-10-16 02:27:442220 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:362221 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2222 return false;
2223 }
Steve Anton4905edb2018-10-16 02:27:442224 session_td->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:252225 } else if (HasAttribute(line, kAttributeSetup)) {
2226 if (!ParseDtlsSetup(line, &(session_td->connection_role), error)) {
2227 return false;
2228 }
henrike@webrtc.org28e20752013-07-10 00:45:362229 } else if (HasAttribute(line, kAttributeMsidSemantics)) {
2230 std::string semantics;
2231 if (!GetValue(line, kAttributeMsidSemantics, &semantics, error)) {
2232 return false;
2233 }
deadbeefc80741f2015-10-22 20:14:452234 desc->set_msid_supported(
2235 CaseInsensitiveFind(semantics, kMediaStreamSemantic));
Johannes Kron0854eb62018-10-10 20:33:202236 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 08:17:392237 desc->set_extmap_allow_mixed(true);
henrike@webrtc.org28e20752013-07-10 00:45:362238 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 18:24:552239 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:362240 if (!ParseExtmap(line, &extmap, error)) {
2241 return false;
2242 }
2243 session_extmaps->push_back(extmap);
2244 }
2245 }
2246
2247 return true;
2248}
2249
2250bool ParseGroupAttribute(const std::string& line,
2251 cricket::SessionDescription* desc,
2252 SdpParseError* error) {
nisseede5da42017-01-12 13:15:362253 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:362254
2255 // RFC 5888 and draft-holmberg-mmusic-sdp-bundle-negotiation-00
2256 // a=group:BUNDLE video voice
2257 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:492258 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:362259 std::string semantics;
2260 if (!GetValue(fields[0], kAttributeGroup, &semantics, error)) {
2261 return false;
2262 }
2263 cricket::ContentGroup group(semantics);
2264 for (size_t i = 1; i < fields.size(); ++i) {
2265 group.AddContentName(fields[i]);
2266 }
2267 desc->AddGroup(group);
2268 return true;
2269}
2270
Steve Anton4905edb2018-10-16 02:27:442271static bool ParseFingerprintAttribute(
2272 const std::string& line,
2273 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
2274 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:362275 if (!IsLineType(line, kLineTypeAttributes) ||
2276 !HasAttribute(line, kAttributeFingerprint)) {
2277 return ParseFailedExpectLine(line, 0, kLineTypeAttributes,
2278 kAttributeFingerprint, error);
2279 }
2280
2281 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:492282 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:362283 const size_t expected_fields = 2;
2284 if (fields.size() != expected_fields) {
2285 return ParseFailedExpectFieldNum(line, expected_fields, error);
2286 }
2287
2288 // The first field here is "fingerprint:<hash>.
2289 std::string algorithm;
2290 if (!GetValue(fields[0], kAttributeFingerprint, &algorithm, error)) {
2291 return false;
2292 }
2293
2294 // Downcase the algorithm. Note that we don't need to downcase the
2295 // fingerprint because hex_decode can handle upper-case.
Steve Anton64b626b2019-01-29 01:25:262296 absl::c_transform(algorithm, algorithm.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:362297
2298 // The second field is the digest value. De-hexify it.
Steve Anton4905edb2018-10-16 02:27:442299 *fingerprint =
2300 rtc::SSLFingerprint::CreateUniqueFromRfc4572(algorithm, fields[1]);
henrike@webrtc.org28e20752013-07-10 00:45:362301 if (!*fingerprint) {
Yves Gerey665174f2018-06-19 13:03:052302 return ParseFailed(line, "Failed to create fingerprint from the digest.",
henrike@webrtc.org28e20752013-07-10 00:45:362303 error);
2304 }
2305
2306 return true;
2307}
2308
sergeyu@chromium.org0be6aa02013-08-23 23:21:252309static bool ParseDtlsSetup(const std::string& line,
2310 cricket::ConnectionRole* role,
2311 SdpParseError* error) {
2312 // setup-attr = "a=setup:" role
2313 // role = "active" / "passive" / "actpass" / "holdconn"
2314 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:492315 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
sergeyu@chromium.org0be6aa02013-08-23 23:21:252316 const size_t expected_fields = 2;
2317 if (fields.size() != expected_fields) {
2318 return ParseFailedExpectFieldNum(line, expected_fields, error);
2319 }
2320 std::string role_str = fields[1];
2321 if (!cricket::StringToConnectionRole(role_str, role)) {
2322 return ParseFailed(line, "Invalid attribute value.", error);
2323 }
2324 return true;
2325}
2326
deadbeef9d3584c2016-02-17 01:54:102327static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 23:31:362328 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-17 01:54:102329 std::string* track_id,
2330 SdpParseError* error) {
Seth Hampson5b4f0752018-04-02 23:31:362331 // https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
deadbeef9d3584c2016-02-17 01:54:102332 // a=msid:<stream id> <track id>
2333 // msid-value = msid-id [ SP msid-appdata ]
2334 // msid-id = 1*64token-char ; see RFC 4566
2335 // msid-appdata = 1*64token-char ; see RFC 4566
2336 std::string field1;
Seth Hampson5b4f0752018-04-02 23:31:362337 std::string new_stream_id;
2338 std::string new_track_id;
Jonas Olssonec9e4922018-09-05 07:53:492339 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
2340 kSdpDelimiterSpaceChar, &field1, &new_track_id)) {
deadbeef9d3584c2016-02-17 01:54:102341 const size_t expected_fields = 2;
2342 return ParseFailedExpectFieldNum(line, expected_fields, error);
2343 }
2344
Seth Hampson5b4f0752018-04-02 23:31:362345 if (new_track_id.empty()) {
deadbeefa4549d62017-02-11 01:26:222346 return ParseFailed(line, "Missing track ID in msid attribute.", error);
2347 }
Seth Hampson5b4f0752018-04-02 23:31:362348 // All track ids should be the same within an m section in a Unified Plan SDP.
2349 if (!track_id->empty() && new_track_id.compare(*track_id) != 0) {
2350 return ParseFailed(
2351 line, "Two different track IDs in msid attribute in one m= section",
2352 error);
2353 }
2354 *track_id = new_track_id;
deadbeefa4549d62017-02-11 01:26:222355
deadbeef9d3584c2016-02-17 01:54:102356 // msid:<msid-id>
Seth Hampson5b4f0752018-04-02 23:31:362357 if (!GetValue(field1, kAttributeMsid, &new_stream_id, error)) {
deadbeef9d3584c2016-02-17 01:54:102358 return false;
2359 }
Seth Hampson5b4f0752018-04-02 23:31:362360 if (new_stream_id.empty()) {
deadbeefa4549d62017-02-11 01:26:222361 return ParseFailed(line, "Missing stream ID in msid attribute.", error);
2362 }
Seth Hampson5b4f0752018-04-02 23:31:362363 // The special value "-" indicates "no MediaStream".
2364 if (new_stream_id.compare(kNoStreamMsid) != 0) {
2365 stream_ids->push_back(new_stream_id);
2366 }
deadbeef9d3584c2016-02-17 01:54:102367 return true;
2368}
2369
Amit Hilbuchc57d5732018-12-11 23:30:112370static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
2371 std::vector<RidDescription>* rids) {
2372 RTC_DCHECK(rids);
2373 std::set<std::string> to_remove;
2374 std::set<std::string> unique_rids;
2375
2376 // Check the rids to see which ones should be removed.
2377 for (RidDescription& rid : *rids) {
2378 // In the case of a duplicate, the entire "a=rid" line, and all "a=rid"
2379 // lines with rid-ids that duplicate this line, are discarded and MUST NOT
2380 // be included in the SDP Answer.
2381 auto pair = unique_rids.insert(rid.rid);
2382 // Insert will "fail" if element already exists.
2383 if (!pair.second) {
2384 to_remove.insert(rid.rid);
2385 continue;
2386 }
2387
2388 // If the "a=rid" line contains a "pt=", the list of payload types
2389 // is verified against the list of valid payload types for the media
2390 // section (that is, those listed on the "m=" line). Any PT missing
2391 // from the "m=" line is discarded from the set of values in the
2392 // "pt=". If no values are left in the "pt=" parameter after this
2393 // processing, then the "a=rid" line is discarded.
2394 if (rid.payload_types.empty()) {
2395 // If formats were not specified, rid should not be removed.
2396 continue;
2397 }
2398
2399 // Note: Spec does not mention how to handle duplicate formats.
2400 // Media section does not handle duplicates either.
2401 std::set<int> removed_formats;
2402 for (int payload_type : rid.payload_types) {
Steve Anton64b626b2019-01-29 01:25:262403 if (!absl::c_linear_search(payload_types, payload_type)) {
Amit Hilbuchc57d5732018-12-11 23:30:112404 removed_formats.insert(payload_type);
2405 }
2406 }
2407
2408 rid.payload_types.erase(
2409 std::remove_if(rid.payload_types.begin(), rid.payload_types.end(),
2410 [&removed_formats](int format) {
2411 return removed_formats.count(format) > 0;
2412 }),
2413 rid.payload_types.end());
2414
2415 // If all formats were removed then remove the rid alogether.
2416 if (rid.payload_types.empty()) {
2417 to_remove.insert(rid.rid);
2418 }
2419 }
2420
2421 // Remove every rid description that appears in the to_remove list.
2422 if (!to_remove.empty()) {
2423 rids->erase(std::remove_if(rids->begin(), rids->end(),
2424 [&to_remove](const RidDescription& rid) {
2425 return to_remove.count(rid.rid) > 0;
2426 }),
2427 rids->end());
2428 }
2429}
2430
2431// Create a new list (because SimulcastLayerList is immutable) without any
2432// layers that have a rid in the to_remove list.
2433// If a group of alternatives is empty after removing layers, the group should
2434// be removed altogether.
2435static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
2436 const std::set<std::string>& to_remove,
2437 const SimulcastLayerList& layers) {
2438 SimulcastLayerList result;
2439 for (const std::vector<SimulcastLayer>& vector : layers) {
2440 std::vector<SimulcastLayer> new_layers;
2441 for (const SimulcastLayer& layer : vector) {
2442 if (to_remove.find(layer.rid) == to_remove.end()) {
2443 new_layers.push_back(layer);
2444 }
2445 }
2446 // If all layers were removed, do not add an entry.
2447 if (!new_layers.empty()) {
2448 result.AddLayerWithAlternatives(new_layers);
2449 }
2450 }
2451
2452 return result;
2453}
2454
2455// Will remove Simulcast Layers if:
2456// 1. They appear in both send and receive directions.
2457// 2. They do not appear in the list of |valid_rids|.
2458static void RemoveInvalidRidsFromSimulcast(
2459 const std::vector<RidDescription>& valid_rids,
2460 SimulcastDescription* simulcast) {
2461 RTC_DCHECK(simulcast);
2462 std::set<std::string> to_remove;
2463 std::vector<SimulcastLayer> all_send_layers =
2464 simulcast->send_layers().GetAllLayers();
2465 std::vector<SimulcastLayer> all_receive_layers =
2466 simulcast->receive_layers().GetAllLayers();
2467
2468 // If a rid appears in both send and receive directions, remove it from both.
2469 // This algorithm runs in O(n^2) time, but for small n (as is the case with
2470 // simulcast layers) it should still perform well.
2471 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-29 01:25:262472 if (absl::c_any_of(all_receive_layers,
2473 [&send_layer](const SimulcastLayer& layer) {
2474 return layer.rid == send_layer.rid;
2475 })) {
Amit Hilbuchc57d5732018-12-11 23:30:112476 to_remove.insert(send_layer.rid);
2477 }
2478 }
2479
2480 // Add any rid that is not in the valid list to the remove set.
2481 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-29 01:25:262482 if (absl::c_none_of(valid_rids, [&send_layer](const RidDescription& rid) {
Florent Castellic4421972019-07-02 18:27:422483 return send_layer.rid == rid.rid &&
2484 rid.direction == cricket::RidDirection::kSend;
Steve Anton64b626b2019-01-29 01:25:262485 })) {
Amit Hilbuchc57d5732018-12-11 23:30:112486 to_remove.insert(send_layer.rid);
2487 }
2488 }
2489
2490 // Add any rid that is not in the valid list to the remove set.
2491 for (const SimulcastLayer& receive_layer : all_receive_layers) {
Florent Castellic4421972019-07-02 18:27:422492 if (absl::c_none_of(
2493 valid_rids, [&receive_layer](const RidDescription& rid) {
2494 return receive_layer.rid == rid.rid &&
2495 rid.direction == cricket::RidDirection::kReceive;
2496 })) {
Amit Hilbuchc57d5732018-12-11 23:30:112497 to_remove.insert(receive_layer.rid);
2498 }
2499 }
2500
2501 simulcast->send_layers() =
2502 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->send_layers());
2503 simulcast->receive_layers() =
2504 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->receive_layers());
2505}
2506
henrike@webrtc.org28e20752013-07-10 00:45:362507// RFC 3551
2508// PT encoding media type clock rate channels
2509// name (Hz)
2510// 0 PCMU A 8,000 1
2511// 1 reserved A
2512// 2 reserved A
2513// 3 GSM A 8,000 1
2514// 4 G723 A 8,000 1
2515// 5 DVI4 A 8,000 1
2516// 6 DVI4 A 16,000 1
2517// 7 LPC A 8,000 1
2518// 8 PCMA A 8,000 1
2519// 9 G722 A 8,000 1
2520// 10 L16 A 44,100 2
2521// 11 L16 A 44,100 1
2522// 12 QCELP A 8,000 1
2523// 13 CN A 8,000 1
2524// 14 MPA A 90,000 (see text)
2525// 15 G728 A 8,000 1
2526// 16 DVI4 A 11,025 1
2527// 17 DVI4 A 22,050 1
2528// 18 G729 A 8,000 1
2529struct StaticPayloadAudioCodec {
2530 const char* name;
2531 int clockrate;
Peter Kasting69558702016-01-13 00:26:352532 size_t channels;
henrike@webrtc.org28e20752013-07-10 00:45:362533};
2534static const StaticPayloadAudioCodec kStaticPayloadAudioCodecs[] = {
Yves Gerey665174f2018-06-19 13:03:052535 {"PCMU", 8000, 1}, {"reserved", 0, 0}, {"reserved", 0, 0},
2536 {"GSM", 8000, 1}, {"G723", 8000, 1}, {"DVI4", 8000, 1},
2537 {"DVI4", 16000, 1}, {"LPC", 8000, 1}, {"PCMA", 8000, 1},
2538 {"G722", 8000, 1}, {"L16", 44100, 2}, {"L16", 44100, 1},
2539 {"QCELP", 8000, 1}, {"CN", 8000, 1}, {"MPA", 90000, 1},
2540 {"G728", 8000, 1}, {"DVI4", 11025, 1}, {"DVI4", 22050, 1},
2541 {"G729", 8000, 1},
henrike@webrtc.org28e20752013-07-10 00:45:362542};
2543
Yves Gerey665174f2018-06-19 13:03:052544void MaybeCreateStaticPayloadAudioCodecs(const std::vector<int>& fmts,
2545 AudioContentDescription* media_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:362546 if (!media_desc) {
2547 return;
2548 }
deadbeef67cf2c12016-04-13 17:07:162549 RTC_DCHECK(media_desc->codecs().empty());
solenberg9fa49752016-10-08 20:02:442550 for (int payload_type : fmts) {
Yves Gerey665174f2018-06-19 13:03:052551 if (!media_desc->HasCodec(payload_type) && payload_type >= 0 &&
kjellander3e33bfe2016-06-20 14:04:092552 static_cast<uint32_t>(payload_type) <
2553 arraysize(kStaticPayloadAudioCodecs)) {
henrike@webrtc.org28e20752013-07-10 00:45:362554 std::string encoding_name = kStaticPayloadAudioCodecs[payload_type].name;
2555 int clock_rate = kStaticPayloadAudioCodecs[payload_type].clockrate;
Peter Kasting69558702016-01-13 00:26:352556 size_t channels = kStaticPayloadAudioCodecs[payload_type].channels;
henrike@webrtc.org28e20752013-07-10 00:45:362557 media_desc->AddCodec(cricket::AudioCodec(payload_type, encoding_name,
deadbeef67cf2c12016-04-13 17:07:162558 clock_rate, 0, channels));
henrike@webrtc.org28e20752013-07-10 00:45:362559 }
henrike@webrtc.org28e20752013-07-10 00:45:362560 }
2561}
2562
2563template <class C>
Steve Anton5a1de872018-12-18 19:25:552564static std::unique_ptr<C> ParseContentDescription(
2565 const std::string& message,
2566 const cricket::MediaType media_type,
2567 int mline_index,
2568 const std::string& protocol,
2569 const std::vector<int>& payload_types,
2570 size_t* pos,
2571 std::string* content_name,
2572 bool* bundle_only,
2573 int* msid_signaling,
2574 TransportDescription* transport,
2575 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2576 webrtc::SdpParseError* error) {
Mirko Bonadei317a1f02019-09-17 15:06:182577 auto media_desc = std::make_unique<C>();
deadbeef67cf2c12016-04-13 17:07:162578 if (!ParseContent(message, media_type, mline_index, protocol, payload_types,
Steve Anton5a1de872018-12-18 19:25:552579 pos, content_name, bundle_only, msid_signaling,
2580 media_desc.get(), transport, candidates, error)) {
zhihuang38989e52017-03-21 18:04:532581 return nullptr;
henrike@webrtc.org28e20752013-07-10 00:45:362582 }
2583 // Sort the codecs according to the m-line fmt list.
deadbeef67cf2c12016-04-13 17:07:162584 std::unordered_map<int, int> payload_type_preferences;
2585 // "size + 1" so that the lowest preference payload type has a preference of
2586 // 1, which is greater than the default (0) for payload types not in the fmt
2587 // list.
2588 int preference = static_cast<int>(payload_types.size() + 1);
2589 for (int pt : payload_types) {
2590 payload_type_preferences[pt] = preference--;
2591 }
2592 std::vector<typename C::CodecType> codecs = media_desc->codecs();
Steve Anton64b626b2019-01-29 01:25:262593 absl::c_sort(
2594 codecs, [&payload_type_preferences](const typename C::CodecType& a,
2595 const typename C::CodecType& b) {
2596 return payload_type_preferences[a.id] > payload_type_preferences[b.id];
2597 });
deadbeef67cf2c12016-04-13 17:07:162598 media_desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:362599 return media_desc;
2600}
2601
Steve Anton5a1de872018-12-18 19:25:552602bool ParseMediaDescription(
2603 const std::string& message,
2604 const TransportDescription& session_td,
2605 const RtpHeaderExtensions& session_extmaps,
2606 size_t* pos,
2607 const rtc::SocketAddress& session_connection_addr,
2608 cricket::SessionDescription* desc,
2609 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2610 SdpParseError* error) {
nisseede5da42017-01-12 13:15:362611 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:362612 std::string line;
2613 int mline_index = -1;
Steve Antone831b8c2018-02-01 20:22:162614 int msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:362615
2616 // Zero or more media descriptions
2617 // RFC 4566
2618 // m=<media> <port> <proto> <fmt>
2619 while (GetLineWithType(message, pos, &line, kLineTypeMedia)) {
2620 ++mline_index;
2621
2622 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:492623 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
zstein4b2e0822017-02-18 03:48:382624
henrike@webrtc.org28e20752013-07-10 00:45:362625 const size_t expected_min_fields = 4;
2626 if (fields.size() < expected_min_fields) {
2627 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
2628 }
deadbeef25ed4352016-12-13 02:37:362629 bool port_rejected = false;
henrike@webrtc.org28e20752013-07-10 00:45:362630 // RFC 3264
2631 // To reject an offered stream, the port number in the corresponding stream
2632 // in the answer MUST be set to zero.
2633 if (fields[1] == kMediaPortRejected) {
deadbeef25ed4352016-12-13 02:37:362634 port_rejected = true;
henrike@webrtc.org28e20752013-07-10 00:45:362635 }
2636
zhihuang38989e52017-03-21 18:04:532637 int port = 0;
2638 if (!rtc::FromString<int>(fields[1], &port) || !IsValidPort(port)) {
2639 return ParseFailed(line, "The port number is invalid", error);
2640 }
Philipp Hancke6fb70042020-06-29 10:32:082641 const std::string& protocol = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:362642
2643 // <fmt>
deadbeef67cf2c12016-04-13 17:07:162644 std::vector<int> payload_types;
Harald Alvestrand5fc28b12019-05-13 11:36:162645 if (cricket::IsRtpProtocol(protocol)) {
Yves Gerey665174f2018-06-19 13:03:052646 for (size_t j = 3; j < fields.size(); ++j) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:562647 int pl = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:282648 if (!GetPayloadTypeFromString(line, fields[j], &pl, error)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:562649 return false;
2650 }
deadbeef67cf2c12016-04-13 17:07:162651 payload_types.push_back(pl);
wu@webrtc.org5e760e72014-04-02 23:19:092652 }
henrike@webrtc.org28e20752013-07-10 00:45:362653 }
2654
2655 // Make a temporary TransportDescription based on |session_td|.
2656 // Some of this gets overwritten by ParseContent.
deadbeef46eed762016-01-28 21:24:372657 TransportDescription transport(
2658 session_td.transport_options, session_td.ice_ufrag, session_td.ice_pwd,
2659 session_td.ice_mode, session_td.connection_role,
2660 session_td.identity_fingerprint.get());
henrike@webrtc.org28e20752013-07-10 00:45:362661
kwibergd1fe2812016-04-27 13:47:292662 std::unique_ptr<MediaContentDescription> content;
henrike@webrtc.org28e20752013-07-10 00:45:362663 std::string content_name;
deadbeef25ed4352016-12-13 02:37:362664 bool bundle_only = false;
Steve Antone831b8c2018-02-01 20:22:162665 int section_msid_signaling = 0;
Philipp Hancke6fb70042020-06-29 10:32:082666 const std::string& media_type = fields[0];
2667 if (media_type == kMediaTypeVideo) {
Steve Anton5a1de872018-12-18 19:25:552668 content = ParseContentDescription<VideoContentDescription>(
deadbeef67cf2c12016-04-13 17:07:162669 message, cricket::MEDIA_TYPE_VIDEO, mline_index, protocol,
Steve Antone831b8c2018-02-01 20:22:162670 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 19:25:552671 &section_msid_signaling, &transport, candidates, error);
Philipp Hancke6fb70042020-06-29 10:32:082672 } else if (media_type == kMediaTypeAudio) {
Steve Anton5a1de872018-12-18 19:25:552673 content = ParseContentDescription<AudioContentDescription>(
deadbeef67cf2c12016-04-13 17:07:162674 message, cricket::MEDIA_TYPE_AUDIO, mline_index, protocol,
Steve Antone831b8c2018-02-01 20:22:162675 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 19:25:552676 &section_msid_signaling, &transport, candidates, error);
Philipp Hancke6fb70042020-06-29 10:32:082677 } else if (media_type == kMediaTypeData) {
Harald Alvestrand5fc28b12019-05-13 11:36:162678 if (cricket::IsDtlsSctp(protocol)) {
2679 // The draft-03 format is:
2680 // m=application <port> DTLS/SCTP <sctp-port>...
2681 // use_sctpmap should be false.
2682 // The draft-26 format is:
2683 // m=application <port> UDP/DTLS/SCTP webrtc-datachannel
2684 // use_sctpmap should be false.
Mirko Bonadei317a1f02019-09-17 15:06:182685 auto data_desc = std::make_unique<SctpDataContentDescription>();
Harald Alvestrandfbb45bd2019-05-15 06:07:472686 // Default max message size is 64K
2687 // according to draft-ietf-mmusic-sctp-sdp-26
2688 data_desc->set_max_message_size(kDefaultSctpMaxMessageSize);
zstein4b2e0822017-02-18 03:48:382689 int p;
2690 if (rtc::FromString(fields[3], &p)) {
Harald Alvestrand5fc28b12019-05-13 11:36:162691 data_desc->set_port(p);
zstein4b2e0822017-02-18 03:48:382692 } else if (fields[3] == kDefaultSctpmapProtocol) {
2693 data_desc->set_use_sctpmap(false);
2694 }
Harald Alvestrand5fc28b12019-05-13 11:36:162695 if (!ParseContent(message, cricket::MEDIA_TYPE_DATA, mline_index,
2696 protocol, payload_types, pos, &content_name,
2697 &bundle_only, &section_msid_signaling,
2698 data_desc.get(), &transport, candidates, error)) {
2699 return false;
2700 }
2701 data_desc->set_protocol(protocol);
2702 content = std::move(data_desc);
2703 } else {
2704 // RTP
2705 std::unique_ptr<RtpDataContentDescription> data_desc =
2706 ParseContentDescription<RtpDataContentDescription>(
2707 message, cricket::MEDIA_TYPE_DATA, mline_index, protocol,
2708 payload_types, pos, &content_name, &bundle_only,
2709 &section_msid_signaling, &transport, candidates, error);
2710 content = std::move(data_desc);
wu@webrtc.org78187522013-10-07 23:32:022711 }
henrike@webrtc.org28e20752013-07-10 00:45:362712 } else {
Mirko Bonadei675513b2017-11-09 10:09:252713 RTC_LOG(LS_WARNING) << "Unsupported media type: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:362714 continue;
2715 }
2716 if (!content.get()) {
2717 // ParseContentDescription returns NULL if failed.
2718 return false;
2719 }
2720
Steve Antone831b8c2018-02-01 20:22:162721 msid_signaling |= section_msid_signaling;
2722
deadbeef25ed4352016-12-13 02:37:362723 bool content_rejected = false;
deadbeef12771a12017-01-03 21:53:472724 // A port of 0 is not interpreted as a rejected m= section when it's
2725 // used along with a=bundle-only.
deadbeef25ed4352016-12-13 02:37:362726 if (bundle_only) {
deadbeef25ed4352016-12-13 02:37:362727 if (!port_rejected) {
deadbeef12771a12017-01-03 21:53:472728 // Usage of bundle-only with a nonzero port is unspecified. So just
2729 // ignore bundle-only if we see this.
2730 bundle_only = false;
Mirko Bonadei675513b2017-11-09 10:09:252731 RTC_LOG(LS_WARNING)
deadbeef12771a12017-01-03 21:53:472732 << "a=bundle-only attribute observed with a nonzero "
Jonas Olsson45cc8902018-02-13 09:37:072733 "port; this usage is unspecified so the attribute is being "
2734 "ignored.";
deadbeef25ed4352016-12-13 02:37:362735 }
2736 } else {
2737 // If not using bundle-only, interpret port 0 in the normal way; the m=
2738 // section is being rejected.
2739 content_rejected = port_rejected;
2740 }
2741
Harald Alvestrand5fc28b12019-05-13 11:36:162742 if (cricket::IsRtpProtocol(protocol) && !content->as_sctp()) {
2743 content->set_protocol(protocol);
henrike@webrtc.org28e20752013-07-10 00:45:362744 // Set the extmap.
2745 if (!session_extmaps.empty() &&
2746 !content->rtp_header_extensions().empty()) {
2747 return ParseFailed("",
2748 "The a=extmap MUST be either all session level or "
2749 "all media level.",
2750 error);
2751 }
2752 for (size_t i = 0; i < session_extmaps.size(); ++i) {
2753 content->AddRtpHeaderExtension(session_extmaps[i]);
2754 }
Harald Alvestrand5fc28b12019-05-13 11:36:162755 } else if (content->as_sctp()) {
2756 // Do nothing, it's OK
2757 } else {
2758 RTC_LOG(LS_WARNING) << "Parse failed with unknown protocol " << protocol;
2759 return false;
henrike@webrtc.org28e20752013-07-10 00:45:362760 }
zhihuang38989e52017-03-21 18:04:532761
2762 // Use the session level connection address if the media level addresses are
2763 // not specified.
2764 rtc::SocketAddress address;
2765 address = content->connection_address().IsNil()
2766 ? session_connection_addr
2767 : content->connection_address();
2768 address.SetPort(port);
2769 content->set_connection_address(address);
2770
henrike@webrtc.org28e20752013-07-10 00:45:362771 desc->AddContent(content_name,
Harald Alvestrand5fc28b12019-05-13 11:36:162772 cricket::IsDtlsSctp(protocol) ? MediaProtocolType::kSctp
2773 : MediaProtocolType::kRtp,
Harald Alvestrand1716d392019-06-03 18:35:452774 content_rejected, bundle_only, std::move(content));
henrike@webrtc.org28e20752013-07-10 00:45:362775 // Create TransportInfo with the media level "ice-pwd" and "ice-ufrag".
Steve Anton06817cd2018-12-18 23:55:302776 desc->AddTransportInfo(TransportInfo(content_name, transport));
henrike@webrtc.org28e20752013-07-10 00:45:362777 }
wu@webrtc.orgcecfd182013-10-30 05:18:122778
Steve Antone831b8c2018-02-01 20:22:162779 desc->set_msid_signaling(msid_signaling);
2780
wu@webrtc.orgcecfd182013-10-30 05:18:122781 size_t end_of_message = message.size();
2782 if (mline_index == -1 && *pos != end_of_message) {
2783 ParseFailed(message, *pos, "Expects m line.", error);
2784 return false;
2785 }
henrike@webrtc.org28e20752013-07-10 00:45:362786 return true;
2787}
2788
2789bool VerifyCodec(const cricket::Codec& codec) {
2790 // Codec has not been populated correctly unless the name has been set. This
2791 // can happen if an SDP has an fmtp or rtcp-fb with a payload type but doesn't
2792 // have a corresponding "rtpmap" line.
htab39db842016-12-08 09:50:482793 return !codec.name.empty();
henrike@webrtc.org28e20752013-07-10 00:45:362794}
2795
2796bool VerifyAudioCodecs(const AudioContentDescription* audio_desc) {
Steve Anton64b626b2019-01-29 01:25:262797 return absl::c_all_of(audio_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:362798}
2799
2800bool VerifyVideoCodecs(const VideoContentDescription* video_desc) {
Steve Anton64b626b2019-01-29 01:25:262801 return absl::c_all_of(video_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:362802}
2803
2804void AddParameters(const cricket::CodecParameterMap& parameters,
2805 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 21:55:532806 for (const auto& entry : parameters) {
2807 const std::string& key = entry.first;
2808 const std::string& value = entry.second;
2809 codec->SetParam(key, value);
henrike@webrtc.org28e20752013-07-10 00:45:362810 }
2811}
2812
2813void AddFeedbackParameter(const cricket::FeedbackParam& feedback_param,
2814 cricket::Codec* codec) {
2815 codec->AddFeedbackParam(feedback_param);
2816}
2817
2818void AddFeedbackParameters(const cricket::FeedbackParams& feedback_params,
2819 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 21:55:532820 for (const cricket::FeedbackParam& param : feedback_params.params()) {
2821 codec->AddFeedbackParam(param);
henrike@webrtc.org28e20752013-07-10 00:45:362822 }
2823}
2824
2825// Gets the current codec setting associated with |payload_type|. If there
changbin.shao@webrtc.org2d25b442015-03-16 04:14:342826// is no Codec associated with that payload type it returns an empty codec
henrike@webrtc.org28e20752013-07-10 00:45:362827// with that payload type.
2828template <class T>
changbin.shao@webrtc.org2d25b442015-03-16 04:14:342829T GetCodecWithPayloadType(const std::vector<T>& codecs, int payload_type) {
magjedb05fa242016-11-11 12:00:162830 const T* codec = FindCodecById(codecs, payload_type);
2831 if (codec)
2832 return *codec;
2833 // Return empty codec with |payload_type|.
changbin.shao@webrtc.org2d25b442015-03-16 04:14:342834 T ret_val;
magjedb05fa242016-11-11 12:00:162835 ret_val.id = payload_type;
henrike@webrtc.org28e20752013-07-10 00:45:362836 return ret_val;
2837}
2838
2839// Updates or creates a new codec entry in the audio description.
2840template <class T, class U>
2841void AddOrReplaceCodec(MediaContentDescription* content_desc, const U& codec) {
2842 T* desc = static_cast<T*>(content_desc);
2843 std::vector<U> codecs = desc->codecs();
2844 bool found = false;
Steve Anton4daf66e2018-09-07 21:55:532845 for (U& existing_codec : codecs) {
2846 if (codec.id == existing_codec.id) {
2847 // Overwrite existing codec with the new codec.
2848 existing_codec = codec;
henrike@webrtc.org28e20752013-07-10 00:45:362849 found = true;
2850 break;
2851 }
2852 }
2853 if (!found) {
2854 desc->AddCodec(codec);
2855 return;
2856 }
2857 desc->set_codecs(codecs);
2858}
2859
2860// Adds or updates existing codec corresponding to |payload_type| according
2861// to |parameters|.
2862template <class T, class U>
Yves Gerey665174f2018-06-19 13:03:052863void UpdateCodec(MediaContentDescription* content_desc,
2864 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:362865 const cricket::CodecParameterMap& parameters) {
2866 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:342867 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2868 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:362869 AddParameters(parameters, &new_codec);
2870 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2871}
2872
2873// Adds or updates existing codec corresponding to |payload_type| according
2874// to |feedback_param|.
2875template <class T, class U>
Yves Gerey665174f2018-06-19 13:03:052876void UpdateCodec(MediaContentDescription* content_desc,
2877 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:362878 const cricket::FeedbackParam& feedback_param) {
2879 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:342880 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2881 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:362882 AddFeedbackParameter(feedback_param, &new_codec);
2883 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2884}
2885
Mirta Dvornicic479a3c02019-06-04 13:38:502886// Adds or updates existing video codec corresponding to |payload_type|
2887// according to |packetization|.
2888void UpdateVideoCodecPacketization(VideoContentDescription* video_desc,
2889 int payload_type,
2890 const std::string& packetization) {
2891 if (packetization != cricket::kPacketizationParamRaw) {
2892 // Ignore unsupported packetization attribute.
2893 return;
2894 }
2895
2896 // Codec might already have been populated (from rtpmap).
2897 cricket::VideoCodec codec =
2898 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
2899 codec.packetization = packetization;
2900 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
2901 codec);
2902}
2903
jlmiller@webrtc.orga744a282015-02-18 21:37:462904template <class T>
2905bool PopWildcardCodec(std::vector<T>* codecs, T* wildcard_codec) {
2906 for (auto iter = codecs->begin(); iter != codecs->end(); ++iter) {
henrike@webrtc.org28e20752013-07-10 00:45:362907 if (iter->id == kWildcardPayloadType) {
2908 *wildcard_codec = *iter;
2909 codecs->erase(iter);
2910 return true;
2911 }
2912 }
2913 return false;
2914}
2915
Yves Gerey665174f2018-06-19 13:03:052916template <class T>
jlmiller@webrtc.orga744a282015-02-18 21:37:462917void UpdateFromWildcardCodecs(cricket::MediaContentDescriptionImpl<T>* desc) {
2918 auto codecs = desc->codecs();
2919 T wildcard_codec;
henrike@webrtc.org28e20752013-07-10 00:45:362920 if (!PopWildcardCodec(&codecs, &wildcard_codec)) {
2921 return;
2922 }
jlmiller@webrtc.orga744a282015-02-18 21:37:462923 for (auto& codec : codecs) {
henrike@webrtc.org28e20752013-07-10 00:45:362924 AddFeedbackParameters(wildcard_codec.feedback_params, &codec);
2925 }
jlmiller@webrtc.orga744a282015-02-18 21:37:462926 desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:362927}
2928
Yves Gerey665174f2018-06-19 13:03:052929void AddAudioAttribute(const std::string& name,
2930 const std::string& value,
henrike@webrtc.org28e20752013-07-10 00:45:362931 AudioContentDescription* audio_desc) {
2932 if (value.empty()) {
2933 return;
2934 }
2935 std::vector<cricket::AudioCodec> codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 21:55:532936 for (cricket::AudioCodec& codec : codecs) {
2937 codec.params[name] = value;
henrike@webrtc.org28e20752013-07-10 00:45:362938 }
2939 audio_desc->set_codecs(codecs);
2940}
2941
2942bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 14:58:012943 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:362944 int mline_index,
2945 const std::string& protocol,
deadbeef67cf2c12016-04-13 17:07:162946 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:362947 size_t* pos,
2948 std::string* content_name,
deadbeef25ed4352016-12-13 02:37:362949 bool* bundle_only,
Steve Antone831b8c2018-02-01 20:22:162950 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:362951 MediaContentDescription* media_desc,
2952 TransportDescription* transport,
Steve Anton5a1de872018-12-18 19:25:552953 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:362954 SdpParseError* error) {
nisseede5da42017-01-12 13:15:362955 RTC_DCHECK(media_desc != NULL);
2956 RTC_DCHECK(content_name != NULL);
2957 RTC_DCHECK(transport != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:362958
henrike@webrtc.org704bf9e2014-02-27 17:52:042959 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 23:14:302960 MaybeCreateStaticPayloadAudioCodecs(payload_types, media_desc->as_audio());
henrike@webrtc.org704bf9e2014-02-27 17:52:042961 }
2962
henrike@webrtc.org28e20752013-07-10 00:45:362963 // The media level "ice-ufrag" and "ice-pwd".
2964 // The candidates before update the media level "ice-pwd" and "ice-ufrag".
2965 Candidates candidates_orig;
2966 std::string line;
2967 std::string mline_id;
2968 // Tracks created out of the ssrc attributes.
2969 StreamParamsVec tracks;
2970 SsrcInfoVec ssrc_infos;
2971 SsrcGroupVec ssrc_groups;
2972 std::string maxptime_as_string;
2973 std::string ptime_as_string;
Seth Hampson5b4f0752018-04-02 23:31:362974 std::vector<std::string> stream_ids;
deadbeef9d3584c2016-02-17 01:54:102975 std::string track_id;
Amit Hilbuchc57d5732018-12-11 23:30:112976 SdpSerializer deserializer;
2977 std::vector<RidDescription> rids;
Amit Hilbucha2012042018-12-03 19:35:052978 SimulcastDescription simulcast;
henrike@webrtc.org28e20752013-07-10 00:45:362979
henrike@webrtc.org28e20752013-07-10 00:45:362980 // Loop until the next m line
2981 while (!IsLineType(message, kLineTypeMedia, *pos)) {
2982 if (!GetLine(message, pos, &line)) {
2983 if (*pos >= message.size()) {
2984 break; // Done parsing
2985 } else {
sergeyu@chromium.org5bc25c42013-12-05 00:24:062986 return ParseFailed(message, *pos, "Invalid SDP line.", error);
henrike@webrtc.org28e20752013-07-10 00:45:362987 }
2988 }
2989
henrike@webrtc.org28e20752013-07-10 00:45:362990 // RFC 4566
2991 // b=* (zero or more bandwidth information lines)
2992 if (IsLineType(line, kLineTypeSessionBandwidth)) {
2993 std::string bandwidth;
Taylor Brandstetteree8c2462020-07-27 22:52:022994 std::string bandwidth_type;
Philipp Hanckefbbfc022020-07-31 06:30:502995 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
2996 kSdpDelimiterColonChar, &bandwidth_type,
2997 &bandwidth)) {
2998 return ParseFailed(
2999 line,
3000 "b= syntax error, does not match b=<modifier>:<bandwidth-value>.",
3001 error);
3002 }
3003 if (!(bandwidth_type == kApplicationSpecificBandwidth ||
3004 bandwidth_type == kTransportSpecificBandwidth)) {
3005 // Ignore unknown bandwidth types.
Taylor Brandstetteree8c2462020-07-27 22:52:023006 continue;
henrike@webrtc.org28e20752013-07-10 00:45:363007 }
Taylor Brandstetteree8c2462020-07-27 22:52:023008 int b = 0;
3009 if (!GetValueFromString(line, bandwidth, &b, error)) {
3010 return false;
3011 }
3012 // TODO(deadbeef): Historically, applications may be setting a value
3013 // of -1 to mean "unset any previously set bandwidth limit", even
3014 // though ommitting the "b=AS" entirely will do just that. Once we've
3015 // transitioned applications to doing the right thing, it would be
3016 // better to treat this as a hard error instead of just ignoring it.
3017 if (bandwidth_type == kApplicationSpecificBandwidth && b == -1) {
3018 RTC_LOG(LS_WARNING) << "Ignoring \"b=AS:-1\"; will be treated as \"no "
3019 "bandwidth limit\".";
3020 continue;
3021 }
3022 if (b < 0) {
3023 return ParseFailed(
3024 line, "b=" + bandwidth_type + " value can't be negative.", error);
3025 }
3026 // We should never use more than the default bandwidth for RTP-based
3027 // data channels. Don't allow SDP to set the bandwidth, because
3028 // that would give JS the opportunity to "break the Internet".
3029 // See: https://code.google.com/p/chromium/issues/detail?id=280726
3030 // Disallow TIAS since it shouldn't be generated for RTP data channels in
3031 // the first place and provides another way to get around the limitation.
3032 if (media_type == cricket::MEDIA_TYPE_DATA &&
3033 cricket::IsRtpProtocol(protocol) &&
3034 (b > cricket::kDataMaxBandwidth / 1000 ||
3035 bandwidth_type == kTransportSpecificBandwidth)) {
3036 rtc::StringBuilder description;
3037 description << "RTP-based data channels may not send more than "
3038 << cricket::kDataMaxBandwidth / 1000 << "kbps.";
3039 return ParseFailed(line, description.str(), error);
3040 }
3041 // Convert values. Prevent integer overflow.
3042 if (bandwidth_type == kApplicationSpecificBandwidth) {
3043 b = std::min(b, INT_MAX / 1000) * 1000;
3044 } else {
3045 b = std::min(b, INT_MAX);
3046 }
3047 media_desc->set_bandwidth(b);
3048 media_desc->set_bandwidth_type(bandwidth_type);
henrike@webrtc.org28e20752013-07-10 00:45:363049 }
3050
zhihuang38989e52017-03-21 18:04:533051 // Parse the media level connection data.
3052 if (IsLineType(line, kLineTypeConnection)) {
3053 rtc::SocketAddress addr;
3054 if (!ParseConnectionData(line, &addr, error)) {
3055 return false;
3056 }
3057 media_desc->set_connection_address(addr);
3058 continue;
3059 }
3060
henrike@webrtc.org28e20752013-07-10 00:45:363061 if (!IsLineType(line, kLineTypeAttributes)) {
Steve Anton36b29d12017-10-30 16:57:423062 // TODO(deadbeef): Handle other lines if needed.
Mirko Bonadei675513b2017-11-09 10:09:253063 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:363064 continue;
3065 }
3066
3067 // Handle attributes common to SCTP and RTP.
3068 if (HasAttribute(line, kAttributeMid)) {
3069 // RFC 3388
3070 // mid-attribute = "a=mid:" identification-tag
3071 // identification-tag = token
3072 // Use the mid identification-tag as the content name.
3073 if (!GetValue(line, kAttributeMid, &mline_id, error)) {
3074 return false;
3075 }
3076 *content_name = mline_id;
deadbeef25ed4352016-12-13 02:37:363077 } else if (HasAttribute(line, kAttributeBundleOnly)) {
3078 *bundle_only = true;
henrike@webrtc.org28e20752013-07-10 00:45:363079 } else if (HasAttribute(line, kAttributeCandidate)) {
3080 Candidate candidate;
3081 if (!ParseCandidate(line, &candidate, error, false)) {
3082 return false;
3083 }
deadbeef7bcdb692017-01-20 20:43:583084 // ParseCandidate will parse non-standard ufrag and password attributes,
3085 // since it's used for candidate trickling, but we only want to process
3086 // the "a=ice-ufrag"/"a=ice-pwd" values in a session description, so
3087 // strip them off at this point.
3088 candidate.set_username(std::string());
3089 candidate.set_password(std::string());
henrike@webrtc.org28e20752013-07-10 00:45:363090 candidates_orig.push_back(candidate);
3091 } else if (HasAttribute(line, kAttributeIceUfrag)) {
3092 if (!GetValue(line, kAttributeIceUfrag, &transport->ice_ufrag, error)) {
3093 return false;
3094 }
3095 } else if (HasAttribute(line, kAttributeIcePwd)) {
3096 if (!GetValue(line, kAttributeIcePwd, &transport->ice_pwd, error)) {
3097 return false;
3098 }
3099 } else if (HasAttribute(line, kAttributeIceOption)) {
3100 if (!ParseIceOptions(line, &transport->transport_options, error)) {
3101 return false;
3102 }
3103 } else if (HasAttribute(line, kAttributeFmtp)) {
3104 if (!ParseFmtpAttributes(line, media_type, media_desc, error)) {
3105 return false;
3106 }
3107 } else if (HasAttribute(line, kAttributeFingerprint)) {
Steve Anton4905edb2018-10-16 02:27:443108 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:363109 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
3110 return false;
3111 }
Steve Anton4905edb2018-10-16 02:27:443112 transport->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:253113 } else if (HasAttribute(line, kAttributeSetup)) {
3114 if (!ParseDtlsSetup(line, &(transport->connection_role), error)) {
3115 return false;
3116 }
Harald Alvestrand5fc28b12019-05-13 11:36:163117 } else if (cricket::IsDtlsSctp(protocol) &&
3118 HasAttribute(line, kAttributeSctpPort)) {
deadbeef7e146cb2016-09-28 17:04:343119 if (media_type != cricket::MEDIA_TYPE_DATA) {
3120 return ParseFailed(
3121 line, "sctp-port attribute found in non-data media description.",
3122 error);
3123 }
Harald Alvestrand5fc28b12019-05-13 11:36:163124 if (media_desc->as_sctp()->use_sctpmap()) {
3125 return ParseFailed(
3126 line, "sctp-port attribute can't be used with sctpmap.", error);
3127 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:563128 int sctp_port;
3129 if (!ParseSctpPort(line, &sctp_port, error)) {
3130 return false;
3131 }
Harald Alvestrand5fc28b12019-05-13 11:36:163132 media_desc->as_sctp()->set_port(sctp_port);
3133 } else if (cricket::IsDtlsSctp(protocol) &&
Harald Alvestrand48cce4d2019-04-11 08:41:243134 HasAttribute(line, kAttributeMaxMessageSize)) {
3135 if (media_type != cricket::MEDIA_TYPE_DATA) {
3136 return ParseFailed(
3137 line,
3138 "max-message-size attribute found in non-data media description.",
3139 error);
3140 }
3141 int max_message_size;
3142 if (!ParseSctpMaxMessageSize(line, &max_message_size, error)) {
3143 return false;
3144 }
Harald Alvestrand5fc28b12019-05-13 11:36:163145 media_desc->as_sctp()->set_max_message_size(max_message_size);
3146 } else if (cricket::IsRtpProtocol(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:363147 //
3148 // RTP specific attrubtes
3149 //
3150 if (HasAttribute(line, kAttributeRtcpMux)) {
3151 media_desc->set_rtcp_mux(true);
deadbeef13871492015-12-09 20:37:513152 } else if (HasAttribute(line, kAttributeRtcpReducedSize)) {
3153 media_desc->set_rtcp_reduced_size(true);
Sebastian Janssone1795f42019-07-24 09:38:033154 } else if (HasAttribute(line, kAttributeRtcpRemoteEstimate)) {
3155 media_desc->set_remote_estimate(true);
henrike@webrtc.org28e20752013-07-10 00:45:363156 } else if (HasAttribute(line, kAttributeSsrcGroup)) {
3157 if (!ParseSsrcGroupAttribute(line, &ssrc_groups, error)) {
3158 return false;
3159 }
3160 } else if (HasAttribute(line, kAttributeSsrc)) {
Steve Antone831b8c2018-02-01 20:22:163161 if (!ParseSsrcAttribute(line, &ssrc_infos, msid_signaling, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:363162 return false;
3163 }
3164 } else if (HasAttribute(line, kAttributeCrypto)) {
3165 if (!ParseCryptoAttribute(line, media_desc, error)) {
3166 return false;
3167 }
3168 } else if (HasAttribute(line, kAttributeRtpmap)) {
deadbeef67cf2c12016-04-13 17:07:163169 if (!ParseRtpmapAttribute(line, media_type, payload_types, media_desc,
3170 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:363171 return false;
3172 }
3173 } else if (HasAttribute(line, kCodecParamMaxPTime)) {
3174 if (!GetValue(line, kCodecParamMaxPTime, &maxptime_as_string, error)) {
3175 return false;
3176 }
Mirta Dvornicic479a3c02019-06-04 13:38:503177 } else if (HasAttribute(line, kAttributePacketization)) {
3178 if (!ParsePacketizationAttribute(line, media_type, media_desc, error)) {
3179 return false;
3180 }
henrike@webrtc.org28e20752013-07-10 00:45:363181 } else if (HasAttribute(line, kAttributeRtcpFb)) {
3182 if (!ParseRtcpFbAttribute(line, media_type, media_desc, error)) {
3183 return false;
3184 }
3185 } else if (HasAttribute(line, kCodecParamPTime)) {
3186 if (!GetValue(line, kCodecParamPTime, &ptime_as_string, error)) {
3187 return false;
3188 }
3189 } else if (HasAttribute(line, kAttributeSendOnly)) {
Steve Anton4e70a722017-11-28 22:57:103190 media_desc->set_direction(RtpTransceiverDirection::kSendOnly);
henrike@webrtc.org28e20752013-07-10 00:45:363191 } else if (HasAttribute(line, kAttributeRecvOnly)) {
Steve Anton4e70a722017-11-28 22:57:103192 media_desc->set_direction(RtpTransceiverDirection::kRecvOnly);
henrike@webrtc.org28e20752013-07-10 00:45:363193 } else if (HasAttribute(line, kAttributeInactive)) {
Steve Anton4e70a722017-11-28 22:57:103194 media_desc->set_direction(RtpTransceiverDirection::kInactive);
henrike@webrtc.org28e20752013-07-10 00:45:363195 } else if (HasAttribute(line, kAttributeSendRecv)) {
Steve Anton4e70a722017-11-28 22:57:103196 media_desc->set_direction(RtpTransceiverDirection::kSendRecv);
Johannes Kron0854eb62018-10-10 20:33:203197 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 08:17:393198 media_desc->set_extmap_allow_mixed_enum(
Johannes Kron0854eb62018-10-10 20:33:203199 MediaContentDescription::kMedia);
henrike@webrtc.org28e20752013-07-10 00:45:363200 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 18:24:553201 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:363202 if (!ParseExtmap(line, &extmap, error)) {
3203 return false;
3204 }
3205 media_desc->AddRtpHeaderExtension(extmap);
3206 } else if (HasAttribute(line, kAttributeXGoogleFlag)) {
3207 // Experimental attribute. Conference mode activates more aggressive
3208 // AEC and NS settings.
Steve Anton36b29d12017-10-30 16:57:423209 // TODO(deadbeef): expose API to set these directly.
henrike@webrtc.org28e20752013-07-10 00:45:363210 std::string flag_value;
3211 if (!GetValue(line, kAttributeXGoogleFlag, &flag_value, error)) {
3212 return false;
3213 }
3214 if (flag_value.compare(kValueConference) == 0)
3215 media_desc->set_conference_mode(true);
deadbeef9d3584c2016-02-17 01:54:103216 } else if (HasAttribute(line, kAttributeMsid)) {
Seth Hampson5b4f0752018-04-02 23:31:363217 if (!ParseMsidAttribute(line, &stream_ids, &track_id, error)) {
deadbeef9d3584c2016-02-17 01:54:103218 return false;
3219 }
Steve Antone831b8c2018-02-01 20:22:163220 *msid_signaling |= cricket::kMsidSignalingMediaSection;
Amit Hilbuchc57d5732018-12-11 23:30:113221 } else if (HasAttribute(line, kAttributeRid)) {
3222 const size_t kRidPrefixLength =
3223 kLinePrefixLength + arraysize(kAttributeRid);
3224 if (line.size() <= kRidPrefixLength) {
3225 RTC_LOG(LS_INFO) << "Ignoring empty RID attribute: " << line;
3226 continue;
3227 }
3228 RTCErrorOr<RidDescription> error_or_rid_description =
3229 deserializer.DeserializeRidDescription(
3230 line.substr(kRidPrefixLength));
3231
3232 // Malformed a=rid lines are discarded.
3233 if (!error_or_rid_description.ok()) {
3234 RTC_LOG(LS_INFO) << "Ignoring malformed RID line: '" << line
3235 << "'. Error: "
3236 << error_or_rid_description.error().message();
3237 continue;
3238 }
3239
3240 rids.push_back(error_or_rid_description.MoveValue());
Amit Hilbucha2012042018-12-03 19:35:053241 } else if (HasAttribute(line, kAttributeSimulcast)) {
3242 const size_t kSimulcastPrefixLength =
3243 kLinePrefixLength + arraysize(kAttributeSimulcast);
3244 if (line.size() <= kSimulcastPrefixLength) {
3245 return ParseFailed(line, "Simulcast attribute is empty.", error);
3246 }
3247
3248 if (!simulcast.empty()) {
3249 return ParseFailed(line, "Multiple Simulcast attributes specified.",
3250 error);
3251 }
3252
Amit Hilbucha2012042018-12-03 19:35:053253 RTCErrorOr<SimulcastDescription> error_or_simulcast =
3254 deserializer.DeserializeSimulcastDescription(
3255 line.substr(kSimulcastPrefixLength));
3256 if (!error_or_simulcast.ok()) {
3257 return ParseFailed(line,
3258 std::string("Malformed simulcast line: ") +
3259 error_or_simulcast.error().message(),
3260 error);
3261 }
3262
3263 simulcast = error_or_simulcast.value();
3264 } else {
3265 // Unrecognized attribute in RTP protocol.
3266 RTC_LOG(LS_INFO) << "Ignored line: " << line;
3267 continue;
henrike@webrtc.org28e20752013-07-10 00:45:363268 }
3269 } else {
3270 // Only parse lines that we are interested of.
Mirko Bonadei675513b2017-11-09 10:09:253271 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:363272 continue;
3273 }
3274 }
3275
Amit Hilbuchc57d5732018-12-11 23:30:113276 // Remove duplicate or inconsistent rids.
3277 RemoveInvalidRidDescriptions(payload_types, &rids);
3278
3279 // If simulcast is specifed, split the rids into send and receive.
3280 // Rids that do not appear in simulcast attribute will be removed.
3281 // If it is not specified, we assume that all rids are for send layers.
Amit Hilbuchb7446ed2019-01-28 20:25:253282 std::vector<RidDescription> send_rids;
Florent Castellib60141b2019-07-03 10:47:543283 std::vector<RidDescription> receive_rids;
Amit Hilbuchc57d5732018-12-11 23:30:113284 if (!simulcast.empty()) {
3285 // Verify that the rids in simulcast match rids in sdp.
3286 RemoveInvalidRidsFromSimulcast(rids, &simulcast);
3287
3288 // Use simulcast description to figure out Send / Receive RIDs.
3289 std::map<std::string, RidDescription> rid_map;
3290 for (const RidDescription& rid : rids) {
3291 rid_map[rid.rid] = rid;
3292 }
3293
3294 for (const auto& layer : simulcast.send_layers().GetAllLayers()) {
3295 auto iter = rid_map.find(layer.rid);
3296 RTC_DCHECK(iter != rid_map.end());
3297 send_rids.push_back(iter->second);
3298 }
3299
Florent Castellib60141b2019-07-03 10:47:543300 for (const auto& layer : simulcast.receive_layers().GetAllLayers()) {
3301 auto iter = rid_map.find(layer.rid);
3302 RTC_DCHECK(iter != rid_map.end());
3303 receive_rids.push_back(iter->second);
3304 }
3305
Amit Hilbuchc57d5732018-12-11 23:30:113306 media_desc->set_simulcast_description(simulcast);
3307 } else {
3308 send_rids = rids;
3309 }
3310
Florent Castellib60141b2019-07-03 10:47:543311 media_desc->set_receive_rids(receive_rids);
3312
henrike@webrtc.org28e20752013-07-10 00:45:363313 // Create tracks from the |ssrc_infos|.
Taylor Brandstetter5de6b752016-03-10 01:02:303314 // If the stream_id/track_id for all SSRCS are identical, one StreamParams
3315 // will be created in CreateTracksFromSsrcInfos, containing all the SSRCs from
3316 // the m= section.
Seth Hampson5897a6e2018-04-03 18:16:333317 if (!ssrc_infos.empty()) {
3318 CreateTracksFromSsrcInfos(ssrc_infos, stream_ids, track_id, &tracks,
3319 *msid_signaling);
3320 } else if (media_type != cricket::MEDIA_TYPE_DATA &&
3321 (*msid_signaling & cricket::kMsidSignalingMediaSection)) {
3322 // If the stream_ids/track_id was signaled but SSRCs were unsignaled we
3323 // still create a track. This isn't done for data media types because
3324 // StreamParams aren't used for SCTP streams, and RTP data channels don't
3325 // support unsignaled SSRCs.
Amit Hilbuchc57d5732018-12-11 23:30:113326 CreateTrackWithNoSsrcs(stream_ids, track_id, send_rids, &tracks);
3327 }
3328
henrike@webrtc.org28e20752013-07-10 00:45:363329 // Add the ssrc group to the track.
Steve Anton4daf66e2018-09-07 21:55:533330 for (const SsrcGroup& ssrc_group : ssrc_groups) {
3331 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:363332 continue;
3333 }
Steve Anton4daf66e2018-09-07 21:55:533334 uint32_t ssrc = ssrc_group.ssrcs.front();
3335 for (StreamParams& track : tracks) {
3336 if (track.has_ssrc(ssrc)) {
3337 track.ssrc_groups.push_back(ssrc_group);
henrike@webrtc.org28e20752013-07-10 00:45:363338 }
3339 }
3340 }
3341
3342 // Add the new tracks to the |media_desc|.
deadbeef9d3584c2016-02-17 01:54:103343 for (StreamParams& track : tracks) {
3344 media_desc->AddStream(track);
henrike@webrtc.org28e20752013-07-10 00:45:363345 }
3346
3347 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 23:14:303348 AudioContentDescription* audio_desc = media_desc->as_audio();
jlmiller@webrtc.orga744a282015-02-18 21:37:463349 UpdateFromWildcardCodecs(audio_desc);
3350
henrike@webrtc.org28e20752013-07-10 00:45:363351 // Verify audio codec ensures that no audio codec has been populated with
3352 // only fmtp.
3353 if (!VerifyAudioCodecs(audio_desc)) {
3354 return ParseFailed("Failed to parse audio codecs correctly.", error);
3355 }
3356 AddAudioAttribute(kCodecParamMaxPTime, maxptime_as_string, audio_desc);
3357 AddAudioAttribute(kCodecParamPTime, ptime_as_string, audio_desc);
3358 }
3359
3360 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 23:14:303361 VideoContentDescription* video_desc = media_desc->as_video();
jlmiller@webrtc.orga744a282015-02-18 21:37:463362 UpdateFromWildcardCodecs(video_desc);
3363 // Verify video codec ensures that no video codec has been populated with
3364 // only rtcp-fb.
3365 if (!VerifyVideoCodecs(video_desc)) {
3366 return ParseFailed("Failed to parse video codecs correctly.", error);
3367 }
henrike@webrtc.org28e20752013-07-10 00:45:363368 }
3369
3370 // RFC 5245
3371 // Update the candidates with the media level "ice-pwd" and "ice-ufrag".
Steve Anton4daf66e2018-09-07 21:55:533372 for (Candidate& candidate : candidates_orig) {
3373 RTC_DCHECK(candidate.username().empty() ||
3374 candidate.username() == transport->ice_ufrag);
3375 candidate.set_username(transport->ice_ufrag);
3376 RTC_DCHECK(candidate.password().empty());
3377 candidate.set_password(transport->ice_pwd);
3378 candidates->push_back(
Mirko Bonadei317a1f02019-09-17 15:06:183379 std::make_unique<JsepIceCandidate>(mline_id, mline_index, candidate));
henrike@webrtc.org28e20752013-07-10 00:45:363380 }
Amit Hilbucha2012042018-12-03 19:35:053381
henrike@webrtc.org28e20752013-07-10 00:45:363382 return true;
3383}
3384
Steve Antone831b8c2018-02-01 20:22:163385bool ParseSsrcAttribute(const std::string& line,
3386 SsrcInfoVec* ssrc_infos,
3387 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:363388 SdpParseError* error) {
nisseede5da42017-01-12 13:15:363389 RTC_DCHECK(ssrc_infos != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:363390 // RFC 5576
3391 // a=ssrc:<ssrc-id> <attribute>
3392 // a=ssrc:<ssrc-id> <attribute>:<value>
3393 std::string field1, field2;
Jonas Olssonec9e4922018-09-05 07:53:493394 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3395 kSdpDelimiterSpaceChar, &field1, &field2)) {
henrike@webrtc.org28e20752013-07-10 00:45:363396 const size_t expected_fields = 2;
3397 return ParseFailedExpectFieldNum(line, expected_fields, error);
3398 }
3399
3400 // ssrc:<ssrc-id>
3401 std::string ssrc_id_s;
3402 if (!GetValue(field1, kAttributeSsrc, &ssrc_id_s, error)) {
3403 return false;
3404 }
Peter Boström0c4e06b2015-10-07 10:23:213405 uint32_t ssrc_id = 0;
wu@webrtc.org5e760e72014-04-02 23:19:093406 if (!GetValueFromString(line, ssrc_id_s, &ssrc_id, error)) {
3407 return false;
3408 }
henrike@webrtc.org28e20752013-07-10 00:45:363409
3410 std::string attribute;
3411 std::string value;
Jonas Olssonec9e4922018-09-05 07:53:493412 if (!rtc::tokenize_first(field2, kSdpDelimiterColonChar, &attribute,
3413 &value)) {
3414 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:363415 description << "Failed to get the ssrc attribute value from " << field2
3416 << ". Expected format <attribute>:<value>.";
3417 return ParseFailed(line, description.str(), error);
3418 }
3419
3420 // Check if there's already an item for this |ssrc_id|. Create a new one if
3421 // there isn't.
Steve Anton64b626b2019-01-29 01:25:263422 auto ssrc_info_it =
3423 absl::c_find_if(*ssrc_infos, [ssrc_id](const SsrcInfo& ssrc_info) {
3424 return ssrc_info.ssrc_id == ssrc_id;
3425 });
Steve Anton4daf66e2018-09-07 21:55:533426 if (ssrc_info_it == ssrc_infos->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:363427 SsrcInfo info;
3428 info.ssrc_id = ssrc_id;
3429 ssrc_infos->push_back(info);
Steve Anton4daf66e2018-09-07 21:55:533430 ssrc_info_it = ssrc_infos->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:363431 }
Steve Anton4daf66e2018-09-07 21:55:533432 SsrcInfo& ssrc_info = *ssrc_info_it;
henrike@webrtc.org28e20752013-07-10 00:45:363433
3434 // Store the info to the |ssrc_info|.
3435 if (attribute == kSsrcAttributeCname) {
3436 // RFC 5576
3437 // cname:<value>
Steve Anton4daf66e2018-09-07 21:55:533438 ssrc_info.cname = value;
henrike@webrtc.org28e20752013-07-10 00:45:363439 } else if (attribute == kSsrcAttributeMsid) {
3440 // draft-alvestrand-mmusic-msid-00
Seth Hampson5b4f0752018-04-02 23:31:363441 // msid:identifier [appdata]
henrike@webrtc.org28e20752013-07-10 00:45:363442 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:493443 rtc::split(value, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:363444 if (fields.size() < 1 || fields.size() > 2) {
Yves Gerey665174f2018-06-19 13:03:053445 return ParseFailed(
3446 line, "Expected format \"msid:<identifier>[ <appdata>]\".", error);
henrike@webrtc.org28e20752013-07-10 00:45:363447 }
Steve Anton4daf66e2018-09-07 21:55:533448 ssrc_info.stream_id = fields[0];
henrike@webrtc.org28e20752013-07-10 00:45:363449 if (fields.size() == 2) {
Steve Anton4daf66e2018-09-07 21:55:533450 ssrc_info.track_id = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:363451 }
Steve Antone831b8c2018-02-01 20:22:163452 *msid_signaling |= cricket::kMsidSignalingSsrcAttribute;
Artem Titovf0a34f22020-03-16 17:52:043453 } else if (attribute == kSsrcAttributeMslabel) {
3454 // draft-alvestrand-rtcweb-mid-01
3455 // mslabel:<value>
3456 ssrc_info.mslabel = value;
3457 } else if (attribute == kSSrcAttributeLabel) {
3458 // The label isn't defined.
3459 // label:<value>
3460 ssrc_info.label = value;
henrike@webrtc.org28e20752013-07-10 00:45:363461 }
3462 return true;
3463}
3464
3465bool ParseSsrcGroupAttribute(const std::string& line,
3466 SsrcGroupVec* ssrc_groups,
3467 SdpParseError* error) {
nisseede5da42017-01-12 13:15:363468 RTC_DCHECK(ssrc_groups != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:363469 // RFC 5576
3470 // a=ssrc-group:<semantics> <ssrc-id> ...
3471 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:493472 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:363473 const size_t expected_min_fields = 2;
3474 if (fields.size() < expected_min_fields) {
3475 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3476 }
3477 std::string semantics;
3478 if (!GetValue(fields[0], kAttributeSsrcGroup, &semantics, error)) {
3479 return false;
3480 }
Peter Boström0c4e06b2015-10-07 10:23:213481 std::vector<uint32_t> ssrcs;
henrike@webrtc.org28e20752013-07-10 00:45:363482 for (size_t i = 1; i < fields.size(); ++i) {
Peter Boström0c4e06b2015-10-07 10:23:213483 uint32_t ssrc = 0;
wu@webrtc.org5e760e72014-04-02 23:19:093484 if (!GetValueFromString(line, fields[i], &ssrc, error)) {
3485 return false;
3486 }
henrike@webrtc.org28e20752013-07-10 00:45:363487 ssrcs.push_back(ssrc);
3488 }
3489 ssrc_groups->push_back(SsrcGroup(semantics, ssrcs));
3490 return true;
3491}
3492
3493bool ParseCryptoAttribute(const std::string& line,
3494 MediaContentDescription* media_desc,
3495 SdpParseError* error) {
3496 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:493497 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:363498 // RFC 4568
3499 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
3500 const size_t expected_min_fields = 3;
3501 if (fields.size() < expected_min_fields) {
3502 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3503 }
3504 std::string tag_value;
3505 if (!GetValue(fields[0], kAttributeCrypto, &tag_value, error)) {
3506 return false;
3507 }
wu@webrtc.org5e760e72014-04-02 23:19:093508 int tag = 0;
3509 if (!GetValueFromString(line, tag_value, &tag, error)) {
3510 return false;
3511 }
jbauch083b73f2015-07-16 09:46:323512 const std::string& crypto_suite = fields[1];
3513 const std::string& key_params = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:363514 std::string session_params;
3515 if (fields.size() > 3) {
3516 session_params = fields[3];
3517 }
Yves Gerey665174f2018-06-19 13:03:053518 media_desc->AddCrypto(
3519 CryptoParams(tag, crypto_suite, key_params, session_params));
henrike@webrtc.org28e20752013-07-10 00:45:363520 return true;
3521}
3522
3523// Updates or creates a new codec entry in the audio description with according
deadbeef67cf2c12016-04-13 17:07:163524// to |name|, |clockrate|, |bitrate|, and |channels|.
3525void UpdateCodec(int payload_type,
3526 const std::string& name,
3527 int clockrate,
3528 int bitrate,
3529 size_t channels,
henrike@webrtc.org28e20752013-07-10 00:45:363530 AudioContentDescription* audio_desc) {
3531 // Codec may already be populated with (only) optional parameters
3532 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:343533 cricket::AudioCodec codec =
3534 GetCodecWithPayloadType(audio_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:363535 codec.name = name;
3536 codec.clockrate = clockrate;
3537 codec.bitrate = bitrate;
3538 codec.channels = channels;
henrike@webrtc.org28e20752013-07-10 00:45:363539 AddOrReplaceCodec<AudioContentDescription, cricket::AudioCodec>(audio_desc,
3540 codec);
3541}
3542
3543// Updates or creates a new codec entry in the video description according to
deadbeef67cf2c12016-04-13 17:07:163544// |name|, |width|, |height|, and |framerate|.
3545void UpdateCodec(int payload_type,
3546 const std::string& name,
henrike@webrtc.org28e20752013-07-10 00:45:363547 VideoContentDescription* video_desc) {
3548 // Codec may already be populated with (only) optional parameters
3549 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:343550 cricket::VideoCodec codec =
3551 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:363552 codec.name = name;
henrike@webrtc.org28e20752013-07-10 00:45:363553 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
3554 codec);
3555}
3556
3557bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 14:58:013558 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 17:07:163559 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:363560 MediaContentDescription* media_desc,
3561 SdpParseError* error) {
3562 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:493563 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:363564 // RFC 4566
3565 // a=rtpmap:<payload type> <encoding name>/<clock rate>[/<encodingparameters>]
3566 const size_t expected_min_fields = 2;
3567 if (fields.size() < expected_min_fields) {
3568 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3569 }
3570 std::string payload_type_value;
3571 if (!GetValue(fields[0], kAttributeRtpmap, &payload_type_value, error)) {
3572 return false;
3573 }
wu@webrtc.org5e760e72014-04-02 23:19:093574 int payload_type = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:283575 if (!GetPayloadTypeFromString(line, payload_type_value, &payload_type,
3576 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:093577 return false;
3578 }
henrike@webrtc.org28e20752013-07-10 00:45:363579
Steve Anton64b626b2019-01-29 01:25:263580 if (!absl::c_linear_search(payload_types, payload_type)) {
Mirko Bonadei675513b2017-11-09 10:09:253581 RTC_LOG(LS_WARNING) << "Ignore rtpmap line that did not appear in the "
Jonas Olsson45cc8902018-02-13 09:37:073582 "<fmt> of the m-line: "
3583 << line;
henrike@webrtc.org28e20752013-07-10 00:45:363584 return true;
3585 }
jbauch083b73f2015-07-16 09:46:323586 const std::string& encoder = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:363587 std::vector<std::string> codec_params;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:523588 rtc::split(encoder, '/', &codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:363589 // <encoding name>/<clock rate>[/<encodingparameters>]
3590 // 2 mandatory fields
3591 if (codec_params.size() < 2 || codec_params.size() > 3) {
3592 return ParseFailed(line,
3593 "Expected format \"<encoding name>/<clock rate>"
3594 "[/<encodingparameters>]\".",
3595 error);
3596 }
jbauch083b73f2015-07-16 09:46:323597 const std::string& encoding_name = codec_params[0];
wu@webrtc.org5e760e72014-04-02 23:19:093598 int clock_rate = 0;
3599 if (!GetValueFromString(line, codec_params[1], &clock_rate, error)) {
3600 return false;
3601 }
henrike@webrtc.org28e20752013-07-10 00:45:363602 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 23:14:303603 VideoContentDescription* video_desc = media_desc->as_video();
Yves Gerey665174f2018-06-19 13:03:053604 UpdateCodec(payload_type, encoding_name, video_desc);
henrike@webrtc.org28e20752013-07-10 00:45:363605 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3606 // RFC 4566
3607 // For audio streams, <encoding parameters> indicates the number
3608 // of audio channels. This parameter is OPTIONAL and may be
3609 // omitted if the number of channels is one, provided that no
3610 // additional parameters are needed.
Peter Kasting69558702016-01-13 00:26:353611 size_t channels = 1;
henrike@webrtc.org28e20752013-07-10 00:45:363612 if (codec_params.size() == 3) {
wu@webrtc.org5e760e72014-04-02 23:19:093613 if (!GetValueFromString(line, codec_params[2], &channels, error)) {
3614 return false;
3615 }
henrike@webrtc.org28e20752013-07-10 00:45:363616 }
Steve Antonb1c1de12017-12-21 23:14:303617 AudioContentDescription* audio_desc = media_desc->as_audio();
ossue1405ad2017-01-23 16:55:483618 UpdateCodec(payload_type, encoding_name, clock_rate, 0, channels,
deadbeef67cf2c12016-04-13 17:07:163619 audio_desc);
henrike@webrtc.org28e20752013-07-10 00:45:363620 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 11:36:163621 RtpDataContentDescription* data_desc = media_desc->as_rtp_data();
3622 if (data_desc) {
3623 data_desc->AddCodec(cricket::RtpDataCodec(payload_type, encoding_name));
3624 }
henrike@webrtc.org28e20752013-07-10 00:45:363625 }
3626 return true;
3627}
3628
Yves Gerey665174f2018-06-19 13:03:053629bool ParseFmtpParam(const std::string& line,
3630 std::string* parameter,
3631 std::string* value,
3632 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 07:53:493633 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, parameter, value)) {
Philipp Hanckef2a4ec12020-07-01 19:07:323634 // Support for non-key-value lines like RFC 2198 or RFC 4733.
3635 *parameter = "";
3636 *value = line;
3637 return true;
henrike@webrtc.org28e20752013-07-10 00:45:363638 }
3639 // a=fmtp:<payload_type> <param1>=<value1>; <param2>=<value2>; ...
henrike@webrtc.org28e20752013-07-10 00:45:363640 return true;
3641}
3642
Yves Gerey665174f2018-06-19 13:03:053643bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 14:58:013644 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:363645 MediaContentDescription* media_desc,
3646 SdpParseError* error) {
3647 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3648 media_type != cricket::MEDIA_TYPE_VIDEO) {
3649 return true;
3650 }
Donald Curtis0e07f922015-05-15 16:21:233651
3652 std::string line_payload;
3653 std::string line_params;
henrike@webrtc.org28e20752013-07-10 00:45:363654
Philipp Hanckef2a4ec12020-07-01 19:07:323655 // https://tools.ietf.org/html/rfc4566#section-6
henrike@webrtc.org28e20752013-07-10 00:45:363656 // a=fmtp:<format> <format specific parameters>
3657 // At least two fields, whereas the second one is any of the optional
3658 // parameters.
Jonas Olssonec9e4922018-09-05 07:53:493659 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3660 kSdpDelimiterSpaceChar, &line_payload,
3661 &line_params)) {
henrike@webrtc.org28e20752013-07-10 00:45:363662 ParseFailedExpectMinFieldNum(line, 2, error);
3663 return false;
3664 }
3665
Donald Curtis0e07f922015-05-15 16:21:233666 // Parse out the payload information.
pkasting@chromium.orgd3245462015-02-23 21:28:223667 std::string payload_type_str;
Donald Curtis0e07f922015-05-15 16:21:233668 if (!GetValue(line_payload, kAttributeFmtp, &payload_type_str, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:363669 return false;
3670 }
3671
Donald Curtis0e07f922015-05-15 16:21:233672 int payload_type = 0;
Donald Curtis144d0182015-05-15 20:14:243673 if (!GetPayloadTypeFromString(line_payload, payload_type_str, &payload_type,
3674 error)) {
Donald Curtis0e07f922015-05-15 16:21:233675 return false;
3676 }
3677
3678 // Parse out format specific parameters.
3679 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 07:53:493680 rtc::split(line_params, kSdpDelimiterSemicolonChar, &fields);
Donald Curtis0e07f922015-05-15 16:21:233681
henrike@webrtc.org28e20752013-07-10 00:45:363682 cricket::CodecParameterMap codec_params;
Donald Curtis144d0182015-05-15 20:14:243683 for (auto& iter : fields) {
Donald Curtis0e07f922015-05-15 16:21:233684 std::string name;
3685 std::string value;
3686 if (!ParseFmtpParam(rtc::string_trim(iter), &name, &value, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:363687 return false;
3688 }
Philipp Hanckef2a4ec12020-07-01 19:07:323689 if (codec_params.find(name) != codec_params.end()) {
3690 RTC_LOG(LS_INFO) << "Overwriting duplicate fmtp parameter with key \""
3691 << name << "\".";
3692 }
henrike@webrtc.org28e20752013-07-10 00:45:363693 codec_params[name] = value;
3694 }
3695
henrike@webrtc.org28e20752013-07-10 00:45:363696 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3697 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:223698 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:363699 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
3700 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:223701 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:363702 }
3703 return true;
3704}
3705
Mirta Dvornicic479a3c02019-06-04 13:38:503706bool ParsePacketizationAttribute(const std::string& line,
3707 const cricket::MediaType media_type,
3708 MediaContentDescription* media_desc,
3709 SdpParseError* error) {
3710 if (media_type != cricket::MEDIA_TYPE_VIDEO) {
3711 return true;
3712 }
3713 std::vector<std::string> packetization_fields;
3714 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &packetization_fields);
3715 if (packetization_fields.size() < 2) {
3716 return ParseFailedGetValue(line, kAttributePacketization, error);
3717 }
3718 std::string payload_type_string;
3719 if (!GetValue(packetization_fields[0], kAttributePacketization,
3720 &payload_type_string, error)) {
3721 return false;
3722 }
3723 int payload_type;
3724 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3725 error)) {
3726 return false;
3727 }
3728 std::string packetization = packetization_fields[1];
3729 UpdateVideoCodecPacketization(media_desc->as_video(), payload_type,
3730 packetization);
3731 return true;
3732}
3733
Yves Gerey665174f2018-06-19 13:03:053734bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 14:58:013735 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:363736 MediaContentDescription* media_desc,
3737 SdpParseError* error) {
3738 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3739 media_type != cricket::MEDIA_TYPE_VIDEO) {
3740 return true;
3741 }
3742 std::vector<std::string> rtcp_fb_fields;
Jonas Olssonec9e4922018-09-05 07:53:493743 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &rtcp_fb_fields);
henrike@webrtc.org28e20752013-07-10 00:45:363744 if (rtcp_fb_fields.size() < 2) {
3745 return ParseFailedGetValue(line, kAttributeRtcpFb, error);
3746 }
3747 std::string payload_type_string;
3748 if (!GetValue(rtcp_fb_fields[0], kAttributeRtcpFb, &payload_type_string,
3749 error)) {
3750 return false;
3751 }
wu@webrtc.org5e760e72014-04-02 23:19:093752 int payload_type = kWildcardPayloadType;
3753 if (payload_type_string != "*") {
pkasting@chromium.orge9facf82015-02-17 20:36:283754 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3755 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:093756 return false;
3757 }
3758 }
henrike@webrtc.org28e20752013-07-10 00:45:363759 std::string id = rtcp_fb_fields[1];
3760 std::string param = "";
3761 for (std::vector<std::string>::iterator iter = rtcp_fb_fields.begin() + 2;
3762 iter != rtcp_fb_fields.end(); ++iter) {
3763 param.append(*iter);
3764 }
3765 const cricket::FeedbackParam feedback_param(id, param);
3766
3767 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
pkasting@chromium.orgd3245462015-02-23 21:28:223768 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
3769 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:363770 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
pkasting@chromium.orgd3245462015-02-23 21:28:223771 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
3772 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:363773 }
3774 return true;
3775}
3776
3777} // namespace webrtc