blob: 67d4bbb408424e66881203125204eef8a785719a [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";
Johannes Kron0854eb62018-10-10 22:33:20 +0200122static const char kAttributeExtmapAllowMixed[] = "extmap-allow-mixed";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000123static const char kAttributeExtmap[] = "extmap";
124// draft-alvestrand-mmusic-msid-01
125// a=msid-semantic: WMS
Seth Hampson5b4f0752018-04-02 16:31:36 -0700126// This is a legacy field supported only for Plan B semantics.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000127static const char kAttributeMsidSemantics[] = "msid-semantic";
128static const char kMediaStreamSemantic[] = "WMS";
129static const char kSsrcAttributeMsid[] = "msid";
130static const char kDefaultMsid[] = "default";
Seth Hampson5b4f0752018-04-02 16:31:36 -0700131static const char kNoStreamMsid[] = "-";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000132static const char kSsrcAttributeMslabel[] = "mslabel";
133static const char kSSrcAttributeLabel[] = "label";
134static const char kAttributeSsrcGroup[] = "ssrc-group";
135static const char kAttributeCrypto[] = "crypto";
136static const char kAttributeCandidate[] = "candidate";
137static const char kAttributeCandidateTyp[] = "typ";
138static const char kAttributeCandidateRaddr[] = "raddr";
139static const char kAttributeCandidateRport[] = "rport";
honghaiza54a0802015-12-16 18:37:23 -0800140static const char kAttributeCandidateUfrag[] = "ufrag";
141static const char kAttributeCandidatePwd[] = "pwd";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000142static const char kAttributeCandidateGeneration[] = "generation";
honghaiza0c44ea2016-03-23 16:07:48 -0700143static const char kAttributeCandidateNetworkId[] = "network-id";
honghaize1a0c942016-02-16 14:54:56 -0800144static const char kAttributeCandidateNetworkCost[] = "network-cost";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000145static const char kAttributeFingerprint[] = "fingerprint";
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000146static const char kAttributeSetup[] = "setup";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000147static const char kAttributeFmtp[] = "fmtp";
148static const char kAttributeRtpmap[] = "rtpmap";
wu@webrtc.org78187522013-10-07 23:32:02 +0000149static const char kAttributeSctpmap[] = "sctpmap";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000150static const char kAttributeRtcp[] = "rtcp";
151static const char kAttributeIceUfrag[] = "ice-ufrag";
152static const char kAttributeIcePwd[] = "ice-pwd";
153static const char kAttributeIceLite[] = "ice-lite";
154static const char kAttributeIceOption[] = "ice-options";
155static const char kAttributeSendOnly[] = "sendonly";
156static const char kAttributeRecvOnly[] = "recvonly";
157static const char kAttributeRtcpFb[] = "rtcp-fb";
158static const char kAttributeSendRecv[] = "sendrecv";
159static const char kAttributeInactive[] = "inactive";
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +0000160// draft-ietf-mmusic-sctp-sdp-07
161// a=sctp-port
162static const char kAttributeSctpPort[] = "sctp-port";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000163
164// Experimental flags
165static const char kAttributeXGoogleFlag[] = "x-google-flag";
166static const char kValueConference[] = "conference";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000167
168// Candidate
169static const char kCandidateHost[] = "host";
170static const char kCandidateSrflx[] = "srflx";
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700171static const char kCandidatePrflx[] = "prflx";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000172static const char kCandidateRelay[] = "relay";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +0000173static const char kTcpCandidateType[] = "tcptype";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000174
Jonas Olssonec9e4922018-09-05 09:53:49 +0200175// rtc::StringBuilder doesn't have a << overload for chars, while rtc::split and
176// rtc::tokenize_first both take a char delimiter. To handle both cases these
177// constants come in pairs of a chars and length-one strings.
178static const char kSdpDelimiterEqual[] = "=";
179static const char kSdpDelimiterEqualChar = '=';
180static const char kSdpDelimiterSpace[] = " ";
181static const char kSdpDelimiterSpaceChar = ' ';
182static const char kSdpDelimiterColon[] = ":";
183static const char kSdpDelimiterColonChar = ':';
184static const char kSdpDelimiterSemicolon[] = ";";
185static const char kSdpDelimiterSemicolonChar = ';';
186static const char kSdpDelimiterSlashChar = '/';
187static const char kNewLine[] = "\n";
188static const char kNewLineChar = '\n';
189static const char kReturnChar = '\r';
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000190static const char kLineBreak[] = "\r\n";
191
Steve Anton36b29d12017-10-30 09:57:42 -0700192// TODO(deadbeef): Generate the Session and Time description
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000193// instead of hardcoding.
194static const char kSessionVersion[] = "v=0";
195// RFC 4566
196static const char kSessionOriginUsername[] = "-";
197static const char kSessionOriginSessionId[] = "0";
198static const char kSessionOriginSessionVersion[] = "0";
199static const char kSessionOriginNettype[] = "IN";
200static const char kSessionOriginAddrtype[] = "IP4";
201static const char kSessionOriginAddress[] = "127.0.0.1";
202static const char kSessionName[] = "s=-";
203static const char kTimeDescription[] = "t=0 0";
204static const char kAttrGroup[] = "a=group:BUNDLE";
205static const char kConnectionNettype[] = "IN";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000206static const char kConnectionIpv4Addrtype[] = "IP4";
207static const char kConnectionIpv6Addrtype[] = "IP6";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000208static const char kMediaTypeVideo[] = "video";
209static const char kMediaTypeAudio[] = "audio";
210static const char kMediaTypeData[] = "application";
211static const char kMediaPortRejected[] = "0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000212// draft-ietf-mmusic-trickle-ice-01
213// When no candidates have been gathered, set the connection
214// address to IP6 ::.
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000215// TODO(perkj): FF can not parse IP6 ::. See http://crbug/430333
216// Use IPV4 per default.
217static const char kDummyAddress[] = "0.0.0.0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000218static const char kDummyPort[] = "9";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000219// RFC 3556
220static const char kApplicationSpecificMaximum[] = "AS";
221
wu@webrtc.org78187522013-10-07 23:32:02 +0000222static const char kDefaultSctpmapProtocol[] = "webrtc-datachannel";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000223
pkasting@chromium.orgd3245462015-02-23 21:28:22 +0000224// RTP payload type is in the 0-127 range. Use -1 to indicate "all" payload
225// types.
226const int kWildcardPayloadType = -1;
227
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000228struct SsrcInfo {
Peter Boström0c4e06b2015-10-07 12:23:21 +0200229 uint32_t ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000230 std::string cname;
deadbeef9d3584c2016-02-16 17:54:10 -0800231 std::string stream_id;
232 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000233
234 // For backward compatibility.
235 // TODO(ronghuawu): Remove below 2 fields once all the clients support msid.
236 std::string label;
237 std::string mslabel;
238};
239typedef std::vector<SsrcInfo> SsrcInfoVec;
240typedef std::vector<SsrcGroup> SsrcGroupVec;
241
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000242template <class T>
243static void AddFmtpLine(const T& codec, std::string* message);
244static void BuildMediaDescription(const ContentInfo* content_info,
245 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200246 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000247 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -0800248 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000249 std::string* message);
zstein4b2e0822017-02-17 19:48:38 -0800250static void BuildSctpContentAttributes(std::string* message,
251 int sctp_port,
252 bool use_sctpmap);
deadbeef9d3584c2016-02-16 17:54:10 -0800253static void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200254 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -0800255 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -0800256 std::string* message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000257static void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200258 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000259 std::string* message);
260static void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -0800261 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000262 std::string* message);
263static void BuildIceOptions(const std::vector<std::string>& transport_options,
264 std::string* message);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +0000265static bool IsRtp(const std::string& protocol);
266static bool IsDtlsSctp(const std::string& protocol);
zhihuang38989e52017-03-21 11:04:53 -0700267static bool ParseSessionDescription(const std::string& message,
268 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000269 std::string* session_id,
270 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000271 TransportDescription* session_td,
272 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700273 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000274 cricket::SessionDescription* desc,
275 SdpParseError* error);
276static bool ParseGroupAttribute(const std::string& line,
277 cricket::SessionDescription* desc,
278 SdpParseError* error);
279static bool ParseMediaDescription(
280 const std::string& message,
281 const TransportDescription& session_td,
282 const RtpHeaderExtensions& session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700283 size_t* pos,
284 const rtc::SocketAddress& session_connection_addr,
285 cricket::SessionDescription* desc,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000286 std::vector<JsepIceCandidate*>* candidates,
287 SdpParseError* error);
288static bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200289 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000290 int mline_index,
291 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -0700292 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000293 size_t* pos,
294 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -0800295 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -0800296 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000297 MediaContentDescription* media_desc,
298 TransportDescription* transport,
299 std::vector<JsepIceCandidate*>* candidates,
300 SdpParseError* error);
301static bool ParseSsrcAttribute(const std::string& line,
302 SsrcInfoVec* ssrc_infos,
Steve Antone831b8c2018-02-01 12:22:16 -0800303 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000304 SdpParseError* error);
305static bool ParseSsrcGroupAttribute(const std::string& line,
306 SsrcGroupVec* ssrc_groups,
307 SdpParseError* error);
308static bool ParseCryptoAttribute(const std::string& line,
309 MediaContentDescription* media_desc,
310 SdpParseError* error);
311static bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200312 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -0700313 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000314 MediaContentDescription* media_desc,
315 SdpParseError* error);
316static bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200317 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000318 MediaContentDescription* media_desc,
319 SdpParseError* error);
Yves Gerey665174f2018-06-19 15:03:05 +0200320static bool ParseFmtpParam(const std::string& line,
321 std::string* parameter,
322 std::string* value,
323 SdpParseError* error);
324static bool ParseCandidate(const std::string& message,
325 Candidate* candidate,
326 SdpParseError* error,
327 bool is_raw);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000328static bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200329 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000330 MediaContentDescription* media_desc,
331 SdpParseError* error);
332static bool ParseIceOptions(const std::string& line,
333 std::vector<std::string>* transport_options,
334 SdpParseError* error);
335static bool ParseExtmap(const std::string& line,
isheriff6f8d6862016-05-26 11:24:55 -0700336 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000337 SdpParseError* error);
338static bool ParseFingerprintAttribute(const std::string& line,
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000339 rtc::SSLFingerprint** fingerprint,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000340 SdpParseError* error);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000341static bool ParseDtlsSetup(const std::string& line,
342 cricket::ConnectionRole* role,
343 SdpParseError* error);
deadbeef9d3584c2016-02-16 17:54:10 -0800344static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700345 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -0800346 std::string* track_id,
347 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000348
349// Helper functions
350
351// Below ParseFailed*** functions output the line that caused the parsing
352// failure and the detailed reason (|description|) of the failure to |error|.
353// The functions always return false so that they can be used directly in the
354// following way when error happens:
355// "return ParseFailed***(...);"
356
357// The line starting at |line_start| of |message| is the failing line.
358// The reason for the failure should be provided in the |description|.
359// An example of a description could be "unknown character".
360static bool ParseFailed(const std::string& message,
361 size_t line_start,
362 const std::string& description,
363 SdpParseError* error) {
364 // Get the first line of |message| from |line_start|.
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000365 std::string first_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000366 size_t line_end = message.find(kNewLine, line_start);
367 if (line_end != std::string::npos) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200368 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000369 --line_end;
370 }
371 first_line = message.substr(line_start, (line_end - line_start));
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000372 } else {
373 first_line = message.substr(line_start);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000374 }
375
376 if (error) {
377 error->line = first_line;
378 error->description = description;
379 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100380 RTC_LOG(LS_ERROR) << "Failed to parse: \"" << first_line
381 << "\". Reason: " << description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000382 return false;
383}
384
385// |line| is the failing line. The reason for the failure should be
386// provided in the |description|.
387static bool ParseFailed(const std::string& line,
388 const std::string& description,
389 SdpParseError* error) {
390 return ParseFailed(line, 0, description, error);
391}
392
393// Parses failure where the failing SDP line isn't know or there are multiple
394// failing lines.
Yves Gerey665174f2018-06-19 15:03:05 +0200395static bool ParseFailed(const std::string& description, SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000396 return ParseFailed("", description, error);
397}
398
399// |line| is the failing line. The failure is due to the fact that |line|
400// doesn't have |expected_fields| fields.
401static bool ParseFailedExpectFieldNum(const std::string& line,
402 int expected_fields,
403 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200404 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000405 description << "Expects " << expected_fields << " fields.";
406 return ParseFailed(line, description.str(), error);
407}
408
409// |line| is the failing line. The failure is due to the fact that |line| has
410// less than |expected_min_fields| fields.
411static bool ParseFailedExpectMinFieldNum(const std::string& line,
412 int expected_min_fields,
413 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200414 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000415 description << "Expects at least " << expected_min_fields << " fields.";
416 return ParseFailed(line, description.str(), error);
417}
418
419// |line| is the failing line. The failure is due to the fact that it failed to
420// get the value of |attribute|.
421static bool ParseFailedGetValue(const std::string& line,
422 const std::string& attribute,
423 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200424 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000425 description << "Failed to get the value of attribute: " << attribute;
426 return ParseFailed(line, description.str(), error);
427}
428
429// The line starting at |line_start| of |message| is the failing line. The
430// failure is due to the line type (e.g. the "m" part of the "m-line")
431// not matching what is expected. The expected line type should be
432// provided as |line_type|.
433static bool ParseFailedExpectLine(const std::string& message,
434 size_t line_start,
435 const char line_type,
436 const std::string& line_value,
437 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200438 rtc::StringBuilder description;
439 description << "Expect line: " << std::string(1, line_type) << "="
440 << line_value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000441 return ParseFailed(message, line_start, description.str(), error);
442}
443
444static bool AddLine(const std::string& line, std::string* message) {
445 if (!message)
446 return false;
447
448 message->append(line);
449 message->append(kLineBreak);
450 return true;
451}
452
453static bool GetLine(const std::string& message,
454 size_t* pos,
455 std::string* line) {
456 size_t line_begin = *pos;
457 size_t line_end = message.find(kNewLine, line_begin);
458 if (line_end == std::string::npos) {
459 return false;
460 }
461 // Update the new start position
462 *pos = line_end + 1;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200463 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000464 --line_end;
465 }
466 *line = message.substr(line_begin, (line_end - line_begin));
467 const char* cline = line->c_str();
468 // RFC 4566
469 // An SDP session description consists of a number of lines of text of
470 // the form:
471 // <type>=<value>
472 // where <type> MUST be exactly one case-significant character and
473 // <value> is structured text whose format depends on <type>.
474 // Whitespace MUST NOT be used on either side of the "=" sign.
Taylor Brandstetter93a7b242018-04-16 10:45:24 -0700475 //
476 // However, an exception to the whitespace rule is made for "s=", since
477 // RFC4566 also says:
478 //
479 // If a session has no meaningful name, the value "s= " SHOULD be used
480 // (i.e., a single space as the session name).
481 if (line->length() < 3 || !islower(cline[0]) ||
Jonas Olssonec9e4922018-09-05 09:53:49 +0200482 cline[1] != kSdpDelimiterEqualChar ||
483 (cline[0] != kLineTypeSessionName &&
484 cline[2] == kSdpDelimiterSpaceChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000485 *pos = line_begin;
486 return false;
487 }
488 return true;
489}
490
491// Init |os| to "|type|=|value|".
492static void InitLine(const char type,
493 const std::string& value,
Jonas Olssonec9e4922018-09-05 09:53:49 +0200494 rtc::StringBuilder* os) {
495 os->Clear();
496 *os << std::string(1, type) << kSdpDelimiterEqual << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000497}
498
499// Init |os| to "a=|attribute|".
Jonas Olssonec9e4922018-09-05 09:53:49 +0200500static void InitAttrLine(const std::string& attribute, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000501 InitLine(kLineTypeAttributes, attribute, os);
502}
503
504// Writes a SDP attribute line based on |attribute| and |value| to |message|.
Yves Gerey665174f2018-06-19 15:03:05 +0200505static void AddAttributeLine(const std::string& attribute,
506 int value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000507 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200508 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000509 InitAttrLine(attribute, &os);
510 os << kSdpDelimiterColon << value;
511 AddLine(os.str(), message);
512}
513
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000514static bool IsLineType(const std::string& message,
515 const char type,
516 size_t line_start) {
517 if (message.size() < line_start + kLinePrefixLength) {
518 return false;
519 }
520 const char* cmessage = message.c_str();
521 return (cmessage[line_start] == type &&
Jonas Olssonec9e4922018-09-05 09:53:49 +0200522 cmessage[line_start + 1] == kSdpDelimiterEqualChar);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000523}
524
Yves Gerey665174f2018-06-19 15:03:05 +0200525static bool IsLineType(const std::string& line, const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000526 return IsLineType(line, type, 0);
527}
528
Yves Gerey665174f2018-06-19 15:03:05 +0200529static bool GetLineWithType(const std::string& message,
530 size_t* pos,
531 std::string* line,
532 const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000533 if (!IsLineType(message, type, *pos)) {
534 return false;
535 }
536
537 if (!GetLine(message, pos, line))
538 return false;
539
540 return true;
541}
542
543static bool HasAttribute(const std::string& line,
544 const std::string& attribute) {
Johannes Kron211856b2018-09-06 12:12:28 +0200545 if (line.compare(kLinePrefixLength, attribute.size(), attribute) == 0) {
546 // Make sure that the match is not only a partial match. If length of
547 // strings doesn't match, the next character of the line must be ':' or ' '.
548 // This function is also used for media descriptions (e.g., "m=audio 9..."),
549 // hence the need to also allow space in the end.
550 RTC_CHECK_LE(kLinePrefixLength + attribute.size(), line.size());
551 if ((kLinePrefixLength + attribute.size()) == line.size() ||
552 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterColonChar ||
553 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterSpaceChar) {
554 return true;
555 }
556 }
557 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000558}
559
Peter Boström0c4e06b2015-10-07 12:23:21 +0200560static bool AddSsrcLine(uint32_t ssrc_id,
561 const std::string& attribute,
562 const std::string& value,
563 std::string* message) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000564 // RFC 5576
565 // a=ssrc:<ssrc-id> <attribute>:<value>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200566 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000567 InitAttrLine(kAttributeSsrc, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200568 os << kSdpDelimiterColon << ssrc_id << kSdpDelimiterSpace << attribute
569 << kSdpDelimiterColon << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000570 return AddLine(os.str(), message);
571}
572
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000573// Get value only from <attribute>:<value>.
Yves Gerey665174f2018-06-19 15:03:05 +0200574static bool GetValue(const std::string& message,
575 const std::string& attribute,
576 std::string* value,
577 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000578 std::string leftpart;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200579 if (!rtc::tokenize_first(message, kSdpDelimiterColonChar, &leftpart, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000580 return ParseFailedGetValue(message, attribute, error);
581 }
582 // The left part should end with the expected attribute.
583 if (leftpart.length() < attribute.length() ||
584 leftpart.compare(leftpart.length() - attribute.length(),
585 attribute.length(), attribute) != 0) {
586 return ParseFailedGetValue(message, attribute, error);
587 }
588 return true;
589}
590
591static bool CaseInsensitiveFind(std::string str1, std::string str2) {
Yves Gerey665174f2018-06-19 15:03:05 +0200592 std::transform(str1.begin(), str1.end(), str1.begin(), ::tolower);
593 std::transform(str2.begin(), str2.end(), str2.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000594 return str1.find(str2) != std::string::npos;
595}
596
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000597template <class T>
598static bool GetValueFromString(const std::string& line,
599 const std::string& s,
600 T* t,
601 SdpParseError* error) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000602 if (!rtc::FromString(s, t)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200603 rtc::StringBuilder description;
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000604 description << "Invalid value: " << s << ".";
605 return ParseFailed(line, description.str(), error);
606 }
607 return true;
608}
609
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000610static bool GetPayloadTypeFromString(const std::string& line,
611 const std::string& s,
612 int* payload_type,
613 SdpParseError* error) {
614 return GetValueFromString(line, s, payload_type, error) &&
Yves Gerey665174f2018-06-19 15:03:05 +0200615 cricket::IsValidRtpPayloadType(*payload_type);
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000616}
617
Seth Hampson5897a6e2018-04-03 11:16:33 -0700618// Creates a StreamParams track in the case when no SSRC lines are signaled.
619// This is a track that does not contain SSRCs and only contains
620// stream_ids/track_id if it's signaled with a=msid lines.
621void CreateTrackWithNoSsrcs(const std::vector<std::string>& msid_stream_ids,
622 const std::string& msid_track_id,
623 StreamParamsVec* tracks) {
624 StreamParams track;
625 if (msid_track_id.empty() || msid_stream_ids.empty()) {
626 // We only create an unsignaled track if a=msid lines were signaled.
627 return;
628 }
629 track.set_stream_ids(msid_stream_ids);
630 track.id = msid_track_id;
631 tracks->push_back(track);
632}
633
634// Creates the StreamParams tracks, for the case when SSRC lines are signaled.
635// |msid_stream_ids| and |msid_track_id| represent the stream/track ID from the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800636// "a=msid" attribute, if it exists. They are empty if the attribute does not
Seth Hampson5897a6e2018-04-03 11:16:33 -0700637// exist. We prioritize getting stream_ids/track_ids signaled in a=msid lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000638void CreateTracksFromSsrcInfos(const SsrcInfoVec& ssrc_infos,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700639 const std::vector<std::string>& msid_stream_ids,
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800640 const std::string& msid_track_id,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700641 StreamParamsVec* tracks,
642 int msid_signaling) {
nisseede5da42017-01-12 05:15:36 -0800643 RTC_DCHECK(tracks != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700644 for (const SsrcInfo& ssrc_info : ssrc_infos) {
645 if (ssrc_info.cname.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000646 continue;
647 }
648
Seth Hampson5b4f0752018-04-02 16:31:36 -0700649 std::vector<std::string> stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000650 std::string track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700651 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
652 // This is the case with Unified Plan SDP msid signaling.
653 stream_ids = msid_stream_ids;
Tomas Gunnarsson191bf5c2018-03-30 10:44:43 +0000654 track_id = msid_track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700655 } else if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
656 // This is the case with Plan B SDP msid signaling.
Steve Anton4daf66e2018-09-07 14:55:53 -0700657 stream_ids.push_back(ssrc_info.stream_id);
658 track_id = ssrc_info.track_id;
659 } else if (!ssrc_info.mslabel.empty()) {
Seth Hampson5b4f0752018-04-02 16:31:36 -0700660 // Since there's no a=msid or a=ssrc msid signaling, this is a sdp from
661 // an older version of client that doesn't support msid.
662 // In that case, we use the mslabel and label to construct the track.
Steve Anton4daf66e2018-09-07 14:55:53 -0700663 stream_ids.push_back(ssrc_info.mslabel);
664 track_id = ssrc_info.label;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700665 } else {
666 // Since no media streams isn't supported with older SDP signaling, we
667 // use a default a stream id.
668 stream_ids.push_back(kDefaultMsid);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000669 }
Seth Hampson5b4f0752018-04-02 16:31:36 -0700670 // If a track ID wasn't populated from the SSRC attributes OR the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800671 // msid attribute, use default/random values.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800672 if (track_id.empty()) {
673 // TODO(ronghuawu): What should we do if the track id doesn't appear?
674 // Create random string (which will be used as track label later)?
675 track_id = rtc::CreateRandomString(8);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000676 }
677
Steve Anton4daf66e2018-09-07 14:55:53 -0700678 auto track_it = std::find_if(
679 tracks->begin(), tracks->end(),
680 [track_id](const StreamParams& track) { return track.id == track_id; });
681 if (track_it == tracks->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000682 // If we don't find an existing track, create a new one.
683 tracks->push_back(StreamParams());
Steve Anton4daf66e2018-09-07 14:55:53 -0700684 track_it = tracks->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000685 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700686 StreamParams& track = *track_it;
687 track.add_ssrc(ssrc_info.ssrc_id);
688 track.cname = ssrc_info.cname;
689 track.set_stream_ids(stream_ids);
690 track.id = track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000691 }
692}
693
Seth Hampson845e8782018-03-02 11:34:10 -0800694void GetMediaStreamIds(const ContentInfo* content,
695 std::set<std::string>* labels) {
Steve Antonb1c1de12017-12-21 15:14:30 -0800696 for (const StreamParams& stream_params :
697 content->media_description()->streams()) {
Seth Hampson845e8782018-03-02 11:34:10 -0800698 for (const std::string& stream_id : stream_params.stream_ids()) {
699 labels->insert(stream_id);
Steve Anton5a26a3a2018-02-28 11:38:47 -0800700 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000701 }
702}
703
704// RFC 5245
705// It is RECOMMENDED that default candidates be chosen based on the
706// likelihood of those candidates to work with the peer that is being
707// contacted. It is RECOMMENDED that relayed > reflexive > host.
708static const int kPreferenceUnknown = 0;
709static const int kPreferenceHost = 1;
710static const int kPreferenceReflexive = 2;
711static const int kPreferenceRelayed = 3;
712
713static int GetCandidatePreferenceFromType(const std::string& type) {
714 int preference = kPreferenceUnknown;
715 if (type == cricket::LOCAL_PORT_TYPE) {
716 preference = kPreferenceHost;
717 } else if (type == cricket::STUN_PORT_TYPE) {
718 preference = kPreferenceReflexive;
719 } else if (type == cricket::RELAY_PORT_TYPE) {
720 preference = kPreferenceRelayed;
721 } else {
nissec80e7412017-01-11 05:56:46 -0800722 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000723 }
724 return preference;
725}
726
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000727// Get ip and port of the default destination from the |candidates| with the
728// given value of |component_id|. The default candidate should be the one most
729// likely to work, typically IPv4 relay.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000730// RFC 5245
731// The value of |component_id| currently supported are 1 (RTP) and 2 (RTCP).
Steve Anton36b29d12017-10-30 09:57:42 -0700732// TODO(deadbeef): Decide the default destination in webrtcsession and
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000733// pass it down via SessionDescription.
Yves Gerey665174f2018-06-19 15:03:05 +0200734static void GetDefaultDestination(const std::vector<Candidate>& candidates,
735 int component_id,
736 std::string* port,
737 std::string* ip,
738 std::string* addr_type) {
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000739 *addr_type = kConnectionIpv4Addrtype;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000740 *port = kDummyPort;
741 *ip = kDummyAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000742 int current_preference = kPreferenceUnknown;
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000743 int current_family = AF_UNSPEC;
Steve Anton4daf66e2018-09-07 14:55:53 -0700744 for (const Candidate& candidate : candidates) {
745 if (candidate.component() != component_id) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000746 continue;
747 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000748 // Default destination should be UDP only.
Steve Anton4daf66e2018-09-07 14:55:53 -0700749 if (candidate.protocol() != cricket::UDP_PROTOCOL_NAME) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000750 continue;
751 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700752 const int preference = GetCandidatePreferenceFromType(candidate.type());
753 const int family = candidate.address().ipaddr().family();
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000754 // See if this candidate is more preferable then the current one if it's the
755 // same family. Or if the current family is IPv4 already so we could safely
756 // ignore all IPv6 ones. WebRTC bug 4269.
757 // http://code.google.com/p/webrtc/issues/detail?id=4269
758 if ((preference <= current_preference && current_family == family) ||
759 (current_family == AF_INET && family == AF_INET6)) {
760 continue;
761 }
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000762 if (family == AF_INET) {
763 addr_type->assign(kConnectionIpv4Addrtype);
764 } else if (family == AF_INET6) {
765 addr_type->assign(kConnectionIpv6Addrtype);
766 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000767 current_preference = preference;
768 current_family = family;
Steve Anton4daf66e2018-09-07 14:55:53 -0700769 *port = candidate.address().PortAsString();
770 *ip = candidate.address().ipaddr().ToString();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000771 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000772}
773
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000774// Gets "a=rtcp" line if found default RTCP candidate from |candidates|.
775static std::string GetRtcpLine(const std::vector<Candidate>& candidates) {
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000776 std::string rtcp_line, rtcp_port, rtcp_ip, addr_type;
Yves Gerey665174f2018-06-19 15:03:05 +0200777 GetDefaultDestination(candidates, ICE_CANDIDATE_COMPONENT_RTCP, &rtcp_port,
778 &rtcp_ip, &addr_type);
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000779 // Found default RTCP candidate.
780 // RFC 5245
781 // If the agent is utilizing RTCP, it MUST encode the RTCP candidate
782 // using the a=rtcp attribute as defined in RFC 3605.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000783
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000784 // RFC 3605
785 // rtcp-attribute = "a=rtcp:" port [nettype space addrtype space
786 // connection-address] CRLF
Jonas Olssonec9e4922018-09-05 09:53:49 +0200787 rtc::StringBuilder os;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000788 InitAttrLine(kAttributeRtcp, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200789 os << kSdpDelimiterColon << rtcp_port << " " << kConnectionNettype << " "
790 << addr_type << " " << rtcp_ip;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000791 rtcp_line = os.str();
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000792 return rtcp_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000793}
794
795// Get candidates according to the mline index from SessionDescriptionInterface.
796static void GetCandidatesByMindex(const SessionDescriptionInterface& desci,
797 int mline_index,
798 std::vector<Candidate>* candidates) {
799 if (!candidates) {
800 return;
801 }
802 const IceCandidateCollection* cc = desci.candidates(mline_index);
803 for (size_t i = 0; i < cc->count(); ++i) {
804 const IceCandidateInterface* candidate = cc->at(i);
805 candidates->push_back(candidate->candidate());
806 }
807}
808
deadbeef90f1e1e2017-02-10 12:35:05 -0800809static bool IsValidPort(int port) {
810 return port >= 0 && port <= 65535;
811}
812
Steve Antone831b8c2018-02-01 12:22:16 -0800813std::string SdpSerialize(const JsepSessionDescription& jdesc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000814 const cricket::SessionDescription* desc = jdesc.description();
815 if (!desc) {
816 return "";
817 }
818
819 std::string message;
820
821 // Session Description.
822 AddLine(kSessionVersion, &message);
823 // Session Origin
824 // RFC 4566
825 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
826 // <unicast-address>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200827 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000828 InitLine(kLineTypeOrigin, kSessionOriginUsername, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200829 const std::string& session_id =
830 jdesc.session_id().empty() ? kSessionOriginSessionId : jdesc.session_id();
831 const std::string& session_version = jdesc.session_version().empty()
832 ? kSessionOriginSessionVersion
833 : jdesc.session_version();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000834 os << " " << session_id << " " << session_version << " "
835 << kSessionOriginNettype << " " << kSessionOriginAddrtype << " "
836 << kSessionOriginAddress;
837 AddLine(os.str(), &message);
838 AddLine(kSessionName, &message);
839
840 // Time Description.
841 AddLine(kTimeDescription, &message);
842
843 // Group
844 if (desc->HasGroup(cricket::GROUP_TYPE_BUNDLE)) {
845 std::string group_line = kAttrGroup;
846 const cricket::ContentGroup* group =
847 desc->GetGroupByName(cricket::GROUP_TYPE_BUNDLE);
nisseede5da42017-01-12 05:15:36 -0800848 RTC_DCHECK(group != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700849 for (const std::string& content_name : group->content_names()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000850 group_line.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -0700851 group_line.append(content_name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000852 }
853 AddLine(group_line, &message);
854 }
855
Johannes Kron0854eb62018-10-10 22:33:20 +0200856 // Mixed one- and two-byte header extension.
857 if (desc->mixed_one_two_byte_header_extensions_supported()) {
858 InitAttrLine(kAttributeExtmapAllowMixed, &os);
859 AddLine(os.str(), &message);
860 }
861
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000862 // MediaStream semantics
863 InitAttrLine(kAttributeMsidSemantics, &os);
864 os << kSdpDelimiterColon << " " << kMediaStreamSemantic;
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000865
Seth Hampson845e8782018-03-02 11:34:10 -0800866 std::set<std::string> media_stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000867 const ContentInfo* audio_content = GetFirstAudioContent(desc);
868 if (audio_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800869 GetMediaStreamIds(audio_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000870
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000871 const ContentInfo* video_content = GetFirstVideoContent(desc);
872 if (video_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800873 GetMediaStreamIds(video_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000874
Steve Anton4daf66e2018-09-07 14:55:53 -0700875 for (const std::string& id : media_stream_ids) {
876 os << " " << id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000877 }
878 AddLine(os.str(), &message);
879
Taylor Brandstetter2f65ec52018-05-24 11:37:28 -0700880 // a=ice-lite
881 //
882 // TODO(deadbeef): It's weird that we need to iterate TransportInfos for
883 // this, when it's a session-level attribute. It really should be moved to a
884 // session-level structure like SessionDescription.
885 for (const cricket::TransportInfo& transport : desc->transport_infos()) {
886 if (transport.description.ice_mode == cricket::ICEMODE_LITE) {
887 InitAttrLine(kAttributeIceLite, &os);
888 AddLine(os.str(), &message);
889 break;
890 }
891 }
892
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000893 // Preserve the order of the media contents.
894 int mline_index = -1;
Steve Anton4daf66e2018-09-07 14:55:53 -0700895 for (const ContentInfo& content : desc->contents()) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000896 std::vector<Candidate> candidates;
897 GetCandidatesByMindex(jdesc, ++mline_index, &candidates);
Steve Anton4daf66e2018-09-07 14:55:53 -0700898 BuildMediaDescription(&content, desc->GetTransportInfoByName(content.name),
899 content.media_description()->type(), candidates,
900 desc->msid_signaling(), &message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000901 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000902 return message;
903}
904
905// Serializes the passed in IceCandidateInterface to a SDP string.
906// candidate - The candidate to be serialized.
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700907std::string SdpSerializeCandidate(const IceCandidateInterface& candidate) {
908 return SdpSerializeCandidate(candidate.candidate());
909}
910
911// Serializes a cricket Candidate.
912std::string SdpSerializeCandidate(const cricket::Candidate& candidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000913 std::string message;
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700914 std::vector<cricket::Candidate> candidates(1, candidate);
honghaiza54a0802015-12-16 18:37:23 -0800915 BuildCandidate(candidates, true, &message);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000916 // From WebRTC draft section 4.8.1.1 candidate-attribute will be
917 // just candidate:<candidate> not a=candidate:<blah>CRLF
nisseede5da42017-01-12 05:15:36 -0800918 RTC_DCHECK(message.find("a=") == 0);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000919 message.erase(0, 2);
nisseede5da42017-01-12 05:15:36 -0800920 RTC_DCHECK(message.find(kLineBreak) == message.size() - 2);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000921 message.resize(message.size() - 2);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000922 return message;
923}
924
925bool SdpDeserialize(const std::string& message,
926 JsepSessionDescription* jdesc,
927 SdpParseError* error) {
928 std::string session_id;
929 std::string session_version;
Peter Thatcher7cbd1882015-09-17 18:54:52 -0700930 TransportDescription session_td("", "");
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000931 RtpHeaderExtensions session_extmaps;
zhihuang38989e52017-03-21 11:04:53 -0700932 rtc::SocketAddress session_connection_addr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000933 cricket::SessionDescription* desc = new cricket::SessionDescription();
934 std::vector<JsepIceCandidate*> candidates;
935 size_t current_pos = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000936
937 // Session Description
938 if (!ParseSessionDescription(message, &current_pos, &session_id,
deadbeefc80741f2015-10-22 13:14:45 -0700939 &session_version, &session_td, &session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700940 &session_connection_addr, desc, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000941 delete desc;
942 return false;
943 }
944
945 // Media Description
deadbeefc80741f2015-10-22 13:14:45 -0700946 if (!ParseMediaDescription(message, session_td, session_extmaps, &current_pos,
zhihuang38989e52017-03-21 11:04:53 -0700947 session_connection_addr, desc, &candidates,
948 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000949 delete desc;
Steve Anton4daf66e2018-09-07 14:55:53 -0700950 for (JsepIceCandidate* candidate : candidates) {
951 delete candidate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000952 }
953 return false;
954 }
955
956 jdesc->Initialize(desc, session_id, session_version);
957
Steve Anton4daf66e2018-09-07 14:55:53 -0700958 for (JsepIceCandidate* candidate : candidates) {
959 jdesc->AddCandidate(candidate);
960 delete candidate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000961 }
962 return true;
963}
964
965bool SdpDeserializeCandidate(const std::string& message,
966 JsepIceCandidate* jcandidate,
967 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -0800968 RTC_DCHECK(jcandidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000969 Candidate candidate;
970 if (!ParseCandidate(message, &candidate, error, true)) {
971 return false;
972 }
973 jcandidate->SetCandidate(candidate);
974 return true;
975}
976
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700977bool SdpDeserializeCandidate(const std::string& transport_name,
978 const std::string& message,
979 cricket::Candidate* candidate,
980 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -0800981 RTC_DCHECK(candidate != nullptr);
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700982 if (!ParseCandidate(message, candidate, error, true)) {
983 return false;
984 }
985 candidate->set_transport_name(transport_name);
986 return true;
987}
988
Yves Gerey665174f2018-06-19 15:03:05 +0200989bool ParseCandidate(const std::string& message,
990 Candidate* candidate,
991 SdpParseError* error,
992 bool is_raw) {
nisseede5da42017-01-12 05:15:36 -0800993 RTC_DCHECK(candidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000994
995 // Get the first line from |message|.
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +0000996 std::string first_line = message;
997 size_t pos = 0;
998 GetLine(message, &pos, &first_line);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000999
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001000 // Makes sure |message| contains only one line.
1001 if (message.size() > first_line.size()) {
1002 std::string left, right;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001003 if (rtc::tokenize_first(message, kNewLineChar, &left, &right) &&
Donald Curtis0e07f922015-05-15 09:21:23 -07001004 !right.empty()) {
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001005 return ParseFailed(message, 0, "Expect one line only", error);
1006 }
1007 }
1008
1009 // From WebRTC draft section 4.8.1.1 candidate-attribute should be
1010 // candidate:<candidate> when trickled, but we still support
1011 // a=candidate:<blah>CRLF for backward compatibility and for parsing a line
1012 // from the SDP.
1013 if (IsLineType(first_line, kLineTypeAttributes)) {
1014 first_line = first_line.substr(kLinePrefixLength);
1015 }
1016
1017 std::string attribute_candidate;
1018 std::string candidate_value;
1019
1020 // |first_line| must be in the form of "candidate:<value>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001021 if (!rtc::tokenize_first(first_line, kSdpDelimiterColonChar,
1022 &attribute_candidate, &candidate_value) ||
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001023 attribute_candidate != kAttributeCandidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001024 if (is_raw) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001025 rtc::StringBuilder description;
Yves Gerey665174f2018-06-19 15:03:05 +02001026 description << "Expect line: " << kAttributeCandidate << ":"
1027 << "<candidate-str>";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001028 return ParseFailed(first_line, 0, description.str(), error);
1029 } else {
1030 return ParseFailedExpectLine(first_line, 0, kLineTypeAttributes,
1031 kAttributeCandidate, error);
1032 }
1033 }
1034
1035 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001036 rtc::split(candidate_value, kSdpDelimiterSpaceChar, &fields);
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001037
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001038 // RFC 5245
1039 // a=candidate:<foundation> <component-id> <transport> <priority>
1040 // <connection-address> <port> typ <candidate-types>
1041 // [raddr <connection-address>] [rport <port>]
1042 // *(SP extension-att-name SP extension-att-value)
1043 const size_t expected_min_fields = 8;
1044 if (fields.size() < expected_min_fields ||
1045 (fields[6] != kAttributeCandidateTyp)) {
1046 return ParseFailedExpectMinFieldNum(first_line, expected_min_fields, error);
1047 }
jbauch083b73f2015-07-16 02:46:32 -07001048 const std::string& foundation = fields[0];
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001049
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001050 int component_id = 0;
1051 if (!GetValueFromString(first_line, fields[1], &component_id, error)) {
1052 return false;
1053 }
jbauch083b73f2015-07-16 02:46:32 -07001054 const std::string& transport = fields[2];
Peter Boström0c4e06b2015-10-07 12:23:21 +02001055 uint32_t priority = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001056 if (!GetValueFromString(first_line, fields[3], &priority, error)) {
1057 return false;
1058 }
jbauch083b73f2015-07-16 02:46:32 -07001059 const std::string& connection_address = fields[4];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001060 int port = 0;
1061 if (!GetValueFromString(first_line, fields[5], &port, error)) {
1062 return false;
1063 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001064 if (!IsValidPort(port)) {
1065 return ParseFailed(first_line, "Invalid port number.", error);
1066 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001067 SocketAddress address(connection_address, port);
1068
1069 cricket::ProtocolType protocol;
hnslb68cc752016-12-13 10:33:41 -08001070 if (!StringToProto(transport.c_str(), &protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001071 return ParseFailed(first_line, "Unsupported transport type.", error);
1072 }
hnslb68cc752016-12-13 10:33:41 -08001073 switch (protocol) {
1074 case cricket::PROTO_UDP:
1075 case cricket::PROTO_TCP:
1076 case cricket::PROTO_SSLTCP:
1077 // Supported protocol.
1078 break;
1079 default:
1080 return ParseFailed(first_line, "Unsupported transport type.", error);
1081 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001082
1083 std::string candidate_type;
jbauch083b73f2015-07-16 02:46:32 -07001084 const std::string& type = fields[7];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001085 if (type == kCandidateHost) {
1086 candidate_type = cricket::LOCAL_PORT_TYPE;
1087 } else if (type == kCandidateSrflx) {
1088 candidate_type = cricket::STUN_PORT_TYPE;
1089 } else if (type == kCandidateRelay) {
1090 candidate_type = cricket::RELAY_PORT_TYPE;
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001091 } else if (type == kCandidatePrflx) {
1092 candidate_type = cricket::PRFLX_PORT_TYPE;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001093 } else {
1094 return ParseFailed(first_line, "Unsupported candidate type.", error);
1095 }
1096
1097 size_t current_position = expected_min_fields;
1098 SocketAddress related_address;
1099 // The 2 optional fields for related address
1100 // [raddr <connection-address>] [rport <port>]
1101 if (fields.size() >= (current_position + 2) &&
1102 fields[current_position] == kAttributeCandidateRaddr) {
1103 related_address.SetIP(fields[++current_position]);
1104 ++current_position;
1105 }
1106 if (fields.size() >= (current_position + 2) &&
1107 fields[current_position] == kAttributeCandidateRport) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001108 int port = 0;
Yves Gerey665174f2018-06-19 15:03:05 +02001109 if (!GetValueFromString(first_line, fields[++current_position], &port,
1110 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001111 return false;
1112 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001113 if (!IsValidPort(port)) {
1114 return ParseFailed(first_line, "Invalid port number.", error);
1115 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001116 related_address.SetPort(port);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001117 ++current_position;
1118 }
1119
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001120 // If this is a TCP candidate, it has additional extension as defined in
1121 // RFC 6544.
1122 std::string tcptype;
1123 if (fields.size() >= (current_position + 2) &&
1124 fields[current_position] == kTcpCandidateType) {
1125 tcptype = fields[++current_position];
1126 ++current_position;
1127
1128 if (tcptype != cricket::TCPTYPE_ACTIVE_STR &&
1129 tcptype != cricket::TCPTYPE_PASSIVE_STR &&
1130 tcptype != cricket::TCPTYPE_SIMOPEN_STR) {
1131 return ParseFailed(first_line, "Invalid TCP candidate type.", error);
1132 }
1133
1134 if (protocol != cricket::PROTO_TCP) {
1135 return ParseFailed(first_line, "Invalid non-TCP candidate", error);
1136 }
1137 }
1138
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001139 // Extension
honghaiza54a0802015-12-16 18:37:23 -08001140 // Though non-standard, we support the ICE ufrag and pwd being signaled on
1141 // the candidate to avoid issues with confusing which generation a candidate
1142 // belongs to when trickling multiple generations at the same time.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001143 std::string username;
1144 std::string password;
Peter Boström0c4e06b2015-10-07 12:23:21 +02001145 uint32_t generation = 0;
honghaiza0c44ea2016-03-23 16:07:48 -07001146 uint16_t network_id = 0;
1147 uint16_t network_cost = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001148 for (size_t i = current_position; i + 1 < fields.size(); ++i) {
1149 // RFC 5245
1150 // *(SP extension-att-name SP extension-att-value)
1151 if (fields[i] == kAttributeCandidateGeneration) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001152 if (!GetValueFromString(first_line, fields[++i], &generation, error)) {
1153 return false;
1154 }
honghaiza54a0802015-12-16 18:37:23 -08001155 } else if (fields[i] == kAttributeCandidateUfrag) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001156 username = fields[++i];
honghaiza54a0802015-12-16 18:37:23 -08001157 } else if (fields[i] == kAttributeCandidatePwd) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001158 password = fields[++i];
honghaiza0c44ea2016-03-23 16:07:48 -07001159 } else if (fields[i] == kAttributeCandidateNetworkId) {
1160 if (!GetValueFromString(first_line, fields[++i], &network_id, error)) {
1161 return false;
1162 }
honghaize1a0c942016-02-16 14:54:56 -08001163 } else if (fields[i] == kAttributeCandidateNetworkCost) {
1164 if (!GetValueFromString(first_line, fields[++i], &network_cost, error)) {
1165 return false;
1166 }
Honghai Zhang351d77b2016-05-20 15:08:29 -07001167 network_cost = std::min(network_cost, rtc::kNetworkCostMax);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001168 } else {
1169 // Skip the unknown extension.
1170 ++i;
1171 }
1172 }
1173
guoweis@webrtc.org61c12472015-01-15 06:53:07 +00001174 *candidate = Candidate(component_id, cricket::ProtoToString(protocol),
guoweis@webrtc.org950c5182014-12-16 23:01:31 +00001175 address, priority, username, password, candidate_type,
honghaiza0c44ea2016-03-23 16:07:48 -07001176 generation, foundation, network_id, network_cost);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001177 candidate->set_related_address(related_address);
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001178 candidate->set_tcptype(tcptype);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001179 return true;
1180}
1181
1182bool ParseIceOptions(const std::string& line,
1183 std::vector<std::string>* transport_options,
1184 SdpParseError* error) {
1185 std::string ice_options;
1186 if (!GetValue(line, kAttributeIceOption, &ice_options, error)) {
1187 return false;
1188 }
1189 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001190 rtc::split(ice_options, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001191 for (size_t i = 0; i < fields.size(); ++i) {
1192 transport_options->push_back(fields[i]);
1193 }
1194 return true;
1195}
1196
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001197bool ParseSctpPort(const std::string& line,
1198 int* sctp_port,
1199 SdpParseError* error) {
1200 // draft-ietf-mmusic-sctp-sdp-07
1201 // a=sctp-port
1202 std::vector<std::string> fields;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001203 const size_t expected_min_fields = 2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001204 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
lally69f57602015-10-08 10:15:04 -07001205 if (fields.size() < expected_min_fields) {
1206 fields.resize(0);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001207 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
lally69f57602015-10-08 10:15:04 -07001208 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001209 if (fields.size() < expected_min_fields) {
1210 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1211 }
1212 if (!rtc::FromString(fields[1], sctp_port)) {
lally69f57602015-10-08 10:15:04 -07001213 return ParseFailed(line, "Invalid sctp port value.", error);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001214 }
1215 return true;
1216}
1217
isheriff6f8d6862016-05-26 11:24:55 -07001218bool ParseExtmap(const std::string& line,
1219 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001220 SdpParseError* error) {
1221 // RFC 5285
1222 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1223 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001224 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001225 const size_t expected_min_fields = 2;
1226 if (fields.size() < expected_min_fields) {
1227 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1228 }
1229 std::string uri = fields[1];
1230
1231 std::string value_direction;
1232 if (!GetValue(fields[0], kAttributeExtmap, &value_direction, error)) {
1233 return false;
1234 }
1235 std::vector<std::string> sub_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001236 rtc::split(value_direction, kSdpDelimiterSlashChar, &sub_fields);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001237 int value = 0;
1238 if (!GetValueFromString(line, sub_fields[0], &value, error)) {
1239 return false;
1240 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001241
jbauch5869f502017-06-29 12:31:36 -07001242 bool encrypted = false;
1243 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1244 // RFC 6904
Steve Anton36b29d12017-10-30 09:57:42 -07001245 // a=extmap:<value["/"<direction>] urn:ietf:params:rtp-hdrext:encrypt <URI>
1246 // <extensionattributes>
jbauch5869f502017-06-29 12:31:36 -07001247 const size_t expected_min_fields_encrypted = expected_min_fields + 1;
1248 if (fields.size() < expected_min_fields_encrypted) {
1249 return ParseFailedExpectMinFieldNum(line, expected_min_fields_encrypted,
Yves Gerey665174f2018-06-19 15:03:05 +02001250 error);
jbauch5869f502017-06-29 12:31:36 -07001251 }
1252
1253 encrypted = true;
1254 uri = fields[2];
1255 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1256 return ParseFailed(line, "Recursive encrypted header.", error);
1257 }
1258 }
1259
1260 *extmap = RtpExtension(uri, value, encrypted);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001261 return true;
1262}
1263
1264void BuildMediaDescription(const ContentInfo* content_info,
1265 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001266 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001267 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -08001268 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001269 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001270 RTC_DCHECK(message != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001271 if (content_info == NULL || message == NULL) {
1272 return;
1273 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001274 rtc::StringBuilder os;
Steve Antonb1c1de12017-12-21 15:14:30 -08001275 const MediaContentDescription* media_desc = content_info->media_description();
1276 RTC_DCHECK(media_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001277
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001278 int sctp_port = cricket::kSctpDefaultPort;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001279
1280 // RFC 4566
1281 // m=<media> <port> <proto> <fmt>
1282 // fmt is a list of payload type numbers that MAY be used in the session.
1283 const char* type = NULL;
1284 if (media_type == cricket::MEDIA_TYPE_AUDIO)
1285 type = kMediaTypeAudio;
1286 else if (media_type == cricket::MEDIA_TYPE_VIDEO)
1287 type = kMediaTypeVideo;
1288 else if (media_type == cricket::MEDIA_TYPE_DATA)
1289 type = kMediaTypeData;
1290 else
nissec80e7412017-01-11 05:56:46 -08001291 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001292
1293 std::string fmt;
1294 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001295 const VideoContentDescription* video_desc = media_desc->as_video();
Steve Anton4daf66e2018-09-07 14:55:53 -07001296 for (const cricket::VideoCodec& codec : video_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001297 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001298 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001299 }
1300 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001301 const AudioContentDescription* audio_desc = media_desc->as_audio();
Steve Anton4daf66e2018-09-07 14:55:53 -07001302 for (const cricket::AudioCodec& codec : audio_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001303 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001304 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001305 }
1306 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001307 const DataContentDescription* data_desc = media_desc->as_data();
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001308 if (IsDtlsSctp(media_desc->protocol())) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001309 fmt.append(" ");
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001310
zstein4b2e0822017-02-17 19:48:38 -08001311 if (data_desc->use_sctpmap()) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001312 for (const cricket::DataCodec& codec : data_desc->codecs()) {
1313 if (cricket::CodecNamesEq(codec.name,
zstein4b2e0822017-02-17 19:48:38 -08001314 cricket::kGoogleSctpDataCodecName) &&
Steve Anton4daf66e2018-09-07 14:55:53 -07001315 codec.GetParam(cricket::kCodecParamPort, &sctp_port)) {
zstein4b2e0822017-02-17 19:48:38 -08001316 break;
1317 }
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001318 }
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001319
Jonas Olsson6b1985d2018-07-05 11:59:48 +02001320 fmt.append(rtc::ToString(sctp_port));
zstein4b2e0822017-02-17 19:48:38 -08001321 } else {
1322 fmt.append(kDefaultSctpmapProtocol);
1323 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001324 } else {
Steve Anton4daf66e2018-09-07 14:55:53 -07001325 for (const cricket::DataCodec& codec : data_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001326 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001327 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001328 }
1329 }
1330 }
1331 // The fmt must never be empty. If no codecs are found, set the fmt attribute
1332 // to 0.
1333 if (fmt.empty()) {
1334 fmt = " 0";
1335 }
1336
deadbeef25ed4352016-12-12 18:37:36 -08001337 // The port number in the m line will be updated later when associated with
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001338 // the candidates.
deadbeef25ed4352016-12-12 18:37:36 -08001339 //
1340 // A port value of 0 indicates that the m= section is rejected.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001341 // RFC 3264
1342 // To reject an offered stream, the port number in the corresponding stream in
1343 // the answer MUST be set to zero.
deadbeef25ed4352016-12-12 18:37:36 -08001344 //
1345 // However, the BUNDLE draft adds a new meaning to port zero, when used along
1346 // with a=bundle-only.
zhihuang38989e52017-03-21 11:04:53 -07001347 std::string port = kDummyPort;
1348 if (content_info->rejected || content_info->bundle_only) {
1349 port = kMediaPortRejected;
1350 } else if (!media_desc->connection_address().IsNil()) {
1351 port = rtc::ToString(media_desc->connection_address().port());
1352 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001353
Yves Gerey665174f2018-06-19 15:03:05 +02001354 rtc::SSLFingerprint* fp =
1355 (transport_info) ? transport_info->description.identity_fingerprint.get()
1356 : NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001357
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001358 // Add the m and c lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001359 InitLine(kLineTypeMedia, type, &os);
1360 os << " " << port << " " << media_desc->protocol() << fmt;
zhihuang38989e52017-03-21 11:04:53 -07001361 AddLine(os.str(), message);
1362
1363 InitLine(kLineTypeConnection, kConnectionNettype, &os);
1364 if (media_desc->connection_address().IsNil()) {
1365 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
1366 } else if (media_desc->connection_address().family() == AF_INET) {
1367 os << " " << kConnectionIpv4Addrtype << " "
1368 << media_desc->connection_address().ipaddr().ToString();
1369 } else {
1370 os << " " << kConnectionIpv6Addrtype << " "
1371 << media_desc->connection_address().ipaddr().ToString();
1372 }
1373 AddLine(os.str(), message);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001374
1375 // RFC 4566
1376 // b=AS:<bandwidth>
Peter Thatcherc0c3a862015-06-24 15:31:25 -07001377 if (media_desc->bandwidth() >= 1000) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001378 InitLine(kLineTypeSessionBandwidth, kApplicationSpecificMaximum, &os);
1379 os << kSdpDelimiterColon << (media_desc->bandwidth() / 1000);
1380 AddLine(os.str(), message);
1381 }
1382
deadbeef25ed4352016-12-12 18:37:36 -08001383 // Add the a=bundle-only line.
1384 if (content_info->bundle_only) {
1385 InitAttrLine(kAttributeBundleOnly, &os);
1386 AddLine(os.str(), message);
1387 }
1388
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001389 // Add the a=rtcp line.
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001390 if (IsRtp(media_desc->protocol())) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001391 std::string rtcp_line = GetRtcpLine(candidates);
1392 if (!rtcp_line.empty()) {
1393 AddLine(rtcp_line, message);
1394 }
1395 }
1396
honghaiza54a0802015-12-16 18:37:23 -08001397 // Build the a=candidate lines. We don't include ufrag and pwd in the
1398 // candidates in the SDP to avoid redundancy.
1399 BuildCandidate(candidates, false, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001400
1401 // Use the transport_info to build the media level ice-ufrag and ice-pwd.
1402 if (transport_info) {
1403 // RFC 5245
1404 // ice-pwd-att = "ice-pwd" ":" password
1405 // ice-ufrag-att = "ice-ufrag" ":" ufrag
1406 // ice-ufrag
deadbeef3f7219b2015-12-28 15:17:14 -08001407 if (!transport_info->description.ice_ufrag.empty()) {
1408 InitAttrLine(kAttributeIceUfrag, &os);
1409 os << kSdpDelimiterColon << transport_info->description.ice_ufrag;
1410 AddLine(os.str(), message);
1411 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001412 // ice-pwd
deadbeef3f7219b2015-12-28 15:17:14 -08001413 if (!transport_info->description.ice_pwd.empty()) {
1414 InitAttrLine(kAttributeIcePwd, &os);
1415 os << kSdpDelimiterColon << transport_info->description.ice_pwd;
1416 AddLine(os.str(), message);
1417 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001418
1419 // draft-petithuguenin-mmusic-ice-attributes-level-03
1420 BuildIceOptions(transport_info->description.transport_options, message);
1421
1422 // RFC 4572
1423 // fingerprint-attribute =
1424 // "fingerprint" ":" hash-func SP fingerprint
1425 if (fp) {
1426 // Insert the fingerprint attribute.
1427 InitAttrLine(kAttributeFingerprint, &os);
Yves Gerey665174f2018-06-19 15:03:05 +02001428 os << kSdpDelimiterColon << fp->algorithm << kSdpDelimiterSpace
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001429 << fp->GetRfc4572Fingerprint();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001430 AddLine(os.str(), message);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001431
1432 // Inserting setup attribute.
1433 if (transport_info->description.connection_role !=
Yves Gerey665174f2018-06-19 15:03:05 +02001434 cricket::CONNECTIONROLE_NONE) {
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001435 // Making sure we are not using "passive" mode.
1436 cricket::ConnectionRole role =
1437 transport_info->description.connection_role;
mallinath@webrtc.org19f27e62013-10-13 17:18:27 +00001438 std::string dtls_role_str;
nissec16fa5e2017-02-07 07:18:43 -08001439 const bool success =
1440 cricket::ConnectionRoleToString(role, &dtls_role_str);
1441 RTC_DCHECK(success);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001442 InitAttrLine(kAttributeSetup, &os);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001443 os << kSdpDelimiterColon << dtls_role_str;
1444 AddLine(os.str(), message);
1445 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001446 }
1447 }
1448
1449 // RFC 3388
1450 // mid-attribute = "a=mid:" identification-tag
1451 // identification-tag = token
1452 // Use the content name as the mid identification-tag.
1453 InitAttrLine(kAttributeMid, &os);
1454 os << kSdpDelimiterColon << content_info->name;
1455 AddLine(os.str(), message);
1456
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001457 if (IsDtlsSctp(media_desc->protocol())) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001458 const DataContentDescription* data_desc = media_desc->as_data();
zstein4b2e0822017-02-17 19:48:38 -08001459 bool use_sctpmap = data_desc->use_sctpmap();
1460 BuildSctpContentAttributes(message, sctp_port, use_sctpmap);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001461 } else if (IsRtp(media_desc->protocol())) {
Steve Antone831b8c2018-02-01 12:22:16 -08001462 BuildRtpContentAttributes(media_desc, media_type, msid_signaling, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001463 }
1464}
1465
zstein4b2e0822017-02-17 19:48:38 -08001466void BuildSctpContentAttributes(std::string* message,
1467 int sctp_port,
1468 bool use_sctpmap) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001469 rtc::StringBuilder os;
zstein4b2e0822017-02-17 19:48:38 -08001470 if (use_sctpmap) {
1471 // draft-ietf-mmusic-sctp-sdp-04
1472 // a=sctpmap:sctpmap-number protocol [streams]
1473 InitAttrLine(kAttributeSctpmap, &os);
1474 os << kSdpDelimiterColon << sctp_port << kSdpDelimiterSpace
1475 << kDefaultSctpmapProtocol << kSdpDelimiterSpace
1476 << cricket::kMaxSctpStreams;
1477 } else {
1478 // draft-ietf-mmusic-sctp-sdp-23
1479 // a=sctp-port:<port>
1480 InitAttrLine(kAttributeSctpPort, &os);
1481 os << kSdpDelimiterColon << sctp_port;
1482 // TODO(zstein): emit max-message-size here
1483 }
wu@webrtc.org78187522013-10-07 23:32:02 +00001484 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001485}
1486
deadbeef9d3584c2016-02-16 17:54:10 -08001487void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001488 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -08001489 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -08001490 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001491 rtc::StringBuilder os;
Johannes Kron0854eb62018-10-10 22:33:20 +02001492 // RFC 8285
1493 // a=extmap-allow-mixed
1494 // The attribute MUST be either on session level or media level. We support
1495 // responding on both levels, however, we don't respond on media level if it's
1496 // set on session level.
1497 if (media_desc->mixed_one_two_byte_header_extensions_supported() ==
1498 MediaContentDescription::kMedia) {
1499 InitAttrLine(kAttributeExtmapAllowMixed, &os);
1500 AddLine(os.str(), message);
1501 }
1502 // RFC 8285
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001503 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1504 // The definitions MUST be either all session level or all media level. This
1505 // implementation uses all media level.
1506 for (size_t i = 0; i < media_desc->rtp_header_extensions().size(); ++i) {
jbauch5869f502017-06-29 12:31:36 -07001507 const RtpExtension& extension = media_desc->rtp_header_extensions()[i];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001508 InitAttrLine(kAttributeExtmap, &os);
jbauch5869f502017-06-29 12:31:36 -07001509 os << kSdpDelimiterColon << extension.id;
1510 if (extension.encrypt) {
1511 os << kSdpDelimiterSpace << RtpExtension::kEncryptHeaderExtensionsUri;
1512 }
1513 os << kSdpDelimiterSpace << extension.uri;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001514 AddLine(os.str(), message);
1515 }
1516
1517 // RFC 3264
1518 // a=sendrecv || a=sendonly || a=sendrecv || a=inactive
deadbeefc80741f2015-10-22 13:14:45 -07001519 switch (media_desc->direction()) {
Steve Anton4e70a722017-11-28 14:57:10 -08001520 case RtpTransceiverDirection::kInactive:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001521 InitAttrLine(kAttributeInactive, &os);
1522 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001523 case RtpTransceiverDirection::kSendOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001524 InitAttrLine(kAttributeSendOnly, &os);
1525 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001526 case RtpTransceiverDirection::kRecvOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001527 InitAttrLine(kAttributeRecvOnly, &os);
1528 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001529 case RtpTransceiverDirection::kSendRecv:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001530 default:
1531 InitAttrLine(kAttributeSendRecv, &os);
1532 break;
1533 }
1534 AddLine(os.str(), message);
1535
Seth Hampson5b4f0752018-04-02 16:31:36 -07001536 // Specified in https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
1537 // a=msid:<msid-id> <msid-appdata>
1538 // The msid-id is a 1*64 token char representing the media stream id, and the
1539 // msid-appdata is a 1*64 token char representing the track id. There is a
1540 // line for every media stream, with a special msid-id value of "-"
1541 // representing no streams. The value of "msid-appdata" MUST be identical for
1542 // all lines.
Steve Antone831b8c2018-02-01 12:22:16 -08001543 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
1544 const StreamParamsVec& streams = media_desc->streams();
1545 if (streams.size() == 1u) {
1546 const StreamParams& track = streams[0];
Seth Hampson5b4f0752018-04-02 16:31:36 -07001547 std::vector<std::string> stream_ids = track.stream_ids();
1548 if (stream_ids.empty()) {
1549 stream_ids.push_back(kNoStreamMsid);
1550 }
1551 for (const std::string& stream_id : stream_ids) {
1552 InitAttrLine(kAttributeMsid, &os);
1553 os << kSdpDelimiterColon << stream_id << kSdpDelimiterSpace << track.id;
1554 AddLine(os.str(), message);
1555 }
Steve Antone831b8c2018-02-01 12:22:16 -08001556 } else if (streams.size() > 1u) {
1557 RTC_LOG(LS_WARNING)
1558 << "Trying to serialize Unified Plan SDP with more than "
Jonas Olsson45cc8902018-02-13 10:37:07 +01001559 "one track in a media section. Omitting 'a=msid'.";
deadbeef9d3584c2016-02-16 17:54:10 -08001560 }
1561 }
1562
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001563 // RFC 5761
1564 // a=rtcp-mux
1565 if (media_desc->rtcp_mux()) {
1566 InitAttrLine(kAttributeRtcpMux, &os);
1567 AddLine(os.str(), message);
1568 }
1569
deadbeef13871492015-12-09 12:37:51 -08001570 // RFC 5506
1571 // a=rtcp-rsize
1572 if (media_desc->rtcp_reduced_size()) {
1573 InitAttrLine(kAttributeRtcpReducedSize, &os);
1574 AddLine(os.str(), message);
1575 }
1576
deadbeefd45aea82017-09-16 01:24:29 -07001577 if (media_desc->conference_mode()) {
1578 InitAttrLine(kAttributeXGoogleFlag, &os);
1579 os << kSdpDelimiterColon << kValueConference;
1580 AddLine(os.str(), message);
1581 }
1582
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001583 // RFC 4568
1584 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001585 for (const CryptoParams& crypto_params : media_desc->cryptos()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001586 InitAttrLine(kAttributeCrypto, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001587 os << kSdpDelimiterColon << crypto_params.tag << " "
1588 << crypto_params.cipher_suite << " " << crypto_params.key_params;
1589 if (!crypto_params.session_params.empty()) {
1590 os << " " << crypto_params.session_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001591 }
1592 AddLine(os.str(), message);
1593 }
1594
1595 // RFC 4566
1596 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1597 // [/<encodingparameters>]
1598 BuildRtpMap(media_desc, media_type, message);
1599
Steve Anton4daf66e2018-09-07 14:55:53 -07001600 for (const StreamParams& track : media_desc->streams()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001601 // Build the ssrc-group lines.
Steve Anton4daf66e2018-09-07 14:55:53 -07001602 for (const SsrcGroup& ssrc_group : track.ssrc_groups) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001603 // RFC 5576
1604 // a=ssrc-group:<semantics> <ssrc-id> ...
Steve Anton4daf66e2018-09-07 14:55:53 -07001605 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001606 continue;
1607 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001608 InitAttrLine(kAttributeSsrcGroup, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001609 os << kSdpDelimiterColon << ssrc_group.semantics;
1610 for (uint32_t ssrc : ssrc_group.ssrcs) {
1611 os << kSdpDelimiterSpace << rtc::ToString(ssrc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001612 }
1613 AddLine(os.str(), message);
1614 }
1615 // Build the ssrc lines for each ssrc.
Steve Anton4daf66e2018-09-07 14:55:53 -07001616 for (uint32_t ssrc : track.ssrcs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001617 // RFC 5576
1618 // a=ssrc:<ssrc-id> cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07001619 AddSsrcLine(ssrc, kSsrcAttributeCname, track.cname, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001620
Steve Antone831b8c2018-02-01 12:22:16 -08001621 if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
1622 // draft-alvestrand-mmusic-msid-00
1623 // a=ssrc:<ssrc-id> msid:identifier [appdata]
1624 // The appdata consists of the "id" attribute of a MediaStreamTrack,
1625 // which corresponds to the "id" attribute of StreamParams.
Seth Hampson5b4f0752018-04-02 16:31:36 -07001626 // Since a=ssrc msid signaling is used in Plan B SDP semantics, and
1627 // multiple stream ids are not supported for Plan B, we are only adding
1628 // a line for the first media stream id here.
Steve Anton4daf66e2018-09-07 14:55:53 -07001629 const std::string& stream_id = track.first_stream_id();
Steve Antone831b8c2018-02-01 12:22:16 -08001630 InitAttrLine(kAttributeSsrc, &os);
1631 os << kSdpDelimiterColon << ssrc << kSdpDelimiterSpace
1632 << kSsrcAttributeMsid << kSdpDelimiterColon << stream_id
Steve Anton4daf66e2018-09-07 14:55:53 -07001633 << kSdpDelimiterSpace << track.id;
Steve Antone831b8c2018-02-01 12:22:16 -08001634 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001635
Steve Antone831b8c2018-02-01 12:22:16 -08001636 // TODO(ronghuawu): Remove below code which is for backward
1637 // compatibility.
1638 // draft-alvestrand-rtcweb-mid-01
1639 // a=ssrc:<ssrc-id> mslabel:<value>
1640 // The label isn't yet defined.
1641 // a=ssrc:<ssrc-id> label:<value>
Seth Hampson5b4f0752018-04-02 16:31:36 -07001642 AddSsrcLine(ssrc, kSsrcAttributeMslabel, stream_id, message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001643 AddSsrcLine(ssrc, kSSrcAttributeLabel, track.id, message);
Steve Antone831b8c2018-02-01 12:22:16 -08001644 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001645 }
1646 }
1647}
1648
Jonas Olssonec9e4922018-09-05 09:53:49 +02001649void WriteFmtpHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001650 // fmtp header: a=fmtp:|payload_type| <parameters>
1651 // Add a=fmtp
1652 InitAttrLine(kAttributeFmtp, os);
1653 // Add :|payload_type|
1654 *os << kSdpDelimiterColon << payload_type;
1655}
1656
Jonas Olssonec9e4922018-09-05 09:53:49 +02001657void WriteRtcpFbHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001658 // rtcp-fb header: a=rtcp-fb:|payload_type|
1659 // <parameters>/<ccm <ccm_parameters>>
1660 // Add a=rtcp-fb
1661 InitAttrLine(kAttributeRtcpFb, os);
1662 // Add :
1663 *os << kSdpDelimiterColon;
1664 if (payload_type == kWildcardPayloadType) {
1665 *os << "*";
1666 } else {
1667 *os << payload_type;
1668 }
1669}
1670
1671void WriteFmtpParameter(const std::string& parameter_name,
1672 const std::string& parameter_value,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001673 rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001674 // fmtp parameters: |parameter_name|=|parameter_value|
1675 *os << parameter_name << kSdpDelimiterEqual << parameter_value;
1676}
1677
1678void WriteFmtpParameters(const cricket::CodecParameterMap& parameters,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001679 rtc::StringBuilder* os) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001680 bool first = true;
1681 for (const auto& entry : parameters) {
1682 const std::string& key = entry.first;
1683 const std::string& value = entry.second;
hta62a216e2016-04-15 11:02:14 -07001684 // Parameters are a semicolon-separated list, no spaces.
1685 // The list is separated from the header by a space.
Steve Anton4daf66e2018-09-07 14:55:53 -07001686 if (first) {
hta62a216e2016-04-15 11:02:14 -07001687 *os << kSdpDelimiterSpace;
Steve Anton4daf66e2018-09-07 14:55:53 -07001688 first = false;
hta62a216e2016-04-15 11:02:14 -07001689 } else {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001690 *os << kSdpDelimiterSemicolon;
1691 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001692 WriteFmtpParameter(key, value, os);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001693 }
1694}
1695
1696bool IsFmtpParam(const std::string& name) {
ossuaa4b0772017-01-30 07:41:18 -08001697 // RFC 4855, section 3 specifies the mapping of media format parameters to SDP
1698 // parameters. Only ptime, maxptime, channels and rate are placed outside of
1699 // the fmtp line. In WebRTC, channels and rate are already handled separately
1700 // and thus not included in the CodecParameterMap.
1701 return name != kCodecParamPTime && name != kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001702}
1703
1704// Retreives fmtp parameters from |params|, which may contain other parameters
1705// as well, and puts them in |fmtp_parameters|.
1706void GetFmtpParams(const cricket::CodecParameterMap& params,
1707 cricket::CodecParameterMap* fmtp_parameters) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001708 for (const auto& entry : params) {
1709 const std::string& key = entry.first;
1710 const std::string& value = entry.second;
1711 if (IsFmtpParam(key)) {
1712 (*fmtp_parameters)[key] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001713 }
1714 }
1715}
1716
1717template <class T>
1718void AddFmtpLine(const T& codec, std::string* message) {
1719 cricket::CodecParameterMap fmtp_parameters;
1720 GetFmtpParams(codec.params, &fmtp_parameters);
1721 if (fmtp_parameters.empty()) {
1722 // No need to add an fmtp if it will have no (optional) parameters.
1723 return;
1724 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001725 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001726 WriteFmtpHeader(codec.id, &os);
1727 WriteFmtpParameters(fmtp_parameters, &os);
1728 AddLine(os.str(), message);
1729 return;
1730}
1731
1732template <class T>
1733void AddRtcpFbLines(const T& codec, std::string* message) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001734 for (const cricket::FeedbackParam& param : codec.feedback_params.params()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001735 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001736 WriteRtcpFbHeader(codec.id, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001737 os << " " << param.id();
1738 if (!param.param().empty()) {
1739 os << " " << param.param();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001740 }
1741 AddLine(os.str(), message);
1742 }
1743}
1744
Yves Gerey665174f2018-06-19 15:03:05 +02001745bool AddSctpDataCodec(DataContentDescription* media_desc, int sctp_port) {
solenberg9fa49752016-10-08 13:02:44 -07001746 for (const auto& codec : media_desc->codecs()) {
1747 if (cricket::CodecNamesEq(codec.name, cricket::kGoogleSctpDataCodecName)) {
Yves Gerey665174f2018-06-19 15:03:05 +02001748 return ParseFailed("", "Can't have multiple sctp port attributes.", NULL);
solenberg9fa49752016-10-08 13:02:44 -07001749 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001750 }
1751 // Add the SCTP Port number as a pseudo-codec "port" parameter
solenberg9fa49752016-10-08 13:02:44 -07001752 cricket::DataCodec codec_port(cricket::kGoogleSctpDataCodecPlType,
deadbeef67cf2c12016-04-13 10:07:16 -07001753 cricket::kGoogleSctpDataCodecName);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001754 codec_port.SetParam(cricket::kCodecParamPort, sctp_port);
Mirko Bonadei675513b2017-11-09 11:09:25 +01001755 RTC_LOG(INFO) << "AddSctpDataCodec: Got SCTP Port Number " << sctp_port;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001756 media_desc->AddCodec(codec_port);
1757 return true;
1758}
1759
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001760bool GetMinValue(const std::vector<int>& values, int* value) {
1761 if (values.empty()) {
1762 return false;
1763 }
1764 std::vector<int>::const_iterator found =
1765 std::min_element(values.begin(), values.end());
1766 *value = *found;
1767 return true;
1768}
1769
1770bool GetParameter(const std::string& name,
Yves Gerey665174f2018-06-19 15:03:05 +02001771 const cricket::CodecParameterMap& params,
1772 int* value) {
1773 std::map<std::string, std::string>::const_iterator found = params.find(name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001774 if (found == params.end()) {
1775 return false;
1776 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00001777 if (!rtc::FromString(found->second, value)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001778 return false;
1779 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001780 return true;
1781}
1782
1783void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001784 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001785 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001786 RTC_DCHECK(message != NULL);
1787 RTC_DCHECK(media_desc != NULL);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001788 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001789 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001790 for (const cricket::VideoCodec& codec : media_desc->as_video()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001791 // RFC 4566
1792 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1793 // [/<encodingparameters>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001794 if (codec.id != kWildcardPayloadType) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001795 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001796 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
deadbeefe814a0d2017-02-25 18:15:09 -08001797 << cricket::kVideoCodecClockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001798 AddLine(os.str(), message);
1799 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001800 AddRtcpFbLines(codec, message);
1801 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001802 }
1803 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001804 std::vector<int> ptimes;
1805 std::vector<int> maxptimes;
1806 int max_minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001807 for (const cricket::AudioCodec& codec : media_desc->as_audio()->codecs()) {
1808 RTC_DCHECK(!codec.name.empty());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001809 // RFC 4566
1810 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1811 // [/<encodingparameters>]
1812 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001813 os << kSdpDelimiterColon << codec.id << " ";
1814 os << codec.name << "/" << codec.clockrate;
1815 if (codec.channels != 1) {
1816 os << "/" << codec.channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001817 }
1818 AddLine(os.str(), message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001819 AddRtcpFbLines(codec, message);
1820 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001821 int minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001822 if (GetParameter(kCodecParamMinPTime, codec.params, &minptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001823 max_minptime = std::max(minptime, max_minptime);
1824 }
1825 int ptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001826 if (GetParameter(kCodecParamPTime, codec.params, &ptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001827 ptimes.push_back(ptime);
1828 }
1829 int maxptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001830 if (GetParameter(kCodecParamMaxPTime, codec.params, &maxptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001831 maxptimes.push_back(maxptime);
1832 }
1833 }
1834 // Populate the maxptime attribute with the smallest maxptime of all codecs
1835 // under the same m-line.
1836 int min_maxptime = INT_MAX;
1837 if (GetMinValue(maxptimes, &min_maxptime)) {
1838 AddAttributeLine(kCodecParamMaxPTime, min_maxptime, message);
1839 }
nisseede5da42017-01-12 05:15:36 -08001840 RTC_DCHECK(min_maxptime > max_minptime);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001841 // Populate the ptime attribute with the smallest ptime or the largest
1842 // minptime, whichever is the largest, for all codecs under the same m-line.
1843 int ptime = INT_MAX;
1844 if (GetMinValue(ptimes, &ptime)) {
1845 ptime = std::min(ptime, min_maxptime);
1846 ptime = std::max(ptime, max_minptime);
1847 AddAttributeLine(kCodecParamPTime, ptime, message);
1848 }
1849 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001850 for (const cricket::DataCodec& codec : media_desc->as_data()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001851 // RFC 4566
1852 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1853 // [/<encodingparameters>]
1854 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001855 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
1856 << codec.clockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001857 AddLine(os.str(), message);
1858 }
1859 }
1860}
1861
1862void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -08001863 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001864 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001865 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001866
Steve Anton4daf66e2018-09-07 14:55:53 -07001867 for (const Candidate& candidate : candidates) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001868 // RFC 5245
1869 // a=candidate:<foundation> <component-id> <transport> <priority>
1870 // <connection-address> <port> typ <candidate-types>
1871 // [raddr <connection-address>] [rport <port>]
1872 // *(SP extension-att-name SP extension-att-value)
1873 std::string type;
1874 // Map the cricket candidate type to "host" / "srflx" / "prflx" / "relay"
Steve Anton4daf66e2018-09-07 14:55:53 -07001875 if (candidate.type() == cricket::LOCAL_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001876 type = kCandidateHost;
Steve Anton4daf66e2018-09-07 14:55:53 -07001877 } else if (candidate.type() == cricket::STUN_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001878 type = kCandidateSrflx;
Steve Anton4daf66e2018-09-07 14:55:53 -07001879 } else if (candidate.type() == cricket::RELAY_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001880 type = kCandidateRelay;
Steve Anton4daf66e2018-09-07 14:55:53 -07001881 } else if (candidate.type() == cricket::PRFLX_PORT_TYPE) {
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001882 type = kCandidatePrflx;
1883 // Peer reflexive candidate may be signaled for being removed.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001884 } else {
nissec80e7412017-01-11 05:56:46 -08001885 RTC_NOTREACHED();
Peter Thatcher019087f2015-04-28 09:06:26 -07001886 // Never write out candidates if we don't know the type.
1887 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001888 }
1889
1890 InitAttrLine(kAttributeCandidate, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001891 os << kSdpDelimiterColon << candidate.foundation() << " "
1892 << candidate.component() << " " << candidate.protocol() << " "
1893 << candidate.priority() << " "
1894 << (candidate.address().ipaddr().IsNil()
1895 ? candidate.address().hostname()
1896 : candidate.address().ipaddr().ToString())
1897 << " " << candidate.address().PortAsString() << " "
1898 << kAttributeCandidateTyp << " " << type << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001899
1900 // Related address
Steve Anton4daf66e2018-09-07 14:55:53 -07001901 if (!candidate.related_address().IsNil()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001902 os << kAttributeCandidateRaddr << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001903 << candidate.related_address().ipaddr().ToString() << " "
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001904 << kAttributeCandidateRport << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001905 << candidate.related_address().PortAsString() << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001906 }
1907
Steve Anton4daf66e2018-09-07 14:55:53 -07001908 if (candidate.protocol() == cricket::TCP_PROTOCOL_NAME) {
1909 os << kTcpCandidateType << " " << candidate.tcptype() << " ";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001910 }
1911
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001912 // Extensions
Steve Anton4daf66e2018-09-07 14:55:53 -07001913 os << kAttributeCandidateGeneration << " " << candidate.generation();
1914 if (include_ufrag && !candidate.username().empty()) {
1915 os << " " << kAttributeCandidateUfrag << " " << candidate.username();
honghaiza54a0802015-12-16 18:37:23 -08001916 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001917 if (candidate.network_id() > 0) {
1918 os << " " << kAttributeCandidateNetworkId << " "
1919 << candidate.network_id();
honghaiza0c44ea2016-03-23 16:07:48 -07001920 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001921 if (candidate.network_cost() > 0) {
1922 os << " " << kAttributeCandidateNetworkCost << " "
1923 << candidate.network_cost();
honghaize1a0c942016-02-16 14:54:56 -08001924 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001925
1926 AddLine(os.str(), message);
1927 }
1928}
1929
1930void BuildIceOptions(const std::vector<std::string>& transport_options,
1931 std::string* message) {
1932 if (!transport_options.empty()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001933 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001934 InitAttrLine(kAttributeIceOption, &os);
1935 os << kSdpDelimiterColon << transport_options[0];
1936 for (size_t i = 1; i < transport_options.size(); ++i) {
1937 os << kSdpDelimiterSpace << transport_options[i];
1938 }
1939 AddLine(os.str(), message);
1940 }
1941}
1942
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001943bool IsRtp(const std::string& protocol) {
1944 return protocol.empty() ||
Yves Gerey665174f2018-06-19 15:03:05 +02001945 (protocol.find(cricket::kMediaProtocolRtpPrefix) != std::string::npos);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001946}
1947
1948bool IsDtlsSctp(const std::string& protocol) {
1949 // This intentionally excludes "SCTP" and "SCTP/DTLS".
lally@webrtc.orga7470932015-02-24 20:19:21 +00001950 return protocol.find(cricket::kMediaProtocolDtlsSctp) != std::string::npos;
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001951}
1952
zhihuang38989e52017-03-21 11:04:53 -07001953bool ParseConnectionData(const std::string& line,
1954 rtc::SocketAddress* addr,
1955 SdpParseError* error) {
1956 // Parse the line from left to right.
1957 std::string token;
1958 std::string rightpart;
1959 // RFC 4566
1960 // c=<nettype> <addrtype> <connection-address>
1961 // Skip the "c="
Jonas Olssonec9e4922018-09-05 09:53:49 +02001962 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, &token, &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07001963 return ParseFailed(line, "Failed to parse the network type.", error);
1964 }
1965
1966 // Extract and verify the <nettype>
Jonas Olssonec9e4922018-09-05 09:53:49 +02001967 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
1968 &rightpart) ||
zhihuang38989e52017-03-21 11:04:53 -07001969 token != kConnectionNettype) {
1970 return ParseFailed(line,
1971 "Failed to parse the connection data. The network type "
1972 "is not currently supported.",
1973 error);
1974 }
1975
1976 // Extract the "<addrtype>" and "<connection-address>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001977 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
1978 &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07001979 return ParseFailed(line, "Failed to parse the address type.", error);
1980 }
1981
1982 // The rightpart part should be the IP address without the slash which is used
1983 // for multicast.
1984 if (rightpart.find('/') != std::string::npos) {
1985 return ParseFailed(line,
1986 "Failed to parse the connection data. Multicast is not "
1987 "currently supported.",
1988 error);
1989 }
1990 addr->SetIP(rightpart);
1991
1992 // Verify that the addrtype matches the type of the parsed address.
1993 if ((addr->family() == AF_INET && token != "IP4") ||
1994 (addr->family() == AF_INET6 && token != "IP6")) {
1995 addr->Clear();
1996 return ParseFailed(
1997 line,
1998 "Failed to parse the connection data. The address type is mismatching.",
1999 error);
2000 }
2001 return true;
2002}
2003
2004bool ParseSessionDescription(const std::string& message,
2005 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002006 std::string* session_id,
2007 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002008 TransportDescription* session_td,
2009 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -07002010 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002011 cricket::SessionDescription* desc,
2012 SdpParseError* error) {
2013 std::string line;
2014
deadbeefc80741f2015-10-22 13:14:45 -07002015 desc->set_msid_supported(false);
Johannes Kron0854eb62018-10-10 22:33:20 +02002016 desc->set_mixed_one_two_byte_header_extensions_supported(false);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002017 // RFC 4566
2018 // v= (protocol version)
2019 if (!GetLineWithType(message, pos, &line, kLineTypeVersion)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002020 return ParseFailedExpectLine(message, *pos, kLineTypeVersion, std::string(),
2021 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002022 }
2023 // RFC 4566
2024 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
2025 // <unicast-address>
2026 if (!GetLineWithType(message, pos, &line, kLineTypeOrigin)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002027 return ParseFailedExpectLine(message, *pos, kLineTypeOrigin, std::string(),
2028 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002029 }
2030 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002031 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002032 const size_t expected_fields = 6;
2033 if (fields.size() != expected_fields) {
2034 return ParseFailedExpectFieldNum(line, expected_fields, error);
2035 }
2036 *session_id = fields[1];
2037 *session_version = fields[2];
2038
2039 // RFC 4566
2040 // s= (session name)
2041 if (!GetLineWithType(message, pos, &line, kLineTypeSessionName)) {
2042 return ParseFailedExpectLine(message, *pos, kLineTypeSessionName,
2043 std::string(), error);
2044 }
2045
Danil Chapovalov66cadcc2018-06-19 16:47:43 +02002046 // absl::optional lines
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002047 // Those are the optional lines, so shouldn't return false if not present.
2048 // RFC 4566
2049 // i=* (session information)
2050 GetLineWithType(message, pos, &line, kLineTypeSessionInfo);
2051
2052 // RFC 4566
2053 // u=* (URI of description)
2054 GetLineWithType(message, pos, &line, kLineTypeSessionUri);
2055
2056 // RFC 4566
2057 // e=* (email address)
2058 GetLineWithType(message, pos, &line, kLineTypeSessionEmail);
2059
2060 // RFC 4566
2061 // p=* (phone number)
2062 GetLineWithType(message, pos, &line, kLineTypeSessionPhone);
2063
2064 // RFC 4566
2065 // c=* (connection information -- not required if included in
2066 // all media)
zhihuang38989e52017-03-21 11:04:53 -07002067 if (GetLineWithType(message, pos, &line, kLineTypeConnection)) {
2068 if (!ParseConnectionData(line, connection_addr, error)) {
2069 return false;
2070 }
2071 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002072
2073 // RFC 4566
2074 // b=* (zero or more bandwidth information lines)
2075 while (GetLineWithType(message, pos, &line, kLineTypeSessionBandwidth)) {
2076 // By pass zero or more b lines.
2077 }
2078
2079 // RFC 4566
2080 // One or more time descriptions ("t=" and "r=" lines; see below)
2081 // t= (time the session is active)
2082 // r=* (zero or more repeat times)
2083 // Ensure there's at least one time description
2084 if (!GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2085 return ParseFailedExpectLine(message, *pos, kLineTypeTiming, std::string(),
2086 error);
2087 }
2088
2089 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2090 // By pass zero or more r lines.
2091 }
2092
2093 // Go through the rest of the time descriptions
2094 while (GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2095 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2096 // By pass zero or more r lines.
2097 }
2098 }
2099
2100 // RFC 4566
2101 // z=* (time zone adjustments)
2102 GetLineWithType(message, pos, &line, kLineTypeTimeZone);
2103
2104 // RFC 4566
2105 // k=* (encryption key)
2106 GetLineWithType(message, pos, &line, kLineTypeEncryptionKey);
2107
2108 // RFC 4566
2109 // a=* (zero or more session attribute lines)
2110 while (GetLineWithType(message, pos, &line, kLineTypeAttributes)) {
2111 if (HasAttribute(line, kAttributeGroup)) {
2112 if (!ParseGroupAttribute(line, desc, error)) {
2113 return false;
2114 }
2115 } else if (HasAttribute(line, kAttributeIceUfrag)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002116 if (!GetValue(line, kAttributeIceUfrag, &(session_td->ice_ufrag),
2117 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002118 return false;
2119 }
2120 } else if (HasAttribute(line, kAttributeIcePwd)) {
2121 if (!GetValue(line, kAttributeIcePwd, &(session_td->ice_pwd), error)) {
2122 return false;
2123 }
2124 } else if (HasAttribute(line, kAttributeIceLite)) {
2125 session_td->ice_mode = cricket::ICEMODE_LITE;
2126 } else if (HasAttribute(line, kAttributeIceOption)) {
2127 if (!ParseIceOptions(line, &(session_td->transport_options), error)) {
2128 return false;
2129 }
2130 } else if (HasAttribute(line, kAttributeFingerprint)) {
2131 if (session_td->identity_fingerprint.get()) {
2132 return ParseFailed(
2133 line,
2134 "Can't have multiple fingerprint attributes at the same level.",
2135 error);
2136 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00002137 rtc::SSLFingerprint* fingerprint = NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002138 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2139 return false;
2140 }
2141 session_td->identity_fingerprint.reset(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002142 } else if (HasAttribute(line, kAttributeSetup)) {
2143 if (!ParseDtlsSetup(line, &(session_td->connection_role), error)) {
2144 return false;
2145 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002146 } else if (HasAttribute(line, kAttributeMsidSemantics)) {
2147 std::string semantics;
2148 if (!GetValue(line, kAttributeMsidSemantics, &semantics, error)) {
2149 return false;
2150 }
deadbeefc80741f2015-10-22 13:14:45 -07002151 desc->set_msid_supported(
2152 CaseInsensitiveFind(semantics, kMediaStreamSemantic));
Johannes Kron0854eb62018-10-10 22:33:20 +02002153 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
2154 desc->set_mixed_one_two_byte_header_extensions_supported(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002155 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002156 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002157 if (!ParseExtmap(line, &extmap, error)) {
2158 return false;
2159 }
2160 session_extmaps->push_back(extmap);
2161 }
2162 }
2163
2164 return true;
2165}
2166
2167bool ParseGroupAttribute(const std::string& line,
2168 cricket::SessionDescription* desc,
2169 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002170 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002171
2172 // RFC 5888 and draft-holmberg-mmusic-sdp-bundle-negotiation-00
2173 // a=group:BUNDLE video voice
2174 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002175 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002176 std::string semantics;
2177 if (!GetValue(fields[0], kAttributeGroup, &semantics, error)) {
2178 return false;
2179 }
2180 cricket::ContentGroup group(semantics);
2181 for (size_t i = 1; i < fields.size(); ++i) {
2182 group.AddContentName(fields[i]);
2183 }
2184 desc->AddGroup(group);
2185 return true;
2186}
2187
2188static bool ParseFingerprintAttribute(const std::string& line,
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00002189 rtc::SSLFingerprint** fingerprint,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002190 SdpParseError* error) {
2191 if (!IsLineType(line, kLineTypeAttributes) ||
2192 !HasAttribute(line, kAttributeFingerprint)) {
2193 return ParseFailedExpectLine(line, 0, kLineTypeAttributes,
2194 kAttributeFingerprint, error);
2195 }
2196
2197 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002198 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002199 const size_t expected_fields = 2;
2200 if (fields.size() != expected_fields) {
2201 return ParseFailedExpectFieldNum(line, expected_fields, error);
2202 }
2203
2204 // The first field here is "fingerprint:<hash>.
2205 std::string algorithm;
2206 if (!GetValue(fields[0], kAttributeFingerprint, &algorithm, error)) {
2207 return false;
2208 }
2209
2210 // Downcase the algorithm. Note that we don't need to downcase the
2211 // fingerprint because hex_decode can handle upper-case.
2212 std::transform(algorithm.begin(), algorithm.end(), algorithm.begin(),
2213 ::tolower);
2214
2215 // The second field is the digest value. De-hexify it.
Yves Gerey665174f2018-06-19 15:03:05 +02002216 *fingerprint = rtc::SSLFingerprint::CreateFromRfc4572(algorithm, fields[1]);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002217 if (!*fingerprint) {
Yves Gerey665174f2018-06-19 15:03:05 +02002218 return ParseFailed(line, "Failed to create fingerprint from the digest.",
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002219 error);
2220 }
2221
2222 return true;
2223}
2224
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002225static bool ParseDtlsSetup(const std::string& line,
2226 cricket::ConnectionRole* role,
2227 SdpParseError* error) {
2228 // setup-attr = "a=setup:" role
2229 // role = "active" / "passive" / "actpass" / "holdconn"
2230 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002231 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002232 const size_t expected_fields = 2;
2233 if (fields.size() != expected_fields) {
2234 return ParseFailedExpectFieldNum(line, expected_fields, error);
2235 }
2236 std::string role_str = fields[1];
2237 if (!cricket::StringToConnectionRole(role_str, role)) {
2238 return ParseFailed(line, "Invalid attribute value.", error);
2239 }
2240 return true;
2241}
2242
deadbeef9d3584c2016-02-16 17:54:10 -08002243static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -07002244 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -08002245 std::string* track_id,
2246 SdpParseError* error) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002247 // https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
deadbeef9d3584c2016-02-16 17:54:10 -08002248 // a=msid:<stream id> <track id>
2249 // msid-value = msid-id [ SP msid-appdata ]
2250 // msid-id = 1*64token-char ; see RFC 4566
2251 // msid-appdata = 1*64token-char ; see RFC 4566
2252 std::string field1;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002253 std::string new_stream_id;
2254 std::string new_track_id;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002255 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
2256 kSdpDelimiterSpaceChar, &field1, &new_track_id)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002257 const size_t expected_fields = 2;
2258 return ParseFailedExpectFieldNum(line, expected_fields, error);
2259 }
2260
Seth Hampson5b4f0752018-04-02 16:31:36 -07002261 if (new_track_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002262 return ParseFailed(line, "Missing track ID in msid attribute.", error);
2263 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002264 // All track ids should be the same within an m section in a Unified Plan SDP.
2265 if (!track_id->empty() && new_track_id.compare(*track_id) != 0) {
2266 return ParseFailed(
2267 line, "Two different track IDs in msid attribute in one m= section",
2268 error);
2269 }
2270 *track_id = new_track_id;
deadbeefa4549d62017-02-10 17:26:22 -08002271
deadbeef9d3584c2016-02-16 17:54:10 -08002272 // msid:<msid-id>
Seth Hampson5b4f0752018-04-02 16:31:36 -07002273 if (!GetValue(field1, kAttributeMsid, &new_stream_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002274 return false;
2275 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002276 if (new_stream_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002277 return ParseFailed(line, "Missing stream ID in msid attribute.", error);
2278 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002279 // The special value "-" indicates "no MediaStream".
2280 if (new_stream_id.compare(kNoStreamMsid) != 0) {
2281 stream_ids->push_back(new_stream_id);
2282 }
deadbeef9d3584c2016-02-16 17:54:10 -08002283 return true;
2284}
2285
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002286// RFC 3551
2287// PT encoding media type clock rate channels
2288// name (Hz)
2289// 0 PCMU A 8,000 1
2290// 1 reserved A
2291// 2 reserved A
2292// 3 GSM A 8,000 1
2293// 4 G723 A 8,000 1
2294// 5 DVI4 A 8,000 1
2295// 6 DVI4 A 16,000 1
2296// 7 LPC A 8,000 1
2297// 8 PCMA A 8,000 1
2298// 9 G722 A 8,000 1
2299// 10 L16 A 44,100 2
2300// 11 L16 A 44,100 1
2301// 12 QCELP A 8,000 1
2302// 13 CN A 8,000 1
2303// 14 MPA A 90,000 (see text)
2304// 15 G728 A 8,000 1
2305// 16 DVI4 A 11,025 1
2306// 17 DVI4 A 22,050 1
2307// 18 G729 A 8,000 1
2308struct StaticPayloadAudioCodec {
2309 const char* name;
2310 int clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002311 size_t channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002312};
2313static const StaticPayloadAudioCodec kStaticPayloadAudioCodecs[] = {
Yves Gerey665174f2018-06-19 15:03:05 +02002314 {"PCMU", 8000, 1}, {"reserved", 0, 0}, {"reserved", 0, 0},
2315 {"GSM", 8000, 1}, {"G723", 8000, 1}, {"DVI4", 8000, 1},
2316 {"DVI4", 16000, 1}, {"LPC", 8000, 1}, {"PCMA", 8000, 1},
2317 {"G722", 8000, 1}, {"L16", 44100, 2}, {"L16", 44100, 1},
2318 {"QCELP", 8000, 1}, {"CN", 8000, 1}, {"MPA", 90000, 1},
2319 {"G728", 8000, 1}, {"DVI4", 11025, 1}, {"DVI4", 22050, 1},
2320 {"G729", 8000, 1},
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002321};
2322
Yves Gerey665174f2018-06-19 15:03:05 +02002323void MaybeCreateStaticPayloadAudioCodecs(const std::vector<int>& fmts,
2324 AudioContentDescription* media_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002325 if (!media_desc) {
2326 return;
2327 }
deadbeef67cf2c12016-04-13 10:07:16 -07002328 RTC_DCHECK(media_desc->codecs().empty());
solenberg9fa49752016-10-08 13:02:44 -07002329 for (int payload_type : fmts) {
Yves Gerey665174f2018-06-19 15:03:05 +02002330 if (!media_desc->HasCodec(payload_type) && payload_type >= 0 &&
kjellander3e33bfe2016-06-20 07:04:09 -07002331 static_cast<uint32_t>(payload_type) <
2332 arraysize(kStaticPayloadAudioCodecs)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002333 std::string encoding_name = kStaticPayloadAudioCodecs[payload_type].name;
2334 int clock_rate = kStaticPayloadAudioCodecs[payload_type].clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002335 size_t channels = kStaticPayloadAudioCodecs[payload_type].channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002336 media_desc->AddCodec(cricket::AudioCodec(payload_type, encoding_name,
deadbeef67cf2c12016-04-13 10:07:16 -07002337 clock_rate, 0, channels));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002338 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002339 }
2340}
2341
2342template <class C>
2343static C* ParseContentDescription(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002344 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002345 int mline_index,
2346 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002347 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002348 size_t* pos,
2349 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002350 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002351 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002352 TransportDescription* transport,
2353 std::vector<JsepIceCandidate*>* candidates,
2354 webrtc::SdpParseError* error) {
2355 C* media_desc = new C();
2356 switch (media_type) {
2357 case cricket::MEDIA_TYPE_AUDIO:
2358 *content_name = cricket::CN_AUDIO;
2359 break;
2360 case cricket::MEDIA_TYPE_VIDEO:
2361 *content_name = cricket::CN_VIDEO;
2362 break;
2363 case cricket::MEDIA_TYPE_DATA:
2364 *content_name = cricket::CN_DATA;
2365 break;
2366 default:
nissec80e7412017-01-11 05:56:46 -08002367 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002368 break;
2369 }
deadbeef67cf2c12016-04-13 10:07:16 -07002370 if (!ParseContent(message, media_type, mline_index, protocol, payload_types,
Steve Antone831b8c2018-02-01 12:22:16 -08002371 pos, content_name, bundle_only, msid_signaling, media_desc,
2372 transport, candidates, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002373 delete media_desc;
zhihuang38989e52017-03-21 11:04:53 -07002374 return nullptr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002375 }
2376 // Sort the codecs according to the m-line fmt list.
deadbeef67cf2c12016-04-13 10:07:16 -07002377 std::unordered_map<int, int> payload_type_preferences;
2378 // "size + 1" so that the lowest preference payload type has a preference of
2379 // 1, which is greater than the default (0) for payload types not in the fmt
2380 // list.
2381 int preference = static_cast<int>(payload_types.size() + 1);
2382 for (int pt : payload_types) {
2383 payload_type_preferences[pt] = preference--;
2384 }
2385 std::vector<typename C::CodecType> codecs = media_desc->codecs();
Yves Gerey665174f2018-06-19 15:03:05 +02002386 std::sort(codecs.begin(), codecs.end(),
2387 [&payload_type_preferences](const typename C::CodecType& a,
2388 const typename C::CodecType& b) {
2389 return payload_type_preferences[a.id] >
2390 payload_type_preferences[b.id];
2391 });
deadbeef67cf2c12016-04-13 10:07:16 -07002392 media_desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002393 return media_desc;
2394}
2395
2396bool ParseMediaDescription(const std::string& message,
2397 const TransportDescription& session_td,
2398 const RtpHeaderExtensions& session_extmaps,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002399 size_t* pos,
zhihuang38989e52017-03-21 11:04:53 -07002400 const rtc::SocketAddress& session_connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002401 cricket::SessionDescription* desc,
2402 std::vector<JsepIceCandidate*>* candidates,
2403 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002404 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002405 std::string line;
2406 int mline_index = -1;
Steve Antone831b8c2018-02-01 12:22:16 -08002407 int msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002408
2409 // Zero or more media descriptions
2410 // RFC 4566
2411 // m=<media> <port> <proto> <fmt>
2412 while (GetLineWithType(message, pos, &line, kLineTypeMedia)) {
2413 ++mline_index;
2414
2415 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002416 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
zstein4b2e0822017-02-17 19:48:38 -08002417
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002418 const size_t expected_min_fields = 4;
2419 if (fields.size() < expected_min_fields) {
2420 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
2421 }
deadbeef25ed4352016-12-12 18:37:36 -08002422 bool port_rejected = false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002423 // RFC 3264
2424 // To reject an offered stream, the port number in the corresponding stream
2425 // in the answer MUST be set to zero.
2426 if (fields[1] == kMediaPortRejected) {
deadbeef25ed4352016-12-12 18:37:36 -08002427 port_rejected = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002428 }
2429
zhihuang38989e52017-03-21 11:04:53 -07002430 int port = 0;
2431 if (!rtc::FromString<int>(fields[1], &port) || !IsValidPort(port)) {
2432 return ParseFailed(line, "The port number is invalid", error);
2433 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002434 std::string protocol = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002435
2436 // <fmt>
deadbeef67cf2c12016-04-13 10:07:16 -07002437 std::vector<int> payload_types;
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002438 if (IsRtp(protocol)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002439 for (size_t j = 3; j < fields.size(); ++j) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002440 // TODO(wu): Remove when below bug is fixed.
2441 // https://bugzilla.mozilla.org/show_bug.cgi?id=996329
pbosbb36fdf2015-07-09 07:48:14 -07002442 if (fields[j].empty() && j == fields.size() - 1) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002443 continue;
2444 }
wu@webrtc.org36eda7c2014-04-15 20:37:30 +00002445
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002446 int pl = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00002447 if (!GetPayloadTypeFromString(line, fields[j], &pl, error)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002448 return false;
2449 }
deadbeef67cf2c12016-04-13 10:07:16 -07002450 payload_types.push_back(pl);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002451 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002452 }
2453
2454 // Make a temporary TransportDescription based on |session_td|.
2455 // Some of this gets overwritten by ParseContent.
deadbeef46eed762016-01-28 13:24:37 -08002456 TransportDescription transport(
2457 session_td.transport_options, session_td.ice_ufrag, session_td.ice_pwd,
2458 session_td.ice_mode, session_td.connection_role,
2459 session_td.identity_fingerprint.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002460
kwibergd1fe2812016-04-27 06:47:29 -07002461 std::unique_ptr<MediaContentDescription> content;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002462 std::string content_name;
deadbeef25ed4352016-12-12 18:37:36 -08002463 bool bundle_only = false;
Steve Antone831b8c2018-02-01 12:22:16 -08002464 int section_msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002465 if (HasAttribute(line, kMediaTypeVideo)) {
2466 content.reset(ParseContentDescription<VideoContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002467 message, cricket::MEDIA_TYPE_VIDEO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002468 payload_types, pos, &content_name, &bundle_only,
2469 &section_msid_signaling, &transport, candidates, error));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002470 } else if (HasAttribute(line, kMediaTypeAudio)) {
2471 content.reset(ParseContentDescription<AudioContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002472 message, cricket::MEDIA_TYPE_AUDIO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002473 payload_types, pos, &content_name, &bundle_only,
2474 &section_msid_signaling, &transport, candidates, error));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002475 } else if (HasAttribute(line, kMediaTypeData)) {
jiayl@webrtc.org0e527722014-09-08 21:43:43 +00002476 DataContentDescription* data_desc =
wu@webrtc.org78187522013-10-07 23:32:02 +00002477 ParseContentDescription<DataContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002478 message, cricket::MEDIA_TYPE_DATA, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002479 payload_types, pos, &content_name, &bundle_only,
2480 &section_msid_signaling, &transport, candidates, error);
jiayl@webrtc.org0e527722014-09-08 21:43:43 +00002481 content.reset(data_desc);
wu@webrtc.org78187522013-10-07 23:32:02 +00002482
zstein4b2e0822017-02-17 19:48:38 -08002483 if (data_desc && IsDtlsSctp(protocol)) {
2484 int p;
2485 if (rtc::FromString(fields[3], &p)) {
2486 if (!AddSctpDataCodec(data_desc, p)) {
2487 return false;
2488 }
2489 } else if (fields[3] == kDefaultSctpmapProtocol) {
2490 data_desc->set_use_sctpmap(false);
2491 }
wu@webrtc.org78187522013-10-07 23:32:02 +00002492 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002493 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002494 RTC_LOG(LS_WARNING) << "Unsupported media type: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002495 continue;
2496 }
2497 if (!content.get()) {
2498 // ParseContentDescription returns NULL if failed.
2499 return false;
2500 }
2501
Steve Antone831b8c2018-02-01 12:22:16 -08002502 msid_signaling |= section_msid_signaling;
2503
deadbeef25ed4352016-12-12 18:37:36 -08002504 bool content_rejected = false;
deadbeef12771a12017-01-03 13:53:47 -08002505 // A port of 0 is not interpreted as a rejected m= section when it's
2506 // used along with a=bundle-only.
deadbeef25ed4352016-12-12 18:37:36 -08002507 if (bundle_only) {
deadbeef25ed4352016-12-12 18:37:36 -08002508 if (!port_rejected) {
deadbeef12771a12017-01-03 13:53:47 -08002509 // Usage of bundle-only with a nonzero port is unspecified. So just
2510 // ignore bundle-only if we see this.
2511 bundle_only = false;
Mirko Bonadei675513b2017-11-09 11:09:25 +01002512 RTC_LOG(LS_WARNING)
deadbeef12771a12017-01-03 13:53:47 -08002513 << "a=bundle-only attribute observed with a nonzero "
Jonas Olsson45cc8902018-02-13 10:37:07 +01002514 "port; this usage is unspecified so the attribute is being "
2515 "ignored.";
deadbeef25ed4352016-12-12 18:37:36 -08002516 }
2517 } else {
2518 // If not using bundle-only, interpret port 0 in the normal way; the m=
2519 // section is being rejected.
2520 content_rejected = port_rejected;
2521 }
2522
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002523 if (IsRtp(protocol)) {
Johannes Kron0854eb62018-10-10 22:33:20 +02002524 if (desc->mixed_one_two_byte_header_extensions_supported()) {
2525 content->set_mixed_one_two_byte_header_extensions_supported(
2526 MediaContentDescription::kSession);
2527 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002528 // Set the extmap.
2529 if (!session_extmaps.empty() &&
2530 !content->rtp_header_extensions().empty()) {
2531 return ParseFailed("",
2532 "The a=extmap MUST be either all session level or "
2533 "all media level.",
2534 error);
2535 }
2536 for (size_t i = 0; i < session_extmaps.size(); ++i) {
2537 content->AddRtpHeaderExtension(session_extmaps[i]);
2538 }
2539 }
2540 content->set_protocol(protocol);
zhihuang38989e52017-03-21 11:04:53 -07002541
2542 // Use the session level connection address if the media level addresses are
2543 // not specified.
2544 rtc::SocketAddress address;
2545 address = content->connection_address().IsNil()
2546 ? session_connection_addr
2547 : content->connection_address();
2548 address.SetPort(port);
2549 content->set_connection_address(address);
2550
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002551 desc->AddContent(content_name,
Steve Anton5adfafd2017-12-20 16:34:00 -08002552 IsDtlsSctp(protocol) ? MediaProtocolType::kSctp
2553 : MediaProtocolType::kRtp,
deadbeef25ed4352016-12-12 18:37:36 -08002554 content_rejected, bundle_only, content.release());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002555 // Create TransportInfo with the media level "ice-pwd" and "ice-ufrag".
2556 TransportInfo transport_info(content_name, transport);
2557
2558 if (!desc->AddTransportInfo(transport_info)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002559 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002560 description << "Failed to AddTransportInfo with content name: "
2561 << content_name;
2562 return ParseFailed("", description.str(), error);
2563 }
2564 }
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002565
Steve Antone831b8c2018-02-01 12:22:16 -08002566 desc->set_msid_signaling(msid_signaling);
2567
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002568 size_t end_of_message = message.size();
2569 if (mline_index == -1 && *pos != end_of_message) {
2570 ParseFailed(message, *pos, "Expects m line.", error);
2571 return false;
2572 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002573 return true;
2574}
2575
2576bool VerifyCodec(const cricket::Codec& codec) {
2577 // Codec has not been populated correctly unless the name has been set. This
2578 // can happen if an SDP has an fmtp or rtcp-fb with a payload type but doesn't
2579 // have a corresponding "rtpmap" line.
htab39db842016-12-08 01:50:48 -08002580 return !codec.name.empty();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002581}
2582
2583bool VerifyAudioCodecs(const AudioContentDescription* audio_desc) {
2584 const std::vector<cricket::AudioCodec>& codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002585 return std::all_of(codecs.begin(), codecs.end(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002586}
2587
2588bool VerifyVideoCodecs(const VideoContentDescription* video_desc) {
2589 const std::vector<cricket::VideoCodec>& codecs = video_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002590 return std::all_of(codecs.begin(), codecs.end(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002591}
2592
2593void AddParameters(const cricket::CodecParameterMap& parameters,
2594 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002595 for (const auto& entry : parameters) {
2596 const std::string& key = entry.first;
2597 const std::string& value = entry.second;
2598 codec->SetParam(key, value);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002599 }
2600}
2601
2602void AddFeedbackParameter(const cricket::FeedbackParam& feedback_param,
2603 cricket::Codec* codec) {
2604 codec->AddFeedbackParam(feedback_param);
2605}
2606
2607void AddFeedbackParameters(const cricket::FeedbackParams& feedback_params,
2608 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002609 for (const cricket::FeedbackParam& param : feedback_params.params()) {
2610 codec->AddFeedbackParam(param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002611 }
2612}
2613
2614// Gets the current codec setting associated with |payload_type|. If there
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002615// is no Codec associated with that payload type it returns an empty codec
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002616// with that payload type.
2617template <class T>
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002618T GetCodecWithPayloadType(const std::vector<T>& codecs, int payload_type) {
magjedb05fa242016-11-11 04:00:16 -08002619 const T* codec = FindCodecById(codecs, payload_type);
2620 if (codec)
2621 return *codec;
2622 // Return empty codec with |payload_type|.
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002623 T ret_val;
magjedb05fa242016-11-11 04:00:16 -08002624 ret_val.id = payload_type;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002625 return ret_val;
2626}
2627
2628// Updates or creates a new codec entry in the audio description.
2629template <class T, class U>
2630void AddOrReplaceCodec(MediaContentDescription* content_desc, const U& codec) {
2631 T* desc = static_cast<T*>(content_desc);
2632 std::vector<U> codecs = desc->codecs();
2633 bool found = false;
Steve Anton4daf66e2018-09-07 14:55:53 -07002634 for (U& existing_codec : codecs) {
2635 if (codec.id == existing_codec.id) {
2636 // Overwrite existing codec with the new codec.
2637 existing_codec = codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002638 found = true;
2639 break;
2640 }
2641 }
2642 if (!found) {
2643 desc->AddCodec(codec);
2644 return;
2645 }
2646 desc->set_codecs(codecs);
2647}
2648
2649// Adds or updates existing codec corresponding to |payload_type| according
2650// to |parameters|.
2651template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002652void UpdateCodec(MediaContentDescription* content_desc,
2653 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002654 const cricket::CodecParameterMap& parameters) {
2655 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002656 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2657 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002658 AddParameters(parameters, &new_codec);
2659 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2660}
2661
2662// Adds or updates existing codec corresponding to |payload_type| according
2663// to |feedback_param|.
2664template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002665void UpdateCodec(MediaContentDescription* content_desc,
2666 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002667 const cricket::FeedbackParam& feedback_param) {
2668 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002669 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2670 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002671 AddFeedbackParameter(feedback_param, &new_codec);
2672 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2673}
2674
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002675template <class T>
2676bool PopWildcardCodec(std::vector<T>* codecs, T* wildcard_codec) {
2677 for (auto iter = codecs->begin(); iter != codecs->end(); ++iter) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002678 if (iter->id == kWildcardPayloadType) {
2679 *wildcard_codec = *iter;
2680 codecs->erase(iter);
2681 return true;
2682 }
2683 }
2684 return false;
2685}
2686
Yves Gerey665174f2018-06-19 15:03:05 +02002687template <class T>
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002688void UpdateFromWildcardCodecs(cricket::MediaContentDescriptionImpl<T>* desc) {
2689 auto codecs = desc->codecs();
2690 T wildcard_codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002691 if (!PopWildcardCodec(&codecs, &wildcard_codec)) {
2692 return;
2693 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002694 for (auto& codec : codecs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002695 AddFeedbackParameters(wildcard_codec.feedback_params, &codec);
2696 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002697 desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002698}
2699
Yves Gerey665174f2018-06-19 15:03:05 +02002700void AddAudioAttribute(const std::string& name,
2701 const std::string& value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002702 AudioContentDescription* audio_desc) {
2703 if (value.empty()) {
2704 return;
2705 }
2706 std::vector<cricket::AudioCodec> codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002707 for (cricket::AudioCodec& codec : codecs) {
2708 codec.params[name] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002709 }
2710 audio_desc->set_codecs(codecs);
2711}
2712
2713bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002714 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002715 int mline_index,
2716 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002717 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002718 size_t* pos,
2719 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002720 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002721 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002722 MediaContentDescription* media_desc,
2723 TransportDescription* transport,
2724 std::vector<JsepIceCandidate*>* candidates,
2725 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002726 RTC_DCHECK(media_desc != NULL);
2727 RTC_DCHECK(content_name != NULL);
2728 RTC_DCHECK(transport != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002729
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002730 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002731 MaybeCreateStaticPayloadAudioCodecs(payload_types, media_desc->as_audio());
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002732 }
2733
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002734 // The media level "ice-ufrag" and "ice-pwd".
2735 // The candidates before update the media level "ice-pwd" and "ice-ufrag".
2736 Candidates candidates_orig;
2737 std::string line;
2738 std::string mline_id;
2739 // Tracks created out of the ssrc attributes.
2740 StreamParamsVec tracks;
2741 SsrcInfoVec ssrc_infos;
2742 SsrcGroupVec ssrc_groups;
2743 std::string maxptime_as_string;
2744 std::string ptime_as_string;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002745 std::vector<std::string> stream_ids;
deadbeef9d3584c2016-02-16 17:54:10 -08002746 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002747
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002748 // Loop until the next m line
2749 while (!IsLineType(message, kLineTypeMedia, *pos)) {
2750 if (!GetLine(message, pos, &line)) {
2751 if (*pos >= message.size()) {
2752 break; // Done parsing
2753 } else {
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +00002754 return ParseFailed(message, *pos, "Invalid SDP line.", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002755 }
2756 }
2757
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002758 // RFC 4566
2759 // b=* (zero or more bandwidth information lines)
2760 if (IsLineType(line, kLineTypeSessionBandwidth)) {
2761 std::string bandwidth;
2762 if (HasAttribute(line, kApplicationSpecificMaximum)) {
2763 if (!GetValue(line, kApplicationSpecificMaximum, &bandwidth, error)) {
2764 return false;
2765 } else {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002766 int b = 0;
2767 if (!GetValueFromString(line, bandwidth, &b, error)) {
2768 return false;
2769 }
deadbeef3e8016e2017-08-03 17:49:30 -07002770 // TODO(deadbeef): Historically, applications may be setting a value
2771 // of -1 to mean "unset any previously set bandwidth limit", even
2772 // though ommitting the "b=AS" entirely will do just that. Once we've
2773 // transitioned applications to doing the right thing, it would be
2774 // better to treat this as a hard error instead of just ignoring it.
2775 if (b == -1) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002776 RTC_LOG(LS_WARNING)
2777 << "Ignoring \"b=AS:-1\"; will be treated as \"no "
2778 "bandwidth limit\".";
deadbeef3e8016e2017-08-03 17:49:30 -07002779 continue;
2780 }
deadbeefbc88c6b2017-08-02 11:26:34 -07002781 if (b < 0) {
2782 return ParseFailed(line, "b=AS value can't be negative.", error);
2783 }
Peter Thatcherc0c3a862015-06-24 15:31:25 -07002784 // We should never use more than the default bandwidth for RTP-based
2785 // data channels. Don't allow SDP to set the bandwidth, because
2786 // that would give JS the opportunity to "break the Internet".
2787 // See: https://code.google.com/p/chromium/issues/detail?id=280726
2788 if (media_type == cricket::MEDIA_TYPE_DATA && IsRtp(protocol) &&
2789 b > cricket::kDataMaxBandwidth / 1000) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002790 rtc::StringBuilder description;
Peter Thatcherc0c3a862015-06-24 15:31:25 -07002791 description << "RTP-based data channels may not send more than "
2792 << cricket::kDataMaxBandwidth / 1000 << "kbps.";
2793 return ParseFailed(line, description.str(), error);
2794 }
deadbeefb2362572016-12-13 16:37:06 -08002795 // Prevent integer overflow.
2796 b = std::min(b, INT_MAX / 1000);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002797 media_desc->set_bandwidth(b * 1000);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002798 }
2799 }
2800 continue;
2801 }
2802
zhihuang38989e52017-03-21 11:04:53 -07002803 // Parse the media level connection data.
2804 if (IsLineType(line, kLineTypeConnection)) {
2805 rtc::SocketAddress addr;
2806 if (!ParseConnectionData(line, &addr, error)) {
2807 return false;
2808 }
2809 media_desc->set_connection_address(addr);
2810 continue;
2811 }
2812
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002813 if (!IsLineType(line, kLineTypeAttributes)) {
Steve Anton36b29d12017-10-30 09:57:42 -07002814 // TODO(deadbeef): Handle other lines if needed.
Mirko Bonadei675513b2017-11-09 11:09:25 +01002815 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002816 continue;
2817 }
2818
2819 // Handle attributes common to SCTP and RTP.
2820 if (HasAttribute(line, kAttributeMid)) {
2821 // RFC 3388
2822 // mid-attribute = "a=mid:" identification-tag
2823 // identification-tag = token
2824 // Use the mid identification-tag as the content name.
2825 if (!GetValue(line, kAttributeMid, &mline_id, error)) {
2826 return false;
2827 }
2828 *content_name = mline_id;
deadbeef25ed4352016-12-12 18:37:36 -08002829 } else if (HasAttribute(line, kAttributeBundleOnly)) {
2830 *bundle_only = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002831 } else if (HasAttribute(line, kAttributeCandidate)) {
2832 Candidate candidate;
2833 if (!ParseCandidate(line, &candidate, error, false)) {
2834 return false;
2835 }
deadbeef7bcdb692017-01-20 12:43:58 -08002836 // ParseCandidate will parse non-standard ufrag and password attributes,
2837 // since it's used for candidate trickling, but we only want to process
2838 // the "a=ice-ufrag"/"a=ice-pwd" values in a session description, so
2839 // strip them off at this point.
2840 candidate.set_username(std::string());
2841 candidate.set_password(std::string());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002842 candidates_orig.push_back(candidate);
2843 } else if (HasAttribute(line, kAttributeIceUfrag)) {
2844 if (!GetValue(line, kAttributeIceUfrag, &transport->ice_ufrag, error)) {
2845 return false;
2846 }
2847 } else if (HasAttribute(line, kAttributeIcePwd)) {
2848 if (!GetValue(line, kAttributeIcePwd, &transport->ice_pwd, error)) {
2849 return false;
2850 }
2851 } else if (HasAttribute(line, kAttributeIceOption)) {
2852 if (!ParseIceOptions(line, &transport->transport_options, error)) {
2853 return false;
2854 }
2855 } else if (HasAttribute(line, kAttributeFmtp)) {
2856 if (!ParseFmtpAttributes(line, media_type, media_desc, error)) {
2857 return false;
2858 }
2859 } else if (HasAttribute(line, kAttributeFingerprint)) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00002860 rtc::SSLFingerprint* fingerprint = NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002861
2862 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2863 return false;
2864 }
2865 transport->identity_fingerprint.reset(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002866 } else if (HasAttribute(line, kAttributeSetup)) {
2867 if (!ParseDtlsSetup(line, &(transport->connection_role), error)) {
2868 return false;
2869 }
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002870 } else if (IsDtlsSctp(protocol) && HasAttribute(line, kAttributeSctpPort)) {
deadbeef7e146cb2016-09-28 10:04:34 -07002871 if (media_type != cricket::MEDIA_TYPE_DATA) {
2872 return ParseFailed(
2873 line, "sctp-port attribute found in non-data media description.",
2874 error);
2875 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002876 int sctp_port;
2877 if (!ParseSctpPort(line, &sctp_port, error)) {
2878 return false;
2879 }
Steve Antonb1c1de12017-12-21 15:14:30 -08002880 if (!AddSctpDataCodec(media_desc->as_data(), sctp_port)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002881 return false;
2882 }
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002883 } else if (IsRtp(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002884 //
2885 // RTP specific attrubtes
2886 //
2887 if (HasAttribute(line, kAttributeRtcpMux)) {
2888 media_desc->set_rtcp_mux(true);
deadbeef13871492015-12-09 12:37:51 -08002889 } else if (HasAttribute(line, kAttributeRtcpReducedSize)) {
2890 media_desc->set_rtcp_reduced_size(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002891 } else if (HasAttribute(line, kAttributeSsrcGroup)) {
2892 if (!ParseSsrcGroupAttribute(line, &ssrc_groups, error)) {
2893 return false;
2894 }
2895 } else if (HasAttribute(line, kAttributeSsrc)) {
Steve Antone831b8c2018-02-01 12:22:16 -08002896 if (!ParseSsrcAttribute(line, &ssrc_infos, msid_signaling, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002897 return false;
2898 }
2899 } else if (HasAttribute(line, kAttributeCrypto)) {
2900 if (!ParseCryptoAttribute(line, media_desc, error)) {
2901 return false;
2902 }
2903 } else if (HasAttribute(line, kAttributeRtpmap)) {
deadbeef67cf2c12016-04-13 10:07:16 -07002904 if (!ParseRtpmapAttribute(line, media_type, payload_types, media_desc,
2905 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002906 return false;
2907 }
2908 } else if (HasAttribute(line, kCodecParamMaxPTime)) {
2909 if (!GetValue(line, kCodecParamMaxPTime, &maxptime_as_string, error)) {
2910 return false;
2911 }
2912 } else if (HasAttribute(line, kAttributeRtcpFb)) {
2913 if (!ParseRtcpFbAttribute(line, media_type, media_desc, error)) {
2914 return false;
2915 }
2916 } else if (HasAttribute(line, kCodecParamPTime)) {
2917 if (!GetValue(line, kCodecParamPTime, &ptime_as_string, error)) {
2918 return false;
2919 }
2920 } else if (HasAttribute(line, kAttributeSendOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002921 media_desc->set_direction(RtpTransceiverDirection::kSendOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002922 } else if (HasAttribute(line, kAttributeRecvOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002923 media_desc->set_direction(RtpTransceiverDirection::kRecvOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002924 } else if (HasAttribute(line, kAttributeInactive)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002925 media_desc->set_direction(RtpTransceiverDirection::kInactive);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002926 } else if (HasAttribute(line, kAttributeSendRecv)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002927 media_desc->set_direction(RtpTransceiverDirection::kSendRecv);
Johannes Kron0854eb62018-10-10 22:33:20 +02002928 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
2929 media_desc->set_mixed_one_two_byte_header_extensions_supported(
2930 MediaContentDescription::kMedia);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002931 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002932 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002933 if (!ParseExtmap(line, &extmap, error)) {
2934 return false;
2935 }
2936 media_desc->AddRtpHeaderExtension(extmap);
2937 } else if (HasAttribute(line, kAttributeXGoogleFlag)) {
2938 // Experimental attribute. Conference mode activates more aggressive
2939 // AEC and NS settings.
Steve Anton36b29d12017-10-30 09:57:42 -07002940 // TODO(deadbeef): expose API to set these directly.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002941 std::string flag_value;
2942 if (!GetValue(line, kAttributeXGoogleFlag, &flag_value, error)) {
2943 return false;
2944 }
2945 if (flag_value.compare(kValueConference) == 0)
2946 media_desc->set_conference_mode(true);
deadbeef9d3584c2016-02-16 17:54:10 -08002947 } else if (HasAttribute(line, kAttributeMsid)) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002948 if (!ParseMsidAttribute(line, &stream_ids, &track_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002949 return false;
2950 }
Steve Antone831b8c2018-02-01 12:22:16 -08002951 *msid_signaling |= cricket::kMsidSignalingMediaSection;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002952 }
2953 } else {
2954 // Only parse lines that we are interested of.
Mirko Bonadei675513b2017-11-09 11:09:25 +01002955 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002956 continue;
2957 }
2958 }
2959
2960 // Create tracks from the |ssrc_infos|.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -08002961 // If the stream_id/track_id for all SSRCS are identical, one StreamParams
2962 // will be created in CreateTracksFromSsrcInfos, containing all the SSRCs from
2963 // the m= section.
Seth Hampson5897a6e2018-04-03 11:16:33 -07002964 if (!ssrc_infos.empty()) {
2965 CreateTracksFromSsrcInfos(ssrc_infos, stream_ids, track_id, &tracks,
2966 *msid_signaling);
2967 } else if (media_type != cricket::MEDIA_TYPE_DATA &&
2968 (*msid_signaling & cricket::kMsidSignalingMediaSection)) {
2969 // If the stream_ids/track_id was signaled but SSRCs were unsignaled we
2970 // still create a track. This isn't done for data media types because
2971 // StreamParams aren't used for SCTP streams, and RTP data channels don't
2972 // support unsignaled SSRCs.
2973 CreateTrackWithNoSsrcs(stream_ids, track_id, &tracks);
2974 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002975
2976 // Add the ssrc group to the track.
Steve Anton4daf66e2018-09-07 14:55:53 -07002977 for (const SsrcGroup& ssrc_group : ssrc_groups) {
2978 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002979 continue;
2980 }
Steve Anton4daf66e2018-09-07 14:55:53 -07002981 uint32_t ssrc = ssrc_group.ssrcs.front();
2982 for (StreamParams& track : tracks) {
2983 if (track.has_ssrc(ssrc)) {
2984 track.ssrc_groups.push_back(ssrc_group);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002985 }
2986 }
2987 }
2988
2989 // Add the new tracks to the |media_desc|.
deadbeef9d3584c2016-02-16 17:54:10 -08002990 for (StreamParams& track : tracks) {
2991 media_desc->AddStream(track);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002992 }
2993
2994 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002995 AudioContentDescription* audio_desc = media_desc->as_audio();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002996 UpdateFromWildcardCodecs(audio_desc);
2997
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002998 // Verify audio codec ensures that no audio codec has been populated with
2999 // only fmtp.
3000 if (!VerifyAudioCodecs(audio_desc)) {
3001 return ParseFailed("Failed to parse audio codecs correctly.", error);
3002 }
3003 AddAudioAttribute(kCodecParamMaxPTime, maxptime_as_string, audio_desc);
3004 AddAudioAttribute(kCodecParamPTime, ptime_as_string, audio_desc);
3005 }
3006
3007 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003008 VideoContentDescription* video_desc = media_desc->as_video();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003009 UpdateFromWildcardCodecs(video_desc);
3010 // Verify video codec ensures that no video codec has been populated with
3011 // only rtcp-fb.
3012 if (!VerifyVideoCodecs(video_desc)) {
3013 return ParseFailed("Failed to parse video codecs correctly.", error);
3014 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003015 }
3016
3017 // RFC 5245
3018 // Update the candidates with the media level "ice-pwd" and "ice-ufrag".
Steve Anton4daf66e2018-09-07 14:55:53 -07003019 for (Candidate& candidate : candidates_orig) {
3020 RTC_DCHECK(candidate.username().empty() ||
3021 candidate.username() == transport->ice_ufrag);
3022 candidate.set_username(transport->ice_ufrag);
3023 RTC_DCHECK(candidate.password().empty());
3024 candidate.set_password(transport->ice_pwd);
3025 candidates->push_back(
3026 new JsepIceCandidate(mline_id, mline_index, candidate));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003027 }
3028 return true;
3029}
3030
Steve Antone831b8c2018-02-01 12:22:16 -08003031bool ParseSsrcAttribute(const std::string& line,
3032 SsrcInfoVec* ssrc_infos,
3033 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003034 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003035 RTC_DCHECK(ssrc_infos != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003036 // RFC 5576
3037 // a=ssrc:<ssrc-id> <attribute>
3038 // a=ssrc:<ssrc-id> <attribute>:<value>
3039 std::string field1, field2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003040 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3041 kSdpDelimiterSpaceChar, &field1, &field2)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003042 const size_t expected_fields = 2;
3043 return ParseFailedExpectFieldNum(line, expected_fields, error);
3044 }
3045
3046 // ssrc:<ssrc-id>
3047 std::string ssrc_id_s;
3048 if (!GetValue(field1, kAttributeSsrc, &ssrc_id_s, error)) {
3049 return false;
3050 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003051 uint32_t ssrc_id = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003052 if (!GetValueFromString(line, ssrc_id_s, &ssrc_id, error)) {
3053 return false;
3054 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003055
3056 std::string attribute;
3057 std::string value;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003058 if (!rtc::tokenize_first(field2, kSdpDelimiterColonChar, &attribute,
3059 &value)) {
3060 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003061 description << "Failed to get the ssrc attribute value from " << field2
3062 << ". Expected format <attribute>:<value>.";
3063 return ParseFailed(line, description.str(), error);
3064 }
3065
3066 // Check if there's already an item for this |ssrc_id|. Create a new one if
3067 // there isn't.
Steve Anton4daf66e2018-09-07 14:55:53 -07003068 auto ssrc_info_it = std::find_if(ssrc_infos->begin(), ssrc_infos->end(),
3069 [ssrc_id](const SsrcInfo& ssrc_info) {
3070 return ssrc_info.ssrc_id == ssrc_id;
3071 });
3072 if (ssrc_info_it == ssrc_infos->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003073 SsrcInfo info;
3074 info.ssrc_id = ssrc_id;
3075 ssrc_infos->push_back(info);
Steve Anton4daf66e2018-09-07 14:55:53 -07003076 ssrc_info_it = ssrc_infos->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003077 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003078 SsrcInfo& ssrc_info = *ssrc_info_it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003079
3080 // Store the info to the |ssrc_info|.
3081 if (attribute == kSsrcAttributeCname) {
3082 // RFC 5576
3083 // cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003084 ssrc_info.cname = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003085 } else if (attribute == kSsrcAttributeMsid) {
3086 // draft-alvestrand-mmusic-msid-00
Seth Hampson5b4f0752018-04-02 16:31:36 -07003087 // msid:identifier [appdata]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003088 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003089 rtc::split(value, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003090 if (fields.size() < 1 || fields.size() > 2) {
Yves Gerey665174f2018-06-19 15:03:05 +02003091 return ParseFailed(
3092 line, "Expected format \"msid:<identifier>[ <appdata>]\".", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003093 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003094 ssrc_info.stream_id = fields[0];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003095 if (fields.size() == 2) {
Steve Anton4daf66e2018-09-07 14:55:53 -07003096 ssrc_info.track_id = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003097 }
Steve Antone831b8c2018-02-01 12:22:16 -08003098 *msid_signaling |= cricket::kMsidSignalingSsrcAttribute;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003099 } else if (attribute == kSsrcAttributeMslabel) {
3100 // draft-alvestrand-rtcweb-mid-01
3101 // mslabel:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003102 ssrc_info.mslabel = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003103 } else if (attribute == kSSrcAttributeLabel) {
3104 // The label isn't defined.
3105 // label:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003106 ssrc_info.label = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003107 }
3108 return true;
3109}
3110
3111bool ParseSsrcGroupAttribute(const std::string& line,
3112 SsrcGroupVec* ssrc_groups,
3113 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003114 RTC_DCHECK(ssrc_groups != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003115 // RFC 5576
3116 // a=ssrc-group:<semantics> <ssrc-id> ...
3117 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003118 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003119 const size_t expected_min_fields = 2;
3120 if (fields.size() < expected_min_fields) {
3121 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3122 }
3123 std::string semantics;
3124 if (!GetValue(fields[0], kAttributeSsrcGroup, &semantics, error)) {
3125 return false;
3126 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003127 std::vector<uint32_t> ssrcs;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003128 for (size_t i = 1; i < fields.size(); ++i) {
Peter Boström0c4e06b2015-10-07 12:23:21 +02003129 uint32_t ssrc = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003130 if (!GetValueFromString(line, fields[i], &ssrc, error)) {
3131 return false;
3132 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003133 ssrcs.push_back(ssrc);
3134 }
3135 ssrc_groups->push_back(SsrcGroup(semantics, ssrcs));
3136 return true;
3137}
3138
3139bool ParseCryptoAttribute(const std::string& line,
3140 MediaContentDescription* media_desc,
3141 SdpParseError* error) {
3142 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003143 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003144 // RFC 4568
3145 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
3146 const size_t expected_min_fields = 3;
3147 if (fields.size() < expected_min_fields) {
3148 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3149 }
3150 std::string tag_value;
3151 if (!GetValue(fields[0], kAttributeCrypto, &tag_value, error)) {
3152 return false;
3153 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003154 int tag = 0;
3155 if (!GetValueFromString(line, tag_value, &tag, error)) {
3156 return false;
3157 }
jbauch083b73f2015-07-16 02:46:32 -07003158 const std::string& crypto_suite = fields[1];
3159 const std::string& key_params = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003160 std::string session_params;
3161 if (fields.size() > 3) {
3162 session_params = fields[3];
3163 }
Yves Gerey665174f2018-06-19 15:03:05 +02003164 media_desc->AddCrypto(
3165 CryptoParams(tag, crypto_suite, key_params, session_params));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003166 return true;
3167}
3168
3169// Updates or creates a new codec entry in the audio description with according
deadbeef67cf2c12016-04-13 10:07:16 -07003170// to |name|, |clockrate|, |bitrate|, and |channels|.
3171void UpdateCodec(int payload_type,
3172 const std::string& name,
3173 int clockrate,
3174 int bitrate,
3175 size_t channels,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003176 AudioContentDescription* audio_desc) {
3177 // Codec may already be populated with (only) optional parameters
3178 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003179 cricket::AudioCodec codec =
3180 GetCodecWithPayloadType(audio_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003181 codec.name = name;
3182 codec.clockrate = clockrate;
3183 codec.bitrate = bitrate;
3184 codec.channels = channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003185 AddOrReplaceCodec<AudioContentDescription, cricket::AudioCodec>(audio_desc,
3186 codec);
3187}
3188
3189// Updates or creates a new codec entry in the video description according to
deadbeef67cf2c12016-04-13 10:07:16 -07003190// |name|, |width|, |height|, and |framerate|.
3191void UpdateCodec(int payload_type,
3192 const std::string& name,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003193 VideoContentDescription* video_desc) {
3194 // Codec may already be populated with (only) optional parameters
3195 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003196 cricket::VideoCodec codec =
3197 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003198 codec.name = name;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003199 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
3200 codec);
3201}
3202
3203bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003204 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -07003205 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003206 MediaContentDescription* media_desc,
3207 SdpParseError* error) {
3208 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003209 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003210 // RFC 4566
3211 // a=rtpmap:<payload type> <encoding name>/<clock rate>[/<encodingparameters>]
3212 const size_t expected_min_fields = 2;
3213 if (fields.size() < expected_min_fields) {
3214 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3215 }
3216 std::string payload_type_value;
3217 if (!GetValue(fields[0], kAttributeRtpmap, &payload_type_value, error)) {
3218 return false;
3219 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003220 int payload_type = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003221 if (!GetPayloadTypeFromString(line, payload_type_value, &payload_type,
3222 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003223 return false;
3224 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003225
deadbeef67cf2c12016-04-13 10:07:16 -07003226 if (std::find(payload_types.begin(), payload_types.end(), payload_type) ==
3227 payload_types.end()) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003228 RTC_LOG(LS_WARNING) << "Ignore rtpmap line that did not appear in the "
Jonas Olsson45cc8902018-02-13 10:37:07 +01003229 "<fmt> of the m-line: "
3230 << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003231 return true;
3232 }
jbauch083b73f2015-07-16 02:46:32 -07003233 const std::string& encoder = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003234 std::vector<std::string> codec_params;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00003235 rtc::split(encoder, '/', &codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003236 // <encoding name>/<clock rate>[/<encodingparameters>]
3237 // 2 mandatory fields
3238 if (codec_params.size() < 2 || codec_params.size() > 3) {
3239 return ParseFailed(line,
3240 "Expected format \"<encoding name>/<clock rate>"
3241 "[/<encodingparameters>]\".",
3242 error);
3243 }
jbauch083b73f2015-07-16 02:46:32 -07003244 const std::string& encoding_name = codec_params[0];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003245 int clock_rate = 0;
3246 if (!GetValueFromString(line, codec_params[1], &clock_rate, error)) {
3247 return false;
3248 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003249 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003250 VideoContentDescription* video_desc = media_desc->as_video();
Yves Gerey665174f2018-06-19 15:03:05 +02003251 UpdateCodec(payload_type, encoding_name, video_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003252 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3253 // RFC 4566
3254 // For audio streams, <encoding parameters> indicates the number
3255 // of audio channels. This parameter is OPTIONAL and may be
3256 // omitted if the number of channels is one, provided that no
3257 // additional parameters are needed.
Peter Kasting69558702016-01-12 16:26:35 -08003258 size_t channels = 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003259 if (codec_params.size() == 3) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003260 if (!GetValueFromString(line, codec_params[2], &channels, error)) {
3261 return false;
3262 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003263 }
Steve Antonb1c1de12017-12-21 15:14:30 -08003264 AudioContentDescription* audio_desc = media_desc->as_audio();
ossue1405ad2017-01-23 08:55:48 -08003265 UpdateCodec(payload_type, encoding_name, clock_rate, 0, channels,
deadbeef67cf2c12016-04-13 10:07:16 -07003266 audio_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003267 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003268 DataContentDescription* data_desc = media_desc->as_data();
deadbeef67cf2c12016-04-13 10:07:16 -07003269 data_desc->AddCodec(cricket::DataCodec(payload_type, encoding_name));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003270 }
3271 return true;
3272}
3273
Yves Gerey665174f2018-06-19 15:03:05 +02003274bool ParseFmtpParam(const std::string& line,
3275 std::string* parameter,
3276 std::string* value,
3277 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003278 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, parameter, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003279 ParseFailed(line, "Unable to parse fmtp parameter. \'=\' missing.", error);
3280 return false;
3281 }
3282 // a=fmtp:<payload_type> <param1>=<value1>; <param2>=<value2>; ...
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003283 return true;
3284}
3285
Yves Gerey665174f2018-06-19 15:03:05 +02003286bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003287 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003288 MediaContentDescription* media_desc,
3289 SdpParseError* error) {
3290 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3291 media_type != cricket::MEDIA_TYPE_VIDEO) {
3292 return true;
3293 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003294
3295 std::string line_payload;
3296 std::string line_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003297
3298 // RFC 5576
3299 // a=fmtp:<format> <format specific parameters>
3300 // At least two fields, whereas the second one is any of the optional
3301 // parameters.
Jonas Olssonec9e4922018-09-05 09:53:49 +02003302 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3303 kSdpDelimiterSpaceChar, &line_payload,
3304 &line_params)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003305 ParseFailedExpectMinFieldNum(line, 2, error);
3306 return false;
3307 }
3308
Donald Curtis0e07f922015-05-15 09:21:23 -07003309 // Parse out the payload information.
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003310 std::string payload_type_str;
Donald Curtis0e07f922015-05-15 09:21:23 -07003311 if (!GetValue(line_payload, kAttributeFmtp, &payload_type_str, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003312 return false;
3313 }
3314
Donald Curtis0e07f922015-05-15 09:21:23 -07003315 int payload_type = 0;
Donald Curtis144d0182015-05-15 13:14:24 -07003316 if (!GetPayloadTypeFromString(line_payload, payload_type_str, &payload_type,
3317 error)) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003318 return false;
3319 }
3320
3321 // Parse out format specific parameters.
3322 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003323 rtc::split(line_params, kSdpDelimiterSemicolonChar, &fields);
Donald Curtis0e07f922015-05-15 09:21:23 -07003324
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003325 cricket::CodecParameterMap codec_params;
Donald Curtis144d0182015-05-15 13:14:24 -07003326 for (auto& iter : fields) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003327 if (iter.find(kSdpDelimiterEqual) == std::string::npos) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003328 // Only fmtps with equals are currently supported. Other fmtp types
3329 // should be ignored. Unknown fmtps do not constitute an error.
3330 continue;
3331 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003332
3333 std::string name;
3334 std::string value;
3335 if (!ParseFmtpParam(rtc::string_trim(iter), &name, &value, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003336 return false;
3337 }
3338 codec_params[name] = value;
3339 }
3340
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003341 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3342 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003343 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003344 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
3345 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003346 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003347 }
3348 return true;
3349}
3350
Yves Gerey665174f2018-06-19 15:03:05 +02003351bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003352 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003353 MediaContentDescription* media_desc,
3354 SdpParseError* error) {
3355 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3356 media_type != cricket::MEDIA_TYPE_VIDEO) {
3357 return true;
3358 }
3359 std::vector<std::string> rtcp_fb_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003360 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &rtcp_fb_fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003361 if (rtcp_fb_fields.size() < 2) {
3362 return ParseFailedGetValue(line, kAttributeRtcpFb, error);
3363 }
3364 std::string payload_type_string;
3365 if (!GetValue(rtcp_fb_fields[0], kAttributeRtcpFb, &payload_type_string,
3366 error)) {
3367 return false;
3368 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003369 int payload_type = kWildcardPayloadType;
3370 if (payload_type_string != "*") {
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003371 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3372 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003373 return false;
3374 }
3375 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003376 std::string id = rtcp_fb_fields[1];
3377 std::string param = "";
3378 for (std::vector<std::string>::iterator iter = rtcp_fb_fields.begin() + 2;
3379 iter != rtcp_fb_fields.end(); ++iter) {
3380 param.append(*iter);
3381 }
3382 const cricket::FeedbackParam feedback_param(id, param);
3383
3384 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003385 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
3386 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003387 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003388 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
3389 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003390 }
3391 return true;
3392}
3393
3394} // namespace webrtc