blob: 220e75261b362f1aa0317c5ecef9f2f132a84e06 [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
Steve Anton10542f22019-01-11 09:11:00 -080011#include "pc/webrtc_sdp.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
Steve Anton64b626b2019-01-28 17:25:26 -080026#include "absl/algorithm/container.h"
Niels Möller039743e2018-10-23 10:07:25 +020027#include "absl/strings/match.h"
Patrik Höglunde2d6a062017-10-05 14:53:33 +020028#include "api/candidate.h"
Steve Anton10542f22019-01-11 09:11:00 -080029#include "api/crypto_params.h"
30#include "api/jsep_ice_candidate.h"
31#include "api/jsep_session_description.h"
32#include "api/media_types.h"
isheriff6f8d6862016-05-26 11:24:55 -070033// for RtpExtension
Steve Anton10542f22019-01-11 09:11:00 -080034#include "api/rtp_parameters.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020035#include "media/base/codec.h"
Steve Anton10542f22019-01-11 09:11:00 -080036#include "media/base/media_constants.h"
37#include "media/base/rtp_utils.h"
38#include "media/sctp/sctp_transport_internal.h"
39#include "p2p/base/p2p_constants.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020040#include "p2p/base/port.h"
Steve Anton10542f22019-01-11 09:11:00 -080041#include "pc/media_session.h"
42#include "pc/sdp_serializer.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020043#include "rtc_base/arraysize.h"
44#include "rtc_base/checks.h"
45#include "rtc_base/logging.h"
Steve Anton10542f22019-01-11 09:11:00 -080046#include "rtc_base/message_digest.h"
Niels Möller198cf002019-05-10 12:29:13 +020047#include "rtc_base/string_utils.h"
Jonas Olssonec9e4922018-09-05 09:53:49 +020048#include "rtc_base/strings/string_builder.h"
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -080049#include "rtc_base/third_party/base64/base64.h"
henrike@webrtc.org28e20752013-07-10 00:45:36 +000050
51using cricket::AudioContentDescription;
52using cricket::Candidate;
53using cricket::Candidates;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000054using cricket::ContentInfo;
55using cricket::CryptoParams;
Harald Alvestrand141c0ad2019-05-05 19:00:00 +000056using cricket::ICE_CANDIDATE_COMPONENT_RTCP;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020057using cricket::ICE_CANDIDATE_COMPONENT_RTP;
Taylor Brandstetteree8c2462020-07-27 15:52:02 -070058using cricket::kApplicationSpecificBandwidth;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000059using cricket::kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000060using cricket::kCodecParamMinPTime;
61using cricket::kCodecParamPTime;
Taylor Brandstetteree8c2462020-07-27 15:52:02 -070062using cricket::kTransportSpecificBandwidth;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000063using cricket::MediaContentDescription;
Harald Alvestrand141c0ad2019-05-05 19:00:00 +000064using cricket::MediaProtocolType;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020065using cricket::MediaType;
Harald Alvestrand141c0ad2019-05-05 19:00:00 +000066using cricket::RidDescription;
Harald Alvestrand5fc28b12019-05-13 13:36:16 +020067using cricket::RtpDataContentDescription;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020068using cricket::RtpHeaderExtensions;
Harald Alvestrand5fc28b12019-05-13 13:36:16 +020069using cricket::SctpDataContentDescription;
Amit Hilbucha2012042018-12-03 11:35:05 -080070using cricket::SimulcastDescription;
Amit Hilbuchc57d5732018-12-11 15:30:11 -080071using cricket::SimulcastLayer;
72using cricket::SimulcastLayerList;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000073using cricket::SsrcGroup;
74using cricket::StreamParams;
75using cricket::StreamParamsVec;
76using cricket::TransportDescription;
77using cricket::TransportInfo;
Philipp Hancke4e8c1152020-10-13 12:43:15 +020078using cricket::UnsupportedContentDescription;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000079using cricket::VideoContentDescription;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +000080using rtc::SocketAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000081
henrike@webrtc.org28e20752013-07-10 00:45:36 +000082namespace cricket {
83class SessionDescription;
84}
85
deadbeef90f1e1e2017-02-10 12:35:05 -080086// TODO(deadbeef): Switch to using anonymous namespace rather than declaring
87// everything "static".
henrike@webrtc.org28e20752013-07-10 00:45:36 +000088namespace webrtc {
89
90// Line type
91// RFC 4566
92// An SDP session description consists of a number of lines of text of
93// the form:
94// <type>=<value>
95// where <type> MUST be exactly one case-significant character.
deadbeef9d3584c2016-02-16 17:54:10 -080096static const int kLinePrefixLength = 2; // Length of <type>=
henrike@webrtc.org28e20752013-07-10 00:45:36 +000097static const char kLineTypeVersion = 'v';
98static const char kLineTypeOrigin = 'o';
99static const char kLineTypeSessionName = 's';
100static const char kLineTypeSessionInfo = 'i';
101static const char kLineTypeSessionUri = 'u';
102static const char kLineTypeSessionEmail = 'e';
103static const char kLineTypeSessionPhone = 'p';
104static const char kLineTypeSessionBandwidth = 'b';
105static const char kLineTypeTiming = 't';
106static const char kLineTypeRepeatTimes = 'r';
107static const char kLineTypeTimeZone = 'z';
108static const char kLineTypeEncryptionKey = 'k';
109static const char kLineTypeMedia = 'm';
110static const char kLineTypeConnection = 'c';
111static const char kLineTypeAttributes = 'a';
112
113// Attributes
114static const char kAttributeGroup[] = "group";
115static const char kAttributeMid[] = "mid";
deadbeef9d3584c2016-02-16 17:54:10 -0800116static const char kAttributeMsid[] = "msid";
deadbeef25ed4352016-12-12 18:37:36 -0800117static const char kAttributeBundleOnly[] = "bundle-only";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000118static const char kAttributeRtcpMux[] = "rtcp-mux";
deadbeef13871492015-12-09 12:37:51 -0800119static const char kAttributeRtcpReducedSize[] = "rtcp-rsize";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000120static const char kAttributeSsrc[] = "ssrc";
121static const char kSsrcAttributeCname[] = "cname";
Johannes Kron0854eb62018-10-10 22:33:20 +0200122static const char kAttributeExtmapAllowMixed[] = "extmap-allow-mixed";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000123static const char kAttributeExtmap[] = "extmap";
124// draft-alvestrand-mmusic-msid-01
125// a=msid-semantic: WMS
Seth Hampson5b4f0752018-04-02 16:31:36 -0700126// This is a legacy field supported only for Plan B semantics.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000127static const char kAttributeMsidSemantics[] = "msid-semantic";
128static const char kMediaStreamSemantic[] = "WMS";
129static const char kSsrcAttributeMsid[] = "msid";
130static const char kDefaultMsid[] = "default";
Seth Hampson5b4f0752018-04-02 16:31:36 -0700131static const char kNoStreamMsid[] = "-";
Artem Titovf0a34f22020-03-16 17:52:04 +0000132static const char kSsrcAttributeMslabel[] = "mslabel";
133static const char kSSrcAttributeLabel[] = "label";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000134static const char kAttributeSsrcGroup[] = "ssrc-group";
135static const char kAttributeCrypto[] = "crypto";
136static const char kAttributeCandidate[] = "candidate";
137static const char kAttributeCandidateTyp[] = "typ";
138static const char kAttributeCandidateRaddr[] = "raddr";
139static const char kAttributeCandidateRport[] = "rport";
honghaiza54a0802015-12-16 18:37:23 -0800140static const char kAttributeCandidateUfrag[] = "ufrag";
141static const char kAttributeCandidatePwd[] = "pwd";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000142static const char kAttributeCandidateGeneration[] = "generation";
honghaiza0c44ea2016-03-23 16:07:48 -0700143static const char kAttributeCandidateNetworkId[] = "network-id";
honghaize1a0c942016-02-16 14:54:56 -0800144static const char kAttributeCandidateNetworkCost[] = "network-cost";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000145static const char kAttributeFingerprint[] = "fingerprint";
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000146static const char kAttributeSetup[] = "setup";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000147static const char kAttributeFmtp[] = "fmtp";
148static const char kAttributeRtpmap[] = "rtpmap";
wu@webrtc.org78187522013-10-07 23:32:02 +0000149static const char kAttributeSctpmap[] = "sctpmap";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000150static const char kAttributeRtcp[] = "rtcp";
151static const char kAttributeIceUfrag[] = "ice-ufrag";
152static const char kAttributeIcePwd[] = "ice-pwd";
153static const char kAttributeIceLite[] = "ice-lite";
154static const char kAttributeIceOption[] = "ice-options";
155static const char kAttributeSendOnly[] = "sendonly";
156static const char kAttributeRecvOnly[] = "recvonly";
157static const char kAttributeRtcpFb[] = "rtcp-fb";
158static const char kAttributeSendRecv[] = "sendrecv";
159static const char kAttributeInactive[] = "inactive";
Harald Alvestrand48cce4d2019-04-11 10:41:24 +0200160// draft-ietf-mmusic-sctp-sdp-26
161// a=sctp-port, a=max-message-size
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +0000162static const char kAttributeSctpPort[] = "sctp-port";
Harald Alvestrand48cce4d2019-04-11 10:41:24 +0200163static const char kAttributeMaxMessageSize[] = "max-message-size";
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +0200164static const int kDefaultSctpMaxMessageSize = 65536;
Amit Hilbucha2012042018-12-03 11:35:05 -0800165// draft-ietf-mmusic-sdp-simulcast-13
166// a=simulcast
167static const char kAttributeSimulcast[] = "simulcast";
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800168// draft-ietf-mmusic-rid-15
169// a=rid
170static const char kAttributeRid[] = "rid";
Mirta Dvornicic479a3c02019-06-04 15:38:50 +0200171static const char kAttributePacketization[] = "packetization";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000172
173// Experimental flags
174static const char kAttributeXGoogleFlag[] = "x-google-flag";
175static const char kValueConference[] = "conference";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000176
Sebastian Janssone1795f42019-07-24 11:38:03 +0200177static const char kAttributeRtcpRemoteEstimate[] = "remote-net-estimate";
178
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000179// Candidate
180static const char kCandidateHost[] = "host";
181static const char kCandidateSrflx[] = "srflx";
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700182static const char kCandidatePrflx[] = "prflx";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000183static const char kCandidateRelay[] = "relay";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +0000184static const char kTcpCandidateType[] = "tcptype";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000185
Jonas Olssonec9e4922018-09-05 09:53:49 +0200186// rtc::StringBuilder doesn't have a << overload for chars, while rtc::split and
187// rtc::tokenize_first both take a char delimiter. To handle both cases these
188// constants come in pairs of a chars and length-one strings.
189static const char kSdpDelimiterEqual[] = "=";
190static const char kSdpDelimiterEqualChar = '=';
191static const char kSdpDelimiterSpace[] = " ";
192static const char kSdpDelimiterSpaceChar = ' ';
193static const char kSdpDelimiterColon[] = ":";
194static const char kSdpDelimiterColonChar = ':';
195static const char kSdpDelimiterSemicolon[] = ";";
196static const char kSdpDelimiterSemicolonChar = ';';
197static const char kSdpDelimiterSlashChar = '/';
198static const char kNewLine[] = "\n";
199static const char kNewLineChar = '\n';
200static const char kReturnChar = '\r';
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000201static const char kLineBreak[] = "\r\n";
202
Steve Anton36b29d12017-10-30 09:57:42 -0700203// TODO(deadbeef): Generate the Session and Time description
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000204// instead of hardcoding.
205static const char kSessionVersion[] = "v=0";
206// RFC 4566
207static const char kSessionOriginUsername[] = "-";
208static const char kSessionOriginSessionId[] = "0";
209static const char kSessionOriginSessionVersion[] = "0";
210static const char kSessionOriginNettype[] = "IN";
211static const char kSessionOriginAddrtype[] = "IP4";
212static const char kSessionOriginAddress[] = "127.0.0.1";
213static const char kSessionName[] = "s=-";
214static const char kTimeDescription[] = "t=0 0";
215static const char kAttrGroup[] = "a=group:BUNDLE";
216static const char kConnectionNettype[] = "IN";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000217static const char kConnectionIpv4Addrtype[] = "IP4";
218static const char kConnectionIpv6Addrtype[] = "IP6";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000219static const char kMediaTypeVideo[] = "video";
220static const char kMediaTypeAudio[] = "audio";
221static const char kMediaTypeData[] = "application";
222static const char kMediaPortRejected[] = "0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000223// draft-ietf-mmusic-trickle-ice-01
224// When no candidates have been gathered, set the connection
225// address to IP6 ::.
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000226// TODO(perkj): FF can not parse IP6 ::. See http://crbug/430333
227// Use IPV4 per default.
228static const char kDummyAddress[] = "0.0.0.0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000229static const char kDummyPort[] = "9";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000230
wu@webrtc.org78187522013-10-07 23:32:02 +0000231static const char kDefaultSctpmapProtocol[] = "webrtc-datachannel";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000232
pkasting@chromium.orgd3245462015-02-23 21:28:22 +0000233// RTP payload type is in the 0-127 range. Use -1 to indicate "all" payload
234// types.
235const int kWildcardPayloadType = -1;
236
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000237struct SsrcInfo {
Peter Boström0c4e06b2015-10-07 12:23:21 +0200238 uint32_t ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000239 std::string cname;
deadbeef9d3584c2016-02-16 17:54:10 -0800240 std::string stream_id;
241 std::string track_id;
Artem Titovf0a34f22020-03-16 17:52:04 +0000242
243 // For backward compatibility.
244 // TODO(ronghuawu): Remove below 2 fields once all the clients support msid.
245 std::string label;
246 std::string mslabel;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000247};
248typedef std::vector<SsrcInfo> SsrcInfoVec;
249typedef std::vector<SsrcGroup> SsrcGroupVec;
250
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000251template <class T>
252static void AddFmtpLine(const T& codec, std::string* message);
253static void BuildMediaDescription(const ContentInfo* content_info,
254 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200255 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000256 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -0800257 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000258 std::string* message);
deadbeef9d3584c2016-02-16 17:54:10 -0800259static void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200260 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -0800261 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -0800262 std::string* message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000263static void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200264 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000265 std::string* message);
266static void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -0800267 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000268 std::string* message);
269static void BuildIceOptions(const std::vector<std::string>& transport_options,
270 std::string* message);
zhihuang38989e52017-03-21 11:04:53 -0700271static bool ParseSessionDescription(const std::string& message,
272 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000273 std::string* session_id,
274 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000275 TransportDescription* session_td,
276 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700277 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000278 cricket::SessionDescription* desc,
279 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000280static 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,
Steve Anton5a1de872018-12-18 11:25:55 -0800287 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000288 SdpParseError* error);
Steve Anton5a1de872018-12-18 11:25:55 -0800289static bool ParseContent(
290 const std::string& message,
291 const cricket::MediaType media_type,
292 int mline_index,
293 const std::string& protocol,
294 const std::vector<int>& payload_types,
295 size_t* pos,
296 std::string* content_name,
297 bool* bundle_only,
298 int* msid_signaling,
299 MediaContentDescription* media_desc,
300 TransportDescription* transport,
301 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
302 SdpParseError* error);
Philipp Hancke4e8c1152020-10-13 12:43:15 +0200303static bool ParseGroupAttribute(const std::string& line,
304 cricket::SessionDescription* desc,
305 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000306static bool ParseSsrcAttribute(const std::string& line,
307 SsrcInfoVec* ssrc_infos,
Steve Antone831b8c2018-02-01 12:22:16 -0800308 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000309 SdpParseError* error);
310static bool ParseSsrcGroupAttribute(const std::string& line,
311 SsrcGroupVec* ssrc_groups,
312 SdpParseError* error);
313static bool ParseCryptoAttribute(const std::string& line,
314 MediaContentDescription* media_desc,
315 SdpParseError* error);
316static bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200317 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -0700318 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000319 MediaContentDescription* media_desc,
320 SdpParseError* error);
321static bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200322 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000323 MediaContentDescription* media_desc,
324 SdpParseError* error);
Yves Gerey665174f2018-06-19 15:03:05 +0200325static bool ParseFmtpParam(const std::string& line,
326 std::string* parameter,
327 std::string* value,
328 SdpParseError* error);
Mirta Dvornicic479a3c02019-06-04 15:38:50 +0200329static bool ParsePacketizationAttribute(const std::string& line,
330 const cricket::MediaType media_type,
331 MediaContentDescription* media_desc,
332 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000333static bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200334 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000335 MediaContentDescription* media_desc,
336 SdpParseError* error);
337static bool ParseIceOptions(const std::string& line,
338 std::vector<std::string>* transport_options,
339 SdpParseError* error);
340static bool ParseExtmap(const std::string& line,
isheriff6f8d6862016-05-26 11:24:55 -0700341 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000342 SdpParseError* error);
Steve Anton4905edb2018-10-15 19:27:44 -0700343static bool ParseFingerprintAttribute(
344 const std::string& line,
345 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
346 SdpParseError* error);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000347static bool ParseDtlsSetup(const std::string& line,
348 cricket::ConnectionRole* role,
349 SdpParseError* error);
deadbeef9d3584c2016-02-16 17:54:10 -0800350static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700351 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -0800352 std::string* track_id,
353 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000354
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800355static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
356 std::vector<RidDescription>* rids);
357
358static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
359 const std::set<std::string>& to_remove,
360 const SimulcastLayerList& layers);
361
362static void RemoveInvalidRidsFromSimulcast(
363 const std::vector<RidDescription>& rids,
364 SimulcastDescription* simulcast);
365
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000366// Helper functions
367
368// Below ParseFailed*** functions output the line that caused the parsing
369// failure and the detailed reason (|description|) of the failure to |error|.
370// The functions always return false so that they can be used directly in the
371// following way when error happens:
372// "return ParseFailed***(...);"
373
374// The line starting at |line_start| of |message| is the failing line.
375// The reason for the failure should be provided in the |description|.
376// An example of a description could be "unknown character".
377static bool ParseFailed(const std::string& message,
378 size_t line_start,
379 const std::string& description,
380 SdpParseError* error) {
381 // Get the first line of |message| from |line_start|.
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000382 std::string first_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000383 size_t line_end = message.find(kNewLine, line_start);
384 if (line_end != std::string::npos) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200385 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000386 --line_end;
387 }
388 first_line = message.substr(line_start, (line_end - line_start));
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000389 } else {
390 first_line = message.substr(line_start);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000391 }
392
393 if (error) {
394 error->line = first_line;
395 error->description = description;
396 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100397 RTC_LOG(LS_ERROR) << "Failed to parse: \"" << first_line
398 << "\". Reason: " << description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000399 return false;
400}
401
402// |line| is the failing line. The reason for the failure should be
403// provided in the |description|.
404static bool ParseFailed(const std::string& line,
405 const std::string& description,
406 SdpParseError* error) {
407 return ParseFailed(line, 0, description, error);
408}
409
410// Parses failure where the failing SDP line isn't know or there are multiple
411// failing lines.
Yves Gerey665174f2018-06-19 15:03:05 +0200412static bool ParseFailed(const std::string& description, SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000413 return ParseFailed("", description, error);
414}
415
416// |line| is the failing line. The failure is due to the fact that |line|
417// doesn't have |expected_fields| fields.
418static bool ParseFailedExpectFieldNum(const std::string& line,
419 int expected_fields,
420 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200421 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000422 description << "Expects " << expected_fields << " fields.";
423 return ParseFailed(line, description.str(), error);
424}
425
426// |line| is the failing line. The failure is due to the fact that |line| has
427// less than |expected_min_fields| fields.
428static bool ParseFailedExpectMinFieldNum(const std::string& line,
429 int expected_min_fields,
430 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200431 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000432 description << "Expects at least " << expected_min_fields << " fields.";
433 return ParseFailed(line, description.str(), error);
434}
435
436// |line| is the failing line. The failure is due to the fact that it failed to
437// get the value of |attribute|.
438static bool ParseFailedGetValue(const std::string& line,
439 const std::string& attribute,
440 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200441 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000442 description << "Failed to get the value of attribute: " << attribute;
443 return ParseFailed(line, description.str(), error);
444}
445
446// The line starting at |line_start| of |message| is the failing line. The
447// failure is due to the line type (e.g. the "m" part of the "m-line")
448// not matching what is expected. The expected line type should be
449// provided as |line_type|.
450static bool ParseFailedExpectLine(const std::string& message,
451 size_t line_start,
452 const char line_type,
453 const std::string& line_value,
454 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200455 rtc::StringBuilder description;
456 description << "Expect line: " << std::string(1, line_type) << "="
457 << line_value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000458 return ParseFailed(message, line_start, description.str(), error);
459}
460
461static bool AddLine(const std::string& line, std::string* message) {
462 if (!message)
463 return false;
464
465 message->append(line);
466 message->append(kLineBreak);
467 return true;
468}
469
470static bool GetLine(const std::string& message,
471 size_t* pos,
472 std::string* line) {
473 size_t line_begin = *pos;
474 size_t line_end = message.find(kNewLine, line_begin);
475 if (line_end == std::string::npos) {
476 return false;
477 }
478 // Update the new start position
479 *pos = line_end + 1;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200480 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000481 --line_end;
482 }
483 *line = message.substr(line_begin, (line_end - line_begin));
484 const char* cline = line->c_str();
485 // RFC 4566
486 // An SDP session description consists of a number of lines of text of
487 // the form:
488 // <type>=<value>
489 // where <type> MUST be exactly one case-significant character and
490 // <value> is structured text whose format depends on <type>.
491 // Whitespace MUST NOT be used on either side of the "=" sign.
Taylor Brandstetter93a7b242018-04-16 10:45:24 -0700492 //
493 // However, an exception to the whitespace rule is made for "s=", since
494 // RFC4566 also says:
495 //
496 // If a session has no meaningful name, the value "s= " SHOULD be used
497 // (i.e., a single space as the session name).
498 if (line->length() < 3 || !islower(cline[0]) ||
Jonas Olssonec9e4922018-09-05 09:53:49 +0200499 cline[1] != kSdpDelimiterEqualChar ||
500 (cline[0] != kLineTypeSessionName &&
501 cline[2] == kSdpDelimiterSpaceChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000502 *pos = line_begin;
503 return false;
504 }
505 return true;
506}
507
508// Init |os| to "|type|=|value|".
509static void InitLine(const char type,
510 const std::string& value,
Jonas Olssonec9e4922018-09-05 09:53:49 +0200511 rtc::StringBuilder* os) {
512 os->Clear();
513 *os << std::string(1, type) << kSdpDelimiterEqual << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000514}
515
516// Init |os| to "a=|attribute|".
Jonas Olssonec9e4922018-09-05 09:53:49 +0200517static void InitAttrLine(const std::string& attribute, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000518 InitLine(kLineTypeAttributes, attribute, os);
519}
520
521// Writes a SDP attribute line based on |attribute| and |value| to |message|.
Yves Gerey665174f2018-06-19 15:03:05 +0200522static void AddAttributeLine(const std::string& attribute,
523 int value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000524 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200525 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000526 InitAttrLine(attribute, &os);
527 os << kSdpDelimiterColon << value;
528 AddLine(os.str(), message);
529}
530
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000531static bool IsLineType(const std::string& message,
532 const char type,
533 size_t line_start) {
534 if (message.size() < line_start + kLinePrefixLength) {
535 return false;
536 }
537 const char* cmessage = message.c_str();
538 return (cmessage[line_start] == type &&
Jonas Olssonec9e4922018-09-05 09:53:49 +0200539 cmessage[line_start + 1] == kSdpDelimiterEqualChar);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000540}
541
Yves Gerey665174f2018-06-19 15:03:05 +0200542static bool IsLineType(const std::string& line, const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000543 return IsLineType(line, type, 0);
544}
545
Yves Gerey665174f2018-06-19 15:03:05 +0200546static bool GetLineWithType(const std::string& message,
547 size_t* pos,
548 std::string* line,
549 const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000550 if (!IsLineType(message, type, *pos)) {
551 return false;
552 }
553
554 if (!GetLine(message, pos, line))
555 return false;
556
557 return true;
558}
559
560static bool HasAttribute(const std::string& line,
561 const std::string& attribute) {
Johannes Kron211856b2018-09-06 12:12:28 +0200562 if (line.compare(kLinePrefixLength, attribute.size(), attribute) == 0) {
563 // Make sure that the match is not only a partial match. If length of
564 // strings doesn't match, the next character of the line must be ':' or ' '.
565 // This function is also used for media descriptions (e.g., "m=audio 9..."),
566 // hence the need to also allow space in the end.
567 RTC_CHECK_LE(kLinePrefixLength + attribute.size(), line.size());
568 if ((kLinePrefixLength + attribute.size()) == line.size() ||
569 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterColonChar ||
570 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterSpaceChar) {
571 return true;
572 }
573 }
574 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000575}
576
Peter Boström0c4e06b2015-10-07 12:23:21 +0200577static bool AddSsrcLine(uint32_t ssrc_id,
578 const std::string& attribute,
579 const std::string& value,
580 std::string* message) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000581 // RFC 5576
582 // a=ssrc:<ssrc-id> <attribute>:<value>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200583 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000584 InitAttrLine(kAttributeSsrc, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200585 os << kSdpDelimiterColon << ssrc_id << kSdpDelimiterSpace << attribute
586 << kSdpDelimiterColon << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000587 return AddLine(os.str(), message);
588}
589
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000590// Get value only from <attribute>:<value>.
Yves Gerey665174f2018-06-19 15:03:05 +0200591static bool GetValue(const std::string& message,
592 const std::string& attribute,
593 std::string* value,
594 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000595 std::string leftpart;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200596 if (!rtc::tokenize_first(message, kSdpDelimiterColonChar, &leftpart, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000597 return ParseFailedGetValue(message, attribute, error);
598 }
599 // The left part should end with the expected attribute.
600 if (leftpart.length() < attribute.length() ||
601 leftpart.compare(leftpart.length() - attribute.length(),
602 attribute.length(), attribute) != 0) {
603 return ParseFailedGetValue(message, attribute, error);
604 }
605 return true;
606}
607
608static bool CaseInsensitiveFind(std::string str1, std::string str2) {
Steve Anton64b626b2019-01-28 17:25:26 -0800609 absl::c_transform(str1, str1.begin(), ::tolower);
610 absl::c_transform(str2, str2.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000611 return str1.find(str2) != std::string::npos;
612}
613
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000614template <class T>
615static bool GetValueFromString(const std::string& line,
616 const std::string& s,
617 T* t,
618 SdpParseError* error) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000619 if (!rtc::FromString(s, t)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200620 rtc::StringBuilder description;
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000621 description << "Invalid value: " << s << ".";
622 return ParseFailed(line, description.str(), error);
623 }
624 return true;
625}
626
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000627static bool GetPayloadTypeFromString(const std::string& line,
628 const std::string& s,
629 int* payload_type,
630 SdpParseError* error) {
631 return GetValueFromString(line, s, payload_type, error) &&
Yves Gerey665174f2018-06-19 15:03:05 +0200632 cricket::IsValidRtpPayloadType(*payload_type);
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000633}
634
Seth Hampson5897a6e2018-04-03 11:16:33 -0700635// Creates a StreamParams track in the case when no SSRC lines are signaled.
636// This is a track that does not contain SSRCs and only contains
637// stream_ids/track_id if it's signaled with a=msid lines.
638void CreateTrackWithNoSsrcs(const std::vector<std::string>& msid_stream_ids,
639 const std::string& msid_track_id,
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800640 const std::vector<RidDescription>& rids,
Seth Hampson5897a6e2018-04-03 11:16:33 -0700641 StreamParamsVec* tracks) {
642 StreamParams track;
Amit Hilbuch6df49d82019-04-15 15:47:21 -0700643 if (msid_track_id.empty() && rids.empty()) {
Seth Hampson5897a6e2018-04-03 11:16:33 -0700644 // We only create an unsignaled track if a=msid lines were signaled.
Amit Hilbuch6df49d82019-04-15 15:47:21 -0700645 RTC_LOG(LS_INFO) << "MSID not signaled, skipping creation of StreamParams";
Seth Hampson5897a6e2018-04-03 11:16:33 -0700646 return;
647 }
648 track.set_stream_ids(msid_stream_ids);
649 track.id = msid_track_id;
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800650 track.set_rids(rids);
Seth Hampson5897a6e2018-04-03 11:16:33 -0700651 tracks->push_back(track);
652}
653
654// Creates the StreamParams tracks, for the case when SSRC lines are signaled.
655// |msid_stream_ids| and |msid_track_id| represent the stream/track ID from the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800656// "a=msid" attribute, if it exists. They are empty if the attribute does not
Seth Hampson5897a6e2018-04-03 11:16:33 -0700657// exist. We prioritize getting stream_ids/track_ids signaled in a=msid lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000658void CreateTracksFromSsrcInfos(const SsrcInfoVec& ssrc_infos,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700659 const std::vector<std::string>& msid_stream_ids,
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800660 const std::string& msid_track_id,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700661 StreamParamsVec* tracks,
662 int msid_signaling) {
nisseede5da42017-01-12 05:15:36 -0800663 RTC_DCHECK(tracks != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700664 for (const SsrcInfo& ssrc_info : ssrc_infos) {
Taylor Brandstetter4256df02020-02-18 14:05:07 -0800665 // According to https://tools.ietf.org/html/rfc5576#section-6.1, the CNAME
666 // attribute is mandatory, but we relax that restriction.
Steve Anton4daf66e2018-09-07 14:55:53 -0700667 if (ssrc_info.cname.empty()) {
Taylor Brandstetter4256df02020-02-18 14:05:07 -0800668 RTC_LOG(LS_WARNING) << "CNAME attribute missing for SSRC "
669 << ssrc_info.ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000670 }
Seth Hampson5b4f0752018-04-02 16:31:36 -0700671 std::vector<std::string> stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000672 std::string track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700673 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
674 // This is the case with Unified Plan SDP msid signaling.
675 stream_ids = msid_stream_ids;
Tomas Gunnarsson191bf5c2018-03-30 10:44:43 +0000676 track_id = msid_track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700677 } else if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
678 // This is the case with Plan B SDP msid signaling.
Steve Anton4daf66e2018-09-07 14:55:53 -0700679 stream_ids.push_back(ssrc_info.stream_id);
680 track_id = ssrc_info.track_id;
Artem Titovf0a34f22020-03-16 17:52:04 +0000681 } else if (!ssrc_info.mslabel.empty()) {
682 // Since there's no a=msid or a=ssrc msid signaling, this is a sdp from
683 // an older version of client that doesn't support msid.
684 // In that case, we use the mslabel and label to construct the track.
685 stream_ids.push_back(ssrc_info.mslabel);
686 track_id = ssrc_info.label;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700687 } else {
688 // Since no media streams isn't supported with older SDP signaling, we
689 // use a default a stream id.
690 stream_ids.push_back(kDefaultMsid);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000691 }
Seth Hampson5b4f0752018-04-02 16:31:36 -0700692 // If a track ID wasn't populated from the SSRC attributes OR the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800693 // msid attribute, use default/random values.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800694 if (track_id.empty()) {
695 // TODO(ronghuawu): What should we do if the track id doesn't appear?
696 // Create random string (which will be used as track label later)?
697 track_id = rtc::CreateRandomString(8);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000698 }
699
Steve Anton64b626b2019-01-28 17:25:26 -0800700 auto track_it = absl::c_find_if(
701 *tracks,
Steve Anton4daf66e2018-09-07 14:55:53 -0700702 [track_id](const StreamParams& track) { return track.id == track_id; });
703 if (track_it == tracks->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000704 // If we don't find an existing track, create a new one.
705 tracks->push_back(StreamParams());
Steve Anton4daf66e2018-09-07 14:55:53 -0700706 track_it = tracks->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000707 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700708 StreamParams& track = *track_it;
709 track.add_ssrc(ssrc_info.ssrc_id);
710 track.cname = ssrc_info.cname;
711 track.set_stream_ids(stream_ids);
712 track.id = track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000713 }
714}
715
Seth Hampson845e8782018-03-02 11:34:10 -0800716void GetMediaStreamIds(const ContentInfo* content,
717 std::set<std::string>* labels) {
Steve Antonb1c1de12017-12-21 15:14:30 -0800718 for (const StreamParams& stream_params :
719 content->media_description()->streams()) {
Seth Hampson845e8782018-03-02 11:34:10 -0800720 for (const std::string& stream_id : stream_params.stream_ids()) {
721 labels->insert(stream_id);
Steve Anton5a26a3a2018-02-28 11:38:47 -0800722 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000723 }
724}
725
726// RFC 5245
727// It is RECOMMENDED that default candidates be chosen based on the
728// likelihood of those candidates to work with the peer that is being
729// contacted. It is RECOMMENDED that relayed > reflexive > host.
730static const int kPreferenceUnknown = 0;
731static const int kPreferenceHost = 1;
732static const int kPreferenceReflexive = 2;
733static const int kPreferenceRelayed = 3;
734
735static int GetCandidatePreferenceFromType(const std::string& type) {
736 int preference = kPreferenceUnknown;
737 if (type == cricket::LOCAL_PORT_TYPE) {
738 preference = kPreferenceHost;
739 } else if (type == cricket::STUN_PORT_TYPE) {
740 preference = kPreferenceReflexive;
741 } else if (type == cricket::RELAY_PORT_TYPE) {
742 preference = kPreferenceRelayed;
743 } else {
nissec80e7412017-01-11 05:56:46 -0800744 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000745 }
746 return preference;
747}
748
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000749// Get ip and port of the default destination from the |candidates| with the
750// given value of |component_id|. The default candidate should be the one most
751// likely to work, typically IPv4 relay.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000752// RFC 5245
753// The value of |component_id| currently supported are 1 (RTP) and 2 (RTCP).
Steve Anton36b29d12017-10-30 09:57:42 -0700754// TODO(deadbeef): Decide the default destination in webrtcsession and
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000755// pass it down via SessionDescription.
Yves Gerey665174f2018-06-19 15:03:05 +0200756static void GetDefaultDestination(const std::vector<Candidate>& candidates,
757 int component_id,
758 std::string* port,
759 std::string* ip,
760 std::string* addr_type) {
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000761 *addr_type = kConnectionIpv4Addrtype;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000762 *port = kDummyPort;
763 *ip = kDummyAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000764 int current_preference = kPreferenceUnknown;
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000765 int current_family = AF_UNSPEC;
Steve Anton4daf66e2018-09-07 14:55:53 -0700766 for (const Candidate& candidate : candidates) {
767 if (candidate.component() != component_id) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000768 continue;
769 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000770 // Default destination should be UDP only.
Steve Anton4daf66e2018-09-07 14:55:53 -0700771 if (candidate.protocol() != cricket::UDP_PROTOCOL_NAME) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000772 continue;
773 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700774 const int preference = GetCandidatePreferenceFromType(candidate.type());
775 const int family = candidate.address().ipaddr().family();
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000776 // See if this candidate is more preferable then the current one if it's the
777 // same family. Or if the current family is IPv4 already so we could safely
778 // ignore all IPv6 ones. WebRTC bug 4269.
779 // http://code.google.com/p/webrtc/issues/detail?id=4269
780 if ((preference <= current_preference && current_family == family) ||
781 (current_family == AF_INET && family == AF_INET6)) {
782 continue;
783 }
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000784 if (family == AF_INET) {
785 addr_type->assign(kConnectionIpv4Addrtype);
786 } else if (family == AF_INET6) {
787 addr_type->assign(kConnectionIpv6Addrtype);
788 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000789 current_preference = preference;
790 current_family = family;
Steve Anton4daf66e2018-09-07 14:55:53 -0700791 *port = candidate.address().PortAsString();
792 *ip = candidate.address().ipaddr().ToString();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000793 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000794}
795
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000796// Gets "a=rtcp" line if found default RTCP candidate from |candidates|.
797static std::string GetRtcpLine(const std::vector<Candidate>& candidates) {
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000798 std::string rtcp_line, rtcp_port, rtcp_ip, addr_type;
Yves Gerey665174f2018-06-19 15:03:05 +0200799 GetDefaultDestination(candidates, ICE_CANDIDATE_COMPONENT_RTCP, &rtcp_port,
800 &rtcp_ip, &addr_type);
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000801 // Found default RTCP candidate.
802 // RFC 5245
803 // If the agent is utilizing RTCP, it MUST encode the RTCP candidate
804 // using the a=rtcp attribute as defined in RFC 3605.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000805
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000806 // RFC 3605
807 // rtcp-attribute = "a=rtcp:" port [nettype space addrtype space
808 // connection-address] CRLF
Jonas Olssonec9e4922018-09-05 09:53:49 +0200809 rtc::StringBuilder os;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000810 InitAttrLine(kAttributeRtcp, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200811 os << kSdpDelimiterColon << rtcp_port << " " << kConnectionNettype << " "
812 << addr_type << " " << rtcp_ip;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000813 rtcp_line = os.str();
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000814 return rtcp_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000815}
816
817// Get candidates according to the mline index from SessionDescriptionInterface.
818static void GetCandidatesByMindex(const SessionDescriptionInterface& desci,
819 int mline_index,
820 std::vector<Candidate>* candidates) {
821 if (!candidates) {
822 return;
823 }
824 const IceCandidateCollection* cc = desci.candidates(mline_index);
825 for (size_t i = 0; i < cc->count(); ++i) {
826 const IceCandidateInterface* candidate = cc->at(i);
827 candidates->push_back(candidate->candidate());
828 }
829}
830
deadbeef90f1e1e2017-02-10 12:35:05 -0800831static bool IsValidPort(int port) {
832 return port >= 0 && port <= 65535;
833}
834
Steve Antone831b8c2018-02-01 12:22:16 -0800835std::string SdpSerialize(const JsepSessionDescription& jdesc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000836 const cricket::SessionDescription* desc = jdesc.description();
837 if (!desc) {
838 return "";
839 }
840
841 std::string message;
842
843 // Session Description.
844 AddLine(kSessionVersion, &message);
845 // Session Origin
846 // RFC 4566
847 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
848 // <unicast-address>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200849 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000850 InitLine(kLineTypeOrigin, kSessionOriginUsername, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200851 const std::string& session_id =
852 jdesc.session_id().empty() ? kSessionOriginSessionId : jdesc.session_id();
853 const std::string& session_version = jdesc.session_version().empty()
854 ? kSessionOriginSessionVersion
855 : jdesc.session_version();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000856 os << " " << session_id << " " << session_version << " "
857 << kSessionOriginNettype << " " << kSessionOriginAddrtype << " "
858 << kSessionOriginAddress;
859 AddLine(os.str(), &message);
860 AddLine(kSessionName, &message);
861
862 // Time Description.
863 AddLine(kTimeDescription, &message);
864
865 // Group
866 if (desc->HasGroup(cricket::GROUP_TYPE_BUNDLE)) {
867 std::string group_line = kAttrGroup;
868 const cricket::ContentGroup* group =
869 desc->GetGroupByName(cricket::GROUP_TYPE_BUNDLE);
nisseede5da42017-01-12 05:15:36 -0800870 RTC_DCHECK(group != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700871 for (const std::string& content_name : group->content_names()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000872 group_line.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -0700873 group_line.append(content_name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000874 }
875 AddLine(group_line, &message);
876 }
877
Johannes Kron0854eb62018-10-10 22:33:20 +0200878 // Mixed one- and two-byte header extension.
Johannes Kron9581bc42018-10-23 10:17:39 +0200879 if (desc->extmap_allow_mixed()) {
Johannes Kron0854eb62018-10-10 22:33:20 +0200880 InitAttrLine(kAttributeExtmapAllowMixed, &os);
881 AddLine(os.str(), &message);
882 }
883
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000884 // MediaStream semantics
885 InitAttrLine(kAttributeMsidSemantics, &os);
886 os << kSdpDelimiterColon << " " << kMediaStreamSemantic;
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000887
Seth Hampson845e8782018-03-02 11:34:10 -0800888 std::set<std::string> media_stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000889 const ContentInfo* audio_content = GetFirstAudioContent(desc);
890 if (audio_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800891 GetMediaStreamIds(audio_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000892
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000893 const ContentInfo* video_content = GetFirstVideoContent(desc);
894 if (video_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800895 GetMediaStreamIds(video_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000896
Steve Anton4daf66e2018-09-07 14:55:53 -0700897 for (const std::string& id : media_stream_ids) {
898 os << " " << id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000899 }
900 AddLine(os.str(), &message);
901
Taylor Brandstetter2f65ec52018-05-24 11:37:28 -0700902 // a=ice-lite
903 //
904 // TODO(deadbeef): It's weird that we need to iterate TransportInfos for
905 // this, when it's a session-level attribute. It really should be moved to a
906 // session-level structure like SessionDescription.
907 for (const cricket::TransportInfo& transport : desc->transport_infos()) {
908 if (transport.description.ice_mode == cricket::ICEMODE_LITE) {
909 InitAttrLine(kAttributeIceLite, &os);
910 AddLine(os.str(), &message);
911 break;
912 }
913 }
914
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000915 // Preserve the order of the media contents.
916 int mline_index = -1;
Steve Anton4daf66e2018-09-07 14:55:53 -0700917 for (const ContentInfo& content : desc->contents()) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000918 std::vector<Candidate> candidates;
919 GetCandidatesByMindex(jdesc, ++mline_index, &candidates);
Steve Anton4daf66e2018-09-07 14:55:53 -0700920 BuildMediaDescription(&content, desc->GetTransportInfoByName(content.name),
921 content.media_description()->type(), candidates,
922 desc->msid_signaling(), &message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000923 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000924 return message;
925}
926
927// Serializes the passed in IceCandidateInterface to a SDP string.
928// candidate - The candidate to be serialized.
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700929std::string SdpSerializeCandidate(const IceCandidateInterface& candidate) {
930 return SdpSerializeCandidate(candidate.candidate());
931}
932
933// Serializes a cricket Candidate.
934std::string SdpSerializeCandidate(const cricket::Candidate& candidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000935 std::string message;
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700936 std::vector<cricket::Candidate> candidates(1, candidate);
honghaiza54a0802015-12-16 18:37:23 -0800937 BuildCandidate(candidates, true, &message);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000938 // From WebRTC draft section 4.8.1.1 candidate-attribute will be
939 // just candidate:<candidate> not a=candidate:<blah>CRLF
nisseede5da42017-01-12 05:15:36 -0800940 RTC_DCHECK(message.find("a=") == 0);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000941 message.erase(0, 2);
nisseede5da42017-01-12 05:15:36 -0800942 RTC_DCHECK(message.find(kLineBreak) == message.size() - 2);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000943 message.resize(message.size() - 2);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000944 return message;
945}
946
947bool SdpDeserialize(const std::string& message,
948 JsepSessionDescription* jdesc,
949 SdpParseError* error) {
950 std::string session_id;
951 std::string session_version;
Peter Thatcher7cbd1882015-09-17 18:54:52 -0700952 TransportDescription session_td("", "");
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000953 RtpHeaderExtensions session_extmaps;
zhihuang38989e52017-03-21 11:04:53 -0700954 rtc::SocketAddress session_connection_addr;
Mirko Bonadei317a1f02019-09-17 17:06:18 +0200955 auto desc = std::make_unique<cricket::SessionDescription>();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000956 size_t current_pos = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000957
958 // Session Description
959 if (!ParseSessionDescription(message, &current_pos, &session_id,
deadbeefc80741f2015-10-22 13:14:45 -0700960 &session_version, &session_td, &session_extmaps,
Steve Anton5a1de872018-12-18 11:25:55 -0800961 &session_connection_addr, desc.get(), error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000962 return false;
963 }
964
965 // Media Description
Steve Anton5a1de872018-12-18 11:25:55 -0800966 std::vector<std::unique_ptr<JsepIceCandidate>> candidates;
deadbeefc80741f2015-10-22 13:14:45 -0700967 if (!ParseMediaDescription(message, session_td, session_extmaps, &current_pos,
Steve Anton5a1de872018-12-18 11:25:55 -0800968 session_connection_addr, desc.get(), &candidates,
zhihuang38989e52017-03-21 11:04:53 -0700969 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000970 return false;
971 }
972
Harald Alvestrand4d7160e2019-04-12 07:01:29 +0200973 jdesc->Initialize(std::move(desc), session_id, session_version);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000974
Steve Anton5a1de872018-12-18 11:25:55 -0800975 for (const auto& candidate : candidates) {
976 jdesc->AddCandidate(candidate.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000977 }
978 return true;
979}
980
981bool SdpDeserializeCandidate(const std::string& message,
982 JsepIceCandidate* jcandidate,
983 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -0800984 RTC_DCHECK(jcandidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000985 Candidate candidate;
986 if (!ParseCandidate(message, &candidate, error, true)) {
987 return false;
988 }
989 jcandidate->SetCandidate(candidate);
990 return true;
991}
992
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700993bool SdpDeserializeCandidate(const std::string& transport_name,
994 const std::string& message,
995 cricket::Candidate* candidate,
996 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -0800997 RTC_DCHECK(candidate != nullptr);
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700998 if (!ParseCandidate(message, candidate, error, true)) {
999 return false;
1000 }
1001 candidate->set_transport_name(transport_name);
1002 return true;
1003}
1004
Yves Gerey665174f2018-06-19 15:03:05 +02001005bool ParseCandidate(const std::string& message,
1006 Candidate* candidate,
1007 SdpParseError* error,
1008 bool is_raw) {
nisseede5da42017-01-12 05:15:36 -08001009 RTC_DCHECK(candidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001010
1011 // Get the first line from |message|.
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001012 std::string first_line = message;
1013 size_t pos = 0;
1014 GetLine(message, &pos, &first_line);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001015
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001016 // Makes sure |message| contains only one line.
1017 if (message.size() > first_line.size()) {
1018 std::string left, right;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001019 if (rtc::tokenize_first(message, kNewLineChar, &left, &right) &&
Donald Curtis0e07f922015-05-15 09:21:23 -07001020 !right.empty()) {
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001021 return ParseFailed(message, 0, "Expect one line only", error);
1022 }
1023 }
1024
1025 // From WebRTC draft section 4.8.1.1 candidate-attribute should be
1026 // candidate:<candidate> when trickled, but we still support
1027 // a=candidate:<blah>CRLF for backward compatibility and for parsing a line
1028 // from the SDP.
1029 if (IsLineType(first_line, kLineTypeAttributes)) {
1030 first_line = first_line.substr(kLinePrefixLength);
1031 }
1032
1033 std::string attribute_candidate;
1034 std::string candidate_value;
1035
1036 // |first_line| must be in the form of "candidate:<value>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001037 if (!rtc::tokenize_first(first_line, kSdpDelimiterColonChar,
1038 &attribute_candidate, &candidate_value) ||
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001039 attribute_candidate != kAttributeCandidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001040 if (is_raw) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001041 rtc::StringBuilder description;
Jonas Olssonb2b20312020-01-14 12:11:31 +01001042 description << "Expect line: " << kAttributeCandidate
1043 << ":"
1044 "<candidate-str>";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001045 return ParseFailed(first_line, 0, description.str(), error);
1046 } else {
1047 return ParseFailedExpectLine(first_line, 0, kLineTypeAttributes,
1048 kAttributeCandidate, error);
1049 }
1050 }
1051
1052 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001053 rtc::split(candidate_value, kSdpDelimiterSpaceChar, &fields);
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001054
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001055 // RFC 5245
1056 // a=candidate:<foundation> <component-id> <transport> <priority>
1057 // <connection-address> <port> typ <candidate-types>
1058 // [raddr <connection-address>] [rport <port>]
1059 // *(SP extension-att-name SP extension-att-value)
1060 const size_t expected_min_fields = 8;
1061 if (fields.size() < expected_min_fields ||
1062 (fields[6] != kAttributeCandidateTyp)) {
1063 return ParseFailedExpectMinFieldNum(first_line, expected_min_fields, error);
1064 }
jbauch083b73f2015-07-16 02:46:32 -07001065 const std::string& foundation = fields[0];
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001066
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001067 int component_id = 0;
1068 if (!GetValueFromString(first_line, fields[1], &component_id, error)) {
1069 return false;
1070 }
jbauch083b73f2015-07-16 02:46:32 -07001071 const std::string& transport = fields[2];
Peter Boström0c4e06b2015-10-07 12:23:21 +02001072 uint32_t priority = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001073 if (!GetValueFromString(first_line, fields[3], &priority, error)) {
1074 return false;
1075 }
jbauch083b73f2015-07-16 02:46:32 -07001076 const std::string& connection_address = fields[4];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001077 int port = 0;
1078 if (!GetValueFromString(first_line, fields[5], &port, error)) {
1079 return false;
1080 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001081 if (!IsValidPort(port)) {
1082 return ParseFailed(first_line, "Invalid port number.", error);
1083 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001084 SocketAddress address(connection_address, port);
1085
1086 cricket::ProtocolType protocol;
hnslb68cc752016-12-13 10:33:41 -08001087 if (!StringToProto(transport.c_str(), &protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001088 return ParseFailed(first_line, "Unsupported transport type.", error);
1089 }
Taylor Brandstetter8206bc02020-04-02 12:36:38 -07001090 bool tcp_protocol = false;
hnslb68cc752016-12-13 10:33:41 -08001091 switch (protocol) {
Taylor Brandstetter8206bc02020-04-02 12:36:38 -07001092 // Supported protocols.
hnslb68cc752016-12-13 10:33:41 -08001093 case cricket::PROTO_UDP:
Taylor Brandstetter8206bc02020-04-02 12:36:38 -07001094 break;
hnslb68cc752016-12-13 10:33:41 -08001095 case cricket::PROTO_TCP:
1096 case cricket::PROTO_SSLTCP:
Taylor Brandstetter8206bc02020-04-02 12:36:38 -07001097 tcp_protocol = true;
hnslb68cc752016-12-13 10:33:41 -08001098 break;
1099 default:
1100 return ParseFailed(first_line, "Unsupported transport type.", error);
1101 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001102
1103 std::string candidate_type;
jbauch083b73f2015-07-16 02:46:32 -07001104 const std::string& type = fields[7];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001105 if (type == kCandidateHost) {
1106 candidate_type = cricket::LOCAL_PORT_TYPE;
1107 } else if (type == kCandidateSrflx) {
1108 candidate_type = cricket::STUN_PORT_TYPE;
1109 } else if (type == kCandidateRelay) {
1110 candidate_type = cricket::RELAY_PORT_TYPE;
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001111 } else if (type == kCandidatePrflx) {
1112 candidate_type = cricket::PRFLX_PORT_TYPE;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001113 } else {
1114 return ParseFailed(first_line, "Unsupported candidate type.", error);
1115 }
1116
1117 size_t current_position = expected_min_fields;
1118 SocketAddress related_address;
1119 // The 2 optional fields for related address
1120 // [raddr <connection-address>] [rport <port>]
1121 if (fields.size() >= (current_position + 2) &&
1122 fields[current_position] == kAttributeCandidateRaddr) {
1123 related_address.SetIP(fields[++current_position]);
1124 ++current_position;
1125 }
1126 if (fields.size() >= (current_position + 2) &&
1127 fields[current_position] == kAttributeCandidateRport) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001128 int port = 0;
Yves Gerey665174f2018-06-19 15:03:05 +02001129 if (!GetValueFromString(first_line, fields[++current_position], &port,
1130 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001131 return false;
1132 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001133 if (!IsValidPort(port)) {
1134 return ParseFailed(first_line, "Invalid port number.", error);
1135 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001136 related_address.SetPort(port);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001137 ++current_position;
1138 }
1139
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001140 // If this is a TCP candidate, it has additional extension as defined in
1141 // RFC 6544.
1142 std::string tcptype;
1143 if (fields.size() >= (current_position + 2) &&
1144 fields[current_position] == kTcpCandidateType) {
1145 tcptype = fields[++current_position];
1146 ++current_position;
1147
1148 if (tcptype != cricket::TCPTYPE_ACTIVE_STR &&
1149 tcptype != cricket::TCPTYPE_PASSIVE_STR &&
1150 tcptype != cricket::TCPTYPE_SIMOPEN_STR) {
1151 return ParseFailed(first_line, "Invalid TCP candidate type.", error);
1152 }
1153
Taylor Brandstetter8206bc02020-04-02 12:36:38 -07001154 if (!tcp_protocol) {
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001155 return ParseFailed(first_line, "Invalid non-TCP candidate", error);
1156 }
Taylor Brandstetter8206bc02020-04-02 12:36:38 -07001157 } else if (tcp_protocol) {
1158 // We allow the tcptype to be missing, for backwards compatibility,
1159 // treating it as a passive candidate.
1160 // TODO(bugs.webrtc.org/11466): Treat a missing tcptype as an error?
1161 tcptype = cricket::TCPTYPE_PASSIVE_STR;
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001162 }
1163
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001164 // Extension
honghaiza54a0802015-12-16 18:37:23 -08001165 // Though non-standard, we support the ICE ufrag and pwd being signaled on
1166 // the candidate to avoid issues with confusing which generation a candidate
1167 // belongs to when trickling multiple generations at the same time.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001168 std::string username;
1169 std::string password;
Peter Boström0c4e06b2015-10-07 12:23:21 +02001170 uint32_t generation = 0;
honghaiza0c44ea2016-03-23 16:07:48 -07001171 uint16_t network_id = 0;
1172 uint16_t network_cost = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001173 for (size_t i = current_position; i + 1 < fields.size(); ++i) {
1174 // RFC 5245
1175 // *(SP extension-att-name SP extension-att-value)
1176 if (fields[i] == kAttributeCandidateGeneration) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001177 if (!GetValueFromString(first_line, fields[++i], &generation, error)) {
1178 return false;
1179 }
honghaiza54a0802015-12-16 18:37:23 -08001180 } else if (fields[i] == kAttributeCandidateUfrag) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001181 username = fields[++i];
honghaiza54a0802015-12-16 18:37:23 -08001182 } else if (fields[i] == kAttributeCandidatePwd) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001183 password = fields[++i];
honghaiza0c44ea2016-03-23 16:07:48 -07001184 } else if (fields[i] == kAttributeCandidateNetworkId) {
1185 if (!GetValueFromString(first_line, fields[++i], &network_id, error)) {
1186 return false;
1187 }
honghaize1a0c942016-02-16 14:54:56 -08001188 } else if (fields[i] == kAttributeCandidateNetworkCost) {
1189 if (!GetValueFromString(first_line, fields[++i], &network_cost, error)) {
1190 return false;
1191 }
Honghai Zhang351d77b2016-05-20 15:08:29 -07001192 network_cost = std::min(network_cost, rtc::kNetworkCostMax);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001193 } else {
1194 // Skip the unknown extension.
1195 ++i;
1196 }
1197 }
1198
guoweis@webrtc.org61c12472015-01-15 06:53:07 +00001199 *candidate = Candidate(component_id, cricket::ProtoToString(protocol),
guoweis@webrtc.org950c5182014-12-16 23:01:31 +00001200 address, priority, username, password, candidate_type,
honghaiza0c44ea2016-03-23 16:07:48 -07001201 generation, foundation, network_id, network_cost);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001202 candidate->set_related_address(related_address);
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001203 candidate->set_tcptype(tcptype);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001204 return true;
1205}
1206
1207bool ParseIceOptions(const std::string& line,
1208 std::vector<std::string>* transport_options,
1209 SdpParseError* error) {
1210 std::string ice_options;
1211 if (!GetValue(line, kAttributeIceOption, &ice_options, error)) {
1212 return false;
1213 }
1214 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001215 rtc::split(ice_options, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001216 for (size_t i = 0; i < fields.size(); ++i) {
1217 transport_options->push_back(fields[i]);
1218 }
1219 return true;
1220}
1221
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001222bool ParseSctpPort(const std::string& line,
1223 int* sctp_port,
1224 SdpParseError* error) {
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02001225 // draft-ietf-mmusic-sctp-sdp-26
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001226 // a=sctp-port
1227 std::vector<std::string> fields;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001228 const size_t expected_min_fields = 2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001229 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
lally69f57602015-10-08 10:15:04 -07001230 if (fields.size() < expected_min_fields) {
1231 fields.resize(0);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001232 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
lally69f57602015-10-08 10:15:04 -07001233 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001234 if (fields.size() < expected_min_fields) {
1235 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1236 }
1237 if (!rtc::FromString(fields[1], sctp_port)) {
lally69f57602015-10-08 10:15:04 -07001238 return ParseFailed(line, "Invalid sctp port value.", error);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001239 }
1240 return true;
1241}
1242
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02001243bool ParseSctpMaxMessageSize(const std::string& line,
1244 int* max_message_size,
1245 SdpParseError* error) {
1246 // draft-ietf-mmusic-sctp-sdp-26
1247 // a=max-message-size:199999
1248 std::vector<std::string> fields;
1249 const size_t expected_min_fields = 2;
1250 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
1251 if (fields.size() < expected_min_fields) {
1252 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1253 }
1254 if (!rtc::FromString(fields[1], max_message_size)) {
1255 return ParseFailed(line, "Invalid SCTP max message size.", error);
1256 }
1257 return true;
1258}
1259
isheriff6f8d6862016-05-26 11:24:55 -07001260bool ParseExtmap(const std::string& line,
1261 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001262 SdpParseError* error) {
1263 // RFC 5285
1264 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1265 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001266 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001267 const size_t expected_min_fields = 2;
1268 if (fields.size() < expected_min_fields) {
1269 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1270 }
1271 std::string uri = fields[1];
1272
1273 std::string value_direction;
1274 if (!GetValue(fields[0], kAttributeExtmap, &value_direction, error)) {
1275 return false;
1276 }
1277 std::vector<std::string> sub_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001278 rtc::split(value_direction, kSdpDelimiterSlashChar, &sub_fields);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001279 int value = 0;
1280 if (!GetValueFromString(line, sub_fields[0], &value, error)) {
1281 return false;
1282 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001283
jbauch5869f502017-06-29 12:31:36 -07001284 bool encrypted = false;
1285 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1286 // RFC 6904
Steve Anton36b29d12017-10-30 09:57:42 -07001287 // a=extmap:<value["/"<direction>] urn:ietf:params:rtp-hdrext:encrypt <URI>
1288 // <extensionattributes>
jbauch5869f502017-06-29 12:31:36 -07001289 const size_t expected_min_fields_encrypted = expected_min_fields + 1;
1290 if (fields.size() < expected_min_fields_encrypted) {
1291 return ParseFailedExpectMinFieldNum(line, expected_min_fields_encrypted,
Yves Gerey665174f2018-06-19 15:03:05 +02001292 error);
jbauch5869f502017-06-29 12:31:36 -07001293 }
1294
1295 encrypted = true;
1296 uri = fields[2];
1297 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1298 return ParseFailed(line, "Recursive encrypted header.", error);
1299 }
1300 }
1301
1302 *extmap = RtpExtension(uri, value, encrypted);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001303 return true;
1304}
1305
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +02001306static void BuildSctpContentAttributes(
1307 std::string* message,
1308 const cricket::SctpDataContentDescription* data_desc) {
1309 rtc::StringBuilder os;
1310 if (data_desc->use_sctpmap()) {
1311 // draft-ietf-mmusic-sctp-sdp-04
1312 // a=sctpmap:sctpmap-number protocol [streams]
1313 rtc::StringBuilder os;
1314 InitAttrLine(kAttributeSctpmap, &os);
1315 os << kSdpDelimiterColon << data_desc->port() << kSdpDelimiterSpace
1316 << kDefaultSctpmapProtocol << kSdpDelimiterSpace
1317 << cricket::kMaxSctpStreams;
1318 AddLine(os.str(), message);
1319 } else {
1320 // draft-ietf-mmusic-sctp-sdp-23
1321 // a=sctp-port:<port>
1322 InitAttrLine(kAttributeSctpPort, &os);
1323 os << kSdpDelimiterColon << data_desc->port();
1324 AddLine(os.str(), message);
1325 if (data_desc->max_message_size() != kDefaultSctpMaxMessageSize) {
1326 InitAttrLine(kAttributeMaxMessageSize, &os);
1327 os << kSdpDelimiterColon << data_desc->max_message_size();
1328 AddLine(os.str(), message);
1329 }
1330 }
1331}
1332
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001333void BuildMediaDescription(const ContentInfo* content_info,
1334 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001335 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001336 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -08001337 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001338 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001339 RTC_DCHECK(message != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001340 if (content_info == NULL || message == NULL) {
1341 return;
1342 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001343 rtc::StringBuilder os;
Steve Antonb1c1de12017-12-21 15:14:30 -08001344 const MediaContentDescription* media_desc = content_info->media_description();
1345 RTC_DCHECK(media_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001346
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001347 // RFC 4566
1348 // m=<media> <port> <proto> <fmt>
1349 // fmt is a list of payload type numbers that MAY be used in the session.
Philipp Hancke4e8c1152020-10-13 12:43:15 +02001350 std::string type;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001351 std::string fmt;
1352 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Philipp Hancke4e8c1152020-10-13 12:43:15 +02001353 type = kMediaTypeVideo;
Steve Antonb1c1de12017-12-21 15:14:30 -08001354 const VideoContentDescription* video_desc = media_desc->as_video();
Steve Anton4daf66e2018-09-07 14:55:53 -07001355 for (const cricket::VideoCodec& codec : video_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001356 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001357 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001358 }
1359 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Philipp Hancke4e8c1152020-10-13 12:43:15 +02001360 type = kMediaTypeAudio;
Steve Antonb1c1de12017-12-21 15:14:30 -08001361 const AudioContentDescription* audio_desc = media_desc->as_audio();
Steve Anton4daf66e2018-09-07 14:55:53 -07001362 for (const cricket::AudioCodec& codec : audio_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001363 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001364 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001365 }
1366 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Philipp Hancke4e8c1152020-10-13 12:43:15 +02001367 type = kMediaTypeData;
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001368 const cricket::SctpDataContentDescription* sctp_data_desc =
1369 media_desc->as_sctp();
1370 if (sctp_data_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001371 fmt.append(" ");
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001372
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001373 if (sctp_data_desc->use_sctpmap()) {
1374 fmt.append(rtc::ToString(sctp_data_desc->port()));
zstein4b2e0822017-02-17 19:48:38 -08001375 } else {
1376 fmt.append(kDefaultSctpmapProtocol);
1377 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001378 } else {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001379 const RtpDataContentDescription* rtp_data_desc =
1380 media_desc->as_rtp_data();
1381 for (const cricket::RtpDataCodec& codec : rtp_data_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001382 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001383 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001384 }
1385 }
Philipp Hancke4e8c1152020-10-13 12:43:15 +02001386 } else if (media_type == cricket::MEDIA_TYPE_UNSUPPORTED) {
1387 const UnsupportedContentDescription* unsupported_desc =
1388 media_desc->as_unsupported();
1389 type = unsupported_desc->media_type();
1390 } else {
1391 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001392 }
1393 // The fmt must never be empty. If no codecs are found, set the fmt attribute
1394 // to 0.
1395 if (fmt.empty()) {
1396 fmt = " 0";
1397 }
1398
deadbeef25ed4352016-12-12 18:37:36 -08001399 // The port number in the m line will be updated later when associated with
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001400 // the candidates.
deadbeef25ed4352016-12-12 18:37:36 -08001401 //
1402 // A port value of 0 indicates that the m= section is rejected.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001403 // RFC 3264
1404 // To reject an offered stream, the port number in the corresponding stream in
1405 // the answer MUST be set to zero.
deadbeef25ed4352016-12-12 18:37:36 -08001406 //
1407 // However, the BUNDLE draft adds a new meaning to port zero, when used along
1408 // with a=bundle-only.
zhihuang38989e52017-03-21 11:04:53 -07001409 std::string port = kDummyPort;
1410 if (content_info->rejected || content_info->bundle_only) {
1411 port = kMediaPortRejected;
1412 } else if (!media_desc->connection_address().IsNil()) {
1413 port = rtc::ToString(media_desc->connection_address().port());
1414 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001415
Yves Gerey665174f2018-06-19 15:03:05 +02001416 rtc::SSLFingerprint* fp =
1417 (transport_info) ? transport_info->description.identity_fingerprint.get()
1418 : NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001419
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001420 // Add the m and c lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001421 InitLine(kLineTypeMedia, type, &os);
1422 os << " " << port << " " << media_desc->protocol() << fmt;
zhihuang38989e52017-03-21 11:04:53 -07001423 AddLine(os.str(), message);
1424
1425 InitLine(kLineTypeConnection, kConnectionNettype, &os);
1426 if (media_desc->connection_address().IsNil()) {
1427 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
1428 } else if (media_desc->connection_address().family() == AF_INET) {
1429 os << " " << kConnectionIpv4Addrtype << " "
1430 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 12:53:06 -08001431 } else if (media_desc->connection_address().family() == AF_INET6) {
zhihuang38989e52017-03-21 11:04:53 -07001432 os << " " << kConnectionIpv6Addrtype << " "
1433 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 12:53:06 -08001434 } else {
1435 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
zhihuang38989e52017-03-21 11:04:53 -07001436 }
1437 AddLine(os.str(), message);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001438
1439 // RFC 4566
Taylor Brandstetteree8c2462020-07-27 15:52:02 -07001440 // b=AS:<bandwidth> or
1441 // b=TIAS:<bandwidth>
1442 int bandwidth = media_desc->bandwidth();
1443 std::string bandwidth_type = media_desc->bandwidth_type();
1444 if (bandwidth_type == kApplicationSpecificBandwidth && bandwidth >= 1000) {
1445 InitLine(kLineTypeSessionBandwidth, bandwidth_type, &os);
1446 bandwidth /= 1000;
1447 os << kSdpDelimiterColon << bandwidth;
1448 AddLine(os.str(), message);
1449 } else if (bandwidth_type == kTransportSpecificBandwidth && bandwidth > 0) {
1450 InitLine(kLineTypeSessionBandwidth, bandwidth_type, &os);
1451 os << kSdpDelimiterColon << bandwidth;
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001452 AddLine(os.str(), message);
1453 }
1454
deadbeef25ed4352016-12-12 18:37:36 -08001455 // Add the a=bundle-only line.
1456 if (content_info->bundle_only) {
1457 InitAttrLine(kAttributeBundleOnly, &os);
1458 AddLine(os.str(), message);
1459 }
1460
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001461 // Add the a=rtcp line.
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001462 if (cricket::IsRtpProtocol(media_desc->protocol())) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001463 std::string rtcp_line = GetRtcpLine(candidates);
1464 if (!rtcp_line.empty()) {
1465 AddLine(rtcp_line, message);
1466 }
1467 }
1468
honghaiza54a0802015-12-16 18:37:23 -08001469 // Build the a=candidate lines. We don't include ufrag and pwd in the
1470 // candidates in the SDP to avoid redundancy.
1471 BuildCandidate(candidates, false, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001472
1473 // Use the transport_info to build the media level ice-ufrag and ice-pwd.
1474 if (transport_info) {
1475 // RFC 5245
1476 // ice-pwd-att = "ice-pwd" ":" password
1477 // ice-ufrag-att = "ice-ufrag" ":" ufrag
1478 // ice-ufrag
deadbeef3f7219b2015-12-28 15:17:14 -08001479 if (!transport_info->description.ice_ufrag.empty()) {
1480 InitAttrLine(kAttributeIceUfrag, &os);
1481 os << kSdpDelimiterColon << transport_info->description.ice_ufrag;
1482 AddLine(os.str(), message);
1483 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001484 // ice-pwd
deadbeef3f7219b2015-12-28 15:17:14 -08001485 if (!transport_info->description.ice_pwd.empty()) {
1486 InitAttrLine(kAttributeIcePwd, &os);
1487 os << kSdpDelimiterColon << transport_info->description.ice_pwd;
1488 AddLine(os.str(), message);
1489 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001490
1491 // draft-petithuguenin-mmusic-ice-attributes-level-03
1492 BuildIceOptions(transport_info->description.transport_options, message);
1493
1494 // RFC 4572
1495 // fingerprint-attribute =
1496 // "fingerprint" ":" hash-func SP fingerprint
1497 if (fp) {
1498 // Insert the fingerprint attribute.
1499 InitAttrLine(kAttributeFingerprint, &os);
Yves Gerey665174f2018-06-19 15:03:05 +02001500 os << kSdpDelimiterColon << fp->algorithm << kSdpDelimiterSpace
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001501 << fp->GetRfc4572Fingerprint();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001502 AddLine(os.str(), message);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001503
1504 // Inserting setup attribute.
1505 if (transport_info->description.connection_role !=
Yves Gerey665174f2018-06-19 15:03:05 +02001506 cricket::CONNECTIONROLE_NONE) {
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001507 // Making sure we are not using "passive" mode.
1508 cricket::ConnectionRole role =
1509 transport_info->description.connection_role;
mallinath@webrtc.org19f27e62013-10-13 17:18:27 +00001510 std::string dtls_role_str;
nissec16fa5e2017-02-07 07:18:43 -08001511 const bool success =
1512 cricket::ConnectionRoleToString(role, &dtls_role_str);
1513 RTC_DCHECK(success);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001514 InitAttrLine(kAttributeSetup, &os);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001515 os << kSdpDelimiterColon << dtls_role_str;
1516 AddLine(os.str(), message);
1517 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001518 }
1519 }
1520
1521 // RFC 3388
1522 // mid-attribute = "a=mid:" identification-tag
1523 // identification-tag = token
1524 // Use the content name as the mid identification-tag.
1525 InitAttrLine(kAttributeMid, &os);
1526 os << kSdpDelimiterColon << content_info->name;
1527 AddLine(os.str(), message);
1528
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001529 if (cricket::IsDtlsSctp(media_desc->protocol())) {
1530 const cricket::SctpDataContentDescription* data_desc =
1531 media_desc->as_sctp();
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +02001532 BuildSctpContentAttributes(message, data_desc);
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001533 } else if (cricket::IsRtpProtocol(media_desc->protocol())) {
Steve Antone831b8c2018-02-01 12:22:16 -08001534 BuildRtpContentAttributes(media_desc, media_type, msid_signaling, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001535 }
1536}
1537
deadbeef9d3584c2016-02-16 17:54:10 -08001538void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001539 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -08001540 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -08001541 std::string* message) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001542 SdpSerializer serializer;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001543 rtc::StringBuilder os;
Johannes Kron0854eb62018-10-10 22:33:20 +02001544 // RFC 8285
1545 // a=extmap-allow-mixed
1546 // The attribute MUST be either on session level or media level. We support
1547 // responding on both levels, however, we don't respond on media level if it's
1548 // set on session level.
Johannes Kron9581bc42018-10-23 10:17:39 +02001549 if (media_desc->extmap_allow_mixed_enum() ==
Johannes Kron0854eb62018-10-10 22:33:20 +02001550 MediaContentDescription::kMedia) {
1551 InitAttrLine(kAttributeExtmapAllowMixed, &os);
1552 AddLine(os.str(), message);
1553 }
1554 // RFC 8285
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001555 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1556 // The definitions MUST be either all session level or all media level. This
1557 // implementation uses all media level.
1558 for (size_t i = 0; i < media_desc->rtp_header_extensions().size(); ++i) {
jbauch5869f502017-06-29 12:31:36 -07001559 const RtpExtension& extension = media_desc->rtp_header_extensions()[i];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001560 InitAttrLine(kAttributeExtmap, &os);
jbauch5869f502017-06-29 12:31:36 -07001561 os << kSdpDelimiterColon << extension.id;
1562 if (extension.encrypt) {
1563 os << kSdpDelimiterSpace << RtpExtension::kEncryptHeaderExtensionsUri;
1564 }
1565 os << kSdpDelimiterSpace << extension.uri;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001566 AddLine(os.str(), message);
1567 }
1568
1569 // RFC 3264
1570 // a=sendrecv || a=sendonly || a=sendrecv || a=inactive
deadbeefc80741f2015-10-22 13:14:45 -07001571 switch (media_desc->direction()) {
Harald Alvestrand6060df52020-08-11 09:54:02 +02001572 // Special case that for sdp purposes should be treated same as inactive.
1573 case RtpTransceiverDirection::kStopped:
Steve Anton4e70a722017-11-28 14:57:10 -08001574 case RtpTransceiverDirection::kInactive:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001575 InitAttrLine(kAttributeInactive, &os);
1576 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001577 case RtpTransceiverDirection::kSendOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001578 InitAttrLine(kAttributeSendOnly, &os);
1579 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001580 case RtpTransceiverDirection::kRecvOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001581 InitAttrLine(kAttributeRecvOnly, &os);
1582 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001583 case RtpTransceiverDirection::kSendRecv:
Markus Handell45c104b2020-03-11 10:51:13 +01001584 InitAttrLine(kAttributeSendRecv, &os);
1585 break;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001586 default:
Markus Handell45c104b2020-03-11 10:51:13 +01001587 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001588 InitAttrLine(kAttributeSendRecv, &os);
1589 break;
1590 }
1591 AddLine(os.str(), message);
1592
Seth Hampson5b4f0752018-04-02 16:31:36 -07001593 // Specified in https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
1594 // a=msid:<msid-id> <msid-appdata>
1595 // The msid-id is a 1*64 token char representing the media stream id, and the
1596 // msid-appdata is a 1*64 token char representing the track id. There is a
1597 // line for every media stream, with a special msid-id value of "-"
1598 // representing no streams. The value of "msid-appdata" MUST be identical for
1599 // all lines.
Steve Antone831b8c2018-02-01 12:22:16 -08001600 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
1601 const StreamParamsVec& streams = media_desc->streams();
1602 if (streams.size() == 1u) {
1603 const StreamParams& track = streams[0];
Seth Hampson5b4f0752018-04-02 16:31:36 -07001604 std::vector<std::string> stream_ids = track.stream_ids();
1605 if (stream_ids.empty()) {
1606 stream_ids.push_back(kNoStreamMsid);
1607 }
1608 for (const std::string& stream_id : stream_ids) {
1609 InitAttrLine(kAttributeMsid, &os);
1610 os << kSdpDelimiterColon << stream_id << kSdpDelimiterSpace << track.id;
1611 AddLine(os.str(), message);
1612 }
Steve Antone831b8c2018-02-01 12:22:16 -08001613 } else if (streams.size() > 1u) {
1614 RTC_LOG(LS_WARNING)
1615 << "Trying to serialize Unified Plan SDP with more than "
Jonas Olsson45cc8902018-02-13 10:37:07 +01001616 "one track in a media section. Omitting 'a=msid'.";
deadbeef9d3584c2016-02-16 17:54:10 -08001617 }
1618 }
1619
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001620 // RFC 5761
1621 // a=rtcp-mux
1622 if (media_desc->rtcp_mux()) {
1623 InitAttrLine(kAttributeRtcpMux, &os);
1624 AddLine(os.str(), message);
1625 }
1626
deadbeef13871492015-12-09 12:37:51 -08001627 // RFC 5506
1628 // a=rtcp-rsize
1629 if (media_desc->rtcp_reduced_size()) {
1630 InitAttrLine(kAttributeRtcpReducedSize, &os);
1631 AddLine(os.str(), message);
1632 }
1633
deadbeefd45aea82017-09-16 01:24:29 -07001634 if (media_desc->conference_mode()) {
1635 InitAttrLine(kAttributeXGoogleFlag, &os);
1636 os << kSdpDelimiterColon << kValueConference;
1637 AddLine(os.str(), message);
1638 }
1639
Sebastian Janssone1795f42019-07-24 11:38:03 +02001640 if (media_desc->remote_estimate()) {
1641 InitAttrLine(kAttributeRtcpRemoteEstimate, &os);
1642 AddLine(os.str(), message);
1643 }
1644
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001645 // RFC 4568
1646 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001647 for (const CryptoParams& crypto_params : media_desc->cryptos()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001648 InitAttrLine(kAttributeCrypto, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001649 os << kSdpDelimiterColon << crypto_params.tag << " "
1650 << crypto_params.cipher_suite << " " << crypto_params.key_params;
1651 if (!crypto_params.session_params.empty()) {
1652 os << " " << crypto_params.session_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001653 }
1654 AddLine(os.str(), message);
1655 }
1656
1657 // RFC 4566
1658 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1659 // [/<encodingparameters>]
1660 BuildRtpMap(media_desc, media_type, message);
1661
Steve Anton4daf66e2018-09-07 14:55:53 -07001662 for (const StreamParams& track : media_desc->streams()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001663 // Build the ssrc-group lines.
Steve Anton4daf66e2018-09-07 14:55:53 -07001664 for (const SsrcGroup& ssrc_group : track.ssrc_groups) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001665 // RFC 5576
1666 // a=ssrc-group:<semantics> <ssrc-id> ...
Steve Anton4daf66e2018-09-07 14:55:53 -07001667 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001668 continue;
1669 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001670 InitAttrLine(kAttributeSsrcGroup, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001671 os << kSdpDelimiterColon << ssrc_group.semantics;
1672 for (uint32_t ssrc : ssrc_group.ssrcs) {
1673 os << kSdpDelimiterSpace << rtc::ToString(ssrc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001674 }
1675 AddLine(os.str(), message);
1676 }
1677 // Build the ssrc lines for each ssrc.
Steve Anton4daf66e2018-09-07 14:55:53 -07001678 for (uint32_t ssrc : track.ssrcs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001679 // RFC 5576
1680 // a=ssrc:<ssrc-id> cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07001681 AddSsrcLine(ssrc, kSsrcAttributeCname, track.cname, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001682
Steve Antone831b8c2018-02-01 12:22:16 -08001683 if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
1684 // draft-alvestrand-mmusic-msid-00
1685 // a=ssrc:<ssrc-id> msid:identifier [appdata]
1686 // The appdata consists of the "id" attribute of a MediaStreamTrack,
1687 // which corresponds to the "id" attribute of StreamParams.
Seth Hampson5b4f0752018-04-02 16:31:36 -07001688 // Since a=ssrc msid signaling is used in Plan B SDP semantics, and
1689 // multiple stream ids are not supported for Plan B, we are only adding
1690 // a line for the first media stream id here.
Seth Hampson7fa6ee62018-10-17 10:25:28 -07001691 const std::string& track_stream_id = track.first_stream_id();
1692 // We use a special msid-id value of "-" to represent no streams,
1693 // for Unified Plan compatibility. Plan B will always have a
1694 // track_stream_id.
1695 const std::string& stream_id =
1696 track_stream_id.empty() ? kNoStreamMsid : track_stream_id;
Steve Antone831b8c2018-02-01 12:22:16 -08001697 InitAttrLine(kAttributeSsrc, &os);
1698 os << kSdpDelimiterColon << ssrc << kSdpDelimiterSpace
1699 << kSsrcAttributeMsid << kSdpDelimiterColon << stream_id
Steve Anton4daf66e2018-09-07 14:55:53 -07001700 << kSdpDelimiterSpace << track.id;
Steve Antone831b8c2018-02-01 12:22:16 -08001701 AddLine(os.str(), message);
Artem Titovf0a34f22020-03-16 17:52:04 +00001702
1703 // TODO(ronghuawu): Remove below code which is for backward
1704 // compatibility.
1705 // draft-alvestrand-rtcweb-mid-01
1706 // a=ssrc:<ssrc-id> mslabel:<value>
1707 // The label isn't yet defined.
1708 // a=ssrc:<ssrc-id> label:<value>
1709 AddSsrcLine(ssrc, kSsrcAttributeMslabel, stream_id, message);
1710 AddSsrcLine(ssrc, kSSrcAttributeLabel, track.id, message);
Steve Antone831b8c2018-02-01 12:22:16 -08001711 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001712 }
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001713
1714 // Build the rid lines for each layer of the track
1715 for (const RidDescription& rid_description : track.rids()) {
1716 InitAttrLine(kAttributeRid, &os);
1717 os << kSdpDelimiterColon
1718 << serializer.SerializeRidDescription(rid_description);
1719 AddLine(os.str(), message);
1720 }
1721 }
1722
Florent Castellib60141b2019-07-03 12:47:54 +02001723 for (const RidDescription& rid_description : media_desc->receive_rids()) {
1724 InitAttrLine(kAttributeRid, &os);
1725 os << kSdpDelimiterColon
1726 << serializer.SerializeRidDescription(rid_description);
1727 AddLine(os.str(), message);
1728 }
1729
Amit Hilbucha2012042018-12-03 11:35:05 -08001730 // Simulcast (a=simulcast)
1731 // https://tools.ietf.org/html/draft-ietf-mmusic-sdp-simulcast-13#section-5.1
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001732 if (media_desc->HasSimulcast()) {
1733 const auto& simulcast = media_desc->simulcast_description();
Amit Hilbucha2012042018-12-03 11:35:05 -08001734 InitAttrLine(kAttributeSimulcast, &os);
Amit Hilbucha2012042018-12-03 11:35:05 -08001735 os << kSdpDelimiterColon
1736 << serializer.SerializeSimulcastDescription(simulcast);
1737 AddLine(os.str(), message);
1738 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001739}
1740
Jonas Olssonec9e4922018-09-05 09:53:49 +02001741void WriteFmtpHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001742 // fmtp header: a=fmtp:|payload_type| <parameters>
1743 // Add a=fmtp
1744 InitAttrLine(kAttributeFmtp, os);
1745 // Add :|payload_type|
1746 *os << kSdpDelimiterColon << payload_type;
1747}
1748
Mirta Dvornicic479a3c02019-06-04 15:38:50 +02001749void WritePacketizationHeader(int payload_type, rtc::StringBuilder* os) {
1750 // packetization header: a=packetization:|payload_type| <packetization_format>
1751 // Add a=packetization
1752 InitAttrLine(kAttributePacketization, os);
1753 // Add :|payload_type|
1754 *os << kSdpDelimiterColon << payload_type;
1755}
1756
Jonas Olssonec9e4922018-09-05 09:53:49 +02001757void WriteRtcpFbHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001758 // rtcp-fb header: a=rtcp-fb:|payload_type|
1759 // <parameters>/<ccm <ccm_parameters>>
1760 // Add a=rtcp-fb
1761 InitAttrLine(kAttributeRtcpFb, os);
1762 // Add :
1763 *os << kSdpDelimiterColon;
1764 if (payload_type == kWildcardPayloadType) {
1765 *os << "*";
1766 } else {
1767 *os << payload_type;
1768 }
1769}
1770
1771void WriteFmtpParameter(const std::string& parameter_name,
1772 const std::string& parameter_value,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001773 rtc::StringBuilder* os) {
Philipp Hanckef2a4ec12020-07-01 21:07:32 +02001774 if (parameter_name == "") {
1775 // RFC 2198 and RFC 4733 don't use key-value pairs.
1776 *os << parameter_value;
1777 } else {
1778 // fmtp parameters: |parameter_name|=|parameter_value|
1779 *os << parameter_name << kSdpDelimiterEqual << parameter_value;
1780 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001781}
1782
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001783bool IsFmtpParam(const std::string& name) {
ossuaa4b0772017-01-30 07:41:18 -08001784 // RFC 4855, section 3 specifies the mapping of media format parameters to SDP
1785 // parameters. Only ptime, maxptime, channels and rate are placed outside of
1786 // the fmtp line. In WebRTC, channels and rate are already handled separately
1787 // and thus not included in the CodecParameterMap.
1788 return name != kCodecParamPTime && name != kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001789}
1790
Johannes Kron72d69152020-02-10 14:05:55 +01001791bool WriteFmtpParameters(const cricket::CodecParameterMap& parameters,
1792 rtc::StringBuilder* os) {
1793 bool empty = true;
1794 const char* delimiter = ""; // No delimiter before first parameter.
1795 for (const auto& entry : parameters) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001796 const std::string& key = entry.first;
1797 const std::string& value = entry.second;
Johannes Kron72d69152020-02-10 14:05:55 +01001798
Steve Anton4daf66e2018-09-07 14:55:53 -07001799 if (IsFmtpParam(key)) {
Johannes Kron72d69152020-02-10 14:05:55 +01001800 *os << delimiter;
1801 // A semicolon before each subsequent parameter.
1802 delimiter = kSdpDelimiterSemicolon;
1803 WriteFmtpParameter(key, value, os);
1804 empty = false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001805 }
1806 }
Johannes Kron72d69152020-02-10 14:05:55 +01001807
1808 return !empty;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001809}
1810
1811template <class T>
1812void AddFmtpLine(const T& codec, std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001813 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001814 WriteFmtpHeader(codec.id, &os);
Johannes Kron72d69152020-02-10 14:05:55 +01001815 os << kSdpDelimiterSpace;
1816 // Create FMTP line and check that it's nonempty.
1817 if (WriteFmtpParameters(codec.params, &os)) {
1818 AddLine(os.str(), message);
1819 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001820 return;
1821}
1822
1823template <class T>
Mirta Dvornicic479a3c02019-06-04 15:38:50 +02001824void AddPacketizationLine(const T& codec, std::string* message) {
1825 if (!codec.packetization) {
1826 return;
1827 }
1828 rtc::StringBuilder os;
1829 WritePacketizationHeader(codec.id, &os);
1830 os << " " << *codec.packetization;
1831 AddLine(os.str(), message);
1832}
1833
1834template <class T>
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001835void AddRtcpFbLines(const T& codec, std::string* message) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001836 for (const cricket::FeedbackParam& param : codec.feedback_params.params()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001837 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001838 WriteRtcpFbHeader(codec.id, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001839 os << " " << param.id();
1840 if (!param.param().empty()) {
1841 os << " " << param.param();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001842 }
1843 AddLine(os.str(), message);
1844 }
1845}
1846
1847bool GetMinValue(const std::vector<int>& values, int* value) {
1848 if (values.empty()) {
1849 return false;
1850 }
Steve Anton64b626b2019-01-28 17:25:26 -08001851 auto it = absl::c_min_element(values);
1852 *value = *it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001853 return true;
1854}
1855
1856bool GetParameter(const std::string& name,
Yves Gerey665174f2018-06-19 15:03:05 +02001857 const cricket::CodecParameterMap& params,
1858 int* value) {
1859 std::map<std::string, std::string>::const_iterator found = params.find(name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001860 if (found == params.end()) {
1861 return false;
1862 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00001863 if (!rtc::FromString(found->second, value)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001864 return false;
1865 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001866 return true;
1867}
1868
1869void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001870 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001871 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001872 RTC_DCHECK(message != NULL);
1873 RTC_DCHECK(media_desc != NULL);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001874 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001875 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001876 for (const cricket::VideoCodec& codec : media_desc->as_video()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001877 // RFC 4566
1878 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1879 // [/<encodingparameters>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001880 if (codec.id != kWildcardPayloadType) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001881 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001882 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
deadbeefe814a0d2017-02-25 18:15:09 -08001883 << cricket::kVideoCodecClockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001884 AddLine(os.str(), message);
1885 }
Mirta Dvornicic479a3c02019-06-04 15:38:50 +02001886 AddPacketizationLine(codec, message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001887 AddRtcpFbLines(codec, message);
1888 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001889 }
1890 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001891 std::vector<int> ptimes;
1892 std::vector<int> maxptimes;
1893 int max_minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001894 for (const cricket::AudioCodec& codec : media_desc->as_audio()->codecs()) {
1895 RTC_DCHECK(!codec.name.empty());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001896 // RFC 4566
1897 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1898 // [/<encodingparameters>]
1899 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001900 os << kSdpDelimiterColon << codec.id << " ";
1901 os << codec.name << "/" << codec.clockrate;
1902 if (codec.channels != 1) {
1903 os << "/" << codec.channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001904 }
1905 AddLine(os.str(), message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001906 AddRtcpFbLines(codec, message);
1907 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001908 int minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001909 if (GetParameter(kCodecParamMinPTime, codec.params, &minptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001910 max_minptime = std::max(minptime, max_minptime);
1911 }
1912 int ptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001913 if (GetParameter(kCodecParamPTime, codec.params, &ptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001914 ptimes.push_back(ptime);
1915 }
1916 int maxptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001917 if (GetParameter(kCodecParamMaxPTime, codec.params, &maxptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001918 maxptimes.push_back(maxptime);
1919 }
1920 }
1921 // Populate the maxptime attribute with the smallest maxptime of all codecs
1922 // under the same m-line.
1923 int min_maxptime = INT_MAX;
1924 if (GetMinValue(maxptimes, &min_maxptime)) {
1925 AddAttributeLine(kCodecParamMaxPTime, min_maxptime, message);
1926 }
nisseede5da42017-01-12 05:15:36 -08001927 RTC_DCHECK(min_maxptime > max_minptime);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001928 // Populate the ptime attribute with the smallest ptime or the largest
1929 // minptime, whichever is the largest, for all codecs under the same m-line.
1930 int ptime = INT_MAX;
1931 if (GetMinValue(ptimes, &ptime)) {
1932 ptime = std::min(ptime, min_maxptime);
1933 ptime = std::max(ptime, max_minptime);
1934 AddAttributeLine(kCodecParamPTime, ptime, message);
1935 }
1936 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001937 if (media_desc->as_rtp_data()) {
1938 for (const cricket::RtpDataCodec& codec :
1939 media_desc->as_rtp_data()->codecs()) {
1940 // RFC 4566
1941 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1942 // [/<encodingparameters>]
1943 InitAttrLine(kAttributeRtpmap, &os);
1944 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
1945 << codec.clockrate;
1946 AddLine(os.str(), message);
1947 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001948 }
1949 }
1950}
1951
1952void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -08001953 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001954 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001955 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001956
Steve Anton4daf66e2018-09-07 14:55:53 -07001957 for (const Candidate& candidate : candidates) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001958 // RFC 5245
1959 // a=candidate:<foundation> <component-id> <transport> <priority>
1960 // <connection-address> <port> typ <candidate-types>
1961 // [raddr <connection-address>] [rport <port>]
1962 // *(SP extension-att-name SP extension-att-value)
1963 std::string type;
1964 // Map the cricket candidate type to "host" / "srflx" / "prflx" / "relay"
Steve Anton4daf66e2018-09-07 14:55:53 -07001965 if (candidate.type() == cricket::LOCAL_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001966 type = kCandidateHost;
Steve Anton4daf66e2018-09-07 14:55:53 -07001967 } else if (candidate.type() == cricket::STUN_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001968 type = kCandidateSrflx;
Steve Anton4daf66e2018-09-07 14:55:53 -07001969 } else if (candidate.type() == cricket::RELAY_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001970 type = kCandidateRelay;
Steve Anton4daf66e2018-09-07 14:55:53 -07001971 } else if (candidate.type() == cricket::PRFLX_PORT_TYPE) {
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001972 type = kCandidatePrflx;
1973 // Peer reflexive candidate may be signaled for being removed.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001974 } else {
nissec80e7412017-01-11 05:56:46 -08001975 RTC_NOTREACHED();
Peter Thatcher019087f2015-04-28 09:06:26 -07001976 // Never write out candidates if we don't know the type.
1977 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001978 }
1979
1980 InitAttrLine(kAttributeCandidate, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001981 os << kSdpDelimiterColon << candidate.foundation() << " "
1982 << candidate.component() << " " << candidate.protocol() << " "
1983 << candidate.priority() << " "
1984 << (candidate.address().ipaddr().IsNil()
1985 ? candidate.address().hostname()
1986 : candidate.address().ipaddr().ToString())
1987 << " " << candidate.address().PortAsString() << " "
1988 << kAttributeCandidateTyp << " " << type << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001989
1990 // Related address
Steve Anton4daf66e2018-09-07 14:55:53 -07001991 if (!candidate.related_address().IsNil()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001992 os << kAttributeCandidateRaddr << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001993 << candidate.related_address().ipaddr().ToString() << " "
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001994 << kAttributeCandidateRport << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001995 << candidate.related_address().PortAsString() << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001996 }
1997
Taylor Brandstetter8206bc02020-04-02 12:36:38 -07001998 // Note that we allow the tcptype to be missing, for backwards
1999 // compatibility; the implementation treats this as a passive candidate.
2000 // TODO(bugs.webrtc.org/11466): Treat a missing tcptype as an error?
2001 if (candidate.protocol() == cricket::TCP_PROTOCOL_NAME &&
2002 !candidate.tcptype().empty()) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002003 os << kTcpCandidateType << " " << candidate.tcptype() << " ";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00002004 }
2005
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002006 // Extensions
Steve Anton4daf66e2018-09-07 14:55:53 -07002007 os << kAttributeCandidateGeneration << " " << candidate.generation();
2008 if (include_ufrag && !candidate.username().empty()) {
2009 os << " " << kAttributeCandidateUfrag << " " << candidate.username();
honghaiza54a0802015-12-16 18:37:23 -08002010 }
Steve Anton4daf66e2018-09-07 14:55:53 -07002011 if (candidate.network_id() > 0) {
2012 os << " " << kAttributeCandidateNetworkId << " "
2013 << candidate.network_id();
honghaiza0c44ea2016-03-23 16:07:48 -07002014 }
Steve Anton4daf66e2018-09-07 14:55:53 -07002015 if (candidate.network_cost() > 0) {
2016 os << " " << kAttributeCandidateNetworkCost << " "
2017 << candidate.network_cost();
honghaize1a0c942016-02-16 14:54:56 -08002018 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002019
2020 AddLine(os.str(), message);
2021 }
2022}
2023
2024void BuildIceOptions(const std::vector<std::string>& transport_options,
2025 std::string* message) {
2026 if (!transport_options.empty()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002027 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002028 InitAttrLine(kAttributeIceOption, &os);
2029 os << kSdpDelimiterColon << transport_options[0];
2030 for (size_t i = 1; i < transport_options.size(); ++i) {
2031 os << kSdpDelimiterSpace << transport_options[i];
2032 }
2033 AddLine(os.str(), message);
2034 }
2035}
2036
zhihuang38989e52017-03-21 11:04:53 -07002037bool ParseConnectionData(const std::string& line,
2038 rtc::SocketAddress* addr,
2039 SdpParseError* error) {
2040 // Parse the line from left to right.
2041 std::string token;
2042 std::string rightpart;
2043 // RFC 4566
2044 // c=<nettype> <addrtype> <connection-address>
2045 // Skip the "c="
Jonas Olssonec9e4922018-09-05 09:53:49 +02002046 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, &token, &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07002047 return ParseFailed(line, "Failed to parse the network type.", error);
2048 }
2049
2050 // Extract and verify the <nettype>
Jonas Olssonec9e4922018-09-05 09:53:49 +02002051 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2052 &rightpart) ||
zhihuang38989e52017-03-21 11:04:53 -07002053 token != kConnectionNettype) {
2054 return ParseFailed(line,
2055 "Failed to parse the connection data. The network type "
2056 "is not currently supported.",
2057 error);
2058 }
2059
2060 // Extract the "<addrtype>" and "<connection-address>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02002061 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2062 &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07002063 return ParseFailed(line, "Failed to parse the address type.", error);
2064 }
2065
2066 // The rightpart part should be the IP address without the slash which is used
2067 // for multicast.
2068 if (rightpart.find('/') != std::string::npos) {
2069 return ParseFailed(line,
2070 "Failed to parse the connection data. Multicast is not "
2071 "currently supported.",
2072 error);
2073 }
2074 addr->SetIP(rightpart);
2075
2076 // Verify that the addrtype matches the type of the parsed address.
2077 if ((addr->family() == AF_INET && token != "IP4") ||
2078 (addr->family() == AF_INET6 && token != "IP6")) {
2079 addr->Clear();
2080 return ParseFailed(
2081 line,
2082 "Failed to parse the connection data. The address type is mismatching.",
2083 error);
2084 }
2085 return true;
2086}
2087
2088bool ParseSessionDescription(const std::string& message,
2089 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002090 std::string* session_id,
2091 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002092 TransportDescription* session_td,
2093 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -07002094 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002095 cricket::SessionDescription* desc,
2096 SdpParseError* error) {
2097 std::string line;
2098
deadbeefc80741f2015-10-22 13:14:45 -07002099 desc->set_msid_supported(false);
Johannes Kron9581bc42018-10-23 10:17:39 +02002100 desc->set_extmap_allow_mixed(false);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002101 // RFC 4566
2102 // v= (protocol version)
2103 if (!GetLineWithType(message, pos, &line, kLineTypeVersion)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002104 return ParseFailedExpectLine(message, *pos, kLineTypeVersion, std::string(),
2105 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002106 }
2107 // RFC 4566
2108 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
2109 // <unicast-address>
2110 if (!GetLineWithType(message, pos, &line, kLineTypeOrigin)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002111 return ParseFailedExpectLine(message, *pos, kLineTypeOrigin, std::string(),
2112 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002113 }
2114 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002115 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002116 const size_t expected_fields = 6;
2117 if (fields.size() != expected_fields) {
2118 return ParseFailedExpectFieldNum(line, expected_fields, error);
2119 }
2120 *session_id = fields[1];
2121 *session_version = fields[2];
2122
2123 // RFC 4566
2124 // s= (session name)
2125 if (!GetLineWithType(message, pos, &line, kLineTypeSessionName)) {
2126 return ParseFailedExpectLine(message, *pos, kLineTypeSessionName,
2127 std::string(), error);
2128 }
2129
Danil Chapovalov66cadcc2018-06-19 16:47:43 +02002130 // absl::optional lines
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002131 // Those are the optional lines, so shouldn't return false if not present.
2132 // RFC 4566
2133 // i=* (session information)
2134 GetLineWithType(message, pos, &line, kLineTypeSessionInfo);
2135
2136 // RFC 4566
2137 // u=* (URI of description)
2138 GetLineWithType(message, pos, &line, kLineTypeSessionUri);
2139
2140 // RFC 4566
2141 // e=* (email address)
2142 GetLineWithType(message, pos, &line, kLineTypeSessionEmail);
2143
2144 // RFC 4566
2145 // p=* (phone number)
2146 GetLineWithType(message, pos, &line, kLineTypeSessionPhone);
2147
2148 // RFC 4566
2149 // c=* (connection information -- not required if included in
2150 // all media)
zhihuang38989e52017-03-21 11:04:53 -07002151 if (GetLineWithType(message, pos, &line, kLineTypeConnection)) {
2152 if (!ParseConnectionData(line, connection_addr, error)) {
2153 return false;
2154 }
2155 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002156
2157 // RFC 4566
2158 // b=* (zero or more bandwidth information lines)
2159 while (GetLineWithType(message, pos, &line, kLineTypeSessionBandwidth)) {
2160 // By pass zero or more b lines.
2161 }
2162
2163 // RFC 4566
2164 // One or more time descriptions ("t=" and "r=" lines; see below)
2165 // t= (time the session is active)
2166 // r=* (zero or more repeat times)
2167 // Ensure there's at least one time description
2168 if (!GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2169 return ParseFailedExpectLine(message, *pos, kLineTypeTiming, std::string(),
2170 error);
2171 }
2172
2173 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2174 // By pass zero or more r lines.
2175 }
2176
2177 // Go through the rest of the time descriptions
2178 while (GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2179 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2180 // By pass zero or more r lines.
2181 }
2182 }
2183
2184 // RFC 4566
2185 // z=* (time zone adjustments)
2186 GetLineWithType(message, pos, &line, kLineTypeTimeZone);
2187
2188 // RFC 4566
2189 // k=* (encryption key)
2190 GetLineWithType(message, pos, &line, kLineTypeEncryptionKey);
2191
2192 // RFC 4566
2193 // a=* (zero or more session attribute lines)
2194 while (GetLineWithType(message, pos, &line, kLineTypeAttributes)) {
2195 if (HasAttribute(line, kAttributeGroup)) {
2196 if (!ParseGroupAttribute(line, desc, error)) {
2197 return false;
2198 }
2199 } else if (HasAttribute(line, kAttributeIceUfrag)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002200 if (!GetValue(line, kAttributeIceUfrag, &(session_td->ice_ufrag),
2201 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002202 return false;
2203 }
2204 } else if (HasAttribute(line, kAttributeIcePwd)) {
2205 if (!GetValue(line, kAttributeIcePwd, &(session_td->ice_pwd), error)) {
2206 return false;
2207 }
2208 } else if (HasAttribute(line, kAttributeIceLite)) {
2209 session_td->ice_mode = cricket::ICEMODE_LITE;
2210 } else if (HasAttribute(line, kAttributeIceOption)) {
2211 if (!ParseIceOptions(line, &(session_td->transport_options), error)) {
2212 return false;
2213 }
2214 } else if (HasAttribute(line, kAttributeFingerprint)) {
2215 if (session_td->identity_fingerprint.get()) {
2216 return ParseFailed(
2217 line,
2218 "Can't have multiple fingerprint attributes at the same level.",
2219 error);
2220 }
Steve Anton4905edb2018-10-15 19:27:44 -07002221 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002222 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2223 return false;
2224 }
Steve Anton4905edb2018-10-15 19:27:44 -07002225 session_td->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002226 } else if (HasAttribute(line, kAttributeSetup)) {
2227 if (!ParseDtlsSetup(line, &(session_td->connection_role), error)) {
2228 return false;
2229 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002230 } else if (HasAttribute(line, kAttributeMsidSemantics)) {
2231 std::string semantics;
2232 if (!GetValue(line, kAttributeMsidSemantics, &semantics, error)) {
2233 return false;
2234 }
deadbeefc80741f2015-10-22 13:14:45 -07002235 desc->set_msid_supported(
2236 CaseInsensitiveFind(semantics, kMediaStreamSemantic));
Johannes Kron0854eb62018-10-10 22:33:20 +02002237 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02002238 desc->set_extmap_allow_mixed(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002239 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002240 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002241 if (!ParseExtmap(line, &extmap, error)) {
2242 return false;
2243 }
2244 session_extmaps->push_back(extmap);
2245 }
2246 }
2247
2248 return true;
2249}
2250
2251bool ParseGroupAttribute(const std::string& line,
2252 cricket::SessionDescription* desc,
2253 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002254 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002255
2256 // RFC 5888 and draft-holmberg-mmusic-sdp-bundle-negotiation-00
2257 // a=group:BUNDLE video voice
2258 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002259 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002260 std::string semantics;
2261 if (!GetValue(fields[0], kAttributeGroup, &semantics, error)) {
2262 return false;
2263 }
2264 cricket::ContentGroup group(semantics);
2265 for (size_t i = 1; i < fields.size(); ++i) {
2266 group.AddContentName(fields[i]);
2267 }
2268 desc->AddGroup(group);
2269 return true;
2270}
2271
Steve Anton4905edb2018-10-15 19:27:44 -07002272static bool ParseFingerprintAttribute(
2273 const std::string& line,
2274 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
2275 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002276 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002277 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002278 const size_t expected_fields = 2;
2279 if (fields.size() != expected_fields) {
2280 return ParseFailedExpectFieldNum(line, expected_fields, error);
2281 }
2282
2283 // The first field here is "fingerprint:<hash>.
2284 std::string algorithm;
2285 if (!GetValue(fields[0], kAttributeFingerprint, &algorithm, error)) {
2286 return false;
2287 }
2288
2289 // Downcase the algorithm. Note that we don't need to downcase the
2290 // fingerprint because hex_decode can handle upper-case.
Steve Anton64b626b2019-01-28 17:25:26 -08002291 absl::c_transform(algorithm, algorithm.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002292
2293 // The second field is the digest value. De-hexify it.
Steve Anton4905edb2018-10-15 19:27:44 -07002294 *fingerprint =
2295 rtc::SSLFingerprint::CreateUniqueFromRfc4572(algorithm, fields[1]);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002296 if (!*fingerprint) {
Yves Gerey665174f2018-06-19 15:03:05 +02002297 return ParseFailed(line, "Failed to create fingerprint from the digest.",
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002298 error);
2299 }
2300
2301 return true;
2302}
2303
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002304static bool ParseDtlsSetup(const std::string& line,
2305 cricket::ConnectionRole* role,
2306 SdpParseError* error) {
2307 // setup-attr = "a=setup:" role
2308 // role = "active" / "passive" / "actpass" / "holdconn"
2309 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002310 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002311 const size_t expected_fields = 2;
2312 if (fields.size() != expected_fields) {
2313 return ParseFailedExpectFieldNum(line, expected_fields, error);
2314 }
2315 std::string role_str = fields[1];
2316 if (!cricket::StringToConnectionRole(role_str, role)) {
2317 return ParseFailed(line, "Invalid attribute value.", error);
2318 }
2319 return true;
2320}
2321
deadbeef9d3584c2016-02-16 17:54:10 -08002322static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -07002323 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -08002324 std::string* track_id,
2325 SdpParseError* error) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002326 // https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
deadbeef9d3584c2016-02-16 17:54:10 -08002327 // a=msid:<stream id> <track id>
2328 // msid-value = msid-id [ SP msid-appdata ]
2329 // msid-id = 1*64token-char ; see RFC 4566
2330 // msid-appdata = 1*64token-char ; see RFC 4566
2331 std::string field1;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002332 std::string new_stream_id;
2333 std::string new_track_id;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002334 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
2335 kSdpDelimiterSpaceChar, &field1, &new_track_id)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002336 const size_t expected_fields = 2;
2337 return ParseFailedExpectFieldNum(line, expected_fields, error);
2338 }
2339
Seth Hampson5b4f0752018-04-02 16:31:36 -07002340 if (new_track_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002341 return ParseFailed(line, "Missing track ID in msid attribute.", error);
2342 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002343 // All track ids should be the same within an m section in a Unified Plan SDP.
2344 if (!track_id->empty() && new_track_id.compare(*track_id) != 0) {
2345 return ParseFailed(
2346 line, "Two different track IDs in msid attribute in one m= section",
2347 error);
2348 }
2349 *track_id = new_track_id;
deadbeefa4549d62017-02-10 17:26:22 -08002350
deadbeef9d3584c2016-02-16 17:54:10 -08002351 // msid:<msid-id>
Seth Hampson5b4f0752018-04-02 16:31:36 -07002352 if (!GetValue(field1, kAttributeMsid, &new_stream_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002353 return false;
2354 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002355 if (new_stream_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002356 return ParseFailed(line, "Missing stream ID in msid attribute.", error);
2357 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002358 // The special value "-" indicates "no MediaStream".
2359 if (new_stream_id.compare(kNoStreamMsid) != 0) {
2360 stream_ids->push_back(new_stream_id);
2361 }
deadbeef9d3584c2016-02-16 17:54:10 -08002362 return true;
2363}
2364
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002365static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
2366 std::vector<RidDescription>* rids) {
2367 RTC_DCHECK(rids);
2368 std::set<std::string> to_remove;
2369 std::set<std::string> unique_rids;
2370
2371 // Check the rids to see which ones should be removed.
2372 for (RidDescription& rid : *rids) {
2373 // In the case of a duplicate, the entire "a=rid" line, and all "a=rid"
2374 // lines with rid-ids that duplicate this line, are discarded and MUST NOT
2375 // be included in the SDP Answer.
2376 auto pair = unique_rids.insert(rid.rid);
2377 // Insert will "fail" if element already exists.
2378 if (!pair.second) {
2379 to_remove.insert(rid.rid);
2380 continue;
2381 }
2382
2383 // If the "a=rid" line contains a "pt=", the list of payload types
2384 // is verified against the list of valid payload types for the media
2385 // section (that is, those listed on the "m=" line). Any PT missing
2386 // from the "m=" line is discarded from the set of values in the
2387 // "pt=". If no values are left in the "pt=" parameter after this
2388 // processing, then the "a=rid" line is discarded.
2389 if (rid.payload_types.empty()) {
2390 // If formats were not specified, rid should not be removed.
2391 continue;
2392 }
2393
2394 // Note: Spec does not mention how to handle duplicate formats.
2395 // Media section does not handle duplicates either.
2396 std::set<int> removed_formats;
2397 for (int payload_type : rid.payload_types) {
Steve Anton64b626b2019-01-28 17:25:26 -08002398 if (!absl::c_linear_search(payload_types, payload_type)) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002399 removed_formats.insert(payload_type);
2400 }
2401 }
2402
2403 rid.payload_types.erase(
2404 std::remove_if(rid.payload_types.begin(), rid.payload_types.end(),
2405 [&removed_formats](int format) {
2406 return removed_formats.count(format) > 0;
2407 }),
2408 rid.payload_types.end());
2409
2410 // If all formats were removed then remove the rid alogether.
2411 if (rid.payload_types.empty()) {
2412 to_remove.insert(rid.rid);
2413 }
2414 }
2415
2416 // Remove every rid description that appears in the to_remove list.
2417 if (!to_remove.empty()) {
2418 rids->erase(std::remove_if(rids->begin(), rids->end(),
2419 [&to_remove](const RidDescription& rid) {
2420 return to_remove.count(rid.rid) > 0;
2421 }),
2422 rids->end());
2423 }
2424}
2425
2426// Create a new list (because SimulcastLayerList is immutable) without any
2427// layers that have a rid in the to_remove list.
2428// If a group of alternatives is empty after removing layers, the group should
2429// be removed altogether.
2430static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
2431 const std::set<std::string>& to_remove,
2432 const SimulcastLayerList& layers) {
2433 SimulcastLayerList result;
2434 for (const std::vector<SimulcastLayer>& vector : layers) {
2435 std::vector<SimulcastLayer> new_layers;
2436 for (const SimulcastLayer& layer : vector) {
2437 if (to_remove.find(layer.rid) == to_remove.end()) {
2438 new_layers.push_back(layer);
2439 }
2440 }
2441 // If all layers were removed, do not add an entry.
2442 if (!new_layers.empty()) {
2443 result.AddLayerWithAlternatives(new_layers);
2444 }
2445 }
2446
2447 return result;
2448}
2449
2450// Will remove Simulcast Layers if:
2451// 1. They appear in both send and receive directions.
2452// 2. They do not appear in the list of |valid_rids|.
2453static void RemoveInvalidRidsFromSimulcast(
2454 const std::vector<RidDescription>& valid_rids,
2455 SimulcastDescription* simulcast) {
2456 RTC_DCHECK(simulcast);
2457 std::set<std::string> to_remove;
2458 std::vector<SimulcastLayer> all_send_layers =
2459 simulcast->send_layers().GetAllLayers();
2460 std::vector<SimulcastLayer> all_receive_layers =
2461 simulcast->receive_layers().GetAllLayers();
2462
2463 // If a rid appears in both send and receive directions, remove it from both.
2464 // This algorithm runs in O(n^2) time, but for small n (as is the case with
2465 // simulcast layers) it should still perform well.
2466 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002467 if (absl::c_any_of(all_receive_layers,
2468 [&send_layer](const SimulcastLayer& layer) {
2469 return layer.rid == send_layer.rid;
2470 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002471 to_remove.insert(send_layer.rid);
2472 }
2473 }
2474
2475 // Add any rid that is not in the valid list to the remove set.
2476 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002477 if (absl::c_none_of(valid_rids, [&send_layer](const RidDescription& rid) {
Florent Castellic4421972019-07-02 20:27:42 +02002478 return send_layer.rid == rid.rid &&
2479 rid.direction == cricket::RidDirection::kSend;
Steve Anton64b626b2019-01-28 17:25:26 -08002480 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002481 to_remove.insert(send_layer.rid);
2482 }
2483 }
2484
2485 // Add any rid that is not in the valid list to the remove set.
2486 for (const SimulcastLayer& receive_layer : all_receive_layers) {
Florent Castellic4421972019-07-02 20:27:42 +02002487 if (absl::c_none_of(
2488 valid_rids, [&receive_layer](const RidDescription& rid) {
2489 return receive_layer.rid == rid.rid &&
2490 rid.direction == cricket::RidDirection::kReceive;
2491 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002492 to_remove.insert(receive_layer.rid);
2493 }
2494 }
2495
2496 simulcast->send_layers() =
2497 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->send_layers());
2498 simulcast->receive_layers() =
2499 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->receive_layers());
2500}
2501
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002502// RFC 3551
2503// PT encoding media type clock rate channels
2504// name (Hz)
2505// 0 PCMU A 8,000 1
2506// 1 reserved A
2507// 2 reserved A
2508// 3 GSM A 8,000 1
2509// 4 G723 A 8,000 1
2510// 5 DVI4 A 8,000 1
2511// 6 DVI4 A 16,000 1
2512// 7 LPC A 8,000 1
2513// 8 PCMA A 8,000 1
2514// 9 G722 A 8,000 1
2515// 10 L16 A 44,100 2
2516// 11 L16 A 44,100 1
2517// 12 QCELP A 8,000 1
2518// 13 CN A 8,000 1
2519// 14 MPA A 90,000 (see text)
2520// 15 G728 A 8,000 1
2521// 16 DVI4 A 11,025 1
2522// 17 DVI4 A 22,050 1
2523// 18 G729 A 8,000 1
2524struct StaticPayloadAudioCodec {
2525 const char* name;
2526 int clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002527 size_t channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002528};
2529static const StaticPayloadAudioCodec kStaticPayloadAudioCodecs[] = {
Yves Gerey665174f2018-06-19 15:03:05 +02002530 {"PCMU", 8000, 1}, {"reserved", 0, 0}, {"reserved", 0, 0},
2531 {"GSM", 8000, 1}, {"G723", 8000, 1}, {"DVI4", 8000, 1},
2532 {"DVI4", 16000, 1}, {"LPC", 8000, 1}, {"PCMA", 8000, 1},
2533 {"G722", 8000, 1}, {"L16", 44100, 2}, {"L16", 44100, 1},
2534 {"QCELP", 8000, 1}, {"CN", 8000, 1}, {"MPA", 90000, 1},
2535 {"G728", 8000, 1}, {"DVI4", 11025, 1}, {"DVI4", 22050, 1},
2536 {"G729", 8000, 1},
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002537};
2538
Yves Gerey665174f2018-06-19 15:03:05 +02002539void MaybeCreateStaticPayloadAudioCodecs(const std::vector<int>& fmts,
2540 AudioContentDescription* media_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002541 if (!media_desc) {
2542 return;
2543 }
deadbeef67cf2c12016-04-13 10:07:16 -07002544 RTC_DCHECK(media_desc->codecs().empty());
solenberg9fa49752016-10-08 13:02:44 -07002545 for (int payload_type : fmts) {
Yves Gerey665174f2018-06-19 15:03:05 +02002546 if (!media_desc->HasCodec(payload_type) && payload_type >= 0 &&
kjellander3e33bfe2016-06-20 07:04:09 -07002547 static_cast<uint32_t>(payload_type) <
2548 arraysize(kStaticPayloadAudioCodecs)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002549 std::string encoding_name = kStaticPayloadAudioCodecs[payload_type].name;
2550 int clock_rate = kStaticPayloadAudioCodecs[payload_type].clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002551 size_t channels = kStaticPayloadAudioCodecs[payload_type].channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002552 media_desc->AddCodec(cricket::AudioCodec(payload_type, encoding_name,
deadbeef67cf2c12016-04-13 10:07:16 -07002553 clock_rate, 0, channels));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002554 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002555 }
2556}
2557
2558template <class C>
Steve Anton5a1de872018-12-18 11:25:55 -08002559static std::unique_ptr<C> ParseContentDescription(
2560 const std::string& message,
2561 const cricket::MediaType media_type,
2562 int mline_index,
2563 const std::string& protocol,
2564 const std::vector<int>& payload_types,
2565 size_t* pos,
2566 std::string* content_name,
2567 bool* bundle_only,
2568 int* msid_signaling,
2569 TransportDescription* transport,
2570 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2571 webrtc::SdpParseError* error) {
Mirko Bonadei317a1f02019-09-17 17:06:18 +02002572 auto media_desc = std::make_unique<C>();
Emil Lundmark801c9992021-01-19 13:06:32 +01002573 media_desc->set_extmap_allow_mixed_enum(MediaContentDescription::kNo);
deadbeef67cf2c12016-04-13 10:07:16 -07002574 if (!ParseContent(message, media_type, mline_index, protocol, payload_types,
Steve Anton5a1de872018-12-18 11:25:55 -08002575 pos, content_name, bundle_only, msid_signaling,
2576 media_desc.get(), transport, candidates, error)) {
zhihuang38989e52017-03-21 11:04:53 -07002577 return nullptr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002578 }
2579 // Sort the codecs according to the m-line fmt list.
deadbeef67cf2c12016-04-13 10:07:16 -07002580 std::unordered_map<int, int> payload_type_preferences;
2581 // "size + 1" so that the lowest preference payload type has a preference of
2582 // 1, which is greater than the default (0) for payload types not in the fmt
2583 // list.
2584 int preference = static_cast<int>(payload_types.size() + 1);
2585 for (int pt : payload_types) {
2586 payload_type_preferences[pt] = preference--;
2587 }
2588 std::vector<typename C::CodecType> codecs = media_desc->codecs();
Steve Anton64b626b2019-01-28 17:25:26 -08002589 absl::c_sort(
2590 codecs, [&payload_type_preferences](const typename C::CodecType& a,
2591 const typename C::CodecType& b) {
2592 return payload_type_preferences[a.id] > payload_type_preferences[b.id];
2593 });
deadbeef67cf2c12016-04-13 10:07:16 -07002594 media_desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002595 return media_desc;
2596}
2597
Steve Anton5a1de872018-12-18 11:25:55 -08002598bool ParseMediaDescription(
2599 const std::string& message,
2600 const TransportDescription& session_td,
2601 const RtpHeaderExtensions& session_extmaps,
2602 size_t* pos,
2603 const rtc::SocketAddress& session_connection_addr,
2604 cricket::SessionDescription* desc,
2605 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2606 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002607 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002608 std::string line;
2609 int mline_index = -1;
Steve Antone831b8c2018-02-01 12:22:16 -08002610 int msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002611
2612 // Zero or more media descriptions
2613 // RFC 4566
2614 // m=<media> <port> <proto> <fmt>
2615 while (GetLineWithType(message, pos, &line, kLineTypeMedia)) {
2616 ++mline_index;
2617
2618 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002619 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
zstein4b2e0822017-02-17 19:48:38 -08002620
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002621 const size_t expected_min_fields = 4;
2622 if (fields.size() < expected_min_fields) {
2623 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
2624 }
deadbeef25ed4352016-12-12 18:37:36 -08002625 bool port_rejected = false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002626 // RFC 3264
2627 // To reject an offered stream, the port number in the corresponding stream
2628 // in the answer MUST be set to zero.
2629 if (fields[1] == kMediaPortRejected) {
deadbeef25ed4352016-12-12 18:37:36 -08002630 port_rejected = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002631 }
2632
zhihuang38989e52017-03-21 11:04:53 -07002633 int port = 0;
2634 if (!rtc::FromString<int>(fields[1], &port) || !IsValidPort(port)) {
2635 return ParseFailed(line, "The port number is invalid", error);
2636 }
Philipp Hancke6fb70042020-06-29 12:32:08 +02002637 const std::string& protocol = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002638
2639 // <fmt>
deadbeef67cf2c12016-04-13 10:07:16 -07002640 std::vector<int> payload_types;
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002641 if (cricket::IsRtpProtocol(protocol)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002642 for (size_t j = 3; j < fields.size(); ++j) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002643 int pl = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00002644 if (!GetPayloadTypeFromString(line, fields[j], &pl, error)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002645 return false;
2646 }
deadbeef67cf2c12016-04-13 10:07:16 -07002647 payload_types.push_back(pl);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002648 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002649 }
2650
2651 // Make a temporary TransportDescription based on |session_td|.
2652 // Some of this gets overwritten by ParseContent.
deadbeef46eed762016-01-28 13:24:37 -08002653 TransportDescription transport(
2654 session_td.transport_options, session_td.ice_ufrag, session_td.ice_pwd,
2655 session_td.ice_mode, session_td.connection_role,
2656 session_td.identity_fingerprint.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002657
kwibergd1fe2812016-04-27 06:47:29 -07002658 std::unique_ptr<MediaContentDescription> content;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002659 std::string content_name;
deadbeef25ed4352016-12-12 18:37:36 -08002660 bool bundle_only = false;
Steve Antone831b8c2018-02-01 12:22:16 -08002661 int section_msid_signaling = 0;
Philipp Hancke6fb70042020-06-29 12:32:08 +02002662 const std::string& media_type = fields[0];
Philipp Hanckeb70c9532021-01-13 10:40:06 +01002663 if ((media_type == kMediaTypeVideo || media_type == kMediaTypeAudio) &&
2664 !cricket::IsRtpProtocol(protocol)) {
2665 return ParseFailed(line, "Unsupported protocol for media type", error);
2666 }
Philipp Hancke6fb70042020-06-29 12:32:08 +02002667 if (media_type == kMediaTypeVideo) {
Steve Anton5a1de872018-12-18 11:25:55 -08002668 content = ParseContentDescription<VideoContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002669 message, cricket::MEDIA_TYPE_VIDEO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002670 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 11:25:55 -08002671 &section_msid_signaling, &transport, candidates, error);
Philipp Hancke6fb70042020-06-29 12:32:08 +02002672 } else if (media_type == kMediaTypeAudio) {
Steve Anton5a1de872018-12-18 11:25:55 -08002673 content = ParseContentDescription<AudioContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002674 message, cricket::MEDIA_TYPE_AUDIO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002675 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 11:25:55 -08002676 &section_msid_signaling, &transport, candidates, error);
Philipp Hancke6fb70042020-06-29 12:32:08 +02002677 } else if (media_type == kMediaTypeData) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002678 if (cricket::IsDtlsSctp(protocol)) {
2679 // The draft-03 format is:
2680 // m=application <port> DTLS/SCTP <sctp-port>...
2681 // use_sctpmap should be false.
2682 // The draft-26 format is:
2683 // m=application <port> UDP/DTLS/SCTP webrtc-datachannel
2684 // use_sctpmap should be false.
Mirko Bonadei317a1f02019-09-17 17:06:18 +02002685 auto data_desc = std::make_unique<SctpDataContentDescription>();
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +02002686 // Default max message size is 64K
2687 // according to draft-ietf-mmusic-sctp-sdp-26
2688 data_desc->set_max_message_size(kDefaultSctpMaxMessageSize);
zstein4b2e0822017-02-17 19:48:38 -08002689 int p;
2690 if (rtc::FromString(fields[3], &p)) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002691 data_desc->set_port(p);
zstein4b2e0822017-02-17 19:48:38 -08002692 } else if (fields[3] == kDefaultSctpmapProtocol) {
2693 data_desc->set_use_sctpmap(false);
2694 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002695 if (!ParseContent(message, cricket::MEDIA_TYPE_DATA, mline_index,
2696 protocol, payload_types, pos, &content_name,
2697 &bundle_only, &section_msid_signaling,
2698 data_desc.get(), &transport, candidates, error)) {
2699 return false;
2700 }
2701 data_desc->set_protocol(protocol);
2702 content = std::move(data_desc);
Philipp Hanckeb70c9532021-01-13 10:40:06 +01002703 } else if (cricket::IsRtpProtocol(protocol)) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002704 // RTP
2705 std::unique_ptr<RtpDataContentDescription> data_desc =
2706 ParseContentDescription<RtpDataContentDescription>(
2707 message, cricket::MEDIA_TYPE_DATA, mline_index, protocol,
2708 payload_types, pos, &content_name, &bundle_only,
2709 &section_msid_signaling, &transport, candidates, error);
2710 content = std::move(data_desc);
Philipp Hanckeb70c9532021-01-13 10:40:06 +01002711 } else {
2712 return ParseFailed(line, "Unsupported protocol for media type", error);
wu@webrtc.org78187522013-10-07 23:32:02 +00002713 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002714 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002715 RTC_LOG(LS_WARNING) << "Unsupported media type: " << line;
Philipp Hancke4e8c1152020-10-13 12:43:15 +02002716 auto unsupported_desc =
2717 std::make_unique<UnsupportedContentDescription>(media_type);
2718 if (!ParseContent(message, cricket::MEDIA_TYPE_UNSUPPORTED, mline_index,
2719 protocol, payload_types, pos, &content_name,
2720 &bundle_only, &section_msid_signaling,
2721 unsupported_desc.get(), &transport, candidates,
2722 error)) {
2723 return false;
2724 }
2725 unsupported_desc->set_protocol(protocol);
2726 content = std::move(unsupported_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002727 }
2728 if (!content.get()) {
2729 // ParseContentDescription returns NULL if failed.
2730 return false;
2731 }
2732
Steve Antone831b8c2018-02-01 12:22:16 -08002733 msid_signaling |= section_msid_signaling;
2734
deadbeef25ed4352016-12-12 18:37:36 -08002735 bool content_rejected = false;
deadbeef12771a12017-01-03 13:53:47 -08002736 // A port of 0 is not interpreted as a rejected m= section when it's
2737 // used along with a=bundle-only.
deadbeef25ed4352016-12-12 18:37:36 -08002738 if (bundle_only) {
deadbeef25ed4352016-12-12 18:37:36 -08002739 if (!port_rejected) {
deadbeef12771a12017-01-03 13:53:47 -08002740 // Usage of bundle-only with a nonzero port is unspecified. So just
2741 // ignore bundle-only if we see this.
2742 bundle_only = false;
Mirko Bonadei675513b2017-11-09 11:09:25 +01002743 RTC_LOG(LS_WARNING)
deadbeef12771a12017-01-03 13:53:47 -08002744 << "a=bundle-only attribute observed with a nonzero "
Jonas Olsson45cc8902018-02-13 10:37:07 +01002745 "port; this usage is unspecified so the attribute is being "
2746 "ignored.";
deadbeef25ed4352016-12-12 18:37:36 -08002747 }
2748 } else {
2749 // If not using bundle-only, interpret port 0 in the normal way; the m=
2750 // section is being rejected.
2751 content_rejected = port_rejected;
2752 }
2753
Philipp Hancke4e8c1152020-10-13 12:43:15 +02002754 if (content->as_unsupported()) {
2755 content_rejected = true;
2756 } else if (cricket::IsRtpProtocol(protocol) && !content->as_sctp()) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002757 content->set_protocol(protocol);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002758 // Set the extmap.
2759 if (!session_extmaps.empty() &&
2760 !content->rtp_header_extensions().empty()) {
2761 return ParseFailed("",
2762 "The a=extmap MUST be either all session level or "
2763 "all media level.",
2764 error);
2765 }
2766 for (size_t i = 0; i < session_extmaps.size(); ++i) {
2767 content->AddRtpHeaderExtension(session_extmaps[i]);
2768 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002769 } else if (content->as_sctp()) {
2770 // Do nothing, it's OK
2771 } else {
2772 RTC_LOG(LS_WARNING) << "Parse failed with unknown protocol " << protocol;
2773 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002774 }
zhihuang38989e52017-03-21 11:04:53 -07002775
2776 // Use the session level connection address if the media level addresses are
2777 // not specified.
2778 rtc::SocketAddress address;
2779 address = content->connection_address().IsNil()
2780 ? session_connection_addr
2781 : content->connection_address();
2782 address.SetPort(port);
2783 content->set_connection_address(address);
2784
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002785 desc->AddContent(content_name,
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002786 cricket::IsDtlsSctp(protocol) ? MediaProtocolType::kSctp
2787 : MediaProtocolType::kRtp,
Harald Alvestrand1716d392019-06-03 20:35:45 +02002788 content_rejected, bundle_only, std::move(content));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002789 // Create TransportInfo with the media level "ice-pwd" and "ice-ufrag".
Steve Anton06817cd2018-12-18 15:55:30 -08002790 desc->AddTransportInfo(TransportInfo(content_name, transport));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002791 }
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002792
Steve Antone831b8c2018-02-01 12:22:16 -08002793 desc->set_msid_signaling(msid_signaling);
2794
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002795 size_t end_of_message = message.size();
2796 if (mline_index == -1 && *pos != end_of_message) {
2797 ParseFailed(message, *pos, "Expects m line.", error);
2798 return false;
2799 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002800 return true;
2801}
2802
2803bool VerifyCodec(const cricket::Codec& codec) {
2804 // Codec has not been populated correctly unless the name has been set. This
2805 // can happen if an SDP has an fmtp or rtcp-fb with a payload type but doesn't
2806 // have a corresponding "rtpmap" line.
htab39db842016-12-08 01:50:48 -08002807 return !codec.name.empty();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002808}
2809
2810bool VerifyAudioCodecs(const AudioContentDescription* audio_desc) {
Steve Anton64b626b2019-01-28 17:25:26 -08002811 return absl::c_all_of(audio_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002812}
2813
2814bool VerifyVideoCodecs(const VideoContentDescription* video_desc) {
Steve Anton64b626b2019-01-28 17:25:26 -08002815 return absl::c_all_of(video_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002816}
2817
2818void AddParameters(const cricket::CodecParameterMap& parameters,
2819 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002820 for (const auto& entry : parameters) {
2821 const std::string& key = entry.first;
2822 const std::string& value = entry.second;
2823 codec->SetParam(key, value);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002824 }
2825}
2826
2827void AddFeedbackParameter(const cricket::FeedbackParam& feedback_param,
2828 cricket::Codec* codec) {
2829 codec->AddFeedbackParam(feedback_param);
2830}
2831
2832void AddFeedbackParameters(const cricket::FeedbackParams& feedback_params,
2833 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002834 for (const cricket::FeedbackParam& param : feedback_params.params()) {
2835 codec->AddFeedbackParam(param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002836 }
2837}
2838
2839// Gets the current codec setting associated with |payload_type|. If there
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002840// is no Codec associated with that payload type it returns an empty codec
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002841// with that payload type.
2842template <class T>
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002843T GetCodecWithPayloadType(const std::vector<T>& codecs, int payload_type) {
magjedb05fa242016-11-11 04:00:16 -08002844 const T* codec = FindCodecById(codecs, payload_type);
2845 if (codec)
2846 return *codec;
2847 // Return empty codec with |payload_type|.
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002848 T ret_val;
magjedb05fa242016-11-11 04:00:16 -08002849 ret_val.id = payload_type;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002850 return ret_val;
2851}
2852
2853// Updates or creates a new codec entry in the audio description.
2854template <class T, class U>
2855void AddOrReplaceCodec(MediaContentDescription* content_desc, const U& codec) {
2856 T* desc = static_cast<T*>(content_desc);
2857 std::vector<U> codecs = desc->codecs();
2858 bool found = false;
Steve Anton4daf66e2018-09-07 14:55:53 -07002859 for (U& existing_codec : codecs) {
2860 if (codec.id == existing_codec.id) {
2861 // Overwrite existing codec with the new codec.
2862 existing_codec = codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002863 found = true;
2864 break;
2865 }
2866 }
2867 if (!found) {
2868 desc->AddCodec(codec);
2869 return;
2870 }
2871 desc->set_codecs(codecs);
2872}
2873
2874// Adds or updates existing codec corresponding to |payload_type| according
2875// to |parameters|.
2876template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002877void UpdateCodec(MediaContentDescription* content_desc,
2878 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002879 const cricket::CodecParameterMap& parameters) {
2880 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002881 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2882 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002883 AddParameters(parameters, &new_codec);
2884 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2885}
2886
2887// Adds or updates existing codec corresponding to |payload_type| according
2888// to |feedback_param|.
2889template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002890void UpdateCodec(MediaContentDescription* content_desc,
2891 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002892 const cricket::FeedbackParam& feedback_param) {
2893 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002894 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2895 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002896 AddFeedbackParameter(feedback_param, &new_codec);
2897 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2898}
2899
Mirta Dvornicic479a3c02019-06-04 15:38:50 +02002900// Adds or updates existing video codec corresponding to |payload_type|
2901// according to |packetization|.
2902void UpdateVideoCodecPacketization(VideoContentDescription* video_desc,
2903 int payload_type,
2904 const std::string& packetization) {
2905 if (packetization != cricket::kPacketizationParamRaw) {
2906 // Ignore unsupported packetization attribute.
2907 return;
2908 }
2909
2910 // Codec might already have been populated (from rtpmap).
2911 cricket::VideoCodec codec =
2912 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
2913 codec.packetization = packetization;
2914 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
2915 codec);
2916}
2917
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002918template <class T>
2919bool PopWildcardCodec(std::vector<T>* codecs, T* wildcard_codec) {
2920 for (auto iter = codecs->begin(); iter != codecs->end(); ++iter) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002921 if (iter->id == kWildcardPayloadType) {
2922 *wildcard_codec = *iter;
2923 codecs->erase(iter);
2924 return true;
2925 }
2926 }
2927 return false;
2928}
2929
Yves Gerey665174f2018-06-19 15:03:05 +02002930template <class T>
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002931void UpdateFromWildcardCodecs(cricket::MediaContentDescriptionImpl<T>* desc) {
2932 auto codecs = desc->codecs();
2933 T wildcard_codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002934 if (!PopWildcardCodec(&codecs, &wildcard_codec)) {
2935 return;
2936 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002937 for (auto& codec : codecs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002938 AddFeedbackParameters(wildcard_codec.feedback_params, &codec);
2939 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002940 desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002941}
2942
Yves Gerey665174f2018-06-19 15:03:05 +02002943void AddAudioAttribute(const std::string& name,
2944 const std::string& value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002945 AudioContentDescription* audio_desc) {
2946 if (value.empty()) {
2947 return;
2948 }
2949 std::vector<cricket::AudioCodec> codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002950 for (cricket::AudioCodec& codec : codecs) {
2951 codec.params[name] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002952 }
2953 audio_desc->set_codecs(codecs);
2954}
2955
2956bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002957 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002958 int mline_index,
2959 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002960 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002961 size_t* pos,
2962 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002963 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002964 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002965 MediaContentDescription* media_desc,
2966 TransportDescription* transport,
Steve Anton5a1de872018-12-18 11:25:55 -08002967 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002968 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002969 RTC_DCHECK(media_desc != NULL);
2970 RTC_DCHECK(content_name != NULL);
2971 RTC_DCHECK(transport != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002972
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002973 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002974 MaybeCreateStaticPayloadAudioCodecs(payload_types, media_desc->as_audio());
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002975 }
2976
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002977 // The media level "ice-ufrag" and "ice-pwd".
2978 // The candidates before update the media level "ice-pwd" and "ice-ufrag".
2979 Candidates candidates_orig;
2980 std::string line;
2981 std::string mline_id;
2982 // Tracks created out of the ssrc attributes.
2983 StreamParamsVec tracks;
2984 SsrcInfoVec ssrc_infos;
2985 SsrcGroupVec ssrc_groups;
2986 std::string maxptime_as_string;
2987 std::string ptime_as_string;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002988 std::vector<std::string> stream_ids;
deadbeef9d3584c2016-02-16 17:54:10 -08002989 std::string track_id;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002990 SdpSerializer deserializer;
2991 std::vector<RidDescription> rids;
Amit Hilbucha2012042018-12-03 11:35:05 -08002992 SimulcastDescription simulcast;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002993
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002994 // Loop until the next m line
2995 while (!IsLineType(message, kLineTypeMedia, *pos)) {
2996 if (!GetLine(message, pos, &line)) {
2997 if (*pos >= message.size()) {
2998 break; // Done parsing
2999 } else {
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +00003000 return ParseFailed(message, *pos, "Invalid SDP line.", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003001 }
3002 }
3003
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003004 // RFC 4566
3005 // b=* (zero or more bandwidth information lines)
3006 if (IsLineType(line, kLineTypeSessionBandwidth)) {
3007 std::string bandwidth;
Taylor Brandstetteree8c2462020-07-27 15:52:02 -07003008 std::string bandwidth_type;
Philipp Hanckefbbfc022020-07-31 08:30:50 +02003009 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3010 kSdpDelimiterColonChar, &bandwidth_type,
3011 &bandwidth)) {
3012 return ParseFailed(
3013 line,
3014 "b= syntax error, does not match b=<modifier>:<bandwidth-value>.",
3015 error);
3016 }
3017 if (!(bandwidth_type == kApplicationSpecificBandwidth ||
3018 bandwidth_type == kTransportSpecificBandwidth)) {
3019 // Ignore unknown bandwidth types.
Taylor Brandstetteree8c2462020-07-27 15:52:02 -07003020 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003021 }
Taylor Brandstetteree8c2462020-07-27 15:52:02 -07003022 int b = 0;
3023 if (!GetValueFromString(line, bandwidth, &b, error)) {
3024 return false;
3025 }
3026 // TODO(deadbeef): Historically, applications may be setting a value
3027 // of -1 to mean "unset any previously set bandwidth limit", even
3028 // though ommitting the "b=AS" entirely will do just that. Once we've
3029 // transitioned applications to doing the right thing, it would be
3030 // better to treat this as a hard error instead of just ignoring it.
3031 if (bandwidth_type == kApplicationSpecificBandwidth && b == -1) {
3032 RTC_LOG(LS_WARNING) << "Ignoring \"b=AS:-1\"; will be treated as \"no "
3033 "bandwidth limit\".";
3034 continue;
3035 }
3036 if (b < 0) {
3037 return ParseFailed(
3038 line, "b=" + bandwidth_type + " value can't be negative.", error);
3039 }
3040 // We should never use more than the default bandwidth for RTP-based
3041 // data channels. Don't allow SDP to set the bandwidth, because
3042 // that would give JS the opportunity to "break the Internet".
3043 // See: https://code.google.com/p/chromium/issues/detail?id=280726
3044 // Disallow TIAS since it shouldn't be generated for RTP data channels in
3045 // the first place and provides another way to get around the limitation.
3046 if (media_type == cricket::MEDIA_TYPE_DATA &&
3047 cricket::IsRtpProtocol(protocol) &&
Philipp Hanckeafee7082020-10-22 11:55:58 +02003048 (b > cricket::kRtpDataMaxBandwidth / 1000 ||
Taylor Brandstetteree8c2462020-07-27 15:52:02 -07003049 bandwidth_type == kTransportSpecificBandwidth)) {
3050 rtc::StringBuilder description;
3051 description << "RTP-based data channels may not send more than "
Philipp Hanckeafee7082020-10-22 11:55:58 +02003052 << cricket::kRtpDataMaxBandwidth / 1000 << "kbps.";
Taylor Brandstetteree8c2462020-07-27 15:52:02 -07003053 return ParseFailed(line, description.str(), error);
3054 }
3055 // Convert values. Prevent integer overflow.
3056 if (bandwidth_type == kApplicationSpecificBandwidth) {
3057 b = std::min(b, INT_MAX / 1000) * 1000;
3058 } else {
3059 b = std::min(b, INT_MAX);
3060 }
3061 media_desc->set_bandwidth(b);
3062 media_desc->set_bandwidth_type(bandwidth_type);
Philipp Hancke20ecd8f2020-12-09 10:42:40 +01003063 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003064 }
3065
zhihuang38989e52017-03-21 11:04:53 -07003066 // Parse the media level connection data.
3067 if (IsLineType(line, kLineTypeConnection)) {
3068 rtc::SocketAddress addr;
3069 if (!ParseConnectionData(line, &addr, error)) {
3070 return false;
3071 }
3072 media_desc->set_connection_address(addr);
3073 continue;
3074 }
3075
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003076 if (!IsLineType(line, kLineTypeAttributes)) {
Steve Anton36b29d12017-10-30 09:57:42 -07003077 // TODO(deadbeef): Handle other lines if needed.
henrikad62c19e2020-12-07 17:52:34 +01003078 RTC_LOG(LS_VERBOSE) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003079 continue;
3080 }
3081
3082 // Handle attributes common to SCTP and RTP.
3083 if (HasAttribute(line, kAttributeMid)) {
3084 // RFC 3388
3085 // mid-attribute = "a=mid:" identification-tag
3086 // identification-tag = token
3087 // Use the mid identification-tag as the content name.
3088 if (!GetValue(line, kAttributeMid, &mline_id, error)) {
3089 return false;
3090 }
3091 *content_name = mline_id;
deadbeef25ed4352016-12-12 18:37:36 -08003092 } else if (HasAttribute(line, kAttributeBundleOnly)) {
3093 *bundle_only = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003094 } else if (HasAttribute(line, kAttributeCandidate)) {
3095 Candidate candidate;
3096 if (!ParseCandidate(line, &candidate, error, false)) {
3097 return false;
3098 }
deadbeef7bcdb692017-01-20 12:43:58 -08003099 // ParseCandidate will parse non-standard ufrag and password attributes,
3100 // since it's used for candidate trickling, but we only want to process
3101 // the "a=ice-ufrag"/"a=ice-pwd" values in a session description, so
3102 // strip them off at this point.
3103 candidate.set_username(std::string());
3104 candidate.set_password(std::string());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003105 candidates_orig.push_back(candidate);
3106 } else if (HasAttribute(line, kAttributeIceUfrag)) {
3107 if (!GetValue(line, kAttributeIceUfrag, &transport->ice_ufrag, error)) {
3108 return false;
3109 }
3110 } else if (HasAttribute(line, kAttributeIcePwd)) {
3111 if (!GetValue(line, kAttributeIcePwd, &transport->ice_pwd, error)) {
3112 return false;
3113 }
3114 } else if (HasAttribute(line, kAttributeIceOption)) {
3115 if (!ParseIceOptions(line, &transport->transport_options, error)) {
3116 return false;
3117 }
3118 } else if (HasAttribute(line, kAttributeFmtp)) {
3119 if (!ParseFmtpAttributes(line, media_type, media_desc, error)) {
3120 return false;
3121 }
3122 } else if (HasAttribute(line, kAttributeFingerprint)) {
Steve Anton4905edb2018-10-15 19:27:44 -07003123 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003124 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
3125 return false;
3126 }
Steve Anton4905edb2018-10-15 19:27:44 -07003127 transport->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00003128 } else if (HasAttribute(line, kAttributeSetup)) {
3129 if (!ParseDtlsSetup(line, &(transport->connection_role), error)) {
3130 return false;
3131 }
Philipp Hanckecd467b52021-01-29 09:29:47 +01003132 } else if (cricket::IsDtlsSctp(protocol) &&
3133 media_type == cricket::MEDIA_TYPE_DATA) {
Philipp Hancke4793e9e2020-12-15 12:40:57 +01003134 //
3135 // SCTP specific attributes
3136 //
3137 if (HasAttribute(line, kAttributeSctpPort)) {
Philipp Hancke4793e9e2020-12-15 12:40:57 +01003138 if (media_desc->as_sctp()->use_sctpmap()) {
3139 return ParseFailed(
3140 line, "sctp-port attribute can't be used with sctpmap.", error);
3141 }
3142 int sctp_port;
3143 if (!ParseSctpPort(line, &sctp_port, error)) {
3144 return false;
3145 }
3146 media_desc->as_sctp()->set_port(sctp_port);
3147 } else if (HasAttribute(line, kAttributeMaxMessageSize)) {
Philipp Hancke4793e9e2020-12-15 12:40:57 +01003148 int max_message_size;
3149 if (!ParseSctpMaxMessageSize(line, &max_message_size, error)) {
3150 return false;
3151 }
3152 media_desc->as_sctp()->set_max_message_size(max_message_size);
3153 } else if (HasAttribute(line, kAttributeSctpmap)) {
3154 // Ignore a=sctpmap: from early versions of draft-ietf-mmusic-sctp-sdp
3155 continue;
deadbeef7e146cb2016-09-28 10:04:34 -07003156 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003157 } else if (cricket::IsRtpProtocol(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003158 //
Philipp Hancke4793e9e2020-12-15 12:40:57 +01003159 // RTP specific attributes
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003160 //
3161 if (HasAttribute(line, kAttributeRtcpMux)) {
3162 media_desc->set_rtcp_mux(true);
deadbeef13871492015-12-09 12:37:51 -08003163 } else if (HasAttribute(line, kAttributeRtcpReducedSize)) {
3164 media_desc->set_rtcp_reduced_size(true);
Sebastian Janssone1795f42019-07-24 11:38:03 +02003165 } else if (HasAttribute(line, kAttributeRtcpRemoteEstimate)) {
3166 media_desc->set_remote_estimate(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003167 } else if (HasAttribute(line, kAttributeSsrcGroup)) {
3168 if (!ParseSsrcGroupAttribute(line, &ssrc_groups, error)) {
3169 return false;
3170 }
3171 } else if (HasAttribute(line, kAttributeSsrc)) {
Steve Antone831b8c2018-02-01 12:22:16 -08003172 if (!ParseSsrcAttribute(line, &ssrc_infos, msid_signaling, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003173 return false;
3174 }
3175 } else if (HasAttribute(line, kAttributeCrypto)) {
3176 if (!ParseCryptoAttribute(line, media_desc, error)) {
3177 return false;
3178 }
3179 } else if (HasAttribute(line, kAttributeRtpmap)) {
deadbeef67cf2c12016-04-13 10:07:16 -07003180 if (!ParseRtpmapAttribute(line, media_type, payload_types, media_desc,
3181 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003182 return false;
3183 }
3184 } else if (HasAttribute(line, kCodecParamMaxPTime)) {
3185 if (!GetValue(line, kCodecParamMaxPTime, &maxptime_as_string, error)) {
3186 return false;
3187 }
Mirta Dvornicic479a3c02019-06-04 15:38:50 +02003188 } else if (HasAttribute(line, kAttributePacketization)) {
3189 if (!ParsePacketizationAttribute(line, media_type, media_desc, error)) {
3190 return false;
3191 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003192 } else if (HasAttribute(line, kAttributeRtcpFb)) {
3193 if (!ParseRtcpFbAttribute(line, media_type, media_desc, error)) {
3194 return false;
3195 }
3196 } else if (HasAttribute(line, kCodecParamPTime)) {
3197 if (!GetValue(line, kCodecParamPTime, &ptime_as_string, error)) {
3198 return false;
3199 }
3200 } else if (HasAttribute(line, kAttributeSendOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003201 media_desc->set_direction(RtpTransceiverDirection::kSendOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003202 } else if (HasAttribute(line, kAttributeRecvOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003203 media_desc->set_direction(RtpTransceiverDirection::kRecvOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003204 } else if (HasAttribute(line, kAttributeInactive)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003205 media_desc->set_direction(RtpTransceiverDirection::kInactive);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003206 } else if (HasAttribute(line, kAttributeSendRecv)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003207 media_desc->set_direction(RtpTransceiverDirection::kSendRecv);
Johannes Kron0854eb62018-10-10 22:33:20 +02003208 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02003209 media_desc->set_extmap_allow_mixed_enum(
Johannes Kron0854eb62018-10-10 22:33:20 +02003210 MediaContentDescription::kMedia);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003211 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07003212 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003213 if (!ParseExtmap(line, &extmap, error)) {
3214 return false;
3215 }
3216 media_desc->AddRtpHeaderExtension(extmap);
3217 } else if (HasAttribute(line, kAttributeXGoogleFlag)) {
3218 // Experimental attribute. Conference mode activates more aggressive
3219 // AEC and NS settings.
Steve Anton36b29d12017-10-30 09:57:42 -07003220 // TODO(deadbeef): expose API to set these directly.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003221 std::string flag_value;
3222 if (!GetValue(line, kAttributeXGoogleFlag, &flag_value, error)) {
3223 return false;
3224 }
3225 if (flag_value.compare(kValueConference) == 0)
3226 media_desc->set_conference_mode(true);
deadbeef9d3584c2016-02-16 17:54:10 -08003227 } else if (HasAttribute(line, kAttributeMsid)) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07003228 if (!ParseMsidAttribute(line, &stream_ids, &track_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08003229 return false;
3230 }
Steve Antone831b8c2018-02-01 12:22:16 -08003231 *msid_signaling |= cricket::kMsidSignalingMediaSection;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003232 } else if (HasAttribute(line, kAttributeRid)) {
3233 const size_t kRidPrefixLength =
3234 kLinePrefixLength + arraysize(kAttributeRid);
3235 if (line.size() <= kRidPrefixLength) {
3236 RTC_LOG(LS_INFO) << "Ignoring empty RID attribute: " << line;
3237 continue;
3238 }
3239 RTCErrorOr<RidDescription> error_or_rid_description =
3240 deserializer.DeserializeRidDescription(
3241 line.substr(kRidPrefixLength));
3242
3243 // Malformed a=rid lines are discarded.
3244 if (!error_or_rid_description.ok()) {
3245 RTC_LOG(LS_INFO) << "Ignoring malformed RID line: '" << line
3246 << "'. Error: "
3247 << error_or_rid_description.error().message();
3248 continue;
3249 }
3250
3251 rids.push_back(error_or_rid_description.MoveValue());
Amit Hilbucha2012042018-12-03 11:35:05 -08003252 } else if (HasAttribute(line, kAttributeSimulcast)) {
3253 const size_t kSimulcastPrefixLength =
3254 kLinePrefixLength + arraysize(kAttributeSimulcast);
3255 if (line.size() <= kSimulcastPrefixLength) {
3256 return ParseFailed(line, "Simulcast attribute is empty.", error);
3257 }
3258
3259 if (!simulcast.empty()) {
3260 return ParseFailed(line, "Multiple Simulcast attributes specified.",
3261 error);
3262 }
3263
Amit Hilbucha2012042018-12-03 11:35:05 -08003264 RTCErrorOr<SimulcastDescription> error_or_simulcast =
3265 deserializer.DeserializeSimulcastDescription(
3266 line.substr(kSimulcastPrefixLength));
3267 if (!error_or_simulcast.ok()) {
3268 return ParseFailed(line,
3269 std::string("Malformed simulcast line: ") +
3270 error_or_simulcast.error().message(),
3271 error);
3272 }
3273
3274 simulcast = error_or_simulcast.value();
Harald Alvestrandba90b7f2020-12-08 12:56:56 +00003275 } else if (HasAttribute(line, kAttributeRtcp)) {
3276 // Ignore and do not log a=rtcp line.
3277 // JSEP section 5.8.2 (media section parsing) says to ignore it.
3278 continue;
Amit Hilbucha2012042018-12-03 11:35:05 -08003279 } else {
3280 // Unrecognized attribute in RTP protocol.
Philipp Hanckedf9245c2020-12-08 14:00:37 +01003281 RTC_LOG(LS_VERBOSE) << "Ignored line: " << line;
Amit Hilbucha2012042018-12-03 11:35:05 -08003282 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003283 }
3284 } else {
3285 // Only parse lines that we are interested of.
Philipp Hanckedf9245c2020-12-08 14:00:37 +01003286 RTC_LOG(LS_VERBOSE) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003287 continue;
3288 }
3289 }
3290
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003291 // Remove duplicate or inconsistent rids.
3292 RemoveInvalidRidDescriptions(payload_types, &rids);
3293
3294 // If simulcast is specifed, split the rids into send and receive.
3295 // Rids that do not appear in simulcast attribute will be removed.
3296 // If it is not specified, we assume that all rids are for send layers.
Amit Hilbuchb7446ed2019-01-28 12:25:25 -08003297 std::vector<RidDescription> send_rids;
Florent Castellib60141b2019-07-03 12:47:54 +02003298 std::vector<RidDescription> receive_rids;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003299 if (!simulcast.empty()) {
3300 // Verify that the rids in simulcast match rids in sdp.
3301 RemoveInvalidRidsFromSimulcast(rids, &simulcast);
3302
3303 // Use simulcast description to figure out Send / Receive RIDs.
3304 std::map<std::string, RidDescription> rid_map;
3305 for (const RidDescription& rid : rids) {
3306 rid_map[rid.rid] = rid;
3307 }
3308
3309 for (const auto& layer : simulcast.send_layers().GetAllLayers()) {
3310 auto iter = rid_map.find(layer.rid);
3311 RTC_DCHECK(iter != rid_map.end());
3312 send_rids.push_back(iter->second);
3313 }
3314
Florent Castellib60141b2019-07-03 12:47:54 +02003315 for (const auto& layer : simulcast.receive_layers().GetAllLayers()) {
3316 auto iter = rid_map.find(layer.rid);
3317 RTC_DCHECK(iter != rid_map.end());
3318 receive_rids.push_back(iter->second);
3319 }
3320
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003321 media_desc->set_simulcast_description(simulcast);
3322 } else {
3323 send_rids = rids;
3324 }
3325
Florent Castellib60141b2019-07-03 12:47:54 +02003326 media_desc->set_receive_rids(receive_rids);
3327
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003328 // Create tracks from the |ssrc_infos|.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -08003329 // If the stream_id/track_id for all SSRCS are identical, one StreamParams
3330 // will be created in CreateTracksFromSsrcInfos, containing all the SSRCs from
3331 // the m= section.
Seth Hampson5897a6e2018-04-03 11:16:33 -07003332 if (!ssrc_infos.empty()) {
3333 CreateTracksFromSsrcInfos(ssrc_infos, stream_ids, track_id, &tracks,
3334 *msid_signaling);
3335 } else if (media_type != cricket::MEDIA_TYPE_DATA &&
3336 (*msid_signaling & cricket::kMsidSignalingMediaSection)) {
3337 // If the stream_ids/track_id was signaled but SSRCs were unsignaled we
3338 // still create a track. This isn't done for data media types because
3339 // StreamParams aren't used for SCTP streams, and RTP data channels don't
3340 // support unsignaled SSRCs.
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003341 CreateTrackWithNoSsrcs(stream_ids, track_id, send_rids, &tracks);
3342 }
3343
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003344 // Add the ssrc group to the track.
Steve Anton4daf66e2018-09-07 14:55:53 -07003345 for (const SsrcGroup& ssrc_group : ssrc_groups) {
3346 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003347 continue;
3348 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003349 uint32_t ssrc = ssrc_group.ssrcs.front();
3350 for (StreamParams& track : tracks) {
3351 if (track.has_ssrc(ssrc)) {
3352 track.ssrc_groups.push_back(ssrc_group);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003353 }
3354 }
3355 }
3356
3357 // Add the new tracks to the |media_desc|.
deadbeef9d3584c2016-02-16 17:54:10 -08003358 for (StreamParams& track : tracks) {
3359 media_desc->AddStream(track);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003360 }
3361
3362 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003363 AudioContentDescription* audio_desc = media_desc->as_audio();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003364 UpdateFromWildcardCodecs(audio_desc);
3365
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003366 // Verify audio codec ensures that no audio codec has been populated with
3367 // only fmtp.
3368 if (!VerifyAudioCodecs(audio_desc)) {
3369 return ParseFailed("Failed to parse audio codecs correctly.", error);
3370 }
3371 AddAudioAttribute(kCodecParamMaxPTime, maxptime_as_string, audio_desc);
3372 AddAudioAttribute(kCodecParamPTime, ptime_as_string, audio_desc);
3373 }
3374
3375 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003376 VideoContentDescription* video_desc = media_desc->as_video();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003377 UpdateFromWildcardCodecs(video_desc);
3378 // Verify video codec ensures that no video codec has been populated with
3379 // only rtcp-fb.
3380 if (!VerifyVideoCodecs(video_desc)) {
3381 return ParseFailed("Failed to parse video codecs correctly.", error);
3382 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003383 }
3384
3385 // RFC 5245
3386 // Update the candidates with the media level "ice-pwd" and "ice-ufrag".
Steve Anton4daf66e2018-09-07 14:55:53 -07003387 for (Candidate& candidate : candidates_orig) {
3388 RTC_DCHECK(candidate.username().empty() ||
3389 candidate.username() == transport->ice_ufrag);
3390 candidate.set_username(transport->ice_ufrag);
3391 RTC_DCHECK(candidate.password().empty());
3392 candidate.set_password(transport->ice_pwd);
3393 candidates->push_back(
Mirko Bonadei317a1f02019-09-17 17:06:18 +02003394 std::make_unique<JsepIceCandidate>(mline_id, mline_index, candidate));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003395 }
Amit Hilbucha2012042018-12-03 11:35:05 -08003396
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003397 return true;
3398}
3399
Steve Antone831b8c2018-02-01 12:22:16 -08003400bool ParseSsrcAttribute(const std::string& line,
3401 SsrcInfoVec* ssrc_infos,
3402 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003403 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003404 RTC_DCHECK(ssrc_infos != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003405 // RFC 5576
3406 // a=ssrc:<ssrc-id> <attribute>
3407 // a=ssrc:<ssrc-id> <attribute>:<value>
3408 std::string field1, field2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003409 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3410 kSdpDelimiterSpaceChar, &field1, &field2)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003411 const size_t expected_fields = 2;
3412 return ParseFailedExpectFieldNum(line, expected_fields, error);
3413 }
3414
3415 // ssrc:<ssrc-id>
3416 std::string ssrc_id_s;
3417 if (!GetValue(field1, kAttributeSsrc, &ssrc_id_s, error)) {
3418 return false;
3419 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003420 uint32_t ssrc_id = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003421 if (!GetValueFromString(line, ssrc_id_s, &ssrc_id, error)) {
3422 return false;
3423 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003424
3425 std::string attribute;
3426 std::string value;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003427 if (!rtc::tokenize_first(field2, kSdpDelimiterColonChar, &attribute,
3428 &value)) {
3429 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003430 description << "Failed to get the ssrc attribute value from " << field2
3431 << ". Expected format <attribute>:<value>.";
3432 return ParseFailed(line, description.str(), error);
3433 }
3434
3435 // Check if there's already an item for this |ssrc_id|. Create a new one if
3436 // there isn't.
Steve Anton64b626b2019-01-28 17:25:26 -08003437 auto ssrc_info_it =
3438 absl::c_find_if(*ssrc_infos, [ssrc_id](const SsrcInfo& ssrc_info) {
3439 return ssrc_info.ssrc_id == ssrc_id;
3440 });
Steve Anton4daf66e2018-09-07 14:55:53 -07003441 if (ssrc_info_it == ssrc_infos->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003442 SsrcInfo info;
3443 info.ssrc_id = ssrc_id;
3444 ssrc_infos->push_back(info);
Steve Anton4daf66e2018-09-07 14:55:53 -07003445 ssrc_info_it = ssrc_infos->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003446 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003447 SsrcInfo& ssrc_info = *ssrc_info_it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003448
3449 // Store the info to the |ssrc_info|.
3450 if (attribute == kSsrcAttributeCname) {
3451 // RFC 5576
3452 // cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003453 ssrc_info.cname = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003454 } else if (attribute == kSsrcAttributeMsid) {
3455 // draft-alvestrand-mmusic-msid-00
Seth Hampson5b4f0752018-04-02 16:31:36 -07003456 // msid:identifier [appdata]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003457 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003458 rtc::split(value, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003459 if (fields.size() < 1 || fields.size() > 2) {
Yves Gerey665174f2018-06-19 15:03:05 +02003460 return ParseFailed(
3461 line, "Expected format \"msid:<identifier>[ <appdata>]\".", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003462 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003463 ssrc_info.stream_id = fields[0];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003464 if (fields.size() == 2) {
Steve Anton4daf66e2018-09-07 14:55:53 -07003465 ssrc_info.track_id = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003466 }
Steve Antone831b8c2018-02-01 12:22:16 -08003467 *msid_signaling |= cricket::kMsidSignalingSsrcAttribute;
Artem Titovf0a34f22020-03-16 17:52:04 +00003468 } else if (attribute == kSsrcAttributeMslabel) {
3469 // draft-alvestrand-rtcweb-mid-01
3470 // mslabel:<value>
3471 ssrc_info.mslabel = value;
3472 } else if (attribute == kSSrcAttributeLabel) {
3473 // The label isn't defined.
3474 // label:<value>
3475 ssrc_info.label = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003476 }
3477 return true;
3478}
3479
3480bool ParseSsrcGroupAttribute(const std::string& line,
3481 SsrcGroupVec* ssrc_groups,
3482 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003483 RTC_DCHECK(ssrc_groups != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003484 // RFC 5576
3485 // a=ssrc-group:<semantics> <ssrc-id> ...
3486 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003487 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003488 const size_t expected_min_fields = 2;
3489 if (fields.size() < expected_min_fields) {
3490 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3491 }
3492 std::string semantics;
3493 if (!GetValue(fields[0], kAttributeSsrcGroup, &semantics, error)) {
3494 return false;
3495 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003496 std::vector<uint32_t> ssrcs;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003497 for (size_t i = 1; i < fields.size(); ++i) {
Peter Boström0c4e06b2015-10-07 12:23:21 +02003498 uint32_t ssrc = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003499 if (!GetValueFromString(line, fields[i], &ssrc, error)) {
3500 return false;
3501 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003502 ssrcs.push_back(ssrc);
3503 }
3504 ssrc_groups->push_back(SsrcGroup(semantics, ssrcs));
3505 return true;
3506}
3507
3508bool ParseCryptoAttribute(const std::string& line,
3509 MediaContentDescription* media_desc,
3510 SdpParseError* error) {
3511 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003512 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003513 // RFC 4568
3514 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
3515 const size_t expected_min_fields = 3;
3516 if (fields.size() < expected_min_fields) {
3517 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3518 }
3519 std::string tag_value;
3520 if (!GetValue(fields[0], kAttributeCrypto, &tag_value, error)) {
3521 return false;
3522 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003523 int tag = 0;
3524 if (!GetValueFromString(line, tag_value, &tag, error)) {
3525 return false;
3526 }
jbauch083b73f2015-07-16 02:46:32 -07003527 const std::string& crypto_suite = fields[1];
3528 const std::string& key_params = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003529 std::string session_params;
3530 if (fields.size() > 3) {
3531 session_params = fields[3];
3532 }
Yves Gerey665174f2018-06-19 15:03:05 +02003533 media_desc->AddCrypto(
3534 CryptoParams(tag, crypto_suite, key_params, session_params));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003535 return true;
3536}
3537
3538// Updates or creates a new codec entry in the audio description with according
deadbeef67cf2c12016-04-13 10:07:16 -07003539// to |name|, |clockrate|, |bitrate|, and |channels|.
3540void UpdateCodec(int payload_type,
3541 const std::string& name,
3542 int clockrate,
3543 int bitrate,
3544 size_t channels,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003545 AudioContentDescription* audio_desc) {
3546 // Codec may already be populated with (only) optional parameters
3547 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003548 cricket::AudioCodec codec =
3549 GetCodecWithPayloadType(audio_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003550 codec.name = name;
3551 codec.clockrate = clockrate;
3552 codec.bitrate = bitrate;
3553 codec.channels = channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003554 AddOrReplaceCodec<AudioContentDescription, cricket::AudioCodec>(audio_desc,
3555 codec);
3556}
3557
3558// Updates or creates a new codec entry in the video description according to
deadbeef67cf2c12016-04-13 10:07:16 -07003559// |name|, |width|, |height|, and |framerate|.
3560void UpdateCodec(int payload_type,
3561 const std::string& name,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003562 VideoContentDescription* video_desc) {
3563 // Codec may already be populated with (only) optional parameters
3564 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003565 cricket::VideoCodec codec =
3566 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003567 codec.name = name;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003568 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
3569 codec);
3570}
3571
3572bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003573 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -07003574 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003575 MediaContentDescription* media_desc,
3576 SdpParseError* error) {
3577 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003578 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003579 // RFC 4566
3580 // a=rtpmap:<payload type> <encoding name>/<clock rate>[/<encodingparameters>]
3581 const size_t expected_min_fields = 2;
3582 if (fields.size() < expected_min_fields) {
3583 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3584 }
3585 std::string payload_type_value;
3586 if (!GetValue(fields[0], kAttributeRtpmap, &payload_type_value, error)) {
3587 return false;
3588 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003589 int payload_type = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003590 if (!GetPayloadTypeFromString(line, payload_type_value, &payload_type,
3591 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003592 return false;
3593 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003594
Steve Anton64b626b2019-01-28 17:25:26 -08003595 if (!absl::c_linear_search(payload_types, payload_type)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003596 RTC_LOG(LS_WARNING) << "Ignore rtpmap line that did not appear in the "
Jonas Olsson45cc8902018-02-13 10:37:07 +01003597 "<fmt> of the m-line: "
3598 << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003599 return true;
3600 }
jbauch083b73f2015-07-16 02:46:32 -07003601 const std::string& encoder = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003602 std::vector<std::string> codec_params;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00003603 rtc::split(encoder, '/', &codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003604 // <encoding name>/<clock rate>[/<encodingparameters>]
3605 // 2 mandatory fields
3606 if (codec_params.size() < 2 || codec_params.size() > 3) {
3607 return ParseFailed(line,
3608 "Expected format \"<encoding name>/<clock rate>"
3609 "[/<encodingparameters>]\".",
3610 error);
3611 }
jbauch083b73f2015-07-16 02:46:32 -07003612 const std::string& encoding_name = codec_params[0];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003613 int clock_rate = 0;
3614 if (!GetValueFromString(line, codec_params[1], &clock_rate, error)) {
3615 return false;
3616 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003617 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003618 VideoContentDescription* video_desc = media_desc->as_video();
Yves Gerey665174f2018-06-19 15:03:05 +02003619 UpdateCodec(payload_type, encoding_name, video_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003620 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3621 // RFC 4566
3622 // For audio streams, <encoding parameters> indicates the number
3623 // of audio channels. This parameter is OPTIONAL and may be
3624 // omitted if the number of channels is one, provided that no
3625 // additional parameters are needed.
Peter Kasting69558702016-01-12 16:26:35 -08003626 size_t channels = 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003627 if (codec_params.size() == 3) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003628 if (!GetValueFromString(line, codec_params[2], &channels, error)) {
3629 return false;
3630 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003631 }
Steve Antonb1c1de12017-12-21 15:14:30 -08003632 AudioContentDescription* audio_desc = media_desc->as_audio();
ossue1405ad2017-01-23 08:55:48 -08003633 UpdateCodec(payload_type, encoding_name, clock_rate, 0, channels,
deadbeef67cf2c12016-04-13 10:07:16 -07003634 audio_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003635 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003636 RtpDataContentDescription* data_desc = media_desc->as_rtp_data();
3637 if (data_desc) {
3638 data_desc->AddCodec(cricket::RtpDataCodec(payload_type, encoding_name));
3639 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003640 }
3641 return true;
3642}
3643
Yves Gerey665174f2018-06-19 15:03:05 +02003644bool ParseFmtpParam(const std::string& line,
3645 std::string* parameter,
3646 std::string* value,
3647 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003648 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, parameter, value)) {
Philipp Hanckef2a4ec12020-07-01 21:07:32 +02003649 // Support for non-key-value lines like RFC 2198 or RFC 4733.
3650 *parameter = "";
3651 *value = line;
3652 return true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003653 }
3654 // a=fmtp:<payload_type> <param1>=<value1>; <param2>=<value2>; ...
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003655 return true;
3656}
3657
Yves Gerey665174f2018-06-19 15:03:05 +02003658bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003659 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003660 MediaContentDescription* media_desc,
3661 SdpParseError* error) {
3662 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3663 media_type != cricket::MEDIA_TYPE_VIDEO) {
3664 return true;
3665 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003666
3667 std::string line_payload;
3668 std::string line_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003669
Philipp Hanckef2a4ec12020-07-01 21:07:32 +02003670 // https://tools.ietf.org/html/rfc4566#section-6
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003671 // a=fmtp:<format> <format specific parameters>
3672 // At least two fields, whereas the second one is any of the optional
3673 // parameters.
Jonas Olssonec9e4922018-09-05 09:53:49 +02003674 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3675 kSdpDelimiterSpaceChar, &line_payload,
3676 &line_params)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003677 ParseFailedExpectMinFieldNum(line, 2, error);
3678 return false;
3679 }
3680
Donald Curtis0e07f922015-05-15 09:21:23 -07003681 // Parse out the payload information.
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003682 std::string payload_type_str;
Donald Curtis0e07f922015-05-15 09:21:23 -07003683 if (!GetValue(line_payload, kAttributeFmtp, &payload_type_str, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003684 return false;
3685 }
3686
Donald Curtis0e07f922015-05-15 09:21:23 -07003687 int payload_type = 0;
Donald Curtis144d0182015-05-15 13:14:24 -07003688 if (!GetPayloadTypeFromString(line_payload, payload_type_str, &payload_type,
3689 error)) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003690 return false;
3691 }
3692
3693 // Parse out format specific parameters.
3694 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003695 rtc::split(line_params, kSdpDelimiterSemicolonChar, &fields);
Donald Curtis0e07f922015-05-15 09:21:23 -07003696
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003697 cricket::CodecParameterMap codec_params;
Donald Curtis144d0182015-05-15 13:14:24 -07003698 for (auto& iter : fields) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003699 std::string name;
3700 std::string value;
3701 if (!ParseFmtpParam(rtc::string_trim(iter), &name, &value, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003702 return false;
3703 }
Philipp Hanckef2a4ec12020-07-01 21:07:32 +02003704 if (codec_params.find(name) != codec_params.end()) {
3705 RTC_LOG(LS_INFO) << "Overwriting duplicate fmtp parameter with key \""
3706 << name << "\".";
3707 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003708 codec_params[name] = value;
3709 }
3710
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003711 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3712 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003713 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003714 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
3715 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003716 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003717 }
3718 return true;
3719}
3720
Mirta Dvornicic479a3c02019-06-04 15:38:50 +02003721bool ParsePacketizationAttribute(const std::string& line,
3722 const cricket::MediaType media_type,
3723 MediaContentDescription* media_desc,
3724 SdpParseError* error) {
3725 if (media_type != cricket::MEDIA_TYPE_VIDEO) {
3726 return true;
3727 }
3728 std::vector<std::string> packetization_fields;
3729 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &packetization_fields);
3730 if (packetization_fields.size() < 2) {
3731 return ParseFailedGetValue(line, kAttributePacketization, error);
3732 }
3733 std::string payload_type_string;
3734 if (!GetValue(packetization_fields[0], kAttributePacketization,
3735 &payload_type_string, error)) {
3736 return false;
3737 }
3738 int payload_type;
3739 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3740 error)) {
3741 return false;
3742 }
3743 std::string packetization = packetization_fields[1];
3744 UpdateVideoCodecPacketization(media_desc->as_video(), payload_type,
3745 packetization);
3746 return true;
3747}
3748
Yves Gerey665174f2018-06-19 15:03:05 +02003749bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003750 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003751 MediaContentDescription* media_desc,
3752 SdpParseError* error) {
3753 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3754 media_type != cricket::MEDIA_TYPE_VIDEO) {
3755 return true;
3756 }
3757 std::vector<std::string> rtcp_fb_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003758 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &rtcp_fb_fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003759 if (rtcp_fb_fields.size() < 2) {
3760 return ParseFailedGetValue(line, kAttributeRtcpFb, error);
3761 }
3762 std::string payload_type_string;
3763 if (!GetValue(rtcp_fb_fields[0], kAttributeRtcpFb, &payload_type_string,
3764 error)) {
3765 return false;
3766 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003767 int payload_type = kWildcardPayloadType;
3768 if (payload_type_string != "*") {
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003769 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3770 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003771 return false;
3772 }
3773 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003774 std::string id = rtcp_fb_fields[1];
3775 std::string param = "";
3776 for (std::vector<std::string>::iterator iter = rtcp_fb_fields.begin() + 2;
3777 iter != rtcp_fb_fields.end(); ++iter) {
3778 param.append(*iter);
3779 }
3780 const cricket::FeedbackParam feedback_param(id, param);
3781
3782 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003783 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
3784 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003785 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003786 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
3787 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003788 }
3789 return true;
3790}
3791
3792} // namespace webrtc