blob: 0cd6beceefa377dffe7f934b9e5b96635046c545 [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>
Steve Anton4905edb2018-10-15 19:27:44 -070023#include <utility>
henrike@webrtc.org28e20752013-07-10 00:45:36 +000024#include <vector>
25
Niels Möller039743e2018-10-23 10:07:25 +020026#include "absl/strings/match.h"
Patrik Höglunde2d6a062017-10-05 14:53:33 +020027#include "api/candidate.h"
Patrik Höglund7aee3d52017-11-15 13:15:17 +010028#include "api/cryptoparams.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020029#include "api/jsepicecandidate.h"
30#include "api/jsepsessiondescription.h"
Niels Möller039743e2018-10-23 10:07:25 +020031#include "api/mediatypes.h"
isheriff6f8d6862016-05-26 11:24:55 -070032// for RtpExtension
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020033#include "api/rtpparameters.h"
34#include "media/base/codec.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020035#include "media/base/mediaconstants.h"
36#include "media/base/rtputils.h"
37#include "media/sctp/sctptransportinternal.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020038#include "p2p/base/p2pconstants.h"
39#include "p2p/base/port.h"
40#include "pc/mediasession.h"
41#include "rtc_base/arraysize.h"
42#include "rtc_base/checks.h"
43#include "rtc_base/logging.h"
44#include "rtc_base/messagedigest.h"
Jonas Olssonec9e4922018-09-05 09:53:49 +020045#include "rtc_base/strings/string_builder.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020046#include "rtc_base/stringutils.h"
henrike@webrtc.org28e20752013-07-10 00:45:36 +000047
48using cricket::AudioContentDescription;
49using cricket::Candidate;
50using cricket::Candidates;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000051using cricket::ContentInfo;
52using cricket::CryptoParams;
53using cricket::DataContentDescription;
54using cricket::ICE_CANDIDATE_COMPONENT_RTP;
55using cricket::ICE_CANDIDATE_COMPONENT_RTCP;
56using cricket::kCodecParamMaxBitrate;
57using cricket::kCodecParamMaxPTime;
58using cricket::kCodecParamMaxQuantization;
59using cricket::kCodecParamMinBitrate;
60using cricket::kCodecParamMinPTime;
61using cricket::kCodecParamPTime;
62using cricket::kCodecParamSPropStereo;
buildbot@webrtc.orged97bb02014-05-07 11:15:20 +000063using cricket::kCodecParamStartBitrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000064using cricket::kCodecParamStereo;
65using cricket::kCodecParamUseInbandFec;
Minyue Li7100dcd2015-03-27 05:05:59 +010066using cricket::kCodecParamUseDtx;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000067using cricket::kCodecParamSctpProtocol;
68using cricket::kCodecParamSctpStreams;
henrike@webrtc.org1e09a712013-07-26 19:17:59 +000069using cricket::kCodecParamMaxAverageBitrate;
buildbot@webrtc.org5d639b32014-09-10 07:57:12 +000070using cricket::kCodecParamMaxPlaybackRate;
stefan@webrtc.org85d27942014-06-09 12:51:39 +000071using cricket::kCodecParamAssociatedPayloadType;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000072using cricket::MediaContentDescription;
73using cricket::MediaType;
isheriff6f8d6862016-05-26 11:24:55 -070074using cricket::RtpHeaderExtensions;
Steve Anton5adfafd2017-12-20 16:34:00 -080075using cricket::MediaProtocolType;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000076using cricket::SsrcGroup;
77using cricket::StreamParams;
78using cricket::StreamParamsVec;
79using cricket::TransportDescription;
80using cricket::TransportInfo;
81using cricket::VideoContentDescription;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +000082using rtc::SocketAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000083
henrike@webrtc.org28e20752013-07-10 00:45:36 +000084namespace cricket {
85class SessionDescription;
86}
87
deadbeef90f1e1e2017-02-10 12:35:05 -080088// TODO(deadbeef): Switch to using anonymous namespace rather than declaring
89// everything "static".
henrike@webrtc.org28e20752013-07-10 00:45:36 +000090namespace webrtc {
91
92// Line type
93// RFC 4566
94// An SDP session description consists of a number of lines of text of
95// the form:
96// <type>=<value>
97// where <type> MUST be exactly one case-significant character.
deadbeef9d3584c2016-02-16 17:54:10 -080098static const int kLinePrefixLength = 2; // Length of <type>=
henrike@webrtc.org28e20752013-07-10 00:45:36 +000099static const char kLineTypeVersion = 'v';
100static const char kLineTypeOrigin = 'o';
101static const char kLineTypeSessionName = 's';
102static const char kLineTypeSessionInfo = 'i';
103static const char kLineTypeSessionUri = 'u';
104static const char kLineTypeSessionEmail = 'e';
105static const char kLineTypeSessionPhone = 'p';
106static const char kLineTypeSessionBandwidth = 'b';
107static const char kLineTypeTiming = 't';
108static const char kLineTypeRepeatTimes = 'r';
109static const char kLineTypeTimeZone = 'z';
110static const char kLineTypeEncryptionKey = 'k';
111static const char kLineTypeMedia = 'm';
112static const char kLineTypeConnection = 'c';
113static const char kLineTypeAttributes = 'a';
114
115// Attributes
116static const char kAttributeGroup[] = "group";
117static const char kAttributeMid[] = "mid";
deadbeef9d3584c2016-02-16 17:54:10 -0800118static const char kAttributeMsid[] = "msid";
deadbeef25ed4352016-12-12 18:37:36 -0800119static const char kAttributeBundleOnly[] = "bundle-only";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000120static const char kAttributeRtcpMux[] = "rtcp-mux";
deadbeef13871492015-12-09 12:37:51 -0800121static const char kAttributeRtcpReducedSize[] = "rtcp-rsize";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000122static const char kAttributeSsrc[] = "ssrc";
123static const char kSsrcAttributeCname[] = "cname";
Johannes Kron0854eb62018-10-10 22:33:20 +0200124static const char kAttributeExtmapAllowMixed[] = "extmap-allow-mixed";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000125static const char kAttributeExtmap[] = "extmap";
126// draft-alvestrand-mmusic-msid-01
127// a=msid-semantic: WMS
Seth Hampson5b4f0752018-04-02 16:31:36 -0700128// This is a legacy field supported only for Plan B semantics.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000129static const char kAttributeMsidSemantics[] = "msid-semantic";
130static const char kMediaStreamSemantic[] = "WMS";
131static const char kSsrcAttributeMsid[] = "msid";
132static const char kDefaultMsid[] = "default";
Seth Hampson5b4f0752018-04-02 16:31:36 -0700133static const char kNoStreamMsid[] = "-";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000134static const char kSsrcAttributeMslabel[] = "mslabel";
135static const char kSSrcAttributeLabel[] = "label";
136static const char kAttributeSsrcGroup[] = "ssrc-group";
137static const char kAttributeCrypto[] = "crypto";
138static const char kAttributeCandidate[] = "candidate";
139static const char kAttributeCandidateTyp[] = "typ";
140static const char kAttributeCandidateRaddr[] = "raddr";
141static const char kAttributeCandidateRport[] = "rport";
honghaiza54a0802015-12-16 18:37:23 -0800142static const char kAttributeCandidateUfrag[] = "ufrag";
143static const char kAttributeCandidatePwd[] = "pwd";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000144static const char kAttributeCandidateGeneration[] = "generation";
honghaiza0c44ea2016-03-23 16:07:48 -0700145static const char kAttributeCandidateNetworkId[] = "network-id";
honghaize1a0c942016-02-16 14:54:56 -0800146static const char kAttributeCandidateNetworkCost[] = "network-cost";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000147static const char kAttributeFingerprint[] = "fingerprint";
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000148static const char kAttributeSetup[] = "setup";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000149static const char kAttributeFmtp[] = "fmtp";
150static const char kAttributeRtpmap[] = "rtpmap";
wu@webrtc.org78187522013-10-07 23:32:02 +0000151static const char kAttributeSctpmap[] = "sctpmap";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000152static const char kAttributeRtcp[] = "rtcp";
153static const char kAttributeIceUfrag[] = "ice-ufrag";
154static const char kAttributeIcePwd[] = "ice-pwd";
155static const char kAttributeIceLite[] = "ice-lite";
156static const char kAttributeIceOption[] = "ice-options";
157static const char kAttributeSendOnly[] = "sendonly";
158static const char kAttributeRecvOnly[] = "recvonly";
159static const char kAttributeRtcpFb[] = "rtcp-fb";
160static const char kAttributeSendRecv[] = "sendrecv";
161static const char kAttributeInactive[] = "inactive";
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +0000162// draft-ietf-mmusic-sctp-sdp-07
163// a=sctp-port
164static const char kAttributeSctpPort[] = "sctp-port";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000165
166// Experimental flags
167static const char kAttributeXGoogleFlag[] = "x-google-flag";
168static const char kValueConference[] = "conference";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000169
170// Candidate
171static const char kCandidateHost[] = "host";
172static const char kCandidateSrflx[] = "srflx";
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700173static const char kCandidatePrflx[] = "prflx";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000174static const char kCandidateRelay[] = "relay";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +0000175static const char kTcpCandidateType[] = "tcptype";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000176
Jonas Olssonec9e4922018-09-05 09:53:49 +0200177// rtc::StringBuilder doesn't have a << overload for chars, while rtc::split and
178// rtc::tokenize_first both take a char delimiter. To handle both cases these
179// constants come in pairs of a chars and length-one strings.
180static const char kSdpDelimiterEqual[] = "=";
181static const char kSdpDelimiterEqualChar = '=';
182static const char kSdpDelimiterSpace[] = " ";
183static const char kSdpDelimiterSpaceChar = ' ';
184static const char kSdpDelimiterColon[] = ":";
185static const char kSdpDelimiterColonChar = ':';
186static const char kSdpDelimiterSemicolon[] = ";";
187static const char kSdpDelimiterSemicolonChar = ';';
188static const char kSdpDelimiterSlashChar = '/';
189static const char kNewLine[] = "\n";
190static const char kNewLineChar = '\n';
191static const char kReturnChar = '\r';
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000192static const char kLineBreak[] = "\r\n";
193
Steve Anton36b29d12017-10-30 09:57:42 -0700194// TODO(deadbeef): Generate the Session and Time description
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000195// instead of hardcoding.
196static const char kSessionVersion[] = "v=0";
197// RFC 4566
198static const char kSessionOriginUsername[] = "-";
199static const char kSessionOriginSessionId[] = "0";
200static const char kSessionOriginSessionVersion[] = "0";
201static const char kSessionOriginNettype[] = "IN";
202static const char kSessionOriginAddrtype[] = "IP4";
203static const char kSessionOriginAddress[] = "127.0.0.1";
204static const char kSessionName[] = "s=-";
205static const char kTimeDescription[] = "t=0 0";
206static const char kAttrGroup[] = "a=group:BUNDLE";
207static const char kConnectionNettype[] = "IN";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000208static const char kConnectionIpv4Addrtype[] = "IP4";
209static const char kConnectionIpv6Addrtype[] = "IP6";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000210static const char kMediaTypeVideo[] = "video";
211static const char kMediaTypeAudio[] = "audio";
212static const char kMediaTypeData[] = "application";
213static const char kMediaPortRejected[] = "0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000214// draft-ietf-mmusic-trickle-ice-01
215// When no candidates have been gathered, set the connection
216// address to IP6 ::.
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000217// TODO(perkj): FF can not parse IP6 ::. See http://crbug/430333
218// Use IPV4 per default.
219static const char kDummyAddress[] = "0.0.0.0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000220static const char kDummyPort[] = "9";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000221// RFC 3556
222static const char kApplicationSpecificMaximum[] = "AS";
223
wu@webrtc.org78187522013-10-07 23:32:02 +0000224static const char kDefaultSctpmapProtocol[] = "webrtc-datachannel";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000225
pkasting@chromium.orgd3245462015-02-23 21:28:22 +0000226// RTP payload type is in the 0-127 range. Use -1 to indicate "all" payload
227// types.
228const int kWildcardPayloadType = -1;
229
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000230struct SsrcInfo {
Peter Boström0c4e06b2015-10-07 12:23:21 +0200231 uint32_t ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000232 std::string cname;
deadbeef9d3584c2016-02-16 17:54:10 -0800233 std::string stream_id;
234 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000235
236 // For backward compatibility.
237 // TODO(ronghuawu): Remove below 2 fields once all the clients support msid.
238 std::string label;
239 std::string mslabel;
240};
241typedef std::vector<SsrcInfo> SsrcInfoVec;
242typedef std::vector<SsrcGroup> SsrcGroupVec;
243
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000244template <class T>
245static void AddFmtpLine(const T& codec, std::string* message);
246static void BuildMediaDescription(const ContentInfo* content_info,
247 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200248 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000249 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -0800250 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000251 std::string* message);
zstein4b2e0822017-02-17 19:48:38 -0800252static void BuildSctpContentAttributes(std::string* message,
253 int sctp_port,
254 bool use_sctpmap);
deadbeef9d3584c2016-02-16 17:54:10 -0800255static void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200256 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -0800257 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -0800258 std::string* message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000259static void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200260 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000261 std::string* message);
262static void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -0800263 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000264 std::string* message);
265static void BuildIceOptions(const std::vector<std::string>& transport_options,
266 std::string* message);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +0000267static bool IsRtp(const std::string& protocol);
268static bool IsDtlsSctp(const std::string& protocol);
zhihuang38989e52017-03-21 11:04:53 -0700269static bool ParseSessionDescription(const std::string& message,
270 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000271 std::string* session_id,
272 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000273 TransportDescription* session_td,
274 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700275 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000276 cricket::SessionDescription* desc,
277 SdpParseError* error);
278static bool ParseGroupAttribute(const std::string& line,
279 cricket::SessionDescription* desc,
280 SdpParseError* error);
281static bool ParseMediaDescription(
282 const std::string& message,
283 const TransportDescription& session_td,
284 const RtpHeaderExtensions& session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700285 size_t* pos,
286 const rtc::SocketAddress& session_connection_addr,
287 cricket::SessionDescription* desc,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000288 std::vector<JsepIceCandidate*>* candidates,
289 SdpParseError* error);
290static bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200291 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000292 int mline_index,
293 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -0700294 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000295 size_t* pos,
296 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -0800297 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -0800298 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000299 MediaContentDescription* media_desc,
300 TransportDescription* transport,
301 std::vector<JsepIceCandidate*>* candidates,
302 SdpParseError* error);
303static bool ParseSsrcAttribute(const std::string& line,
304 SsrcInfoVec* ssrc_infos,
Steve Antone831b8c2018-02-01 12:22:16 -0800305 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000306 SdpParseError* error);
307static bool ParseSsrcGroupAttribute(const std::string& line,
308 SsrcGroupVec* ssrc_groups,
309 SdpParseError* error);
310static bool ParseCryptoAttribute(const std::string& line,
311 MediaContentDescription* media_desc,
312 SdpParseError* error);
313static bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200314 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -0700315 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000316 MediaContentDescription* media_desc,
317 SdpParseError* error);
318static bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200319 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000320 MediaContentDescription* media_desc,
321 SdpParseError* error);
Yves Gerey665174f2018-06-19 15:03:05 +0200322static bool ParseFmtpParam(const std::string& line,
323 std::string* parameter,
324 std::string* value,
325 SdpParseError* error);
326static bool ParseCandidate(const std::string& message,
327 Candidate* candidate,
328 SdpParseError* error,
329 bool is_raw);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000330static bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200331 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000332 MediaContentDescription* media_desc,
333 SdpParseError* error);
334static bool ParseIceOptions(const std::string& line,
335 std::vector<std::string>* transport_options,
336 SdpParseError* error);
337static bool ParseExtmap(const std::string& line,
isheriff6f8d6862016-05-26 11:24:55 -0700338 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000339 SdpParseError* error);
Steve Anton4905edb2018-10-15 19:27:44 -0700340static bool ParseFingerprintAttribute(
341 const std::string& line,
342 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
343 SdpParseError* error);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000344static bool ParseDtlsSetup(const std::string& line,
345 cricket::ConnectionRole* role,
346 SdpParseError* error);
deadbeef9d3584c2016-02-16 17:54:10 -0800347static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700348 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -0800349 std::string* track_id,
350 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000351
352// Helper functions
353
354// Below ParseFailed*** functions output the line that caused the parsing
355// failure and the detailed reason (|description|) of the failure to |error|.
356// The functions always return false so that they can be used directly in the
357// following way when error happens:
358// "return ParseFailed***(...);"
359
360// The line starting at |line_start| of |message| is the failing line.
361// The reason for the failure should be provided in the |description|.
362// An example of a description could be "unknown character".
363static bool ParseFailed(const std::string& message,
364 size_t line_start,
365 const std::string& description,
366 SdpParseError* error) {
367 // Get the first line of |message| from |line_start|.
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000368 std::string first_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000369 size_t line_end = message.find(kNewLine, line_start);
370 if (line_end != std::string::npos) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200371 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000372 --line_end;
373 }
374 first_line = message.substr(line_start, (line_end - line_start));
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000375 } else {
376 first_line = message.substr(line_start);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000377 }
378
379 if (error) {
380 error->line = first_line;
381 error->description = description;
382 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100383 RTC_LOG(LS_ERROR) << "Failed to parse: \"" << first_line
384 << "\". Reason: " << description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000385 return false;
386}
387
388// |line| is the failing line. The reason for the failure should be
389// provided in the |description|.
390static bool ParseFailed(const std::string& line,
391 const std::string& description,
392 SdpParseError* error) {
393 return ParseFailed(line, 0, description, error);
394}
395
396// Parses failure where the failing SDP line isn't know or there are multiple
397// failing lines.
Yves Gerey665174f2018-06-19 15:03:05 +0200398static bool ParseFailed(const std::string& description, SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000399 return ParseFailed("", description, error);
400}
401
402// |line| is the failing line. The failure is due to the fact that |line|
403// doesn't have |expected_fields| fields.
404static bool ParseFailedExpectFieldNum(const std::string& line,
405 int expected_fields,
406 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200407 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000408 description << "Expects " << expected_fields << " fields.";
409 return ParseFailed(line, description.str(), error);
410}
411
412// |line| is the failing line. The failure is due to the fact that |line| has
413// less than |expected_min_fields| fields.
414static bool ParseFailedExpectMinFieldNum(const std::string& line,
415 int expected_min_fields,
416 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200417 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000418 description << "Expects at least " << expected_min_fields << " fields.";
419 return ParseFailed(line, description.str(), error);
420}
421
422// |line| is the failing line. The failure is due to the fact that it failed to
423// get the value of |attribute|.
424static bool ParseFailedGetValue(const std::string& line,
425 const std::string& attribute,
426 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200427 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000428 description << "Failed to get the value of attribute: " << attribute;
429 return ParseFailed(line, description.str(), error);
430}
431
432// The line starting at |line_start| of |message| is the failing line. The
433// failure is due to the line type (e.g. the "m" part of the "m-line")
434// not matching what is expected. The expected line type should be
435// provided as |line_type|.
436static bool ParseFailedExpectLine(const std::string& message,
437 size_t line_start,
438 const char line_type,
439 const std::string& line_value,
440 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200441 rtc::StringBuilder description;
442 description << "Expect line: " << std::string(1, line_type) << "="
443 << line_value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000444 return ParseFailed(message, line_start, description.str(), error);
445}
446
447static bool AddLine(const std::string& line, std::string* message) {
448 if (!message)
449 return false;
450
451 message->append(line);
452 message->append(kLineBreak);
453 return true;
454}
455
456static bool GetLine(const std::string& message,
457 size_t* pos,
458 std::string* line) {
459 size_t line_begin = *pos;
460 size_t line_end = message.find(kNewLine, line_begin);
461 if (line_end == std::string::npos) {
462 return false;
463 }
464 // Update the new start position
465 *pos = line_end + 1;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200466 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000467 --line_end;
468 }
469 *line = message.substr(line_begin, (line_end - line_begin));
470 const char* cline = line->c_str();
471 // RFC 4566
472 // An SDP session description consists of a number of lines of text of
473 // the form:
474 // <type>=<value>
475 // where <type> MUST be exactly one case-significant character and
476 // <value> is structured text whose format depends on <type>.
477 // Whitespace MUST NOT be used on either side of the "=" sign.
Taylor Brandstetter93a7b242018-04-16 10:45:24 -0700478 //
479 // However, an exception to the whitespace rule is made for "s=", since
480 // RFC4566 also says:
481 //
482 // If a session has no meaningful name, the value "s= " SHOULD be used
483 // (i.e., a single space as the session name).
484 if (line->length() < 3 || !islower(cline[0]) ||
Jonas Olssonec9e4922018-09-05 09:53:49 +0200485 cline[1] != kSdpDelimiterEqualChar ||
486 (cline[0] != kLineTypeSessionName &&
487 cline[2] == kSdpDelimiterSpaceChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000488 *pos = line_begin;
489 return false;
490 }
491 return true;
492}
493
494// Init |os| to "|type|=|value|".
495static void InitLine(const char type,
496 const std::string& value,
Jonas Olssonec9e4922018-09-05 09:53:49 +0200497 rtc::StringBuilder* os) {
498 os->Clear();
499 *os << std::string(1, type) << kSdpDelimiterEqual << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000500}
501
502// Init |os| to "a=|attribute|".
Jonas Olssonec9e4922018-09-05 09:53:49 +0200503static void InitAttrLine(const std::string& attribute, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000504 InitLine(kLineTypeAttributes, attribute, os);
505}
506
507// Writes a SDP attribute line based on |attribute| and |value| to |message|.
Yves Gerey665174f2018-06-19 15:03:05 +0200508static void AddAttributeLine(const std::string& attribute,
509 int value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000510 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200511 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000512 InitAttrLine(attribute, &os);
513 os << kSdpDelimiterColon << value;
514 AddLine(os.str(), message);
515}
516
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000517static bool IsLineType(const std::string& message,
518 const char type,
519 size_t line_start) {
520 if (message.size() < line_start + kLinePrefixLength) {
521 return false;
522 }
523 const char* cmessage = message.c_str();
524 return (cmessage[line_start] == type &&
Jonas Olssonec9e4922018-09-05 09:53:49 +0200525 cmessage[line_start + 1] == kSdpDelimiterEqualChar);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000526}
527
Yves Gerey665174f2018-06-19 15:03:05 +0200528static bool IsLineType(const std::string& line, const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000529 return IsLineType(line, type, 0);
530}
531
Yves Gerey665174f2018-06-19 15:03:05 +0200532static bool GetLineWithType(const std::string& message,
533 size_t* pos,
534 std::string* line,
535 const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000536 if (!IsLineType(message, type, *pos)) {
537 return false;
538 }
539
540 if (!GetLine(message, pos, line))
541 return false;
542
543 return true;
544}
545
546static bool HasAttribute(const std::string& line,
547 const std::string& attribute) {
Johannes Kron211856b2018-09-06 12:12:28 +0200548 if (line.compare(kLinePrefixLength, attribute.size(), attribute) == 0) {
549 // Make sure that the match is not only a partial match. If length of
550 // strings doesn't match, the next character of the line must be ':' or ' '.
551 // This function is also used for media descriptions (e.g., "m=audio 9..."),
552 // hence the need to also allow space in the end.
553 RTC_CHECK_LE(kLinePrefixLength + attribute.size(), line.size());
554 if ((kLinePrefixLength + attribute.size()) == line.size() ||
555 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterColonChar ||
556 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterSpaceChar) {
557 return true;
558 }
559 }
560 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000561}
562
Peter Boström0c4e06b2015-10-07 12:23:21 +0200563static bool AddSsrcLine(uint32_t ssrc_id,
564 const std::string& attribute,
565 const std::string& value,
566 std::string* message) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000567 // RFC 5576
568 // a=ssrc:<ssrc-id> <attribute>:<value>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200569 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000570 InitAttrLine(kAttributeSsrc, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200571 os << kSdpDelimiterColon << ssrc_id << kSdpDelimiterSpace << attribute
572 << kSdpDelimiterColon << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000573 return AddLine(os.str(), message);
574}
575
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000576// Get value only from <attribute>:<value>.
Yves Gerey665174f2018-06-19 15:03:05 +0200577static bool GetValue(const std::string& message,
578 const std::string& attribute,
579 std::string* value,
580 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000581 std::string leftpart;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200582 if (!rtc::tokenize_first(message, kSdpDelimiterColonChar, &leftpart, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000583 return ParseFailedGetValue(message, attribute, error);
584 }
585 // The left part should end with the expected attribute.
586 if (leftpart.length() < attribute.length() ||
587 leftpart.compare(leftpart.length() - attribute.length(),
588 attribute.length(), attribute) != 0) {
589 return ParseFailedGetValue(message, attribute, error);
590 }
591 return true;
592}
593
594static bool CaseInsensitiveFind(std::string str1, std::string str2) {
Yves Gerey665174f2018-06-19 15:03:05 +0200595 std::transform(str1.begin(), str1.end(), str1.begin(), ::tolower);
596 std::transform(str2.begin(), str2.end(), str2.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000597 return str1.find(str2) != std::string::npos;
598}
599
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000600template <class T>
601static bool GetValueFromString(const std::string& line,
602 const std::string& s,
603 T* t,
604 SdpParseError* error) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000605 if (!rtc::FromString(s, t)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200606 rtc::StringBuilder description;
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000607 description << "Invalid value: " << s << ".";
608 return ParseFailed(line, description.str(), error);
609 }
610 return true;
611}
612
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000613static bool GetPayloadTypeFromString(const std::string& line,
614 const std::string& s,
615 int* payload_type,
616 SdpParseError* error) {
617 return GetValueFromString(line, s, payload_type, error) &&
Yves Gerey665174f2018-06-19 15:03:05 +0200618 cricket::IsValidRtpPayloadType(*payload_type);
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000619}
620
Seth Hampson5897a6e2018-04-03 11:16:33 -0700621// Creates a StreamParams track in the case when no SSRC lines are signaled.
622// This is a track that does not contain SSRCs and only contains
623// stream_ids/track_id if it's signaled with a=msid lines.
624void CreateTrackWithNoSsrcs(const std::vector<std::string>& msid_stream_ids,
625 const std::string& msid_track_id,
626 StreamParamsVec* tracks) {
627 StreamParams track;
628 if (msid_track_id.empty() || msid_stream_ids.empty()) {
629 // We only create an unsignaled track if a=msid lines were signaled.
630 return;
631 }
632 track.set_stream_ids(msid_stream_ids);
633 track.id = msid_track_id;
634 tracks->push_back(track);
635}
636
637// Creates the StreamParams tracks, for the case when SSRC lines are signaled.
638// |msid_stream_ids| and |msid_track_id| represent the stream/track ID from the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800639// "a=msid" attribute, if it exists. They are empty if the attribute does not
Seth Hampson5897a6e2018-04-03 11:16:33 -0700640// exist. We prioritize getting stream_ids/track_ids signaled in a=msid lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000641void CreateTracksFromSsrcInfos(const SsrcInfoVec& ssrc_infos,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700642 const std::vector<std::string>& msid_stream_ids,
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800643 const std::string& msid_track_id,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700644 StreamParamsVec* tracks,
645 int msid_signaling) {
nisseede5da42017-01-12 05:15:36 -0800646 RTC_DCHECK(tracks != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700647 for (const SsrcInfo& ssrc_info : ssrc_infos) {
648 if (ssrc_info.cname.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000649 continue;
650 }
651
Seth Hampson5b4f0752018-04-02 16:31:36 -0700652 std::vector<std::string> stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000653 std::string track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700654 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
655 // This is the case with Unified Plan SDP msid signaling.
656 stream_ids = msid_stream_ids;
Tomas Gunnarsson191bf5c2018-03-30 10:44:43 +0000657 track_id = msid_track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700658 } else if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
659 // This is the case with Plan B SDP msid signaling.
Steve Anton4daf66e2018-09-07 14:55:53 -0700660 stream_ids.push_back(ssrc_info.stream_id);
661 track_id = ssrc_info.track_id;
662 } else if (!ssrc_info.mslabel.empty()) {
Seth Hampson5b4f0752018-04-02 16:31:36 -0700663 // Since there's no a=msid or a=ssrc msid signaling, this is a sdp from
664 // an older version of client that doesn't support msid.
665 // In that case, we use the mslabel and label to construct the track.
Steve Anton4daf66e2018-09-07 14:55:53 -0700666 stream_ids.push_back(ssrc_info.mslabel);
667 track_id = ssrc_info.label;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700668 } else {
669 // Since no media streams isn't supported with older SDP signaling, we
670 // use a default a stream id.
671 stream_ids.push_back(kDefaultMsid);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000672 }
Seth Hampson5b4f0752018-04-02 16:31:36 -0700673 // If a track ID wasn't populated from the SSRC attributes OR the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800674 // msid attribute, use default/random values.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800675 if (track_id.empty()) {
676 // TODO(ronghuawu): What should we do if the track id doesn't appear?
677 // Create random string (which will be used as track label later)?
678 track_id = rtc::CreateRandomString(8);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000679 }
680
Steve Anton4daf66e2018-09-07 14:55:53 -0700681 auto track_it = std::find_if(
682 tracks->begin(), tracks->end(),
683 [track_id](const StreamParams& track) { return track.id == track_id; });
684 if (track_it == tracks->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000685 // If we don't find an existing track, create a new one.
686 tracks->push_back(StreamParams());
Steve Anton4daf66e2018-09-07 14:55:53 -0700687 track_it = tracks->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000688 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700689 StreamParams& track = *track_it;
690 track.add_ssrc(ssrc_info.ssrc_id);
691 track.cname = ssrc_info.cname;
692 track.set_stream_ids(stream_ids);
693 track.id = track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000694 }
695}
696
Seth Hampson845e8782018-03-02 11:34:10 -0800697void GetMediaStreamIds(const ContentInfo* content,
698 std::set<std::string>* labels) {
Steve Antonb1c1de12017-12-21 15:14:30 -0800699 for (const StreamParams& stream_params :
700 content->media_description()->streams()) {
Seth Hampson845e8782018-03-02 11:34:10 -0800701 for (const std::string& stream_id : stream_params.stream_ids()) {
702 labels->insert(stream_id);
Steve Anton5a26a3a2018-02-28 11:38:47 -0800703 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000704 }
705}
706
707// RFC 5245
708// It is RECOMMENDED that default candidates be chosen based on the
709// likelihood of those candidates to work with the peer that is being
710// contacted. It is RECOMMENDED that relayed > reflexive > host.
711static const int kPreferenceUnknown = 0;
712static const int kPreferenceHost = 1;
713static const int kPreferenceReflexive = 2;
714static const int kPreferenceRelayed = 3;
715
716static int GetCandidatePreferenceFromType(const std::string& type) {
717 int preference = kPreferenceUnknown;
718 if (type == cricket::LOCAL_PORT_TYPE) {
719 preference = kPreferenceHost;
720 } else if (type == cricket::STUN_PORT_TYPE) {
721 preference = kPreferenceReflexive;
722 } else if (type == cricket::RELAY_PORT_TYPE) {
723 preference = kPreferenceRelayed;
724 } else {
nissec80e7412017-01-11 05:56:46 -0800725 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000726 }
727 return preference;
728}
729
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000730// Get ip and port of the default destination from the |candidates| with the
731// given value of |component_id|. The default candidate should be the one most
732// likely to work, typically IPv4 relay.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000733// RFC 5245
734// The value of |component_id| currently supported are 1 (RTP) and 2 (RTCP).
Steve Anton36b29d12017-10-30 09:57:42 -0700735// TODO(deadbeef): Decide the default destination in webrtcsession and
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000736// pass it down via SessionDescription.
Yves Gerey665174f2018-06-19 15:03:05 +0200737static void GetDefaultDestination(const std::vector<Candidate>& candidates,
738 int component_id,
739 std::string* port,
740 std::string* ip,
741 std::string* addr_type) {
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000742 *addr_type = kConnectionIpv4Addrtype;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000743 *port = kDummyPort;
744 *ip = kDummyAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000745 int current_preference = kPreferenceUnknown;
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000746 int current_family = AF_UNSPEC;
Steve Anton4daf66e2018-09-07 14:55:53 -0700747 for (const Candidate& candidate : candidates) {
748 if (candidate.component() != component_id) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000749 continue;
750 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000751 // Default destination should be UDP only.
Steve Anton4daf66e2018-09-07 14:55:53 -0700752 if (candidate.protocol() != cricket::UDP_PROTOCOL_NAME) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000753 continue;
754 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700755 const int preference = GetCandidatePreferenceFromType(candidate.type());
756 const int family = candidate.address().ipaddr().family();
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000757 // See if this candidate is more preferable then the current one if it's the
758 // same family. Or if the current family is IPv4 already so we could safely
759 // ignore all IPv6 ones. WebRTC bug 4269.
760 // http://code.google.com/p/webrtc/issues/detail?id=4269
761 if ((preference <= current_preference && current_family == family) ||
762 (current_family == AF_INET && family == AF_INET6)) {
763 continue;
764 }
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000765 if (family == AF_INET) {
766 addr_type->assign(kConnectionIpv4Addrtype);
767 } else if (family == AF_INET6) {
768 addr_type->assign(kConnectionIpv6Addrtype);
769 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000770 current_preference = preference;
771 current_family = family;
Steve Anton4daf66e2018-09-07 14:55:53 -0700772 *port = candidate.address().PortAsString();
773 *ip = candidate.address().ipaddr().ToString();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000774 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000775}
776
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000777// Gets "a=rtcp" line if found default RTCP candidate from |candidates|.
778static std::string GetRtcpLine(const std::vector<Candidate>& candidates) {
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000779 std::string rtcp_line, rtcp_port, rtcp_ip, addr_type;
Yves Gerey665174f2018-06-19 15:03:05 +0200780 GetDefaultDestination(candidates, ICE_CANDIDATE_COMPONENT_RTCP, &rtcp_port,
781 &rtcp_ip, &addr_type);
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000782 // Found default RTCP candidate.
783 // RFC 5245
784 // If the agent is utilizing RTCP, it MUST encode the RTCP candidate
785 // using the a=rtcp attribute as defined in RFC 3605.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000786
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000787 // RFC 3605
788 // rtcp-attribute = "a=rtcp:" port [nettype space addrtype space
789 // connection-address] CRLF
Jonas Olssonec9e4922018-09-05 09:53:49 +0200790 rtc::StringBuilder os;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000791 InitAttrLine(kAttributeRtcp, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200792 os << kSdpDelimiterColon << rtcp_port << " " << kConnectionNettype << " "
793 << addr_type << " " << rtcp_ip;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000794 rtcp_line = os.str();
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000795 return rtcp_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000796}
797
798// Get candidates according to the mline index from SessionDescriptionInterface.
799static void GetCandidatesByMindex(const SessionDescriptionInterface& desci,
800 int mline_index,
801 std::vector<Candidate>* candidates) {
802 if (!candidates) {
803 return;
804 }
805 const IceCandidateCollection* cc = desci.candidates(mline_index);
806 for (size_t i = 0; i < cc->count(); ++i) {
807 const IceCandidateInterface* candidate = cc->at(i);
808 candidates->push_back(candidate->candidate());
809 }
810}
811
deadbeef90f1e1e2017-02-10 12:35:05 -0800812static bool IsValidPort(int port) {
813 return port >= 0 && port <= 65535;
814}
815
Steve Antone831b8c2018-02-01 12:22:16 -0800816std::string SdpSerialize(const JsepSessionDescription& jdesc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000817 const cricket::SessionDescription* desc = jdesc.description();
818 if (!desc) {
819 return "";
820 }
821
822 std::string message;
823
824 // Session Description.
825 AddLine(kSessionVersion, &message);
826 // Session Origin
827 // RFC 4566
828 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
829 // <unicast-address>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200830 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000831 InitLine(kLineTypeOrigin, kSessionOriginUsername, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200832 const std::string& session_id =
833 jdesc.session_id().empty() ? kSessionOriginSessionId : jdesc.session_id();
834 const std::string& session_version = jdesc.session_version().empty()
835 ? kSessionOriginSessionVersion
836 : jdesc.session_version();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000837 os << " " << session_id << " " << session_version << " "
838 << kSessionOriginNettype << " " << kSessionOriginAddrtype << " "
839 << kSessionOriginAddress;
840 AddLine(os.str(), &message);
841 AddLine(kSessionName, &message);
842
843 // Time Description.
844 AddLine(kTimeDescription, &message);
845
846 // Group
847 if (desc->HasGroup(cricket::GROUP_TYPE_BUNDLE)) {
848 std::string group_line = kAttrGroup;
849 const cricket::ContentGroup* group =
850 desc->GetGroupByName(cricket::GROUP_TYPE_BUNDLE);
nisseede5da42017-01-12 05:15:36 -0800851 RTC_DCHECK(group != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700852 for (const std::string& content_name : group->content_names()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000853 group_line.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -0700854 group_line.append(content_name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000855 }
856 AddLine(group_line, &message);
857 }
858
Johannes Kron0854eb62018-10-10 22:33:20 +0200859 // Mixed one- and two-byte header extension.
Johannes Kron9581bc42018-10-23 10:17:39 +0200860 if (desc->extmap_allow_mixed()) {
Johannes Kron0854eb62018-10-10 22:33:20 +0200861 InitAttrLine(kAttributeExtmapAllowMixed, &os);
862 AddLine(os.str(), &message);
863 }
864
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000865 // MediaStream semantics
866 InitAttrLine(kAttributeMsidSemantics, &os);
867 os << kSdpDelimiterColon << " " << kMediaStreamSemantic;
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000868
Seth Hampson845e8782018-03-02 11:34:10 -0800869 std::set<std::string> media_stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000870 const ContentInfo* audio_content = GetFirstAudioContent(desc);
871 if (audio_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800872 GetMediaStreamIds(audio_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000873
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000874 const ContentInfo* video_content = GetFirstVideoContent(desc);
875 if (video_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800876 GetMediaStreamIds(video_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000877
Steve Anton4daf66e2018-09-07 14:55:53 -0700878 for (const std::string& id : media_stream_ids) {
879 os << " " << id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000880 }
881 AddLine(os.str(), &message);
882
Taylor Brandstetter2f65ec52018-05-24 11:37:28 -0700883 // a=ice-lite
884 //
885 // TODO(deadbeef): It's weird that we need to iterate TransportInfos for
886 // this, when it's a session-level attribute. It really should be moved to a
887 // session-level structure like SessionDescription.
888 for (const cricket::TransportInfo& transport : desc->transport_infos()) {
889 if (transport.description.ice_mode == cricket::ICEMODE_LITE) {
890 InitAttrLine(kAttributeIceLite, &os);
891 AddLine(os.str(), &message);
892 break;
893 }
894 }
895
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000896 // Preserve the order of the media contents.
897 int mline_index = -1;
Steve Anton4daf66e2018-09-07 14:55:53 -0700898 for (const ContentInfo& content : desc->contents()) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000899 std::vector<Candidate> candidates;
900 GetCandidatesByMindex(jdesc, ++mline_index, &candidates);
Steve Anton4daf66e2018-09-07 14:55:53 -0700901 BuildMediaDescription(&content, desc->GetTransportInfoByName(content.name),
902 content.media_description()->type(), candidates,
903 desc->msid_signaling(), &message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000904 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000905 return message;
906}
907
908// Serializes the passed in IceCandidateInterface to a SDP string.
909// candidate - The candidate to be serialized.
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700910std::string SdpSerializeCandidate(const IceCandidateInterface& candidate) {
911 return SdpSerializeCandidate(candidate.candidate());
912}
913
914// Serializes a cricket Candidate.
915std::string SdpSerializeCandidate(const cricket::Candidate& candidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000916 std::string message;
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700917 std::vector<cricket::Candidate> candidates(1, candidate);
honghaiza54a0802015-12-16 18:37:23 -0800918 BuildCandidate(candidates, true, &message);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000919 // From WebRTC draft section 4.8.1.1 candidate-attribute will be
920 // just candidate:<candidate> not a=candidate:<blah>CRLF
nisseede5da42017-01-12 05:15:36 -0800921 RTC_DCHECK(message.find("a=") == 0);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000922 message.erase(0, 2);
nisseede5da42017-01-12 05:15:36 -0800923 RTC_DCHECK(message.find(kLineBreak) == message.size() - 2);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000924 message.resize(message.size() - 2);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000925 return message;
926}
927
928bool SdpDeserialize(const std::string& message,
929 JsepSessionDescription* jdesc,
930 SdpParseError* error) {
931 std::string session_id;
932 std::string session_version;
Peter Thatcher7cbd1882015-09-17 18:54:52 -0700933 TransportDescription session_td("", "");
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000934 RtpHeaderExtensions session_extmaps;
zhihuang38989e52017-03-21 11:04:53 -0700935 rtc::SocketAddress session_connection_addr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000936 cricket::SessionDescription* desc = new cricket::SessionDescription();
937 std::vector<JsepIceCandidate*> candidates;
938 size_t current_pos = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000939
940 // Session Description
941 if (!ParseSessionDescription(message, &current_pos, &session_id,
deadbeefc80741f2015-10-22 13:14:45 -0700942 &session_version, &session_td, &session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700943 &session_connection_addr, desc, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000944 delete desc;
945 return false;
946 }
947
948 // Media Description
deadbeefc80741f2015-10-22 13:14:45 -0700949 if (!ParseMediaDescription(message, session_td, session_extmaps, &current_pos,
zhihuang38989e52017-03-21 11:04:53 -0700950 session_connection_addr, desc, &candidates,
951 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000952 delete desc;
Steve Anton4daf66e2018-09-07 14:55:53 -0700953 for (JsepIceCandidate* candidate : candidates) {
954 delete candidate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000955 }
956 return false;
957 }
958
959 jdesc->Initialize(desc, session_id, session_version);
960
Steve Anton4daf66e2018-09-07 14:55:53 -0700961 for (JsepIceCandidate* candidate : candidates) {
962 jdesc->AddCandidate(candidate);
963 delete candidate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000964 }
965 return true;
966}
967
968bool SdpDeserializeCandidate(const std::string& message,
969 JsepIceCandidate* jcandidate,
970 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -0800971 RTC_DCHECK(jcandidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000972 Candidate candidate;
973 if (!ParseCandidate(message, &candidate, error, true)) {
974 return false;
975 }
976 jcandidate->SetCandidate(candidate);
977 return true;
978}
979
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700980bool SdpDeserializeCandidate(const std::string& transport_name,
981 const std::string& message,
982 cricket::Candidate* candidate,
983 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -0800984 RTC_DCHECK(candidate != nullptr);
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700985 if (!ParseCandidate(message, candidate, error, true)) {
986 return false;
987 }
988 candidate->set_transport_name(transport_name);
989 return true;
990}
991
Yves Gerey665174f2018-06-19 15:03:05 +0200992bool ParseCandidate(const std::string& message,
993 Candidate* candidate,
994 SdpParseError* error,
995 bool is_raw) {
nisseede5da42017-01-12 05:15:36 -0800996 RTC_DCHECK(candidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000997
998 // Get the first line from |message|.
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +0000999 std::string first_line = message;
1000 size_t pos = 0;
1001 GetLine(message, &pos, &first_line);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001002
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001003 // Makes sure |message| contains only one line.
1004 if (message.size() > first_line.size()) {
1005 std::string left, right;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001006 if (rtc::tokenize_first(message, kNewLineChar, &left, &right) &&
Donald Curtis0e07f922015-05-15 09:21:23 -07001007 !right.empty()) {
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001008 return ParseFailed(message, 0, "Expect one line only", error);
1009 }
1010 }
1011
1012 // From WebRTC draft section 4.8.1.1 candidate-attribute should be
1013 // candidate:<candidate> when trickled, but we still support
1014 // a=candidate:<blah>CRLF for backward compatibility and for parsing a line
1015 // from the SDP.
1016 if (IsLineType(first_line, kLineTypeAttributes)) {
1017 first_line = first_line.substr(kLinePrefixLength);
1018 }
1019
1020 std::string attribute_candidate;
1021 std::string candidate_value;
1022
1023 // |first_line| must be in the form of "candidate:<value>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001024 if (!rtc::tokenize_first(first_line, kSdpDelimiterColonChar,
1025 &attribute_candidate, &candidate_value) ||
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001026 attribute_candidate != kAttributeCandidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001027 if (is_raw) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001028 rtc::StringBuilder description;
Yves Gerey665174f2018-06-19 15:03:05 +02001029 description << "Expect line: " << kAttributeCandidate << ":"
1030 << "<candidate-str>";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001031 return ParseFailed(first_line, 0, description.str(), error);
1032 } else {
1033 return ParseFailedExpectLine(first_line, 0, kLineTypeAttributes,
1034 kAttributeCandidate, error);
1035 }
1036 }
1037
1038 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001039 rtc::split(candidate_value, kSdpDelimiterSpaceChar, &fields);
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001040
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001041 // RFC 5245
1042 // a=candidate:<foundation> <component-id> <transport> <priority>
1043 // <connection-address> <port> typ <candidate-types>
1044 // [raddr <connection-address>] [rport <port>]
1045 // *(SP extension-att-name SP extension-att-value)
1046 const size_t expected_min_fields = 8;
1047 if (fields.size() < expected_min_fields ||
1048 (fields[6] != kAttributeCandidateTyp)) {
1049 return ParseFailedExpectMinFieldNum(first_line, expected_min_fields, error);
1050 }
jbauch083b73f2015-07-16 02:46:32 -07001051 const std::string& foundation = fields[0];
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001052
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001053 int component_id = 0;
1054 if (!GetValueFromString(first_line, fields[1], &component_id, error)) {
1055 return false;
1056 }
jbauch083b73f2015-07-16 02:46:32 -07001057 const std::string& transport = fields[2];
Peter Boström0c4e06b2015-10-07 12:23:21 +02001058 uint32_t priority = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001059 if (!GetValueFromString(first_line, fields[3], &priority, error)) {
1060 return false;
1061 }
jbauch083b73f2015-07-16 02:46:32 -07001062 const std::string& connection_address = fields[4];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001063 int port = 0;
1064 if (!GetValueFromString(first_line, fields[5], &port, error)) {
1065 return false;
1066 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001067 if (!IsValidPort(port)) {
1068 return ParseFailed(first_line, "Invalid port number.", error);
1069 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001070 SocketAddress address(connection_address, port);
1071
1072 cricket::ProtocolType protocol;
hnslb68cc752016-12-13 10:33:41 -08001073 if (!StringToProto(transport.c_str(), &protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001074 return ParseFailed(first_line, "Unsupported transport type.", error);
1075 }
hnslb68cc752016-12-13 10:33:41 -08001076 switch (protocol) {
1077 case cricket::PROTO_UDP:
1078 case cricket::PROTO_TCP:
1079 case cricket::PROTO_SSLTCP:
1080 // Supported protocol.
1081 break;
1082 default:
1083 return ParseFailed(first_line, "Unsupported transport type.", error);
1084 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001085
1086 std::string candidate_type;
jbauch083b73f2015-07-16 02:46:32 -07001087 const std::string& type = fields[7];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001088 if (type == kCandidateHost) {
1089 candidate_type = cricket::LOCAL_PORT_TYPE;
1090 } else if (type == kCandidateSrflx) {
1091 candidate_type = cricket::STUN_PORT_TYPE;
1092 } else if (type == kCandidateRelay) {
1093 candidate_type = cricket::RELAY_PORT_TYPE;
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001094 } else if (type == kCandidatePrflx) {
1095 candidate_type = cricket::PRFLX_PORT_TYPE;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001096 } else {
1097 return ParseFailed(first_line, "Unsupported candidate type.", error);
1098 }
1099
1100 size_t current_position = expected_min_fields;
1101 SocketAddress related_address;
1102 // The 2 optional fields for related address
1103 // [raddr <connection-address>] [rport <port>]
1104 if (fields.size() >= (current_position + 2) &&
1105 fields[current_position] == kAttributeCandidateRaddr) {
1106 related_address.SetIP(fields[++current_position]);
1107 ++current_position;
1108 }
1109 if (fields.size() >= (current_position + 2) &&
1110 fields[current_position] == kAttributeCandidateRport) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001111 int port = 0;
Yves Gerey665174f2018-06-19 15:03:05 +02001112 if (!GetValueFromString(first_line, fields[++current_position], &port,
1113 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001114 return false;
1115 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001116 if (!IsValidPort(port)) {
1117 return ParseFailed(first_line, "Invalid port number.", error);
1118 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001119 related_address.SetPort(port);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001120 ++current_position;
1121 }
1122
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001123 // If this is a TCP candidate, it has additional extension as defined in
1124 // RFC 6544.
1125 std::string tcptype;
1126 if (fields.size() >= (current_position + 2) &&
1127 fields[current_position] == kTcpCandidateType) {
1128 tcptype = fields[++current_position];
1129 ++current_position;
1130
1131 if (tcptype != cricket::TCPTYPE_ACTIVE_STR &&
1132 tcptype != cricket::TCPTYPE_PASSIVE_STR &&
1133 tcptype != cricket::TCPTYPE_SIMOPEN_STR) {
1134 return ParseFailed(first_line, "Invalid TCP candidate type.", error);
1135 }
1136
1137 if (protocol != cricket::PROTO_TCP) {
1138 return ParseFailed(first_line, "Invalid non-TCP candidate", error);
1139 }
1140 }
1141
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001142 // Extension
honghaiza54a0802015-12-16 18:37:23 -08001143 // Though non-standard, we support the ICE ufrag and pwd being signaled on
1144 // the candidate to avoid issues with confusing which generation a candidate
1145 // belongs to when trickling multiple generations at the same time.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001146 std::string username;
1147 std::string password;
Peter Boström0c4e06b2015-10-07 12:23:21 +02001148 uint32_t generation = 0;
honghaiza0c44ea2016-03-23 16:07:48 -07001149 uint16_t network_id = 0;
1150 uint16_t network_cost = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001151 for (size_t i = current_position; i + 1 < fields.size(); ++i) {
1152 // RFC 5245
1153 // *(SP extension-att-name SP extension-att-value)
1154 if (fields[i] == kAttributeCandidateGeneration) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001155 if (!GetValueFromString(first_line, fields[++i], &generation, error)) {
1156 return false;
1157 }
honghaiza54a0802015-12-16 18:37:23 -08001158 } else if (fields[i] == kAttributeCandidateUfrag) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001159 username = fields[++i];
honghaiza54a0802015-12-16 18:37:23 -08001160 } else if (fields[i] == kAttributeCandidatePwd) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001161 password = fields[++i];
honghaiza0c44ea2016-03-23 16:07:48 -07001162 } else if (fields[i] == kAttributeCandidateNetworkId) {
1163 if (!GetValueFromString(first_line, fields[++i], &network_id, error)) {
1164 return false;
1165 }
honghaize1a0c942016-02-16 14:54:56 -08001166 } else if (fields[i] == kAttributeCandidateNetworkCost) {
1167 if (!GetValueFromString(first_line, fields[++i], &network_cost, error)) {
1168 return false;
1169 }
Honghai Zhang351d77b2016-05-20 15:08:29 -07001170 network_cost = std::min(network_cost, rtc::kNetworkCostMax);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001171 } else {
1172 // Skip the unknown extension.
1173 ++i;
1174 }
1175 }
1176
guoweis@webrtc.org61c12472015-01-15 06:53:07 +00001177 *candidate = Candidate(component_id, cricket::ProtoToString(protocol),
guoweis@webrtc.org950c5182014-12-16 23:01:31 +00001178 address, priority, username, password, candidate_type,
honghaiza0c44ea2016-03-23 16:07:48 -07001179 generation, foundation, network_id, network_cost);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001180 candidate->set_related_address(related_address);
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001181 candidate->set_tcptype(tcptype);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001182 return true;
1183}
1184
1185bool ParseIceOptions(const std::string& line,
1186 std::vector<std::string>* transport_options,
1187 SdpParseError* error) {
1188 std::string ice_options;
1189 if (!GetValue(line, kAttributeIceOption, &ice_options, error)) {
1190 return false;
1191 }
1192 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001193 rtc::split(ice_options, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001194 for (size_t i = 0; i < fields.size(); ++i) {
1195 transport_options->push_back(fields[i]);
1196 }
1197 return true;
1198}
1199
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001200bool ParseSctpPort(const std::string& line,
1201 int* sctp_port,
1202 SdpParseError* error) {
1203 // draft-ietf-mmusic-sctp-sdp-07
1204 // a=sctp-port
1205 std::vector<std::string> fields;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001206 const size_t expected_min_fields = 2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001207 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
lally69f57602015-10-08 10:15:04 -07001208 if (fields.size() < expected_min_fields) {
1209 fields.resize(0);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001210 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
lally69f57602015-10-08 10:15:04 -07001211 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001212 if (fields.size() < expected_min_fields) {
1213 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1214 }
1215 if (!rtc::FromString(fields[1], sctp_port)) {
lally69f57602015-10-08 10:15:04 -07001216 return ParseFailed(line, "Invalid sctp port value.", error);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001217 }
1218 return true;
1219}
1220
isheriff6f8d6862016-05-26 11:24:55 -07001221bool ParseExtmap(const std::string& line,
1222 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001223 SdpParseError* error) {
1224 // RFC 5285
1225 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1226 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001227 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001228 const size_t expected_min_fields = 2;
1229 if (fields.size() < expected_min_fields) {
1230 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1231 }
1232 std::string uri = fields[1];
1233
1234 std::string value_direction;
1235 if (!GetValue(fields[0], kAttributeExtmap, &value_direction, error)) {
1236 return false;
1237 }
1238 std::vector<std::string> sub_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001239 rtc::split(value_direction, kSdpDelimiterSlashChar, &sub_fields);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001240 int value = 0;
1241 if (!GetValueFromString(line, sub_fields[0], &value, error)) {
1242 return false;
1243 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001244
jbauch5869f502017-06-29 12:31:36 -07001245 bool encrypted = false;
1246 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1247 // RFC 6904
Steve Anton36b29d12017-10-30 09:57:42 -07001248 // a=extmap:<value["/"<direction>] urn:ietf:params:rtp-hdrext:encrypt <URI>
1249 // <extensionattributes>
jbauch5869f502017-06-29 12:31:36 -07001250 const size_t expected_min_fields_encrypted = expected_min_fields + 1;
1251 if (fields.size() < expected_min_fields_encrypted) {
1252 return ParseFailedExpectMinFieldNum(line, expected_min_fields_encrypted,
Yves Gerey665174f2018-06-19 15:03:05 +02001253 error);
jbauch5869f502017-06-29 12:31:36 -07001254 }
1255
1256 encrypted = true;
1257 uri = fields[2];
1258 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1259 return ParseFailed(line, "Recursive encrypted header.", error);
1260 }
1261 }
1262
1263 *extmap = RtpExtension(uri, value, encrypted);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001264 return true;
1265}
1266
1267void BuildMediaDescription(const ContentInfo* content_info,
1268 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001269 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001270 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -08001271 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001272 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001273 RTC_DCHECK(message != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001274 if (content_info == NULL || message == NULL) {
1275 return;
1276 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001277 rtc::StringBuilder os;
Steve Antonb1c1de12017-12-21 15:14:30 -08001278 const MediaContentDescription* media_desc = content_info->media_description();
1279 RTC_DCHECK(media_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001280
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001281 int sctp_port = cricket::kSctpDefaultPort;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001282
1283 // RFC 4566
1284 // m=<media> <port> <proto> <fmt>
1285 // fmt is a list of payload type numbers that MAY be used in the session.
1286 const char* type = NULL;
1287 if (media_type == cricket::MEDIA_TYPE_AUDIO)
1288 type = kMediaTypeAudio;
1289 else if (media_type == cricket::MEDIA_TYPE_VIDEO)
1290 type = kMediaTypeVideo;
1291 else if (media_type == cricket::MEDIA_TYPE_DATA)
1292 type = kMediaTypeData;
1293 else
nissec80e7412017-01-11 05:56:46 -08001294 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001295
1296 std::string fmt;
1297 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001298 const VideoContentDescription* video_desc = media_desc->as_video();
Steve Anton4daf66e2018-09-07 14:55:53 -07001299 for (const cricket::VideoCodec& codec : video_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001300 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001301 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001302 }
1303 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001304 const AudioContentDescription* audio_desc = media_desc->as_audio();
Steve Anton4daf66e2018-09-07 14:55:53 -07001305 for (const cricket::AudioCodec& codec : audio_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001306 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001307 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001308 }
1309 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001310 const DataContentDescription* data_desc = media_desc->as_data();
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001311 if (IsDtlsSctp(media_desc->protocol())) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001312 fmt.append(" ");
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001313
zstein4b2e0822017-02-17 19:48:38 -08001314 if (data_desc->use_sctpmap()) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001315 for (const cricket::DataCodec& codec : data_desc->codecs()) {
Niels Möller039743e2018-10-23 10:07:25 +02001316 if (absl::EqualsIgnoreCase(codec.name,
1317 cricket::kGoogleSctpDataCodecName) &&
Steve Anton4daf66e2018-09-07 14:55:53 -07001318 codec.GetParam(cricket::kCodecParamPort, &sctp_port)) {
zstein4b2e0822017-02-17 19:48:38 -08001319 break;
1320 }
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001321 }
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001322
Jonas Olsson6b1985d2018-07-05 11:59:48 +02001323 fmt.append(rtc::ToString(sctp_port));
zstein4b2e0822017-02-17 19:48:38 -08001324 } else {
1325 fmt.append(kDefaultSctpmapProtocol);
1326 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001327 } else {
Steve Anton4daf66e2018-09-07 14:55:53 -07001328 for (const cricket::DataCodec& codec : data_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001329 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001330 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001331 }
1332 }
1333 }
1334 // The fmt must never be empty. If no codecs are found, set the fmt attribute
1335 // to 0.
1336 if (fmt.empty()) {
1337 fmt = " 0";
1338 }
1339
deadbeef25ed4352016-12-12 18:37:36 -08001340 // The port number in the m line will be updated later when associated with
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001341 // the candidates.
deadbeef25ed4352016-12-12 18:37:36 -08001342 //
1343 // A port value of 0 indicates that the m= section is rejected.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001344 // RFC 3264
1345 // To reject an offered stream, the port number in the corresponding stream in
1346 // the answer MUST be set to zero.
deadbeef25ed4352016-12-12 18:37:36 -08001347 //
1348 // However, the BUNDLE draft adds a new meaning to port zero, when used along
1349 // with a=bundle-only.
zhihuang38989e52017-03-21 11:04:53 -07001350 std::string port = kDummyPort;
1351 if (content_info->rejected || content_info->bundle_only) {
1352 port = kMediaPortRejected;
1353 } else if (!media_desc->connection_address().IsNil()) {
1354 port = rtc::ToString(media_desc->connection_address().port());
1355 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001356
Yves Gerey665174f2018-06-19 15:03:05 +02001357 rtc::SSLFingerprint* fp =
1358 (transport_info) ? transport_info->description.identity_fingerprint.get()
1359 : NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001360
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001361 // Add the m and c lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001362 InitLine(kLineTypeMedia, type, &os);
1363 os << " " << port << " " << media_desc->protocol() << fmt;
zhihuang38989e52017-03-21 11:04:53 -07001364 AddLine(os.str(), message);
1365
1366 InitLine(kLineTypeConnection, kConnectionNettype, &os);
1367 if (media_desc->connection_address().IsNil()) {
1368 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
1369 } else if (media_desc->connection_address().family() == AF_INET) {
1370 os << " " << kConnectionIpv4Addrtype << " "
1371 << media_desc->connection_address().ipaddr().ToString();
1372 } else {
1373 os << " " << kConnectionIpv6Addrtype << " "
1374 << media_desc->connection_address().ipaddr().ToString();
1375 }
1376 AddLine(os.str(), message);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001377
1378 // RFC 4566
1379 // b=AS:<bandwidth>
Peter Thatcherc0c3a862015-06-24 15:31:25 -07001380 if (media_desc->bandwidth() >= 1000) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001381 InitLine(kLineTypeSessionBandwidth, kApplicationSpecificMaximum, &os);
1382 os << kSdpDelimiterColon << (media_desc->bandwidth() / 1000);
1383 AddLine(os.str(), message);
1384 }
1385
deadbeef25ed4352016-12-12 18:37:36 -08001386 // Add the a=bundle-only line.
1387 if (content_info->bundle_only) {
1388 InitAttrLine(kAttributeBundleOnly, &os);
1389 AddLine(os.str(), message);
1390 }
1391
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001392 // Add the a=rtcp line.
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001393 if (IsRtp(media_desc->protocol())) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001394 std::string rtcp_line = GetRtcpLine(candidates);
1395 if (!rtcp_line.empty()) {
1396 AddLine(rtcp_line, message);
1397 }
1398 }
1399
honghaiza54a0802015-12-16 18:37:23 -08001400 // Build the a=candidate lines. We don't include ufrag and pwd in the
1401 // candidates in the SDP to avoid redundancy.
1402 BuildCandidate(candidates, false, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001403
1404 // Use the transport_info to build the media level ice-ufrag and ice-pwd.
1405 if (transport_info) {
1406 // RFC 5245
1407 // ice-pwd-att = "ice-pwd" ":" password
1408 // ice-ufrag-att = "ice-ufrag" ":" ufrag
1409 // ice-ufrag
deadbeef3f7219b2015-12-28 15:17:14 -08001410 if (!transport_info->description.ice_ufrag.empty()) {
1411 InitAttrLine(kAttributeIceUfrag, &os);
1412 os << kSdpDelimiterColon << transport_info->description.ice_ufrag;
1413 AddLine(os.str(), message);
1414 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001415 // ice-pwd
deadbeef3f7219b2015-12-28 15:17:14 -08001416 if (!transport_info->description.ice_pwd.empty()) {
1417 InitAttrLine(kAttributeIcePwd, &os);
1418 os << kSdpDelimiterColon << transport_info->description.ice_pwd;
1419 AddLine(os.str(), message);
1420 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001421
1422 // draft-petithuguenin-mmusic-ice-attributes-level-03
1423 BuildIceOptions(transport_info->description.transport_options, message);
1424
1425 // RFC 4572
1426 // fingerprint-attribute =
1427 // "fingerprint" ":" hash-func SP fingerprint
1428 if (fp) {
1429 // Insert the fingerprint attribute.
1430 InitAttrLine(kAttributeFingerprint, &os);
Yves Gerey665174f2018-06-19 15:03:05 +02001431 os << kSdpDelimiterColon << fp->algorithm << kSdpDelimiterSpace
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001432 << fp->GetRfc4572Fingerprint();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001433 AddLine(os.str(), message);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001434
1435 // Inserting setup attribute.
1436 if (transport_info->description.connection_role !=
Yves Gerey665174f2018-06-19 15:03:05 +02001437 cricket::CONNECTIONROLE_NONE) {
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001438 // Making sure we are not using "passive" mode.
1439 cricket::ConnectionRole role =
1440 transport_info->description.connection_role;
mallinath@webrtc.org19f27e62013-10-13 17:18:27 +00001441 std::string dtls_role_str;
nissec16fa5e2017-02-07 07:18:43 -08001442 const bool success =
1443 cricket::ConnectionRoleToString(role, &dtls_role_str);
1444 RTC_DCHECK(success);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001445 InitAttrLine(kAttributeSetup, &os);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001446 os << kSdpDelimiterColon << dtls_role_str;
1447 AddLine(os.str(), message);
1448 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001449 }
1450 }
1451
1452 // RFC 3388
1453 // mid-attribute = "a=mid:" identification-tag
1454 // identification-tag = token
1455 // Use the content name as the mid identification-tag.
1456 InitAttrLine(kAttributeMid, &os);
1457 os << kSdpDelimiterColon << content_info->name;
1458 AddLine(os.str(), message);
1459
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001460 if (IsDtlsSctp(media_desc->protocol())) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001461 const DataContentDescription* data_desc = media_desc->as_data();
zstein4b2e0822017-02-17 19:48:38 -08001462 bool use_sctpmap = data_desc->use_sctpmap();
1463 BuildSctpContentAttributes(message, sctp_port, use_sctpmap);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001464 } else if (IsRtp(media_desc->protocol())) {
Steve Antone831b8c2018-02-01 12:22:16 -08001465 BuildRtpContentAttributes(media_desc, media_type, msid_signaling, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001466 }
1467}
1468
zstein4b2e0822017-02-17 19:48:38 -08001469void BuildSctpContentAttributes(std::string* message,
1470 int sctp_port,
1471 bool use_sctpmap) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001472 rtc::StringBuilder os;
zstein4b2e0822017-02-17 19:48:38 -08001473 if (use_sctpmap) {
1474 // draft-ietf-mmusic-sctp-sdp-04
1475 // a=sctpmap:sctpmap-number protocol [streams]
1476 InitAttrLine(kAttributeSctpmap, &os);
1477 os << kSdpDelimiterColon << sctp_port << kSdpDelimiterSpace
1478 << kDefaultSctpmapProtocol << kSdpDelimiterSpace
1479 << cricket::kMaxSctpStreams;
1480 } else {
1481 // draft-ietf-mmusic-sctp-sdp-23
1482 // a=sctp-port:<port>
1483 InitAttrLine(kAttributeSctpPort, &os);
1484 os << kSdpDelimiterColon << sctp_port;
1485 // TODO(zstein): emit max-message-size here
1486 }
wu@webrtc.org78187522013-10-07 23:32:02 +00001487 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001488}
1489
deadbeef9d3584c2016-02-16 17:54:10 -08001490void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001491 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -08001492 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -08001493 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001494 rtc::StringBuilder os;
Johannes Kron0854eb62018-10-10 22:33:20 +02001495 // RFC 8285
1496 // a=extmap-allow-mixed
1497 // The attribute MUST be either on session level or media level. We support
1498 // responding on both levels, however, we don't respond on media level if it's
1499 // set on session level.
Johannes Kron9581bc42018-10-23 10:17:39 +02001500 if (media_desc->extmap_allow_mixed_enum() ==
Johannes Kron0854eb62018-10-10 22:33:20 +02001501 MediaContentDescription::kMedia) {
1502 InitAttrLine(kAttributeExtmapAllowMixed, &os);
1503 AddLine(os.str(), message);
1504 }
1505 // RFC 8285
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001506 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1507 // The definitions MUST be either all session level or all media level. This
1508 // implementation uses all media level.
1509 for (size_t i = 0; i < media_desc->rtp_header_extensions().size(); ++i) {
jbauch5869f502017-06-29 12:31:36 -07001510 const RtpExtension& extension = media_desc->rtp_header_extensions()[i];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001511 InitAttrLine(kAttributeExtmap, &os);
jbauch5869f502017-06-29 12:31:36 -07001512 os << kSdpDelimiterColon << extension.id;
1513 if (extension.encrypt) {
1514 os << kSdpDelimiterSpace << RtpExtension::kEncryptHeaderExtensionsUri;
1515 }
1516 os << kSdpDelimiterSpace << extension.uri;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001517 AddLine(os.str(), message);
1518 }
1519
1520 // RFC 3264
1521 // a=sendrecv || a=sendonly || a=sendrecv || a=inactive
deadbeefc80741f2015-10-22 13:14:45 -07001522 switch (media_desc->direction()) {
Steve Anton4e70a722017-11-28 14:57:10 -08001523 case RtpTransceiverDirection::kInactive:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001524 InitAttrLine(kAttributeInactive, &os);
1525 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001526 case RtpTransceiverDirection::kSendOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001527 InitAttrLine(kAttributeSendOnly, &os);
1528 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001529 case RtpTransceiverDirection::kRecvOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001530 InitAttrLine(kAttributeRecvOnly, &os);
1531 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001532 case RtpTransceiverDirection::kSendRecv:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001533 default:
1534 InitAttrLine(kAttributeSendRecv, &os);
1535 break;
1536 }
1537 AddLine(os.str(), message);
1538
Seth Hampson5b4f0752018-04-02 16:31:36 -07001539 // Specified in https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
1540 // a=msid:<msid-id> <msid-appdata>
1541 // The msid-id is a 1*64 token char representing the media stream id, and the
1542 // msid-appdata is a 1*64 token char representing the track id. There is a
1543 // line for every media stream, with a special msid-id value of "-"
1544 // representing no streams. The value of "msid-appdata" MUST be identical for
1545 // all lines.
Steve Antone831b8c2018-02-01 12:22:16 -08001546 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
1547 const StreamParamsVec& streams = media_desc->streams();
1548 if (streams.size() == 1u) {
1549 const StreamParams& track = streams[0];
Seth Hampson5b4f0752018-04-02 16:31:36 -07001550 std::vector<std::string> stream_ids = track.stream_ids();
1551 if (stream_ids.empty()) {
1552 stream_ids.push_back(kNoStreamMsid);
1553 }
1554 for (const std::string& stream_id : stream_ids) {
1555 InitAttrLine(kAttributeMsid, &os);
1556 os << kSdpDelimiterColon << stream_id << kSdpDelimiterSpace << track.id;
1557 AddLine(os.str(), message);
1558 }
Steve Antone831b8c2018-02-01 12:22:16 -08001559 } else if (streams.size() > 1u) {
1560 RTC_LOG(LS_WARNING)
1561 << "Trying to serialize Unified Plan SDP with more than "
Jonas Olsson45cc8902018-02-13 10:37:07 +01001562 "one track in a media section. Omitting 'a=msid'.";
deadbeef9d3584c2016-02-16 17:54:10 -08001563 }
1564 }
1565
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001566 // RFC 5761
1567 // a=rtcp-mux
1568 if (media_desc->rtcp_mux()) {
1569 InitAttrLine(kAttributeRtcpMux, &os);
1570 AddLine(os.str(), message);
1571 }
1572
deadbeef13871492015-12-09 12:37:51 -08001573 // RFC 5506
1574 // a=rtcp-rsize
1575 if (media_desc->rtcp_reduced_size()) {
1576 InitAttrLine(kAttributeRtcpReducedSize, &os);
1577 AddLine(os.str(), message);
1578 }
1579
deadbeefd45aea82017-09-16 01:24:29 -07001580 if (media_desc->conference_mode()) {
1581 InitAttrLine(kAttributeXGoogleFlag, &os);
1582 os << kSdpDelimiterColon << kValueConference;
1583 AddLine(os.str(), message);
1584 }
1585
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001586 // RFC 4568
1587 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001588 for (const CryptoParams& crypto_params : media_desc->cryptos()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001589 InitAttrLine(kAttributeCrypto, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001590 os << kSdpDelimiterColon << crypto_params.tag << " "
1591 << crypto_params.cipher_suite << " " << crypto_params.key_params;
1592 if (!crypto_params.session_params.empty()) {
1593 os << " " << crypto_params.session_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001594 }
1595 AddLine(os.str(), message);
1596 }
1597
1598 // RFC 4566
1599 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1600 // [/<encodingparameters>]
1601 BuildRtpMap(media_desc, media_type, message);
1602
Steve Anton4daf66e2018-09-07 14:55:53 -07001603 for (const StreamParams& track : media_desc->streams()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001604 // Build the ssrc-group lines.
Steve Anton4daf66e2018-09-07 14:55:53 -07001605 for (const SsrcGroup& ssrc_group : track.ssrc_groups) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001606 // RFC 5576
1607 // a=ssrc-group:<semantics> <ssrc-id> ...
Steve Anton4daf66e2018-09-07 14:55:53 -07001608 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001609 continue;
1610 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001611 InitAttrLine(kAttributeSsrcGroup, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001612 os << kSdpDelimiterColon << ssrc_group.semantics;
1613 for (uint32_t ssrc : ssrc_group.ssrcs) {
1614 os << kSdpDelimiterSpace << rtc::ToString(ssrc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001615 }
1616 AddLine(os.str(), message);
1617 }
1618 // Build the ssrc lines for each ssrc.
Steve Anton4daf66e2018-09-07 14:55:53 -07001619 for (uint32_t ssrc : track.ssrcs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001620 // RFC 5576
1621 // a=ssrc:<ssrc-id> cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07001622 AddSsrcLine(ssrc, kSsrcAttributeCname, track.cname, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001623
Steve Antone831b8c2018-02-01 12:22:16 -08001624 if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
1625 // draft-alvestrand-mmusic-msid-00
1626 // a=ssrc:<ssrc-id> msid:identifier [appdata]
1627 // The appdata consists of the "id" attribute of a MediaStreamTrack,
1628 // which corresponds to the "id" attribute of StreamParams.
Seth Hampson5b4f0752018-04-02 16:31:36 -07001629 // Since a=ssrc msid signaling is used in Plan B SDP semantics, and
1630 // multiple stream ids are not supported for Plan B, we are only adding
1631 // a line for the first media stream id here.
Seth Hampson7fa6ee62018-10-17 10:25:28 -07001632 const std::string& track_stream_id = track.first_stream_id();
1633 // We use a special msid-id value of "-" to represent no streams,
1634 // for Unified Plan compatibility. Plan B will always have a
1635 // track_stream_id.
1636 const std::string& stream_id =
1637 track_stream_id.empty() ? kNoStreamMsid : track_stream_id;
Steve Antone831b8c2018-02-01 12:22:16 -08001638 InitAttrLine(kAttributeSsrc, &os);
1639 os << kSdpDelimiterColon << ssrc << kSdpDelimiterSpace
1640 << kSsrcAttributeMsid << kSdpDelimiterColon << stream_id
Steve Anton4daf66e2018-09-07 14:55:53 -07001641 << kSdpDelimiterSpace << track.id;
Steve Antone831b8c2018-02-01 12:22:16 -08001642 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001643
Steve Antone831b8c2018-02-01 12:22:16 -08001644 // TODO(ronghuawu): Remove below code which is for backward
1645 // compatibility.
1646 // draft-alvestrand-rtcweb-mid-01
1647 // a=ssrc:<ssrc-id> mslabel:<value>
1648 // The label isn't yet defined.
1649 // a=ssrc:<ssrc-id> label:<value>
Seth Hampson5b4f0752018-04-02 16:31:36 -07001650 AddSsrcLine(ssrc, kSsrcAttributeMslabel, stream_id, message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001651 AddSsrcLine(ssrc, kSSrcAttributeLabel, track.id, message);
Steve Antone831b8c2018-02-01 12:22:16 -08001652 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001653 }
1654 }
1655}
1656
Jonas Olssonec9e4922018-09-05 09:53:49 +02001657void WriteFmtpHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001658 // fmtp header: a=fmtp:|payload_type| <parameters>
1659 // Add a=fmtp
1660 InitAttrLine(kAttributeFmtp, os);
1661 // Add :|payload_type|
1662 *os << kSdpDelimiterColon << payload_type;
1663}
1664
Jonas Olssonec9e4922018-09-05 09:53:49 +02001665void WriteRtcpFbHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001666 // rtcp-fb header: a=rtcp-fb:|payload_type|
1667 // <parameters>/<ccm <ccm_parameters>>
1668 // Add a=rtcp-fb
1669 InitAttrLine(kAttributeRtcpFb, os);
1670 // Add :
1671 *os << kSdpDelimiterColon;
1672 if (payload_type == kWildcardPayloadType) {
1673 *os << "*";
1674 } else {
1675 *os << payload_type;
1676 }
1677}
1678
1679void WriteFmtpParameter(const std::string& parameter_name,
1680 const std::string& parameter_value,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001681 rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001682 // fmtp parameters: |parameter_name|=|parameter_value|
1683 *os << parameter_name << kSdpDelimiterEqual << parameter_value;
1684}
1685
1686void WriteFmtpParameters(const cricket::CodecParameterMap& parameters,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001687 rtc::StringBuilder* os) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001688 bool first = true;
1689 for (const auto& entry : parameters) {
1690 const std::string& key = entry.first;
1691 const std::string& value = entry.second;
hta62a216e2016-04-15 11:02:14 -07001692 // Parameters are a semicolon-separated list, no spaces.
1693 // The list is separated from the header by a space.
Steve Anton4daf66e2018-09-07 14:55:53 -07001694 if (first) {
hta62a216e2016-04-15 11:02:14 -07001695 *os << kSdpDelimiterSpace;
Steve Anton4daf66e2018-09-07 14:55:53 -07001696 first = false;
hta62a216e2016-04-15 11:02:14 -07001697 } else {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001698 *os << kSdpDelimiterSemicolon;
1699 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001700 WriteFmtpParameter(key, value, os);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001701 }
1702}
1703
1704bool IsFmtpParam(const std::string& name) {
ossuaa4b0772017-01-30 07:41:18 -08001705 // RFC 4855, section 3 specifies the mapping of media format parameters to SDP
1706 // parameters. Only ptime, maxptime, channels and rate are placed outside of
1707 // the fmtp line. In WebRTC, channels and rate are already handled separately
1708 // and thus not included in the CodecParameterMap.
1709 return name != kCodecParamPTime && name != kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001710}
1711
1712// Retreives fmtp parameters from |params|, which may contain other parameters
1713// as well, and puts them in |fmtp_parameters|.
1714void GetFmtpParams(const cricket::CodecParameterMap& params,
1715 cricket::CodecParameterMap* fmtp_parameters) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001716 for (const auto& entry : params) {
1717 const std::string& key = entry.first;
1718 const std::string& value = entry.second;
1719 if (IsFmtpParam(key)) {
1720 (*fmtp_parameters)[key] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001721 }
1722 }
1723}
1724
1725template <class T>
1726void AddFmtpLine(const T& codec, std::string* message) {
1727 cricket::CodecParameterMap fmtp_parameters;
1728 GetFmtpParams(codec.params, &fmtp_parameters);
1729 if (fmtp_parameters.empty()) {
1730 // No need to add an fmtp if it will have no (optional) parameters.
1731 return;
1732 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001733 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001734 WriteFmtpHeader(codec.id, &os);
1735 WriteFmtpParameters(fmtp_parameters, &os);
1736 AddLine(os.str(), message);
1737 return;
1738}
1739
1740template <class T>
1741void AddRtcpFbLines(const T& codec, std::string* message) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001742 for (const cricket::FeedbackParam& param : codec.feedback_params.params()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001743 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001744 WriteRtcpFbHeader(codec.id, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001745 os << " " << param.id();
1746 if (!param.param().empty()) {
1747 os << " " << param.param();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001748 }
1749 AddLine(os.str(), message);
1750 }
1751}
1752
Yves Gerey665174f2018-06-19 15:03:05 +02001753bool AddSctpDataCodec(DataContentDescription* media_desc, int sctp_port) {
solenberg9fa49752016-10-08 13:02:44 -07001754 for (const auto& codec : media_desc->codecs()) {
Niels Möller039743e2018-10-23 10:07:25 +02001755 if (absl::EqualsIgnoreCase(codec.name, cricket::kGoogleSctpDataCodecName)) {
Yves Gerey665174f2018-06-19 15:03:05 +02001756 return ParseFailed("", "Can't have multiple sctp port attributes.", NULL);
solenberg9fa49752016-10-08 13:02:44 -07001757 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001758 }
1759 // Add the SCTP Port number as a pseudo-codec "port" parameter
solenberg9fa49752016-10-08 13:02:44 -07001760 cricket::DataCodec codec_port(cricket::kGoogleSctpDataCodecPlType,
deadbeef67cf2c12016-04-13 10:07:16 -07001761 cricket::kGoogleSctpDataCodecName);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001762 codec_port.SetParam(cricket::kCodecParamPort, sctp_port);
Mirko Bonadei675513b2017-11-09 11:09:25 +01001763 RTC_LOG(INFO) << "AddSctpDataCodec: Got SCTP Port Number " << sctp_port;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001764 media_desc->AddCodec(codec_port);
1765 return true;
1766}
1767
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001768bool GetMinValue(const std::vector<int>& values, int* value) {
1769 if (values.empty()) {
1770 return false;
1771 }
1772 std::vector<int>::const_iterator found =
1773 std::min_element(values.begin(), values.end());
1774 *value = *found;
1775 return true;
1776}
1777
1778bool GetParameter(const std::string& name,
Yves Gerey665174f2018-06-19 15:03:05 +02001779 const cricket::CodecParameterMap& params,
1780 int* value) {
1781 std::map<std::string, std::string>::const_iterator found = params.find(name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001782 if (found == params.end()) {
1783 return false;
1784 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00001785 if (!rtc::FromString(found->second, value)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001786 return false;
1787 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001788 return true;
1789}
1790
1791void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001792 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001793 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001794 RTC_DCHECK(message != NULL);
1795 RTC_DCHECK(media_desc != NULL);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001796 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001797 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001798 for (const cricket::VideoCodec& codec : media_desc->as_video()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001799 // RFC 4566
1800 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1801 // [/<encodingparameters>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001802 if (codec.id != kWildcardPayloadType) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001803 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001804 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
deadbeefe814a0d2017-02-25 18:15:09 -08001805 << cricket::kVideoCodecClockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001806 AddLine(os.str(), message);
1807 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001808 AddRtcpFbLines(codec, message);
1809 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001810 }
1811 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001812 std::vector<int> ptimes;
1813 std::vector<int> maxptimes;
1814 int max_minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001815 for (const cricket::AudioCodec& codec : media_desc->as_audio()->codecs()) {
1816 RTC_DCHECK(!codec.name.empty());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001817 // RFC 4566
1818 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1819 // [/<encodingparameters>]
1820 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001821 os << kSdpDelimiterColon << codec.id << " ";
1822 os << codec.name << "/" << codec.clockrate;
1823 if (codec.channels != 1) {
1824 os << "/" << codec.channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001825 }
1826 AddLine(os.str(), message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001827 AddRtcpFbLines(codec, message);
1828 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001829 int minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001830 if (GetParameter(kCodecParamMinPTime, codec.params, &minptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001831 max_minptime = std::max(minptime, max_minptime);
1832 }
1833 int ptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001834 if (GetParameter(kCodecParamPTime, codec.params, &ptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001835 ptimes.push_back(ptime);
1836 }
1837 int maxptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001838 if (GetParameter(kCodecParamMaxPTime, codec.params, &maxptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001839 maxptimes.push_back(maxptime);
1840 }
1841 }
1842 // Populate the maxptime attribute with the smallest maxptime of all codecs
1843 // under the same m-line.
1844 int min_maxptime = INT_MAX;
1845 if (GetMinValue(maxptimes, &min_maxptime)) {
1846 AddAttributeLine(kCodecParamMaxPTime, min_maxptime, message);
1847 }
nisseede5da42017-01-12 05:15:36 -08001848 RTC_DCHECK(min_maxptime > max_minptime);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001849 // Populate the ptime attribute with the smallest ptime or the largest
1850 // minptime, whichever is the largest, for all codecs under the same m-line.
1851 int ptime = INT_MAX;
1852 if (GetMinValue(ptimes, &ptime)) {
1853 ptime = std::min(ptime, min_maxptime);
1854 ptime = std::max(ptime, max_minptime);
1855 AddAttributeLine(kCodecParamPTime, ptime, message);
1856 }
1857 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001858 for (const cricket::DataCodec& codec : media_desc->as_data()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001859 // RFC 4566
1860 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1861 // [/<encodingparameters>]
1862 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001863 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
1864 << codec.clockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001865 AddLine(os.str(), message);
1866 }
1867 }
1868}
1869
1870void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -08001871 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001872 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001873 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001874
Steve Anton4daf66e2018-09-07 14:55:53 -07001875 for (const Candidate& candidate : candidates) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001876 // RFC 5245
1877 // a=candidate:<foundation> <component-id> <transport> <priority>
1878 // <connection-address> <port> typ <candidate-types>
1879 // [raddr <connection-address>] [rport <port>]
1880 // *(SP extension-att-name SP extension-att-value)
1881 std::string type;
1882 // Map the cricket candidate type to "host" / "srflx" / "prflx" / "relay"
Steve Anton4daf66e2018-09-07 14:55:53 -07001883 if (candidate.type() == cricket::LOCAL_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001884 type = kCandidateHost;
Steve Anton4daf66e2018-09-07 14:55:53 -07001885 } else if (candidate.type() == cricket::STUN_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001886 type = kCandidateSrflx;
Steve Anton4daf66e2018-09-07 14:55:53 -07001887 } else if (candidate.type() == cricket::RELAY_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001888 type = kCandidateRelay;
Steve Anton4daf66e2018-09-07 14:55:53 -07001889 } else if (candidate.type() == cricket::PRFLX_PORT_TYPE) {
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001890 type = kCandidatePrflx;
1891 // Peer reflexive candidate may be signaled for being removed.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001892 } else {
nissec80e7412017-01-11 05:56:46 -08001893 RTC_NOTREACHED();
Peter Thatcher019087f2015-04-28 09:06:26 -07001894 // Never write out candidates if we don't know the type.
1895 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001896 }
1897
1898 InitAttrLine(kAttributeCandidate, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001899 os << kSdpDelimiterColon << candidate.foundation() << " "
1900 << candidate.component() << " " << candidate.protocol() << " "
1901 << candidate.priority() << " "
1902 << (candidate.address().ipaddr().IsNil()
1903 ? candidate.address().hostname()
1904 : candidate.address().ipaddr().ToString())
1905 << " " << candidate.address().PortAsString() << " "
1906 << kAttributeCandidateTyp << " " << type << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001907
1908 // Related address
Steve Anton4daf66e2018-09-07 14:55:53 -07001909 if (!candidate.related_address().IsNil()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001910 os << kAttributeCandidateRaddr << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001911 << candidate.related_address().ipaddr().ToString() << " "
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001912 << kAttributeCandidateRport << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001913 << candidate.related_address().PortAsString() << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001914 }
1915
Steve Anton4daf66e2018-09-07 14:55:53 -07001916 if (candidate.protocol() == cricket::TCP_PROTOCOL_NAME) {
1917 os << kTcpCandidateType << " " << candidate.tcptype() << " ";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001918 }
1919
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001920 // Extensions
Steve Anton4daf66e2018-09-07 14:55:53 -07001921 os << kAttributeCandidateGeneration << " " << candidate.generation();
1922 if (include_ufrag && !candidate.username().empty()) {
1923 os << " " << kAttributeCandidateUfrag << " " << candidate.username();
honghaiza54a0802015-12-16 18:37:23 -08001924 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001925 if (candidate.network_id() > 0) {
1926 os << " " << kAttributeCandidateNetworkId << " "
1927 << candidate.network_id();
honghaiza0c44ea2016-03-23 16:07:48 -07001928 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001929 if (candidate.network_cost() > 0) {
1930 os << " " << kAttributeCandidateNetworkCost << " "
1931 << candidate.network_cost();
honghaize1a0c942016-02-16 14:54:56 -08001932 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001933
1934 AddLine(os.str(), message);
1935 }
1936}
1937
1938void BuildIceOptions(const std::vector<std::string>& transport_options,
1939 std::string* message) {
1940 if (!transport_options.empty()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001941 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001942 InitAttrLine(kAttributeIceOption, &os);
1943 os << kSdpDelimiterColon << transport_options[0];
1944 for (size_t i = 1; i < transport_options.size(); ++i) {
1945 os << kSdpDelimiterSpace << transport_options[i];
1946 }
1947 AddLine(os.str(), message);
1948 }
1949}
1950
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001951bool IsRtp(const std::string& protocol) {
1952 return protocol.empty() ||
Yves Gerey665174f2018-06-19 15:03:05 +02001953 (protocol.find(cricket::kMediaProtocolRtpPrefix) != std::string::npos);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001954}
1955
1956bool IsDtlsSctp(const std::string& protocol) {
1957 // This intentionally excludes "SCTP" and "SCTP/DTLS".
lally@webrtc.orga7470932015-02-24 20:19:21 +00001958 return protocol.find(cricket::kMediaProtocolDtlsSctp) != std::string::npos;
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001959}
1960
zhihuang38989e52017-03-21 11:04:53 -07001961bool ParseConnectionData(const std::string& line,
1962 rtc::SocketAddress* addr,
1963 SdpParseError* error) {
1964 // Parse the line from left to right.
1965 std::string token;
1966 std::string rightpart;
1967 // RFC 4566
1968 // c=<nettype> <addrtype> <connection-address>
1969 // Skip the "c="
Jonas Olssonec9e4922018-09-05 09:53:49 +02001970 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, &token, &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07001971 return ParseFailed(line, "Failed to parse the network type.", error);
1972 }
1973
1974 // Extract and verify the <nettype>
Jonas Olssonec9e4922018-09-05 09:53:49 +02001975 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
1976 &rightpart) ||
zhihuang38989e52017-03-21 11:04:53 -07001977 token != kConnectionNettype) {
1978 return ParseFailed(line,
1979 "Failed to parse the connection data. The network type "
1980 "is not currently supported.",
1981 error);
1982 }
1983
1984 // Extract the "<addrtype>" and "<connection-address>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001985 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
1986 &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07001987 return ParseFailed(line, "Failed to parse the address type.", error);
1988 }
1989
1990 // The rightpart part should be the IP address without the slash which is used
1991 // for multicast.
1992 if (rightpart.find('/') != std::string::npos) {
1993 return ParseFailed(line,
1994 "Failed to parse the connection data. Multicast is not "
1995 "currently supported.",
1996 error);
1997 }
1998 addr->SetIP(rightpart);
1999
2000 // Verify that the addrtype matches the type of the parsed address.
2001 if ((addr->family() == AF_INET && token != "IP4") ||
2002 (addr->family() == AF_INET6 && token != "IP6")) {
2003 addr->Clear();
2004 return ParseFailed(
2005 line,
2006 "Failed to parse the connection data. The address type is mismatching.",
2007 error);
2008 }
2009 return true;
2010}
2011
2012bool ParseSessionDescription(const std::string& message,
2013 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002014 std::string* session_id,
2015 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002016 TransportDescription* session_td,
2017 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -07002018 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002019 cricket::SessionDescription* desc,
2020 SdpParseError* error) {
2021 std::string line;
2022
deadbeefc80741f2015-10-22 13:14:45 -07002023 desc->set_msid_supported(false);
Johannes Kron9581bc42018-10-23 10:17:39 +02002024 desc->set_extmap_allow_mixed(false);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002025 // RFC 4566
2026 // v= (protocol version)
2027 if (!GetLineWithType(message, pos, &line, kLineTypeVersion)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002028 return ParseFailedExpectLine(message, *pos, kLineTypeVersion, std::string(),
2029 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002030 }
2031 // RFC 4566
2032 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
2033 // <unicast-address>
2034 if (!GetLineWithType(message, pos, &line, kLineTypeOrigin)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002035 return ParseFailedExpectLine(message, *pos, kLineTypeOrigin, std::string(),
2036 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002037 }
2038 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002039 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002040 const size_t expected_fields = 6;
2041 if (fields.size() != expected_fields) {
2042 return ParseFailedExpectFieldNum(line, expected_fields, error);
2043 }
2044 *session_id = fields[1];
2045 *session_version = fields[2];
2046
2047 // RFC 4566
2048 // s= (session name)
2049 if (!GetLineWithType(message, pos, &line, kLineTypeSessionName)) {
2050 return ParseFailedExpectLine(message, *pos, kLineTypeSessionName,
2051 std::string(), error);
2052 }
2053
Danil Chapovalov66cadcc2018-06-19 16:47:43 +02002054 // absl::optional lines
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002055 // Those are the optional lines, so shouldn't return false if not present.
2056 // RFC 4566
2057 // i=* (session information)
2058 GetLineWithType(message, pos, &line, kLineTypeSessionInfo);
2059
2060 // RFC 4566
2061 // u=* (URI of description)
2062 GetLineWithType(message, pos, &line, kLineTypeSessionUri);
2063
2064 // RFC 4566
2065 // e=* (email address)
2066 GetLineWithType(message, pos, &line, kLineTypeSessionEmail);
2067
2068 // RFC 4566
2069 // p=* (phone number)
2070 GetLineWithType(message, pos, &line, kLineTypeSessionPhone);
2071
2072 // RFC 4566
2073 // c=* (connection information -- not required if included in
2074 // all media)
zhihuang38989e52017-03-21 11:04:53 -07002075 if (GetLineWithType(message, pos, &line, kLineTypeConnection)) {
2076 if (!ParseConnectionData(line, connection_addr, error)) {
2077 return false;
2078 }
2079 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002080
2081 // RFC 4566
2082 // b=* (zero or more bandwidth information lines)
2083 while (GetLineWithType(message, pos, &line, kLineTypeSessionBandwidth)) {
2084 // By pass zero or more b lines.
2085 }
2086
2087 // RFC 4566
2088 // One or more time descriptions ("t=" and "r=" lines; see below)
2089 // t= (time the session is active)
2090 // r=* (zero or more repeat times)
2091 // Ensure there's at least one time description
2092 if (!GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2093 return ParseFailedExpectLine(message, *pos, kLineTypeTiming, std::string(),
2094 error);
2095 }
2096
2097 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2098 // By pass zero or more r lines.
2099 }
2100
2101 // Go through the rest of the time descriptions
2102 while (GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2103 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2104 // By pass zero or more r lines.
2105 }
2106 }
2107
2108 // RFC 4566
2109 // z=* (time zone adjustments)
2110 GetLineWithType(message, pos, &line, kLineTypeTimeZone);
2111
2112 // RFC 4566
2113 // k=* (encryption key)
2114 GetLineWithType(message, pos, &line, kLineTypeEncryptionKey);
2115
2116 // RFC 4566
2117 // a=* (zero or more session attribute lines)
2118 while (GetLineWithType(message, pos, &line, kLineTypeAttributes)) {
2119 if (HasAttribute(line, kAttributeGroup)) {
2120 if (!ParseGroupAttribute(line, desc, error)) {
2121 return false;
2122 }
2123 } else if (HasAttribute(line, kAttributeIceUfrag)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002124 if (!GetValue(line, kAttributeIceUfrag, &(session_td->ice_ufrag),
2125 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002126 return false;
2127 }
2128 } else if (HasAttribute(line, kAttributeIcePwd)) {
2129 if (!GetValue(line, kAttributeIcePwd, &(session_td->ice_pwd), error)) {
2130 return false;
2131 }
2132 } else if (HasAttribute(line, kAttributeIceLite)) {
2133 session_td->ice_mode = cricket::ICEMODE_LITE;
2134 } else if (HasAttribute(line, kAttributeIceOption)) {
2135 if (!ParseIceOptions(line, &(session_td->transport_options), error)) {
2136 return false;
2137 }
2138 } else if (HasAttribute(line, kAttributeFingerprint)) {
2139 if (session_td->identity_fingerprint.get()) {
2140 return ParseFailed(
2141 line,
2142 "Can't have multiple fingerprint attributes at the same level.",
2143 error);
2144 }
Steve Anton4905edb2018-10-15 19:27:44 -07002145 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002146 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2147 return false;
2148 }
Steve Anton4905edb2018-10-15 19:27:44 -07002149 session_td->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002150 } else if (HasAttribute(line, kAttributeSetup)) {
2151 if (!ParseDtlsSetup(line, &(session_td->connection_role), error)) {
2152 return false;
2153 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002154 } else if (HasAttribute(line, kAttributeMsidSemantics)) {
2155 std::string semantics;
2156 if (!GetValue(line, kAttributeMsidSemantics, &semantics, error)) {
2157 return false;
2158 }
deadbeefc80741f2015-10-22 13:14:45 -07002159 desc->set_msid_supported(
2160 CaseInsensitiveFind(semantics, kMediaStreamSemantic));
Johannes Kron0854eb62018-10-10 22:33:20 +02002161 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02002162 desc->set_extmap_allow_mixed(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002163 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002164 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002165 if (!ParseExtmap(line, &extmap, error)) {
2166 return false;
2167 }
2168 session_extmaps->push_back(extmap);
2169 }
2170 }
2171
2172 return true;
2173}
2174
2175bool ParseGroupAttribute(const std::string& line,
2176 cricket::SessionDescription* desc,
2177 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002178 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002179
2180 // RFC 5888 and draft-holmberg-mmusic-sdp-bundle-negotiation-00
2181 // a=group:BUNDLE video voice
2182 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002183 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002184 std::string semantics;
2185 if (!GetValue(fields[0], kAttributeGroup, &semantics, error)) {
2186 return false;
2187 }
2188 cricket::ContentGroup group(semantics);
2189 for (size_t i = 1; i < fields.size(); ++i) {
2190 group.AddContentName(fields[i]);
2191 }
2192 desc->AddGroup(group);
2193 return true;
2194}
2195
Steve Anton4905edb2018-10-15 19:27:44 -07002196static bool ParseFingerprintAttribute(
2197 const std::string& line,
2198 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
2199 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002200 if (!IsLineType(line, kLineTypeAttributes) ||
2201 !HasAttribute(line, kAttributeFingerprint)) {
2202 return ParseFailedExpectLine(line, 0, kLineTypeAttributes,
2203 kAttributeFingerprint, error);
2204 }
2205
2206 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002207 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002208 const size_t expected_fields = 2;
2209 if (fields.size() != expected_fields) {
2210 return ParseFailedExpectFieldNum(line, expected_fields, error);
2211 }
2212
2213 // The first field here is "fingerprint:<hash>.
2214 std::string algorithm;
2215 if (!GetValue(fields[0], kAttributeFingerprint, &algorithm, error)) {
2216 return false;
2217 }
2218
2219 // Downcase the algorithm. Note that we don't need to downcase the
2220 // fingerprint because hex_decode can handle upper-case.
2221 std::transform(algorithm.begin(), algorithm.end(), algorithm.begin(),
2222 ::tolower);
2223
2224 // The second field is the digest value. De-hexify it.
Steve Anton4905edb2018-10-15 19:27:44 -07002225 *fingerprint =
2226 rtc::SSLFingerprint::CreateUniqueFromRfc4572(algorithm, fields[1]);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002227 if (!*fingerprint) {
Yves Gerey665174f2018-06-19 15:03:05 +02002228 return ParseFailed(line, "Failed to create fingerprint from the digest.",
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002229 error);
2230 }
2231
2232 return true;
2233}
2234
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002235static bool ParseDtlsSetup(const std::string& line,
2236 cricket::ConnectionRole* role,
2237 SdpParseError* error) {
2238 // setup-attr = "a=setup:" role
2239 // role = "active" / "passive" / "actpass" / "holdconn"
2240 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002241 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002242 const size_t expected_fields = 2;
2243 if (fields.size() != expected_fields) {
2244 return ParseFailedExpectFieldNum(line, expected_fields, error);
2245 }
2246 std::string role_str = fields[1];
2247 if (!cricket::StringToConnectionRole(role_str, role)) {
2248 return ParseFailed(line, "Invalid attribute value.", error);
2249 }
2250 return true;
2251}
2252
deadbeef9d3584c2016-02-16 17:54:10 -08002253static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -07002254 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -08002255 std::string* track_id,
2256 SdpParseError* error) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002257 // https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
deadbeef9d3584c2016-02-16 17:54:10 -08002258 // a=msid:<stream id> <track id>
2259 // msid-value = msid-id [ SP msid-appdata ]
2260 // msid-id = 1*64token-char ; see RFC 4566
2261 // msid-appdata = 1*64token-char ; see RFC 4566
2262 std::string field1;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002263 std::string new_stream_id;
2264 std::string new_track_id;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002265 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
2266 kSdpDelimiterSpaceChar, &field1, &new_track_id)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002267 const size_t expected_fields = 2;
2268 return ParseFailedExpectFieldNum(line, expected_fields, error);
2269 }
2270
Seth Hampson5b4f0752018-04-02 16:31:36 -07002271 if (new_track_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002272 return ParseFailed(line, "Missing track ID in msid attribute.", error);
2273 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002274 // All track ids should be the same within an m section in a Unified Plan SDP.
2275 if (!track_id->empty() && new_track_id.compare(*track_id) != 0) {
2276 return ParseFailed(
2277 line, "Two different track IDs in msid attribute in one m= section",
2278 error);
2279 }
2280 *track_id = new_track_id;
deadbeefa4549d62017-02-10 17:26:22 -08002281
deadbeef9d3584c2016-02-16 17:54:10 -08002282 // msid:<msid-id>
Seth Hampson5b4f0752018-04-02 16:31:36 -07002283 if (!GetValue(field1, kAttributeMsid, &new_stream_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002284 return false;
2285 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002286 if (new_stream_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002287 return ParseFailed(line, "Missing stream ID in msid attribute.", error);
2288 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002289 // The special value "-" indicates "no MediaStream".
2290 if (new_stream_id.compare(kNoStreamMsid) != 0) {
2291 stream_ids->push_back(new_stream_id);
2292 }
deadbeef9d3584c2016-02-16 17:54:10 -08002293 return true;
2294}
2295
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002296// RFC 3551
2297// PT encoding media type clock rate channels
2298// name (Hz)
2299// 0 PCMU A 8,000 1
2300// 1 reserved A
2301// 2 reserved A
2302// 3 GSM A 8,000 1
2303// 4 G723 A 8,000 1
2304// 5 DVI4 A 8,000 1
2305// 6 DVI4 A 16,000 1
2306// 7 LPC A 8,000 1
2307// 8 PCMA A 8,000 1
2308// 9 G722 A 8,000 1
2309// 10 L16 A 44,100 2
2310// 11 L16 A 44,100 1
2311// 12 QCELP A 8,000 1
2312// 13 CN A 8,000 1
2313// 14 MPA A 90,000 (see text)
2314// 15 G728 A 8,000 1
2315// 16 DVI4 A 11,025 1
2316// 17 DVI4 A 22,050 1
2317// 18 G729 A 8,000 1
2318struct StaticPayloadAudioCodec {
2319 const char* name;
2320 int clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002321 size_t channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002322};
2323static const StaticPayloadAudioCodec kStaticPayloadAudioCodecs[] = {
Yves Gerey665174f2018-06-19 15:03:05 +02002324 {"PCMU", 8000, 1}, {"reserved", 0, 0}, {"reserved", 0, 0},
2325 {"GSM", 8000, 1}, {"G723", 8000, 1}, {"DVI4", 8000, 1},
2326 {"DVI4", 16000, 1}, {"LPC", 8000, 1}, {"PCMA", 8000, 1},
2327 {"G722", 8000, 1}, {"L16", 44100, 2}, {"L16", 44100, 1},
2328 {"QCELP", 8000, 1}, {"CN", 8000, 1}, {"MPA", 90000, 1},
2329 {"G728", 8000, 1}, {"DVI4", 11025, 1}, {"DVI4", 22050, 1},
2330 {"G729", 8000, 1},
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002331};
2332
Yves Gerey665174f2018-06-19 15:03:05 +02002333void MaybeCreateStaticPayloadAudioCodecs(const std::vector<int>& fmts,
2334 AudioContentDescription* media_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002335 if (!media_desc) {
2336 return;
2337 }
deadbeef67cf2c12016-04-13 10:07:16 -07002338 RTC_DCHECK(media_desc->codecs().empty());
solenberg9fa49752016-10-08 13:02:44 -07002339 for (int payload_type : fmts) {
Yves Gerey665174f2018-06-19 15:03:05 +02002340 if (!media_desc->HasCodec(payload_type) && payload_type >= 0 &&
kjellander3e33bfe2016-06-20 07:04:09 -07002341 static_cast<uint32_t>(payload_type) <
2342 arraysize(kStaticPayloadAudioCodecs)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002343 std::string encoding_name = kStaticPayloadAudioCodecs[payload_type].name;
2344 int clock_rate = kStaticPayloadAudioCodecs[payload_type].clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002345 size_t channels = kStaticPayloadAudioCodecs[payload_type].channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002346 media_desc->AddCodec(cricket::AudioCodec(payload_type, encoding_name,
deadbeef67cf2c12016-04-13 10:07:16 -07002347 clock_rate, 0, channels));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002348 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002349 }
2350}
2351
2352template <class C>
2353static C* ParseContentDescription(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002354 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002355 int mline_index,
2356 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002357 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002358 size_t* pos,
2359 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002360 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002361 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002362 TransportDescription* transport,
2363 std::vector<JsepIceCandidate*>* candidates,
2364 webrtc::SdpParseError* error) {
2365 C* media_desc = new C();
2366 switch (media_type) {
2367 case cricket::MEDIA_TYPE_AUDIO:
2368 *content_name = cricket::CN_AUDIO;
2369 break;
2370 case cricket::MEDIA_TYPE_VIDEO:
2371 *content_name = cricket::CN_VIDEO;
2372 break;
2373 case cricket::MEDIA_TYPE_DATA:
2374 *content_name = cricket::CN_DATA;
2375 break;
2376 default:
nissec80e7412017-01-11 05:56:46 -08002377 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002378 break;
2379 }
deadbeef67cf2c12016-04-13 10:07:16 -07002380 if (!ParseContent(message, media_type, mline_index, protocol, payload_types,
Steve Antone831b8c2018-02-01 12:22:16 -08002381 pos, content_name, bundle_only, msid_signaling, media_desc,
2382 transport, candidates, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002383 delete media_desc;
zhihuang38989e52017-03-21 11:04:53 -07002384 return nullptr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002385 }
2386 // Sort the codecs according to the m-line fmt list.
deadbeef67cf2c12016-04-13 10:07:16 -07002387 std::unordered_map<int, int> payload_type_preferences;
2388 // "size + 1" so that the lowest preference payload type has a preference of
2389 // 1, which is greater than the default (0) for payload types not in the fmt
2390 // list.
2391 int preference = static_cast<int>(payload_types.size() + 1);
2392 for (int pt : payload_types) {
2393 payload_type_preferences[pt] = preference--;
2394 }
2395 std::vector<typename C::CodecType> codecs = media_desc->codecs();
Yves Gerey665174f2018-06-19 15:03:05 +02002396 std::sort(codecs.begin(), codecs.end(),
2397 [&payload_type_preferences](const typename C::CodecType& a,
2398 const typename C::CodecType& b) {
2399 return payload_type_preferences[a.id] >
2400 payload_type_preferences[b.id];
2401 });
deadbeef67cf2c12016-04-13 10:07:16 -07002402 media_desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002403 return media_desc;
2404}
2405
2406bool ParseMediaDescription(const std::string& message,
2407 const TransportDescription& session_td,
2408 const RtpHeaderExtensions& session_extmaps,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002409 size_t* pos,
zhihuang38989e52017-03-21 11:04:53 -07002410 const rtc::SocketAddress& session_connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002411 cricket::SessionDescription* desc,
2412 std::vector<JsepIceCandidate*>* candidates,
2413 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002414 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002415 std::string line;
2416 int mline_index = -1;
Steve Antone831b8c2018-02-01 12:22:16 -08002417 int msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002418
2419 // Zero or more media descriptions
2420 // RFC 4566
2421 // m=<media> <port> <proto> <fmt>
2422 while (GetLineWithType(message, pos, &line, kLineTypeMedia)) {
2423 ++mline_index;
2424
2425 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002426 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
zstein4b2e0822017-02-17 19:48:38 -08002427
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002428 const size_t expected_min_fields = 4;
2429 if (fields.size() < expected_min_fields) {
2430 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
2431 }
deadbeef25ed4352016-12-12 18:37:36 -08002432 bool port_rejected = false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002433 // RFC 3264
2434 // To reject an offered stream, the port number in the corresponding stream
2435 // in the answer MUST be set to zero.
2436 if (fields[1] == kMediaPortRejected) {
deadbeef25ed4352016-12-12 18:37:36 -08002437 port_rejected = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002438 }
2439
zhihuang38989e52017-03-21 11:04:53 -07002440 int port = 0;
2441 if (!rtc::FromString<int>(fields[1], &port) || !IsValidPort(port)) {
2442 return ParseFailed(line, "The port number is invalid", error);
2443 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002444 std::string protocol = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002445
2446 // <fmt>
deadbeef67cf2c12016-04-13 10:07:16 -07002447 std::vector<int> payload_types;
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002448 if (IsRtp(protocol)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002449 for (size_t j = 3; j < fields.size(); ++j) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002450 // TODO(wu): Remove when below bug is fixed.
2451 // https://bugzilla.mozilla.org/show_bug.cgi?id=996329
pbosbb36fdf2015-07-09 07:48:14 -07002452 if (fields[j].empty() && j == fields.size() - 1) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002453 continue;
2454 }
wu@webrtc.org36eda7c2014-04-15 20:37:30 +00002455
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002456 int pl = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00002457 if (!GetPayloadTypeFromString(line, fields[j], &pl, error)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002458 return false;
2459 }
deadbeef67cf2c12016-04-13 10:07:16 -07002460 payload_types.push_back(pl);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002461 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002462 }
2463
2464 // Make a temporary TransportDescription based on |session_td|.
2465 // Some of this gets overwritten by ParseContent.
deadbeef46eed762016-01-28 13:24:37 -08002466 TransportDescription transport(
2467 session_td.transport_options, session_td.ice_ufrag, session_td.ice_pwd,
2468 session_td.ice_mode, session_td.connection_role,
2469 session_td.identity_fingerprint.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002470
kwibergd1fe2812016-04-27 06:47:29 -07002471 std::unique_ptr<MediaContentDescription> content;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002472 std::string content_name;
deadbeef25ed4352016-12-12 18:37:36 -08002473 bool bundle_only = false;
Steve Antone831b8c2018-02-01 12:22:16 -08002474 int section_msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002475 if (HasAttribute(line, kMediaTypeVideo)) {
2476 content.reset(ParseContentDescription<VideoContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002477 message, cricket::MEDIA_TYPE_VIDEO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002478 payload_types, pos, &content_name, &bundle_only,
2479 &section_msid_signaling, &transport, candidates, error));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002480 } else if (HasAttribute(line, kMediaTypeAudio)) {
2481 content.reset(ParseContentDescription<AudioContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002482 message, cricket::MEDIA_TYPE_AUDIO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002483 payload_types, pos, &content_name, &bundle_only,
2484 &section_msid_signaling, &transport, candidates, error));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002485 } else if (HasAttribute(line, kMediaTypeData)) {
jiayl@webrtc.org0e527722014-09-08 21:43:43 +00002486 DataContentDescription* data_desc =
wu@webrtc.org78187522013-10-07 23:32:02 +00002487 ParseContentDescription<DataContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002488 message, cricket::MEDIA_TYPE_DATA, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002489 payload_types, pos, &content_name, &bundle_only,
2490 &section_msid_signaling, &transport, candidates, error);
jiayl@webrtc.org0e527722014-09-08 21:43:43 +00002491 content.reset(data_desc);
wu@webrtc.org78187522013-10-07 23:32:02 +00002492
zstein4b2e0822017-02-17 19:48:38 -08002493 if (data_desc && IsDtlsSctp(protocol)) {
2494 int p;
2495 if (rtc::FromString(fields[3], &p)) {
2496 if (!AddSctpDataCodec(data_desc, p)) {
2497 return false;
2498 }
2499 } else if (fields[3] == kDefaultSctpmapProtocol) {
2500 data_desc->set_use_sctpmap(false);
2501 }
wu@webrtc.org78187522013-10-07 23:32:02 +00002502 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002503 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002504 RTC_LOG(LS_WARNING) << "Unsupported media type: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002505 continue;
2506 }
2507 if (!content.get()) {
2508 // ParseContentDescription returns NULL if failed.
2509 return false;
2510 }
2511
Steve Antone831b8c2018-02-01 12:22:16 -08002512 msid_signaling |= section_msid_signaling;
2513
deadbeef25ed4352016-12-12 18:37:36 -08002514 bool content_rejected = false;
deadbeef12771a12017-01-03 13:53:47 -08002515 // A port of 0 is not interpreted as a rejected m= section when it's
2516 // used along with a=bundle-only.
deadbeef25ed4352016-12-12 18:37:36 -08002517 if (bundle_only) {
deadbeef25ed4352016-12-12 18:37:36 -08002518 if (!port_rejected) {
deadbeef12771a12017-01-03 13:53:47 -08002519 // Usage of bundle-only with a nonzero port is unspecified. So just
2520 // ignore bundle-only if we see this.
2521 bundle_only = false;
Mirko Bonadei675513b2017-11-09 11:09:25 +01002522 RTC_LOG(LS_WARNING)
deadbeef12771a12017-01-03 13:53:47 -08002523 << "a=bundle-only attribute observed with a nonzero "
Jonas Olsson45cc8902018-02-13 10:37:07 +01002524 "port; this usage is unspecified so the attribute is being "
2525 "ignored.";
deadbeef25ed4352016-12-12 18:37:36 -08002526 }
2527 } else {
2528 // If not using bundle-only, interpret port 0 in the normal way; the m=
2529 // section is being rejected.
2530 content_rejected = port_rejected;
2531 }
2532
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002533 if (IsRtp(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002534 // Set the extmap.
2535 if (!session_extmaps.empty() &&
2536 !content->rtp_header_extensions().empty()) {
2537 return ParseFailed("",
2538 "The a=extmap MUST be either all session level or "
2539 "all media level.",
2540 error);
2541 }
2542 for (size_t i = 0; i < session_extmaps.size(); ++i) {
2543 content->AddRtpHeaderExtension(session_extmaps[i]);
2544 }
2545 }
2546 content->set_protocol(protocol);
zhihuang38989e52017-03-21 11:04:53 -07002547
2548 // Use the session level connection address if the media level addresses are
2549 // not specified.
2550 rtc::SocketAddress address;
2551 address = content->connection_address().IsNil()
2552 ? session_connection_addr
2553 : content->connection_address();
2554 address.SetPort(port);
2555 content->set_connection_address(address);
2556
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002557 desc->AddContent(content_name,
Steve Anton5adfafd2017-12-20 16:34:00 -08002558 IsDtlsSctp(protocol) ? MediaProtocolType::kSctp
2559 : MediaProtocolType::kRtp,
deadbeef25ed4352016-12-12 18:37:36 -08002560 content_rejected, bundle_only, content.release());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002561 // Create TransportInfo with the media level "ice-pwd" and "ice-ufrag".
2562 TransportInfo transport_info(content_name, transport);
2563
2564 if (!desc->AddTransportInfo(transport_info)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002565 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002566 description << "Failed to AddTransportInfo with content name: "
2567 << content_name;
2568 return ParseFailed("", description.str(), error);
2569 }
2570 }
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002571
Steve Antone831b8c2018-02-01 12:22:16 -08002572 desc->set_msid_signaling(msid_signaling);
2573
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002574 size_t end_of_message = message.size();
2575 if (mline_index == -1 && *pos != end_of_message) {
2576 ParseFailed(message, *pos, "Expects m line.", error);
2577 return false;
2578 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002579 return true;
2580}
2581
2582bool VerifyCodec(const cricket::Codec& codec) {
2583 // Codec has not been populated correctly unless the name has been set. This
2584 // can happen if an SDP has an fmtp or rtcp-fb with a payload type but doesn't
2585 // have a corresponding "rtpmap" line.
htab39db842016-12-08 01:50:48 -08002586 return !codec.name.empty();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002587}
2588
2589bool VerifyAudioCodecs(const AudioContentDescription* audio_desc) {
2590 const std::vector<cricket::AudioCodec>& codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002591 return std::all_of(codecs.begin(), codecs.end(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002592}
2593
2594bool VerifyVideoCodecs(const VideoContentDescription* video_desc) {
2595 const std::vector<cricket::VideoCodec>& codecs = video_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002596 return std::all_of(codecs.begin(), codecs.end(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002597}
2598
2599void AddParameters(const cricket::CodecParameterMap& parameters,
2600 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002601 for (const auto& entry : parameters) {
2602 const std::string& key = entry.first;
2603 const std::string& value = entry.second;
2604 codec->SetParam(key, value);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002605 }
2606}
2607
2608void AddFeedbackParameter(const cricket::FeedbackParam& feedback_param,
2609 cricket::Codec* codec) {
2610 codec->AddFeedbackParam(feedback_param);
2611}
2612
2613void AddFeedbackParameters(const cricket::FeedbackParams& feedback_params,
2614 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002615 for (const cricket::FeedbackParam& param : feedback_params.params()) {
2616 codec->AddFeedbackParam(param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002617 }
2618}
2619
2620// Gets the current codec setting associated with |payload_type|. If there
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002621// is no Codec associated with that payload type it returns an empty codec
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002622// with that payload type.
2623template <class T>
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002624T GetCodecWithPayloadType(const std::vector<T>& codecs, int payload_type) {
magjedb05fa242016-11-11 04:00:16 -08002625 const T* codec = FindCodecById(codecs, payload_type);
2626 if (codec)
2627 return *codec;
2628 // Return empty codec with |payload_type|.
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002629 T ret_val;
magjedb05fa242016-11-11 04:00:16 -08002630 ret_val.id = payload_type;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002631 return ret_val;
2632}
2633
2634// Updates or creates a new codec entry in the audio description.
2635template <class T, class U>
2636void AddOrReplaceCodec(MediaContentDescription* content_desc, const U& codec) {
2637 T* desc = static_cast<T*>(content_desc);
2638 std::vector<U> codecs = desc->codecs();
2639 bool found = false;
Steve Anton4daf66e2018-09-07 14:55:53 -07002640 for (U& existing_codec : codecs) {
2641 if (codec.id == existing_codec.id) {
2642 // Overwrite existing codec with the new codec.
2643 existing_codec = codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002644 found = true;
2645 break;
2646 }
2647 }
2648 if (!found) {
2649 desc->AddCodec(codec);
2650 return;
2651 }
2652 desc->set_codecs(codecs);
2653}
2654
2655// Adds or updates existing codec corresponding to |payload_type| according
2656// to |parameters|.
2657template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002658void UpdateCodec(MediaContentDescription* content_desc,
2659 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002660 const cricket::CodecParameterMap& parameters) {
2661 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002662 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2663 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002664 AddParameters(parameters, &new_codec);
2665 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2666}
2667
2668// Adds or updates existing codec corresponding to |payload_type| according
2669// to |feedback_param|.
2670template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002671void UpdateCodec(MediaContentDescription* content_desc,
2672 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002673 const cricket::FeedbackParam& feedback_param) {
2674 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002675 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2676 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002677 AddFeedbackParameter(feedback_param, &new_codec);
2678 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2679}
2680
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002681template <class T>
2682bool PopWildcardCodec(std::vector<T>* codecs, T* wildcard_codec) {
2683 for (auto iter = codecs->begin(); iter != codecs->end(); ++iter) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002684 if (iter->id == kWildcardPayloadType) {
2685 *wildcard_codec = *iter;
2686 codecs->erase(iter);
2687 return true;
2688 }
2689 }
2690 return false;
2691}
2692
Yves Gerey665174f2018-06-19 15:03:05 +02002693template <class T>
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002694void UpdateFromWildcardCodecs(cricket::MediaContentDescriptionImpl<T>* desc) {
2695 auto codecs = desc->codecs();
2696 T wildcard_codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002697 if (!PopWildcardCodec(&codecs, &wildcard_codec)) {
2698 return;
2699 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002700 for (auto& codec : codecs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002701 AddFeedbackParameters(wildcard_codec.feedback_params, &codec);
2702 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002703 desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002704}
2705
Yves Gerey665174f2018-06-19 15:03:05 +02002706void AddAudioAttribute(const std::string& name,
2707 const std::string& value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002708 AudioContentDescription* audio_desc) {
2709 if (value.empty()) {
2710 return;
2711 }
2712 std::vector<cricket::AudioCodec> codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002713 for (cricket::AudioCodec& codec : codecs) {
2714 codec.params[name] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002715 }
2716 audio_desc->set_codecs(codecs);
2717}
2718
2719bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002720 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002721 int mline_index,
2722 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002723 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002724 size_t* pos,
2725 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002726 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002727 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002728 MediaContentDescription* media_desc,
2729 TransportDescription* transport,
2730 std::vector<JsepIceCandidate*>* candidates,
2731 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002732 RTC_DCHECK(media_desc != NULL);
2733 RTC_DCHECK(content_name != NULL);
2734 RTC_DCHECK(transport != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002735
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002736 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002737 MaybeCreateStaticPayloadAudioCodecs(payload_types, media_desc->as_audio());
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002738 }
2739
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002740 // The media level "ice-ufrag" and "ice-pwd".
2741 // The candidates before update the media level "ice-pwd" and "ice-ufrag".
2742 Candidates candidates_orig;
2743 std::string line;
2744 std::string mline_id;
2745 // Tracks created out of the ssrc attributes.
2746 StreamParamsVec tracks;
2747 SsrcInfoVec ssrc_infos;
2748 SsrcGroupVec ssrc_groups;
2749 std::string maxptime_as_string;
2750 std::string ptime_as_string;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002751 std::vector<std::string> stream_ids;
deadbeef9d3584c2016-02-16 17:54:10 -08002752 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002753
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002754 // Loop until the next m line
2755 while (!IsLineType(message, kLineTypeMedia, *pos)) {
2756 if (!GetLine(message, pos, &line)) {
2757 if (*pos >= message.size()) {
2758 break; // Done parsing
2759 } else {
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +00002760 return ParseFailed(message, *pos, "Invalid SDP line.", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002761 }
2762 }
2763
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002764 // RFC 4566
2765 // b=* (zero or more bandwidth information lines)
2766 if (IsLineType(line, kLineTypeSessionBandwidth)) {
2767 std::string bandwidth;
2768 if (HasAttribute(line, kApplicationSpecificMaximum)) {
2769 if (!GetValue(line, kApplicationSpecificMaximum, &bandwidth, error)) {
2770 return false;
2771 } else {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002772 int b = 0;
2773 if (!GetValueFromString(line, bandwidth, &b, error)) {
2774 return false;
2775 }
deadbeef3e8016e2017-08-03 17:49:30 -07002776 // TODO(deadbeef): Historically, applications may be setting a value
2777 // of -1 to mean "unset any previously set bandwidth limit", even
2778 // though ommitting the "b=AS" entirely will do just that. Once we've
2779 // transitioned applications to doing the right thing, it would be
2780 // better to treat this as a hard error instead of just ignoring it.
2781 if (b == -1) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002782 RTC_LOG(LS_WARNING)
2783 << "Ignoring \"b=AS:-1\"; will be treated as \"no "
2784 "bandwidth limit\".";
deadbeef3e8016e2017-08-03 17:49:30 -07002785 continue;
2786 }
deadbeefbc88c6b2017-08-02 11:26:34 -07002787 if (b < 0) {
2788 return ParseFailed(line, "b=AS value can't be negative.", error);
2789 }
Peter Thatcherc0c3a862015-06-24 15:31:25 -07002790 // We should never use more than the default bandwidth for RTP-based
2791 // data channels. Don't allow SDP to set the bandwidth, because
2792 // that would give JS the opportunity to "break the Internet".
2793 // See: https://code.google.com/p/chromium/issues/detail?id=280726
2794 if (media_type == cricket::MEDIA_TYPE_DATA && IsRtp(protocol) &&
2795 b > cricket::kDataMaxBandwidth / 1000) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002796 rtc::StringBuilder description;
Peter Thatcherc0c3a862015-06-24 15:31:25 -07002797 description << "RTP-based data channels may not send more than "
2798 << cricket::kDataMaxBandwidth / 1000 << "kbps.";
2799 return ParseFailed(line, description.str(), error);
2800 }
deadbeefb2362572016-12-13 16:37:06 -08002801 // Prevent integer overflow.
2802 b = std::min(b, INT_MAX / 1000);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002803 media_desc->set_bandwidth(b * 1000);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002804 }
2805 }
2806 continue;
2807 }
2808
zhihuang38989e52017-03-21 11:04:53 -07002809 // Parse the media level connection data.
2810 if (IsLineType(line, kLineTypeConnection)) {
2811 rtc::SocketAddress addr;
2812 if (!ParseConnectionData(line, &addr, error)) {
2813 return false;
2814 }
2815 media_desc->set_connection_address(addr);
2816 continue;
2817 }
2818
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002819 if (!IsLineType(line, kLineTypeAttributes)) {
Steve Anton36b29d12017-10-30 09:57:42 -07002820 // TODO(deadbeef): Handle other lines if needed.
Mirko Bonadei675513b2017-11-09 11:09:25 +01002821 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002822 continue;
2823 }
2824
2825 // Handle attributes common to SCTP and RTP.
2826 if (HasAttribute(line, kAttributeMid)) {
2827 // RFC 3388
2828 // mid-attribute = "a=mid:" identification-tag
2829 // identification-tag = token
2830 // Use the mid identification-tag as the content name.
2831 if (!GetValue(line, kAttributeMid, &mline_id, error)) {
2832 return false;
2833 }
2834 *content_name = mline_id;
deadbeef25ed4352016-12-12 18:37:36 -08002835 } else if (HasAttribute(line, kAttributeBundleOnly)) {
2836 *bundle_only = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002837 } else if (HasAttribute(line, kAttributeCandidate)) {
2838 Candidate candidate;
2839 if (!ParseCandidate(line, &candidate, error, false)) {
2840 return false;
2841 }
deadbeef7bcdb692017-01-20 12:43:58 -08002842 // ParseCandidate will parse non-standard ufrag and password attributes,
2843 // since it's used for candidate trickling, but we only want to process
2844 // the "a=ice-ufrag"/"a=ice-pwd" values in a session description, so
2845 // strip them off at this point.
2846 candidate.set_username(std::string());
2847 candidate.set_password(std::string());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002848 candidates_orig.push_back(candidate);
2849 } else if (HasAttribute(line, kAttributeIceUfrag)) {
2850 if (!GetValue(line, kAttributeIceUfrag, &transport->ice_ufrag, error)) {
2851 return false;
2852 }
2853 } else if (HasAttribute(line, kAttributeIcePwd)) {
2854 if (!GetValue(line, kAttributeIcePwd, &transport->ice_pwd, error)) {
2855 return false;
2856 }
2857 } else if (HasAttribute(line, kAttributeIceOption)) {
2858 if (!ParseIceOptions(line, &transport->transport_options, error)) {
2859 return false;
2860 }
2861 } else if (HasAttribute(line, kAttributeFmtp)) {
2862 if (!ParseFmtpAttributes(line, media_type, media_desc, error)) {
2863 return false;
2864 }
2865 } else if (HasAttribute(line, kAttributeFingerprint)) {
Steve Anton4905edb2018-10-15 19:27:44 -07002866 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002867 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2868 return false;
2869 }
Steve Anton4905edb2018-10-15 19:27:44 -07002870 transport->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002871 } else if (HasAttribute(line, kAttributeSetup)) {
2872 if (!ParseDtlsSetup(line, &(transport->connection_role), error)) {
2873 return false;
2874 }
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002875 } else if (IsDtlsSctp(protocol) && HasAttribute(line, kAttributeSctpPort)) {
deadbeef7e146cb2016-09-28 10:04:34 -07002876 if (media_type != cricket::MEDIA_TYPE_DATA) {
2877 return ParseFailed(
2878 line, "sctp-port attribute found in non-data media description.",
2879 error);
2880 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002881 int sctp_port;
2882 if (!ParseSctpPort(line, &sctp_port, error)) {
2883 return false;
2884 }
Steve Antonb1c1de12017-12-21 15:14:30 -08002885 if (!AddSctpDataCodec(media_desc->as_data(), sctp_port)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002886 return false;
2887 }
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002888 } else if (IsRtp(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002889 //
2890 // RTP specific attrubtes
2891 //
2892 if (HasAttribute(line, kAttributeRtcpMux)) {
2893 media_desc->set_rtcp_mux(true);
deadbeef13871492015-12-09 12:37:51 -08002894 } else if (HasAttribute(line, kAttributeRtcpReducedSize)) {
2895 media_desc->set_rtcp_reduced_size(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002896 } else if (HasAttribute(line, kAttributeSsrcGroup)) {
2897 if (!ParseSsrcGroupAttribute(line, &ssrc_groups, error)) {
2898 return false;
2899 }
2900 } else if (HasAttribute(line, kAttributeSsrc)) {
Steve Antone831b8c2018-02-01 12:22:16 -08002901 if (!ParseSsrcAttribute(line, &ssrc_infos, msid_signaling, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002902 return false;
2903 }
2904 } else if (HasAttribute(line, kAttributeCrypto)) {
2905 if (!ParseCryptoAttribute(line, media_desc, error)) {
2906 return false;
2907 }
2908 } else if (HasAttribute(line, kAttributeRtpmap)) {
deadbeef67cf2c12016-04-13 10:07:16 -07002909 if (!ParseRtpmapAttribute(line, media_type, payload_types, media_desc,
2910 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002911 return false;
2912 }
2913 } else if (HasAttribute(line, kCodecParamMaxPTime)) {
2914 if (!GetValue(line, kCodecParamMaxPTime, &maxptime_as_string, error)) {
2915 return false;
2916 }
2917 } else if (HasAttribute(line, kAttributeRtcpFb)) {
2918 if (!ParseRtcpFbAttribute(line, media_type, media_desc, error)) {
2919 return false;
2920 }
2921 } else if (HasAttribute(line, kCodecParamPTime)) {
2922 if (!GetValue(line, kCodecParamPTime, &ptime_as_string, error)) {
2923 return false;
2924 }
2925 } else if (HasAttribute(line, kAttributeSendOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002926 media_desc->set_direction(RtpTransceiverDirection::kSendOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002927 } else if (HasAttribute(line, kAttributeRecvOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002928 media_desc->set_direction(RtpTransceiverDirection::kRecvOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002929 } else if (HasAttribute(line, kAttributeInactive)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002930 media_desc->set_direction(RtpTransceiverDirection::kInactive);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002931 } else if (HasAttribute(line, kAttributeSendRecv)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002932 media_desc->set_direction(RtpTransceiverDirection::kSendRecv);
Johannes Kron0854eb62018-10-10 22:33:20 +02002933 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02002934 media_desc->set_extmap_allow_mixed_enum(
Johannes Kron0854eb62018-10-10 22:33:20 +02002935 MediaContentDescription::kMedia);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002936 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002937 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002938 if (!ParseExtmap(line, &extmap, error)) {
2939 return false;
2940 }
2941 media_desc->AddRtpHeaderExtension(extmap);
2942 } else if (HasAttribute(line, kAttributeXGoogleFlag)) {
2943 // Experimental attribute. Conference mode activates more aggressive
2944 // AEC and NS settings.
Steve Anton36b29d12017-10-30 09:57:42 -07002945 // TODO(deadbeef): expose API to set these directly.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002946 std::string flag_value;
2947 if (!GetValue(line, kAttributeXGoogleFlag, &flag_value, error)) {
2948 return false;
2949 }
2950 if (flag_value.compare(kValueConference) == 0)
2951 media_desc->set_conference_mode(true);
deadbeef9d3584c2016-02-16 17:54:10 -08002952 } else if (HasAttribute(line, kAttributeMsid)) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002953 if (!ParseMsidAttribute(line, &stream_ids, &track_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002954 return false;
2955 }
Steve Antone831b8c2018-02-01 12:22:16 -08002956 *msid_signaling |= cricket::kMsidSignalingMediaSection;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002957 }
2958 } else {
2959 // Only parse lines that we are interested of.
Mirko Bonadei675513b2017-11-09 11:09:25 +01002960 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002961 continue;
2962 }
2963 }
2964
2965 // Create tracks from the |ssrc_infos|.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -08002966 // If the stream_id/track_id for all SSRCS are identical, one StreamParams
2967 // will be created in CreateTracksFromSsrcInfos, containing all the SSRCs from
2968 // the m= section.
Seth Hampson5897a6e2018-04-03 11:16:33 -07002969 if (!ssrc_infos.empty()) {
2970 CreateTracksFromSsrcInfos(ssrc_infos, stream_ids, track_id, &tracks,
2971 *msid_signaling);
2972 } else if (media_type != cricket::MEDIA_TYPE_DATA &&
2973 (*msid_signaling & cricket::kMsidSignalingMediaSection)) {
2974 // If the stream_ids/track_id was signaled but SSRCs were unsignaled we
2975 // still create a track. This isn't done for data media types because
2976 // StreamParams aren't used for SCTP streams, and RTP data channels don't
2977 // support unsignaled SSRCs.
2978 CreateTrackWithNoSsrcs(stream_ids, track_id, &tracks);
2979 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002980
2981 // Add the ssrc group to the track.
Steve Anton4daf66e2018-09-07 14:55:53 -07002982 for (const SsrcGroup& ssrc_group : ssrc_groups) {
2983 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002984 continue;
2985 }
Steve Anton4daf66e2018-09-07 14:55:53 -07002986 uint32_t ssrc = ssrc_group.ssrcs.front();
2987 for (StreamParams& track : tracks) {
2988 if (track.has_ssrc(ssrc)) {
2989 track.ssrc_groups.push_back(ssrc_group);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002990 }
2991 }
2992 }
2993
2994 // Add the new tracks to the |media_desc|.
deadbeef9d3584c2016-02-16 17:54:10 -08002995 for (StreamParams& track : tracks) {
2996 media_desc->AddStream(track);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002997 }
2998
2999 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003000 AudioContentDescription* audio_desc = media_desc->as_audio();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003001 UpdateFromWildcardCodecs(audio_desc);
3002
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003003 // Verify audio codec ensures that no audio codec has been populated with
3004 // only fmtp.
3005 if (!VerifyAudioCodecs(audio_desc)) {
3006 return ParseFailed("Failed to parse audio codecs correctly.", error);
3007 }
3008 AddAudioAttribute(kCodecParamMaxPTime, maxptime_as_string, audio_desc);
3009 AddAudioAttribute(kCodecParamPTime, ptime_as_string, audio_desc);
3010 }
3011
3012 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003013 VideoContentDescription* video_desc = media_desc->as_video();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003014 UpdateFromWildcardCodecs(video_desc);
3015 // Verify video codec ensures that no video codec has been populated with
3016 // only rtcp-fb.
3017 if (!VerifyVideoCodecs(video_desc)) {
3018 return ParseFailed("Failed to parse video codecs correctly.", error);
3019 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003020 }
3021
3022 // RFC 5245
3023 // Update the candidates with the media level "ice-pwd" and "ice-ufrag".
Steve Anton4daf66e2018-09-07 14:55:53 -07003024 for (Candidate& candidate : candidates_orig) {
3025 RTC_DCHECK(candidate.username().empty() ||
3026 candidate.username() == transport->ice_ufrag);
3027 candidate.set_username(transport->ice_ufrag);
3028 RTC_DCHECK(candidate.password().empty());
3029 candidate.set_password(transport->ice_pwd);
3030 candidates->push_back(
3031 new JsepIceCandidate(mline_id, mline_index, candidate));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003032 }
3033 return true;
3034}
3035
Steve Antone831b8c2018-02-01 12:22:16 -08003036bool ParseSsrcAttribute(const std::string& line,
3037 SsrcInfoVec* ssrc_infos,
3038 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003039 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003040 RTC_DCHECK(ssrc_infos != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003041 // RFC 5576
3042 // a=ssrc:<ssrc-id> <attribute>
3043 // a=ssrc:<ssrc-id> <attribute>:<value>
3044 std::string field1, field2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003045 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3046 kSdpDelimiterSpaceChar, &field1, &field2)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003047 const size_t expected_fields = 2;
3048 return ParseFailedExpectFieldNum(line, expected_fields, error);
3049 }
3050
3051 // ssrc:<ssrc-id>
3052 std::string ssrc_id_s;
3053 if (!GetValue(field1, kAttributeSsrc, &ssrc_id_s, error)) {
3054 return false;
3055 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003056 uint32_t ssrc_id = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003057 if (!GetValueFromString(line, ssrc_id_s, &ssrc_id, error)) {
3058 return false;
3059 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003060
3061 std::string attribute;
3062 std::string value;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003063 if (!rtc::tokenize_first(field2, kSdpDelimiterColonChar, &attribute,
3064 &value)) {
3065 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003066 description << "Failed to get the ssrc attribute value from " << field2
3067 << ". Expected format <attribute>:<value>.";
3068 return ParseFailed(line, description.str(), error);
3069 }
3070
3071 // Check if there's already an item for this |ssrc_id|. Create a new one if
3072 // there isn't.
Steve Anton4daf66e2018-09-07 14:55:53 -07003073 auto ssrc_info_it = std::find_if(ssrc_infos->begin(), ssrc_infos->end(),
3074 [ssrc_id](const SsrcInfo& ssrc_info) {
3075 return ssrc_info.ssrc_id == ssrc_id;
3076 });
3077 if (ssrc_info_it == ssrc_infos->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003078 SsrcInfo info;
3079 info.ssrc_id = ssrc_id;
3080 ssrc_infos->push_back(info);
Steve Anton4daf66e2018-09-07 14:55:53 -07003081 ssrc_info_it = ssrc_infos->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003082 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003083 SsrcInfo& ssrc_info = *ssrc_info_it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003084
3085 // Store the info to the |ssrc_info|.
3086 if (attribute == kSsrcAttributeCname) {
3087 // RFC 5576
3088 // cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003089 ssrc_info.cname = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003090 } else if (attribute == kSsrcAttributeMsid) {
3091 // draft-alvestrand-mmusic-msid-00
Seth Hampson5b4f0752018-04-02 16:31:36 -07003092 // msid:identifier [appdata]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003093 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003094 rtc::split(value, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003095 if (fields.size() < 1 || fields.size() > 2) {
Yves Gerey665174f2018-06-19 15:03:05 +02003096 return ParseFailed(
3097 line, "Expected format \"msid:<identifier>[ <appdata>]\".", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003098 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003099 ssrc_info.stream_id = fields[0];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003100 if (fields.size() == 2) {
Steve Anton4daf66e2018-09-07 14:55:53 -07003101 ssrc_info.track_id = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003102 }
Steve Antone831b8c2018-02-01 12:22:16 -08003103 *msid_signaling |= cricket::kMsidSignalingSsrcAttribute;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003104 } else if (attribute == kSsrcAttributeMslabel) {
3105 // draft-alvestrand-rtcweb-mid-01
3106 // mslabel:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003107 ssrc_info.mslabel = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003108 } else if (attribute == kSSrcAttributeLabel) {
3109 // The label isn't defined.
3110 // label:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003111 ssrc_info.label = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003112 }
3113 return true;
3114}
3115
3116bool ParseSsrcGroupAttribute(const std::string& line,
3117 SsrcGroupVec* ssrc_groups,
3118 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003119 RTC_DCHECK(ssrc_groups != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003120 // RFC 5576
3121 // a=ssrc-group:<semantics> <ssrc-id> ...
3122 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003123 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003124 const size_t expected_min_fields = 2;
3125 if (fields.size() < expected_min_fields) {
3126 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3127 }
3128 std::string semantics;
3129 if (!GetValue(fields[0], kAttributeSsrcGroup, &semantics, error)) {
3130 return false;
3131 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003132 std::vector<uint32_t> ssrcs;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003133 for (size_t i = 1; i < fields.size(); ++i) {
Peter Boström0c4e06b2015-10-07 12:23:21 +02003134 uint32_t ssrc = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003135 if (!GetValueFromString(line, fields[i], &ssrc, error)) {
3136 return false;
3137 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003138 ssrcs.push_back(ssrc);
3139 }
3140 ssrc_groups->push_back(SsrcGroup(semantics, ssrcs));
3141 return true;
3142}
3143
3144bool ParseCryptoAttribute(const std::string& line,
3145 MediaContentDescription* media_desc,
3146 SdpParseError* error) {
3147 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003148 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003149 // RFC 4568
3150 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
3151 const size_t expected_min_fields = 3;
3152 if (fields.size() < expected_min_fields) {
3153 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3154 }
3155 std::string tag_value;
3156 if (!GetValue(fields[0], kAttributeCrypto, &tag_value, error)) {
3157 return false;
3158 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003159 int tag = 0;
3160 if (!GetValueFromString(line, tag_value, &tag, error)) {
3161 return false;
3162 }
jbauch083b73f2015-07-16 02:46:32 -07003163 const std::string& crypto_suite = fields[1];
3164 const std::string& key_params = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003165 std::string session_params;
3166 if (fields.size() > 3) {
3167 session_params = fields[3];
3168 }
Yves Gerey665174f2018-06-19 15:03:05 +02003169 media_desc->AddCrypto(
3170 CryptoParams(tag, crypto_suite, key_params, session_params));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003171 return true;
3172}
3173
3174// Updates or creates a new codec entry in the audio description with according
deadbeef67cf2c12016-04-13 10:07:16 -07003175// to |name|, |clockrate|, |bitrate|, and |channels|.
3176void UpdateCodec(int payload_type,
3177 const std::string& name,
3178 int clockrate,
3179 int bitrate,
3180 size_t channels,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003181 AudioContentDescription* audio_desc) {
3182 // Codec may already be populated with (only) optional parameters
3183 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003184 cricket::AudioCodec codec =
3185 GetCodecWithPayloadType(audio_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003186 codec.name = name;
3187 codec.clockrate = clockrate;
3188 codec.bitrate = bitrate;
3189 codec.channels = channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003190 AddOrReplaceCodec<AudioContentDescription, cricket::AudioCodec>(audio_desc,
3191 codec);
3192}
3193
3194// Updates or creates a new codec entry in the video description according to
deadbeef67cf2c12016-04-13 10:07:16 -07003195// |name|, |width|, |height|, and |framerate|.
3196void UpdateCodec(int payload_type,
3197 const std::string& name,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003198 VideoContentDescription* video_desc) {
3199 // Codec may already be populated with (only) optional parameters
3200 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003201 cricket::VideoCodec codec =
3202 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003203 codec.name = name;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003204 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
3205 codec);
3206}
3207
3208bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003209 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -07003210 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003211 MediaContentDescription* media_desc,
3212 SdpParseError* error) {
3213 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003214 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003215 // RFC 4566
3216 // a=rtpmap:<payload type> <encoding name>/<clock rate>[/<encodingparameters>]
3217 const size_t expected_min_fields = 2;
3218 if (fields.size() < expected_min_fields) {
3219 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3220 }
3221 std::string payload_type_value;
3222 if (!GetValue(fields[0], kAttributeRtpmap, &payload_type_value, error)) {
3223 return false;
3224 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003225 int payload_type = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003226 if (!GetPayloadTypeFromString(line, payload_type_value, &payload_type,
3227 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003228 return false;
3229 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003230
deadbeef67cf2c12016-04-13 10:07:16 -07003231 if (std::find(payload_types.begin(), payload_types.end(), payload_type) ==
3232 payload_types.end()) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003233 RTC_LOG(LS_WARNING) << "Ignore rtpmap line that did not appear in the "
Jonas Olsson45cc8902018-02-13 10:37:07 +01003234 "<fmt> of the m-line: "
3235 << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003236 return true;
3237 }
jbauch083b73f2015-07-16 02:46:32 -07003238 const std::string& encoder = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003239 std::vector<std::string> codec_params;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00003240 rtc::split(encoder, '/', &codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003241 // <encoding name>/<clock rate>[/<encodingparameters>]
3242 // 2 mandatory fields
3243 if (codec_params.size() < 2 || codec_params.size() > 3) {
3244 return ParseFailed(line,
3245 "Expected format \"<encoding name>/<clock rate>"
3246 "[/<encodingparameters>]\".",
3247 error);
3248 }
jbauch083b73f2015-07-16 02:46:32 -07003249 const std::string& encoding_name = codec_params[0];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003250 int clock_rate = 0;
3251 if (!GetValueFromString(line, codec_params[1], &clock_rate, error)) {
3252 return false;
3253 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003254 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003255 VideoContentDescription* video_desc = media_desc->as_video();
Yves Gerey665174f2018-06-19 15:03:05 +02003256 UpdateCodec(payload_type, encoding_name, video_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003257 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3258 // RFC 4566
3259 // For audio streams, <encoding parameters> indicates the number
3260 // of audio channels. This parameter is OPTIONAL and may be
3261 // omitted if the number of channels is one, provided that no
3262 // additional parameters are needed.
Peter Kasting69558702016-01-12 16:26:35 -08003263 size_t channels = 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003264 if (codec_params.size() == 3) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003265 if (!GetValueFromString(line, codec_params[2], &channels, error)) {
3266 return false;
3267 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003268 }
Steve Antonb1c1de12017-12-21 15:14:30 -08003269 AudioContentDescription* audio_desc = media_desc->as_audio();
ossue1405ad2017-01-23 08:55:48 -08003270 UpdateCodec(payload_type, encoding_name, clock_rate, 0, channels,
deadbeef67cf2c12016-04-13 10:07:16 -07003271 audio_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003272 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003273 DataContentDescription* data_desc = media_desc->as_data();
deadbeef67cf2c12016-04-13 10:07:16 -07003274 data_desc->AddCodec(cricket::DataCodec(payload_type, encoding_name));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003275 }
3276 return true;
3277}
3278
Yves Gerey665174f2018-06-19 15:03:05 +02003279bool ParseFmtpParam(const std::string& line,
3280 std::string* parameter,
3281 std::string* value,
3282 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003283 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, parameter, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003284 ParseFailed(line, "Unable to parse fmtp parameter. \'=\' missing.", error);
3285 return false;
3286 }
3287 // a=fmtp:<payload_type> <param1>=<value1>; <param2>=<value2>; ...
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003288 return true;
3289}
3290
Yves Gerey665174f2018-06-19 15:03:05 +02003291bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003292 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003293 MediaContentDescription* media_desc,
3294 SdpParseError* error) {
3295 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3296 media_type != cricket::MEDIA_TYPE_VIDEO) {
3297 return true;
3298 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003299
3300 std::string line_payload;
3301 std::string line_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003302
3303 // RFC 5576
3304 // a=fmtp:<format> <format specific parameters>
3305 // At least two fields, whereas the second one is any of the optional
3306 // parameters.
Jonas Olssonec9e4922018-09-05 09:53:49 +02003307 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3308 kSdpDelimiterSpaceChar, &line_payload,
3309 &line_params)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003310 ParseFailedExpectMinFieldNum(line, 2, error);
3311 return false;
3312 }
3313
Donald Curtis0e07f922015-05-15 09:21:23 -07003314 // Parse out the payload information.
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003315 std::string payload_type_str;
Donald Curtis0e07f922015-05-15 09:21:23 -07003316 if (!GetValue(line_payload, kAttributeFmtp, &payload_type_str, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003317 return false;
3318 }
3319
Donald Curtis0e07f922015-05-15 09:21:23 -07003320 int payload_type = 0;
Donald Curtis144d0182015-05-15 13:14:24 -07003321 if (!GetPayloadTypeFromString(line_payload, payload_type_str, &payload_type,
3322 error)) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003323 return false;
3324 }
3325
3326 // Parse out format specific parameters.
3327 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003328 rtc::split(line_params, kSdpDelimiterSemicolonChar, &fields);
Donald Curtis0e07f922015-05-15 09:21:23 -07003329
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003330 cricket::CodecParameterMap codec_params;
Donald Curtis144d0182015-05-15 13:14:24 -07003331 for (auto& iter : fields) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003332 if (iter.find(kSdpDelimiterEqual) == std::string::npos) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003333 // Only fmtps with equals are currently supported. Other fmtp types
3334 // should be ignored. Unknown fmtps do not constitute an error.
3335 continue;
3336 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003337
3338 std::string name;
3339 std::string value;
3340 if (!ParseFmtpParam(rtc::string_trim(iter), &name, &value, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003341 return false;
3342 }
3343 codec_params[name] = value;
3344 }
3345
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003346 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3347 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003348 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003349 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
3350 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003351 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003352 }
3353 return true;
3354}
3355
Yves Gerey665174f2018-06-19 15:03:05 +02003356bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003357 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003358 MediaContentDescription* media_desc,
3359 SdpParseError* error) {
3360 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3361 media_type != cricket::MEDIA_TYPE_VIDEO) {
3362 return true;
3363 }
3364 std::vector<std::string> rtcp_fb_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003365 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &rtcp_fb_fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003366 if (rtcp_fb_fields.size() < 2) {
3367 return ParseFailedGetValue(line, kAttributeRtcpFb, error);
3368 }
3369 std::string payload_type_string;
3370 if (!GetValue(rtcp_fb_fields[0], kAttributeRtcpFb, &payload_type_string,
3371 error)) {
3372 return false;
3373 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003374 int payload_type = kWildcardPayloadType;
3375 if (payload_type_string != "*") {
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003376 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3377 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003378 return false;
3379 }
3380 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003381 std::string id = rtcp_fb_fields[1];
3382 std::string param = "";
3383 for (std::vector<std::string>::iterator iter = rtcp_fb_fields.begin() + 2;
3384 iter != rtcp_fb_fields.end(); ++iter) {
3385 param.append(*iter);
3386 }
3387 const cricket::FeedbackParam feedback_param(id, param);
3388
3389 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003390 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
3391 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003392 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003393 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
3394 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003395 }
3396 return true;
3397}
3398
3399} // namespace webrtc