blob: 665b4d411a050a98430f26d4f4fab347f0ba47a8 [file] [log] [blame]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001/*
kjellanderb24317b2016-02-10 07:54:43 -08002 * Copyright 2011 The WebRTC project authors. All Rights Reserved.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003 *
kjellanderb24317b2016-02-10 07:54:43 -08004 * 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:36 +00009 */
10
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020011#include "pc/webrtcsdp.h"
henrike@webrtc.org28e20752013-07-10 00:45:36 +000012
kjellandera96e2d72016-02-04 23:52:28 -080013#include <ctype.h>
henrike@webrtc.org28e20752013-07-10 00:45:36 +000014#include <limits.h>
15#include <stdio.h>
kwibergd1fe2812016-04-27 06:47:29 -070016
henrike@webrtc.org28e20752013-07-10 00:45:36 +000017#include <algorithm>
Steve Anton36b29d12017-10-30 09:57:42 -070018#include <map>
kwibergd1fe2812016-04-27 06:47:29 -070019#include <memory>
Steve Anton36b29d12017-10-30 09:57:42 -070020#include <set>
henrike@webrtc.org28e20752013-07-10 00:45:36 +000021#include <string>
deadbeef67cf2c12016-04-13 10:07:16 -070022#include <unordered_map>
henrike@webrtc.org28e20752013-07-10 00:45:36 +000023#include <vector>
24
Patrik Höglundb6b29e02018-06-21 16:58:01 +020025#include "api/mediatypes.h"
Patrik Höglunde2d6a062017-10-05 14:53:33 +020026#include "api/candidate.h"
Patrik Höglund7aee3d52017-11-15 13:15:17 +010027#include "api/cryptoparams.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020028#include "api/jsepicecandidate.h"
29#include "api/jsepsessiondescription.h"
isheriff6f8d6862016-05-26 11:24:55 -070030// for RtpExtension
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020031#include "api/rtpparameters.h"
32#include "media/base/codec.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020033#include "media/base/mediaconstants.h"
34#include "media/base/rtputils.h"
35#include "media/sctp/sctptransportinternal.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020036#include "p2p/base/p2pconstants.h"
37#include "p2p/base/port.h"
38#include "pc/mediasession.h"
39#include "rtc_base/arraysize.h"
40#include "rtc_base/checks.h"
41#include "rtc_base/logging.h"
42#include "rtc_base/messagedigest.h"
Jonas Olssonec9e4922018-09-05 09:53:49 +020043#include "rtc_base/strings/string_builder.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020044#include "rtc_base/stringutils.h"
henrike@webrtc.org28e20752013-07-10 00:45:36 +000045
46using cricket::AudioContentDescription;
47using cricket::Candidate;
48using cricket::Candidates;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000049using cricket::ContentInfo;
50using cricket::CryptoParams;
51using cricket::DataContentDescription;
52using cricket::ICE_CANDIDATE_COMPONENT_RTP;
53using cricket::ICE_CANDIDATE_COMPONENT_RTCP;
54using cricket::kCodecParamMaxBitrate;
55using cricket::kCodecParamMaxPTime;
56using cricket::kCodecParamMaxQuantization;
57using cricket::kCodecParamMinBitrate;
58using cricket::kCodecParamMinPTime;
59using cricket::kCodecParamPTime;
60using cricket::kCodecParamSPropStereo;
buildbot@webrtc.orged97bb02014-05-07 11:15:20 +000061using cricket::kCodecParamStartBitrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000062using cricket::kCodecParamStereo;
63using cricket::kCodecParamUseInbandFec;
Minyue Li7100dcd2015-03-27 05:05:59 +010064using cricket::kCodecParamUseDtx;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000065using cricket::kCodecParamSctpProtocol;
66using cricket::kCodecParamSctpStreams;
henrike@webrtc.org1e09a712013-07-26 19:17:59 +000067using cricket::kCodecParamMaxAverageBitrate;
buildbot@webrtc.org5d639b32014-09-10 07:57:12 +000068using cricket::kCodecParamMaxPlaybackRate;
stefan@webrtc.org85d27942014-06-09 12:51:39 +000069using cricket::kCodecParamAssociatedPayloadType;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000070using cricket::MediaContentDescription;
71using cricket::MediaType;
isheriff6f8d6862016-05-26 11:24:55 -070072using cricket::RtpHeaderExtensions;
Steve Anton5adfafd2017-12-20 16:34:00 -080073using cricket::MediaProtocolType;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000074using cricket::SsrcGroup;
75using cricket::StreamParams;
76using cricket::StreamParamsVec;
77using cricket::TransportDescription;
78using cricket::TransportInfo;
79using cricket::VideoContentDescription;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +000080using rtc::SocketAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000081
henrike@webrtc.org28e20752013-07-10 00:45:36 +000082namespace cricket {
83class SessionDescription;
84}
85
deadbeef90f1e1e2017-02-10 12:35:05 -080086// TODO(deadbeef): Switch to using anonymous namespace rather than declaring
87// everything "static".
henrike@webrtc.org28e20752013-07-10 00:45:36 +000088namespace webrtc {
89
90// Line type
91// RFC 4566
92// An SDP session description consists of a number of lines of text of
93// the form:
94// <type>=<value>
95// where <type> MUST be exactly one case-significant character.
deadbeef9d3584c2016-02-16 17:54:10 -080096static const int kLinePrefixLength = 2; // Length of <type>=
henrike@webrtc.org28e20752013-07-10 00:45:36 +000097static const char kLineTypeVersion = 'v';
98static const char kLineTypeOrigin = 'o';
99static const char kLineTypeSessionName = 's';
100static const char kLineTypeSessionInfo = 'i';
101static const char kLineTypeSessionUri = 'u';
102static const char kLineTypeSessionEmail = 'e';
103static const char kLineTypeSessionPhone = 'p';
104static const char kLineTypeSessionBandwidth = 'b';
105static const char kLineTypeTiming = 't';
106static const char kLineTypeRepeatTimes = 'r';
107static const char kLineTypeTimeZone = 'z';
108static const char kLineTypeEncryptionKey = 'k';
109static const char kLineTypeMedia = 'm';
110static const char kLineTypeConnection = 'c';
111static const char kLineTypeAttributes = 'a';
112
113// Attributes
114static const char kAttributeGroup[] = "group";
115static const char kAttributeMid[] = "mid";
deadbeef9d3584c2016-02-16 17:54:10 -0800116static const char kAttributeMsid[] = "msid";
deadbeef25ed4352016-12-12 18:37:36 -0800117static const char kAttributeBundleOnly[] = "bundle-only";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000118static const char kAttributeRtcpMux[] = "rtcp-mux";
deadbeef13871492015-12-09 12:37:51 -0800119static const char kAttributeRtcpReducedSize[] = "rtcp-rsize";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000120static const char kAttributeSsrc[] = "ssrc";
121static const char kSsrcAttributeCname[] = "cname";
122static const char kAttributeExtmap[] = "extmap";
123// draft-alvestrand-mmusic-msid-01
124// a=msid-semantic: WMS
Seth Hampson5b4f0752018-04-02 16:31:36 -0700125// This is a legacy field supported only for Plan B semantics.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000126static const char kAttributeMsidSemantics[] = "msid-semantic";
127static const char kMediaStreamSemantic[] = "WMS";
128static const char kSsrcAttributeMsid[] = "msid";
129static const char kDefaultMsid[] = "default";
Seth Hampson5b4f0752018-04-02 16:31:36 -0700130static const char kNoStreamMsid[] = "-";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000131static const char kSsrcAttributeMslabel[] = "mslabel";
132static const char kSSrcAttributeLabel[] = "label";
133static 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-16 18:37:23 -0800139static const char kAttributeCandidateUfrag[] = "ufrag";
140static const char kAttributeCandidatePwd[] = "pwd";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000141static const char kAttributeCandidateGeneration[] = "generation";
honghaiza0c44ea2016-03-23 16:07:48 -0700142static const char kAttributeCandidateNetworkId[] = "network-id";
honghaize1a0c942016-02-16 14:54:56 -0800143static const char kAttributeCandidateNetworkCost[] = "network-cost";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000144static const char kAttributeFingerprint[] = "fingerprint";
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000145static const char kAttributeSetup[] = "setup";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000146static const char kAttributeFmtp[] = "fmtp";
147static const char kAttributeRtpmap[] = "rtpmap";
wu@webrtc.org78187522013-10-07 23:32:02 +0000148static const char kAttributeSctpmap[] = "sctpmap";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000149static 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";
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +0000159// draft-ietf-mmusic-sctp-sdp-07
160// a=sctp-port
161static const char kAttributeSctpPort[] = "sctp-port";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000162
163// Experimental flags
164static const char kAttributeXGoogleFlag[] = "x-google-flag";
165static const char kValueConference[] = "conference";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000166
167// Candidate
168static const char kCandidateHost[] = "host";
169static const char kCandidateSrflx[] = "srflx";
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700170static const char kCandidatePrflx[] = "prflx";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000171static const char kCandidateRelay[] = "relay";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +0000172static const char kTcpCandidateType[] = "tcptype";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000173
Jonas Olssonec9e4922018-09-05 09:53:49 +0200174// rtc::StringBuilder doesn't have a << overload for chars, while rtc::split and
175// rtc::tokenize_first both take a char delimiter. To handle both cases these
176// constants come in pairs of a chars and length-one strings.
177static const char kSdpDelimiterEqual[] = "=";
178static const char kSdpDelimiterEqualChar = '=';
179static const char kSdpDelimiterSpace[] = " ";
180static const char kSdpDelimiterSpaceChar = ' ';
181static const char kSdpDelimiterColon[] = ":";
182static const char kSdpDelimiterColonChar = ':';
183static const char kSdpDelimiterSemicolon[] = ";";
184static const char kSdpDelimiterSemicolonChar = ';';
185static const char kSdpDelimiterSlashChar = '/';
186static const char kNewLine[] = "\n";
187static const char kNewLineChar = '\n';
188static const char kReturnChar = '\r';
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000189static const char kLineBreak[] = "\r\n";
190
Steve Anton36b29d12017-10-30 09:57:42 -0700191// TODO(deadbeef): Generate the Session and Time description
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000192// instead of hardcoding.
193static const char kSessionVersion[] = "v=0";
194// RFC 4566
195static const char kSessionOriginUsername[] = "-";
196static const char kSessionOriginSessionId[] = "0";
197static const char kSessionOriginSessionVersion[] = "0";
198static const char kSessionOriginNettype[] = "IN";
199static const char kSessionOriginAddrtype[] = "IP4";
200static const char kSessionOriginAddress[] = "127.0.0.1";
201static const char kSessionName[] = "s=-";
202static const char kTimeDescription[] = "t=0 0";
203static const char kAttrGroup[] = "a=group:BUNDLE";
204static const char kConnectionNettype[] = "IN";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000205static const char kConnectionIpv4Addrtype[] = "IP4";
206static const char kConnectionIpv6Addrtype[] = "IP6";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000207static const char kMediaTypeVideo[] = "video";
208static const char kMediaTypeAudio[] = "audio";
209static const char kMediaTypeData[] = "application";
210static const char kMediaPortRejected[] = "0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000211// draft-ietf-mmusic-trickle-ice-01
212// When no candidates have been gathered, set the connection
213// address to IP6 ::.
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000214// TODO(perkj): FF can not parse IP6 ::. See http://crbug/430333
215// Use IPV4 per default.
216static const char kDummyAddress[] = "0.0.0.0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000217static const char kDummyPort[] = "9";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000218// RFC 3556
219static const char kApplicationSpecificMaximum[] = "AS";
220
wu@webrtc.org78187522013-10-07 23:32:02 +0000221static const char kDefaultSctpmapProtocol[] = "webrtc-datachannel";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000222
pkasting@chromium.orgd3245462015-02-23 21:28:22 +0000223// RTP payload type is in the 0-127 range. Use -1 to indicate "all" payload
224// types.
225const int kWildcardPayloadType = -1;
226
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000227struct SsrcInfo {
Peter Boström0c4e06b2015-10-07 12:23:21 +0200228 uint32_t ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000229 std::string cname;
deadbeef9d3584c2016-02-16 17:54:10 -0800230 std::string stream_id;
231 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000232
233 // For backward compatibility.
234 // TODO(ronghuawu): Remove below 2 fields once all the clients support msid.
235 std::string label;
236 std::string mslabel;
237};
238typedef std::vector<SsrcInfo> SsrcInfoVec;
239typedef std::vector<SsrcGroup> SsrcGroupVec;
240
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000241template <class T>
242static void AddFmtpLine(const T& codec, std::string* message);
243static void BuildMediaDescription(const ContentInfo* content_info,
244 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200245 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000246 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -0800247 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000248 std::string* message);
zstein4b2e0822017-02-17 19:48:38 -0800249static void BuildSctpContentAttributes(std::string* message,
250 int sctp_port,
251 bool use_sctpmap);
deadbeef9d3584c2016-02-16 17:54:10 -0800252static void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200253 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -0800254 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -0800255 std::string* message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000256static void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200257 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000258 std::string* message);
259static void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -0800260 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000261 std::string* message);
262static void BuildIceOptions(const std::vector<std::string>& transport_options,
263 std::string* message);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +0000264static bool IsRtp(const std::string& protocol);
265static bool IsDtlsSctp(const std::string& protocol);
zhihuang38989e52017-03-21 11:04:53 -0700266static bool ParseSessionDescription(const std::string& message,
267 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000268 std::string* session_id,
269 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000270 TransportDescription* session_td,
271 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700272 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000273 cricket::SessionDescription* desc,
274 SdpParseError* error);
275static bool ParseGroupAttribute(const std::string& line,
276 cricket::SessionDescription* desc,
277 SdpParseError* error);
278static bool ParseMediaDescription(
279 const std::string& message,
280 const TransportDescription& session_td,
281 const RtpHeaderExtensions& session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700282 size_t* pos,
283 const rtc::SocketAddress& session_connection_addr,
284 cricket::SessionDescription* desc,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000285 std::vector<JsepIceCandidate*>* candidates,
286 SdpParseError* error);
287static bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200288 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000289 int mline_index,
290 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -0700291 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000292 size_t* pos,
293 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -0800294 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -0800295 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000296 MediaContentDescription* media_desc,
297 TransportDescription* transport,
298 std::vector<JsepIceCandidate*>* candidates,
299 SdpParseError* error);
300static bool ParseSsrcAttribute(const std::string& line,
301 SsrcInfoVec* ssrc_infos,
Steve Antone831b8c2018-02-01 12:22:16 -0800302 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000303 SdpParseError* error);
304static bool ParseSsrcGroupAttribute(const std::string& line,
305 SsrcGroupVec* ssrc_groups,
306 SdpParseError* error);
307static bool ParseCryptoAttribute(const std::string& line,
308 MediaContentDescription* media_desc,
309 SdpParseError* error);
310static bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200311 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -0700312 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000313 MediaContentDescription* media_desc,
314 SdpParseError* error);
315static bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200316 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000317 MediaContentDescription* media_desc,
318 SdpParseError* error);
Yves Gerey665174f2018-06-19 15:03:05 +0200319static bool ParseFmtpParam(const std::string& line,
320 std::string* parameter,
321 std::string* value,
322 SdpParseError* error);
323static bool ParseCandidate(const std::string& message,
324 Candidate* candidate,
325 SdpParseError* error,
326 bool is_raw);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000327static bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200328 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000329 MediaContentDescription* media_desc,
330 SdpParseError* error);
331static bool ParseIceOptions(const std::string& line,
332 std::vector<std::string>* transport_options,
333 SdpParseError* error);
334static bool ParseExtmap(const std::string& line,
isheriff6f8d6862016-05-26 11:24:55 -0700335 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000336 SdpParseError* error);
337static bool ParseFingerprintAttribute(const std::string& line,
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000338 rtc::SSLFingerprint** fingerprint,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000339 SdpParseError* error);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000340static bool ParseDtlsSetup(const std::string& line,
341 cricket::ConnectionRole* role,
342 SdpParseError* error);
deadbeef9d3584c2016-02-16 17:54:10 -0800343static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700344 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -0800345 std::string* track_id,
346 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000347
348// Helper functions
349
350// Below ParseFailed*** functions output the line that caused the parsing
351// failure and the detailed reason (|description|) of the failure to |error|.
352// The functions always return false so that they can be used directly in the
353// following way when error happens:
354// "return ParseFailed***(...);"
355
356// The line starting at |line_start| of |message| is the failing line.
357// The reason for the failure should be provided in the |description|.
358// An example of a description could be "unknown character".
359static bool ParseFailed(const std::string& message,
360 size_t line_start,
361 const std::string& description,
362 SdpParseError* error) {
363 // Get the first line of |message| from |line_start|.
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000364 std::string first_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000365 size_t line_end = message.find(kNewLine, line_start);
366 if (line_end != std::string::npos) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200367 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000368 --line_end;
369 }
370 first_line = message.substr(line_start, (line_end - line_start));
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000371 } else {
372 first_line = message.substr(line_start);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000373 }
374
375 if (error) {
376 error->line = first_line;
377 error->description = description;
378 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100379 RTC_LOG(LS_ERROR) << "Failed to parse: \"" << first_line
380 << "\". Reason: " << description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000381 return false;
382}
383
384// |line| is the failing line. The reason for the failure should be
385// provided in the |description|.
386static bool ParseFailed(const std::string& line,
387 const std::string& description,
388 SdpParseError* error) {
389 return ParseFailed(line, 0, description, error);
390}
391
392// Parses failure where the failing SDP line isn't know or there are multiple
393// failing lines.
Yves Gerey665174f2018-06-19 15:03:05 +0200394static bool ParseFailed(const std::string& description, SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000395 return ParseFailed("", description, error);
396}
397
398// |line| is the failing line. The failure is due to the fact that |line|
399// doesn't have |expected_fields| fields.
400static bool ParseFailedExpectFieldNum(const std::string& line,
401 int expected_fields,
402 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200403 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000404 description << "Expects " << expected_fields << " fields.";
405 return ParseFailed(line, description.str(), error);
406}
407
408// |line| is the failing line. The failure is due to the fact that |line| has
409// less than |expected_min_fields| fields.
410static bool ParseFailedExpectMinFieldNum(const std::string& line,
411 int expected_min_fields,
412 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200413 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000414 description << "Expects at least " << expected_min_fields << " fields.";
415 return ParseFailed(line, description.str(), error);
416}
417
418// |line| is the failing line. The failure is due to the fact that it failed to
419// get the value of |attribute|.
420static bool ParseFailedGetValue(const std::string& line,
421 const std::string& attribute,
422 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200423 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000424 description << "Failed to get the value of attribute: " << attribute;
425 return ParseFailed(line, description.str(), error);
426}
427
428// The line starting at |line_start| of |message| is the failing line. The
429// failure is due to the line type (e.g. the "m" part of the "m-line")
430// not matching what is expected. The expected line type should be
431// provided as |line_type|.
432static bool ParseFailedExpectLine(const std::string& message,
433 size_t line_start,
434 const char line_type,
435 const std::string& line_value,
436 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200437 rtc::StringBuilder description;
438 description << "Expect line: " << std::string(1, line_type) << "="
439 << line_value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000440 return ParseFailed(message, line_start, description.str(), error);
441}
442
443static bool AddLine(const std::string& line, std::string* message) {
444 if (!message)
445 return false;
446
447 message->append(line);
448 message->append(kLineBreak);
449 return true;
450}
451
452static bool GetLine(const std::string& message,
453 size_t* pos,
454 std::string* line) {
455 size_t line_begin = *pos;
456 size_t line_end = message.find(kNewLine, line_begin);
457 if (line_end == std::string::npos) {
458 return false;
459 }
460 // Update the new start position
461 *pos = line_end + 1;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200462 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000463 --line_end;
464 }
465 *line = message.substr(line_begin, (line_end - line_begin));
466 const char* cline = line->c_str();
467 // RFC 4566
468 // An SDP session description consists of a number of lines of text of
469 // the form:
470 // <type>=<value>
471 // where <type> MUST be exactly one case-significant character and
472 // <value> is structured text whose format depends on <type>.
473 // Whitespace MUST NOT be used on either side of the "=" sign.
Taylor Brandstetter93a7b242018-04-16 10:45:24 -0700474 //
475 // However, an exception to the whitespace rule is made for "s=", since
476 // RFC4566 also says:
477 //
478 // If a session has no meaningful name, the value "s= " SHOULD be used
479 // (i.e., a single space as the session name).
480 if (line->length() < 3 || !islower(cline[0]) ||
Jonas Olssonec9e4922018-09-05 09:53:49 +0200481 cline[1] != kSdpDelimiterEqualChar ||
482 (cline[0] != kLineTypeSessionName &&
483 cline[2] == kSdpDelimiterSpaceChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000484 *pos = line_begin;
485 return false;
486 }
487 return true;
488}
489
490// Init |os| to "|type|=|value|".
491static void InitLine(const char type,
492 const std::string& value,
Jonas Olssonec9e4922018-09-05 09:53:49 +0200493 rtc::StringBuilder* os) {
494 os->Clear();
495 *os << std::string(1, type) << kSdpDelimiterEqual << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000496}
497
498// Init |os| to "a=|attribute|".
Jonas Olssonec9e4922018-09-05 09:53:49 +0200499static void InitAttrLine(const std::string& attribute, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000500 InitLine(kLineTypeAttributes, attribute, os);
501}
502
503// Writes a SDP attribute line based on |attribute| and |value| to |message|.
Yves Gerey665174f2018-06-19 15:03:05 +0200504static void AddAttributeLine(const std::string& attribute,
505 int value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000506 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200507 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000508 InitAttrLine(attribute, &os);
509 os << kSdpDelimiterColon << value;
510 AddLine(os.str(), message);
511}
512
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000513static bool IsLineType(const std::string& message,
514 const char type,
515 size_t line_start) {
516 if (message.size() < line_start + kLinePrefixLength) {
517 return false;
518 }
519 const char* cmessage = message.c_str();
520 return (cmessage[line_start] == type &&
Jonas Olssonec9e4922018-09-05 09:53:49 +0200521 cmessage[line_start + 1] == kSdpDelimiterEqualChar);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000522}
523
Yves Gerey665174f2018-06-19 15:03:05 +0200524static bool IsLineType(const std::string& line, const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000525 return IsLineType(line, type, 0);
526}
527
Yves Gerey665174f2018-06-19 15:03:05 +0200528static bool GetLineWithType(const std::string& message,
529 size_t* pos,
530 std::string* line,
531 const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000532 if (!IsLineType(message, type, *pos)) {
533 return false;
534 }
535
536 if (!GetLine(message, pos, line))
537 return false;
538
539 return true;
540}
541
542static bool HasAttribute(const std::string& line,
543 const std::string& attribute) {
Johannes Kron211856b2018-09-06 12:12:28 +0200544 if (line.compare(kLinePrefixLength, attribute.size(), attribute) == 0) {
545 // Make sure that the match is not only a partial match. If length of
546 // strings doesn't match, the next character of the line must be ':' or ' '.
547 // This function is also used for media descriptions (e.g., "m=audio 9..."),
548 // hence the need to also allow space in the end.
549 RTC_CHECK_LE(kLinePrefixLength + attribute.size(), line.size());
550 if ((kLinePrefixLength + attribute.size()) == line.size() ||
551 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterColonChar ||
552 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterSpaceChar) {
553 return true;
554 }
555 }
556 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000557}
558
Peter Boström0c4e06b2015-10-07 12:23:21 +0200559static bool AddSsrcLine(uint32_t ssrc_id,
560 const std::string& attribute,
561 const std::string& value,
562 std::string* message) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000563 // RFC 5576
564 // a=ssrc:<ssrc-id> <attribute>:<value>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200565 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000566 InitAttrLine(kAttributeSsrc, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200567 os << kSdpDelimiterColon << ssrc_id << kSdpDelimiterSpace << attribute
568 << kSdpDelimiterColon << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000569 return AddLine(os.str(), message);
570}
571
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000572// Get value only from <attribute>:<value>.
Yves Gerey665174f2018-06-19 15:03:05 +0200573static bool GetValue(const std::string& message,
574 const std::string& attribute,
575 std::string* value,
576 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000577 std::string leftpart;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200578 if (!rtc::tokenize_first(message, kSdpDelimiterColonChar, &leftpart, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000579 return ParseFailedGetValue(message, attribute, error);
580 }
581 // The left part should end with the expected attribute.
582 if (leftpart.length() < attribute.length() ||
583 leftpart.compare(leftpart.length() - attribute.length(),
584 attribute.length(), attribute) != 0) {
585 return ParseFailedGetValue(message, attribute, error);
586 }
587 return true;
588}
589
590static bool CaseInsensitiveFind(std::string str1, std::string str2) {
Yves Gerey665174f2018-06-19 15:03:05 +0200591 std::transform(str1.begin(), str1.end(), str1.begin(), ::tolower);
592 std::transform(str2.begin(), str2.end(), str2.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000593 return str1.find(str2) != std::string::npos;
594}
595
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000596template <class T>
597static bool GetValueFromString(const std::string& line,
598 const std::string& s,
599 T* t,
600 SdpParseError* error) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000601 if (!rtc::FromString(s, t)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200602 rtc::StringBuilder description;
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000603 description << "Invalid value: " << s << ".";
604 return ParseFailed(line, description.str(), error);
605 }
606 return true;
607}
608
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000609static bool GetPayloadTypeFromString(const std::string& line,
610 const std::string& s,
611 int* payload_type,
612 SdpParseError* error) {
613 return GetValueFromString(line, s, payload_type, error) &&
Yves Gerey665174f2018-06-19 15:03:05 +0200614 cricket::IsValidRtpPayloadType(*payload_type);
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000615}
616
Seth Hampson5897a6e2018-04-03 11:16:33 -0700617// Creates a StreamParams track in the case when no SSRC lines are signaled.
618// This is a track that does not contain SSRCs and only contains
619// stream_ids/track_id if it's signaled with a=msid lines.
620void CreateTrackWithNoSsrcs(const std::vector<std::string>& msid_stream_ids,
621 const std::string& msid_track_id,
622 StreamParamsVec* tracks) {
623 StreamParams track;
624 if (msid_track_id.empty() || msid_stream_ids.empty()) {
625 // We only create an unsignaled track if a=msid lines were signaled.
626 return;
627 }
628 track.set_stream_ids(msid_stream_ids);
629 track.id = msid_track_id;
630 tracks->push_back(track);
631}
632
633// Creates the StreamParams tracks, for the case when SSRC lines are signaled.
634// |msid_stream_ids| and |msid_track_id| represent the stream/track ID from the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800635// "a=msid" attribute, if it exists. They are empty if the attribute does not
Seth Hampson5897a6e2018-04-03 11:16:33 -0700636// exist. We prioritize getting stream_ids/track_ids signaled in a=msid lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000637void CreateTracksFromSsrcInfos(const SsrcInfoVec& ssrc_infos,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700638 const std::vector<std::string>& msid_stream_ids,
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800639 const std::string& msid_track_id,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700640 StreamParamsVec* tracks,
641 int msid_signaling) {
nisseede5da42017-01-12 05:15:36 -0800642 RTC_DCHECK(tracks != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700643 for (const SsrcInfo& ssrc_info : ssrc_infos) {
644 if (ssrc_info.cname.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000645 continue;
646 }
647
Seth Hampson5b4f0752018-04-02 16:31:36 -0700648 std::vector<std::string> stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000649 std::string track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700650 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
651 // This is the case with Unified Plan SDP msid signaling.
652 stream_ids = msid_stream_ids;
Tomas Gunnarsson191bf5c2018-03-30 10:44:43 +0000653 track_id = msid_track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700654 } else if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
655 // This is the case with Plan B SDP msid signaling.
Steve Anton4daf66e2018-09-07 14:55:53 -0700656 stream_ids.push_back(ssrc_info.stream_id);
657 track_id = ssrc_info.track_id;
658 } else if (!ssrc_info.mslabel.empty()) {
Seth Hampson5b4f0752018-04-02 16:31:36 -0700659 // Since there's no a=msid or a=ssrc msid signaling, this is a sdp from
660 // an older version of client that doesn't support msid.
661 // In that case, we use the mslabel and label to construct the track.
Steve Anton4daf66e2018-09-07 14:55:53 -0700662 stream_ids.push_back(ssrc_info.mslabel);
663 track_id = ssrc_info.label;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700664 } else {
665 // Since no media streams isn't supported with older SDP signaling, we
666 // use a default a stream id.
667 stream_ids.push_back(kDefaultMsid);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000668 }
Seth Hampson5b4f0752018-04-02 16:31:36 -0700669 // If a track ID wasn't populated from the SSRC attributes OR the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800670 // msid attribute, use default/random values.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800671 if (track_id.empty()) {
672 // TODO(ronghuawu): What should we do if the track id doesn't appear?
673 // Create random string (which will be used as track label later)?
674 track_id = rtc::CreateRandomString(8);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000675 }
676
Steve Anton4daf66e2018-09-07 14:55:53 -0700677 auto track_it = std::find_if(
678 tracks->begin(), tracks->end(),
679 [track_id](const StreamParams& track) { return track.id == track_id; });
680 if (track_it == tracks->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000681 // If we don't find an existing track, create a new one.
682 tracks->push_back(StreamParams());
Steve Anton4daf66e2018-09-07 14:55:53 -0700683 track_it = tracks->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000684 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700685 StreamParams& track = *track_it;
686 track.add_ssrc(ssrc_info.ssrc_id);
687 track.cname = ssrc_info.cname;
688 track.set_stream_ids(stream_ids);
689 track.id = track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000690 }
691}
692
Seth Hampson845e8782018-03-02 11:34:10 -0800693void GetMediaStreamIds(const ContentInfo* content,
694 std::set<std::string>* labels) {
Steve Antonb1c1de12017-12-21 15:14:30 -0800695 for (const StreamParams& stream_params :
696 content->media_description()->streams()) {
Seth Hampson845e8782018-03-02 11:34:10 -0800697 for (const std::string& stream_id : stream_params.stream_ids()) {
698 labels->insert(stream_id);
Steve Anton5a26a3a2018-02-28 11:38:47 -0800699 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000700 }
701}
702
703// RFC 5245
704// It is RECOMMENDED that default candidates be chosen based on the
705// likelihood of those candidates to work with the peer that is being
706// contacted. It is RECOMMENDED that relayed > reflexive > host.
707static const int kPreferenceUnknown = 0;
708static const int kPreferenceHost = 1;
709static const int kPreferenceReflexive = 2;
710static const int kPreferenceRelayed = 3;
711
712static int GetCandidatePreferenceFromType(const std::string& type) {
713 int preference = kPreferenceUnknown;
714 if (type == cricket::LOCAL_PORT_TYPE) {
715 preference = kPreferenceHost;
716 } else if (type == cricket::STUN_PORT_TYPE) {
717 preference = kPreferenceReflexive;
718 } else if (type == cricket::RELAY_PORT_TYPE) {
719 preference = kPreferenceRelayed;
720 } else {
nissec80e7412017-01-11 05:56:46 -0800721 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000722 }
723 return preference;
724}
725
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000726// Get ip and port of the default destination from the |candidates| with the
727// given value of |component_id|. The default candidate should be the one most
728// likely to work, typically IPv4 relay.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000729// RFC 5245
730// The value of |component_id| currently supported are 1 (RTP) and 2 (RTCP).
Steve Anton36b29d12017-10-30 09:57:42 -0700731// TODO(deadbeef): Decide the default destination in webrtcsession and
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000732// pass it down via SessionDescription.
Yves Gerey665174f2018-06-19 15:03:05 +0200733static void GetDefaultDestination(const std::vector<Candidate>& candidates,
734 int component_id,
735 std::string* port,
736 std::string* ip,
737 std::string* addr_type) {
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000738 *addr_type = kConnectionIpv4Addrtype;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000739 *port = kDummyPort;
740 *ip = kDummyAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000741 int current_preference = kPreferenceUnknown;
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000742 int current_family = AF_UNSPEC;
Steve Anton4daf66e2018-09-07 14:55:53 -0700743 for (const Candidate& candidate : candidates) {
744 if (candidate.component() != component_id) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000745 continue;
746 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000747 // Default destination should be UDP only.
Steve Anton4daf66e2018-09-07 14:55:53 -0700748 if (candidate.protocol() != cricket::UDP_PROTOCOL_NAME) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000749 continue;
750 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700751 const int preference = GetCandidatePreferenceFromType(candidate.type());
752 const int family = candidate.address().ipaddr().family();
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000753 // See if this candidate is more preferable then the current one if it's the
754 // same family. Or if the current family is IPv4 already so we could safely
755 // ignore all IPv6 ones. WebRTC bug 4269.
756 // http://code.google.com/p/webrtc/issues/detail?id=4269
757 if ((preference <= current_preference && current_family == family) ||
758 (current_family == AF_INET && family == AF_INET6)) {
759 continue;
760 }
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000761 if (family == AF_INET) {
762 addr_type->assign(kConnectionIpv4Addrtype);
763 } else if (family == AF_INET6) {
764 addr_type->assign(kConnectionIpv6Addrtype);
765 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000766 current_preference = preference;
767 current_family = family;
Steve Anton4daf66e2018-09-07 14:55:53 -0700768 *port = candidate.address().PortAsString();
769 *ip = candidate.address().ipaddr().ToString();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000770 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000771}
772
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000773// Gets "a=rtcp" line if found default RTCP candidate from |candidates|.
774static std::string GetRtcpLine(const std::vector<Candidate>& candidates) {
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000775 std::string rtcp_line, rtcp_port, rtcp_ip, addr_type;
Yves Gerey665174f2018-06-19 15:03:05 +0200776 GetDefaultDestination(candidates, ICE_CANDIDATE_COMPONENT_RTCP, &rtcp_port,
777 &rtcp_ip, &addr_type);
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000778 // Found default RTCP candidate.
779 // RFC 5245
780 // If the agent is utilizing RTCP, it MUST encode the RTCP candidate
781 // using the a=rtcp attribute as defined in RFC 3605.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000782
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000783 // RFC 3605
784 // rtcp-attribute = "a=rtcp:" port [nettype space addrtype space
785 // connection-address] CRLF
Jonas Olssonec9e4922018-09-05 09:53:49 +0200786 rtc::StringBuilder os;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000787 InitAttrLine(kAttributeRtcp, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200788 os << kSdpDelimiterColon << rtcp_port << " " << kConnectionNettype << " "
789 << addr_type << " " << rtcp_ip;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000790 rtcp_line = os.str();
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000791 return rtcp_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000792}
793
794// Get candidates according to the mline index from SessionDescriptionInterface.
795static void GetCandidatesByMindex(const SessionDescriptionInterface& desci,
796 int mline_index,
797 std::vector<Candidate>* candidates) {
798 if (!candidates) {
799 return;
800 }
801 const IceCandidateCollection* cc = desci.candidates(mline_index);
802 for (size_t i = 0; i < cc->count(); ++i) {
803 const IceCandidateInterface* candidate = cc->at(i);
804 candidates->push_back(candidate->candidate());
805 }
806}
807
deadbeef90f1e1e2017-02-10 12:35:05 -0800808static bool IsValidPort(int port) {
809 return port >= 0 && port <= 65535;
810}
811
Steve Antone831b8c2018-02-01 12:22:16 -0800812std::string SdpSerialize(const JsepSessionDescription& jdesc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000813 const cricket::SessionDescription* desc = jdesc.description();
814 if (!desc) {
815 return "";
816 }
817
818 std::string message;
819
820 // Session Description.
821 AddLine(kSessionVersion, &message);
822 // Session Origin
823 // RFC 4566
824 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
825 // <unicast-address>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200826 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000827 InitLine(kLineTypeOrigin, kSessionOriginUsername, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200828 const std::string& session_id =
829 jdesc.session_id().empty() ? kSessionOriginSessionId : jdesc.session_id();
830 const std::string& session_version = jdesc.session_version().empty()
831 ? kSessionOriginSessionVersion
832 : jdesc.session_version();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000833 os << " " << session_id << " " << session_version << " "
834 << kSessionOriginNettype << " " << kSessionOriginAddrtype << " "
835 << kSessionOriginAddress;
836 AddLine(os.str(), &message);
837 AddLine(kSessionName, &message);
838
839 // Time Description.
840 AddLine(kTimeDescription, &message);
841
842 // Group
843 if (desc->HasGroup(cricket::GROUP_TYPE_BUNDLE)) {
844 std::string group_line = kAttrGroup;
845 const cricket::ContentGroup* group =
846 desc->GetGroupByName(cricket::GROUP_TYPE_BUNDLE);
nisseede5da42017-01-12 05:15:36 -0800847 RTC_DCHECK(group != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700848 for (const std::string& content_name : group->content_names()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000849 group_line.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -0700850 group_line.append(content_name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000851 }
852 AddLine(group_line, &message);
853 }
854
855 // MediaStream semantics
856 InitAttrLine(kAttributeMsidSemantics, &os);
857 os << kSdpDelimiterColon << " " << kMediaStreamSemantic;
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000858
Seth Hampson845e8782018-03-02 11:34:10 -0800859 std::set<std::string> media_stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000860 const ContentInfo* audio_content = GetFirstAudioContent(desc);
861 if (audio_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800862 GetMediaStreamIds(audio_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000863
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000864 const ContentInfo* video_content = GetFirstVideoContent(desc);
865 if (video_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800866 GetMediaStreamIds(video_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000867
Steve Anton4daf66e2018-09-07 14:55:53 -0700868 for (const std::string& id : media_stream_ids) {
869 os << " " << id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000870 }
871 AddLine(os.str(), &message);
872
Taylor Brandstetter2f65ec52018-05-24 11:37:28 -0700873 // a=ice-lite
874 //
875 // TODO(deadbeef): It's weird that we need to iterate TransportInfos for
876 // this, when it's a session-level attribute. It really should be moved to a
877 // session-level structure like SessionDescription.
878 for (const cricket::TransportInfo& transport : desc->transport_infos()) {
879 if (transport.description.ice_mode == cricket::ICEMODE_LITE) {
880 InitAttrLine(kAttributeIceLite, &os);
881 AddLine(os.str(), &message);
882 break;
883 }
884 }
885
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000886 // Preserve the order of the media contents.
887 int mline_index = -1;
Steve Anton4daf66e2018-09-07 14:55:53 -0700888 for (const ContentInfo& content : desc->contents()) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000889 std::vector<Candidate> candidates;
890 GetCandidatesByMindex(jdesc, ++mline_index, &candidates);
Steve Anton4daf66e2018-09-07 14:55:53 -0700891 BuildMediaDescription(&content, desc->GetTransportInfoByName(content.name),
892 content.media_description()->type(), candidates,
893 desc->msid_signaling(), &message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000894 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000895 return message;
896}
897
898// Serializes the passed in IceCandidateInterface to a SDP string.
899// candidate - The candidate to be serialized.
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700900std::string SdpSerializeCandidate(const IceCandidateInterface& candidate) {
901 return SdpSerializeCandidate(candidate.candidate());
902}
903
904// Serializes a cricket Candidate.
905std::string SdpSerializeCandidate(const cricket::Candidate& candidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000906 std::string message;
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700907 std::vector<cricket::Candidate> candidates(1, candidate);
honghaiza54a0802015-12-16 18:37:23 -0800908 BuildCandidate(candidates, true, &message);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000909 // From WebRTC draft section 4.8.1.1 candidate-attribute will be
910 // just candidate:<candidate> not a=candidate:<blah>CRLF
nisseede5da42017-01-12 05:15:36 -0800911 RTC_DCHECK(message.find("a=") == 0);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000912 message.erase(0, 2);
nisseede5da42017-01-12 05:15:36 -0800913 RTC_DCHECK(message.find(kLineBreak) == message.size() - 2);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000914 message.resize(message.size() - 2);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000915 return message;
916}
917
918bool SdpDeserialize(const std::string& message,
919 JsepSessionDescription* jdesc,
920 SdpParseError* error) {
921 std::string session_id;
922 std::string session_version;
Peter Thatcher7cbd1882015-09-17 18:54:52 -0700923 TransportDescription session_td("", "");
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000924 RtpHeaderExtensions session_extmaps;
zhihuang38989e52017-03-21 11:04:53 -0700925 rtc::SocketAddress session_connection_addr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000926 cricket::SessionDescription* desc = new cricket::SessionDescription();
927 std::vector<JsepIceCandidate*> candidates;
928 size_t current_pos = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000929
930 // Session Description
931 if (!ParseSessionDescription(message, &current_pos, &session_id,
deadbeefc80741f2015-10-22 13:14:45 -0700932 &session_version, &session_td, &session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700933 &session_connection_addr, desc, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000934 delete desc;
935 return false;
936 }
937
938 // Media Description
deadbeefc80741f2015-10-22 13:14:45 -0700939 if (!ParseMediaDescription(message, session_td, session_extmaps, &current_pos,
zhihuang38989e52017-03-21 11:04:53 -0700940 session_connection_addr, desc, &candidates,
941 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000942 delete desc;
Steve Anton4daf66e2018-09-07 14:55:53 -0700943 for (JsepIceCandidate* candidate : candidates) {
944 delete candidate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000945 }
946 return false;
947 }
948
949 jdesc->Initialize(desc, session_id, session_version);
950
Steve Anton4daf66e2018-09-07 14:55:53 -0700951 for (JsepIceCandidate* candidate : candidates) {
952 jdesc->AddCandidate(candidate);
953 delete candidate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000954 }
955 return true;
956}
957
958bool SdpDeserializeCandidate(const std::string& message,
959 JsepIceCandidate* jcandidate,
960 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -0800961 RTC_DCHECK(jcandidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000962 Candidate candidate;
963 if (!ParseCandidate(message, &candidate, error, true)) {
964 return false;
965 }
966 jcandidate->SetCandidate(candidate);
967 return true;
968}
969
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700970bool SdpDeserializeCandidate(const std::string& transport_name,
971 const std::string& message,
972 cricket::Candidate* candidate,
973 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -0800974 RTC_DCHECK(candidate != nullptr);
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700975 if (!ParseCandidate(message, candidate, error, true)) {
976 return false;
977 }
978 candidate->set_transport_name(transport_name);
979 return true;
980}
981
Yves Gerey665174f2018-06-19 15:03:05 +0200982bool ParseCandidate(const std::string& message,
983 Candidate* candidate,
984 SdpParseError* error,
985 bool is_raw) {
nisseede5da42017-01-12 05:15:36 -0800986 RTC_DCHECK(candidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000987
988 // Get the first line from |message|.
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +0000989 std::string first_line = message;
990 size_t pos = 0;
991 GetLine(message, &pos, &first_line);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000992
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +0000993 // Makes sure |message| contains only one line.
994 if (message.size() > first_line.size()) {
995 std::string left, right;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200996 if (rtc::tokenize_first(message, kNewLineChar, &left, &right) &&
Donald Curtis0e07f922015-05-15 09:21:23 -0700997 !right.empty()) {
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +0000998 return ParseFailed(message, 0, "Expect one line only", error);
999 }
1000 }
1001
1002 // From WebRTC draft section 4.8.1.1 candidate-attribute should be
1003 // candidate:<candidate> when trickled, but we still support
1004 // a=candidate:<blah>CRLF for backward compatibility and for parsing a line
1005 // from the SDP.
1006 if (IsLineType(first_line, kLineTypeAttributes)) {
1007 first_line = first_line.substr(kLinePrefixLength);
1008 }
1009
1010 std::string attribute_candidate;
1011 std::string candidate_value;
1012
1013 // |first_line| must be in the form of "candidate:<value>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001014 if (!rtc::tokenize_first(first_line, kSdpDelimiterColonChar,
1015 &attribute_candidate, &candidate_value) ||
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001016 attribute_candidate != kAttributeCandidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001017 if (is_raw) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001018 rtc::StringBuilder description;
Yves Gerey665174f2018-06-19 15:03:05 +02001019 description << "Expect line: " << kAttributeCandidate << ":"
1020 << "<candidate-str>";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001021 return ParseFailed(first_line, 0, description.str(), error);
1022 } else {
1023 return ParseFailedExpectLine(first_line, 0, kLineTypeAttributes,
1024 kAttributeCandidate, error);
1025 }
1026 }
1027
1028 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001029 rtc::split(candidate_value, kSdpDelimiterSpaceChar, &fields);
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001030
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001031 // RFC 5245
1032 // a=candidate:<foundation> <component-id> <transport> <priority>
1033 // <connection-address> <port> typ <candidate-types>
1034 // [raddr <connection-address>] [rport <port>]
1035 // *(SP extension-att-name SP extension-att-value)
1036 const size_t expected_min_fields = 8;
1037 if (fields.size() < expected_min_fields ||
1038 (fields[6] != kAttributeCandidateTyp)) {
1039 return ParseFailedExpectMinFieldNum(first_line, expected_min_fields, error);
1040 }
jbauch083b73f2015-07-16 02:46:32 -07001041 const std::string& foundation = fields[0];
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001042
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001043 int component_id = 0;
1044 if (!GetValueFromString(first_line, fields[1], &component_id, error)) {
1045 return false;
1046 }
jbauch083b73f2015-07-16 02:46:32 -07001047 const std::string& transport = fields[2];
Peter Boström0c4e06b2015-10-07 12:23:21 +02001048 uint32_t priority = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001049 if (!GetValueFromString(first_line, fields[3], &priority, error)) {
1050 return false;
1051 }
jbauch083b73f2015-07-16 02:46:32 -07001052 const std::string& connection_address = fields[4];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001053 int port = 0;
1054 if (!GetValueFromString(first_line, fields[5], &port, error)) {
1055 return false;
1056 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001057 if (!IsValidPort(port)) {
1058 return ParseFailed(first_line, "Invalid port number.", error);
1059 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001060 SocketAddress address(connection_address, port);
1061
1062 cricket::ProtocolType protocol;
hnslb68cc752016-12-13 10:33:41 -08001063 if (!StringToProto(transport.c_str(), &protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001064 return ParseFailed(first_line, "Unsupported transport type.", error);
1065 }
hnslb68cc752016-12-13 10:33:41 -08001066 switch (protocol) {
1067 case cricket::PROTO_UDP:
1068 case cricket::PROTO_TCP:
1069 case cricket::PROTO_SSLTCP:
1070 // Supported protocol.
1071 break;
1072 default:
1073 return ParseFailed(first_line, "Unsupported transport type.", error);
1074 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001075
1076 std::string candidate_type;
jbauch083b73f2015-07-16 02:46:32 -07001077 const std::string& type = fields[7];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001078 if (type == kCandidateHost) {
1079 candidate_type = cricket::LOCAL_PORT_TYPE;
1080 } else if (type == kCandidateSrflx) {
1081 candidate_type = cricket::STUN_PORT_TYPE;
1082 } else if (type == kCandidateRelay) {
1083 candidate_type = cricket::RELAY_PORT_TYPE;
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001084 } else if (type == kCandidatePrflx) {
1085 candidate_type = cricket::PRFLX_PORT_TYPE;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001086 } else {
1087 return ParseFailed(first_line, "Unsupported candidate type.", error);
1088 }
1089
1090 size_t current_position = expected_min_fields;
1091 SocketAddress related_address;
1092 // The 2 optional fields for related address
1093 // [raddr <connection-address>] [rport <port>]
1094 if (fields.size() >= (current_position + 2) &&
1095 fields[current_position] == kAttributeCandidateRaddr) {
1096 related_address.SetIP(fields[++current_position]);
1097 ++current_position;
1098 }
1099 if (fields.size() >= (current_position + 2) &&
1100 fields[current_position] == kAttributeCandidateRport) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001101 int port = 0;
Yves Gerey665174f2018-06-19 15:03:05 +02001102 if (!GetValueFromString(first_line, fields[++current_position], &port,
1103 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001104 return false;
1105 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001106 if (!IsValidPort(port)) {
1107 return ParseFailed(first_line, "Invalid port number.", error);
1108 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001109 related_address.SetPort(port);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001110 ++current_position;
1111 }
1112
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001113 // If this is a TCP candidate, it has additional extension as defined in
1114 // RFC 6544.
1115 std::string tcptype;
1116 if (fields.size() >= (current_position + 2) &&
1117 fields[current_position] == kTcpCandidateType) {
1118 tcptype = fields[++current_position];
1119 ++current_position;
1120
1121 if (tcptype != cricket::TCPTYPE_ACTIVE_STR &&
1122 tcptype != cricket::TCPTYPE_PASSIVE_STR &&
1123 tcptype != cricket::TCPTYPE_SIMOPEN_STR) {
1124 return ParseFailed(first_line, "Invalid TCP candidate type.", error);
1125 }
1126
1127 if (protocol != cricket::PROTO_TCP) {
1128 return ParseFailed(first_line, "Invalid non-TCP candidate", error);
1129 }
1130 }
1131
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001132 // Extension
honghaiza54a0802015-12-16 18:37:23 -08001133 // Though non-standard, we support the ICE ufrag and pwd being signaled on
1134 // the candidate to avoid issues with confusing which generation a candidate
1135 // belongs to when trickling multiple generations at the same time.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001136 std::string username;
1137 std::string password;
Peter Boström0c4e06b2015-10-07 12:23:21 +02001138 uint32_t generation = 0;
honghaiza0c44ea2016-03-23 16:07:48 -07001139 uint16_t network_id = 0;
1140 uint16_t network_cost = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001141 for (size_t i = current_position; i + 1 < fields.size(); ++i) {
1142 // RFC 5245
1143 // *(SP extension-att-name SP extension-att-value)
1144 if (fields[i] == kAttributeCandidateGeneration) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001145 if (!GetValueFromString(first_line, fields[++i], &generation, error)) {
1146 return false;
1147 }
honghaiza54a0802015-12-16 18:37:23 -08001148 } else if (fields[i] == kAttributeCandidateUfrag) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001149 username = fields[++i];
honghaiza54a0802015-12-16 18:37:23 -08001150 } else if (fields[i] == kAttributeCandidatePwd) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001151 password = fields[++i];
honghaiza0c44ea2016-03-23 16:07:48 -07001152 } else if (fields[i] == kAttributeCandidateNetworkId) {
1153 if (!GetValueFromString(first_line, fields[++i], &network_id, error)) {
1154 return false;
1155 }
honghaize1a0c942016-02-16 14:54:56 -08001156 } else if (fields[i] == kAttributeCandidateNetworkCost) {
1157 if (!GetValueFromString(first_line, fields[++i], &network_cost, error)) {
1158 return false;
1159 }
Honghai Zhang351d77b2016-05-20 15:08:29 -07001160 network_cost = std::min(network_cost, rtc::kNetworkCostMax);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001161 } else {
1162 // Skip the unknown extension.
1163 ++i;
1164 }
1165 }
1166
guoweis@webrtc.org61c12472015-01-15 06:53:07 +00001167 *candidate = Candidate(component_id, cricket::ProtoToString(protocol),
guoweis@webrtc.org950c5182014-12-16 23:01:31 +00001168 address, priority, username, password, candidate_type,
honghaiza0c44ea2016-03-23 16:07:48 -07001169 generation, foundation, network_id, network_cost);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001170 candidate->set_related_address(related_address);
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001171 candidate->set_tcptype(tcptype);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001172 return true;
1173}
1174
1175bool ParseIceOptions(const std::string& line,
1176 std::vector<std::string>* transport_options,
1177 SdpParseError* error) {
1178 std::string ice_options;
1179 if (!GetValue(line, kAttributeIceOption, &ice_options, error)) {
1180 return false;
1181 }
1182 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001183 rtc::split(ice_options, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001184 for (size_t i = 0; i < fields.size(); ++i) {
1185 transport_options->push_back(fields[i]);
1186 }
1187 return true;
1188}
1189
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001190bool ParseSctpPort(const std::string& line,
1191 int* sctp_port,
1192 SdpParseError* error) {
1193 // draft-ietf-mmusic-sctp-sdp-07
1194 // a=sctp-port
1195 std::vector<std::string> fields;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001196 const size_t expected_min_fields = 2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001197 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
lally69f57602015-10-08 10:15:04 -07001198 if (fields.size() < expected_min_fields) {
1199 fields.resize(0);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001200 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
lally69f57602015-10-08 10:15:04 -07001201 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001202 if (fields.size() < expected_min_fields) {
1203 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1204 }
1205 if (!rtc::FromString(fields[1], sctp_port)) {
lally69f57602015-10-08 10:15:04 -07001206 return ParseFailed(line, "Invalid sctp port value.", error);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001207 }
1208 return true;
1209}
1210
isheriff6f8d6862016-05-26 11:24:55 -07001211bool ParseExtmap(const std::string& line,
1212 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001213 SdpParseError* error) {
1214 // RFC 5285
1215 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1216 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001217 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001218 const size_t expected_min_fields = 2;
1219 if (fields.size() < expected_min_fields) {
1220 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1221 }
1222 std::string uri = fields[1];
1223
1224 std::string value_direction;
1225 if (!GetValue(fields[0], kAttributeExtmap, &value_direction, error)) {
1226 return false;
1227 }
1228 std::vector<std::string> sub_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001229 rtc::split(value_direction, kSdpDelimiterSlashChar, &sub_fields);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001230 int value = 0;
1231 if (!GetValueFromString(line, sub_fields[0], &value, error)) {
1232 return false;
1233 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001234
jbauch5869f502017-06-29 12:31:36 -07001235 bool encrypted = false;
1236 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1237 // RFC 6904
Steve Anton36b29d12017-10-30 09:57:42 -07001238 // a=extmap:<value["/"<direction>] urn:ietf:params:rtp-hdrext:encrypt <URI>
1239 // <extensionattributes>
jbauch5869f502017-06-29 12:31:36 -07001240 const size_t expected_min_fields_encrypted = expected_min_fields + 1;
1241 if (fields.size() < expected_min_fields_encrypted) {
1242 return ParseFailedExpectMinFieldNum(line, expected_min_fields_encrypted,
Yves Gerey665174f2018-06-19 15:03:05 +02001243 error);
jbauch5869f502017-06-29 12:31:36 -07001244 }
1245
1246 encrypted = true;
1247 uri = fields[2];
1248 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1249 return ParseFailed(line, "Recursive encrypted header.", error);
1250 }
1251 }
1252
1253 *extmap = RtpExtension(uri, value, encrypted);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001254 return true;
1255}
1256
1257void BuildMediaDescription(const ContentInfo* content_info,
1258 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001259 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001260 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -08001261 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001262 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001263 RTC_DCHECK(message != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001264 if (content_info == NULL || message == NULL) {
1265 return;
1266 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001267 rtc::StringBuilder os;
Steve Antonb1c1de12017-12-21 15:14:30 -08001268 const MediaContentDescription* media_desc = content_info->media_description();
1269 RTC_DCHECK(media_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001270
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001271 int sctp_port = cricket::kSctpDefaultPort;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001272
1273 // RFC 4566
1274 // m=<media> <port> <proto> <fmt>
1275 // fmt is a list of payload type numbers that MAY be used in the session.
1276 const char* type = NULL;
1277 if (media_type == cricket::MEDIA_TYPE_AUDIO)
1278 type = kMediaTypeAudio;
1279 else if (media_type == cricket::MEDIA_TYPE_VIDEO)
1280 type = kMediaTypeVideo;
1281 else if (media_type == cricket::MEDIA_TYPE_DATA)
1282 type = kMediaTypeData;
1283 else
nissec80e7412017-01-11 05:56:46 -08001284 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001285
1286 std::string fmt;
1287 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001288 const VideoContentDescription* video_desc = media_desc->as_video();
Steve Anton4daf66e2018-09-07 14:55:53 -07001289 for (const cricket::VideoCodec& codec : video_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001290 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001291 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001292 }
1293 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001294 const AudioContentDescription* audio_desc = media_desc->as_audio();
Steve Anton4daf66e2018-09-07 14:55:53 -07001295 for (const cricket::AudioCodec& codec : audio_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001296 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001297 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001298 }
1299 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001300 const DataContentDescription* data_desc = media_desc->as_data();
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001301 if (IsDtlsSctp(media_desc->protocol())) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001302 fmt.append(" ");
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001303
zstein4b2e0822017-02-17 19:48:38 -08001304 if (data_desc->use_sctpmap()) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001305 for (const cricket::DataCodec& codec : data_desc->codecs()) {
1306 if (cricket::CodecNamesEq(codec.name,
zstein4b2e0822017-02-17 19:48:38 -08001307 cricket::kGoogleSctpDataCodecName) &&
Steve Anton4daf66e2018-09-07 14:55:53 -07001308 codec.GetParam(cricket::kCodecParamPort, &sctp_port)) {
zstein4b2e0822017-02-17 19:48:38 -08001309 break;
1310 }
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001311 }
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001312
Jonas Olsson6b1985d2018-07-05 11:59:48 +02001313 fmt.append(rtc::ToString(sctp_port));
zstein4b2e0822017-02-17 19:48:38 -08001314 } else {
1315 fmt.append(kDefaultSctpmapProtocol);
1316 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001317 } else {
Steve Anton4daf66e2018-09-07 14:55:53 -07001318 for (const cricket::DataCodec& codec : data_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001319 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001320 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001321 }
1322 }
1323 }
1324 // The fmt must never be empty. If no codecs are found, set the fmt attribute
1325 // to 0.
1326 if (fmt.empty()) {
1327 fmt = " 0";
1328 }
1329
deadbeef25ed4352016-12-12 18:37:36 -08001330 // The port number in the m line will be updated later when associated with
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001331 // the candidates.
deadbeef25ed4352016-12-12 18:37:36 -08001332 //
1333 // A port value of 0 indicates that the m= section is rejected.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001334 // RFC 3264
1335 // To reject an offered stream, the port number in the corresponding stream in
1336 // the answer MUST be set to zero.
deadbeef25ed4352016-12-12 18:37:36 -08001337 //
1338 // However, the BUNDLE draft adds a new meaning to port zero, when used along
1339 // with a=bundle-only.
zhihuang38989e52017-03-21 11:04:53 -07001340 std::string port = kDummyPort;
1341 if (content_info->rejected || content_info->bundle_only) {
1342 port = kMediaPortRejected;
1343 } else if (!media_desc->connection_address().IsNil()) {
1344 port = rtc::ToString(media_desc->connection_address().port());
1345 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001346
Yves Gerey665174f2018-06-19 15:03:05 +02001347 rtc::SSLFingerprint* fp =
1348 (transport_info) ? transport_info->description.identity_fingerprint.get()
1349 : NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001350
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001351 // Add the m and c lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001352 InitLine(kLineTypeMedia, type, &os);
1353 os << " " << port << " " << media_desc->protocol() << fmt;
zhihuang38989e52017-03-21 11:04:53 -07001354 AddLine(os.str(), message);
1355
1356 InitLine(kLineTypeConnection, kConnectionNettype, &os);
1357 if (media_desc->connection_address().IsNil()) {
1358 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
1359 } else if (media_desc->connection_address().family() == AF_INET) {
1360 os << " " << kConnectionIpv4Addrtype << " "
1361 << media_desc->connection_address().ipaddr().ToString();
1362 } else {
1363 os << " " << kConnectionIpv6Addrtype << " "
1364 << media_desc->connection_address().ipaddr().ToString();
1365 }
1366 AddLine(os.str(), message);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001367
1368 // RFC 4566
1369 // b=AS:<bandwidth>
Peter Thatcherc0c3a862015-06-24 15:31:25 -07001370 if (media_desc->bandwidth() >= 1000) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001371 InitLine(kLineTypeSessionBandwidth, kApplicationSpecificMaximum, &os);
1372 os << kSdpDelimiterColon << (media_desc->bandwidth() / 1000);
1373 AddLine(os.str(), message);
1374 }
1375
deadbeef25ed4352016-12-12 18:37:36 -08001376 // Add the a=bundle-only line.
1377 if (content_info->bundle_only) {
1378 InitAttrLine(kAttributeBundleOnly, &os);
1379 AddLine(os.str(), message);
1380 }
1381
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001382 // Add the a=rtcp line.
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001383 if (IsRtp(media_desc->protocol())) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001384 std::string rtcp_line = GetRtcpLine(candidates);
1385 if (!rtcp_line.empty()) {
1386 AddLine(rtcp_line, message);
1387 }
1388 }
1389
honghaiza54a0802015-12-16 18:37:23 -08001390 // Build the a=candidate lines. We don't include ufrag and pwd in the
1391 // candidates in the SDP to avoid redundancy.
1392 BuildCandidate(candidates, false, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001393
1394 // Use the transport_info to build the media level ice-ufrag and ice-pwd.
1395 if (transport_info) {
1396 // RFC 5245
1397 // ice-pwd-att = "ice-pwd" ":" password
1398 // ice-ufrag-att = "ice-ufrag" ":" ufrag
1399 // ice-ufrag
deadbeef3f7219b2015-12-28 15:17:14 -08001400 if (!transport_info->description.ice_ufrag.empty()) {
1401 InitAttrLine(kAttributeIceUfrag, &os);
1402 os << kSdpDelimiterColon << transport_info->description.ice_ufrag;
1403 AddLine(os.str(), message);
1404 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001405 // ice-pwd
deadbeef3f7219b2015-12-28 15:17:14 -08001406 if (!transport_info->description.ice_pwd.empty()) {
1407 InitAttrLine(kAttributeIcePwd, &os);
1408 os << kSdpDelimiterColon << transport_info->description.ice_pwd;
1409 AddLine(os.str(), message);
1410 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001411
1412 // draft-petithuguenin-mmusic-ice-attributes-level-03
1413 BuildIceOptions(transport_info->description.transport_options, message);
1414
1415 // RFC 4572
1416 // fingerprint-attribute =
1417 // "fingerprint" ":" hash-func SP fingerprint
1418 if (fp) {
1419 // Insert the fingerprint attribute.
1420 InitAttrLine(kAttributeFingerprint, &os);
Yves Gerey665174f2018-06-19 15:03:05 +02001421 os << kSdpDelimiterColon << fp->algorithm << kSdpDelimiterSpace
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001422 << fp->GetRfc4572Fingerprint();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001423 AddLine(os.str(), message);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001424
1425 // Inserting setup attribute.
1426 if (transport_info->description.connection_role !=
Yves Gerey665174f2018-06-19 15:03:05 +02001427 cricket::CONNECTIONROLE_NONE) {
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001428 // Making sure we are not using "passive" mode.
1429 cricket::ConnectionRole role =
1430 transport_info->description.connection_role;
mallinath@webrtc.org19f27e62013-10-13 17:18:27 +00001431 std::string dtls_role_str;
nissec16fa5e2017-02-07 07:18:43 -08001432 const bool success =
1433 cricket::ConnectionRoleToString(role, &dtls_role_str);
1434 RTC_DCHECK(success);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001435 InitAttrLine(kAttributeSetup, &os);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001436 os << kSdpDelimiterColon << dtls_role_str;
1437 AddLine(os.str(), message);
1438 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001439 }
1440 }
1441
1442 // RFC 3388
1443 // mid-attribute = "a=mid:" identification-tag
1444 // identification-tag = token
1445 // Use the content name as the mid identification-tag.
1446 InitAttrLine(kAttributeMid, &os);
1447 os << kSdpDelimiterColon << content_info->name;
1448 AddLine(os.str(), message);
1449
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001450 if (IsDtlsSctp(media_desc->protocol())) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001451 const DataContentDescription* data_desc = media_desc->as_data();
zstein4b2e0822017-02-17 19:48:38 -08001452 bool use_sctpmap = data_desc->use_sctpmap();
1453 BuildSctpContentAttributes(message, sctp_port, use_sctpmap);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001454 } else if (IsRtp(media_desc->protocol())) {
Steve Antone831b8c2018-02-01 12:22:16 -08001455 BuildRtpContentAttributes(media_desc, media_type, msid_signaling, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001456 }
1457}
1458
zstein4b2e0822017-02-17 19:48:38 -08001459void BuildSctpContentAttributes(std::string* message,
1460 int sctp_port,
1461 bool use_sctpmap) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001462 rtc::StringBuilder os;
zstein4b2e0822017-02-17 19:48:38 -08001463 if (use_sctpmap) {
1464 // draft-ietf-mmusic-sctp-sdp-04
1465 // a=sctpmap:sctpmap-number protocol [streams]
1466 InitAttrLine(kAttributeSctpmap, &os);
1467 os << kSdpDelimiterColon << sctp_port << kSdpDelimiterSpace
1468 << kDefaultSctpmapProtocol << kSdpDelimiterSpace
1469 << cricket::kMaxSctpStreams;
1470 } else {
1471 // draft-ietf-mmusic-sctp-sdp-23
1472 // a=sctp-port:<port>
1473 InitAttrLine(kAttributeSctpPort, &os);
1474 os << kSdpDelimiterColon << sctp_port;
1475 // TODO(zstein): emit max-message-size here
1476 }
wu@webrtc.org78187522013-10-07 23:32:02 +00001477 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001478}
1479
deadbeef9d3584c2016-02-16 17:54:10 -08001480void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001481 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -08001482 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -08001483 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001484 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001485 // RFC 5285
1486 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1487 // The definitions MUST be either all session level or all media level. This
1488 // implementation uses all media level.
1489 for (size_t i = 0; i < media_desc->rtp_header_extensions().size(); ++i) {
jbauch5869f502017-06-29 12:31:36 -07001490 const RtpExtension& extension = media_desc->rtp_header_extensions()[i];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001491 InitAttrLine(kAttributeExtmap, &os);
jbauch5869f502017-06-29 12:31:36 -07001492 os << kSdpDelimiterColon << extension.id;
1493 if (extension.encrypt) {
1494 os << kSdpDelimiterSpace << RtpExtension::kEncryptHeaderExtensionsUri;
1495 }
1496 os << kSdpDelimiterSpace << extension.uri;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001497 AddLine(os.str(), message);
1498 }
1499
1500 // RFC 3264
1501 // a=sendrecv || a=sendonly || a=sendrecv || a=inactive
deadbeefc80741f2015-10-22 13:14:45 -07001502 switch (media_desc->direction()) {
Steve Anton4e70a722017-11-28 14:57:10 -08001503 case RtpTransceiverDirection::kInactive:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001504 InitAttrLine(kAttributeInactive, &os);
1505 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001506 case RtpTransceiverDirection::kSendOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001507 InitAttrLine(kAttributeSendOnly, &os);
1508 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001509 case RtpTransceiverDirection::kRecvOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001510 InitAttrLine(kAttributeRecvOnly, &os);
1511 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001512 case RtpTransceiverDirection::kSendRecv:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001513 default:
1514 InitAttrLine(kAttributeSendRecv, &os);
1515 break;
1516 }
1517 AddLine(os.str(), message);
1518
Seth Hampson5b4f0752018-04-02 16:31:36 -07001519 // Specified in https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
1520 // a=msid:<msid-id> <msid-appdata>
1521 // The msid-id is a 1*64 token char representing the media stream id, and the
1522 // msid-appdata is a 1*64 token char representing the track id. There is a
1523 // line for every media stream, with a special msid-id value of "-"
1524 // representing no streams. The value of "msid-appdata" MUST be identical for
1525 // all lines.
Steve Antone831b8c2018-02-01 12:22:16 -08001526 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
1527 const StreamParamsVec& streams = media_desc->streams();
1528 if (streams.size() == 1u) {
1529 const StreamParams& track = streams[0];
Seth Hampson5b4f0752018-04-02 16:31:36 -07001530 std::vector<std::string> stream_ids = track.stream_ids();
1531 if (stream_ids.empty()) {
1532 stream_ids.push_back(kNoStreamMsid);
1533 }
1534 for (const std::string& stream_id : stream_ids) {
1535 InitAttrLine(kAttributeMsid, &os);
1536 os << kSdpDelimiterColon << stream_id << kSdpDelimiterSpace << track.id;
1537 AddLine(os.str(), message);
1538 }
Steve Antone831b8c2018-02-01 12:22:16 -08001539 } else if (streams.size() > 1u) {
1540 RTC_LOG(LS_WARNING)
1541 << "Trying to serialize Unified Plan SDP with more than "
Jonas Olsson45cc8902018-02-13 10:37:07 +01001542 "one track in a media section. Omitting 'a=msid'.";
deadbeef9d3584c2016-02-16 17:54:10 -08001543 }
1544 }
1545
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001546 // RFC 5761
1547 // a=rtcp-mux
1548 if (media_desc->rtcp_mux()) {
1549 InitAttrLine(kAttributeRtcpMux, &os);
1550 AddLine(os.str(), message);
1551 }
1552
deadbeef13871492015-12-09 12:37:51 -08001553 // RFC 5506
1554 // a=rtcp-rsize
1555 if (media_desc->rtcp_reduced_size()) {
1556 InitAttrLine(kAttributeRtcpReducedSize, &os);
1557 AddLine(os.str(), message);
1558 }
1559
deadbeefd45aea82017-09-16 01:24:29 -07001560 if (media_desc->conference_mode()) {
1561 InitAttrLine(kAttributeXGoogleFlag, &os);
1562 os << kSdpDelimiterColon << kValueConference;
1563 AddLine(os.str(), message);
1564 }
1565
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001566 // RFC 4568
1567 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001568 for (const CryptoParams& crypto_params : media_desc->cryptos()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001569 InitAttrLine(kAttributeCrypto, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001570 os << kSdpDelimiterColon << crypto_params.tag << " "
1571 << crypto_params.cipher_suite << " " << crypto_params.key_params;
1572 if (!crypto_params.session_params.empty()) {
1573 os << " " << crypto_params.session_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001574 }
1575 AddLine(os.str(), message);
1576 }
1577
1578 // RFC 4566
1579 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1580 // [/<encodingparameters>]
1581 BuildRtpMap(media_desc, media_type, message);
1582
Steve Anton4daf66e2018-09-07 14:55:53 -07001583 for (const StreamParams& track : media_desc->streams()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001584 // Build the ssrc-group lines.
Steve Anton4daf66e2018-09-07 14:55:53 -07001585 for (const SsrcGroup& ssrc_group : track.ssrc_groups) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001586 // RFC 5576
1587 // a=ssrc-group:<semantics> <ssrc-id> ...
Steve Anton4daf66e2018-09-07 14:55:53 -07001588 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001589 continue;
1590 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001591 InitAttrLine(kAttributeSsrcGroup, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001592 os << kSdpDelimiterColon << ssrc_group.semantics;
1593 for (uint32_t ssrc : ssrc_group.ssrcs) {
1594 os << kSdpDelimiterSpace << rtc::ToString(ssrc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001595 }
1596 AddLine(os.str(), message);
1597 }
1598 // Build the ssrc lines for each ssrc.
Steve Anton4daf66e2018-09-07 14:55:53 -07001599 for (uint32_t ssrc : track.ssrcs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001600 // RFC 5576
1601 // a=ssrc:<ssrc-id> cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07001602 AddSsrcLine(ssrc, kSsrcAttributeCname, track.cname, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001603
Steve Antone831b8c2018-02-01 12:22:16 -08001604 if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
1605 // draft-alvestrand-mmusic-msid-00
1606 // a=ssrc:<ssrc-id> msid:identifier [appdata]
1607 // The appdata consists of the "id" attribute of a MediaStreamTrack,
1608 // which corresponds to the "id" attribute of StreamParams.
Seth Hampson5b4f0752018-04-02 16:31:36 -07001609 // Since a=ssrc msid signaling is used in Plan B SDP semantics, and
1610 // multiple stream ids are not supported for Plan B, we are only adding
1611 // a line for the first media stream id here.
Steve Anton4daf66e2018-09-07 14:55:53 -07001612 const std::string& stream_id = track.first_stream_id();
Steve Antone831b8c2018-02-01 12:22:16 -08001613 InitAttrLine(kAttributeSsrc, &os);
1614 os << kSdpDelimiterColon << ssrc << kSdpDelimiterSpace
1615 << kSsrcAttributeMsid << kSdpDelimiterColon << stream_id
Steve Anton4daf66e2018-09-07 14:55:53 -07001616 << kSdpDelimiterSpace << track.id;
Steve Antone831b8c2018-02-01 12:22:16 -08001617 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001618
Steve Antone831b8c2018-02-01 12:22:16 -08001619 // TODO(ronghuawu): Remove below code which is for backward
1620 // compatibility.
1621 // draft-alvestrand-rtcweb-mid-01
1622 // a=ssrc:<ssrc-id> mslabel:<value>
1623 // The label isn't yet defined.
1624 // a=ssrc:<ssrc-id> label:<value>
Seth Hampson5b4f0752018-04-02 16:31:36 -07001625 AddSsrcLine(ssrc, kSsrcAttributeMslabel, stream_id, message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001626 AddSsrcLine(ssrc, kSSrcAttributeLabel, track.id, message);
Steve Antone831b8c2018-02-01 12:22:16 -08001627 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001628 }
1629 }
1630}
1631
Jonas Olssonec9e4922018-09-05 09:53:49 +02001632void WriteFmtpHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001633 // fmtp header: a=fmtp:|payload_type| <parameters>
1634 // Add a=fmtp
1635 InitAttrLine(kAttributeFmtp, os);
1636 // Add :|payload_type|
1637 *os << kSdpDelimiterColon << payload_type;
1638}
1639
Jonas Olssonec9e4922018-09-05 09:53:49 +02001640void WriteRtcpFbHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001641 // rtcp-fb header: a=rtcp-fb:|payload_type|
1642 // <parameters>/<ccm <ccm_parameters>>
1643 // Add a=rtcp-fb
1644 InitAttrLine(kAttributeRtcpFb, os);
1645 // Add :
1646 *os << kSdpDelimiterColon;
1647 if (payload_type == kWildcardPayloadType) {
1648 *os << "*";
1649 } else {
1650 *os << payload_type;
1651 }
1652}
1653
1654void WriteFmtpParameter(const std::string& parameter_name,
1655 const std::string& parameter_value,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001656 rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001657 // fmtp parameters: |parameter_name|=|parameter_value|
1658 *os << parameter_name << kSdpDelimiterEqual << parameter_value;
1659}
1660
1661void WriteFmtpParameters(const cricket::CodecParameterMap& parameters,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001662 rtc::StringBuilder* os) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001663 bool first = true;
1664 for (const auto& entry : parameters) {
1665 const std::string& key = entry.first;
1666 const std::string& value = entry.second;
hta62a216e2016-04-15 11:02:14 -07001667 // Parameters are a semicolon-separated list, no spaces.
1668 // The list is separated from the header by a space.
Steve Anton4daf66e2018-09-07 14:55:53 -07001669 if (first) {
hta62a216e2016-04-15 11:02:14 -07001670 *os << kSdpDelimiterSpace;
Steve Anton4daf66e2018-09-07 14:55:53 -07001671 first = false;
hta62a216e2016-04-15 11:02:14 -07001672 } else {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001673 *os << kSdpDelimiterSemicolon;
1674 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001675 WriteFmtpParameter(key, value, os);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001676 }
1677}
1678
1679bool IsFmtpParam(const std::string& name) {
ossuaa4b0772017-01-30 07:41:18 -08001680 // RFC 4855, section 3 specifies the mapping of media format parameters to SDP
1681 // parameters. Only ptime, maxptime, channels and rate are placed outside of
1682 // the fmtp line. In WebRTC, channels and rate are already handled separately
1683 // and thus not included in the CodecParameterMap.
1684 return name != kCodecParamPTime && name != kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001685}
1686
1687// Retreives fmtp parameters from |params|, which may contain other parameters
1688// as well, and puts them in |fmtp_parameters|.
1689void GetFmtpParams(const cricket::CodecParameterMap& params,
1690 cricket::CodecParameterMap* fmtp_parameters) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001691 for (const auto& entry : params) {
1692 const std::string& key = entry.first;
1693 const std::string& value = entry.second;
1694 if (IsFmtpParam(key)) {
1695 (*fmtp_parameters)[key] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001696 }
1697 }
1698}
1699
1700template <class T>
1701void AddFmtpLine(const T& codec, std::string* message) {
1702 cricket::CodecParameterMap fmtp_parameters;
1703 GetFmtpParams(codec.params, &fmtp_parameters);
1704 if (fmtp_parameters.empty()) {
1705 // No need to add an fmtp if it will have no (optional) parameters.
1706 return;
1707 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001708 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001709 WriteFmtpHeader(codec.id, &os);
1710 WriteFmtpParameters(fmtp_parameters, &os);
1711 AddLine(os.str(), message);
1712 return;
1713}
1714
1715template <class T>
1716void AddRtcpFbLines(const T& codec, std::string* message) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001717 for (const cricket::FeedbackParam& param : codec.feedback_params.params()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001718 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001719 WriteRtcpFbHeader(codec.id, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001720 os << " " << param.id();
1721 if (!param.param().empty()) {
1722 os << " " << param.param();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001723 }
1724 AddLine(os.str(), message);
1725 }
1726}
1727
Yves Gerey665174f2018-06-19 15:03:05 +02001728bool AddSctpDataCodec(DataContentDescription* media_desc, int sctp_port) {
solenberg9fa49752016-10-08 13:02:44 -07001729 for (const auto& codec : media_desc->codecs()) {
1730 if (cricket::CodecNamesEq(codec.name, cricket::kGoogleSctpDataCodecName)) {
Yves Gerey665174f2018-06-19 15:03:05 +02001731 return ParseFailed("", "Can't have multiple sctp port attributes.", NULL);
solenberg9fa49752016-10-08 13:02:44 -07001732 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001733 }
1734 // Add the SCTP Port number as a pseudo-codec "port" parameter
solenberg9fa49752016-10-08 13:02:44 -07001735 cricket::DataCodec codec_port(cricket::kGoogleSctpDataCodecPlType,
deadbeef67cf2c12016-04-13 10:07:16 -07001736 cricket::kGoogleSctpDataCodecName);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001737 codec_port.SetParam(cricket::kCodecParamPort, sctp_port);
Mirko Bonadei675513b2017-11-09 11:09:25 +01001738 RTC_LOG(INFO) << "AddSctpDataCodec: Got SCTP Port Number " << sctp_port;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001739 media_desc->AddCodec(codec_port);
1740 return true;
1741}
1742
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001743bool GetMinValue(const std::vector<int>& values, int* value) {
1744 if (values.empty()) {
1745 return false;
1746 }
1747 std::vector<int>::const_iterator found =
1748 std::min_element(values.begin(), values.end());
1749 *value = *found;
1750 return true;
1751}
1752
1753bool GetParameter(const std::string& name,
Yves Gerey665174f2018-06-19 15:03:05 +02001754 const cricket::CodecParameterMap& params,
1755 int* value) {
1756 std::map<std::string, std::string>::const_iterator found = params.find(name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001757 if (found == params.end()) {
1758 return false;
1759 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00001760 if (!rtc::FromString(found->second, value)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001761 return false;
1762 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001763 return true;
1764}
1765
1766void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001767 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001768 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001769 RTC_DCHECK(message != NULL);
1770 RTC_DCHECK(media_desc != NULL);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001771 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001772 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001773 for (const cricket::VideoCodec& codec : media_desc->as_video()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001774 // RFC 4566
1775 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1776 // [/<encodingparameters>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001777 if (codec.id != kWildcardPayloadType) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001778 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001779 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
deadbeefe814a0d2017-02-25 18:15:09 -08001780 << cricket::kVideoCodecClockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001781 AddLine(os.str(), message);
1782 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001783 AddRtcpFbLines(codec, message);
1784 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001785 }
1786 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001787 std::vector<int> ptimes;
1788 std::vector<int> maxptimes;
1789 int max_minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001790 for (const cricket::AudioCodec& codec : media_desc->as_audio()->codecs()) {
1791 RTC_DCHECK(!codec.name.empty());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001792 // RFC 4566
1793 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1794 // [/<encodingparameters>]
1795 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001796 os << kSdpDelimiterColon << codec.id << " ";
1797 os << codec.name << "/" << codec.clockrate;
1798 if (codec.channels != 1) {
1799 os << "/" << codec.channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001800 }
1801 AddLine(os.str(), message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001802 AddRtcpFbLines(codec, message);
1803 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001804 int minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001805 if (GetParameter(kCodecParamMinPTime, codec.params, &minptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001806 max_minptime = std::max(minptime, max_minptime);
1807 }
1808 int ptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001809 if (GetParameter(kCodecParamPTime, codec.params, &ptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001810 ptimes.push_back(ptime);
1811 }
1812 int maxptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001813 if (GetParameter(kCodecParamMaxPTime, codec.params, &maxptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001814 maxptimes.push_back(maxptime);
1815 }
1816 }
1817 // Populate the maxptime attribute with the smallest maxptime of all codecs
1818 // under the same m-line.
1819 int min_maxptime = INT_MAX;
1820 if (GetMinValue(maxptimes, &min_maxptime)) {
1821 AddAttributeLine(kCodecParamMaxPTime, min_maxptime, message);
1822 }
nisseede5da42017-01-12 05:15:36 -08001823 RTC_DCHECK(min_maxptime > max_minptime);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001824 // Populate the ptime attribute with the smallest ptime or the largest
1825 // minptime, whichever is the largest, for all codecs under the same m-line.
1826 int ptime = INT_MAX;
1827 if (GetMinValue(ptimes, &ptime)) {
1828 ptime = std::min(ptime, min_maxptime);
1829 ptime = std::max(ptime, max_minptime);
1830 AddAttributeLine(kCodecParamPTime, ptime, message);
1831 }
1832 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001833 for (const cricket::DataCodec& codec : media_desc->as_data()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001834 // RFC 4566
1835 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1836 // [/<encodingparameters>]
1837 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001838 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
1839 << codec.clockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001840 AddLine(os.str(), message);
1841 }
1842 }
1843}
1844
1845void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -08001846 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001847 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001848 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001849
Steve Anton4daf66e2018-09-07 14:55:53 -07001850 for (const Candidate& candidate : candidates) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001851 // RFC 5245
1852 // a=candidate:<foundation> <component-id> <transport> <priority>
1853 // <connection-address> <port> typ <candidate-types>
1854 // [raddr <connection-address>] [rport <port>]
1855 // *(SP extension-att-name SP extension-att-value)
1856 std::string type;
1857 // Map the cricket candidate type to "host" / "srflx" / "prflx" / "relay"
Steve Anton4daf66e2018-09-07 14:55:53 -07001858 if (candidate.type() == cricket::LOCAL_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001859 type = kCandidateHost;
Steve Anton4daf66e2018-09-07 14:55:53 -07001860 } else if (candidate.type() == cricket::STUN_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001861 type = kCandidateSrflx;
Steve Anton4daf66e2018-09-07 14:55:53 -07001862 } else if (candidate.type() == cricket::RELAY_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001863 type = kCandidateRelay;
Steve Anton4daf66e2018-09-07 14:55:53 -07001864 } else if (candidate.type() == cricket::PRFLX_PORT_TYPE) {
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001865 type = kCandidatePrflx;
1866 // Peer reflexive candidate may be signaled for being removed.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001867 } else {
nissec80e7412017-01-11 05:56:46 -08001868 RTC_NOTREACHED();
Peter Thatcher019087f2015-04-28 09:06:26 -07001869 // Never write out candidates if we don't know the type.
1870 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001871 }
1872
1873 InitAttrLine(kAttributeCandidate, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001874 os << kSdpDelimiterColon << candidate.foundation() << " "
1875 << candidate.component() << " " << candidate.protocol() << " "
1876 << candidate.priority() << " "
1877 << (candidate.address().ipaddr().IsNil()
1878 ? candidate.address().hostname()
1879 : candidate.address().ipaddr().ToString())
1880 << " " << candidate.address().PortAsString() << " "
1881 << kAttributeCandidateTyp << " " << type << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001882
1883 // Related address
Steve Anton4daf66e2018-09-07 14:55:53 -07001884 if (!candidate.related_address().IsNil()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001885 os << kAttributeCandidateRaddr << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001886 << candidate.related_address().ipaddr().ToString() << " "
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001887 << kAttributeCandidateRport << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001888 << candidate.related_address().PortAsString() << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001889 }
1890
Steve Anton4daf66e2018-09-07 14:55:53 -07001891 if (candidate.protocol() == cricket::TCP_PROTOCOL_NAME) {
1892 os << kTcpCandidateType << " " << candidate.tcptype() << " ";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001893 }
1894
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001895 // Extensions
Steve Anton4daf66e2018-09-07 14:55:53 -07001896 os << kAttributeCandidateGeneration << " " << candidate.generation();
1897 if (include_ufrag && !candidate.username().empty()) {
1898 os << " " << kAttributeCandidateUfrag << " " << candidate.username();
honghaiza54a0802015-12-16 18:37:23 -08001899 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001900 if (candidate.network_id() > 0) {
1901 os << " " << kAttributeCandidateNetworkId << " "
1902 << candidate.network_id();
honghaiza0c44ea2016-03-23 16:07:48 -07001903 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001904 if (candidate.network_cost() > 0) {
1905 os << " " << kAttributeCandidateNetworkCost << " "
1906 << candidate.network_cost();
honghaize1a0c942016-02-16 14:54:56 -08001907 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001908
1909 AddLine(os.str(), message);
1910 }
1911}
1912
1913void BuildIceOptions(const std::vector<std::string>& transport_options,
1914 std::string* message) {
1915 if (!transport_options.empty()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001916 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001917 InitAttrLine(kAttributeIceOption, &os);
1918 os << kSdpDelimiterColon << transport_options[0];
1919 for (size_t i = 1; i < transport_options.size(); ++i) {
1920 os << kSdpDelimiterSpace << transport_options[i];
1921 }
1922 AddLine(os.str(), message);
1923 }
1924}
1925
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001926bool IsRtp(const std::string& protocol) {
1927 return protocol.empty() ||
Yves Gerey665174f2018-06-19 15:03:05 +02001928 (protocol.find(cricket::kMediaProtocolRtpPrefix) != std::string::npos);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001929}
1930
1931bool IsDtlsSctp(const std::string& protocol) {
1932 // This intentionally excludes "SCTP" and "SCTP/DTLS".
lally@webrtc.orga7470932015-02-24 20:19:21 +00001933 return protocol.find(cricket::kMediaProtocolDtlsSctp) != std::string::npos;
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001934}
1935
zhihuang38989e52017-03-21 11:04:53 -07001936bool ParseConnectionData(const std::string& line,
1937 rtc::SocketAddress* addr,
1938 SdpParseError* error) {
1939 // Parse the line from left to right.
1940 std::string token;
1941 std::string rightpart;
1942 // RFC 4566
1943 // c=<nettype> <addrtype> <connection-address>
1944 // Skip the "c="
Jonas Olssonec9e4922018-09-05 09:53:49 +02001945 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, &token, &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07001946 return ParseFailed(line, "Failed to parse the network type.", error);
1947 }
1948
1949 // Extract and verify the <nettype>
Jonas Olssonec9e4922018-09-05 09:53:49 +02001950 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
1951 &rightpart) ||
zhihuang38989e52017-03-21 11:04:53 -07001952 token != kConnectionNettype) {
1953 return ParseFailed(line,
1954 "Failed to parse the connection data. The network type "
1955 "is not currently supported.",
1956 error);
1957 }
1958
1959 // Extract the "<addrtype>" and "<connection-address>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001960 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
1961 &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07001962 return ParseFailed(line, "Failed to parse the address type.", error);
1963 }
1964
1965 // The rightpart part should be the IP address without the slash which is used
1966 // for multicast.
1967 if (rightpart.find('/') != std::string::npos) {
1968 return ParseFailed(line,
1969 "Failed to parse the connection data. Multicast is not "
1970 "currently supported.",
1971 error);
1972 }
1973 addr->SetIP(rightpart);
1974
1975 // Verify that the addrtype matches the type of the parsed address.
1976 if ((addr->family() == AF_INET && token != "IP4") ||
1977 (addr->family() == AF_INET6 && token != "IP6")) {
1978 addr->Clear();
1979 return ParseFailed(
1980 line,
1981 "Failed to parse the connection data. The address type is mismatching.",
1982 error);
1983 }
1984 return true;
1985}
1986
1987bool ParseSessionDescription(const std::string& message,
1988 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001989 std::string* session_id,
1990 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001991 TransportDescription* session_td,
1992 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -07001993 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001994 cricket::SessionDescription* desc,
1995 SdpParseError* error) {
1996 std::string line;
1997
deadbeefc80741f2015-10-22 13:14:45 -07001998 desc->set_msid_supported(false);
1999
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002000 // RFC 4566
2001 // v= (protocol version)
2002 if (!GetLineWithType(message, pos, &line, kLineTypeVersion)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002003 return ParseFailedExpectLine(message, *pos, kLineTypeVersion, std::string(),
2004 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002005 }
2006 // RFC 4566
2007 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
2008 // <unicast-address>
2009 if (!GetLineWithType(message, pos, &line, kLineTypeOrigin)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002010 return ParseFailedExpectLine(message, *pos, kLineTypeOrigin, std::string(),
2011 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002012 }
2013 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002014 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002015 const size_t expected_fields = 6;
2016 if (fields.size() != expected_fields) {
2017 return ParseFailedExpectFieldNum(line, expected_fields, error);
2018 }
2019 *session_id = fields[1];
2020 *session_version = fields[2];
2021
2022 // RFC 4566
2023 // s= (session name)
2024 if (!GetLineWithType(message, pos, &line, kLineTypeSessionName)) {
2025 return ParseFailedExpectLine(message, *pos, kLineTypeSessionName,
2026 std::string(), error);
2027 }
2028
Danil Chapovalov66cadcc2018-06-19 16:47:43 +02002029 // absl::optional lines
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002030 // Those are the optional lines, so shouldn't return false if not present.
2031 // RFC 4566
2032 // i=* (session information)
2033 GetLineWithType(message, pos, &line, kLineTypeSessionInfo);
2034
2035 // RFC 4566
2036 // u=* (URI of description)
2037 GetLineWithType(message, pos, &line, kLineTypeSessionUri);
2038
2039 // RFC 4566
2040 // e=* (email address)
2041 GetLineWithType(message, pos, &line, kLineTypeSessionEmail);
2042
2043 // RFC 4566
2044 // p=* (phone number)
2045 GetLineWithType(message, pos, &line, kLineTypeSessionPhone);
2046
2047 // RFC 4566
2048 // c=* (connection information -- not required if included in
2049 // all media)
zhihuang38989e52017-03-21 11:04:53 -07002050 if (GetLineWithType(message, pos, &line, kLineTypeConnection)) {
2051 if (!ParseConnectionData(line, connection_addr, error)) {
2052 return false;
2053 }
2054 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002055
2056 // RFC 4566
2057 // b=* (zero or more bandwidth information lines)
2058 while (GetLineWithType(message, pos, &line, kLineTypeSessionBandwidth)) {
2059 // By pass zero or more b lines.
2060 }
2061
2062 // RFC 4566
2063 // One or more time descriptions ("t=" and "r=" lines; see below)
2064 // t= (time the session is active)
2065 // r=* (zero or more repeat times)
2066 // Ensure there's at least one time description
2067 if (!GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2068 return ParseFailedExpectLine(message, *pos, kLineTypeTiming, std::string(),
2069 error);
2070 }
2071
2072 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2073 // By pass zero or more r lines.
2074 }
2075
2076 // Go through the rest of the time descriptions
2077 while (GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2078 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2079 // By pass zero or more r lines.
2080 }
2081 }
2082
2083 // RFC 4566
2084 // z=* (time zone adjustments)
2085 GetLineWithType(message, pos, &line, kLineTypeTimeZone);
2086
2087 // RFC 4566
2088 // k=* (encryption key)
2089 GetLineWithType(message, pos, &line, kLineTypeEncryptionKey);
2090
2091 // RFC 4566
2092 // a=* (zero or more session attribute lines)
2093 while (GetLineWithType(message, pos, &line, kLineTypeAttributes)) {
2094 if (HasAttribute(line, kAttributeGroup)) {
2095 if (!ParseGroupAttribute(line, desc, error)) {
2096 return false;
2097 }
2098 } else if (HasAttribute(line, kAttributeIceUfrag)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002099 if (!GetValue(line, kAttributeIceUfrag, &(session_td->ice_ufrag),
2100 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002101 return false;
2102 }
2103 } else if (HasAttribute(line, kAttributeIcePwd)) {
2104 if (!GetValue(line, kAttributeIcePwd, &(session_td->ice_pwd), error)) {
2105 return false;
2106 }
2107 } else if (HasAttribute(line, kAttributeIceLite)) {
2108 session_td->ice_mode = cricket::ICEMODE_LITE;
2109 } else if (HasAttribute(line, kAttributeIceOption)) {
2110 if (!ParseIceOptions(line, &(session_td->transport_options), error)) {
2111 return false;
2112 }
2113 } else if (HasAttribute(line, kAttributeFingerprint)) {
2114 if (session_td->identity_fingerprint.get()) {
2115 return ParseFailed(
2116 line,
2117 "Can't have multiple fingerprint attributes at the same level.",
2118 error);
2119 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00002120 rtc::SSLFingerprint* fingerprint = NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002121 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2122 return false;
2123 }
2124 session_td->identity_fingerprint.reset(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002125 } else if (HasAttribute(line, kAttributeSetup)) {
2126 if (!ParseDtlsSetup(line, &(session_td->connection_role), error)) {
2127 return false;
2128 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002129 } else if (HasAttribute(line, kAttributeMsidSemantics)) {
2130 std::string semantics;
2131 if (!GetValue(line, kAttributeMsidSemantics, &semantics, error)) {
2132 return false;
2133 }
deadbeefc80741f2015-10-22 13:14:45 -07002134 desc->set_msid_supported(
2135 CaseInsensitiveFind(semantics, kMediaStreamSemantic));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002136 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002137 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002138 if (!ParseExtmap(line, &extmap, error)) {
2139 return false;
2140 }
2141 session_extmaps->push_back(extmap);
2142 }
2143 }
2144
2145 return true;
2146}
2147
2148bool ParseGroupAttribute(const std::string& line,
2149 cricket::SessionDescription* desc,
2150 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002151 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002152
2153 // RFC 5888 and draft-holmberg-mmusic-sdp-bundle-negotiation-00
2154 // a=group:BUNDLE video voice
2155 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002156 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002157 std::string semantics;
2158 if (!GetValue(fields[0], kAttributeGroup, &semantics, error)) {
2159 return false;
2160 }
2161 cricket::ContentGroup group(semantics);
2162 for (size_t i = 1; i < fields.size(); ++i) {
2163 group.AddContentName(fields[i]);
2164 }
2165 desc->AddGroup(group);
2166 return true;
2167}
2168
2169static bool ParseFingerprintAttribute(const std::string& line,
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00002170 rtc::SSLFingerprint** fingerprint,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002171 SdpParseError* error) {
2172 if (!IsLineType(line, kLineTypeAttributes) ||
2173 !HasAttribute(line, kAttributeFingerprint)) {
2174 return ParseFailedExpectLine(line, 0, kLineTypeAttributes,
2175 kAttributeFingerprint, error);
2176 }
2177
2178 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002179 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002180 const size_t expected_fields = 2;
2181 if (fields.size() != expected_fields) {
2182 return ParseFailedExpectFieldNum(line, expected_fields, error);
2183 }
2184
2185 // The first field here is "fingerprint:<hash>.
2186 std::string algorithm;
2187 if (!GetValue(fields[0], kAttributeFingerprint, &algorithm, error)) {
2188 return false;
2189 }
2190
2191 // Downcase the algorithm. Note that we don't need to downcase the
2192 // fingerprint because hex_decode can handle upper-case.
2193 std::transform(algorithm.begin(), algorithm.end(), algorithm.begin(),
2194 ::tolower);
2195
2196 // The second field is the digest value. De-hexify it.
Yves Gerey665174f2018-06-19 15:03:05 +02002197 *fingerprint = rtc::SSLFingerprint::CreateFromRfc4572(algorithm, fields[1]);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002198 if (!*fingerprint) {
Yves Gerey665174f2018-06-19 15:03:05 +02002199 return ParseFailed(line, "Failed to create fingerprint from the digest.",
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002200 error);
2201 }
2202
2203 return true;
2204}
2205
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002206static bool ParseDtlsSetup(const std::string& line,
2207 cricket::ConnectionRole* role,
2208 SdpParseError* error) {
2209 // setup-attr = "a=setup:" role
2210 // role = "active" / "passive" / "actpass" / "holdconn"
2211 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002212 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002213 const size_t expected_fields = 2;
2214 if (fields.size() != expected_fields) {
2215 return ParseFailedExpectFieldNum(line, expected_fields, error);
2216 }
2217 std::string role_str = fields[1];
2218 if (!cricket::StringToConnectionRole(role_str, role)) {
2219 return ParseFailed(line, "Invalid attribute value.", error);
2220 }
2221 return true;
2222}
2223
deadbeef9d3584c2016-02-16 17:54:10 -08002224static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -07002225 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -08002226 std::string* track_id,
2227 SdpParseError* error) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002228 // https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
deadbeef9d3584c2016-02-16 17:54:10 -08002229 // a=msid:<stream id> <track id>
2230 // msid-value = msid-id [ SP msid-appdata ]
2231 // msid-id = 1*64token-char ; see RFC 4566
2232 // msid-appdata = 1*64token-char ; see RFC 4566
2233 std::string field1;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002234 std::string new_stream_id;
2235 std::string new_track_id;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002236 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
2237 kSdpDelimiterSpaceChar, &field1, &new_track_id)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002238 const size_t expected_fields = 2;
2239 return ParseFailedExpectFieldNum(line, expected_fields, error);
2240 }
2241
Seth Hampson5b4f0752018-04-02 16:31:36 -07002242 if (new_track_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002243 return ParseFailed(line, "Missing track ID in msid attribute.", error);
2244 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002245 // All track ids should be the same within an m section in a Unified Plan SDP.
2246 if (!track_id->empty() && new_track_id.compare(*track_id) != 0) {
2247 return ParseFailed(
2248 line, "Two different track IDs in msid attribute in one m= section",
2249 error);
2250 }
2251 *track_id = new_track_id;
deadbeefa4549d62017-02-10 17:26:22 -08002252
deadbeef9d3584c2016-02-16 17:54:10 -08002253 // msid:<msid-id>
Seth Hampson5b4f0752018-04-02 16:31:36 -07002254 if (!GetValue(field1, kAttributeMsid, &new_stream_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002255 return false;
2256 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002257 if (new_stream_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002258 return ParseFailed(line, "Missing stream ID in msid attribute.", error);
2259 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002260 // The special value "-" indicates "no MediaStream".
2261 if (new_stream_id.compare(kNoStreamMsid) != 0) {
2262 stream_ids->push_back(new_stream_id);
2263 }
deadbeef9d3584c2016-02-16 17:54:10 -08002264 return true;
2265}
2266
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002267// RFC 3551
2268// PT encoding media type clock rate channels
2269// name (Hz)
2270// 0 PCMU A 8,000 1
2271// 1 reserved A
2272// 2 reserved A
2273// 3 GSM A 8,000 1
2274// 4 G723 A 8,000 1
2275// 5 DVI4 A 8,000 1
2276// 6 DVI4 A 16,000 1
2277// 7 LPC A 8,000 1
2278// 8 PCMA A 8,000 1
2279// 9 G722 A 8,000 1
2280// 10 L16 A 44,100 2
2281// 11 L16 A 44,100 1
2282// 12 QCELP A 8,000 1
2283// 13 CN A 8,000 1
2284// 14 MPA A 90,000 (see text)
2285// 15 G728 A 8,000 1
2286// 16 DVI4 A 11,025 1
2287// 17 DVI4 A 22,050 1
2288// 18 G729 A 8,000 1
2289struct StaticPayloadAudioCodec {
2290 const char* name;
2291 int clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002292 size_t channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002293};
2294static const StaticPayloadAudioCodec kStaticPayloadAudioCodecs[] = {
Yves Gerey665174f2018-06-19 15:03:05 +02002295 {"PCMU", 8000, 1}, {"reserved", 0, 0}, {"reserved", 0, 0},
2296 {"GSM", 8000, 1}, {"G723", 8000, 1}, {"DVI4", 8000, 1},
2297 {"DVI4", 16000, 1}, {"LPC", 8000, 1}, {"PCMA", 8000, 1},
2298 {"G722", 8000, 1}, {"L16", 44100, 2}, {"L16", 44100, 1},
2299 {"QCELP", 8000, 1}, {"CN", 8000, 1}, {"MPA", 90000, 1},
2300 {"G728", 8000, 1}, {"DVI4", 11025, 1}, {"DVI4", 22050, 1},
2301 {"G729", 8000, 1},
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002302};
2303
Yves Gerey665174f2018-06-19 15:03:05 +02002304void MaybeCreateStaticPayloadAudioCodecs(const std::vector<int>& fmts,
2305 AudioContentDescription* media_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002306 if (!media_desc) {
2307 return;
2308 }
deadbeef67cf2c12016-04-13 10:07:16 -07002309 RTC_DCHECK(media_desc->codecs().empty());
solenberg9fa49752016-10-08 13:02:44 -07002310 for (int payload_type : fmts) {
Yves Gerey665174f2018-06-19 15:03:05 +02002311 if (!media_desc->HasCodec(payload_type) && payload_type >= 0 &&
kjellander3e33bfe2016-06-20 07:04:09 -07002312 static_cast<uint32_t>(payload_type) <
2313 arraysize(kStaticPayloadAudioCodecs)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002314 std::string encoding_name = kStaticPayloadAudioCodecs[payload_type].name;
2315 int clock_rate = kStaticPayloadAudioCodecs[payload_type].clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002316 size_t channels = kStaticPayloadAudioCodecs[payload_type].channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002317 media_desc->AddCodec(cricket::AudioCodec(payload_type, encoding_name,
deadbeef67cf2c12016-04-13 10:07:16 -07002318 clock_rate, 0, channels));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002319 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002320 }
2321}
2322
2323template <class C>
2324static C* ParseContentDescription(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002325 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002326 int mline_index,
2327 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002328 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002329 size_t* pos,
2330 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002331 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002332 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002333 TransportDescription* transport,
2334 std::vector<JsepIceCandidate*>* candidates,
2335 webrtc::SdpParseError* error) {
2336 C* media_desc = new C();
2337 switch (media_type) {
2338 case cricket::MEDIA_TYPE_AUDIO:
2339 *content_name = cricket::CN_AUDIO;
2340 break;
2341 case cricket::MEDIA_TYPE_VIDEO:
2342 *content_name = cricket::CN_VIDEO;
2343 break;
2344 case cricket::MEDIA_TYPE_DATA:
2345 *content_name = cricket::CN_DATA;
2346 break;
2347 default:
nissec80e7412017-01-11 05:56:46 -08002348 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002349 break;
2350 }
deadbeef67cf2c12016-04-13 10:07:16 -07002351 if (!ParseContent(message, media_type, mline_index, protocol, payload_types,
Steve Antone831b8c2018-02-01 12:22:16 -08002352 pos, content_name, bundle_only, msid_signaling, media_desc,
2353 transport, candidates, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002354 delete media_desc;
zhihuang38989e52017-03-21 11:04:53 -07002355 return nullptr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002356 }
2357 // Sort the codecs according to the m-line fmt list.
deadbeef67cf2c12016-04-13 10:07:16 -07002358 std::unordered_map<int, int> payload_type_preferences;
2359 // "size + 1" so that the lowest preference payload type has a preference of
2360 // 1, which is greater than the default (0) for payload types not in the fmt
2361 // list.
2362 int preference = static_cast<int>(payload_types.size() + 1);
2363 for (int pt : payload_types) {
2364 payload_type_preferences[pt] = preference--;
2365 }
2366 std::vector<typename C::CodecType> codecs = media_desc->codecs();
Yves Gerey665174f2018-06-19 15:03:05 +02002367 std::sort(codecs.begin(), codecs.end(),
2368 [&payload_type_preferences](const typename C::CodecType& a,
2369 const typename C::CodecType& b) {
2370 return payload_type_preferences[a.id] >
2371 payload_type_preferences[b.id];
2372 });
deadbeef67cf2c12016-04-13 10:07:16 -07002373 media_desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002374 return media_desc;
2375}
2376
2377bool ParseMediaDescription(const std::string& message,
2378 const TransportDescription& session_td,
2379 const RtpHeaderExtensions& session_extmaps,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002380 size_t* pos,
zhihuang38989e52017-03-21 11:04:53 -07002381 const rtc::SocketAddress& session_connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002382 cricket::SessionDescription* desc,
2383 std::vector<JsepIceCandidate*>* candidates,
2384 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002385 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002386 std::string line;
2387 int mline_index = -1;
Steve Antone831b8c2018-02-01 12:22:16 -08002388 int msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002389
2390 // Zero or more media descriptions
2391 // RFC 4566
2392 // m=<media> <port> <proto> <fmt>
2393 while (GetLineWithType(message, pos, &line, kLineTypeMedia)) {
2394 ++mline_index;
2395
2396 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002397 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
zstein4b2e0822017-02-17 19:48:38 -08002398
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002399 const size_t expected_min_fields = 4;
2400 if (fields.size() < expected_min_fields) {
2401 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
2402 }
deadbeef25ed4352016-12-12 18:37:36 -08002403 bool port_rejected = false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002404 // RFC 3264
2405 // To reject an offered stream, the port number in the corresponding stream
2406 // in the answer MUST be set to zero.
2407 if (fields[1] == kMediaPortRejected) {
deadbeef25ed4352016-12-12 18:37:36 -08002408 port_rejected = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002409 }
2410
zhihuang38989e52017-03-21 11:04:53 -07002411 int port = 0;
2412 if (!rtc::FromString<int>(fields[1], &port) || !IsValidPort(port)) {
2413 return ParseFailed(line, "The port number is invalid", error);
2414 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002415 std::string protocol = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002416
2417 // <fmt>
deadbeef67cf2c12016-04-13 10:07:16 -07002418 std::vector<int> payload_types;
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002419 if (IsRtp(protocol)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002420 for (size_t j = 3; j < fields.size(); ++j) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002421 // TODO(wu): Remove when below bug is fixed.
2422 // https://bugzilla.mozilla.org/show_bug.cgi?id=996329
pbosbb36fdf2015-07-09 07:48:14 -07002423 if (fields[j].empty() && j == fields.size() - 1) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002424 continue;
2425 }
wu@webrtc.org36eda7c2014-04-15 20:37:30 +00002426
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002427 int pl = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00002428 if (!GetPayloadTypeFromString(line, fields[j], &pl, error)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002429 return false;
2430 }
deadbeef67cf2c12016-04-13 10:07:16 -07002431 payload_types.push_back(pl);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002432 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002433 }
2434
2435 // Make a temporary TransportDescription based on |session_td|.
2436 // Some of this gets overwritten by ParseContent.
deadbeef46eed762016-01-28 13:24:37 -08002437 TransportDescription transport(
2438 session_td.transport_options, session_td.ice_ufrag, session_td.ice_pwd,
2439 session_td.ice_mode, session_td.connection_role,
2440 session_td.identity_fingerprint.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002441
kwibergd1fe2812016-04-27 06:47:29 -07002442 std::unique_ptr<MediaContentDescription> content;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002443 std::string content_name;
deadbeef25ed4352016-12-12 18:37:36 -08002444 bool bundle_only = false;
Steve Antone831b8c2018-02-01 12:22:16 -08002445 int section_msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002446 if (HasAttribute(line, kMediaTypeVideo)) {
2447 content.reset(ParseContentDescription<VideoContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002448 message, cricket::MEDIA_TYPE_VIDEO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002449 payload_types, pos, &content_name, &bundle_only,
2450 &section_msid_signaling, &transport, candidates, error));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002451 } else if (HasAttribute(line, kMediaTypeAudio)) {
2452 content.reset(ParseContentDescription<AudioContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002453 message, cricket::MEDIA_TYPE_AUDIO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002454 payload_types, pos, &content_name, &bundle_only,
2455 &section_msid_signaling, &transport, candidates, error));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002456 } else if (HasAttribute(line, kMediaTypeData)) {
jiayl@webrtc.org0e527722014-09-08 21:43:43 +00002457 DataContentDescription* data_desc =
wu@webrtc.org78187522013-10-07 23:32:02 +00002458 ParseContentDescription<DataContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002459 message, cricket::MEDIA_TYPE_DATA, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002460 payload_types, pos, &content_name, &bundle_only,
2461 &section_msid_signaling, &transport, candidates, error);
jiayl@webrtc.org0e527722014-09-08 21:43:43 +00002462 content.reset(data_desc);
wu@webrtc.org78187522013-10-07 23:32:02 +00002463
zstein4b2e0822017-02-17 19:48:38 -08002464 if (data_desc && IsDtlsSctp(protocol)) {
2465 int p;
2466 if (rtc::FromString(fields[3], &p)) {
2467 if (!AddSctpDataCodec(data_desc, p)) {
2468 return false;
2469 }
2470 } else if (fields[3] == kDefaultSctpmapProtocol) {
2471 data_desc->set_use_sctpmap(false);
2472 }
wu@webrtc.org78187522013-10-07 23:32:02 +00002473 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002474 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002475 RTC_LOG(LS_WARNING) << "Unsupported media type: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002476 continue;
2477 }
2478 if (!content.get()) {
2479 // ParseContentDescription returns NULL if failed.
2480 return false;
2481 }
2482
Steve Antone831b8c2018-02-01 12:22:16 -08002483 msid_signaling |= section_msid_signaling;
2484
deadbeef25ed4352016-12-12 18:37:36 -08002485 bool content_rejected = false;
deadbeef12771a12017-01-03 13:53:47 -08002486 // A port of 0 is not interpreted as a rejected m= section when it's
2487 // used along with a=bundle-only.
deadbeef25ed4352016-12-12 18:37:36 -08002488 if (bundle_only) {
deadbeef25ed4352016-12-12 18:37:36 -08002489 if (!port_rejected) {
deadbeef12771a12017-01-03 13:53:47 -08002490 // Usage of bundle-only with a nonzero port is unspecified. So just
2491 // ignore bundle-only if we see this.
2492 bundle_only = false;
Mirko Bonadei675513b2017-11-09 11:09:25 +01002493 RTC_LOG(LS_WARNING)
deadbeef12771a12017-01-03 13:53:47 -08002494 << "a=bundle-only attribute observed with a nonzero "
Jonas Olsson45cc8902018-02-13 10:37:07 +01002495 "port; this usage is unspecified so the attribute is being "
2496 "ignored.";
deadbeef25ed4352016-12-12 18:37:36 -08002497 }
2498 } else {
2499 // If not using bundle-only, interpret port 0 in the normal way; the m=
2500 // section is being rejected.
2501 content_rejected = port_rejected;
2502 }
2503
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002504 if (IsRtp(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002505 // Set the extmap.
2506 if (!session_extmaps.empty() &&
2507 !content->rtp_header_extensions().empty()) {
2508 return ParseFailed("",
2509 "The a=extmap MUST be either all session level or "
2510 "all media level.",
2511 error);
2512 }
2513 for (size_t i = 0; i < session_extmaps.size(); ++i) {
2514 content->AddRtpHeaderExtension(session_extmaps[i]);
2515 }
2516 }
2517 content->set_protocol(protocol);
zhihuang38989e52017-03-21 11:04:53 -07002518
2519 // Use the session level connection address if the media level addresses are
2520 // not specified.
2521 rtc::SocketAddress address;
2522 address = content->connection_address().IsNil()
2523 ? session_connection_addr
2524 : content->connection_address();
2525 address.SetPort(port);
2526 content->set_connection_address(address);
2527
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002528 desc->AddContent(content_name,
Steve Anton5adfafd2017-12-20 16:34:00 -08002529 IsDtlsSctp(protocol) ? MediaProtocolType::kSctp
2530 : MediaProtocolType::kRtp,
deadbeef25ed4352016-12-12 18:37:36 -08002531 content_rejected, bundle_only, content.release());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002532 // Create TransportInfo with the media level "ice-pwd" and "ice-ufrag".
2533 TransportInfo transport_info(content_name, transport);
2534
2535 if (!desc->AddTransportInfo(transport_info)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002536 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002537 description << "Failed to AddTransportInfo with content name: "
2538 << content_name;
2539 return ParseFailed("", description.str(), error);
2540 }
2541 }
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002542
Steve Antone831b8c2018-02-01 12:22:16 -08002543 desc->set_msid_signaling(msid_signaling);
2544
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002545 size_t end_of_message = message.size();
2546 if (mline_index == -1 && *pos != end_of_message) {
2547 ParseFailed(message, *pos, "Expects m line.", error);
2548 return false;
2549 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002550 return true;
2551}
2552
2553bool VerifyCodec(const cricket::Codec& codec) {
2554 // Codec has not been populated correctly unless the name has been set. This
2555 // can happen if an SDP has an fmtp or rtcp-fb with a payload type but doesn't
2556 // have a corresponding "rtpmap" line.
htab39db842016-12-08 01:50:48 -08002557 return !codec.name.empty();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002558}
2559
2560bool VerifyAudioCodecs(const AudioContentDescription* audio_desc) {
2561 const std::vector<cricket::AudioCodec>& codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002562 return std::all_of(codecs.begin(), codecs.end(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002563}
2564
2565bool VerifyVideoCodecs(const VideoContentDescription* video_desc) {
2566 const std::vector<cricket::VideoCodec>& codecs = video_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002567 return std::all_of(codecs.begin(), codecs.end(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002568}
2569
2570void AddParameters(const cricket::CodecParameterMap& parameters,
2571 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002572 for (const auto& entry : parameters) {
2573 const std::string& key = entry.first;
2574 const std::string& value = entry.second;
2575 codec->SetParam(key, value);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002576 }
2577}
2578
2579void AddFeedbackParameter(const cricket::FeedbackParam& feedback_param,
2580 cricket::Codec* codec) {
2581 codec->AddFeedbackParam(feedback_param);
2582}
2583
2584void AddFeedbackParameters(const cricket::FeedbackParams& feedback_params,
2585 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002586 for (const cricket::FeedbackParam& param : feedback_params.params()) {
2587 codec->AddFeedbackParam(param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002588 }
2589}
2590
2591// Gets the current codec setting associated with |payload_type|. If there
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002592// is no Codec associated with that payload type it returns an empty codec
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002593// with that payload type.
2594template <class T>
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002595T GetCodecWithPayloadType(const std::vector<T>& codecs, int payload_type) {
magjedb05fa242016-11-11 04:00:16 -08002596 const T* codec = FindCodecById(codecs, payload_type);
2597 if (codec)
2598 return *codec;
2599 // Return empty codec with |payload_type|.
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002600 T ret_val;
magjedb05fa242016-11-11 04:00:16 -08002601 ret_val.id = payload_type;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002602 return ret_val;
2603}
2604
2605// Updates or creates a new codec entry in the audio description.
2606template <class T, class U>
2607void AddOrReplaceCodec(MediaContentDescription* content_desc, const U& codec) {
2608 T* desc = static_cast<T*>(content_desc);
2609 std::vector<U> codecs = desc->codecs();
2610 bool found = false;
Steve Anton4daf66e2018-09-07 14:55:53 -07002611 for (U& existing_codec : codecs) {
2612 if (codec.id == existing_codec.id) {
2613 // Overwrite existing codec with the new codec.
2614 existing_codec = codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002615 found = true;
2616 break;
2617 }
2618 }
2619 if (!found) {
2620 desc->AddCodec(codec);
2621 return;
2622 }
2623 desc->set_codecs(codecs);
2624}
2625
2626// Adds or updates existing codec corresponding to |payload_type| according
2627// to |parameters|.
2628template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002629void UpdateCodec(MediaContentDescription* content_desc,
2630 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002631 const cricket::CodecParameterMap& parameters) {
2632 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002633 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2634 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002635 AddParameters(parameters, &new_codec);
2636 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2637}
2638
2639// Adds or updates existing codec corresponding to |payload_type| according
2640// to |feedback_param|.
2641template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002642void UpdateCodec(MediaContentDescription* content_desc,
2643 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002644 const cricket::FeedbackParam& feedback_param) {
2645 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002646 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2647 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002648 AddFeedbackParameter(feedback_param, &new_codec);
2649 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2650}
2651
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002652template <class T>
2653bool PopWildcardCodec(std::vector<T>* codecs, T* wildcard_codec) {
2654 for (auto iter = codecs->begin(); iter != codecs->end(); ++iter) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002655 if (iter->id == kWildcardPayloadType) {
2656 *wildcard_codec = *iter;
2657 codecs->erase(iter);
2658 return true;
2659 }
2660 }
2661 return false;
2662}
2663
Yves Gerey665174f2018-06-19 15:03:05 +02002664template <class T>
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002665void UpdateFromWildcardCodecs(cricket::MediaContentDescriptionImpl<T>* desc) {
2666 auto codecs = desc->codecs();
2667 T wildcard_codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002668 if (!PopWildcardCodec(&codecs, &wildcard_codec)) {
2669 return;
2670 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002671 for (auto& codec : codecs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002672 AddFeedbackParameters(wildcard_codec.feedback_params, &codec);
2673 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002674 desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002675}
2676
Yves Gerey665174f2018-06-19 15:03:05 +02002677void AddAudioAttribute(const std::string& name,
2678 const std::string& value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002679 AudioContentDescription* audio_desc) {
2680 if (value.empty()) {
2681 return;
2682 }
2683 std::vector<cricket::AudioCodec> codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002684 for (cricket::AudioCodec& codec : codecs) {
2685 codec.params[name] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002686 }
2687 audio_desc->set_codecs(codecs);
2688}
2689
2690bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002691 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002692 int mline_index,
2693 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002694 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002695 size_t* pos,
2696 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002697 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002698 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002699 MediaContentDescription* media_desc,
2700 TransportDescription* transport,
2701 std::vector<JsepIceCandidate*>* candidates,
2702 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002703 RTC_DCHECK(media_desc != NULL);
2704 RTC_DCHECK(content_name != NULL);
2705 RTC_DCHECK(transport != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002706
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002707 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002708 MaybeCreateStaticPayloadAudioCodecs(payload_types, media_desc->as_audio());
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002709 }
2710
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002711 // The media level "ice-ufrag" and "ice-pwd".
2712 // The candidates before update the media level "ice-pwd" and "ice-ufrag".
2713 Candidates candidates_orig;
2714 std::string line;
2715 std::string mline_id;
2716 // Tracks created out of the ssrc attributes.
2717 StreamParamsVec tracks;
2718 SsrcInfoVec ssrc_infos;
2719 SsrcGroupVec ssrc_groups;
2720 std::string maxptime_as_string;
2721 std::string ptime_as_string;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002722 std::vector<std::string> stream_ids;
deadbeef9d3584c2016-02-16 17:54:10 -08002723 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002724
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002725 // Loop until the next m line
2726 while (!IsLineType(message, kLineTypeMedia, *pos)) {
2727 if (!GetLine(message, pos, &line)) {
2728 if (*pos >= message.size()) {
2729 break; // Done parsing
2730 } else {
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +00002731 return ParseFailed(message, *pos, "Invalid SDP line.", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002732 }
2733 }
2734
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002735 // RFC 4566
2736 // b=* (zero or more bandwidth information lines)
2737 if (IsLineType(line, kLineTypeSessionBandwidth)) {
2738 std::string bandwidth;
2739 if (HasAttribute(line, kApplicationSpecificMaximum)) {
2740 if (!GetValue(line, kApplicationSpecificMaximum, &bandwidth, error)) {
2741 return false;
2742 } else {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002743 int b = 0;
2744 if (!GetValueFromString(line, bandwidth, &b, error)) {
2745 return false;
2746 }
deadbeef3e8016e2017-08-03 17:49:30 -07002747 // TODO(deadbeef): Historically, applications may be setting a value
2748 // of -1 to mean "unset any previously set bandwidth limit", even
2749 // though ommitting the "b=AS" entirely will do just that. Once we've
2750 // transitioned applications to doing the right thing, it would be
2751 // better to treat this as a hard error instead of just ignoring it.
2752 if (b == -1) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002753 RTC_LOG(LS_WARNING)
2754 << "Ignoring \"b=AS:-1\"; will be treated as \"no "
2755 "bandwidth limit\".";
deadbeef3e8016e2017-08-03 17:49:30 -07002756 continue;
2757 }
deadbeefbc88c6b2017-08-02 11:26:34 -07002758 if (b < 0) {
2759 return ParseFailed(line, "b=AS value can't be negative.", error);
2760 }
Peter Thatcherc0c3a862015-06-24 15:31:25 -07002761 // We should never use more than the default bandwidth for RTP-based
2762 // data channels. Don't allow SDP to set the bandwidth, because
2763 // that would give JS the opportunity to "break the Internet".
2764 // See: https://code.google.com/p/chromium/issues/detail?id=280726
2765 if (media_type == cricket::MEDIA_TYPE_DATA && IsRtp(protocol) &&
2766 b > cricket::kDataMaxBandwidth / 1000) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002767 rtc::StringBuilder description;
Peter Thatcherc0c3a862015-06-24 15:31:25 -07002768 description << "RTP-based data channels may not send more than "
2769 << cricket::kDataMaxBandwidth / 1000 << "kbps.";
2770 return ParseFailed(line, description.str(), error);
2771 }
deadbeefb2362572016-12-13 16:37:06 -08002772 // Prevent integer overflow.
2773 b = std::min(b, INT_MAX / 1000);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002774 media_desc->set_bandwidth(b * 1000);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002775 }
2776 }
2777 continue;
2778 }
2779
zhihuang38989e52017-03-21 11:04:53 -07002780 // Parse the media level connection data.
2781 if (IsLineType(line, kLineTypeConnection)) {
2782 rtc::SocketAddress addr;
2783 if (!ParseConnectionData(line, &addr, error)) {
2784 return false;
2785 }
2786 media_desc->set_connection_address(addr);
2787 continue;
2788 }
2789
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002790 if (!IsLineType(line, kLineTypeAttributes)) {
Steve Anton36b29d12017-10-30 09:57:42 -07002791 // TODO(deadbeef): Handle other lines if needed.
Mirko Bonadei675513b2017-11-09 11:09:25 +01002792 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002793 continue;
2794 }
2795
2796 // Handle attributes common to SCTP and RTP.
2797 if (HasAttribute(line, kAttributeMid)) {
2798 // RFC 3388
2799 // mid-attribute = "a=mid:" identification-tag
2800 // identification-tag = token
2801 // Use the mid identification-tag as the content name.
2802 if (!GetValue(line, kAttributeMid, &mline_id, error)) {
2803 return false;
2804 }
2805 *content_name = mline_id;
deadbeef25ed4352016-12-12 18:37:36 -08002806 } else if (HasAttribute(line, kAttributeBundleOnly)) {
2807 *bundle_only = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002808 } else if (HasAttribute(line, kAttributeCandidate)) {
2809 Candidate candidate;
2810 if (!ParseCandidate(line, &candidate, error, false)) {
2811 return false;
2812 }
deadbeef7bcdb692017-01-20 12:43:58 -08002813 // ParseCandidate will parse non-standard ufrag and password attributes,
2814 // since it's used for candidate trickling, but we only want to process
2815 // the "a=ice-ufrag"/"a=ice-pwd" values in a session description, so
2816 // strip them off at this point.
2817 candidate.set_username(std::string());
2818 candidate.set_password(std::string());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002819 candidates_orig.push_back(candidate);
2820 } else if (HasAttribute(line, kAttributeIceUfrag)) {
2821 if (!GetValue(line, kAttributeIceUfrag, &transport->ice_ufrag, error)) {
2822 return false;
2823 }
2824 } else if (HasAttribute(line, kAttributeIcePwd)) {
2825 if (!GetValue(line, kAttributeIcePwd, &transport->ice_pwd, error)) {
2826 return false;
2827 }
2828 } else if (HasAttribute(line, kAttributeIceOption)) {
2829 if (!ParseIceOptions(line, &transport->transport_options, error)) {
2830 return false;
2831 }
2832 } else if (HasAttribute(line, kAttributeFmtp)) {
2833 if (!ParseFmtpAttributes(line, media_type, media_desc, error)) {
2834 return false;
2835 }
2836 } else if (HasAttribute(line, kAttributeFingerprint)) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00002837 rtc::SSLFingerprint* fingerprint = NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002838
2839 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2840 return false;
2841 }
2842 transport->identity_fingerprint.reset(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002843 } else if (HasAttribute(line, kAttributeSetup)) {
2844 if (!ParseDtlsSetup(line, &(transport->connection_role), error)) {
2845 return false;
2846 }
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002847 } else if (IsDtlsSctp(protocol) && HasAttribute(line, kAttributeSctpPort)) {
deadbeef7e146cb2016-09-28 10:04:34 -07002848 if (media_type != cricket::MEDIA_TYPE_DATA) {
2849 return ParseFailed(
2850 line, "sctp-port attribute found in non-data media description.",
2851 error);
2852 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002853 int sctp_port;
2854 if (!ParseSctpPort(line, &sctp_port, error)) {
2855 return false;
2856 }
Steve Antonb1c1de12017-12-21 15:14:30 -08002857 if (!AddSctpDataCodec(media_desc->as_data(), sctp_port)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002858 return false;
2859 }
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002860 } else if (IsRtp(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002861 //
2862 // RTP specific attrubtes
2863 //
2864 if (HasAttribute(line, kAttributeRtcpMux)) {
2865 media_desc->set_rtcp_mux(true);
deadbeef13871492015-12-09 12:37:51 -08002866 } else if (HasAttribute(line, kAttributeRtcpReducedSize)) {
2867 media_desc->set_rtcp_reduced_size(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002868 } else if (HasAttribute(line, kAttributeSsrcGroup)) {
2869 if (!ParseSsrcGroupAttribute(line, &ssrc_groups, error)) {
2870 return false;
2871 }
2872 } else if (HasAttribute(line, kAttributeSsrc)) {
Steve Antone831b8c2018-02-01 12:22:16 -08002873 if (!ParseSsrcAttribute(line, &ssrc_infos, msid_signaling, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002874 return false;
2875 }
2876 } else if (HasAttribute(line, kAttributeCrypto)) {
2877 if (!ParseCryptoAttribute(line, media_desc, error)) {
2878 return false;
2879 }
2880 } else if (HasAttribute(line, kAttributeRtpmap)) {
deadbeef67cf2c12016-04-13 10:07:16 -07002881 if (!ParseRtpmapAttribute(line, media_type, payload_types, media_desc,
2882 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002883 return false;
2884 }
2885 } else if (HasAttribute(line, kCodecParamMaxPTime)) {
2886 if (!GetValue(line, kCodecParamMaxPTime, &maxptime_as_string, error)) {
2887 return false;
2888 }
2889 } else if (HasAttribute(line, kAttributeRtcpFb)) {
2890 if (!ParseRtcpFbAttribute(line, media_type, media_desc, error)) {
2891 return false;
2892 }
2893 } else if (HasAttribute(line, kCodecParamPTime)) {
2894 if (!GetValue(line, kCodecParamPTime, &ptime_as_string, error)) {
2895 return false;
2896 }
2897 } else if (HasAttribute(line, kAttributeSendOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002898 media_desc->set_direction(RtpTransceiverDirection::kSendOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002899 } else if (HasAttribute(line, kAttributeRecvOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002900 media_desc->set_direction(RtpTransceiverDirection::kRecvOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002901 } else if (HasAttribute(line, kAttributeInactive)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002902 media_desc->set_direction(RtpTransceiverDirection::kInactive);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002903 } else if (HasAttribute(line, kAttributeSendRecv)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002904 media_desc->set_direction(RtpTransceiverDirection::kSendRecv);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002905 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002906 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002907 if (!ParseExtmap(line, &extmap, error)) {
2908 return false;
2909 }
2910 media_desc->AddRtpHeaderExtension(extmap);
2911 } else if (HasAttribute(line, kAttributeXGoogleFlag)) {
2912 // Experimental attribute. Conference mode activates more aggressive
2913 // AEC and NS settings.
Steve Anton36b29d12017-10-30 09:57:42 -07002914 // TODO(deadbeef): expose API to set these directly.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002915 std::string flag_value;
2916 if (!GetValue(line, kAttributeXGoogleFlag, &flag_value, error)) {
2917 return false;
2918 }
2919 if (flag_value.compare(kValueConference) == 0)
2920 media_desc->set_conference_mode(true);
deadbeef9d3584c2016-02-16 17:54:10 -08002921 } else if (HasAttribute(line, kAttributeMsid)) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002922 if (!ParseMsidAttribute(line, &stream_ids, &track_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002923 return false;
2924 }
Steve Antone831b8c2018-02-01 12:22:16 -08002925 *msid_signaling |= cricket::kMsidSignalingMediaSection;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002926 }
2927 } else {
2928 // Only parse lines that we are interested of.
Mirko Bonadei675513b2017-11-09 11:09:25 +01002929 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002930 continue;
2931 }
2932 }
2933
2934 // Create tracks from the |ssrc_infos|.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -08002935 // If the stream_id/track_id for all SSRCS are identical, one StreamParams
2936 // will be created in CreateTracksFromSsrcInfos, containing all the SSRCs from
2937 // the m= section.
Seth Hampson5897a6e2018-04-03 11:16:33 -07002938 if (!ssrc_infos.empty()) {
2939 CreateTracksFromSsrcInfos(ssrc_infos, stream_ids, track_id, &tracks,
2940 *msid_signaling);
2941 } else if (media_type != cricket::MEDIA_TYPE_DATA &&
2942 (*msid_signaling & cricket::kMsidSignalingMediaSection)) {
2943 // If the stream_ids/track_id was signaled but SSRCs were unsignaled we
2944 // still create a track. This isn't done for data media types because
2945 // StreamParams aren't used for SCTP streams, and RTP data channels don't
2946 // support unsignaled SSRCs.
2947 CreateTrackWithNoSsrcs(stream_ids, track_id, &tracks);
2948 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002949
2950 // Add the ssrc group to the track.
Steve Anton4daf66e2018-09-07 14:55:53 -07002951 for (const SsrcGroup& ssrc_group : ssrc_groups) {
2952 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002953 continue;
2954 }
Steve Anton4daf66e2018-09-07 14:55:53 -07002955 uint32_t ssrc = ssrc_group.ssrcs.front();
2956 for (StreamParams& track : tracks) {
2957 if (track.has_ssrc(ssrc)) {
2958 track.ssrc_groups.push_back(ssrc_group);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002959 }
2960 }
2961 }
2962
2963 // Add the new tracks to the |media_desc|.
deadbeef9d3584c2016-02-16 17:54:10 -08002964 for (StreamParams& track : tracks) {
2965 media_desc->AddStream(track);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002966 }
2967
2968 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002969 AudioContentDescription* audio_desc = media_desc->as_audio();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002970 UpdateFromWildcardCodecs(audio_desc);
2971
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002972 // Verify audio codec ensures that no audio codec has been populated with
2973 // only fmtp.
2974 if (!VerifyAudioCodecs(audio_desc)) {
2975 return ParseFailed("Failed to parse audio codecs correctly.", error);
2976 }
2977 AddAudioAttribute(kCodecParamMaxPTime, maxptime_as_string, audio_desc);
2978 AddAudioAttribute(kCodecParamPTime, ptime_as_string, audio_desc);
2979 }
2980
2981 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002982 VideoContentDescription* video_desc = media_desc->as_video();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002983 UpdateFromWildcardCodecs(video_desc);
2984 // Verify video codec ensures that no video codec has been populated with
2985 // only rtcp-fb.
2986 if (!VerifyVideoCodecs(video_desc)) {
2987 return ParseFailed("Failed to parse video codecs correctly.", error);
2988 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002989 }
2990
2991 // RFC 5245
2992 // Update the candidates with the media level "ice-pwd" and "ice-ufrag".
Steve Anton4daf66e2018-09-07 14:55:53 -07002993 for (Candidate& candidate : candidates_orig) {
2994 RTC_DCHECK(candidate.username().empty() ||
2995 candidate.username() == transport->ice_ufrag);
2996 candidate.set_username(transport->ice_ufrag);
2997 RTC_DCHECK(candidate.password().empty());
2998 candidate.set_password(transport->ice_pwd);
2999 candidates->push_back(
3000 new JsepIceCandidate(mline_id, mline_index, candidate));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003001 }
3002 return true;
3003}
3004
Steve Antone831b8c2018-02-01 12:22:16 -08003005bool ParseSsrcAttribute(const std::string& line,
3006 SsrcInfoVec* ssrc_infos,
3007 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003008 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003009 RTC_DCHECK(ssrc_infos != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003010 // RFC 5576
3011 // a=ssrc:<ssrc-id> <attribute>
3012 // a=ssrc:<ssrc-id> <attribute>:<value>
3013 std::string field1, field2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003014 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3015 kSdpDelimiterSpaceChar, &field1, &field2)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003016 const size_t expected_fields = 2;
3017 return ParseFailedExpectFieldNum(line, expected_fields, error);
3018 }
3019
3020 // ssrc:<ssrc-id>
3021 std::string ssrc_id_s;
3022 if (!GetValue(field1, kAttributeSsrc, &ssrc_id_s, error)) {
3023 return false;
3024 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003025 uint32_t ssrc_id = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003026 if (!GetValueFromString(line, ssrc_id_s, &ssrc_id, error)) {
3027 return false;
3028 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003029
3030 std::string attribute;
3031 std::string value;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003032 if (!rtc::tokenize_first(field2, kSdpDelimiterColonChar, &attribute,
3033 &value)) {
3034 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003035 description << "Failed to get the ssrc attribute value from " << field2
3036 << ". Expected format <attribute>:<value>.";
3037 return ParseFailed(line, description.str(), error);
3038 }
3039
3040 // Check if there's already an item for this |ssrc_id|. Create a new one if
3041 // there isn't.
Steve Anton4daf66e2018-09-07 14:55:53 -07003042 auto ssrc_info_it = std::find_if(ssrc_infos->begin(), ssrc_infos->end(),
3043 [ssrc_id](const SsrcInfo& ssrc_info) {
3044 return ssrc_info.ssrc_id == ssrc_id;
3045 });
3046 if (ssrc_info_it == ssrc_infos->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003047 SsrcInfo info;
3048 info.ssrc_id = ssrc_id;
3049 ssrc_infos->push_back(info);
Steve Anton4daf66e2018-09-07 14:55:53 -07003050 ssrc_info_it = ssrc_infos->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003051 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003052 SsrcInfo& ssrc_info = *ssrc_info_it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003053
3054 // Store the info to the |ssrc_info|.
3055 if (attribute == kSsrcAttributeCname) {
3056 // RFC 5576
3057 // cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003058 ssrc_info.cname = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003059 } else if (attribute == kSsrcAttributeMsid) {
3060 // draft-alvestrand-mmusic-msid-00
Seth Hampson5b4f0752018-04-02 16:31:36 -07003061 // msid:identifier [appdata]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003062 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003063 rtc::split(value, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003064 if (fields.size() < 1 || fields.size() > 2) {
Yves Gerey665174f2018-06-19 15:03:05 +02003065 return ParseFailed(
3066 line, "Expected format \"msid:<identifier>[ <appdata>]\".", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003067 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003068 ssrc_info.stream_id = fields[0];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003069 if (fields.size() == 2) {
Steve Anton4daf66e2018-09-07 14:55:53 -07003070 ssrc_info.track_id = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003071 }
Steve Antone831b8c2018-02-01 12:22:16 -08003072 *msid_signaling |= cricket::kMsidSignalingSsrcAttribute;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003073 } else if (attribute == kSsrcAttributeMslabel) {
3074 // draft-alvestrand-rtcweb-mid-01
3075 // mslabel:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003076 ssrc_info.mslabel = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003077 } else if (attribute == kSSrcAttributeLabel) {
3078 // The label isn't defined.
3079 // label:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003080 ssrc_info.label = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003081 }
3082 return true;
3083}
3084
3085bool ParseSsrcGroupAttribute(const std::string& line,
3086 SsrcGroupVec* ssrc_groups,
3087 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003088 RTC_DCHECK(ssrc_groups != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003089 // RFC 5576
3090 // a=ssrc-group:<semantics> <ssrc-id> ...
3091 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003092 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003093 const size_t expected_min_fields = 2;
3094 if (fields.size() < expected_min_fields) {
3095 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3096 }
3097 std::string semantics;
3098 if (!GetValue(fields[0], kAttributeSsrcGroup, &semantics, error)) {
3099 return false;
3100 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003101 std::vector<uint32_t> ssrcs;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003102 for (size_t i = 1; i < fields.size(); ++i) {
Peter Boström0c4e06b2015-10-07 12:23:21 +02003103 uint32_t ssrc = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003104 if (!GetValueFromString(line, fields[i], &ssrc, error)) {
3105 return false;
3106 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003107 ssrcs.push_back(ssrc);
3108 }
3109 ssrc_groups->push_back(SsrcGroup(semantics, ssrcs));
3110 return true;
3111}
3112
3113bool ParseCryptoAttribute(const std::string& line,
3114 MediaContentDescription* media_desc,
3115 SdpParseError* error) {
3116 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003117 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003118 // RFC 4568
3119 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
3120 const size_t expected_min_fields = 3;
3121 if (fields.size() < expected_min_fields) {
3122 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3123 }
3124 std::string tag_value;
3125 if (!GetValue(fields[0], kAttributeCrypto, &tag_value, error)) {
3126 return false;
3127 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003128 int tag = 0;
3129 if (!GetValueFromString(line, tag_value, &tag, error)) {
3130 return false;
3131 }
jbauch083b73f2015-07-16 02:46:32 -07003132 const std::string& crypto_suite = fields[1];
3133 const std::string& key_params = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003134 std::string session_params;
3135 if (fields.size() > 3) {
3136 session_params = fields[3];
3137 }
Yves Gerey665174f2018-06-19 15:03:05 +02003138 media_desc->AddCrypto(
3139 CryptoParams(tag, crypto_suite, key_params, session_params));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003140 return true;
3141}
3142
3143// Updates or creates a new codec entry in the audio description with according
deadbeef67cf2c12016-04-13 10:07:16 -07003144// to |name|, |clockrate|, |bitrate|, and |channels|.
3145void UpdateCodec(int payload_type,
3146 const std::string& name,
3147 int clockrate,
3148 int bitrate,
3149 size_t channels,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003150 AudioContentDescription* audio_desc) {
3151 // Codec may already be populated with (only) optional parameters
3152 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003153 cricket::AudioCodec codec =
3154 GetCodecWithPayloadType(audio_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003155 codec.name = name;
3156 codec.clockrate = clockrate;
3157 codec.bitrate = bitrate;
3158 codec.channels = channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003159 AddOrReplaceCodec<AudioContentDescription, cricket::AudioCodec>(audio_desc,
3160 codec);
3161}
3162
3163// Updates or creates a new codec entry in the video description according to
deadbeef67cf2c12016-04-13 10:07:16 -07003164// |name|, |width|, |height|, and |framerate|.
3165void UpdateCodec(int payload_type,
3166 const std::string& name,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003167 VideoContentDescription* video_desc) {
3168 // Codec may already be populated with (only) optional parameters
3169 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003170 cricket::VideoCodec codec =
3171 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003172 codec.name = name;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003173 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
3174 codec);
3175}
3176
3177bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003178 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -07003179 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003180 MediaContentDescription* media_desc,
3181 SdpParseError* error) {
3182 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003183 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003184 // RFC 4566
3185 // a=rtpmap:<payload type> <encoding name>/<clock rate>[/<encodingparameters>]
3186 const size_t expected_min_fields = 2;
3187 if (fields.size() < expected_min_fields) {
3188 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3189 }
3190 std::string payload_type_value;
3191 if (!GetValue(fields[0], kAttributeRtpmap, &payload_type_value, error)) {
3192 return false;
3193 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003194 int payload_type = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003195 if (!GetPayloadTypeFromString(line, payload_type_value, &payload_type,
3196 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003197 return false;
3198 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003199
deadbeef67cf2c12016-04-13 10:07:16 -07003200 if (std::find(payload_types.begin(), payload_types.end(), payload_type) ==
3201 payload_types.end()) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003202 RTC_LOG(LS_WARNING) << "Ignore rtpmap line that did not appear in the "
Jonas Olsson45cc8902018-02-13 10:37:07 +01003203 "<fmt> of the m-line: "
3204 << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003205 return true;
3206 }
jbauch083b73f2015-07-16 02:46:32 -07003207 const std::string& encoder = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003208 std::vector<std::string> codec_params;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00003209 rtc::split(encoder, '/', &codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003210 // <encoding name>/<clock rate>[/<encodingparameters>]
3211 // 2 mandatory fields
3212 if (codec_params.size() < 2 || codec_params.size() > 3) {
3213 return ParseFailed(line,
3214 "Expected format \"<encoding name>/<clock rate>"
3215 "[/<encodingparameters>]\".",
3216 error);
3217 }
jbauch083b73f2015-07-16 02:46:32 -07003218 const std::string& encoding_name = codec_params[0];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003219 int clock_rate = 0;
3220 if (!GetValueFromString(line, codec_params[1], &clock_rate, error)) {
3221 return false;
3222 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003223 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003224 VideoContentDescription* video_desc = media_desc->as_video();
Yves Gerey665174f2018-06-19 15:03:05 +02003225 UpdateCodec(payload_type, encoding_name, video_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003226 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3227 // RFC 4566
3228 // For audio streams, <encoding parameters> indicates the number
3229 // of audio channels. This parameter is OPTIONAL and may be
3230 // omitted if the number of channels is one, provided that no
3231 // additional parameters are needed.
Peter Kasting69558702016-01-12 16:26:35 -08003232 size_t channels = 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003233 if (codec_params.size() == 3) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003234 if (!GetValueFromString(line, codec_params[2], &channels, error)) {
3235 return false;
3236 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003237 }
Steve Antonb1c1de12017-12-21 15:14:30 -08003238 AudioContentDescription* audio_desc = media_desc->as_audio();
ossue1405ad2017-01-23 08:55:48 -08003239 UpdateCodec(payload_type, encoding_name, clock_rate, 0, channels,
deadbeef67cf2c12016-04-13 10:07:16 -07003240 audio_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003241 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003242 DataContentDescription* data_desc = media_desc->as_data();
deadbeef67cf2c12016-04-13 10:07:16 -07003243 data_desc->AddCodec(cricket::DataCodec(payload_type, encoding_name));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003244 }
3245 return true;
3246}
3247
Yves Gerey665174f2018-06-19 15:03:05 +02003248bool ParseFmtpParam(const std::string& line,
3249 std::string* parameter,
3250 std::string* value,
3251 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003252 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, parameter, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003253 ParseFailed(line, "Unable to parse fmtp parameter. \'=\' missing.", error);
3254 return false;
3255 }
3256 // a=fmtp:<payload_type> <param1>=<value1>; <param2>=<value2>; ...
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003257 return true;
3258}
3259
Yves Gerey665174f2018-06-19 15:03:05 +02003260bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003261 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003262 MediaContentDescription* media_desc,
3263 SdpParseError* error) {
3264 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3265 media_type != cricket::MEDIA_TYPE_VIDEO) {
3266 return true;
3267 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003268
3269 std::string line_payload;
3270 std::string line_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003271
3272 // RFC 5576
3273 // a=fmtp:<format> <format specific parameters>
3274 // At least two fields, whereas the second one is any of the optional
3275 // parameters.
Jonas Olssonec9e4922018-09-05 09:53:49 +02003276 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3277 kSdpDelimiterSpaceChar, &line_payload,
3278 &line_params)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003279 ParseFailedExpectMinFieldNum(line, 2, error);
3280 return false;
3281 }
3282
Donald Curtis0e07f922015-05-15 09:21:23 -07003283 // Parse out the payload information.
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003284 std::string payload_type_str;
Donald Curtis0e07f922015-05-15 09:21:23 -07003285 if (!GetValue(line_payload, kAttributeFmtp, &payload_type_str, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003286 return false;
3287 }
3288
Donald Curtis0e07f922015-05-15 09:21:23 -07003289 int payload_type = 0;
Donald Curtis144d0182015-05-15 13:14:24 -07003290 if (!GetPayloadTypeFromString(line_payload, payload_type_str, &payload_type,
3291 error)) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003292 return false;
3293 }
3294
3295 // Parse out format specific parameters.
3296 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003297 rtc::split(line_params, kSdpDelimiterSemicolonChar, &fields);
Donald Curtis0e07f922015-05-15 09:21:23 -07003298
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003299 cricket::CodecParameterMap codec_params;
Donald Curtis144d0182015-05-15 13:14:24 -07003300 for (auto& iter : fields) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003301 if (iter.find(kSdpDelimiterEqual) == std::string::npos) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003302 // Only fmtps with equals are currently supported. Other fmtp types
3303 // should be ignored. Unknown fmtps do not constitute an error.
3304 continue;
3305 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003306
3307 std::string name;
3308 std::string value;
3309 if (!ParseFmtpParam(rtc::string_trim(iter), &name, &value, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003310 return false;
3311 }
3312 codec_params[name] = value;
3313 }
3314
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003315 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3316 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003317 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003318 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
3319 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003320 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003321 }
3322 return true;
3323}
3324
Yves Gerey665174f2018-06-19 15:03:05 +02003325bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003326 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003327 MediaContentDescription* media_desc,
3328 SdpParseError* error) {
3329 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3330 media_type != cricket::MEDIA_TYPE_VIDEO) {
3331 return true;
3332 }
3333 std::vector<std::string> rtcp_fb_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003334 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &rtcp_fb_fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003335 if (rtcp_fb_fields.size() < 2) {
3336 return ParseFailedGetValue(line, kAttributeRtcpFb, error);
3337 }
3338 std::string payload_type_string;
3339 if (!GetValue(rtcp_fb_fields[0], kAttributeRtcpFb, &payload_type_string,
3340 error)) {
3341 return false;
3342 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003343 int payload_type = kWildcardPayloadType;
3344 if (payload_type_string != "*") {
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003345 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3346 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003347 return false;
3348 }
3349 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003350 std::string id = rtcp_fb_fields[1];
3351 std::string param = "";
3352 for (std::vector<std::string>::iterator iter = rtcp_fb_fields.begin() + 2;
3353 iter != rtcp_fb_fields.end(); ++iter) {
3354 param.append(*iter);
3355 }
3356 const cricket::FeedbackParam feedback_param(id, param);
3357
3358 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003359 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
3360 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003361 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003362 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
3363 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003364 }
3365 return true;
3366}
3367
3368} // namespace webrtc