blob: 40f78747cf39d24ff103896026120b59e843cb05 [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
Patrik Höglundb6b29e02018-06-21 16:58:01 +020026#include "api/mediatypes.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"
isheriff6f8d6862016-05-26 11:24:55 -070031// for RtpExtension
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020032#include "api/rtpparameters.h"
33#include "media/base/codec.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020034#include "media/base/mediaconstants.h"
35#include "media/base/rtputils.h"
36#include "media/sctp/sctptransportinternal.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020037#include "p2p/base/p2pconstants.h"
38#include "p2p/base/port.h"
39#include "pc/mediasession.h"
40#include "rtc_base/arraysize.h"
41#include "rtc_base/checks.h"
42#include "rtc_base/logging.h"
43#include "rtc_base/messagedigest.h"
Jonas Olssonec9e4922018-09-05 09:53:49 +020044#include "rtc_base/strings/string_builder.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020045#include "rtc_base/stringutils.h"
henrike@webrtc.org28e20752013-07-10 00:45:36 +000046
47using cricket::AudioContentDescription;
48using cricket::Candidate;
49using cricket::Candidates;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000050using cricket::ContentInfo;
51using cricket::CryptoParams;
52using cricket::DataContentDescription;
53using cricket::ICE_CANDIDATE_COMPONENT_RTP;
54using cricket::ICE_CANDIDATE_COMPONENT_RTCP;
55using cricket::kCodecParamMaxBitrate;
56using cricket::kCodecParamMaxPTime;
57using cricket::kCodecParamMaxQuantization;
58using cricket::kCodecParamMinBitrate;
59using cricket::kCodecParamMinPTime;
60using cricket::kCodecParamPTime;
61using cricket::kCodecParamSPropStereo;
buildbot@webrtc.orged97bb02014-05-07 11:15:20 +000062using cricket::kCodecParamStartBitrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000063using cricket::kCodecParamStereo;
64using cricket::kCodecParamUseInbandFec;
Minyue Li7100dcd2015-03-27 05:05:59 +010065using cricket::kCodecParamUseDtx;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000066using cricket::kCodecParamSctpProtocol;
67using cricket::kCodecParamSctpStreams;
henrike@webrtc.org1e09a712013-07-26 19:17:59 +000068using cricket::kCodecParamMaxAverageBitrate;
buildbot@webrtc.org5d639b32014-09-10 07:57:12 +000069using cricket::kCodecParamMaxPlaybackRate;
stefan@webrtc.org85d27942014-06-09 12:51:39 +000070using cricket::kCodecParamAssociatedPayloadType;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000071using cricket::MediaContentDescription;
72using cricket::MediaType;
isheriff6f8d6862016-05-26 11:24:55 -070073using cricket::RtpHeaderExtensions;
Steve Anton5adfafd2017-12-20 16:34:00 -080074using cricket::MediaProtocolType;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000075using cricket::SsrcGroup;
76using cricket::StreamParams;
77using cricket::StreamParamsVec;
78using cricket::TransportDescription;
79using cricket::TransportInfo;
80using cricket::VideoContentDescription;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +000081using rtc::SocketAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000082
henrike@webrtc.org28e20752013-07-10 00:45:36 +000083namespace cricket {
84class SessionDescription;
85}
86
deadbeef90f1e1e2017-02-10 12:35:05 -080087// TODO(deadbeef): Switch to using anonymous namespace rather than declaring
88// everything "static".
henrike@webrtc.org28e20752013-07-10 00:45:36 +000089namespace webrtc {
90
91// Line type
92// RFC 4566
93// An SDP session description consists of a number of lines of text of
94// the form:
95// <type>=<value>
96// where <type> MUST be exactly one case-significant character.
deadbeef9d3584c2016-02-16 17:54:10 -080097static const int kLinePrefixLength = 2; // Length of <type>=
henrike@webrtc.org28e20752013-07-10 00:45:36 +000098static const char kLineTypeVersion = 'v';
99static const char kLineTypeOrigin = 'o';
100static const char kLineTypeSessionName = 's';
101static const char kLineTypeSessionInfo = 'i';
102static const char kLineTypeSessionUri = 'u';
103static const char kLineTypeSessionEmail = 'e';
104static const char kLineTypeSessionPhone = 'p';
105static const char kLineTypeSessionBandwidth = 'b';
106static const char kLineTypeTiming = 't';
107static const char kLineTypeRepeatTimes = 'r';
108static const char kLineTypeTimeZone = 'z';
109static const char kLineTypeEncryptionKey = 'k';
110static const char kLineTypeMedia = 'm';
111static const char kLineTypeConnection = 'c';
112static const char kLineTypeAttributes = 'a';
113
114// Attributes
115static const char kAttributeGroup[] = "group";
116static const char kAttributeMid[] = "mid";
deadbeef9d3584c2016-02-16 17:54:10 -0800117static const char kAttributeMsid[] = "msid";
deadbeef25ed4352016-12-12 18:37:36 -0800118static const char kAttributeBundleOnly[] = "bundle-only";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000119static const char kAttributeRtcpMux[] = "rtcp-mux";
deadbeef13871492015-12-09 12:37:51 -0800120static const char kAttributeRtcpReducedSize[] = "rtcp-rsize";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000121static const char kAttributeSsrc[] = "ssrc";
122static const char kSsrcAttributeCname[] = "cname";
Johannes Kron0854eb62018-10-10 22:33:20 +0200123static const char kAttributeExtmapAllowMixed[] = "extmap-allow-mixed";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000124static const char kAttributeExtmap[] = "extmap";
125// draft-alvestrand-mmusic-msid-01
126// a=msid-semantic: WMS
Seth Hampson5b4f0752018-04-02 16:31:36 -0700127// This is a legacy field supported only for Plan B semantics.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000128static const char kAttributeMsidSemantics[] = "msid-semantic";
129static const char kMediaStreamSemantic[] = "WMS";
130static const char kSsrcAttributeMsid[] = "msid";
131static const char kDefaultMsid[] = "default";
Seth Hampson5b4f0752018-04-02 16:31:36 -0700132static const char kNoStreamMsid[] = "-";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000133static const char kSsrcAttributeMslabel[] = "mslabel";
134static const char kSSrcAttributeLabel[] = "label";
135static const char kAttributeSsrcGroup[] = "ssrc-group";
136static const char kAttributeCrypto[] = "crypto";
137static const char kAttributeCandidate[] = "candidate";
138static const char kAttributeCandidateTyp[] = "typ";
139static const char kAttributeCandidateRaddr[] = "raddr";
140static const char kAttributeCandidateRport[] = "rport";
honghaiza54a0802015-12-16 18:37:23 -0800141static const char kAttributeCandidateUfrag[] = "ufrag";
142static const char kAttributeCandidatePwd[] = "pwd";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000143static const char kAttributeCandidateGeneration[] = "generation";
honghaiza0c44ea2016-03-23 16:07:48 -0700144static const char kAttributeCandidateNetworkId[] = "network-id";
honghaize1a0c942016-02-16 14:54:56 -0800145static const char kAttributeCandidateNetworkCost[] = "network-cost";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000146static const char kAttributeFingerprint[] = "fingerprint";
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000147static const char kAttributeSetup[] = "setup";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000148static const char kAttributeFmtp[] = "fmtp";
149static const char kAttributeRtpmap[] = "rtpmap";
wu@webrtc.org78187522013-10-07 23:32:02 +0000150static const char kAttributeSctpmap[] = "sctpmap";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000151static const char kAttributeRtcp[] = "rtcp";
152static const char kAttributeIceUfrag[] = "ice-ufrag";
153static const char kAttributeIcePwd[] = "ice-pwd";
154static const char kAttributeIceLite[] = "ice-lite";
155static const char kAttributeIceOption[] = "ice-options";
156static const char kAttributeSendOnly[] = "sendonly";
157static const char kAttributeRecvOnly[] = "recvonly";
158static const char kAttributeRtcpFb[] = "rtcp-fb";
159static const char kAttributeSendRecv[] = "sendrecv";
160static const char kAttributeInactive[] = "inactive";
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +0000161// draft-ietf-mmusic-sctp-sdp-07
162// a=sctp-port
163static const char kAttributeSctpPort[] = "sctp-port";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000164
165// Experimental flags
166static const char kAttributeXGoogleFlag[] = "x-google-flag";
167static const char kValueConference[] = "conference";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000168
169// Candidate
170static const char kCandidateHost[] = "host";
171static const char kCandidateSrflx[] = "srflx";
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700172static const char kCandidatePrflx[] = "prflx";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000173static const char kCandidateRelay[] = "relay";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +0000174static const char kTcpCandidateType[] = "tcptype";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000175
Jonas Olssonec9e4922018-09-05 09:53:49 +0200176// rtc::StringBuilder doesn't have a << overload for chars, while rtc::split and
177// rtc::tokenize_first both take a char delimiter. To handle both cases these
178// constants come in pairs of a chars and length-one strings.
179static const char kSdpDelimiterEqual[] = "=";
180static const char kSdpDelimiterEqualChar = '=';
181static const char kSdpDelimiterSpace[] = " ";
182static const char kSdpDelimiterSpaceChar = ' ';
183static const char kSdpDelimiterColon[] = ":";
184static const char kSdpDelimiterColonChar = ':';
185static const char kSdpDelimiterSemicolon[] = ";";
186static const char kSdpDelimiterSemicolonChar = ';';
187static const char kSdpDelimiterSlashChar = '/';
188static const char kNewLine[] = "\n";
189static const char kNewLineChar = '\n';
190static const char kReturnChar = '\r';
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000191static const char kLineBreak[] = "\r\n";
192
Steve Anton36b29d12017-10-30 09:57:42 -0700193// TODO(deadbeef): Generate the Session and Time description
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000194// instead of hardcoding.
195static const char kSessionVersion[] = "v=0";
196// RFC 4566
197static const char kSessionOriginUsername[] = "-";
198static const char kSessionOriginSessionId[] = "0";
199static const char kSessionOriginSessionVersion[] = "0";
200static const char kSessionOriginNettype[] = "IN";
201static const char kSessionOriginAddrtype[] = "IP4";
202static const char kSessionOriginAddress[] = "127.0.0.1";
203static const char kSessionName[] = "s=-";
204static const char kTimeDescription[] = "t=0 0";
205static const char kAttrGroup[] = "a=group:BUNDLE";
206static const char kConnectionNettype[] = "IN";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000207static const char kConnectionIpv4Addrtype[] = "IP4";
208static const char kConnectionIpv6Addrtype[] = "IP6";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000209static const char kMediaTypeVideo[] = "video";
210static const char kMediaTypeAudio[] = "audio";
211static const char kMediaTypeData[] = "application";
212static const char kMediaPortRejected[] = "0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000213// draft-ietf-mmusic-trickle-ice-01
214// When no candidates have been gathered, set the connection
215// address to IP6 ::.
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000216// TODO(perkj): FF can not parse IP6 ::. See http://crbug/430333
217// Use IPV4 per default.
218static const char kDummyAddress[] = "0.0.0.0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000219static const char kDummyPort[] = "9";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000220// RFC 3556
221static const char kApplicationSpecificMaximum[] = "AS";
222
wu@webrtc.org78187522013-10-07 23:32:02 +0000223static const char kDefaultSctpmapProtocol[] = "webrtc-datachannel";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000224
pkasting@chromium.orgd3245462015-02-23 21:28:22 +0000225// RTP payload type is in the 0-127 range. Use -1 to indicate "all" payload
226// types.
227const int kWildcardPayloadType = -1;
228
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000229struct SsrcInfo {
Peter Boström0c4e06b2015-10-07 12:23:21 +0200230 uint32_t ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000231 std::string cname;
deadbeef9d3584c2016-02-16 17:54:10 -0800232 std::string stream_id;
233 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000234
235 // For backward compatibility.
236 // TODO(ronghuawu): Remove below 2 fields once all the clients support msid.
237 std::string label;
238 std::string mslabel;
239};
240typedef std::vector<SsrcInfo> SsrcInfoVec;
241typedef std::vector<SsrcGroup> SsrcGroupVec;
242
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000243template <class T>
244static void AddFmtpLine(const T& codec, std::string* message);
245static void BuildMediaDescription(const ContentInfo* content_info,
246 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200247 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000248 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -0800249 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000250 std::string* message);
zstein4b2e0822017-02-17 19:48:38 -0800251static void BuildSctpContentAttributes(std::string* message,
252 int sctp_port,
253 bool use_sctpmap);
deadbeef9d3584c2016-02-16 17:54:10 -0800254static void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200255 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -0800256 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -0800257 std::string* message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000258static void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200259 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000260 std::string* message);
261static void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -0800262 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000263 std::string* message);
264static void BuildIceOptions(const std::vector<std::string>& transport_options,
265 std::string* message);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +0000266static bool IsRtp(const std::string& protocol);
267static bool IsDtlsSctp(const std::string& protocol);
zhihuang38989e52017-03-21 11:04:53 -0700268static bool ParseSessionDescription(const std::string& message,
269 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000270 std::string* session_id,
271 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000272 TransportDescription* session_td,
273 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700274 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000275 cricket::SessionDescription* desc,
276 SdpParseError* error);
277static bool ParseGroupAttribute(const std::string& line,
278 cricket::SessionDescription* desc,
279 SdpParseError* error);
280static bool ParseMediaDescription(
281 const std::string& message,
282 const TransportDescription& session_td,
283 const RtpHeaderExtensions& session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700284 size_t* pos,
285 const rtc::SocketAddress& session_connection_addr,
286 cricket::SessionDescription* desc,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000287 std::vector<JsepIceCandidate*>* candidates,
288 SdpParseError* error);
289static bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200290 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000291 int mline_index,
292 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -0700293 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000294 size_t* pos,
295 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -0800296 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -0800297 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000298 MediaContentDescription* media_desc,
299 TransportDescription* transport,
300 std::vector<JsepIceCandidate*>* candidates,
301 SdpParseError* error);
302static bool ParseSsrcAttribute(const std::string& line,
303 SsrcInfoVec* ssrc_infos,
Steve Antone831b8c2018-02-01 12:22:16 -0800304 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000305 SdpParseError* error);
306static bool ParseSsrcGroupAttribute(const std::string& line,
307 SsrcGroupVec* ssrc_groups,
308 SdpParseError* error);
309static bool ParseCryptoAttribute(const std::string& line,
310 MediaContentDescription* media_desc,
311 SdpParseError* error);
312static bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200313 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -0700314 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000315 MediaContentDescription* media_desc,
316 SdpParseError* error);
317static bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200318 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000319 MediaContentDescription* media_desc,
320 SdpParseError* error);
Yves Gerey665174f2018-06-19 15:03:05 +0200321static bool ParseFmtpParam(const std::string& line,
322 std::string* parameter,
323 std::string* value,
324 SdpParseError* error);
325static bool ParseCandidate(const std::string& message,
326 Candidate* candidate,
327 SdpParseError* error,
328 bool is_raw);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000329static bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200330 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000331 MediaContentDescription* media_desc,
332 SdpParseError* error);
333static bool ParseIceOptions(const std::string& line,
334 std::vector<std::string>* transport_options,
335 SdpParseError* error);
336static bool ParseExtmap(const std::string& line,
isheriff6f8d6862016-05-26 11:24:55 -0700337 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000338 SdpParseError* error);
Steve Anton4905edb2018-10-15 19:27:44 -0700339static bool ParseFingerprintAttribute(
340 const std::string& line,
341 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
342 SdpParseError* error);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000343static bool ParseDtlsSetup(const std::string& line,
344 cricket::ConnectionRole* role,
345 SdpParseError* error);
deadbeef9d3584c2016-02-16 17:54:10 -0800346static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700347 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -0800348 std::string* track_id,
349 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000350
351// Helper functions
352
353// Below ParseFailed*** functions output the line that caused the parsing
354// failure and the detailed reason (|description|) of the failure to |error|.
355// The functions always return false so that they can be used directly in the
356// following way when error happens:
357// "return ParseFailed***(...);"
358
359// The line starting at |line_start| of |message| is the failing line.
360// The reason for the failure should be provided in the |description|.
361// An example of a description could be "unknown character".
362static bool ParseFailed(const std::string& message,
363 size_t line_start,
364 const std::string& description,
365 SdpParseError* error) {
366 // Get the first line of |message| from |line_start|.
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000367 std::string first_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000368 size_t line_end = message.find(kNewLine, line_start);
369 if (line_end != std::string::npos) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200370 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000371 --line_end;
372 }
373 first_line = message.substr(line_start, (line_end - line_start));
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000374 } else {
375 first_line = message.substr(line_start);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000376 }
377
378 if (error) {
379 error->line = first_line;
380 error->description = description;
381 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100382 RTC_LOG(LS_ERROR) << "Failed to parse: \"" << first_line
383 << "\". Reason: " << description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000384 return false;
385}
386
387// |line| is the failing line. The reason for the failure should be
388// provided in the |description|.
389static bool ParseFailed(const std::string& line,
390 const std::string& description,
391 SdpParseError* error) {
392 return ParseFailed(line, 0, description, error);
393}
394
395// Parses failure where the failing SDP line isn't know or there are multiple
396// failing lines.
Yves Gerey665174f2018-06-19 15:03:05 +0200397static bool ParseFailed(const std::string& description, SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000398 return ParseFailed("", description, error);
399}
400
401// |line| is the failing line. The failure is due to the fact that |line|
402// doesn't have |expected_fields| fields.
403static bool ParseFailedExpectFieldNum(const std::string& line,
404 int expected_fields,
405 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200406 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000407 description << "Expects " << expected_fields << " fields.";
408 return ParseFailed(line, description.str(), error);
409}
410
411// |line| is the failing line. The failure is due to the fact that |line| has
412// less than |expected_min_fields| fields.
413static bool ParseFailedExpectMinFieldNum(const std::string& line,
414 int expected_min_fields,
415 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200416 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000417 description << "Expects at least " << expected_min_fields << " fields.";
418 return ParseFailed(line, description.str(), error);
419}
420
421// |line| is the failing line. The failure is due to the fact that it failed to
422// get the value of |attribute|.
423static bool ParseFailedGetValue(const std::string& line,
424 const std::string& attribute,
425 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200426 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000427 description << "Failed to get the value of attribute: " << attribute;
428 return ParseFailed(line, description.str(), error);
429}
430
431// The line starting at |line_start| of |message| is the failing line. The
432// failure is due to the line type (e.g. the "m" part of the "m-line")
433// not matching what is expected. The expected line type should be
434// provided as |line_type|.
435static bool ParseFailedExpectLine(const std::string& message,
436 size_t line_start,
437 const char line_type,
438 const std::string& line_value,
439 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200440 rtc::StringBuilder description;
441 description << "Expect line: " << std::string(1, line_type) << "="
442 << line_value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000443 return ParseFailed(message, line_start, description.str(), error);
444}
445
446static bool AddLine(const std::string& line, std::string* message) {
447 if (!message)
448 return false;
449
450 message->append(line);
451 message->append(kLineBreak);
452 return true;
453}
454
455static bool GetLine(const std::string& message,
456 size_t* pos,
457 std::string* line) {
458 size_t line_begin = *pos;
459 size_t line_end = message.find(kNewLine, line_begin);
460 if (line_end == std::string::npos) {
461 return false;
462 }
463 // Update the new start position
464 *pos = line_end + 1;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200465 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000466 --line_end;
467 }
468 *line = message.substr(line_begin, (line_end - line_begin));
469 const char* cline = line->c_str();
470 // RFC 4566
471 // An SDP session description consists of a number of lines of text of
472 // the form:
473 // <type>=<value>
474 // where <type> MUST be exactly one case-significant character and
475 // <value> is structured text whose format depends on <type>.
476 // Whitespace MUST NOT be used on either side of the "=" sign.
Taylor Brandstetter93a7b242018-04-16 10:45:24 -0700477 //
478 // However, an exception to the whitespace rule is made for "s=", since
479 // RFC4566 also says:
480 //
481 // If a session has no meaningful name, the value "s= " SHOULD be used
482 // (i.e., a single space as the session name).
483 if (line->length() < 3 || !islower(cline[0]) ||
Jonas Olssonec9e4922018-09-05 09:53:49 +0200484 cline[1] != kSdpDelimiterEqualChar ||
485 (cline[0] != kLineTypeSessionName &&
486 cline[2] == kSdpDelimiterSpaceChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000487 *pos = line_begin;
488 return false;
489 }
490 return true;
491}
492
493// Init |os| to "|type|=|value|".
494static void InitLine(const char type,
495 const std::string& value,
Jonas Olssonec9e4922018-09-05 09:53:49 +0200496 rtc::StringBuilder* os) {
497 os->Clear();
498 *os << std::string(1, type) << kSdpDelimiterEqual << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000499}
500
501// Init |os| to "a=|attribute|".
Jonas Olssonec9e4922018-09-05 09:53:49 +0200502static void InitAttrLine(const std::string& attribute, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000503 InitLine(kLineTypeAttributes, attribute, os);
504}
505
506// Writes a SDP attribute line based on |attribute| and |value| to |message|.
Yves Gerey665174f2018-06-19 15:03:05 +0200507static void AddAttributeLine(const std::string& attribute,
508 int value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000509 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200510 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000511 InitAttrLine(attribute, &os);
512 os << kSdpDelimiterColon << value;
513 AddLine(os.str(), message);
514}
515
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000516static bool IsLineType(const std::string& message,
517 const char type,
518 size_t line_start) {
519 if (message.size() < line_start + kLinePrefixLength) {
520 return false;
521 }
522 const char* cmessage = message.c_str();
523 return (cmessage[line_start] == type &&
Jonas Olssonec9e4922018-09-05 09:53:49 +0200524 cmessage[line_start + 1] == kSdpDelimiterEqualChar);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000525}
526
Yves Gerey665174f2018-06-19 15:03:05 +0200527static bool IsLineType(const std::string& line, const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000528 return IsLineType(line, type, 0);
529}
530
Yves Gerey665174f2018-06-19 15:03:05 +0200531static bool GetLineWithType(const std::string& message,
532 size_t* pos,
533 std::string* line,
534 const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000535 if (!IsLineType(message, type, *pos)) {
536 return false;
537 }
538
539 if (!GetLine(message, pos, line))
540 return false;
541
542 return true;
543}
544
545static bool HasAttribute(const std::string& line,
546 const std::string& attribute) {
Johannes Kron211856b2018-09-06 12:12:28 +0200547 if (line.compare(kLinePrefixLength, attribute.size(), attribute) == 0) {
548 // Make sure that the match is not only a partial match. If length of
549 // strings doesn't match, the next character of the line must be ':' or ' '.
550 // This function is also used for media descriptions (e.g., "m=audio 9..."),
551 // hence the need to also allow space in the end.
552 RTC_CHECK_LE(kLinePrefixLength + attribute.size(), line.size());
553 if ((kLinePrefixLength + attribute.size()) == line.size() ||
554 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterColonChar ||
555 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterSpaceChar) {
556 return true;
557 }
558 }
559 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000560}
561
Peter Boström0c4e06b2015-10-07 12:23:21 +0200562static bool AddSsrcLine(uint32_t ssrc_id,
563 const std::string& attribute,
564 const std::string& value,
565 std::string* message) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000566 // RFC 5576
567 // a=ssrc:<ssrc-id> <attribute>:<value>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200568 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000569 InitAttrLine(kAttributeSsrc, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200570 os << kSdpDelimiterColon << ssrc_id << kSdpDelimiterSpace << attribute
571 << kSdpDelimiterColon << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000572 return AddLine(os.str(), message);
573}
574
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000575// Get value only from <attribute>:<value>.
Yves Gerey665174f2018-06-19 15:03:05 +0200576static bool GetValue(const std::string& message,
577 const std::string& attribute,
578 std::string* value,
579 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000580 std::string leftpart;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200581 if (!rtc::tokenize_first(message, kSdpDelimiterColonChar, &leftpart, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000582 return ParseFailedGetValue(message, attribute, error);
583 }
584 // The left part should end with the expected attribute.
585 if (leftpart.length() < attribute.length() ||
586 leftpart.compare(leftpart.length() - attribute.length(),
587 attribute.length(), attribute) != 0) {
588 return ParseFailedGetValue(message, attribute, error);
589 }
590 return true;
591}
592
593static bool CaseInsensitiveFind(std::string str1, std::string str2) {
Yves Gerey665174f2018-06-19 15:03:05 +0200594 std::transform(str1.begin(), str1.end(), str1.begin(), ::tolower);
595 std::transform(str2.begin(), str2.end(), str2.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000596 return str1.find(str2) != std::string::npos;
597}
598
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000599template <class T>
600static bool GetValueFromString(const std::string& line,
601 const std::string& s,
602 T* t,
603 SdpParseError* error) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000604 if (!rtc::FromString(s, t)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200605 rtc::StringBuilder description;
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000606 description << "Invalid value: " << s << ".";
607 return ParseFailed(line, description.str(), error);
608 }
609 return true;
610}
611
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000612static bool GetPayloadTypeFromString(const std::string& line,
613 const std::string& s,
614 int* payload_type,
615 SdpParseError* error) {
616 return GetValueFromString(line, s, payload_type, error) &&
Yves Gerey665174f2018-06-19 15:03:05 +0200617 cricket::IsValidRtpPayloadType(*payload_type);
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000618}
619
Seth Hampson5897a6e2018-04-03 11:16:33 -0700620// Creates a StreamParams track in the case when no SSRC lines are signaled.
621// This is a track that does not contain SSRCs and only contains
622// stream_ids/track_id if it's signaled with a=msid lines.
623void CreateTrackWithNoSsrcs(const std::vector<std::string>& msid_stream_ids,
624 const std::string& msid_track_id,
625 StreamParamsVec* tracks) {
626 StreamParams track;
627 if (msid_track_id.empty() || msid_stream_ids.empty()) {
628 // We only create an unsignaled track if a=msid lines were signaled.
629 return;
630 }
631 track.set_stream_ids(msid_stream_ids);
632 track.id = msid_track_id;
633 tracks->push_back(track);
634}
635
636// Creates the StreamParams tracks, for the case when SSRC lines are signaled.
637// |msid_stream_ids| and |msid_track_id| represent the stream/track ID from the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800638// "a=msid" attribute, if it exists. They are empty if the attribute does not
Seth Hampson5897a6e2018-04-03 11:16:33 -0700639// exist. We prioritize getting stream_ids/track_ids signaled in a=msid lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000640void CreateTracksFromSsrcInfos(const SsrcInfoVec& ssrc_infos,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700641 const std::vector<std::string>& msid_stream_ids,
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800642 const std::string& msid_track_id,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700643 StreamParamsVec* tracks,
644 int msid_signaling) {
nisseede5da42017-01-12 05:15:36 -0800645 RTC_DCHECK(tracks != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700646 for (const SsrcInfo& ssrc_info : ssrc_infos) {
647 if (ssrc_info.cname.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000648 continue;
649 }
650
Seth Hampson5b4f0752018-04-02 16:31:36 -0700651 std::vector<std::string> stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000652 std::string track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700653 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
654 // This is the case with Unified Plan SDP msid signaling.
655 stream_ids = msid_stream_ids;
Tomas Gunnarsson191bf5c2018-03-30 10:44:43 +0000656 track_id = msid_track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700657 } else if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
658 // This is the case with Plan B SDP msid signaling.
Steve Anton4daf66e2018-09-07 14:55:53 -0700659 stream_ids.push_back(ssrc_info.stream_id);
660 track_id = ssrc_info.track_id;
661 } else if (!ssrc_info.mslabel.empty()) {
Seth Hampson5b4f0752018-04-02 16:31:36 -0700662 // Since there's no a=msid or a=ssrc msid signaling, this is a sdp from
663 // an older version of client that doesn't support msid.
664 // In that case, we use the mslabel and label to construct the track.
Steve Anton4daf66e2018-09-07 14:55:53 -0700665 stream_ids.push_back(ssrc_info.mslabel);
666 track_id = ssrc_info.label;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700667 } else {
668 // Since no media streams isn't supported with older SDP signaling, we
669 // use a default a stream id.
670 stream_ids.push_back(kDefaultMsid);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000671 }
Seth Hampson5b4f0752018-04-02 16:31:36 -0700672 // If a track ID wasn't populated from the SSRC attributes OR the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800673 // msid attribute, use default/random values.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800674 if (track_id.empty()) {
675 // TODO(ronghuawu): What should we do if the track id doesn't appear?
676 // Create random string (which will be used as track label later)?
677 track_id = rtc::CreateRandomString(8);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000678 }
679
Steve Anton4daf66e2018-09-07 14:55:53 -0700680 auto track_it = std::find_if(
681 tracks->begin(), tracks->end(),
682 [track_id](const StreamParams& track) { return track.id == track_id; });
683 if (track_it == tracks->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000684 // If we don't find an existing track, create a new one.
685 tracks->push_back(StreamParams());
Steve Anton4daf66e2018-09-07 14:55:53 -0700686 track_it = tracks->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000687 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700688 StreamParams& track = *track_it;
689 track.add_ssrc(ssrc_info.ssrc_id);
690 track.cname = ssrc_info.cname;
691 track.set_stream_ids(stream_ids);
692 track.id = track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000693 }
694}
695
Seth Hampson845e8782018-03-02 11:34:10 -0800696void GetMediaStreamIds(const ContentInfo* content,
697 std::set<std::string>* labels) {
Steve Antonb1c1de12017-12-21 15:14:30 -0800698 for (const StreamParams& stream_params :
699 content->media_description()->streams()) {
Seth Hampson845e8782018-03-02 11:34:10 -0800700 for (const std::string& stream_id : stream_params.stream_ids()) {
701 labels->insert(stream_id);
Steve Anton5a26a3a2018-02-28 11:38:47 -0800702 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000703 }
704}
705
706// RFC 5245
707// It is RECOMMENDED that default candidates be chosen based on the
708// likelihood of those candidates to work with the peer that is being
709// contacted. It is RECOMMENDED that relayed > reflexive > host.
710static const int kPreferenceUnknown = 0;
711static const int kPreferenceHost = 1;
712static const int kPreferenceReflexive = 2;
713static const int kPreferenceRelayed = 3;
714
715static int GetCandidatePreferenceFromType(const std::string& type) {
716 int preference = kPreferenceUnknown;
717 if (type == cricket::LOCAL_PORT_TYPE) {
718 preference = kPreferenceHost;
719 } else if (type == cricket::STUN_PORT_TYPE) {
720 preference = kPreferenceReflexive;
721 } else if (type == cricket::RELAY_PORT_TYPE) {
722 preference = kPreferenceRelayed;
723 } else {
nissec80e7412017-01-11 05:56:46 -0800724 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000725 }
726 return preference;
727}
728
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000729// Get ip and port of the default destination from the |candidates| with the
730// given value of |component_id|. The default candidate should be the one most
731// likely to work, typically IPv4 relay.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000732// RFC 5245
733// The value of |component_id| currently supported are 1 (RTP) and 2 (RTCP).
Steve Anton36b29d12017-10-30 09:57:42 -0700734// TODO(deadbeef): Decide the default destination in webrtcsession and
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000735// pass it down via SessionDescription.
Yves Gerey665174f2018-06-19 15:03:05 +0200736static void GetDefaultDestination(const std::vector<Candidate>& candidates,
737 int component_id,
738 std::string* port,
739 std::string* ip,
740 std::string* addr_type) {
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000741 *addr_type = kConnectionIpv4Addrtype;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000742 *port = kDummyPort;
743 *ip = kDummyAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000744 int current_preference = kPreferenceUnknown;
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000745 int current_family = AF_UNSPEC;
Steve Anton4daf66e2018-09-07 14:55:53 -0700746 for (const Candidate& candidate : candidates) {
747 if (candidate.component() != component_id) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000748 continue;
749 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000750 // Default destination should be UDP only.
Steve Anton4daf66e2018-09-07 14:55:53 -0700751 if (candidate.protocol() != cricket::UDP_PROTOCOL_NAME) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000752 continue;
753 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700754 const int preference = GetCandidatePreferenceFromType(candidate.type());
755 const int family = candidate.address().ipaddr().family();
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000756 // See if this candidate is more preferable then the current one if it's the
757 // same family. Or if the current family is IPv4 already so we could safely
758 // ignore all IPv6 ones. WebRTC bug 4269.
759 // http://code.google.com/p/webrtc/issues/detail?id=4269
760 if ((preference <= current_preference && current_family == family) ||
761 (current_family == AF_INET && family == AF_INET6)) {
762 continue;
763 }
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000764 if (family == AF_INET) {
765 addr_type->assign(kConnectionIpv4Addrtype);
766 } else if (family == AF_INET6) {
767 addr_type->assign(kConnectionIpv6Addrtype);
768 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000769 current_preference = preference;
770 current_family = family;
Steve Anton4daf66e2018-09-07 14:55:53 -0700771 *port = candidate.address().PortAsString();
772 *ip = candidate.address().ipaddr().ToString();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000773 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000774}
775
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000776// Gets "a=rtcp" line if found default RTCP candidate from |candidates|.
777static std::string GetRtcpLine(const std::vector<Candidate>& candidates) {
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000778 std::string rtcp_line, rtcp_port, rtcp_ip, addr_type;
Yves Gerey665174f2018-06-19 15:03:05 +0200779 GetDefaultDestination(candidates, ICE_CANDIDATE_COMPONENT_RTCP, &rtcp_port,
780 &rtcp_ip, &addr_type);
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000781 // Found default RTCP candidate.
782 // RFC 5245
783 // If the agent is utilizing RTCP, it MUST encode the RTCP candidate
784 // using the a=rtcp attribute as defined in RFC 3605.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000785
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000786 // RFC 3605
787 // rtcp-attribute = "a=rtcp:" port [nettype space addrtype space
788 // connection-address] CRLF
Jonas Olssonec9e4922018-09-05 09:53:49 +0200789 rtc::StringBuilder os;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000790 InitAttrLine(kAttributeRtcp, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200791 os << kSdpDelimiterColon << rtcp_port << " " << kConnectionNettype << " "
792 << addr_type << " " << rtcp_ip;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000793 rtcp_line = os.str();
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000794 return rtcp_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000795}
796
797// Get candidates according to the mline index from SessionDescriptionInterface.
798static void GetCandidatesByMindex(const SessionDescriptionInterface& desci,
799 int mline_index,
800 std::vector<Candidate>* candidates) {
801 if (!candidates) {
802 return;
803 }
804 const IceCandidateCollection* cc = desci.candidates(mline_index);
805 for (size_t i = 0; i < cc->count(); ++i) {
806 const IceCandidateInterface* candidate = cc->at(i);
807 candidates->push_back(candidate->candidate());
808 }
809}
810
deadbeef90f1e1e2017-02-10 12:35:05 -0800811static bool IsValidPort(int port) {
812 return port >= 0 && port <= 65535;
813}
814
Steve Antone831b8c2018-02-01 12:22:16 -0800815std::string SdpSerialize(const JsepSessionDescription& jdesc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000816 const cricket::SessionDescription* desc = jdesc.description();
817 if (!desc) {
818 return "";
819 }
820
821 std::string message;
822
823 // Session Description.
824 AddLine(kSessionVersion, &message);
825 // Session Origin
826 // RFC 4566
827 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
828 // <unicast-address>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200829 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000830 InitLine(kLineTypeOrigin, kSessionOriginUsername, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200831 const std::string& session_id =
832 jdesc.session_id().empty() ? kSessionOriginSessionId : jdesc.session_id();
833 const std::string& session_version = jdesc.session_version().empty()
834 ? kSessionOriginSessionVersion
835 : jdesc.session_version();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000836 os << " " << session_id << " " << session_version << " "
837 << kSessionOriginNettype << " " << kSessionOriginAddrtype << " "
838 << kSessionOriginAddress;
839 AddLine(os.str(), &message);
840 AddLine(kSessionName, &message);
841
842 // Time Description.
843 AddLine(kTimeDescription, &message);
844
845 // Group
846 if (desc->HasGroup(cricket::GROUP_TYPE_BUNDLE)) {
847 std::string group_line = kAttrGroup;
848 const cricket::ContentGroup* group =
849 desc->GetGroupByName(cricket::GROUP_TYPE_BUNDLE);
nisseede5da42017-01-12 05:15:36 -0800850 RTC_DCHECK(group != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700851 for (const std::string& content_name : group->content_names()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000852 group_line.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -0700853 group_line.append(content_name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000854 }
855 AddLine(group_line, &message);
856 }
857
Johannes Kron0854eb62018-10-10 22:33:20 +0200858 // Mixed one- and two-byte header extension.
Johannes Kron9581bc42018-10-23 10:17:39 +0200859 if (desc->extmap_allow_mixed()) {
Johannes Kron0854eb62018-10-10 22:33:20 +0200860 InitAttrLine(kAttributeExtmapAllowMixed, &os);
861 AddLine(os.str(), &message);
862 }
863
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000864 // MediaStream semantics
865 InitAttrLine(kAttributeMsidSemantics, &os);
866 os << kSdpDelimiterColon << " " << kMediaStreamSemantic;
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000867
Seth Hampson845e8782018-03-02 11:34:10 -0800868 std::set<std::string> media_stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000869 const ContentInfo* audio_content = GetFirstAudioContent(desc);
870 if (audio_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800871 GetMediaStreamIds(audio_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000872
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000873 const ContentInfo* video_content = GetFirstVideoContent(desc);
874 if (video_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800875 GetMediaStreamIds(video_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000876
Steve Anton4daf66e2018-09-07 14:55:53 -0700877 for (const std::string& id : media_stream_ids) {
878 os << " " << id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000879 }
880 AddLine(os.str(), &message);
881
Taylor Brandstetter2f65ec52018-05-24 11:37:28 -0700882 // a=ice-lite
883 //
884 // TODO(deadbeef): It's weird that we need to iterate TransportInfos for
885 // this, when it's a session-level attribute. It really should be moved to a
886 // session-level structure like SessionDescription.
887 for (const cricket::TransportInfo& transport : desc->transport_infos()) {
888 if (transport.description.ice_mode == cricket::ICEMODE_LITE) {
889 InitAttrLine(kAttributeIceLite, &os);
890 AddLine(os.str(), &message);
891 break;
892 }
893 }
894
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000895 // Preserve the order of the media contents.
896 int mline_index = -1;
Steve Anton4daf66e2018-09-07 14:55:53 -0700897 for (const ContentInfo& content : desc->contents()) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000898 std::vector<Candidate> candidates;
899 GetCandidatesByMindex(jdesc, ++mline_index, &candidates);
Steve Anton4daf66e2018-09-07 14:55:53 -0700900 BuildMediaDescription(&content, desc->GetTransportInfoByName(content.name),
901 content.media_description()->type(), candidates,
902 desc->msid_signaling(), &message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000903 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000904 return message;
905}
906
907// Serializes the passed in IceCandidateInterface to a SDP string.
908// candidate - The candidate to be serialized.
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700909std::string SdpSerializeCandidate(const IceCandidateInterface& candidate) {
910 return SdpSerializeCandidate(candidate.candidate());
911}
912
913// Serializes a cricket Candidate.
914std::string SdpSerializeCandidate(const cricket::Candidate& candidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000915 std::string message;
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700916 std::vector<cricket::Candidate> candidates(1, candidate);
honghaiza54a0802015-12-16 18:37:23 -0800917 BuildCandidate(candidates, true, &message);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000918 // From WebRTC draft section 4.8.1.1 candidate-attribute will be
919 // just candidate:<candidate> not a=candidate:<blah>CRLF
nisseede5da42017-01-12 05:15:36 -0800920 RTC_DCHECK(message.find("a=") == 0);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000921 message.erase(0, 2);
nisseede5da42017-01-12 05:15:36 -0800922 RTC_DCHECK(message.find(kLineBreak) == message.size() - 2);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000923 message.resize(message.size() - 2);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000924 return message;
925}
926
927bool SdpDeserialize(const std::string& message,
928 JsepSessionDescription* jdesc,
929 SdpParseError* error) {
930 std::string session_id;
931 std::string session_version;
Peter Thatcher7cbd1882015-09-17 18:54:52 -0700932 TransportDescription session_td("", "");
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000933 RtpHeaderExtensions session_extmaps;
zhihuang38989e52017-03-21 11:04:53 -0700934 rtc::SocketAddress session_connection_addr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000935 cricket::SessionDescription* desc = new cricket::SessionDescription();
936 std::vector<JsepIceCandidate*> candidates;
937 size_t current_pos = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000938
939 // Session Description
940 if (!ParseSessionDescription(message, &current_pos, &session_id,
deadbeefc80741f2015-10-22 13:14:45 -0700941 &session_version, &session_td, &session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700942 &session_connection_addr, desc, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000943 delete desc;
944 return false;
945 }
946
947 // Media Description
deadbeefc80741f2015-10-22 13:14:45 -0700948 if (!ParseMediaDescription(message, session_td, session_extmaps, &current_pos,
zhihuang38989e52017-03-21 11:04:53 -0700949 session_connection_addr, desc, &candidates,
950 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000951 delete desc;
Steve Anton4daf66e2018-09-07 14:55:53 -0700952 for (JsepIceCandidate* candidate : candidates) {
953 delete candidate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000954 }
955 return false;
956 }
957
958 jdesc->Initialize(desc, session_id, session_version);
959
Steve Anton4daf66e2018-09-07 14:55:53 -0700960 for (JsepIceCandidate* candidate : candidates) {
961 jdesc->AddCandidate(candidate);
962 delete candidate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000963 }
964 return true;
965}
966
967bool SdpDeserializeCandidate(const std::string& message,
968 JsepIceCandidate* jcandidate,
969 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -0800970 RTC_DCHECK(jcandidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000971 Candidate candidate;
972 if (!ParseCandidate(message, &candidate, error, true)) {
973 return false;
974 }
975 jcandidate->SetCandidate(candidate);
976 return true;
977}
978
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700979bool SdpDeserializeCandidate(const std::string& transport_name,
980 const std::string& message,
981 cricket::Candidate* candidate,
982 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -0800983 RTC_DCHECK(candidate != nullptr);
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700984 if (!ParseCandidate(message, candidate, error, true)) {
985 return false;
986 }
987 candidate->set_transport_name(transport_name);
988 return true;
989}
990
Yves Gerey665174f2018-06-19 15:03:05 +0200991bool ParseCandidate(const std::string& message,
992 Candidate* candidate,
993 SdpParseError* error,
994 bool is_raw) {
nisseede5da42017-01-12 05:15:36 -0800995 RTC_DCHECK(candidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000996
997 // Get the first line from |message|.
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +0000998 std::string first_line = message;
999 size_t pos = 0;
1000 GetLine(message, &pos, &first_line);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001001
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001002 // Makes sure |message| contains only one line.
1003 if (message.size() > first_line.size()) {
1004 std::string left, right;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001005 if (rtc::tokenize_first(message, kNewLineChar, &left, &right) &&
Donald Curtis0e07f922015-05-15 09:21:23 -07001006 !right.empty()) {
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001007 return ParseFailed(message, 0, "Expect one line only", error);
1008 }
1009 }
1010
1011 // From WebRTC draft section 4.8.1.1 candidate-attribute should be
1012 // candidate:<candidate> when trickled, but we still support
1013 // a=candidate:<blah>CRLF for backward compatibility and for parsing a line
1014 // from the SDP.
1015 if (IsLineType(first_line, kLineTypeAttributes)) {
1016 first_line = first_line.substr(kLinePrefixLength);
1017 }
1018
1019 std::string attribute_candidate;
1020 std::string candidate_value;
1021
1022 // |first_line| must be in the form of "candidate:<value>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001023 if (!rtc::tokenize_first(first_line, kSdpDelimiterColonChar,
1024 &attribute_candidate, &candidate_value) ||
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001025 attribute_candidate != kAttributeCandidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001026 if (is_raw) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001027 rtc::StringBuilder description;
Yves Gerey665174f2018-06-19 15:03:05 +02001028 description << "Expect line: " << kAttributeCandidate << ":"
1029 << "<candidate-str>";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001030 return ParseFailed(first_line, 0, description.str(), error);
1031 } else {
1032 return ParseFailedExpectLine(first_line, 0, kLineTypeAttributes,
1033 kAttributeCandidate, error);
1034 }
1035 }
1036
1037 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001038 rtc::split(candidate_value, kSdpDelimiterSpaceChar, &fields);
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001039
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001040 // RFC 5245
1041 // a=candidate:<foundation> <component-id> <transport> <priority>
1042 // <connection-address> <port> typ <candidate-types>
1043 // [raddr <connection-address>] [rport <port>]
1044 // *(SP extension-att-name SP extension-att-value)
1045 const size_t expected_min_fields = 8;
1046 if (fields.size() < expected_min_fields ||
1047 (fields[6] != kAttributeCandidateTyp)) {
1048 return ParseFailedExpectMinFieldNum(first_line, expected_min_fields, error);
1049 }
jbauch083b73f2015-07-16 02:46:32 -07001050 const std::string& foundation = fields[0];
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001051
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001052 int component_id = 0;
1053 if (!GetValueFromString(first_line, fields[1], &component_id, error)) {
1054 return false;
1055 }
jbauch083b73f2015-07-16 02:46:32 -07001056 const std::string& transport = fields[2];
Peter Boström0c4e06b2015-10-07 12:23:21 +02001057 uint32_t priority = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001058 if (!GetValueFromString(first_line, fields[3], &priority, error)) {
1059 return false;
1060 }
jbauch083b73f2015-07-16 02:46:32 -07001061 const std::string& connection_address = fields[4];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001062 int port = 0;
1063 if (!GetValueFromString(first_line, fields[5], &port, error)) {
1064 return false;
1065 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001066 if (!IsValidPort(port)) {
1067 return ParseFailed(first_line, "Invalid port number.", error);
1068 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001069 SocketAddress address(connection_address, port);
1070
1071 cricket::ProtocolType protocol;
hnslb68cc752016-12-13 10:33:41 -08001072 if (!StringToProto(transport.c_str(), &protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001073 return ParseFailed(first_line, "Unsupported transport type.", error);
1074 }
hnslb68cc752016-12-13 10:33:41 -08001075 switch (protocol) {
1076 case cricket::PROTO_UDP:
1077 case cricket::PROTO_TCP:
1078 case cricket::PROTO_SSLTCP:
1079 // Supported protocol.
1080 break;
1081 default:
1082 return ParseFailed(first_line, "Unsupported transport type.", error);
1083 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001084
1085 std::string candidate_type;
jbauch083b73f2015-07-16 02:46:32 -07001086 const std::string& type = fields[7];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001087 if (type == kCandidateHost) {
1088 candidate_type = cricket::LOCAL_PORT_TYPE;
1089 } else if (type == kCandidateSrflx) {
1090 candidate_type = cricket::STUN_PORT_TYPE;
1091 } else if (type == kCandidateRelay) {
1092 candidate_type = cricket::RELAY_PORT_TYPE;
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001093 } else if (type == kCandidatePrflx) {
1094 candidate_type = cricket::PRFLX_PORT_TYPE;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001095 } else {
1096 return ParseFailed(first_line, "Unsupported candidate type.", error);
1097 }
1098
1099 size_t current_position = expected_min_fields;
1100 SocketAddress related_address;
1101 // The 2 optional fields for related address
1102 // [raddr <connection-address>] [rport <port>]
1103 if (fields.size() >= (current_position + 2) &&
1104 fields[current_position] == kAttributeCandidateRaddr) {
1105 related_address.SetIP(fields[++current_position]);
1106 ++current_position;
1107 }
1108 if (fields.size() >= (current_position + 2) &&
1109 fields[current_position] == kAttributeCandidateRport) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001110 int port = 0;
Yves Gerey665174f2018-06-19 15:03:05 +02001111 if (!GetValueFromString(first_line, fields[++current_position], &port,
1112 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001113 return false;
1114 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001115 if (!IsValidPort(port)) {
1116 return ParseFailed(first_line, "Invalid port number.", error);
1117 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001118 related_address.SetPort(port);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001119 ++current_position;
1120 }
1121
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001122 // If this is a TCP candidate, it has additional extension as defined in
1123 // RFC 6544.
1124 std::string tcptype;
1125 if (fields.size() >= (current_position + 2) &&
1126 fields[current_position] == kTcpCandidateType) {
1127 tcptype = fields[++current_position];
1128 ++current_position;
1129
1130 if (tcptype != cricket::TCPTYPE_ACTIVE_STR &&
1131 tcptype != cricket::TCPTYPE_PASSIVE_STR &&
1132 tcptype != cricket::TCPTYPE_SIMOPEN_STR) {
1133 return ParseFailed(first_line, "Invalid TCP candidate type.", error);
1134 }
1135
1136 if (protocol != cricket::PROTO_TCP) {
1137 return ParseFailed(first_line, "Invalid non-TCP candidate", error);
1138 }
1139 }
1140
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001141 // Extension
honghaiza54a0802015-12-16 18:37:23 -08001142 // Though non-standard, we support the ICE ufrag and pwd being signaled on
1143 // the candidate to avoid issues with confusing which generation a candidate
1144 // belongs to when trickling multiple generations at the same time.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001145 std::string username;
1146 std::string password;
Peter Boström0c4e06b2015-10-07 12:23:21 +02001147 uint32_t generation = 0;
honghaiza0c44ea2016-03-23 16:07:48 -07001148 uint16_t network_id = 0;
1149 uint16_t network_cost = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001150 for (size_t i = current_position; i + 1 < fields.size(); ++i) {
1151 // RFC 5245
1152 // *(SP extension-att-name SP extension-att-value)
1153 if (fields[i] == kAttributeCandidateGeneration) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001154 if (!GetValueFromString(first_line, fields[++i], &generation, error)) {
1155 return false;
1156 }
honghaiza54a0802015-12-16 18:37:23 -08001157 } else if (fields[i] == kAttributeCandidateUfrag) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001158 username = fields[++i];
honghaiza54a0802015-12-16 18:37:23 -08001159 } else if (fields[i] == kAttributeCandidatePwd) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001160 password = fields[++i];
honghaiza0c44ea2016-03-23 16:07:48 -07001161 } else if (fields[i] == kAttributeCandidateNetworkId) {
1162 if (!GetValueFromString(first_line, fields[++i], &network_id, error)) {
1163 return false;
1164 }
honghaize1a0c942016-02-16 14:54:56 -08001165 } else if (fields[i] == kAttributeCandidateNetworkCost) {
1166 if (!GetValueFromString(first_line, fields[++i], &network_cost, error)) {
1167 return false;
1168 }
Honghai Zhang351d77b2016-05-20 15:08:29 -07001169 network_cost = std::min(network_cost, rtc::kNetworkCostMax);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001170 } else {
1171 // Skip the unknown extension.
1172 ++i;
1173 }
1174 }
1175
guoweis@webrtc.org61c12472015-01-15 06:53:07 +00001176 *candidate = Candidate(component_id, cricket::ProtoToString(protocol),
guoweis@webrtc.org950c5182014-12-16 23:01:31 +00001177 address, priority, username, password, candidate_type,
honghaiza0c44ea2016-03-23 16:07:48 -07001178 generation, foundation, network_id, network_cost);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001179 candidate->set_related_address(related_address);
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001180 candidate->set_tcptype(tcptype);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001181 return true;
1182}
1183
1184bool ParseIceOptions(const std::string& line,
1185 std::vector<std::string>* transport_options,
1186 SdpParseError* error) {
1187 std::string ice_options;
1188 if (!GetValue(line, kAttributeIceOption, &ice_options, error)) {
1189 return false;
1190 }
1191 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001192 rtc::split(ice_options, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001193 for (size_t i = 0; i < fields.size(); ++i) {
1194 transport_options->push_back(fields[i]);
1195 }
1196 return true;
1197}
1198
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001199bool ParseSctpPort(const std::string& line,
1200 int* sctp_port,
1201 SdpParseError* error) {
1202 // draft-ietf-mmusic-sctp-sdp-07
1203 // a=sctp-port
1204 std::vector<std::string> fields;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001205 const size_t expected_min_fields = 2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001206 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
lally69f57602015-10-08 10:15:04 -07001207 if (fields.size() < expected_min_fields) {
1208 fields.resize(0);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001209 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
lally69f57602015-10-08 10:15:04 -07001210 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001211 if (fields.size() < expected_min_fields) {
1212 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1213 }
1214 if (!rtc::FromString(fields[1], sctp_port)) {
lally69f57602015-10-08 10:15:04 -07001215 return ParseFailed(line, "Invalid sctp port value.", error);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001216 }
1217 return true;
1218}
1219
isheriff6f8d6862016-05-26 11:24:55 -07001220bool ParseExtmap(const std::string& line,
1221 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001222 SdpParseError* error) {
1223 // RFC 5285
1224 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1225 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001226 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001227 const size_t expected_min_fields = 2;
1228 if (fields.size() < expected_min_fields) {
1229 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1230 }
1231 std::string uri = fields[1];
1232
1233 std::string value_direction;
1234 if (!GetValue(fields[0], kAttributeExtmap, &value_direction, error)) {
1235 return false;
1236 }
1237 std::vector<std::string> sub_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001238 rtc::split(value_direction, kSdpDelimiterSlashChar, &sub_fields);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001239 int value = 0;
1240 if (!GetValueFromString(line, sub_fields[0], &value, error)) {
1241 return false;
1242 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001243
jbauch5869f502017-06-29 12:31:36 -07001244 bool encrypted = false;
1245 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1246 // RFC 6904
Steve Anton36b29d12017-10-30 09:57:42 -07001247 // a=extmap:<value["/"<direction>] urn:ietf:params:rtp-hdrext:encrypt <URI>
1248 // <extensionattributes>
jbauch5869f502017-06-29 12:31:36 -07001249 const size_t expected_min_fields_encrypted = expected_min_fields + 1;
1250 if (fields.size() < expected_min_fields_encrypted) {
1251 return ParseFailedExpectMinFieldNum(line, expected_min_fields_encrypted,
Yves Gerey665174f2018-06-19 15:03:05 +02001252 error);
jbauch5869f502017-06-29 12:31:36 -07001253 }
1254
1255 encrypted = true;
1256 uri = fields[2];
1257 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1258 return ParseFailed(line, "Recursive encrypted header.", error);
1259 }
1260 }
1261
1262 *extmap = RtpExtension(uri, value, encrypted);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001263 return true;
1264}
1265
1266void BuildMediaDescription(const ContentInfo* content_info,
1267 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001268 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001269 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -08001270 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001271 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001272 RTC_DCHECK(message != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001273 if (content_info == NULL || message == NULL) {
1274 return;
1275 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001276 rtc::StringBuilder os;
Steve Antonb1c1de12017-12-21 15:14:30 -08001277 const MediaContentDescription* media_desc = content_info->media_description();
1278 RTC_DCHECK(media_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001279
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001280 int sctp_port = cricket::kSctpDefaultPort;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001281
1282 // RFC 4566
1283 // m=<media> <port> <proto> <fmt>
1284 // fmt is a list of payload type numbers that MAY be used in the session.
1285 const char* type = NULL;
1286 if (media_type == cricket::MEDIA_TYPE_AUDIO)
1287 type = kMediaTypeAudio;
1288 else if (media_type == cricket::MEDIA_TYPE_VIDEO)
1289 type = kMediaTypeVideo;
1290 else if (media_type == cricket::MEDIA_TYPE_DATA)
1291 type = kMediaTypeData;
1292 else
nissec80e7412017-01-11 05:56:46 -08001293 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001294
1295 std::string fmt;
1296 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001297 const VideoContentDescription* video_desc = media_desc->as_video();
Steve Anton4daf66e2018-09-07 14:55:53 -07001298 for (const cricket::VideoCodec& codec : video_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001299 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001300 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001301 }
1302 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001303 const AudioContentDescription* audio_desc = media_desc->as_audio();
Steve Anton4daf66e2018-09-07 14:55:53 -07001304 for (const cricket::AudioCodec& codec : audio_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001305 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001306 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001307 }
1308 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001309 const DataContentDescription* data_desc = media_desc->as_data();
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001310 if (IsDtlsSctp(media_desc->protocol())) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001311 fmt.append(" ");
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001312
zstein4b2e0822017-02-17 19:48:38 -08001313 if (data_desc->use_sctpmap()) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001314 for (const cricket::DataCodec& codec : data_desc->codecs()) {
1315 if (cricket::CodecNamesEq(codec.name,
zstein4b2e0822017-02-17 19:48:38 -08001316 cricket::kGoogleSctpDataCodecName) &&
Steve Anton4daf66e2018-09-07 14:55:53 -07001317 codec.GetParam(cricket::kCodecParamPort, &sctp_port)) {
zstein4b2e0822017-02-17 19:48:38 -08001318 break;
1319 }
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001320 }
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001321
Jonas Olsson6b1985d2018-07-05 11:59:48 +02001322 fmt.append(rtc::ToString(sctp_port));
zstein4b2e0822017-02-17 19:48:38 -08001323 } else {
1324 fmt.append(kDefaultSctpmapProtocol);
1325 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001326 } else {
Steve Anton4daf66e2018-09-07 14:55:53 -07001327 for (const cricket::DataCodec& codec : data_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001328 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001329 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001330 }
1331 }
1332 }
1333 // The fmt must never be empty. If no codecs are found, set the fmt attribute
1334 // to 0.
1335 if (fmt.empty()) {
1336 fmt = " 0";
1337 }
1338
deadbeef25ed4352016-12-12 18:37:36 -08001339 // The port number in the m line will be updated later when associated with
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001340 // the candidates.
deadbeef25ed4352016-12-12 18:37:36 -08001341 //
1342 // A port value of 0 indicates that the m= section is rejected.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001343 // RFC 3264
1344 // To reject an offered stream, the port number in the corresponding stream in
1345 // the answer MUST be set to zero.
deadbeef25ed4352016-12-12 18:37:36 -08001346 //
1347 // However, the BUNDLE draft adds a new meaning to port zero, when used along
1348 // with a=bundle-only.
zhihuang38989e52017-03-21 11:04:53 -07001349 std::string port = kDummyPort;
1350 if (content_info->rejected || content_info->bundle_only) {
1351 port = kMediaPortRejected;
1352 } else if (!media_desc->connection_address().IsNil()) {
1353 port = rtc::ToString(media_desc->connection_address().port());
1354 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001355
Yves Gerey665174f2018-06-19 15:03:05 +02001356 rtc::SSLFingerprint* fp =
1357 (transport_info) ? transport_info->description.identity_fingerprint.get()
1358 : NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001359
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001360 // Add the m and c lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001361 InitLine(kLineTypeMedia, type, &os);
1362 os << " " << port << " " << media_desc->protocol() << fmt;
zhihuang38989e52017-03-21 11:04:53 -07001363 AddLine(os.str(), message);
1364
1365 InitLine(kLineTypeConnection, kConnectionNettype, &os);
1366 if (media_desc->connection_address().IsNil()) {
1367 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
1368 } else if (media_desc->connection_address().family() == AF_INET) {
1369 os << " " << kConnectionIpv4Addrtype << " "
1370 << media_desc->connection_address().ipaddr().ToString();
1371 } else {
1372 os << " " << kConnectionIpv6Addrtype << " "
1373 << media_desc->connection_address().ipaddr().ToString();
1374 }
1375 AddLine(os.str(), message);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001376
1377 // RFC 4566
1378 // b=AS:<bandwidth>
Peter Thatcherc0c3a862015-06-24 15:31:25 -07001379 if (media_desc->bandwidth() >= 1000) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001380 InitLine(kLineTypeSessionBandwidth, kApplicationSpecificMaximum, &os);
1381 os << kSdpDelimiterColon << (media_desc->bandwidth() / 1000);
1382 AddLine(os.str(), message);
1383 }
1384
deadbeef25ed4352016-12-12 18:37:36 -08001385 // Add the a=bundle-only line.
1386 if (content_info->bundle_only) {
1387 InitAttrLine(kAttributeBundleOnly, &os);
1388 AddLine(os.str(), message);
1389 }
1390
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001391 // Add the a=rtcp line.
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001392 if (IsRtp(media_desc->protocol())) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001393 std::string rtcp_line = GetRtcpLine(candidates);
1394 if (!rtcp_line.empty()) {
1395 AddLine(rtcp_line, message);
1396 }
1397 }
1398
honghaiza54a0802015-12-16 18:37:23 -08001399 // Build the a=candidate lines. We don't include ufrag and pwd in the
1400 // candidates in the SDP to avoid redundancy.
1401 BuildCandidate(candidates, false, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001402
1403 // Use the transport_info to build the media level ice-ufrag and ice-pwd.
1404 if (transport_info) {
1405 // RFC 5245
1406 // ice-pwd-att = "ice-pwd" ":" password
1407 // ice-ufrag-att = "ice-ufrag" ":" ufrag
1408 // ice-ufrag
deadbeef3f7219b2015-12-28 15:17:14 -08001409 if (!transport_info->description.ice_ufrag.empty()) {
1410 InitAttrLine(kAttributeIceUfrag, &os);
1411 os << kSdpDelimiterColon << transport_info->description.ice_ufrag;
1412 AddLine(os.str(), message);
1413 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001414 // ice-pwd
deadbeef3f7219b2015-12-28 15:17:14 -08001415 if (!transport_info->description.ice_pwd.empty()) {
1416 InitAttrLine(kAttributeIcePwd, &os);
1417 os << kSdpDelimiterColon << transport_info->description.ice_pwd;
1418 AddLine(os.str(), message);
1419 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001420
1421 // draft-petithuguenin-mmusic-ice-attributes-level-03
1422 BuildIceOptions(transport_info->description.transport_options, message);
1423
1424 // RFC 4572
1425 // fingerprint-attribute =
1426 // "fingerprint" ":" hash-func SP fingerprint
1427 if (fp) {
1428 // Insert the fingerprint attribute.
1429 InitAttrLine(kAttributeFingerprint, &os);
Yves Gerey665174f2018-06-19 15:03:05 +02001430 os << kSdpDelimiterColon << fp->algorithm << kSdpDelimiterSpace
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001431 << fp->GetRfc4572Fingerprint();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001432 AddLine(os.str(), message);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001433
1434 // Inserting setup attribute.
1435 if (transport_info->description.connection_role !=
Yves Gerey665174f2018-06-19 15:03:05 +02001436 cricket::CONNECTIONROLE_NONE) {
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001437 // Making sure we are not using "passive" mode.
1438 cricket::ConnectionRole role =
1439 transport_info->description.connection_role;
mallinath@webrtc.org19f27e62013-10-13 17:18:27 +00001440 std::string dtls_role_str;
nissec16fa5e2017-02-07 07:18:43 -08001441 const bool success =
1442 cricket::ConnectionRoleToString(role, &dtls_role_str);
1443 RTC_DCHECK(success);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001444 InitAttrLine(kAttributeSetup, &os);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001445 os << kSdpDelimiterColon << dtls_role_str;
1446 AddLine(os.str(), message);
1447 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001448 }
1449 }
1450
1451 // RFC 3388
1452 // mid-attribute = "a=mid:" identification-tag
1453 // identification-tag = token
1454 // Use the content name as the mid identification-tag.
1455 InitAttrLine(kAttributeMid, &os);
1456 os << kSdpDelimiterColon << content_info->name;
1457 AddLine(os.str(), message);
1458
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001459 if (IsDtlsSctp(media_desc->protocol())) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001460 const DataContentDescription* data_desc = media_desc->as_data();
zstein4b2e0822017-02-17 19:48:38 -08001461 bool use_sctpmap = data_desc->use_sctpmap();
1462 BuildSctpContentAttributes(message, sctp_port, use_sctpmap);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001463 } else if (IsRtp(media_desc->protocol())) {
Steve Antone831b8c2018-02-01 12:22:16 -08001464 BuildRtpContentAttributes(media_desc, media_type, msid_signaling, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001465 }
1466}
1467
zstein4b2e0822017-02-17 19:48:38 -08001468void BuildSctpContentAttributes(std::string* message,
1469 int sctp_port,
1470 bool use_sctpmap) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001471 rtc::StringBuilder os;
zstein4b2e0822017-02-17 19:48:38 -08001472 if (use_sctpmap) {
1473 // draft-ietf-mmusic-sctp-sdp-04
1474 // a=sctpmap:sctpmap-number protocol [streams]
1475 InitAttrLine(kAttributeSctpmap, &os);
1476 os << kSdpDelimiterColon << sctp_port << kSdpDelimiterSpace
1477 << kDefaultSctpmapProtocol << kSdpDelimiterSpace
1478 << cricket::kMaxSctpStreams;
1479 } else {
1480 // draft-ietf-mmusic-sctp-sdp-23
1481 // a=sctp-port:<port>
1482 InitAttrLine(kAttributeSctpPort, &os);
1483 os << kSdpDelimiterColon << sctp_port;
1484 // TODO(zstein): emit max-message-size here
1485 }
wu@webrtc.org78187522013-10-07 23:32:02 +00001486 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001487}
1488
deadbeef9d3584c2016-02-16 17:54:10 -08001489void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001490 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -08001491 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -08001492 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001493 rtc::StringBuilder os;
Johannes Kron0854eb62018-10-10 22:33:20 +02001494 // RFC 8285
1495 // a=extmap-allow-mixed
1496 // The attribute MUST be either on session level or media level. We support
1497 // responding on both levels, however, we don't respond on media level if it's
1498 // set on session level.
Johannes Kron9581bc42018-10-23 10:17:39 +02001499 if (media_desc->extmap_allow_mixed_enum() ==
Johannes Kron0854eb62018-10-10 22:33:20 +02001500 MediaContentDescription::kMedia) {
1501 InitAttrLine(kAttributeExtmapAllowMixed, &os);
1502 AddLine(os.str(), message);
1503 }
1504 // RFC 8285
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001505 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1506 // The definitions MUST be either all session level or all media level. This
1507 // implementation uses all media level.
1508 for (size_t i = 0; i < media_desc->rtp_header_extensions().size(); ++i) {
jbauch5869f502017-06-29 12:31:36 -07001509 const RtpExtension& extension = media_desc->rtp_header_extensions()[i];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001510 InitAttrLine(kAttributeExtmap, &os);
jbauch5869f502017-06-29 12:31:36 -07001511 os << kSdpDelimiterColon << extension.id;
1512 if (extension.encrypt) {
1513 os << kSdpDelimiterSpace << RtpExtension::kEncryptHeaderExtensionsUri;
1514 }
1515 os << kSdpDelimiterSpace << extension.uri;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001516 AddLine(os.str(), message);
1517 }
1518
1519 // RFC 3264
1520 // a=sendrecv || a=sendonly || a=sendrecv || a=inactive
deadbeefc80741f2015-10-22 13:14:45 -07001521 switch (media_desc->direction()) {
Steve Anton4e70a722017-11-28 14:57:10 -08001522 case RtpTransceiverDirection::kInactive:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001523 InitAttrLine(kAttributeInactive, &os);
1524 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001525 case RtpTransceiverDirection::kSendOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001526 InitAttrLine(kAttributeSendOnly, &os);
1527 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001528 case RtpTransceiverDirection::kRecvOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001529 InitAttrLine(kAttributeRecvOnly, &os);
1530 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001531 case RtpTransceiverDirection::kSendRecv:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001532 default:
1533 InitAttrLine(kAttributeSendRecv, &os);
1534 break;
1535 }
1536 AddLine(os.str(), message);
1537
Seth Hampson5b4f0752018-04-02 16:31:36 -07001538 // Specified in https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
1539 // a=msid:<msid-id> <msid-appdata>
1540 // The msid-id is a 1*64 token char representing the media stream id, and the
1541 // msid-appdata is a 1*64 token char representing the track id. There is a
1542 // line for every media stream, with a special msid-id value of "-"
1543 // representing no streams. The value of "msid-appdata" MUST be identical for
1544 // all lines.
Steve Antone831b8c2018-02-01 12:22:16 -08001545 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
1546 const StreamParamsVec& streams = media_desc->streams();
1547 if (streams.size() == 1u) {
1548 const StreamParams& track = streams[0];
Seth Hampson5b4f0752018-04-02 16:31:36 -07001549 std::vector<std::string> stream_ids = track.stream_ids();
1550 if (stream_ids.empty()) {
1551 stream_ids.push_back(kNoStreamMsid);
1552 }
1553 for (const std::string& stream_id : stream_ids) {
1554 InitAttrLine(kAttributeMsid, &os);
1555 os << kSdpDelimiterColon << stream_id << kSdpDelimiterSpace << track.id;
1556 AddLine(os.str(), message);
1557 }
Steve Antone831b8c2018-02-01 12:22:16 -08001558 } else if (streams.size() > 1u) {
1559 RTC_LOG(LS_WARNING)
1560 << "Trying to serialize Unified Plan SDP with more than "
Jonas Olsson45cc8902018-02-13 10:37:07 +01001561 "one track in a media section. Omitting 'a=msid'.";
deadbeef9d3584c2016-02-16 17:54:10 -08001562 }
1563 }
1564
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001565 // RFC 5761
1566 // a=rtcp-mux
1567 if (media_desc->rtcp_mux()) {
1568 InitAttrLine(kAttributeRtcpMux, &os);
1569 AddLine(os.str(), message);
1570 }
1571
deadbeef13871492015-12-09 12:37:51 -08001572 // RFC 5506
1573 // a=rtcp-rsize
1574 if (media_desc->rtcp_reduced_size()) {
1575 InitAttrLine(kAttributeRtcpReducedSize, &os);
1576 AddLine(os.str(), message);
1577 }
1578
deadbeefd45aea82017-09-16 01:24:29 -07001579 if (media_desc->conference_mode()) {
1580 InitAttrLine(kAttributeXGoogleFlag, &os);
1581 os << kSdpDelimiterColon << kValueConference;
1582 AddLine(os.str(), message);
1583 }
1584
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001585 // RFC 4568
1586 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001587 for (const CryptoParams& crypto_params : media_desc->cryptos()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001588 InitAttrLine(kAttributeCrypto, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001589 os << kSdpDelimiterColon << crypto_params.tag << " "
1590 << crypto_params.cipher_suite << " " << crypto_params.key_params;
1591 if (!crypto_params.session_params.empty()) {
1592 os << " " << crypto_params.session_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001593 }
1594 AddLine(os.str(), message);
1595 }
1596
1597 // RFC 4566
1598 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1599 // [/<encodingparameters>]
1600 BuildRtpMap(media_desc, media_type, message);
1601
Steve Anton4daf66e2018-09-07 14:55:53 -07001602 for (const StreamParams& track : media_desc->streams()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001603 // Build the ssrc-group lines.
Steve Anton4daf66e2018-09-07 14:55:53 -07001604 for (const SsrcGroup& ssrc_group : track.ssrc_groups) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001605 // RFC 5576
1606 // a=ssrc-group:<semantics> <ssrc-id> ...
Steve Anton4daf66e2018-09-07 14:55:53 -07001607 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001608 continue;
1609 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001610 InitAttrLine(kAttributeSsrcGroup, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001611 os << kSdpDelimiterColon << ssrc_group.semantics;
1612 for (uint32_t ssrc : ssrc_group.ssrcs) {
1613 os << kSdpDelimiterSpace << rtc::ToString(ssrc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001614 }
1615 AddLine(os.str(), message);
1616 }
1617 // Build the ssrc lines for each ssrc.
Steve Anton4daf66e2018-09-07 14:55:53 -07001618 for (uint32_t ssrc : track.ssrcs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001619 // RFC 5576
1620 // a=ssrc:<ssrc-id> cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07001621 AddSsrcLine(ssrc, kSsrcAttributeCname, track.cname, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001622
Steve Antone831b8c2018-02-01 12:22:16 -08001623 if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
1624 // draft-alvestrand-mmusic-msid-00
1625 // a=ssrc:<ssrc-id> msid:identifier [appdata]
1626 // The appdata consists of the "id" attribute of a MediaStreamTrack,
1627 // which corresponds to the "id" attribute of StreamParams.
Seth Hampson5b4f0752018-04-02 16:31:36 -07001628 // Since a=ssrc msid signaling is used in Plan B SDP semantics, and
1629 // multiple stream ids are not supported for Plan B, we are only adding
1630 // a line for the first media stream id here.
Seth Hampson7fa6ee62018-10-17 10:25:28 -07001631 const std::string& track_stream_id = track.first_stream_id();
1632 // We use a special msid-id value of "-" to represent no streams,
1633 // for Unified Plan compatibility. Plan B will always have a
1634 // track_stream_id.
1635 const std::string& stream_id =
1636 track_stream_id.empty() ? kNoStreamMsid : track_stream_id;
Steve Antone831b8c2018-02-01 12:22:16 -08001637 InitAttrLine(kAttributeSsrc, &os);
1638 os << kSdpDelimiterColon << ssrc << kSdpDelimiterSpace
1639 << kSsrcAttributeMsid << kSdpDelimiterColon << stream_id
Steve Anton4daf66e2018-09-07 14:55:53 -07001640 << kSdpDelimiterSpace << track.id;
Steve Antone831b8c2018-02-01 12:22:16 -08001641 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001642
Steve Antone831b8c2018-02-01 12:22:16 -08001643 // TODO(ronghuawu): Remove below code which is for backward
1644 // compatibility.
1645 // draft-alvestrand-rtcweb-mid-01
1646 // a=ssrc:<ssrc-id> mslabel:<value>
1647 // The label isn't yet defined.
1648 // a=ssrc:<ssrc-id> label:<value>
Seth Hampson5b4f0752018-04-02 16:31:36 -07001649 AddSsrcLine(ssrc, kSsrcAttributeMslabel, stream_id, message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001650 AddSsrcLine(ssrc, kSSrcAttributeLabel, track.id, message);
Steve Antone831b8c2018-02-01 12:22:16 -08001651 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001652 }
1653 }
1654}
1655
Jonas Olssonec9e4922018-09-05 09:53:49 +02001656void WriteFmtpHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001657 // fmtp header: a=fmtp:|payload_type| <parameters>
1658 // Add a=fmtp
1659 InitAttrLine(kAttributeFmtp, os);
1660 // Add :|payload_type|
1661 *os << kSdpDelimiterColon << payload_type;
1662}
1663
Jonas Olssonec9e4922018-09-05 09:53:49 +02001664void WriteRtcpFbHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001665 // rtcp-fb header: a=rtcp-fb:|payload_type|
1666 // <parameters>/<ccm <ccm_parameters>>
1667 // Add a=rtcp-fb
1668 InitAttrLine(kAttributeRtcpFb, os);
1669 // Add :
1670 *os << kSdpDelimiterColon;
1671 if (payload_type == kWildcardPayloadType) {
1672 *os << "*";
1673 } else {
1674 *os << payload_type;
1675 }
1676}
1677
1678void WriteFmtpParameter(const std::string& parameter_name,
1679 const std::string& parameter_value,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001680 rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001681 // fmtp parameters: |parameter_name|=|parameter_value|
1682 *os << parameter_name << kSdpDelimiterEqual << parameter_value;
1683}
1684
1685void WriteFmtpParameters(const cricket::CodecParameterMap& parameters,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001686 rtc::StringBuilder* os) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001687 bool first = true;
1688 for (const auto& entry : parameters) {
1689 const std::string& key = entry.first;
1690 const std::string& value = entry.second;
hta62a216e2016-04-15 11:02:14 -07001691 // Parameters are a semicolon-separated list, no spaces.
1692 // The list is separated from the header by a space.
Steve Anton4daf66e2018-09-07 14:55:53 -07001693 if (first) {
hta62a216e2016-04-15 11:02:14 -07001694 *os << kSdpDelimiterSpace;
Steve Anton4daf66e2018-09-07 14:55:53 -07001695 first = false;
hta62a216e2016-04-15 11:02:14 -07001696 } else {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001697 *os << kSdpDelimiterSemicolon;
1698 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001699 WriteFmtpParameter(key, value, os);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001700 }
1701}
1702
1703bool IsFmtpParam(const std::string& name) {
ossuaa4b0772017-01-30 07:41:18 -08001704 // RFC 4855, section 3 specifies the mapping of media format parameters to SDP
1705 // parameters. Only ptime, maxptime, channels and rate are placed outside of
1706 // the fmtp line. In WebRTC, channels and rate are already handled separately
1707 // and thus not included in the CodecParameterMap.
1708 return name != kCodecParamPTime && name != kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001709}
1710
1711// Retreives fmtp parameters from |params|, which may contain other parameters
1712// as well, and puts them in |fmtp_parameters|.
1713void GetFmtpParams(const cricket::CodecParameterMap& params,
1714 cricket::CodecParameterMap* fmtp_parameters) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001715 for (const auto& entry : params) {
1716 const std::string& key = entry.first;
1717 const std::string& value = entry.second;
1718 if (IsFmtpParam(key)) {
1719 (*fmtp_parameters)[key] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001720 }
1721 }
1722}
1723
1724template <class T>
1725void AddFmtpLine(const T& codec, std::string* message) {
1726 cricket::CodecParameterMap fmtp_parameters;
1727 GetFmtpParams(codec.params, &fmtp_parameters);
1728 if (fmtp_parameters.empty()) {
1729 // No need to add an fmtp if it will have no (optional) parameters.
1730 return;
1731 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001732 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001733 WriteFmtpHeader(codec.id, &os);
1734 WriteFmtpParameters(fmtp_parameters, &os);
1735 AddLine(os.str(), message);
1736 return;
1737}
1738
1739template <class T>
1740void AddRtcpFbLines(const T& codec, std::string* message) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001741 for (const cricket::FeedbackParam& param : codec.feedback_params.params()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001742 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001743 WriteRtcpFbHeader(codec.id, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001744 os << " " << param.id();
1745 if (!param.param().empty()) {
1746 os << " " << param.param();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001747 }
1748 AddLine(os.str(), message);
1749 }
1750}
1751
Yves Gerey665174f2018-06-19 15:03:05 +02001752bool AddSctpDataCodec(DataContentDescription* media_desc, int sctp_port) {
solenberg9fa49752016-10-08 13:02:44 -07001753 for (const auto& codec : media_desc->codecs()) {
1754 if (cricket::CodecNamesEq(codec.name, cricket::kGoogleSctpDataCodecName)) {
Yves Gerey665174f2018-06-19 15:03:05 +02001755 return ParseFailed("", "Can't have multiple sctp port attributes.", NULL);
solenberg9fa49752016-10-08 13:02:44 -07001756 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001757 }
1758 // Add the SCTP Port number as a pseudo-codec "port" parameter
solenberg9fa49752016-10-08 13:02:44 -07001759 cricket::DataCodec codec_port(cricket::kGoogleSctpDataCodecPlType,
deadbeef67cf2c12016-04-13 10:07:16 -07001760 cricket::kGoogleSctpDataCodecName);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001761 codec_port.SetParam(cricket::kCodecParamPort, sctp_port);
Mirko Bonadei675513b2017-11-09 11:09:25 +01001762 RTC_LOG(INFO) << "AddSctpDataCodec: Got SCTP Port Number " << sctp_port;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001763 media_desc->AddCodec(codec_port);
1764 return true;
1765}
1766
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001767bool GetMinValue(const std::vector<int>& values, int* value) {
1768 if (values.empty()) {
1769 return false;
1770 }
1771 std::vector<int>::const_iterator found =
1772 std::min_element(values.begin(), values.end());
1773 *value = *found;
1774 return true;
1775}
1776
1777bool GetParameter(const std::string& name,
Yves Gerey665174f2018-06-19 15:03:05 +02001778 const cricket::CodecParameterMap& params,
1779 int* value) {
1780 std::map<std::string, std::string>::const_iterator found = params.find(name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001781 if (found == params.end()) {
1782 return false;
1783 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00001784 if (!rtc::FromString(found->second, value)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001785 return false;
1786 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001787 return true;
1788}
1789
1790void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001791 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001792 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001793 RTC_DCHECK(message != NULL);
1794 RTC_DCHECK(media_desc != NULL);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001795 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001796 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001797 for (const cricket::VideoCodec& codec : media_desc->as_video()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001798 // RFC 4566
1799 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1800 // [/<encodingparameters>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001801 if (codec.id != kWildcardPayloadType) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001802 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001803 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
deadbeefe814a0d2017-02-25 18:15:09 -08001804 << cricket::kVideoCodecClockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001805 AddLine(os.str(), message);
1806 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001807 AddRtcpFbLines(codec, message);
1808 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001809 }
1810 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001811 std::vector<int> ptimes;
1812 std::vector<int> maxptimes;
1813 int max_minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001814 for (const cricket::AudioCodec& codec : media_desc->as_audio()->codecs()) {
1815 RTC_DCHECK(!codec.name.empty());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001816 // RFC 4566
1817 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1818 // [/<encodingparameters>]
1819 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001820 os << kSdpDelimiterColon << codec.id << " ";
1821 os << codec.name << "/" << codec.clockrate;
1822 if (codec.channels != 1) {
1823 os << "/" << codec.channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001824 }
1825 AddLine(os.str(), message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001826 AddRtcpFbLines(codec, message);
1827 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001828 int minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001829 if (GetParameter(kCodecParamMinPTime, codec.params, &minptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001830 max_minptime = std::max(minptime, max_minptime);
1831 }
1832 int ptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001833 if (GetParameter(kCodecParamPTime, codec.params, &ptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001834 ptimes.push_back(ptime);
1835 }
1836 int maxptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001837 if (GetParameter(kCodecParamMaxPTime, codec.params, &maxptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001838 maxptimes.push_back(maxptime);
1839 }
1840 }
1841 // Populate the maxptime attribute with the smallest maxptime of all codecs
1842 // under the same m-line.
1843 int min_maxptime = INT_MAX;
1844 if (GetMinValue(maxptimes, &min_maxptime)) {
1845 AddAttributeLine(kCodecParamMaxPTime, min_maxptime, message);
1846 }
nisseede5da42017-01-12 05:15:36 -08001847 RTC_DCHECK(min_maxptime > max_minptime);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001848 // Populate the ptime attribute with the smallest ptime or the largest
1849 // minptime, whichever is the largest, for all codecs under the same m-line.
1850 int ptime = INT_MAX;
1851 if (GetMinValue(ptimes, &ptime)) {
1852 ptime = std::min(ptime, min_maxptime);
1853 ptime = std::max(ptime, max_minptime);
1854 AddAttributeLine(kCodecParamPTime, ptime, message);
1855 }
1856 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001857 for (const cricket::DataCodec& codec : media_desc->as_data()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001858 // RFC 4566
1859 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1860 // [/<encodingparameters>]
1861 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001862 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
1863 << codec.clockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001864 AddLine(os.str(), message);
1865 }
1866 }
1867}
1868
1869void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -08001870 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001871 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001872 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001873
Steve Anton4daf66e2018-09-07 14:55:53 -07001874 for (const Candidate& candidate : candidates) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001875 // RFC 5245
1876 // a=candidate:<foundation> <component-id> <transport> <priority>
1877 // <connection-address> <port> typ <candidate-types>
1878 // [raddr <connection-address>] [rport <port>]
1879 // *(SP extension-att-name SP extension-att-value)
1880 std::string type;
1881 // Map the cricket candidate type to "host" / "srflx" / "prflx" / "relay"
Steve Anton4daf66e2018-09-07 14:55:53 -07001882 if (candidate.type() == cricket::LOCAL_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001883 type = kCandidateHost;
Steve Anton4daf66e2018-09-07 14:55:53 -07001884 } else if (candidate.type() == cricket::STUN_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001885 type = kCandidateSrflx;
Steve Anton4daf66e2018-09-07 14:55:53 -07001886 } else if (candidate.type() == cricket::RELAY_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001887 type = kCandidateRelay;
Steve Anton4daf66e2018-09-07 14:55:53 -07001888 } else if (candidate.type() == cricket::PRFLX_PORT_TYPE) {
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001889 type = kCandidatePrflx;
1890 // Peer reflexive candidate may be signaled for being removed.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001891 } else {
nissec80e7412017-01-11 05:56:46 -08001892 RTC_NOTREACHED();
Peter Thatcher019087f2015-04-28 09:06:26 -07001893 // Never write out candidates if we don't know the type.
1894 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001895 }
1896
1897 InitAttrLine(kAttributeCandidate, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001898 os << kSdpDelimiterColon << candidate.foundation() << " "
1899 << candidate.component() << " " << candidate.protocol() << " "
1900 << candidate.priority() << " "
1901 << (candidate.address().ipaddr().IsNil()
1902 ? candidate.address().hostname()
1903 : candidate.address().ipaddr().ToString())
1904 << " " << candidate.address().PortAsString() << " "
1905 << kAttributeCandidateTyp << " " << type << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001906
1907 // Related address
Steve Anton4daf66e2018-09-07 14:55:53 -07001908 if (!candidate.related_address().IsNil()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001909 os << kAttributeCandidateRaddr << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001910 << candidate.related_address().ipaddr().ToString() << " "
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001911 << kAttributeCandidateRport << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001912 << candidate.related_address().PortAsString() << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001913 }
1914
Steve Anton4daf66e2018-09-07 14:55:53 -07001915 if (candidate.protocol() == cricket::TCP_PROTOCOL_NAME) {
1916 os << kTcpCandidateType << " " << candidate.tcptype() << " ";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001917 }
1918
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001919 // Extensions
Steve Anton4daf66e2018-09-07 14:55:53 -07001920 os << kAttributeCandidateGeneration << " " << candidate.generation();
1921 if (include_ufrag && !candidate.username().empty()) {
1922 os << " " << kAttributeCandidateUfrag << " " << candidate.username();
honghaiza54a0802015-12-16 18:37:23 -08001923 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001924 if (candidate.network_id() > 0) {
1925 os << " " << kAttributeCandidateNetworkId << " "
1926 << candidate.network_id();
honghaiza0c44ea2016-03-23 16:07:48 -07001927 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001928 if (candidate.network_cost() > 0) {
1929 os << " " << kAttributeCandidateNetworkCost << " "
1930 << candidate.network_cost();
honghaize1a0c942016-02-16 14:54:56 -08001931 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001932
1933 AddLine(os.str(), message);
1934 }
1935}
1936
1937void BuildIceOptions(const std::vector<std::string>& transport_options,
1938 std::string* message) {
1939 if (!transport_options.empty()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001940 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001941 InitAttrLine(kAttributeIceOption, &os);
1942 os << kSdpDelimiterColon << transport_options[0];
1943 for (size_t i = 1; i < transport_options.size(); ++i) {
1944 os << kSdpDelimiterSpace << transport_options[i];
1945 }
1946 AddLine(os.str(), message);
1947 }
1948}
1949
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001950bool IsRtp(const std::string& protocol) {
1951 return protocol.empty() ||
Yves Gerey665174f2018-06-19 15:03:05 +02001952 (protocol.find(cricket::kMediaProtocolRtpPrefix) != std::string::npos);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001953}
1954
1955bool IsDtlsSctp(const std::string& protocol) {
1956 // This intentionally excludes "SCTP" and "SCTP/DTLS".
lally@webrtc.orga7470932015-02-24 20:19:21 +00001957 return protocol.find(cricket::kMediaProtocolDtlsSctp) != std::string::npos;
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001958}
1959
zhihuang38989e52017-03-21 11:04:53 -07001960bool ParseConnectionData(const std::string& line,
1961 rtc::SocketAddress* addr,
1962 SdpParseError* error) {
1963 // Parse the line from left to right.
1964 std::string token;
1965 std::string rightpart;
1966 // RFC 4566
1967 // c=<nettype> <addrtype> <connection-address>
1968 // Skip the "c="
Jonas Olssonec9e4922018-09-05 09:53:49 +02001969 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, &token, &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07001970 return ParseFailed(line, "Failed to parse the network type.", error);
1971 }
1972
1973 // Extract and verify the <nettype>
Jonas Olssonec9e4922018-09-05 09:53:49 +02001974 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
1975 &rightpart) ||
zhihuang38989e52017-03-21 11:04:53 -07001976 token != kConnectionNettype) {
1977 return ParseFailed(line,
1978 "Failed to parse the connection data. The network type "
1979 "is not currently supported.",
1980 error);
1981 }
1982
1983 // Extract the "<addrtype>" and "<connection-address>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001984 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
1985 &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07001986 return ParseFailed(line, "Failed to parse the address type.", error);
1987 }
1988
1989 // The rightpart part should be the IP address without the slash which is used
1990 // for multicast.
1991 if (rightpart.find('/') != std::string::npos) {
1992 return ParseFailed(line,
1993 "Failed to parse the connection data. Multicast is not "
1994 "currently supported.",
1995 error);
1996 }
1997 addr->SetIP(rightpart);
1998
1999 // Verify that the addrtype matches the type of the parsed address.
2000 if ((addr->family() == AF_INET && token != "IP4") ||
2001 (addr->family() == AF_INET6 && token != "IP6")) {
2002 addr->Clear();
2003 return ParseFailed(
2004 line,
2005 "Failed to parse the connection data. The address type is mismatching.",
2006 error);
2007 }
2008 return true;
2009}
2010
2011bool ParseSessionDescription(const std::string& message,
2012 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002013 std::string* session_id,
2014 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002015 TransportDescription* session_td,
2016 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -07002017 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002018 cricket::SessionDescription* desc,
2019 SdpParseError* error) {
2020 std::string line;
2021
deadbeefc80741f2015-10-22 13:14:45 -07002022 desc->set_msid_supported(false);
Johannes Kron9581bc42018-10-23 10:17:39 +02002023 desc->set_extmap_allow_mixed(false);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002024 // RFC 4566
2025 // v= (protocol version)
2026 if (!GetLineWithType(message, pos, &line, kLineTypeVersion)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002027 return ParseFailedExpectLine(message, *pos, kLineTypeVersion, std::string(),
2028 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002029 }
2030 // RFC 4566
2031 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
2032 // <unicast-address>
2033 if (!GetLineWithType(message, pos, &line, kLineTypeOrigin)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002034 return ParseFailedExpectLine(message, *pos, kLineTypeOrigin, std::string(),
2035 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002036 }
2037 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002038 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002039 const size_t expected_fields = 6;
2040 if (fields.size() != expected_fields) {
2041 return ParseFailedExpectFieldNum(line, expected_fields, error);
2042 }
2043 *session_id = fields[1];
2044 *session_version = fields[2];
2045
2046 // RFC 4566
2047 // s= (session name)
2048 if (!GetLineWithType(message, pos, &line, kLineTypeSessionName)) {
2049 return ParseFailedExpectLine(message, *pos, kLineTypeSessionName,
2050 std::string(), error);
2051 }
2052
Danil Chapovalov66cadcc2018-06-19 16:47:43 +02002053 // absl::optional lines
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002054 // Those are the optional lines, so shouldn't return false if not present.
2055 // RFC 4566
2056 // i=* (session information)
2057 GetLineWithType(message, pos, &line, kLineTypeSessionInfo);
2058
2059 // RFC 4566
2060 // u=* (URI of description)
2061 GetLineWithType(message, pos, &line, kLineTypeSessionUri);
2062
2063 // RFC 4566
2064 // e=* (email address)
2065 GetLineWithType(message, pos, &line, kLineTypeSessionEmail);
2066
2067 // RFC 4566
2068 // p=* (phone number)
2069 GetLineWithType(message, pos, &line, kLineTypeSessionPhone);
2070
2071 // RFC 4566
2072 // c=* (connection information -- not required if included in
2073 // all media)
zhihuang38989e52017-03-21 11:04:53 -07002074 if (GetLineWithType(message, pos, &line, kLineTypeConnection)) {
2075 if (!ParseConnectionData(line, connection_addr, error)) {
2076 return false;
2077 }
2078 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002079
2080 // RFC 4566
2081 // b=* (zero or more bandwidth information lines)
2082 while (GetLineWithType(message, pos, &line, kLineTypeSessionBandwidth)) {
2083 // By pass zero or more b lines.
2084 }
2085
2086 // RFC 4566
2087 // One or more time descriptions ("t=" and "r=" lines; see below)
2088 // t= (time the session is active)
2089 // r=* (zero or more repeat times)
2090 // Ensure there's at least one time description
2091 if (!GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2092 return ParseFailedExpectLine(message, *pos, kLineTypeTiming, std::string(),
2093 error);
2094 }
2095
2096 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2097 // By pass zero or more r lines.
2098 }
2099
2100 // Go through the rest of the time descriptions
2101 while (GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2102 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2103 // By pass zero or more r lines.
2104 }
2105 }
2106
2107 // RFC 4566
2108 // z=* (time zone adjustments)
2109 GetLineWithType(message, pos, &line, kLineTypeTimeZone);
2110
2111 // RFC 4566
2112 // k=* (encryption key)
2113 GetLineWithType(message, pos, &line, kLineTypeEncryptionKey);
2114
2115 // RFC 4566
2116 // a=* (zero or more session attribute lines)
2117 while (GetLineWithType(message, pos, &line, kLineTypeAttributes)) {
2118 if (HasAttribute(line, kAttributeGroup)) {
2119 if (!ParseGroupAttribute(line, desc, error)) {
2120 return false;
2121 }
2122 } else if (HasAttribute(line, kAttributeIceUfrag)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002123 if (!GetValue(line, kAttributeIceUfrag, &(session_td->ice_ufrag),
2124 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002125 return false;
2126 }
2127 } else if (HasAttribute(line, kAttributeIcePwd)) {
2128 if (!GetValue(line, kAttributeIcePwd, &(session_td->ice_pwd), error)) {
2129 return false;
2130 }
2131 } else if (HasAttribute(line, kAttributeIceLite)) {
2132 session_td->ice_mode = cricket::ICEMODE_LITE;
2133 } else if (HasAttribute(line, kAttributeIceOption)) {
2134 if (!ParseIceOptions(line, &(session_td->transport_options), error)) {
2135 return false;
2136 }
2137 } else if (HasAttribute(line, kAttributeFingerprint)) {
2138 if (session_td->identity_fingerprint.get()) {
2139 return ParseFailed(
2140 line,
2141 "Can't have multiple fingerprint attributes at the same level.",
2142 error);
2143 }
Steve Anton4905edb2018-10-15 19:27:44 -07002144 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002145 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2146 return false;
2147 }
Steve Anton4905edb2018-10-15 19:27:44 -07002148 session_td->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002149 } else if (HasAttribute(line, kAttributeSetup)) {
2150 if (!ParseDtlsSetup(line, &(session_td->connection_role), error)) {
2151 return false;
2152 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002153 } else if (HasAttribute(line, kAttributeMsidSemantics)) {
2154 std::string semantics;
2155 if (!GetValue(line, kAttributeMsidSemantics, &semantics, error)) {
2156 return false;
2157 }
deadbeefc80741f2015-10-22 13:14:45 -07002158 desc->set_msid_supported(
2159 CaseInsensitiveFind(semantics, kMediaStreamSemantic));
Johannes Kron0854eb62018-10-10 22:33:20 +02002160 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02002161 desc->set_extmap_allow_mixed(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002162 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002163 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002164 if (!ParseExtmap(line, &extmap, error)) {
2165 return false;
2166 }
2167 session_extmaps->push_back(extmap);
2168 }
2169 }
2170
2171 return true;
2172}
2173
2174bool ParseGroupAttribute(const std::string& line,
2175 cricket::SessionDescription* desc,
2176 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002177 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002178
2179 // RFC 5888 and draft-holmberg-mmusic-sdp-bundle-negotiation-00
2180 // a=group:BUNDLE video voice
2181 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002182 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002183 std::string semantics;
2184 if (!GetValue(fields[0], kAttributeGroup, &semantics, error)) {
2185 return false;
2186 }
2187 cricket::ContentGroup group(semantics);
2188 for (size_t i = 1; i < fields.size(); ++i) {
2189 group.AddContentName(fields[i]);
2190 }
2191 desc->AddGroup(group);
2192 return true;
2193}
2194
Steve Anton4905edb2018-10-15 19:27:44 -07002195static bool ParseFingerprintAttribute(
2196 const std::string& line,
2197 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
2198 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002199 if (!IsLineType(line, kLineTypeAttributes) ||
2200 !HasAttribute(line, kAttributeFingerprint)) {
2201 return ParseFailedExpectLine(line, 0, kLineTypeAttributes,
2202 kAttributeFingerprint, error);
2203 }
2204
2205 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002206 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002207 const size_t expected_fields = 2;
2208 if (fields.size() != expected_fields) {
2209 return ParseFailedExpectFieldNum(line, expected_fields, error);
2210 }
2211
2212 // The first field here is "fingerprint:<hash>.
2213 std::string algorithm;
2214 if (!GetValue(fields[0], kAttributeFingerprint, &algorithm, error)) {
2215 return false;
2216 }
2217
2218 // Downcase the algorithm. Note that we don't need to downcase the
2219 // fingerprint because hex_decode can handle upper-case.
2220 std::transform(algorithm.begin(), algorithm.end(), algorithm.begin(),
2221 ::tolower);
2222
2223 // The second field is the digest value. De-hexify it.
Steve Anton4905edb2018-10-15 19:27:44 -07002224 *fingerprint =
2225 rtc::SSLFingerprint::CreateUniqueFromRfc4572(algorithm, fields[1]);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002226 if (!*fingerprint) {
Yves Gerey665174f2018-06-19 15:03:05 +02002227 return ParseFailed(line, "Failed to create fingerprint from the digest.",
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002228 error);
2229 }
2230
2231 return true;
2232}
2233
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002234static bool ParseDtlsSetup(const std::string& line,
2235 cricket::ConnectionRole* role,
2236 SdpParseError* error) {
2237 // setup-attr = "a=setup:" role
2238 // role = "active" / "passive" / "actpass" / "holdconn"
2239 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002240 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002241 const size_t expected_fields = 2;
2242 if (fields.size() != expected_fields) {
2243 return ParseFailedExpectFieldNum(line, expected_fields, error);
2244 }
2245 std::string role_str = fields[1];
2246 if (!cricket::StringToConnectionRole(role_str, role)) {
2247 return ParseFailed(line, "Invalid attribute value.", error);
2248 }
2249 return true;
2250}
2251
deadbeef9d3584c2016-02-16 17:54:10 -08002252static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -07002253 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -08002254 std::string* track_id,
2255 SdpParseError* error) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002256 // https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
deadbeef9d3584c2016-02-16 17:54:10 -08002257 // a=msid:<stream id> <track id>
2258 // msid-value = msid-id [ SP msid-appdata ]
2259 // msid-id = 1*64token-char ; see RFC 4566
2260 // msid-appdata = 1*64token-char ; see RFC 4566
2261 std::string field1;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002262 std::string new_stream_id;
2263 std::string new_track_id;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002264 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
2265 kSdpDelimiterSpaceChar, &field1, &new_track_id)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002266 const size_t expected_fields = 2;
2267 return ParseFailedExpectFieldNum(line, expected_fields, error);
2268 }
2269
Seth Hampson5b4f0752018-04-02 16:31:36 -07002270 if (new_track_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002271 return ParseFailed(line, "Missing track ID in msid attribute.", error);
2272 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002273 // All track ids should be the same within an m section in a Unified Plan SDP.
2274 if (!track_id->empty() && new_track_id.compare(*track_id) != 0) {
2275 return ParseFailed(
2276 line, "Two different track IDs in msid attribute in one m= section",
2277 error);
2278 }
2279 *track_id = new_track_id;
deadbeefa4549d62017-02-10 17:26:22 -08002280
deadbeef9d3584c2016-02-16 17:54:10 -08002281 // msid:<msid-id>
Seth Hampson5b4f0752018-04-02 16:31:36 -07002282 if (!GetValue(field1, kAttributeMsid, &new_stream_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002283 return false;
2284 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002285 if (new_stream_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002286 return ParseFailed(line, "Missing stream ID in msid attribute.", error);
2287 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002288 // The special value "-" indicates "no MediaStream".
2289 if (new_stream_id.compare(kNoStreamMsid) != 0) {
2290 stream_ids->push_back(new_stream_id);
2291 }
deadbeef9d3584c2016-02-16 17:54:10 -08002292 return true;
2293}
2294
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002295// RFC 3551
2296// PT encoding media type clock rate channels
2297// name (Hz)
2298// 0 PCMU A 8,000 1
2299// 1 reserved A
2300// 2 reserved A
2301// 3 GSM A 8,000 1
2302// 4 G723 A 8,000 1
2303// 5 DVI4 A 8,000 1
2304// 6 DVI4 A 16,000 1
2305// 7 LPC A 8,000 1
2306// 8 PCMA A 8,000 1
2307// 9 G722 A 8,000 1
2308// 10 L16 A 44,100 2
2309// 11 L16 A 44,100 1
2310// 12 QCELP A 8,000 1
2311// 13 CN A 8,000 1
2312// 14 MPA A 90,000 (see text)
2313// 15 G728 A 8,000 1
2314// 16 DVI4 A 11,025 1
2315// 17 DVI4 A 22,050 1
2316// 18 G729 A 8,000 1
2317struct StaticPayloadAudioCodec {
2318 const char* name;
2319 int clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002320 size_t channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002321};
2322static const StaticPayloadAudioCodec kStaticPayloadAudioCodecs[] = {
Yves Gerey665174f2018-06-19 15:03:05 +02002323 {"PCMU", 8000, 1}, {"reserved", 0, 0}, {"reserved", 0, 0},
2324 {"GSM", 8000, 1}, {"G723", 8000, 1}, {"DVI4", 8000, 1},
2325 {"DVI4", 16000, 1}, {"LPC", 8000, 1}, {"PCMA", 8000, 1},
2326 {"G722", 8000, 1}, {"L16", 44100, 2}, {"L16", 44100, 1},
2327 {"QCELP", 8000, 1}, {"CN", 8000, 1}, {"MPA", 90000, 1},
2328 {"G728", 8000, 1}, {"DVI4", 11025, 1}, {"DVI4", 22050, 1},
2329 {"G729", 8000, 1},
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002330};
2331
Yves Gerey665174f2018-06-19 15:03:05 +02002332void MaybeCreateStaticPayloadAudioCodecs(const std::vector<int>& fmts,
2333 AudioContentDescription* media_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002334 if (!media_desc) {
2335 return;
2336 }
deadbeef67cf2c12016-04-13 10:07:16 -07002337 RTC_DCHECK(media_desc->codecs().empty());
solenberg9fa49752016-10-08 13:02:44 -07002338 for (int payload_type : fmts) {
Yves Gerey665174f2018-06-19 15:03:05 +02002339 if (!media_desc->HasCodec(payload_type) && payload_type >= 0 &&
kjellander3e33bfe2016-06-20 07:04:09 -07002340 static_cast<uint32_t>(payload_type) <
2341 arraysize(kStaticPayloadAudioCodecs)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002342 std::string encoding_name = kStaticPayloadAudioCodecs[payload_type].name;
2343 int clock_rate = kStaticPayloadAudioCodecs[payload_type].clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002344 size_t channels = kStaticPayloadAudioCodecs[payload_type].channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002345 media_desc->AddCodec(cricket::AudioCodec(payload_type, encoding_name,
deadbeef67cf2c12016-04-13 10:07:16 -07002346 clock_rate, 0, channels));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002347 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002348 }
2349}
2350
2351template <class C>
2352static C* ParseContentDescription(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002353 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002354 int mline_index,
2355 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002356 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002357 size_t* pos,
2358 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002359 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002360 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002361 TransportDescription* transport,
2362 std::vector<JsepIceCandidate*>* candidates,
2363 webrtc::SdpParseError* error) {
2364 C* media_desc = new C();
2365 switch (media_type) {
2366 case cricket::MEDIA_TYPE_AUDIO:
2367 *content_name = cricket::CN_AUDIO;
2368 break;
2369 case cricket::MEDIA_TYPE_VIDEO:
2370 *content_name = cricket::CN_VIDEO;
2371 break;
2372 case cricket::MEDIA_TYPE_DATA:
2373 *content_name = cricket::CN_DATA;
2374 break;
2375 default:
nissec80e7412017-01-11 05:56:46 -08002376 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002377 break;
2378 }
deadbeef67cf2c12016-04-13 10:07:16 -07002379 if (!ParseContent(message, media_type, mline_index, protocol, payload_types,
Steve Antone831b8c2018-02-01 12:22:16 -08002380 pos, content_name, bundle_only, msid_signaling, media_desc,
2381 transport, candidates, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002382 delete media_desc;
zhihuang38989e52017-03-21 11:04:53 -07002383 return nullptr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002384 }
2385 // Sort the codecs according to the m-line fmt list.
deadbeef67cf2c12016-04-13 10:07:16 -07002386 std::unordered_map<int, int> payload_type_preferences;
2387 // "size + 1" so that the lowest preference payload type has a preference of
2388 // 1, which is greater than the default (0) for payload types not in the fmt
2389 // list.
2390 int preference = static_cast<int>(payload_types.size() + 1);
2391 for (int pt : payload_types) {
2392 payload_type_preferences[pt] = preference--;
2393 }
2394 std::vector<typename C::CodecType> codecs = media_desc->codecs();
Yves Gerey665174f2018-06-19 15:03:05 +02002395 std::sort(codecs.begin(), codecs.end(),
2396 [&payload_type_preferences](const typename C::CodecType& a,
2397 const typename C::CodecType& b) {
2398 return payload_type_preferences[a.id] >
2399 payload_type_preferences[b.id];
2400 });
deadbeef67cf2c12016-04-13 10:07:16 -07002401 media_desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002402 return media_desc;
2403}
2404
2405bool ParseMediaDescription(const std::string& message,
2406 const TransportDescription& session_td,
2407 const RtpHeaderExtensions& session_extmaps,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002408 size_t* pos,
zhihuang38989e52017-03-21 11:04:53 -07002409 const rtc::SocketAddress& session_connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002410 cricket::SessionDescription* desc,
2411 std::vector<JsepIceCandidate*>* candidates,
2412 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002413 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002414 std::string line;
2415 int mline_index = -1;
Steve Antone831b8c2018-02-01 12:22:16 -08002416 int msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002417
2418 // Zero or more media descriptions
2419 // RFC 4566
2420 // m=<media> <port> <proto> <fmt>
2421 while (GetLineWithType(message, pos, &line, kLineTypeMedia)) {
2422 ++mline_index;
2423
2424 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002425 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
zstein4b2e0822017-02-17 19:48:38 -08002426
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002427 const size_t expected_min_fields = 4;
2428 if (fields.size() < expected_min_fields) {
2429 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
2430 }
deadbeef25ed4352016-12-12 18:37:36 -08002431 bool port_rejected = false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002432 // RFC 3264
2433 // To reject an offered stream, the port number in the corresponding stream
2434 // in the answer MUST be set to zero.
2435 if (fields[1] == kMediaPortRejected) {
deadbeef25ed4352016-12-12 18:37:36 -08002436 port_rejected = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002437 }
2438
zhihuang38989e52017-03-21 11:04:53 -07002439 int port = 0;
2440 if (!rtc::FromString<int>(fields[1], &port) || !IsValidPort(port)) {
2441 return ParseFailed(line, "The port number is invalid", error);
2442 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002443 std::string protocol = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002444
2445 // <fmt>
deadbeef67cf2c12016-04-13 10:07:16 -07002446 std::vector<int> payload_types;
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002447 if (IsRtp(protocol)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002448 for (size_t j = 3; j < fields.size(); ++j) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002449 // TODO(wu): Remove when below bug is fixed.
2450 // https://bugzilla.mozilla.org/show_bug.cgi?id=996329
pbosbb36fdf2015-07-09 07:48:14 -07002451 if (fields[j].empty() && j == fields.size() - 1) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002452 continue;
2453 }
wu@webrtc.org36eda7c2014-04-15 20:37:30 +00002454
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002455 int pl = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00002456 if (!GetPayloadTypeFromString(line, fields[j], &pl, error)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002457 return false;
2458 }
deadbeef67cf2c12016-04-13 10:07:16 -07002459 payload_types.push_back(pl);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002460 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002461 }
2462
2463 // Make a temporary TransportDescription based on |session_td|.
2464 // Some of this gets overwritten by ParseContent.
deadbeef46eed762016-01-28 13:24:37 -08002465 TransportDescription transport(
2466 session_td.transport_options, session_td.ice_ufrag, session_td.ice_pwd,
2467 session_td.ice_mode, session_td.connection_role,
2468 session_td.identity_fingerprint.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002469
kwibergd1fe2812016-04-27 06:47:29 -07002470 std::unique_ptr<MediaContentDescription> content;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002471 std::string content_name;
deadbeef25ed4352016-12-12 18:37:36 -08002472 bool bundle_only = false;
Steve Antone831b8c2018-02-01 12:22:16 -08002473 int section_msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002474 if (HasAttribute(line, kMediaTypeVideo)) {
2475 content.reset(ParseContentDescription<VideoContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002476 message, cricket::MEDIA_TYPE_VIDEO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002477 payload_types, pos, &content_name, &bundle_only,
2478 &section_msid_signaling, &transport, candidates, error));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002479 } else if (HasAttribute(line, kMediaTypeAudio)) {
2480 content.reset(ParseContentDescription<AudioContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002481 message, cricket::MEDIA_TYPE_AUDIO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002482 payload_types, pos, &content_name, &bundle_only,
2483 &section_msid_signaling, &transport, candidates, error));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002484 } else if (HasAttribute(line, kMediaTypeData)) {
jiayl@webrtc.org0e527722014-09-08 21:43:43 +00002485 DataContentDescription* data_desc =
wu@webrtc.org78187522013-10-07 23:32:02 +00002486 ParseContentDescription<DataContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002487 message, cricket::MEDIA_TYPE_DATA, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002488 payload_types, pos, &content_name, &bundle_only,
2489 &section_msid_signaling, &transport, candidates, error);
jiayl@webrtc.org0e527722014-09-08 21:43:43 +00002490 content.reset(data_desc);
wu@webrtc.org78187522013-10-07 23:32:02 +00002491
zstein4b2e0822017-02-17 19:48:38 -08002492 if (data_desc && IsDtlsSctp(protocol)) {
2493 int p;
2494 if (rtc::FromString(fields[3], &p)) {
2495 if (!AddSctpDataCodec(data_desc, p)) {
2496 return false;
2497 }
2498 } else if (fields[3] == kDefaultSctpmapProtocol) {
2499 data_desc->set_use_sctpmap(false);
2500 }
wu@webrtc.org78187522013-10-07 23:32:02 +00002501 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002502 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002503 RTC_LOG(LS_WARNING) << "Unsupported media type: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002504 continue;
2505 }
2506 if (!content.get()) {
2507 // ParseContentDescription returns NULL if failed.
2508 return false;
2509 }
2510
Steve Antone831b8c2018-02-01 12:22:16 -08002511 msid_signaling |= section_msid_signaling;
2512
deadbeef25ed4352016-12-12 18:37:36 -08002513 bool content_rejected = false;
deadbeef12771a12017-01-03 13:53:47 -08002514 // A port of 0 is not interpreted as a rejected m= section when it's
2515 // used along with a=bundle-only.
deadbeef25ed4352016-12-12 18:37:36 -08002516 if (bundle_only) {
deadbeef25ed4352016-12-12 18:37:36 -08002517 if (!port_rejected) {
deadbeef12771a12017-01-03 13:53:47 -08002518 // Usage of bundle-only with a nonzero port is unspecified. So just
2519 // ignore bundle-only if we see this.
2520 bundle_only = false;
Mirko Bonadei675513b2017-11-09 11:09:25 +01002521 RTC_LOG(LS_WARNING)
deadbeef12771a12017-01-03 13:53:47 -08002522 << "a=bundle-only attribute observed with a nonzero "
Jonas Olsson45cc8902018-02-13 10:37:07 +01002523 "port; this usage is unspecified so the attribute is being "
2524 "ignored.";
deadbeef25ed4352016-12-12 18:37:36 -08002525 }
2526 } else {
2527 // If not using bundle-only, interpret port 0 in the normal way; the m=
2528 // section is being rejected.
2529 content_rejected = port_rejected;
2530 }
2531
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002532 if (IsRtp(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002533 // Set the extmap.
2534 if (!session_extmaps.empty() &&
2535 !content->rtp_header_extensions().empty()) {
2536 return ParseFailed("",
2537 "The a=extmap MUST be either all session level or "
2538 "all media level.",
2539 error);
2540 }
2541 for (size_t i = 0; i < session_extmaps.size(); ++i) {
2542 content->AddRtpHeaderExtension(session_extmaps[i]);
2543 }
2544 }
2545 content->set_protocol(protocol);
zhihuang38989e52017-03-21 11:04:53 -07002546
2547 // Use the session level connection address if the media level addresses are
2548 // not specified.
2549 rtc::SocketAddress address;
2550 address = content->connection_address().IsNil()
2551 ? session_connection_addr
2552 : content->connection_address();
2553 address.SetPort(port);
2554 content->set_connection_address(address);
2555
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002556 desc->AddContent(content_name,
Steve Anton5adfafd2017-12-20 16:34:00 -08002557 IsDtlsSctp(protocol) ? MediaProtocolType::kSctp
2558 : MediaProtocolType::kRtp,
deadbeef25ed4352016-12-12 18:37:36 -08002559 content_rejected, bundle_only, content.release());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002560 // Create TransportInfo with the media level "ice-pwd" and "ice-ufrag".
2561 TransportInfo transport_info(content_name, transport);
2562
2563 if (!desc->AddTransportInfo(transport_info)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002564 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002565 description << "Failed to AddTransportInfo with content name: "
2566 << content_name;
2567 return ParseFailed("", description.str(), error);
2568 }
2569 }
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002570
Steve Antone831b8c2018-02-01 12:22:16 -08002571 desc->set_msid_signaling(msid_signaling);
2572
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002573 size_t end_of_message = message.size();
2574 if (mline_index == -1 && *pos != end_of_message) {
2575 ParseFailed(message, *pos, "Expects m line.", error);
2576 return false;
2577 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002578 return true;
2579}
2580
2581bool VerifyCodec(const cricket::Codec& codec) {
2582 // Codec has not been populated correctly unless the name has been set. This
2583 // can happen if an SDP has an fmtp or rtcp-fb with a payload type but doesn't
2584 // have a corresponding "rtpmap" line.
htab39db842016-12-08 01:50:48 -08002585 return !codec.name.empty();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002586}
2587
2588bool VerifyAudioCodecs(const AudioContentDescription* audio_desc) {
2589 const std::vector<cricket::AudioCodec>& codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002590 return std::all_of(codecs.begin(), codecs.end(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002591}
2592
2593bool VerifyVideoCodecs(const VideoContentDescription* video_desc) {
2594 const std::vector<cricket::VideoCodec>& codecs = video_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002595 return std::all_of(codecs.begin(), codecs.end(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002596}
2597
2598void AddParameters(const cricket::CodecParameterMap& parameters,
2599 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002600 for (const auto& entry : parameters) {
2601 const std::string& key = entry.first;
2602 const std::string& value = entry.second;
2603 codec->SetParam(key, value);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002604 }
2605}
2606
2607void AddFeedbackParameter(const cricket::FeedbackParam& feedback_param,
2608 cricket::Codec* codec) {
2609 codec->AddFeedbackParam(feedback_param);
2610}
2611
2612void AddFeedbackParameters(const cricket::FeedbackParams& feedback_params,
2613 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002614 for (const cricket::FeedbackParam& param : feedback_params.params()) {
2615 codec->AddFeedbackParam(param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002616 }
2617}
2618
2619// Gets the current codec setting associated with |payload_type|. If there
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002620// is no Codec associated with that payload type it returns an empty codec
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002621// with that payload type.
2622template <class T>
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002623T GetCodecWithPayloadType(const std::vector<T>& codecs, int payload_type) {
magjedb05fa242016-11-11 04:00:16 -08002624 const T* codec = FindCodecById(codecs, payload_type);
2625 if (codec)
2626 return *codec;
2627 // Return empty codec with |payload_type|.
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002628 T ret_val;
magjedb05fa242016-11-11 04:00:16 -08002629 ret_val.id = payload_type;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002630 return ret_val;
2631}
2632
2633// Updates or creates a new codec entry in the audio description.
2634template <class T, class U>
2635void AddOrReplaceCodec(MediaContentDescription* content_desc, const U& codec) {
2636 T* desc = static_cast<T*>(content_desc);
2637 std::vector<U> codecs = desc->codecs();
2638 bool found = false;
Steve Anton4daf66e2018-09-07 14:55:53 -07002639 for (U& existing_codec : codecs) {
2640 if (codec.id == existing_codec.id) {
2641 // Overwrite existing codec with the new codec.
2642 existing_codec = codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002643 found = true;
2644 break;
2645 }
2646 }
2647 if (!found) {
2648 desc->AddCodec(codec);
2649 return;
2650 }
2651 desc->set_codecs(codecs);
2652}
2653
2654// Adds or updates existing codec corresponding to |payload_type| according
2655// to |parameters|.
2656template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002657void UpdateCodec(MediaContentDescription* content_desc,
2658 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002659 const cricket::CodecParameterMap& parameters) {
2660 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002661 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2662 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002663 AddParameters(parameters, &new_codec);
2664 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2665}
2666
2667// Adds or updates existing codec corresponding to |payload_type| according
2668// to |feedback_param|.
2669template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002670void UpdateCodec(MediaContentDescription* content_desc,
2671 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002672 const cricket::FeedbackParam& feedback_param) {
2673 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002674 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2675 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002676 AddFeedbackParameter(feedback_param, &new_codec);
2677 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2678}
2679
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002680template <class T>
2681bool PopWildcardCodec(std::vector<T>* codecs, T* wildcard_codec) {
2682 for (auto iter = codecs->begin(); iter != codecs->end(); ++iter) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002683 if (iter->id == kWildcardPayloadType) {
2684 *wildcard_codec = *iter;
2685 codecs->erase(iter);
2686 return true;
2687 }
2688 }
2689 return false;
2690}
2691
Yves Gerey665174f2018-06-19 15:03:05 +02002692template <class T>
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002693void UpdateFromWildcardCodecs(cricket::MediaContentDescriptionImpl<T>* desc) {
2694 auto codecs = desc->codecs();
2695 T wildcard_codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002696 if (!PopWildcardCodec(&codecs, &wildcard_codec)) {
2697 return;
2698 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002699 for (auto& codec : codecs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002700 AddFeedbackParameters(wildcard_codec.feedback_params, &codec);
2701 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002702 desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002703}
2704
Yves Gerey665174f2018-06-19 15:03:05 +02002705void AddAudioAttribute(const std::string& name,
2706 const std::string& value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002707 AudioContentDescription* audio_desc) {
2708 if (value.empty()) {
2709 return;
2710 }
2711 std::vector<cricket::AudioCodec> codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002712 for (cricket::AudioCodec& codec : codecs) {
2713 codec.params[name] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002714 }
2715 audio_desc->set_codecs(codecs);
2716}
2717
2718bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002719 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002720 int mline_index,
2721 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002722 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002723 size_t* pos,
2724 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002725 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002726 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002727 MediaContentDescription* media_desc,
2728 TransportDescription* transport,
2729 std::vector<JsepIceCandidate*>* candidates,
2730 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002731 RTC_DCHECK(media_desc != NULL);
2732 RTC_DCHECK(content_name != NULL);
2733 RTC_DCHECK(transport != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002734
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002735 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002736 MaybeCreateStaticPayloadAudioCodecs(payload_types, media_desc->as_audio());
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002737 }
2738
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002739 // The media level "ice-ufrag" and "ice-pwd".
2740 // The candidates before update the media level "ice-pwd" and "ice-ufrag".
2741 Candidates candidates_orig;
2742 std::string line;
2743 std::string mline_id;
2744 // Tracks created out of the ssrc attributes.
2745 StreamParamsVec tracks;
2746 SsrcInfoVec ssrc_infos;
2747 SsrcGroupVec ssrc_groups;
2748 std::string maxptime_as_string;
2749 std::string ptime_as_string;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002750 std::vector<std::string> stream_ids;
deadbeef9d3584c2016-02-16 17:54:10 -08002751 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002752
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002753 // Loop until the next m line
2754 while (!IsLineType(message, kLineTypeMedia, *pos)) {
2755 if (!GetLine(message, pos, &line)) {
2756 if (*pos >= message.size()) {
2757 break; // Done parsing
2758 } else {
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +00002759 return ParseFailed(message, *pos, "Invalid SDP line.", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002760 }
2761 }
2762
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002763 // RFC 4566
2764 // b=* (zero or more bandwidth information lines)
2765 if (IsLineType(line, kLineTypeSessionBandwidth)) {
2766 std::string bandwidth;
2767 if (HasAttribute(line, kApplicationSpecificMaximum)) {
2768 if (!GetValue(line, kApplicationSpecificMaximum, &bandwidth, error)) {
2769 return false;
2770 } else {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002771 int b = 0;
2772 if (!GetValueFromString(line, bandwidth, &b, error)) {
2773 return false;
2774 }
deadbeef3e8016e2017-08-03 17:49:30 -07002775 // TODO(deadbeef): Historically, applications may be setting a value
2776 // of -1 to mean "unset any previously set bandwidth limit", even
2777 // though ommitting the "b=AS" entirely will do just that. Once we've
2778 // transitioned applications to doing the right thing, it would be
2779 // better to treat this as a hard error instead of just ignoring it.
2780 if (b == -1) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002781 RTC_LOG(LS_WARNING)
2782 << "Ignoring \"b=AS:-1\"; will be treated as \"no "
2783 "bandwidth limit\".";
deadbeef3e8016e2017-08-03 17:49:30 -07002784 continue;
2785 }
deadbeefbc88c6b2017-08-02 11:26:34 -07002786 if (b < 0) {
2787 return ParseFailed(line, "b=AS value can't be negative.", error);
2788 }
Peter Thatcherc0c3a862015-06-24 15:31:25 -07002789 // We should never use more than the default bandwidth for RTP-based
2790 // data channels. Don't allow SDP to set the bandwidth, because
2791 // that would give JS the opportunity to "break the Internet".
2792 // See: https://code.google.com/p/chromium/issues/detail?id=280726
2793 if (media_type == cricket::MEDIA_TYPE_DATA && IsRtp(protocol) &&
2794 b > cricket::kDataMaxBandwidth / 1000) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002795 rtc::StringBuilder description;
Peter Thatcherc0c3a862015-06-24 15:31:25 -07002796 description << "RTP-based data channels may not send more than "
2797 << cricket::kDataMaxBandwidth / 1000 << "kbps.";
2798 return ParseFailed(line, description.str(), error);
2799 }
deadbeefb2362572016-12-13 16:37:06 -08002800 // Prevent integer overflow.
2801 b = std::min(b, INT_MAX / 1000);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002802 media_desc->set_bandwidth(b * 1000);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002803 }
2804 }
2805 continue;
2806 }
2807
zhihuang38989e52017-03-21 11:04:53 -07002808 // Parse the media level connection data.
2809 if (IsLineType(line, kLineTypeConnection)) {
2810 rtc::SocketAddress addr;
2811 if (!ParseConnectionData(line, &addr, error)) {
2812 return false;
2813 }
2814 media_desc->set_connection_address(addr);
2815 continue;
2816 }
2817
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002818 if (!IsLineType(line, kLineTypeAttributes)) {
Steve Anton36b29d12017-10-30 09:57:42 -07002819 // TODO(deadbeef): Handle other lines if needed.
Mirko Bonadei675513b2017-11-09 11:09:25 +01002820 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002821 continue;
2822 }
2823
2824 // Handle attributes common to SCTP and RTP.
2825 if (HasAttribute(line, kAttributeMid)) {
2826 // RFC 3388
2827 // mid-attribute = "a=mid:" identification-tag
2828 // identification-tag = token
2829 // Use the mid identification-tag as the content name.
2830 if (!GetValue(line, kAttributeMid, &mline_id, error)) {
2831 return false;
2832 }
2833 *content_name = mline_id;
deadbeef25ed4352016-12-12 18:37:36 -08002834 } else if (HasAttribute(line, kAttributeBundleOnly)) {
2835 *bundle_only = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002836 } else if (HasAttribute(line, kAttributeCandidate)) {
2837 Candidate candidate;
2838 if (!ParseCandidate(line, &candidate, error, false)) {
2839 return false;
2840 }
deadbeef7bcdb692017-01-20 12:43:58 -08002841 // ParseCandidate will parse non-standard ufrag and password attributes,
2842 // since it's used for candidate trickling, but we only want to process
2843 // the "a=ice-ufrag"/"a=ice-pwd" values in a session description, so
2844 // strip them off at this point.
2845 candidate.set_username(std::string());
2846 candidate.set_password(std::string());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002847 candidates_orig.push_back(candidate);
2848 } else if (HasAttribute(line, kAttributeIceUfrag)) {
2849 if (!GetValue(line, kAttributeIceUfrag, &transport->ice_ufrag, error)) {
2850 return false;
2851 }
2852 } else if (HasAttribute(line, kAttributeIcePwd)) {
2853 if (!GetValue(line, kAttributeIcePwd, &transport->ice_pwd, error)) {
2854 return false;
2855 }
2856 } else if (HasAttribute(line, kAttributeIceOption)) {
2857 if (!ParseIceOptions(line, &transport->transport_options, error)) {
2858 return false;
2859 }
2860 } else if (HasAttribute(line, kAttributeFmtp)) {
2861 if (!ParseFmtpAttributes(line, media_type, media_desc, error)) {
2862 return false;
2863 }
2864 } else if (HasAttribute(line, kAttributeFingerprint)) {
Steve Anton4905edb2018-10-15 19:27:44 -07002865 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002866 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2867 return false;
2868 }
Steve Anton4905edb2018-10-15 19:27:44 -07002869 transport->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002870 } else if (HasAttribute(line, kAttributeSetup)) {
2871 if (!ParseDtlsSetup(line, &(transport->connection_role), error)) {
2872 return false;
2873 }
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002874 } else if (IsDtlsSctp(protocol) && HasAttribute(line, kAttributeSctpPort)) {
deadbeef7e146cb2016-09-28 10:04:34 -07002875 if (media_type != cricket::MEDIA_TYPE_DATA) {
2876 return ParseFailed(
2877 line, "sctp-port attribute found in non-data media description.",
2878 error);
2879 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002880 int sctp_port;
2881 if (!ParseSctpPort(line, &sctp_port, error)) {
2882 return false;
2883 }
Steve Antonb1c1de12017-12-21 15:14:30 -08002884 if (!AddSctpDataCodec(media_desc->as_data(), sctp_port)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002885 return false;
2886 }
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002887 } else if (IsRtp(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002888 //
2889 // RTP specific attrubtes
2890 //
2891 if (HasAttribute(line, kAttributeRtcpMux)) {
2892 media_desc->set_rtcp_mux(true);
deadbeef13871492015-12-09 12:37:51 -08002893 } else if (HasAttribute(line, kAttributeRtcpReducedSize)) {
2894 media_desc->set_rtcp_reduced_size(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002895 } else if (HasAttribute(line, kAttributeSsrcGroup)) {
2896 if (!ParseSsrcGroupAttribute(line, &ssrc_groups, error)) {
2897 return false;
2898 }
2899 } else if (HasAttribute(line, kAttributeSsrc)) {
Steve Antone831b8c2018-02-01 12:22:16 -08002900 if (!ParseSsrcAttribute(line, &ssrc_infos, msid_signaling, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002901 return false;
2902 }
2903 } else if (HasAttribute(line, kAttributeCrypto)) {
2904 if (!ParseCryptoAttribute(line, media_desc, error)) {
2905 return false;
2906 }
2907 } else if (HasAttribute(line, kAttributeRtpmap)) {
deadbeef67cf2c12016-04-13 10:07:16 -07002908 if (!ParseRtpmapAttribute(line, media_type, payload_types, media_desc,
2909 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002910 return false;
2911 }
2912 } else if (HasAttribute(line, kCodecParamMaxPTime)) {
2913 if (!GetValue(line, kCodecParamMaxPTime, &maxptime_as_string, error)) {
2914 return false;
2915 }
2916 } else if (HasAttribute(line, kAttributeRtcpFb)) {
2917 if (!ParseRtcpFbAttribute(line, media_type, media_desc, error)) {
2918 return false;
2919 }
2920 } else if (HasAttribute(line, kCodecParamPTime)) {
2921 if (!GetValue(line, kCodecParamPTime, &ptime_as_string, error)) {
2922 return false;
2923 }
2924 } else if (HasAttribute(line, kAttributeSendOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002925 media_desc->set_direction(RtpTransceiverDirection::kSendOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002926 } else if (HasAttribute(line, kAttributeRecvOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002927 media_desc->set_direction(RtpTransceiverDirection::kRecvOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002928 } else if (HasAttribute(line, kAttributeInactive)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002929 media_desc->set_direction(RtpTransceiverDirection::kInactive);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002930 } else if (HasAttribute(line, kAttributeSendRecv)) {
Steve Anton4e70a722017-11-28 14:57:10 -08002931 media_desc->set_direction(RtpTransceiverDirection::kSendRecv);
Johannes Kron0854eb62018-10-10 22:33:20 +02002932 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02002933 media_desc->set_extmap_allow_mixed_enum(
Johannes Kron0854eb62018-10-10 22:33:20 +02002934 MediaContentDescription::kMedia);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002935 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002936 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002937 if (!ParseExtmap(line, &extmap, error)) {
2938 return false;
2939 }
2940 media_desc->AddRtpHeaderExtension(extmap);
2941 } else if (HasAttribute(line, kAttributeXGoogleFlag)) {
2942 // Experimental attribute. Conference mode activates more aggressive
2943 // AEC and NS settings.
Steve Anton36b29d12017-10-30 09:57:42 -07002944 // TODO(deadbeef): expose API to set these directly.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002945 std::string flag_value;
2946 if (!GetValue(line, kAttributeXGoogleFlag, &flag_value, error)) {
2947 return false;
2948 }
2949 if (flag_value.compare(kValueConference) == 0)
2950 media_desc->set_conference_mode(true);
deadbeef9d3584c2016-02-16 17:54:10 -08002951 } else if (HasAttribute(line, kAttributeMsid)) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002952 if (!ParseMsidAttribute(line, &stream_ids, &track_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002953 return false;
2954 }
Steve Antone831b8c2018-02-01 12:22:16 -08002955 *msid_signaling |= cricket::kMsidSignalingMediaSection;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002956 }
2957 } else {
2958 // Only parse lines that we are interested of.
Mirko Bonadei675513b2017-11-09 11:09:25 +01002959 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002960 continue;
2961 }
2962 }
2963
2964 // Create tracks from the |ssrc_infos|.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -08002965 // If the stream_id/track_id for all SSRCS are identical, one StreamParams
2966 // will be created in CreateTracksFromSsrcInfos, containing all the SSRCs from
2967 // the m= section.
Seth Hampson5897a6e2018-04-03 11:16:33 -07002968 if (!ssrc_infos.empty()) {
2969 CreateTracksFromSsrcInfos(ssrc_infos, stream_ids, track_id, &tracks,
2970 *msid_signaling);
2971 } else if (media_type != cricket::MEDIA_TYPE_DATA &&
2972 (*msid_signaling & cricket::kMsidSignalingMediaSection)) {
2973 // If the stream_ids/track_id was signaled but SSRCs were unsignaled we
2974 // still create a track. This isn't done for data media types because
2975 // StreamParams aren't used for SCTP streams, and RTP data channels don't
2976 // support unsignaled SSRCs.
2977 CreateTrackWithNoSsrcs(stream_ids, track_id, &tracks);
2978 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002979
2980 // Add the ssrc group to the track.
Steve Anton4daf66e2018-09-07 14:55:53 -07002981 for (const SsrcGroup& ssrc_group : ssrc_groups) {
2982 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002983 continue;
2984 }
Steve Anton4daf66e2018-09-07 14:55:53 -07002985 uint32_t ssrc = ssrc_group.ssrcs.front();
2986 for (StreamParams& track : tracks) {
2987 if (track.has_ssrc(ssrc)) {
2988 track.ssrc_groups.push_back(ssrc_group);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002989 }
2990 }
2991 }
2992
2993 // Add the new tracks to the |media_desc|.
deadbeef9d3584c2016-02-16 17:54:10 -08002994 for (StreamParams& track : tracks) {
2995 media_desc->AddStream(track);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002996 }
2997
2998 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002999 AudioContentDescription* audio_desc = media_desc->as_audio();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003000 UpdateFromWildcardCodecs(audio_desc);
3001
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003002 // Verify audio codec ensures that no audio codec has been populated with
3003 // only fmtp.
3004 if (!VerifyAudioCodecs(audio_desc)) {
3005 return ParseFailed("Failed to parse audio codecs correctly.", error);
3006 }
3007 AddAudioAttribute(kCodecParamMaxPTime, maxptime_as_string, audio_desc);
3008 AddAudioAttribute(kCodecParamPTime, ptime_as_string, audio_desc);
3009 }
3010
3011 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003012 VideoContentDescription* video_desc = media_desc->as_video();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003013 UpdateFromWildcardCodecs(video_desc);
3014 // Verify video codec ensures that no video codec has been populated with
3015 // only rtcp-fb.
3016 if (!VerifyVideoCodecs(video_desc)) {
3017 return ParseFailed("Failed to parse video codecs correctly.", error);
3018 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003019 }
3020
3021 // RFC 5245
3022 // Update the candidates with the media level "ice-pwd" and "ice-ufrag".
Steve Anton4daf66e2018-09-07 14:55:53 -07003023 for (Candidate& candidate : candidates_orig) {
3024 RTC_DCHECK(candidate.username().empty() ||
3025 candidate.username() == transport->ice_ufrag);
3026 candidate.set_username(transport->ice_ufrag);
3027 RTC_DCHECK(candidate.password().empty());
3028 candidate.set_password(transport->ice_pwd);
3029 candidates->push_back(
3030 new JsepIceCandidate(mline_id, mline_index, candidate));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003031 }
3032 return true;
3033}
3034
Steve Antone831b8c2018-02-01 12:22:16 -08003035bool ParseSsrcAttribute(const std::string& line,
3036 SsrcInfoVec* ssrc_infos,
3037 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003038 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003039 RTC_DCHECK(ssrc_infos != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003040 // RFC 5576
3041 // a=ssrc:<ssrc-id> <attribute>
3042 // a=ssrc:<ssrc-id> <attribute>:<value>
3043 std::string field1, field2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003044 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3045 kSdpDelimiterSpaceChar, &field1, &field2)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003046 const size_t expected_fields = 2;
3047 return ParseFailedExpectFieldNum(line, expected_fields, error);
3048 }
3049
3050 // ssrc:<ssrc-id>
3051 std::string ssrc_id_s;
3052 if (!GetValue(field1, kAttributeSsrc, &ssrc_id_s, error)) {
3053 return false;
3054 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003055 uint32_t ssrc_id = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003056 if (!GetValueFromString(line, ssrc_id_s, &ssrc_id, error)) {
3057 return false;
3058 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003059
3060 std::string attribute;
3061 std::string value;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003062 if (!rtc::tokenize_first(field2, kSdpDelimiterColonChar, &attribute,
3063 &value)) {
3064 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003065 description << "Failed to get the ssrc attribute value from " << field2
3066 << ". Expected format <attribute>:<value>.";
3067 return ParseFailed(line, description.str(), error);
3068 }
3069
3070 // Check if there's already an item for this |ssrc_id|. Create a new one if
3071 // there isn't.
Steve Anton4daf66e2018-09-07 14:55:53 -07003072 auto ssrc_info_it = std::find_if(ssrc_infos->begin(), ssrc_infos->end(),
3073 [ssrc_id](const SsrcInfo& ssrc_info) {
3074 return ssrc_info.ssrc_id == ssrc_id;
3075 });
3076 if (ssrc_info_it == ssrc_infos->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003077 SsrcInfo info;
3078 info.ssrc_id = ssrc_id;
3079 ssrc_infos->push_back(info);
Steve Anton4daf66e2018-09-07 14:55:53 -07003080 ssrc_info_it = ssrc_infos->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003081 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003082 SsrcInfo& ssrc_info = *ssrc_info_it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003083
3084 // Store the info to the |ssrc_info|.
3085 if (attribute == kSsrcAttributeCname) {
3086 // RFC 5576
3087 // cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003088 ssrc_info.cname = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003089 } else if (attribute == kSsrcAttributeMsid) {
3090 // draft-alvestrand-mmusic-msid-00
Seth Hampson5b4f0752018-04-02 16:31:36 -07003091 // msid:identifier [appdata]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003092 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003093 rtc::split(value, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003094 if (fields.size() < 1 || fields.size() > 2) {
Yves Gerey665174f2018-06-19 15:03:05 +02003095 return ParseFailed(
3096 line, "Expected format \"msid:<identifier>[ <appdata>]\".", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003097 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003098 ssrc_info.stream_id = fields[0];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003099 if (fields.size() == 2) {
Steve Anton4daf66e2018-09-07 14:55:53 -07003100 ssrc_info.track_id = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003101 }
Steve Antone831b8c2018-02-01 12:22:16 -08003102 *msid_signaling |= cricket::kMsidSignalingSsrcAttribute;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003103 } else if (attribute == kSsrcAttributeMslabel) {
3104 // draft-alvestrand-rtcweb-mid-01
3105 // mslabel:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003106 ssrc_info.mslabel = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003107 } else if (attribute == kSSrcAttributeLabel) {
3108 // The label isn't defined.
3109 // label:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003110 ssrc_info.label = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003111 }
3112 return true;
3113}
3114
3115bool ParseSsrcGroupAttribute(const std::string& line,
3116 SsrcGroupVec* ssrc_groups,
3117 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003118 RTC_DCHECK(ssrc_groups != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003119 // RFC 5576
3120 // a=ssrc-group:<semantics> <ssrc-id> ...
3121 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003122 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003123 const size_t expected_min_fields = 2;
3124 if (fields.size() < expected_min_fields) {
3125 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3126 }
3127 std::string semantics;
3128 if (!GetValue(fields[0], kAttributeSsrcGroup, &semantics, error)) {
3129 return false;
3130 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003131 std::vector<uint32_t> ssrcs;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003132 for (size_t i = 1; i < fields.size(); ++i) {
Peter Boström0c4e06b2015-10-07 12:23:21 +02003133 uint32_t ssrc = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003134 if (!GetValueFromString(line, fields[i], &ssrc, error)) {
3135 return false;
3136 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003137 ssrcs.push_back(ssrc);
3138 }
3139 ssrc_groups->push_back(SsrcGroup(semantics, ssrcs));
3140 return true;
3141}
3142
3143bool ParseCryptoAttribute(const std::string& line,
3144 MediaContentDescription* media_desc,
3145 SdpParseError* error) {
3146 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003147 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003148 // RFC 4568
3149 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
3150 const size_t expected_min_fields = 3;
3151 if (fields.size() < expected_min_fields) {
3152 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3153 }
3154 std::string tag_value;
3155 if (!GetValue(fields[0], kAttributeCrypto, &tag_value, error)) {
3156 return false;
3157 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003158 int tag = 0;
3159 if (!GetValueFromString(line, tag_value, &tag, error)) {
3160 return false;
3161 }
jbauch083b73f2015-07-16 02:46:32 -07003162 const std::string& crypto_suite = fields[1];
3163 const std::string& key_params = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003164 std::string session_params;
3165 if (fields.size() > 3) {
3166 session_params = fields[3];
3167 }
Yves Gerey665174f2018-06-19 15:03:05 +02003168 media_desc->AddCrypto(
3169 CryptoParams(tag, crypto_suite, key_params, session_params));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003170 return true;
3171}
3172
3173// Updates or creates a new codec entry in the audio description with according
deadbeef67cf2c12016-04-13 10:07:16 -07003174// to |name|, |clockrate|, |bitrate|, and |channels|.
3175void UpdateCodec(int payload_type,
3176 const std::string& name,
3177 int clockrate,
3178 int bitrate,
3179 size_t channels,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003180 AudioContentDescription* audio_desc) {
3181 // Codec may already be populated with (only) optional parameters
3182 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003183 cricket::AudioCodec codec =
3184 GetCodecWithPayloadType(audio_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003185 codec.name = name;
3186 codec.clockrate = clockrate;
3187 codec.bitrate = bitrate;
3188 codec.channels = channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003189 AddOrReplaceCodec<AudioContentDescription, cricket::AudioCodec>(audio_desc,
3190 codec);
3191}
3192
3193// Updates or creates a new codec entry in the video description according to
deadbeef67cf2c12016-04-13 10:07:16 -07003194// |name|, |width|, |height|, and |framerate|.
3195void UpdateCodec(int payload_type,
3196 const std::string& name,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003197 VideoContentDescription* video_desc) {
3198 // Codec may already be populated with (only) optional parameters
3199 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003200 cricket::VideoCodec codec =
3201 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003202 codec.name = name;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003203 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
3204 codec);
3205}
3206
3207bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003208 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -07003209 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003210 MediaContentDescription* media_desc,
3211 SdpParseError* error) {
3212 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003213 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003214 // RFC 4566
3215 // a=rtpmap:<payload type> <encoding name>/<clock rate>[/<encodingparameters>]
3216 const size_t expected_min_fields = 2;
3217 if (fields.size() < expected_min_fields) {
3218 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3219 }
3220 std::string payload_type_value;
3221 if (!GetValue(fields[0], kAttributeRtpmap, &payload_type_value, error)) {
3222 return false;
3223 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003224 int payload_type = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003225 if (!GetPayloadTypeFromString(line, payload_type_value, &payload_type,
3226 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003227 return false;
3228 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003229
deadbeef67cf2c12016-04-13 10:07:16 -07003230 if (std::find(payload_types.begin(), payload_types.end(), payload_type) ==
3231 payload_types.end()) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003232 RTC_LOG(LS_WARNING) << "Ignore rtpmap line that did not appear in the "
Jonas Olsson45cc8902018-02-13 10:37:07 +01003233 "<fmt> of the m-line: "
3234 << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003235 return true;
3236 }
jbauch083b73f2015-07-16 02:46:32 -07003237 const std::string& encoder = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003238 std::vector<std::string> codec_params;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00003239 rtc::split(encoder, '/', &codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003240 // <encoding name>/<clock rate>[/<encodingparameters>]
3241 // 2 mandatory fields
3242 if (codec_params.size() < 2 || codec_params.size() > 3) {
3243 return ParseFailed(line,
3244 "Expected format \"<encoding name>/<clock rate>"
3245 "[/<encodingparameters>]\".",
3246 error);
3247 }
jbauch083b73f2015-07-16 02:46:32 -07003248 const std::string& encoding_name = codec_params[0];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003249 int clock_rate = 0;
3250 if (!GetValueFromString(line, codec_params[1], &clock_rate, error)) {
3251 return false;
3252 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003253 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003254 VideoContentDescription* video_desc = media_desc->as_video();
Yves Gerey665174f2018-06-19 15:03:05 +02003255 UpdateCodec(payload_type, encoding_name, video_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003256 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3257 // RFC 4566
3258 // For audio streams, <encoding parameters> indicates the number
3259 // of audio channels. This parameter is OPTIONAL and may be
3260 // omitted if the number of channels is one, provided that no
3261 // additional parameters are needed.
Peter Kasting69558702016-01-12 16:26:35 -08003262 size_t channels = 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003263 if (codec_params.size() == 3) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003264 if (!GetValueFromString(line, codec_params[2], &channels, error)) {
3265 return false;
3266 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003267 }
Steve Antonb1c1de12017-12-21 15:14:30 -08003268 AudioContentDescription* audio_desc = media_desc->as_audio();
ossue1405ad2017-01-23 08:55:48 -08003269 UpdateCodec(payload_type, encoding_name, clock_rate, 0, channels,
deadbeef67cf2c12016-04-13 10:07:16 -07003270 audio_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003271 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003272 DataContentDescription* data_desc = media_desc->as_data();
deadbeef67cf2c12016-04-13 10:07:16 -07003273 data_desc->AddCodec(cricket::DataCodec(payload_type, encoding_name));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003274 }
3275 return true;
3276}
3277
Yves Gerey665174f2018-06-19 15:03:05 +02003278bool ParseFmtpParam(const std::string& line,
3279 std::string* parameter,
3280 std::string* value,
3281 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003282 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, parameter, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003283 ParseFailed(line, "Unable to parse fmtp parameter. \'=\' missing.", error);
3284 return false;
3285 }
3286 // a=fmtp:<payload_type> <param1>=<value1>; <param2>=<value2>; ...
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003287 return true;
3288}
3289
Yves Gerey665174f2018-06-19 15:03:05 +02003290bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003291 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003292 MediaContentDescription* media_desc,
3293 SdpParseError* error) {
3294 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3295 media_type != cricket::MEDIA_TYPE_VIDEO) {
3296 return true;
3297 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003298
3299 std::string line_payload;
3300 std::string line_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003301
3302 // RFC 5576
3303 // a=fmtp:<format> <format specific parameters>
3304 // At least two fields, whereas the second one is any of the optional
3305 // parameters.
Jonas Olssonec9e4922018-09-05 09:53:49 +02003306 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3307 kSdpDelimiterSpaceChar, &line_payload,
3308 &line_params)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003309 ParseFailedExpectMinFieldNum(line, 2, error);
3310 return false;
3311 }
3312
Donald Curtis0e07f922015-05-15 09:21:23 -07003313 // Parse out the payload information.
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003314 std::string payload_type_str;
Donald Curtis0e07f922015-05-15 09:21:23 -07003315 if (!GetValue(line_payload, kAttributeFmtp, &payload_type_str, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003316 return false;
3317 }
3318
Donald Curtis0e07f922015-05-15 09:21:23 -07003319 int payload_type = 0;
Donald Curtis144d0182015-05-15 13:14:24 -07003320 if (!GetPayloadTypeFromString(line_payload, payload_type_str, &payload_type,
3321 error)) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003322 return false;
3323 }
3324
3325 // Parse out format specific parameters.
3326 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003327 rtc::split(line_params, kSdpDelimiterSemicolonChar, &fields);
Donald Curtis0e07f922015-05-15 09:21:23 -07003328
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003329 cricket::CodecParameterMap codec_params;
Donald Curtis144d0182015-05-15 13:14:24 -07003330 for (auto& iter : fields) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003331 if (iter.find(kSdpDelimiterEqual) == std::string::npos) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003332 // Only fmtps with equals are currently supported. Other fmtp types
3333 // should be ignored. Unknown fmtps do not constitute an error.
3334 continue;
3335 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003336
3337 std::string name;
3338 std::string value;
3339 if (!ParseFmtpParam(rtc::string_trim(iter), &name, &value, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003340 return false;
3341 }
3342 codec_params[name] = value;
3343 }
3344
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003345 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3346 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003347 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003348 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
3349 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003350 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003351 }
3352 return true;
3353}
3354
Yves Gerey665174f2018-06-19 15:03:05 +02003355bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003356 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003357 MediaContentDescription* media_desc,
3358 SdpParseError* error) {
3359 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3360 media_type != cricket::MEDIA_TYPE_VIDEO) {
3361 return true;
3362 }
3363 std::vector<std::string> rtcp_fb_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003364 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &rtcp_fb_fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003365 if (rtcp_fb_fields.size() < 2) {
3366 return ParseFailedGetValue(line, kAttributeRtcpFb, error);
3367 }
3368 std::string payload_type_string;
3369 if (!GetValue(rtcp_fb_fields[0], kAttributeRtcpFb, &payload_type_string,
3370 error)) {
3371 return false;
3372 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003373 int payload_type = kWildcardPayloadType;
3374 if (payload_type_string != "*") {
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003375 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3376 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003377 return false;
3378 }
3379 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003380 std::string id = rtcp_fb_fields[1];
3381 std::string param = "";
3382 for (std::vector<std::string>::iterator iter = rtcp_fb_fields.begin() + 2;
3383 iter != rtcp_fb_fields.end(); ++iter) {
3384 param.append(*iter);
3385 }
3386 const cricket::FeedbackParam feedback_param(id, param);
3387
3388 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003389 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
3390 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003391 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003392 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
3393 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003394 }
3395 return true;
3396}
3397
3398} // namespace webrtc