blob: 0c09fa2ae85f0cd024a4fc4c41a667a2d2106384 [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"
Steve Anton5a1de872018-12-18 11:25:55 -080027#include "absl/memory/memory.h"
Niels Möller039743e2018-10-23 10:07:25 +020028#include "absl/strings/match.h"
Patrik Höglunde2d6a062017-10-05 14:53:33 +020029#include "api/candidate.h"
Steve Anton10542f22019-01-11 09:11:00 -080030#include "api/crypto_params.h"
31#include "api/jsep_ice_candidate.h"
32#include "api/jsep_session_description.h"
33#include "api/media_types.h"
isheriff6f8d6862016-05-26 11:24:55 -070034// for RtpExtension
Steve Anton10542f22019-01-11 09:11:00 -080035#include "api/rtp_parameters.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020036#include "media/base/codec.h"
Steve Anton10542f22019-01-11 09:11:00 -080037#include "media/base/media_constants.h"
38#include "media/base/rtp_utils.h"
39#include "media/sctp/sctp_transport_internal.h"
40#include "p2p/base/p2p_constants.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020041#include "p2p/base/port.h"
Steve Anton10542f22019-01-11 09:11:00 -080042#include "pc/media_session.h"
43#include "pc/sdp_serializer.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020044#include "rtc_base/arraysize.h"
45#include "rtc_base/checks.h"
46#include "rtc_base/logging.h"
Steve Anton10542f22019-01-11 09:11:00 -080047#include "rtc_base/message_digest.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;
56using cricket::DataContentDescription;
Harald Alvestrand141c0ad2019-05-05 19:00:00 +000057using cricket::ICE_CANDIDATE_COMPONENT_RTCP;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020058using cricket::ICE_CANDIDATE_COMPONENT_RTP;
59using cricket::kCodecParamAssociatedPayloadType;
60using cricket::kCodecParamMaxAverageBitrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000061using cricket::kCodecParamMaxBitrate;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020062using cricket::kCodecParamMaxPlaybackRate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000063using cricket::kCodecParamMaxPTime;
64using cricket::kCodecParamMaxQuantization;
65using cricket::kCodecParamMinBitrate;
66using cricket::kCodecParamMinPTime;
67using cricket::kCodecParamPTime;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020068using cricket::kCodecParamSctpProtocol;
69using cricket::kCodecParamSctpStreams;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000070using cricket::kCodecParamSPropStereo;
buildbot@webrtc.orged97bb02014-05-07 11:15:20 +000071using cricket::kCodecParamStartBitrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000072using cricket::kCodecParamStereo;
Harald Alvestrand141c0ad2019-05-05 19:00:00 +000073using cricket::kCodecParamUseDtx;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020074using cricket::kCodecParamUseInbandFec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000075using cricket::MediaContentDescription;
Harald Alvestrand141c0ad2019-05-05 19:00:00 +000076using cricket::MediaProtocolType;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020077using cricket::MediaType;
Harald Alvestrand141c0ad2019-05-05 19:00:00 +000078using cricket::RidDescription;
Harald Alvestrand5fc28b12019-05-13 13:36:16 +020079using cricket::RtpDataContentDescription;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020080using cricket::RtpHeaderExtensions;
Harald Alvestrand5fc28b12019-05-13 13:36:16 +020081using cricket::SctpDataContentDescription;
Amit Hilbucha2012042018-12-03 11:35:05 -080082using cricket::SimulcastDescription;
Amit Hilbuchc57d5732018-12-11 15:30:11 -080083using cricket::SimulcastLayer;
84using cricket::SimulcastLayerList;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000085using cricket::SsrcGroup;
86using cricket::StreamParams;
87using cricket::StreamParamsVec;
88using cricket::TransportDescription;
89using cricket::TransportInfo;
90using cricket::VideoContentDescription;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +000091using rtc::SocketAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000092
henrike@webrtc.org28e20752013-07-10 00:45:36 +000093namespace cricket {
94class SessionDescription;
95}
96
deadbeef90f1e1e2017-02-10 12:35:05 -080097// TODO(deadbeef): Switch to using anonymous namespace rather than declaring
98// everything "static".
henrike@webrtc.org28e20752013-07-10 00:45:36 +000099namespace webrtc {
100
101// Line type
102// RFC 4566
103// An SDP session description consists of a number of lines of text of
104// the form:
105// <type>=<value>
106// where <type> MUST be exactly one case-significant character.
deadbeef9d3584c2016-02-16 17:54:10 -0800107static const int kLinePrefixLength = 2; // Length of <type>=
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000108static const char kLineTypeVersion = 'v';
109static const char kLineTypeOrigin = 'o';
110static const char kLineTypeSessionName = 's';
111static const char kLineTypeSessionInfo = 'i';
112static const char kLineTypeSessionUri = 'u';
113static const char kLineTypeSessionEmail = 'e';
114static const char kLineTypeSessionPhone = 'p';
115static const char kLineTypeSessionBandwidth = 'b';
116static const char kLineTypeTiming = 't';
117static const char kLineTypeRepeatTimes = 'r';
118static const char kLineTypeTimeZone = 'z';
119static const char kLineTypeEncryptionKey = 'k';
120static const char kLineTypeMedia = 'm';
121static const char kLineTypeConnection = 'c';
122static const char kLineTypeAttributes = 'a';
123
124// Attributes
125static const char kAttributeGroup[] = "group";
126static const char kAttributeMid[] = "mid";
deadbeef9d3584c2016-02-16 17:54:10 -0800127static const char kAttributeMsid[] = "msid";
deadbeef25ed4352016-12-12 18:37:36 -0800128static const char kAttributeBundleOnly[] = "bundle-only";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000129static const char kAttributeRtcpMux[] = "rtcp-mux";
deadbeef13871492015-12-09 12:37:51 -0800130static const char kAttributeRtcpReducedSize[] = "rtcp-rsize";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000131static const char kAttributeSsrc[] = "ssrc";
132static const char kSsrcAttributeCname[] = "cname";
Johannes Kron0854eb62018-10-10 22:33:20 +0200133static const char kAttributeExtmapAllowMixed[] = "extmap-allow-mixed";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000134static const char kAttributeExtmap[] = "extmap";
135// draft-alvestrand-mmusic-msid-01
136// a=msid-semantic: WMS
Seth Hampson5b4f0752018-04-02 16:31:36 -0700137// This is a legacy field supported only for Plan B semantics.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000138static const char kAttributeMsidSemantics[] = "msid-semantic";
139static const char kMediaStreamSemantic[] = "WMS";
140static const char kSsrcAttributeMsid[] = "msid";
141static const char kDefaultMsid[] = "default";
Seth Hampson5b4f0752018-04-02 16:31:36 -0700142static const char kNoStreamMsid[] = "-";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000143static const char kSsrcAttributeMslabel[] = "mslabel";
144static const char kSSrcAttributeLabel[] = "label";
145static const char kAttributeSsrcGroup[] = "ssrc-group";
146static const char kAttributeCrypto[] = "crypto";
147static const char kAttributeCandidate[] = "candidate";
148static const char kAttributeCandidateTyp[] = "typ";
149static const char kAttributeCandidateRaddr[] = "raddr";
150static const char kAttributeCandidateRport[] = "rport";
honghaiza54a0802015-12-16 18:37:23 -0800151static const char kAttributeCandidateUfrag[] = "ufrag";
152static const char kAttributeCandidatePwd[] = "pwd";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000153static const char kAttributeCandidateGeneration[] = "generation";
honghaiza0c44ea2016-03-23 16:07:48 -0700154static const char kAttributeCandidateNetworkId[] = "network-id";
honghaize1a0c942016-02-16 14:54:56 -0800155static const char kAttributeCandidateNetworkCost[] = "network-cost";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000156static const char kAttributeFingerprint[] = "fingerprint";
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000157static const char kAttributeSetup[] = "setup";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000158static const char kAttributeFmtp[] = "fmtp";
159static const char kAttributeRtpmap[] = "rtpmap";
wu@webrtc.org78187522013-10-07 23:32:02 +0000160static const char kAttributeSctpmap[] = "sctpmap";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000161static const char kAttributeRtcp[] = "rtcp";
162static const char kAttributeIceUfrag[] = "ice-ufrag";
163static const char kAttributeIcePwd[] = "ice-pwd";
164static const char kAttributeIceLite[] = "ice-lite";
165static const char kAttributeIceOption[] = "ice-options";
166static const char kAttributeSendOnly[] = "sendonly";
167static const char kAttributeRecvOnly[] = "recvonly";
168static const char kAttributeRtcpFb[] = "rtcp-fb";
169static const char kAttributeSendRecv[] = "sendrecv";
170static const char kAttributeInactive[] = "inactive";
Harald Alvestrand48cce4d2019-04-11 10:41:24 +0200171// draft-ietf-mmusic-sctp-sdp-26
172// a=sctp-port, a=max-message-size
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +0000173static const char kAttributeSctpPort[] = "sctp-port";
Harald Alvestrand48cce4d2019-04-11 10:41:24 +0200174static const char kAttributeMaxMessageSize[] = "max-message-size";
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +0200175static const int kDefaultSctpMaxMessageSize = 65536;
Amit Hilbucha2012042018-12-03 11:35:05 -0800176// draft-ietf-mmusic-sdp-simulcast-13
177// a=simulcast
178static const char kAttributeSimulcast[] = "simulcast";
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800179// draft-ietf-mmusic-rid-15
180// a=rid
181static const char kAttributeRid[] = "rid";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000182
183// Experimental flags
184static const char kAttributeXGoogleFlag[] = "x-google-flag";
185static const char kValueConference[] = "conference";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000186
187// Candidate
188static const char kCandidateHost[] = "host";
189static const char kCandidateSrflx[] = "srflx";
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700190static const char kCandidatePrflx[] = "prflx";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000191static const char kCandidateRelay[] = "relay";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +0000192static const char kTcpCandidateType[] = "tcptype";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000193
Jonas Olssonec9e4922018-09-05 09:53:49 +0200194// rtc::StringBuilder doesn't have a << overload for chars, while rtc::split and
195// rtc::tokenize_first both take a char delimiter. To handle both cases these
196// constants come in pairs of a chars and length-one strings.
197static const char kSdpDelimiterEqual[] = "=";
198static const char kSdpDelimiterEqualChar = '=';
199static const char kSdpDelimiterSpace[] = " ";
200static const char kSdpDelimiterSpaceChar = ' ';
201static const char kSdpDelimiterColon[] = ":";
202static const char kSdpDelimiterColonChar = ':';
203static const char kSdpDelimiterSemicolon[] = ";";
204static const char kSdpDelimiterSemicolonChar = ';';
205static const char kSdpDelimiterSlashChar = '/';
206static const char kNewLine[] = "\n";
207static const char kNewLineChar = '\n';
208static const char kReturnChar = '\r';
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000209static const char kLineBreak[] = "\r\n";
210
Steve Anton36b29d12017-10-30 09:57:42 -0700211// TODO(deadbeef): Generate the Session and Time description
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000212// instead of hardcoding.
213static const char kSessionVersion[] = "v=0";
214// RFC 4566
215static const char kSessionOriginUsername[] = "-";
216static const char kSessionOriginSessionId[] = "0";
217static const char kSessionOriginSessionVersion[] = "0";
218static const char kSessionOriginNettype[] = "IN";
219static const char kSessionOriginAddrtype[] = "IP4";
220static const char kSessionOriginAddress[] = "127.0.0.1";
221static const char kSessionName[] = "s=-";
222static const char kTimeDescription[] = "t=0 0";
223static const char kAttrGroup[] = "a=group:BUNDLE";
224static const char kConnectionNettype[] = "IN";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000225static const char kConnectionIpv4Addrtype[] = "IP4";
226static const char kConnectionIpv6Addrtype[] = "IP6";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000227static const char kMediaTypeVideo[] = "video";
228static const char kMediaTypeAudio[] = "audio";
229static const char kMediaTypeData[] = "application";
230static const char kMediaPortRejected[] = "0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000231// draft-ietf-mmusic-trickle-ice-01
232// When no candidates have been gathered, set the connection
233// address to IP6 ::.
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000234// TODO(perkj): FF can not parse IP6 ::. See http://crbug/430333
235// Use IPV4 per default.
236static const char kDummyAddress[] = "0.0.0.0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000237static const char kDummyPort[] = "9";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000238// RFC 3556
239static const char kApplicationSpecificMaximum[] = "AS";
240
wu@webrtc.org78187522013-10-07 23:32:02 +0000241static const char kDefaultSctpmapProtocol[] = "webrtc-datachannel";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000242
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -0800243// This is a non-standardized media transport settings.
244// This setting is going to be set in the offer. There may be one or more
245// a=x-mt: settings, and they are in the priority order (the most preferred on
246// top). x-mt setting format depends on the media transport, and is generated by
247// |MediaTransportInterface::GetTransportParametersOffer|.
248static const char kMediaTransportSettingLine[] = "x-mt";
249
pkasting@chromium.orgd3245462015-02-23 21:28:22 +0000250// RTP payload type is in the 0-127 range. Use -1 to indicate "all" payload
251// types.
252const int kWildcardPayloadType = -1;
253
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000254struct SsrcInfo {
Peter Boström0c4e06b2015-10-07 12:23:21 +0200255 uint32_t ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000256 std::string cname;
deadbeef9d3584c2016-02-16 17:54:10 -0800257 std::string stream_id;
258 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000259
260 // For backward compatibility.
261 // TODO(ronghuawu): Remove below 2 fields once all the clients support msid.
262 std::string label;
263 std::string mslabel;
264};
265typedef std::vector<SsrcInfo> SsrcInfoVec;
266typedef std::vector<SsrcGroup> SsrcGroupVec;
267
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000268template <class T>
269static void AddFmtpLine(const T& codec, std::string* message);
270static void BuildMediaDescription(const ContentInfo* content_info,
271 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200272 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000273 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -0800274 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000275 std::string* message);
deadbeef9d3584c2016-02-16 17:54:10 -0800276static void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200277 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -0800278 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -0800279 std::string* message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000280static void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200281 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000282 std::string* message);
283static void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -0800284 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000285 std::string* message);
286static void BuildIceOptions(const std::vector<std::string>& transport_options,
287 std::string* message);
zhihuang38989e52017-03-21 11:04:53 -0700288static bool ParseSessionDescription(const std::string& message,
289 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000290 std::string* session_id,
291 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000292 TransportDescription* session_td,
293 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700294 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000295 cricket::SessionDescription* desc,
296 SdpParseError* error);
297static bool ParseGroupAttribute(const std::string& line,
298 cricket::SessionDescription* desc,
299 SdpParseError* error);
300static bool ParseMediaDescription(
301 const std::string& message,
302 const TransportDescription& session_td,
303 const RtpHeaderExtensions& session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700304 size_t* pos,
305 const rtc::SocketAddress& session_connection_addr,
306 cricket::SessionDescription* desc,
Steve Anton5a1de872018-12-18 11:25:55 -0800307 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000308 SdpParseError* error);
Steve Anton5a1de872018-12-18 11:25:55 -0800309static bool ParseContent(
310 const std::string& message,
311 const cricket::MediaType media_type,
312 int mline_index,
313 const std::string& protocol,
314 const std::vector<int>& payload_types,
315 size_t* pos,
316 std::string* content_name,
317 bool* bundle_only,
318 int* msid_signaling,
319 MediaContentDescription* media_desc,
320 TransportDescription* transport,
321 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
322 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000323static bool ParseSsrcAttribute(const std::string& line,
324 SsrcInfoVec* ssrc_infos,
Steve Antone831b8c2018-02-01 12:22:16 -0800325 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000326 SdpParseError* error);
327static bool ParseSsrcGroupAttribute(const std::string& line,
328 SsrcGroupVec* ssrc_groups,
329 SdpParseError* error);
330static bool ParseCryptoAttribute(const std::string& line,
331 MediaContentDescription* media_desc,
332 SdpParseError* error);
333static bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200334 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -0700335 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000336 MediaContentDescription* media_desc,
337 SdpParseError* error);
338static bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200339 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000340 MediaContentDescription* media_desc,
341 SdpParseError* error);
Yves Gerey665174f2018-06-19 15:03:05 +0200342static bool ParseFmtpParam(const std::string& line,
343 std::string* parameter,
344 std::string* value,
345 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000346static bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200347 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000348 MediaContentDescription* media_desc,
349 SdpParseError* error);
350static bool ParseIceOptions(const std::string& line,
351 std::vector<std::string>* transport_options,
352 SdpParseError* error);
353static bool ParseExtmap(const std::string& line,
isheriff6f8d6862016-05-26 11:24:55 -0700354 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000355 SdpParseError* error);
Steve Anton4905edb2018-10-15 19:27:44 -0700356static bool ParseFingerprintAttribute(
357 const std::string& line,
358 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
359 SdpParseError* error);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000360static bool ParseDtlsSetup(const std::string& line,
361 cricket::ConnectionRole* role,
362 SdpParseError* error);
deadbeef9d3584c2016-02-16 17:54:10 -0800363static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700364 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -0800365 std::string* track_id,
366 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000367
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800368static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
369 std::vector<RidDescription>* rids);
370
371static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
372 const std::set<std::string>& to_remove,
373 const SimulcastLayerList& layers);
374
375static void RemoveInvalidRidsFromSimulcast(
376 const std::vector<RidDescription>& rids,
377 SimulcastDescription* simulcast);
378
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000379// Helper functions
380
381// Below ParseFailed*** functions output the line that caused the parsing
382// failure and the detailed reason (|description|) of the failure to |error|.
383// The functions always return false so that they can be used directly in the
384// following way when error happens:
385// "return ParseFailed***(...);"
386
387// The line starting at |line_start| of |message| is the failing line.
388// The reason for the failure should be provided in the |description|.
389// An example of a description could be "unknown character".
390static bool ParseFailed(const std::string& message,
391 size_t line_start,
392 const std::string& description,
393 SdpParseError* error) {
394 // Get the first line of |message| from |line_start|.
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000395 std::string first_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000396 size_t line_end = message.find(kNewLine, line_start);
397 if (line_end != std::string::npos) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200398 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000399 --line_end;
400 }
401 first_line = message.substr(line_start, (line_end - line_start));
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000402 } else {
403 first_line = message.substr(line_start);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000404 }
405
406 if (error) {
407 error->line = first_line;
408 error->description = description;
409 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100410 RTC_LOG(LS_ERROR) << "Failed to parse: \"" << first_line
411 << "\". Reason: " << description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000412 return false;
413}
414
415// |line| is the failing line. The reason for the failure should be
416// provided in the |description|.
417static bool ParseFailed(const std::string& line,
418 const std::string& description,
419 SdpParseError* error) {
420 return ParseFailed(line, 0, description, error);
421}
422
423// Parses failure where the failing SDP line isn't know or there are multiple
424// failing lines.
Yves Gerey665174f2018-06-19 15:03:05 +0200425static bool ParseFailed(const std::string& description, SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000426 return ParseFailed("", description, error);
427}
428
429// |line| is the failing line. The failure is due to the fact that |line|
430// doesn't have |expected_fields| fields.
431static bool ParseFailedExpectFieldNum(const std::string& line,
432 int expected_fields,
433 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200434 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000435 description << "Expects " << expected_fields << " fields.";
436 return ParseFailed(line, description.str(), error);
437}
438
439// |line| is the failing line. The failure is due to the fact that |line| has
440// less than |expected_min_fields| fields.
441static bool ParseFailedExpectMinFieldNum(const std::string& line,
442 int expected_min_fields,
443 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200444 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000445 description << "Expects at least " << expected_min_fields << " fields.";
446 return ParseFailed(line, description.str(), error);
447}
448
449// |line| is the failing line. The failure is due to the fact that it failed to
450// get the value of |attribute|.
451static bool ParseFailedGetValue(const std::string& line,
452 const std::string& attribute,
453 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200454 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000455 description << "Failed to get the value of attribute: " << attribute;
456 return ParseFailed(line, description.str(), error);
457}
458
459// The line starting at |line_start| of |message| is the failing line. The
460// failure is due to the line type (e.g. the "m" part of the "m-line")
461// not matching what is expected. The expected line type should be
462// provided as |line_type|.
463static bool ParseFailedExpectLine(const std::string& message,
464 size_t line_start,
465 const char line_type,
466 const std::string& line_value,
467 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200468 rtc::StringBuilder description;
469 description << "Expect line: " << std::string(1, line_type) << "="
470 << line_value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000471 return ParseFailed(message, line_start, description.str(), error);
472}
473
474static bool AddLine(const std::string& line, std::string* message) {
475 if (!message)
476 return false;
477
478 message->append(line);
479 message->append(kLineBreak);
480 return true;
481}
482
483static bool GetLine(const std::string& message,
484 size_t* pos,
485 std::string* line) {
486 size_t line_begin = *pos;
487 size_t line_end = message.find(kNewLine, line_begin);
488 if (line_end == std::string::npos) {
489 return false;
490 }
491 // Update the new start position
492 *pos = line_end + 1;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200493 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000494 --line_end;
495 }
496 *line = message.substr(line_begin, (line_end - line_begin));
497 const char* cline = line->c_str();
498 // RFC 4566
499 // An SDP session description consists of a number of lines of text of
500 // the form:
501 // <type>=<value>
502 // where <type> MUST be exactly one case-significant character and
503 // <value> is structured text whose format depends on <type>.
504 // Whitespace MUST NOT be used on either side of the "=" sign.
Taylor Brandstetter93a7b242018-04-16 10:45:24 -0700505 //
506 // However, an exception to the whitespace rule is made for "s=", since
507 // RFC4566 also says:
508 //
509 // If a session has no meaningful name, the value "s= " SHOULD be used
510 // (i.e., a single space as the session name).
511 if (line->length() < 3 || !islower(cline[0]) ||
Jonas Olssonec9e4922018-09-05 09:53:49 +0200512 cline[1] != kSdpDelimiterEqualChar ||
513 (cline[0] != kLineTypeSessionName &&
514 cline[2] == kSdpDelimiterSpaceChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000515 *pos = line_begin;
516 return false;
517 }
518 return true;
519}
520
521// Init |os| to "|type|=|value|".
522static void InitLine(const char type,
523 const std::string& value,
Jonas Olssonec9e4922018-09-05 09:53:49 +0200524 rtc::StringBuilder* os) {
525 os->Clear();
526 *os << std::string(1, type) << kSdpDelimiterEqual << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000527}
528
529// Init |os| to "a=|attribute|".
Jonas Olssonec9e4922018-09-05 09:53:49 +0200530static void InitAttrLine(const std::string& attribute, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000531 InitLine(kLineTypeAttributes, attribute, os);
532}
533
Piotr (Peter) Slatalab1ae10b2019-03-01 11:14:05 -0800534// Writes an x-mt SDP attribute line based on the media transport settings.
535static void AddMediaTransportLine(
536 const cricket::SessionDescription::MediaTransportSetting& setting,
537 std::string* message) {
538 rtc::StringBuilder os;
539 InitAttrLine(kMediaTransportSettingLine, &os);
540 os << kSdpDelimiterColon << setting.transport_name << kSdpDelimiterColon
541 << rtc::Base64::Encode(setting.transport_setting);
542 AddLine(os.str(), message);
543}
544
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000545// Writes a SDP attribute line based on |attribute| and |value| to |message|.
Yves Gerey665174f2018-06-19 15:03:05 +0200546static void AddAttributeLine(const std::string& attribute,
547 int value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000548 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200549 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000550 InitAttrLine(attribute, &os);
551 os << kSdpDelimiterColon << value;
552 AddLine(os.str(), message);
553}
554
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000555static bool IsLineType(const std::string& message,
556 const char type,
557 size_t line_start) {
558 if (message.size() < line_start + kLinePrefixLength) {
559 return false;
560 }
561 const char* cmessage = message.c_str();
562 return (cmessage[line_start] == type &&
Jonas Olssonec9e4922018-09-05 09:53:49 +0200563 cmessage[line_start + 1] == kSdpDelimiterEqualChar);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000564}
565
Yves Gerey665174f2018-06-19 15:03:05 +0200566static bool IsLineType(const std::string& line, const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000567 return IsLineType(line, type, 0);
568}
569
Yves Gerey665174f2018-06-19 15:03:05 +0200570static bool GetLineWithType(const std::string& message,
571 size_t* pos,
572 std::string* line,
573 const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000574 if (!IsLineType(message, type, *pos)) {
575 return false;
576 }
577
578 if (!GetLine(message, pos, line))
579 return false;
580
581 return true;
582}
583
584static bool HasAttribute(const std::string& line,
585 const std::string& attribute) {
Johannes Kron211856b2018-09-06 12:12:28 +0200586 if (line.compare(kLinePrefixLength, attribute.size(), attribute) == 0) {
587 // Make sure that the match is not only a partial match. If length of
588 // strings doesn't match, the next character of the line must be ':' or ' '.
589 // This function is also used for media descriptions (e.g., "m=audio 9..."),
590 // hence the need to also allow space in the end.
591 RTC_CHECK_LE(kLinePrefixLength + attribute.size(), line.size());
592 if ((kLinePrefixLength + attribute.size()) == line.size() ||
593 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterColonChar ||
594 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterSpaceChar) {
595 return true;
596 }
597 }
598 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000599}
600
Peter Boström0c4e06b2015-10-07 12:23:21 +0200601static bool AddSsrcLine(uint32_t ssrc_id,
602 const std::string& attribute,
603 const std::string& value,
604 std::string* message) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000605 // RFC 5576
606 // a=ssrc:<ssrc-id> <attribute>:<value>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200607 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000608 InitAttrLine(kAttributeSsrc, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200609 os << kSdpDelimiterColon << ssrc_id << kSdpDelimiterSpace << attribute
610 << kSdpDelimiterColon << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000611 return AddLine(os.str(), message);
612}
613
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000614// Get value only from <attribute>:<value>.
Yves Gerey665174f2018-06-19 15:03:05 +0200615static bool GetValue(const std::string& message,
616 const std::string& attribute,
617 std::string* value,
618 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000619 std::string leftpart;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200620 if (!rtc::tokenize_first(message, kSdpDelimiterColonChar, &leftpart, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000621 return ParseFailedGetValue(message, attribute, error);
622 }
623 // The left part should end with the expected attribute.
624 if (leftpart.length() < attribute.length() ||
625 leftpart.compare(leftpart.length() - attribute.length(),
626 attribute.length(), attribute) != 0) {
627 return ParseFailedGetValue(message, attribute, error);
628 }
629 return true;
630}
631
632static bool CaseInsensitiveFind(std::string str1, std::string str2) {
Steve Anton64b626b2019-01-28 17:25:26 -0800633 absl::c_transform(str1, str1.begin(), ::tolower);
634 absl::c_transform(str2, str2.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000635 return str1.find(str2) != std::string::npos;
636}
637
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000638template <class T>
639static bool GetValueFromString(const std::string& line,
640 const std::string& s,
641 T* t,
642 SdpParseError* error) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000643 if (!rtc::FromString(s, t)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200644 rtc::StringBuilder description;
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000645 description << "Invalid value: " << s << ".";
646 return ParseFailed(line, description.str(), error);
647 }
648 return true;
649}
650
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000651static bool GetPayloadTypeFromString(const std::string& line,
652 const std::string& s,
653 int* payload_type,
654 SdpParseError* error) {
655 return GetValueFromString(line, s, payload_type, error) &&
Yves Gerey665174f2018-06-19 15:03:05 +0200656 cricket::IsValidRtpPayloadType(*payload_type);
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000657}
658
Seth Hampson5897a6e2018-04-03 11:16:33 -0700659// Creates a StreamParams track in the case when no SSRC lines are signaled.
660// This is a track that does not contain SSRCs and only contains
661// stream_ids/track_id if it's signaled with a=msid lines.
662void CreateTrackWithNoSsrcs(const std::vector<std::string>& msid_stream_ids,
663 const std::string& msid_track_id,
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800664 const std::vector<RidDescription>& rids,
Seth Hampson5897a6e2018-04-03 11:16:33 -0700665 StreamParamsVec* tracks) {
666 StreamParams track;
Amit Hilbuch6df49d82019-04-15 15:47:21 -0700667 if (msid_track_id.empty() && rids.empty()) {
Seth Hampson5897a6e2018-04-03 11:16:33 -0700668 // We only create an unsignaled track if a=msid lines were signaled.
Amit Hilbuch6df49d82019-04-15 15:47:21 -0700669 RTC_LOG(LS_INFO) << "MSID not signaled, skipping creation of StreamParams";
Seth Hampson5897a6e2018-04-03 11:16:33 -0700670 return;
671 }
672 track.set_stream_ids(msid_stream_ids);
673 track.id = msid_track_id;
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800674 track.set_rids(rids);
Seth Hampson5897a6e2018-04-03 11:16:33 -0700675 tracks->push_back(track);
676}
677
678// Creates the StreamParams tracks, for the case when SSRC lines are signaled.
679// |msid_stream_ids| and |msid_track_id| represent the stream/track ID from the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800680// "a=msid" attribute, if it exists. They are empty if the attribute does not
Seth Hampson5897a6e2018-04-03 11:16:33 -0700681// exist. We prioritize getting stream_ids/track_ids signaled in a=msid lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000682void CreateTracksFromSsrcInfos(const SsrcInfoVec& ssrc_infos,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700683 const std::vector<std::string>& msid_stream_ids,
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800684 const std::string& msid_track_id,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700685 StreamParamsVec* tracks,
686 int msid_signaling) {
nisseede5da42017-01-12 05:15:36 -0800687 RTC_DCHECK(tracks != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700688 for (const SsrcInfo& ssrc_info : ssrc_infos) {
689 if (ssrc_info.cname.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000690 continue;
691 }
692
Seth Hampson5b4f0752018-04-02 16:31:36 -0700693 std::vector<std::string> stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000694 std::string track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700695 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
696 // This is the case with Unified Plan SDP msid signaling.
697 stream_ids = msid_stream_ids;
Tomas Gunnarsson191bf5c2018-03-30 10:44:43 +0000698 track_id = msid_track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700699 } else if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
700 // This is the case with Plan B SDP msid signaling.
Steve Anton4daf66e2018-09-07 14:55:53 -0700701 stream_ids.push_back(ssrc_info.stream_id);
702 track_id = ssrc_info.track_id;
703 } else if (!ssrc_info.mslabel.empty()) {
Seth Hampson5b4f0752018-04-02 16:31:36 -0700704 // Since there's no a=msid or a=ssrc msid signaling, this is a sdp from
705 // an older version of client that doesn't support msid.
706 // In that case, we use the mslabel and label to construct the track.
Steve Anton4daf66e2018-09-07 14:55:53 -0700707 stream_ids.push_back(ssrc_info.mslabel);
708 track_id = ssrc_info.label;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700709 } else {
710 // Since no media streams isn't supported with older SDP signaling, we
711 // use a default a stream id.
712 stream_ids.push_back(kDefaultMsid);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000713 }
Seth Hampson5b4f0752018-04-02 16:31:36 -0700714 // If a track ID wasn't populated from the SSRC attributes OR the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800715 // msid attribute, use default/random values.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800716 if (track_id.empty()) {
717 // TODO(ronghuawu): What should we do if the track id doesn't appear?
718 // Create random string (which will be used as track label later)?
719 track_id = rtc::CreateRandomString(8);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000720 }
721
Steve Anton64b626b2019-01-28 17:25:26 -0800722 auto track_it = absl::c_find_if(
723 *tracks,
Steve Anton4daf66e2018-09-07 14:55:53 -0700724 [track_id](const StreamParams& track) { return track.id == track_id; });
725 if (track_it == tracks->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000726 // If we don't find an existing track, create a new one.
727 tracks->push_back(StreamParams());
Steve Anton4daf66e2018-09-07 14:55:53 -0700728 track_it = tracks->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000729 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700730 StreamParams& track = *track_it;
731 track.add_ssrc(ssrc_info.ssrc_id);
732 track.cname = ssrc_info.cname;
733 track.set_stream_ids(stream_ids);
734 track.id = track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000735 }
736}
737
Seth Hampson845e8782018-03-02 11:34:10 -0800738void GetMediaStreamIds(const ContentInfo* content,
739 std::set<std::string>* labels) {
Steve Antonb1c1de12017-12-21 15:14:30 -0800740 for (const StreamParams& stream_params :
741 content->media_description()->streams()) {
Seth Hampson845e8782018-03-02 11:34:10 -0800742 for (const std::string& stream_id : stream_params.stream_ids()) {
743 labels->insert(stream_id);
Steve Anton5a26a3a2018-02-28 11:38:47 -0800744 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000745 }
746}
747
748// RFC 5245
749// It is RECOMMENDED that default candidates be chosen based on the
750// likelihood of those candidates to work with the peer that is being
751// contacted. It is RECOMMENDED that relayed > reflexive > host.
752static const int kPreferenceUnknown = 0;
753static const int kPreferenceHost = 1;
754static const int kPreferenceReflexive = 2;
755static const int kPreferenceRelayed = 3;
756
757static int GetCandidatePreferenceFromType(const std::string& type) {
758 int preference = kPreferenceUnknown;
759 if (type == cricket::LOCAL_PORT_TYPE) {
760 preference = kPreferenceHost;
761 } else if (type == cricket::STUN_PORT_TYPE) {
762 preference = kPreferenceReflexive;
763 } else if (type == cricket::RELAY_PORT_TYPE) {
764 preference = kPreferenceRelayed;
765 } else {
nissec80e7412017-01-11 05:56:46 -0800766 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000767 }
768 return preference;
769}
770
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000771// Get ip and port of the default destination from the |candidates| with the
772// given value of |component_id|. The default candidate should be the one most
773// likely to work, typically IPv4 relay.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000774// RFC 5245
775// The value of |component_id| currently supported are 1 (RTP) and 2 (RTCP).
Steve Anton36b29d12017-10-30 09:57:42 -0700776// TODO(deadbeef): Decide the default destination in webrtcsession and
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000777// pass it down via SessionDescription.
Yves Gerey665174f2018-06-19 15:03:05 +0200778static void GetDefaultDestination(const std::vector<Candidate>& candidates,
779 int component_id,
780 std::string* port,
781 std::string* ip,
782 std::string* addr_type) {
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000783 *addr_type = kConnectionIpv4Addrtype;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000784 *port = kDummyPort;
785 *ip = kDummyAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000786 int current_preference = kPreferenceUnknown;
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000787 int current_family = AF_UNSPEC;
Steve Anton4daf66e2018-09-07 14:55:53 -0700788 for (const Candidate& candidate : candidates) {
789 if (candidate.component() != component_id) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000790 continue;
791 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000792 // Default destination should be UDP only.
Steve Anton4daf66e2018-09-07 14:55:53 -0700793 if (candidate.protocol() != cricket::UDP_PROTOCOL_NAME) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000794 continue;
795 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700796 const int preference = GetCandidatePreferenceFromType(candidate.type());
797 const int family = candidate.address().ipaddr().family();
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000798 // See if this candidate is more preferable then the current one if it's the
799 // same family. Or if the current family is IPv4 already so we could safely
800 // ignore all IPv6 ones. WebRTC bug 4269.
801 // http://code.google.com/p/webrtc/issues/detail?id=4269
802 if ((preference <= current_preference && current_family == family) ||
803 (current_family == AF_INET && family == AF_INET6)) {
804 continue;
805 }
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000806 if (family == AF_INET) {
807 addr_type->assign(kConnectionIpv4Addrtype);
808 } else if (family == AF_INET6) {
809 addr_type->assign(kConnectionIpv6Addrtype);
810 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000811 current_preference = preference;
812 current_family = family;
Steve Anton4daf66e2018-09-07 14:55:53 -0700813 *port = candidate.address().PortAsString();
814 *ip = candidate.address().ipaddr().ToString();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000815 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000816}
817
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000818// Gets "a=rtcp" line if found default RTCP candidate from |candidates|.
819static std::string GetRtcpLine(const std::vector<Candidate>& candidates) {
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000820 std::string rtcp_line, rtcp_port, rtcp_ip, addr_type;
Yves Gerey665174f2018-06-19 15:03:05 +0200821 GetDefaultDestination(candidates, ICE_CANDIDATE_COMPONENT_RTCP, &rtcp_port,
822 &rtcp_ip, &addr_type);
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000823 // Found default RTCP candidate.
824 // RFC 5245
825 // If the agent is utilizing RTCP, it MUST encode the RTCP candidate
826 // using the a=rtcp attribute as defined in RFC 3605.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000827
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000828 // RFC 3605
829 // rtcp-attribute = "a=rtcp:" port [nettype space addrtype space
830 // connection-address] CRLF
Jonas Olssonec9e4922018-09-05 09:53:49 +0200831 rtc::StringBuilder os;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000832 InitAttrLine(kAttributeRtcp, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200833 os << kSdpDelimiterColon << rtcp_port << " " << kConnectionNettype << " "
834 << addr_type << " " << rtcp_ip;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000835 rtcp_line = os.str();
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000836 return rtcp_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000837}
838
839// Get candidates according to the mline index from SessionDescriptionInterface.
840static void GetCandidatesByMindex(const SessionDescriptionInterface& desci,
841 int mline_index,
842 std::vector<Candidate>* candidates) {
843 if (!candidates) {
844 return;
845 }
846 const IceCandidateCollection* cc = desci.candidates(mline_index);
847 for (size_t i = 0; i < cc->count(); ++i) {
848 const IceCandidateInterface* candidate = cc->at(i);
849 candidates->push_back(candidate->candidate());
850 }
851}
852
deadbeef90f1e1e2017-02-10 12:35:05 -0800853static bool IsValidPort(int port) {
854 return port >= 0 && port <= 65535;
855}
856
Steve Antone831b8c2018-02-01 12:22:16 -0800857std::string SdpSerialize(const JsepSessionDescription& jdesc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000858 const cricket::SessionDescription* desc = jdesc.description();
859 if (!desc) {
860 return "";
861 }
862
863 std::string message;
864
865 // Session Description.
866 AddLine(kSessionVersion, &message);
867 // Session Origin
868 // RFC 4566
869 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
870 // <unicast-address>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200871 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000872 InitLine(kLineTypeOrigin, kSessionOriginUsername, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200873 const std::string& session_id =
874 jdesc.session_id().empty() ? kSessionOriginSessionId : jdesc.session_id();
875 const std::string& session_version = jdesc.session_version().empty()
876 ? kSessionOriginSessionVersion
877 : jdesc.session_version();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000878 os << " " << session_id << " " << session_version << " "
879 << kSessionOriginNettype << " " << kSessionOriginAddrtype << " "
880 << kSessionOriginAddress;
881 AddLine(os.str(), &message);
882 AddLine(kSessionName, &message);
883
884 // Time Description.
885 AddLine(kTimeDescription, &message);
886
Piotr (Peter) Slatalab1ae10b2019-03-01 11:14:05 -0800887 for (const cricket::SessionDescription::MediaTransportSetting& settings :
888 desc->MediaTransportSettings()) {
889 AddMediaTransportLine(settings, &message);
890 }
891
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000892 // Group
893 if (desc->HasGroup(cricket::GROUP_TYPE_BUNDLE)) {
894 std::string group_line = kAttrGroup;
895 const cricket::ContentGroup* group =
896 desc->GetGroupByName(cricket::GROUP_TYPE_BUNDLE);
nisseede5da42017-01-12 05:15:36 -0800897 RTC_DCHECK(group != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700898 for (const std::string& content_name : group->content_names()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000899 group_line.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -0700900 group_line.append(content_name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000901 }
902 AddLine(group_line, &message);
903 }
904
Johannes Kron0854eb62018-10-10 22:33:20 +0200905 // Mixed one- and two-byte header extension.
Johannes Kron9581bc42018-10-23 10:17:39 +0200906 if (desc->extmap_allow_mixed()) {
Johannes Kron0854eb62018-10-10 22:33:20 +0200907 InitAttrLine(kAttributeExtmapAllowMixed, &os);
908 AddLine(os.str(), &message);
909 }
910
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000911 // MediaStream semantics
912 InitAttrLine(kAttributeMsidSemantics, &os);
913 os << kSdpDelimiterColon << " " << kMediaStreamSemantic;
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000914
Seth Hampson845e8782018-03-02 11:34:10 -0800915 std::set<std::string> media_stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000916 const ContentInfo* audio_content = GetFirstAudioContent(desc);
917 if (audio_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800918 GetMediaStreamIds(audio_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000919
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000920 const ContentInfo* video_content = GetFirstVideoContent(desc);
921 if (video_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800922 GetMediaStreamIds(video_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000923
Steve Anton4daf66e2018-09-07 14:55:53 -0700924 for (const std::string& id : media_stream_ids) {
925 os << " " << id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000926 }
927 AddLine(os.str(), &message);
928
Taylor Brandstetter2f65ec52018-05-24 11:37:28 -0700929 // a=ice-lite
930 //
931 // TODO(deadbeef): It's weird that we need to iterate TransportInfos for
932 // this, when it's a session-level attribute. It really should be moved to a
933 // session-level structure like SessionDescription.
934 for (const cricket::TransportInfo& transport : desc->transport_infos()) {
935 if (transport.description.ice_mode == cricket::ICEMODE_LITE) {
936 InitAttrLine(kAttributeIceLite, &os);
937 AddLine(os.str(), &message);
938 break;
939 }
940 }
941
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000942 // Preserve the order of the media contents.
943 int mline_index = -1;
Steve Anton4daf66e2018-09-07 14:55:53 -0700944 for (const ContentInfo& content : desc->contents()) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000945 std::vector<Candidate> candidates;
946 GetCandidatesByMindex(jdesc, ++mline_index, &candidates);
Steve Anton4daf66e2018-09-07 14:55:53 -0700947 BuildMediaDescription(&content, desc->GetTransportInfoByName(content.name),
948 content.media_description()->type(), candidates,
949 desc->msid_signaling(), &message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000950 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000951 return message;
952}
953
954// Serializes the passed in IceCandidateInterface to a SDP string.
955// candidate - The candidate to be serialized.
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700956std::string SdpSerializeCandidate(const IceCandidateInterface& candidate) {
957 return SdpSerializeCandidate(candidate.candidate());
958}
959
960// Serializes a cricket Candidate.
961std::string SdpSerializeCandidate(const cricket::Candidate& candidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000962 std::string message;
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700963 std::vector<cricket::Candidate> candidates(1, candidate);
honghaiza54a0802015-12-16 18:37:23 -0800964 BuildCandidate(candidates, true, &message);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000965 // From WebRTC draft section 4.8.1.1 candidate-attribute will be
966 // just candidate:<candidate> not a=candidate:<blah>CRLF
nisseede5da42017-01-12 05:15:36 -0800967 RTC_DCHECK(message.find("a=") == 0);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000968 message.erase(0, 2);
nisseede5da42017-01-12 05:15:36 -0800969 RTC_DCHECK(message.find(kLineBreak) == message.size() - 2);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000970 message.resize(message.size() - 2);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000971 return message;
972}
973
974bool SdpDeserialize(const std::string& message,
975 JsepSessionDescription* jdesc,
976 SdpParseError* error) {
977 std::string session_id;
978 std::string session_version;
Peter Thatcher7cbd1882015-09-17 18:54:52 -0700979 TransportDescription session_td("", "");
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000980 RtpHeaderExtensions session_extmaps;
zhihuang38989e52017-03-21 11:04:53 -0700981 rtc::SocketAddress session_connection_addr;
Steve Anton5a1de872018-12-18 11:25:55 -0800982 auto desc = absl::make_unique<cricket::SessionDescription>();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000983 size_t current_pos = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000984
985 // Session Description
986 if (!ParseSessionDescription(message, &current_pos, &session_id,
deadbeefc80741f2015-10-22 13:14:45 -0700987 &session_version, &session_td, &session_extmaps,
Steve Anton5a1de872018-12-18 11:25:55 -0800988 &session_connection_addr, desc.get(), error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000989 return false;
990 }
991
992 // Media Description
Steve Anton5a1de872018-12-18 11:25:55 -0800993 std::vector<std::unique_ptr<JsepIceCandidate>> candidates;
deadbeefc80741f2015-10-22 13:14:45 -0700994 if (!ParseMediaDescription(message, session_td, session_extmaps, &current_pos,
Steve Anton5a1de872018-12-18 11:25:55 -0800995 session_connection_addr, desc.get(), &candidates,
zhihuang38989e52017-03-21 11:04:53 -0700996 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000997 return false;
998 }
999
Harald Alvestrand4d7160e2019-04-12 07:01:29 +02001000 jdesc->Initialize(std::move(desc), session_id, session_version);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001001
Steve Anton5a1de872018-12-18 11:25:55 -08001002 for (const auto& candidate : candidates) {
1003 jdesc->AddCandidate(candidate.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001004 }
1005 return true;
1006}
1007
1008bool SdpDeserializeCandidate(const std::string& message,
1009 JsepIceCandidate* jcandidate,
1010 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08001011 RTC_DCHECK(jcandidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001012 Candidate candidate;
1013 if (!ParseCandidate(message, &candidate, error, true)) {
1014 return false;
1015 }
1016 jcandidate->SetCandidate(candidate);
1017 return true;
1018}
1019
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001020bool SdpDeserializeCandidate(const std::string& transport_name,
1021 const std::string& message,
1022 cricket::Candidate* candidate,
1023 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08001024 RTC_DCHECK(candidate != nullptr);
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001025 if (!ParseCandidate(message, candidate, error, true)) {
1026 return false;
1027 }
1028 candidate->set_transport_name(transport_name);
1029 return true;
1030}
1031
Yves Gerey665174f2018-06-19 15:03:05 +02001032bool ParseCandidate(const std::string& message,
1033 Candidate* candidate,
1034 SdpParseError* error,
1035 bool is_raw) {
nisseede5da42017-01-12 05:15:36 -08001036 RTC_DCHECK(candidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001037
1038 // Get the first line from |message|.
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001039 std::string first_line = message;
1040 size_t pos = 0;
1041 GetLine(message, &pos, &first_line);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001042
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001043 // Makes sure |message| contains only one line.
1044 if (message.size() > first_line.size()) {
1045 std::string left, right;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001046 if (rtc::tokenize_first(message, kNewLineChar, &left, &right) &&
Donald Curtis0e07f922015-05-15 09:21:23 -07001047 !right.empty()) {
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001048 return ParseFailed(message, 0, "Expect one line only", error);
1049 }
1050 }
1051
1052 // From WebRTC draft section 4.8.1.1 candidate-attribute should be
1053 // candidate:<candidate> when trickled, but we still support
1054 // a=candidate:<blah>CRLF for backward compatibility and for parsing a line
1055 // from the SDP.
1056 if (IsLineType(first_line, kLineTypeAttributes)) {
1057 first_line = first_line.substr(kLinePrefixLength);
1058 }
1059
1060 std::string attribute_candidate;
1061 std::string candidate_value;
1062
1063 // |first_line| must be in the form of "candidate:<value>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001064 if (!rtc::tokenize_first(first_line, kSdpDelimiterColonChar,
1065 &attribute_candidate, &candidate_value) ||
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001066 attribute_candidate != kAttributeCandidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001067 if (is_raw) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001068 rtc::StringBuilder description;
Yves Gerey665174f2018-06-19 15:03:05 +02001069 description << "Expect line: " << kAttributeCandidate << ":"
1070 << "<candidate-str>";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001071 return ParseFailed(first_line, 0, description.str(), error);
1072 } else {
1073 return ParseFailedExpectLine(first_line, 0, kLineTypeAttributes,
1074 kAttributeCandidate, error);
1075 }
1076 }
1077
1078 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001079 rtc::split(candidate_value, kSdpDelimiterSpaceChar, &fields);
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001080
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001081 // RFC 5245
1082 // a=candidate:<foundation> <component-id> <transport> <priority>
1083 // <connection-address> <port> typ <candidate-types>
1084 // [raddr <connection-address>] [rport <port>]
1085 // *(SP extension-att-name SP extension-att-value)
1086 const size_t expected_min_fields = 8;
1087 if (fields.size() < expected_min_fields ||
1088 (fields[6] != kAttributeCandidateTyp)) {
1089 return ParseFailedExpectMinFieldNum(first_line, expected_min_fields, error);
1090 }
jbauch083b73f2015-07-16 02:46:32 -07001091 const std::string& foundation = fields[0];
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001092
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001093 int component_id = 0;
1094 if (!GetValueFromString(first_line, fields[1], &component_id, error)) {
1095 return false;
1096 }
jbauch083b73f2015-07-16 02:46:32 -07001097 const std::string& transport = fields[2];
Peter Boström0c4e06b2015-10-07 12:23:21 +02001098 uint32_t priority = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001099 if (!GetValueFromString(first_line, fields[3], &priority, error)) {
1100 return false;
1101 }
jbauch083b73f2015-07-16 02:46:32 -07001102 const std::string& connection_address = fields[4];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001103 int port = 0;
1104 if (!GetValueFromString(first_line, fields[5], &port, error)) {
1105 return false;
1106 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001107 if (!IsValidPort(port)) {
1108 return ParseFailed(first_line, "Invalid port number.", error);
1109 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001110 SocketAddress address(connection_address, port);
1111
1112 cricket::ProtocolType protocol;
hnslb68cc752016-12-13 10:33:41 -08001113 if (!StringToProto(transport.c_str(), &protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001114 return ParseFailed(first_line, "Unsupported transport type.", error);
1115 }
hnslb68cc752016-12-13 10:33:41 -08001116 switch (protocol) {
1117 case cricket::PROTO_UDP:
1118 case cricket::PROTO_TCP:
1119 case cricket::PROTO_SSLTCP:
1120 // Supported protocol.
1121 break;
1122 default:
1123 return ParseFailed(first_line, "Unsupported transport type.", error);
1124 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001125
1126 std::string candidate_type;
jbauch083b73f2015-07-16 02:46:32 -07001127 const std::string& type = fields[7];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001128 if (type == kCandidateHost) {
1129 candidate_type = cricket::LOCAL_PORT_TYPE;
1130 } else if (type == kCandidateSrflx) {
1131 candidate_type = cricket::STUN_PORT_TYPE;
1132 } else if (type == kCandidateRelay) {
1133 candidate_type = cricket::RELAY_PORT_TYPE;
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001134 } else if (type == kCandidatePrflx) {
1135 candidate_type = cricket::PRFLX_PORT_TYPE;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001136 } else {
1137 return ParseFailed(first_line, "Unsupported candidate type.", error);
1138 }
1139
1140 size_t current_position = expected_min_fields;
1141 SocketAddress related_address;
1142 // The 2 optional fields for related address
1143 // [raddr <connection-address>] [rport <port>]
1144 if (fields.size() >= (current_position + 2) &&
1145 fields[current_position] == kAttributeCandidateRaddr) {
1146 related_address.SetIP(fields[++current_position]);
1147 ++current_position;
1148 }
1149 if (fields.size() >= (current_position + 2) &&
1150 fields[current_position] == kAttributeCandidateRport) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001151 int port = 0;
Yves Gerey665174f2018-06-19 15:03:05 +02001152 if (!GetValueFromString(first_line, fields[++current_position], &port,
1153 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001154 return false;
1155 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001156 if (!IsValidPort(port)) {
1157 return ParseFailed(first_line, "Invalid port number.", error);
1158 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001159 related_address.SetPort(port);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001160 ++current_position;
1161 }
1162
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001163 // If this is a TCP candidate, it has additional extension as defined in
1164 // RFC 6544.
1165 std::string tcptype;
1166 if (fields.size() >= (current_position + 2) &&
1167 fields[current_position] == kTcpCandidateType) {
1168 tcptype = fields[++current_position];
1169 ++current_position;
1170
1171 if (tcptype != cricket::TCPTYPE_ACTIVE_STR &&
1172 tcptype != cricket::TCPTYPE_PASSIVE_STR &&
1173 tcptype != cricket::TCPTYPE_SIMOPEN_STR) {
1174 return ParseFailed(first_line, "Invalid TCP candidate type.", error);
1175 }
1176
1177 if (protocol != cricket::PROTO_TCP) {
1178 return ParseFailed(first_line, "Invalid non-TCP candidate", error);
1179 }
1180 }
1181
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001182 // Extension
honghaiza54a0802015-12-16 18:37:23 -08001183 // Though non-standard, we support the ICE ufrag and pwd being signaled on
1184 // the candidate to avoid issues with confusing which generation a candidate
1185 // belongs to when trickling multiple generations at the same time.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001186 std::string username;
1187 std::string password;
Peter Boström0c4e06b2015-10-07 12:23:21 +02001188 uint32_t generation = 0;
honghaiza0c44ea2016-03-23 16:07:48 -07001189 uint16_t network_id = 0;
1190 uint16_t network_cost = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001191 for (size_t i = current_position; i + 1 < fields.size(); ++i) {
1192 // RFC 5245
1193 // *(SP extension-att-name SP extension-att-value)
1194 if (fields[i] == kAttributeCandidateGeneration) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001195 if (!GetValueFromString(first_line, fields[++i], &generation, error)) {
1196 return false;
1197 }
honghaiza54a0802015-12-16 18:37:23 -08001198 } else if (fields[i] == kAttributeCandidateUfrag) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001199 username = fields[++i];
honghaiza54a0802015-12-16 18:37:23 -08001200 } else if (fields[i] == kAttributeCandidatePwd) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001201 password = fields[++i];
honghaiza0c44ea2016-03-23 16:07:48 -07001202 } else if (fields[i] == kAttributeCandidateNetworkId) {
1203 if (!GetValueFromString(first_line, fields[++i], &network_id, error)) {
1204 return false;
1205 }
honghaize1a0c942016-02-16 14:54:56 -08001206 } else if (fields[i] == kAttributeCandidateNetworkCost) {
1207 if (!GetValueFromString(first_line, fields[++i], &network_cost, error)) {
1208 return false;
1209 }
Honghai Zhang351d77b2016-05-20 15:08:29 -07001210 network_cost = std::min(network_cost, rtc::kNetworkCostMax);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001211 } else {
1212 // Skip the unknown extension.
1213 ++i;
1214 }
1215 }
1216
guoweis@webrtc.org61c12472015-01-15 06:53:07 +00001217 *candidate = Candidate(component_id, cricket::ProtoToString(protocol),
guoweis@webrtc.org950c5182014-12-16 23:01:31 +00001218 address, priority, username, password, candidate_type,
honghaiza0c44ea2016-03-23 16:07:48 -07001219 generation, foundation, network_id, network_cost);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001220 candidate->set_related_address(related_address);
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001221 candidate->set_tcptype(tcptype);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001222 return true;
1223}
1224
1225bool ParseIceOptions(const std::string& line,
1226 std::vector<std::string>* transport_options,
1227 SdpParseError* error) {
1228 std::string ice_options;
1229 if (!GetValue(line, kAttributeIceOption, &ice_options, error)) {
1230 return false;
1231 }
1232 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001233 rtc::split(ice_options, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001234 for (size_t i = 0; i < fields.size(); ++i) {
1235 transport_options->push_back(fields[i]);
1236 }
1237 return true;
1238}
1239
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001240bool ParseSctpPort(const std::string& line,
1241 int* sctp_port,
1242 SdpParseError* error) {
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02001243 // draft-ietf-mmusic-sctp-sdp-26
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001244 // a=sctp-port
1245 std::vector<std::string> fields;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001246 const size_t expected_min_fields = 2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001247 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
lally69f57602015-10-08 10:15:04 -07001248 if (fields.size() < expected_min_fields) {
1249 fields.resize(0);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001250 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
lally69f57602015-10-08 10:15:04 -07001251 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001252 if (fields.size() < expected_min_fields) {
1253 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1254 }
1255 if (!rtc::FromString(fields[1], sctp_port)) {
lally69f57602015-10-08 10:15:04 -07001256 return ParseFailed(line, "Invalid sctp port value.", error);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001257 }
1258 return true;
1259}
1260
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02001261bool ParseSctpMaxMessageSize(const std::string& line,
1262 int* max_message_size,
1263 SdpParseError* error) {
1264 // draft-ietf-mmusic-sctp-sdp-26
1265 // a=max-message-size:199999
1266 std::vector<std::string> fields;
1267 const size_t expected_min_fields = 2;
1268 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
1269 if (fields.size() < expected_min_fields) {
1270 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1271 }
1272 if (!rtc::FromString(fields[1], max_message_size)) {
1273 return ParseFailed(line, "Invalid SCTP max message size.", error);
1274 }
1275 return true;
1276}
1277
isheriff6f8d6862016-05-26 11:24:55 -07001278bool ParseExtmap(const std::string& line,
1279 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001280 SdpParseError* error) {
1281 // RFC 5285
1282 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1283 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001284 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001285 const size_t expected_min_fields = 2;
1286 if (fields.size() < expected_min_fields) {
1287 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1288 }
1289 std::string uri = fields[1];
1290
1291 std::string value_direction;
1292 if (!GetValue(fields[0], kAttributeExtmap, &value_direction, error)) {
1293 return false;
1294 }
1295 std::vector<std::string> sub_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001296 rtc::split(value_direction, kSdpDelimiterSlashChar, &sub_fields);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001297 int value = 0;
1298 if (!GetValueFromString(line, sub_fields[0], &value, error)) {
1299 return false;
1300 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001301
jbauch5869f502017-06-29 12:31:36 -07001302 bool encrypted = false;
1303 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1304 // RFC 6904
Steve Anton36b29d12017-10-30 09:57:42 -07001305 // a=extmap:<value["/"<direction>] urn:ietf:params:rtp-hdrext:encrypt <URI>
1306 // <extensionattributes>
jbauch5869f502017-06-29 12:31:36 -07001307 const size_t expected_min_fields_encrypted = expected_min_fields + 1;
1308 if (fields.size() < expected_min_fields_encrypted) {
1309 return ParseFailedExpectMinFieldNum(line, expected_min_fields_encrypted,
Yves Gerey665174f2018-06-19 15:03:05 +02001310 error);
jbauch5869f502017-06-29 12:31:36 -07001311 }
1312
1313 encrypted = true;
1314 uri = fields[2];
1315 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1316 return ParseFailed(line, "Recursive encrypted header.", error);
1317 }
1318 }
1319
1320 *extmap = RtpExtension(uri, value, encrypted);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001321 return true;
1322}
1323
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +02001324static void BuildSctpContentAttributes(
1325 std::string* message,
1326 const cricket::SctpDataContentDescription* data_desc) {
1327 rtc::StringBuilder os;
1328 if (data_desc->use_sctpmap()) {
1329 // draft-ietf-mmusic-sctp-sdp-04
1330 // a=sctpmap:sctpmap-number protocol [streams]
1331 rtc::StringBuilder os;
1332 InitAttrLine(kAttributeSctpmap, &os);
1333 os << kSdpDelimiterColon << data_desc->port() << kSdpDelimiterSpace
1334 << kDefaultSctpmapProtocol << kSdpDelimiterSpace
1335 << cricket::kMaxSctpStreams;
1336 AddLine(os.str(), message);
1337 } else {
1338 // draft-ietf-mmusic-sctp-sdp-23
1339 // a=sctp-port:<port>
1340 InitAttrLine(kAttributeSctpPort, &os);
1341 os << kSdpDelimiterColon << data_desc->port();
1342 AddLine(os.str(), message);
1343 if (data_desc->max_message_size() != kDefaultSctpMaxMessageSize) {
1344 InitAttrLine(kAttributeMaxMessageSize, &os);
1345 os << kSdpDelimiterColon << data_desc->max_message_size();
1346 AddLine(os.str(), message);
1347 }
1348 }
1349}
1350
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001351void BuildMediaDescription(const ContentInfo* content_info,
1352 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001353 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001354 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -08001355 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001356 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001357 RTC_DCHECK(message != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001358 if (content_info == NULL || message == NULL) {
1359 return;
1360 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001361 rtc::StringBuilder os;
Steve Antonb1c1de12017-12-21 15:14:30 -08001362 const MediaContentDescription* media_desc = content_info->media_description();
1363 RTC_DCHECK(media_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001364
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001365 // RFC 4566
1366 // m=<media> <port> <proto> <fmt>
1367 // fmt is a list of payload type numbers that MAY be used in the session.
1368 const char* type = NULL;
1369 if (media_type == cricket::MEDIA_TYPE_AUDIO)
1370 type = kMediaTypeAudio;
1371 else if (media_type == cricket::MEDIA_TYPE_VIDEO)
1372 type = kMediaTypeVideo;
1373 else if (media_type == cricket::MEDIA_TYPE_DATA)
1374 type = kMediaTypeData;
1375 else
nissec80e7412017-01-11 05:56:46 -08001376 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001377
1378 std::string fmt;
1379 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001380 const VideoContentDescription* video_desc = media_desc->as_video();
Steve Anton4daf66e2018-09-07 14:55:53 -07001381 for (const cricket::VideoCodec& codec : video_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 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001386 const AudioContentDescription* audio_desc = media_desc->as_audio();
Steve Anton4daf66e2018-09-07 14:55:53 -07001387 for (const cricket::AudioCodec& codec : audio_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001388 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001389 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001390 }
1391 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001392 const cricket::SctpDataContentDescription* sctp_data_desc =
1393 media_desc->as_sctp();
1394 if (sctp_data_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001395 fmt.append(" ");
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001396
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001397 if (sctp_data_desc->use_sctpmap()) {
1398 fmt.append(rtc::ToString(sctp_data_desc->port()));
zstein4b2e0822017-02-17 19:48:38 -08001399 } else {
1400 fmt.append(kDefaultSctpmapProtocol);
1401 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001402 } else {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001403 const RtpDataContentDescription* rtp_data_desc =
1404 media_desc->as_rtp_data();
1405 for (const cricket::RtpDataCodec& codec : rtp_data_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001406 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001407 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001408 }
1409 }
1410 }
1411 // The fmt must never be empty. If no codecs are found, set the fmt attribute
1412 // to 0.
1413 if (fmt.empty()) {
1414 fmt = " 0";
1415 }
1416
deadbeef25ed4352016-12-12 18:37:36 -08001417 // The port number in the m line will be updated later when associated with
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001418 // the candidates.
deadbeef25ed4352016-12-12 18:37:36 -08001419 //
1420 // A port value of 0 indicates that the m= section is rejected.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001421 // RFC 3264
1422 // To reject an offered stream, the port number in the corresponding stream in
1423 // the answer MUST be set to zero.
deadbeef25ed4352016-12-12 18:37:36 -08001424 //
1425 // However, the BUNDLE draft adds a new meaning to port zero, when used along
1426 // with a=bundle-only.
zhihuang38989e52017-03-21 11:04:53 -07001427 std::string port = kDummyPort;
1428 if (content_info->rejected || content_info->bundle_only) {
1429 port = kMediaPortRejected;
1430 } else if (!media_desc->connection_address().IsNil()) {
1431 port = rtc::ToString(media_desc->connection_address().port());
1432 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001433
Yves Gerey665174f2018-06-19 15:03:05 +02001434 rtc::SSLFingerprint* fp =
1435 (transport_info) ? transport_info->description.identity_fingerprint.get()
1436 : NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001437
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001438 // Add the m and c lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001439 InitLine(kLineTypeMedia, type, &os);
1440 os << " " << port << " " << media_desc->protocol() << fmt;
zhihuang38989e52017-03-21 11:04:53 -07001441 AddLine(os.str(), message);
1442
1443 InitLine(kLineTypeConnection, kConnectionNettype, &os);
1444 if (media_desc->connection_address().IsNil()) {
1445 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
1446 } else if (media_desc->connection_address().family() == AF_INET) {
1447 os << " " << kConnectionIpv4Addrtype << " "
1448 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 12:53:06 -08001449 } else if (media_desc->connection_address().family() == AF_INET6) {
zhihuang38989e52017-03-21 11:04:53 -07001450 os << " " << kConnectionIpv6Addrtype << " "
1451 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 12:53:06 -08001452 } else if (!media_desc->connection_address().hostname().empty()) {
1453 // For hostname candidates, we use c=IN IP4 <hostname>.
1454 os << " " << kConnectionIpv4Addrtype << " "
1455 << media_desc->connection_address().hostname();
1456 } else {
1457 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
zhihuang38989e52017-03-21 11:04:53 -07001458 }
1459 AddLine(os.str(), message);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001460
1461 // RFC 4566
1462 // b=AS:<bandwidth>
Peter Thatcherc0c3a862015-06-24 15:31:25 -07001463 if (media_desc->bandwidth() >= 1000) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001464 InitLine(kLineTypeSessionBandwidth, kApplicationSpecificMaximum, &os);
1465 os << kSdpDelimiterColon << (media_desc->bandwidth() / 1000);
1466 AddLine(os.str(), message);
1467 }
1468
deadbeef25ed4352016-12-12 18:37:36 -08001469 // Add the a=bundle-only line.
1470 if (content_info->bundle_only) {
1471 InitAttrLine(kAttributeBundleOnly, &os);
1472 AddLine(os.str(), message);
1473 }
1474
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001475 // Add the a=rtcp line.
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001476 if (cricket::IsRtpProtocol(media_desc->protocol())) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001477 std::string rtcp_line = GetRtcpLine(candidates);
1478 if (!rtcp_line.empty()) {
1479 AddLine(rtcp_line, message);
1480 }
1481 }
1482
honghaiza54a0802015-12-16 18:37:23 -08001483 // Build the a=candidate lines. We don't include ufrag and pwd in the
1484 // candidates in the SDP to avoid redundancy.
1485 BuildCandidate(candidates, false, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001486
1487 // Use the transport_info to build the media level ice-ufrag and ice-pwd.
1488 if (transport_info) {
1489 // RFC 5245
1490 // ice-pwd-att = "ice-pwd" ":" password
1491 // ice-ufrag-att = "ice-ufrag" ":" ufrag
1492 // ice-ufrag
deadbeef3f7219b2015-12-28 15:17:14 -08001493 if (!transport_info->description.ice_ufrag.empty()) {
1494 InitAttrLine(kAttributeIceUfrag, &os);
1495 os << kSdpDelimiterColon << transport_info->description.ice_ufrag;
1496 AddLine(os.str(), message);
1497 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001498 // ice-pwd
deadbeef3f7219b2015-12-28 15:17:14 -08001499 if (!transport_info->description.ice_pwd.empty()) {
1500 InitAttrLine(kAttributeIcePwd, &os);
1501 os << kSdpDelimiterColon << transport_info->description.ice_pwd;
1502 AddLine(os.str(), message);
1503 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001504
1505 // draft-petithuguenin-mmusic-ice-attributes-level-03
1506 BuildIceOptions(transport_info->description.transport_options, message);
1507
1508 // RFC 4572
1509 // fingerprint-attribute =
1510 // "fingerprint" ":" hash-func SP fingerprint
1511 if (fp) {
1512 // Insert the fingerprint attribute.
1513 InitAttrLine(kAttributeFingerprint, &os);
Yves Gerey665174f2018-06-19 15:03:05 +02001514 os << kSdpDelimiterColon << fp->algorithm << kSdpDelimiterSpace
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001515 << fp->GetRfc4572Fingerprint();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001516 AddLine(os.str(), message);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001517
1518 // Inserting setup attribute.
1519 if (transport_info->description.connection_role !=
Yves Gerey665174f2018-06-19 15:03:05 +02001520 cricket::CONNECTIONROLE_NONE) {
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001521 // Making sure we are not using "passive" mode.
1522 cricket::ConnectionRole role =
1523 transport_info->description.connection_role;
mallinath@webrtc.org19f27e62013-10-13 17:18:27 +00001524 std::string dtls_role_str;
nissec16fa5e2017-02-07 07:18:43 -08001525 const bool success =
1526 cricket::ConnectionRoleToString(role, &dtls_role_str);
1527 RTC_DCHECK(success);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001528 InitAttrLine(kAttributeSetup, &os);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001529 os << kSdpDelimiterColon << dtls_role_str;
1530 AddLine(os.str(), message);
1531 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001532 }
1533 }
1534
1535 // RFC 3388
1536 // mid-attribute = "a=mid:" identification-tag
1537 // identification-tag = token
1538 // Use the content name as the mid identification-tag.
1539 InitAttrLine(kAttributeMid, &os);
1540 os << kSdpDelimiterColon << content_info->name;
1541 AddLine(os.str(), message);
1542
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001543 if (cricket::IsDtlsSctp(media_desc->protocol())) {
1544 const cricket::SctpDataContentDescription* data_desc =
1545 media_desc->as_sctp();
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +02001546 BuildSctpContentAttributes(message, data_desc);
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001547 } else if (cricket::IsRtpProtocol(media_desc->protocol())) {
Steve Antone831b8c2018-02-01 12:22:16 -08001548 BuildRtpContentAttributes(media_desc, media_type, msid_signaling, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001549 }
1550}
1551
deadbeef9d3584c2016-02-16 17:54:10 -08001552void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001553 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -08001554 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -08001555 std::string* message) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001556 SdpSerializer serializer;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001557 rtc::StringBuilder os;
Johannes Kron0854eb62018-10-10 22:33:20 +02001558 // RFC 8285
1559 // a=extmap-allow-mixed
1560 // The attribute MUST be either on session level or media level. We support
1561 // responding on both levels, however, we don't respond on media level if it's
1562 // set on session level.
Johannes Kron9581bc42018-10-23 10:17:39 +02001563 if (media_desc->extmap_allow_mixed_enum() ==
Johannes Kron0854eb62018-10-10 22:33:20 +02001564 MediaContentDescription::kMedia) {
1565 InitAttrLine(kAttributeExtmapAllowMixed, &os);
1566 AddLine(os.str(), message);
1567 }
1568 // RFC 8285
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001569 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1570 // The definitions MUST be either all session level or all media level. This
1571 // implementation uses all media level.
1572 for (size_t i = 0; i < media_desc->rtp_header_extensions().size(); ++i) {
jbauch5869f502017-06-29 12:31:36 -07001573 const RtpExtension& extension = media_desc->rtp_header_extensions()[i];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001574 InitAttrLine(kAttributeExtmap, &os);
jbauch5869f502017-06-29 12:31:36 -07001575 os << kSdpDelimiterColon << extension.id;
1576 if (extension.encrypt) {
1577 os << kSdpDelimiterSpace << RtpExtension::kEncryptHeaderExtensionsUri;
1578 }
1579 os << kSdpDelimiterSpace << extension.uri;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001580 AddLine(os.str(), message);
1581 }
1582
1583 // RFC 3264
1584 // a=sendrecv || a=sendonly || a=sendrecv || a=inactive
deadbeefc80741f2015-10-22 13:14:45 -07001585 switch (media_desc->direction()) {
Steve Anton4e70a722017-11-28 14:57:10 -08001586 case RtpTransceiverDirection::kInactive:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001587 InitAttrLine(kAttributeInactive, &os);
1588 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001589 case RtpTransceiverDirection::kSendOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001590 InitAttrLine(kAttributeSendOnly, &os);
1591 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001592 case RtpTransceiverDirection::kRecvOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001593 InitAttrLine(kAttributeRecvOnly, &os);
1594 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001595 case RtpTransceiverDirection::kSendRecv:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001596 default:
1597 InitAttrLine(kAttributeSendRecv, &os);
1598 break;
1599 }
1600 AddLine(os.str(), message);
1601
Seth Hampson5b4f0752018-04-02 16:31:36 -07001602 // Specified in https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
1603 // a=msid:<msid-id> <msid-appdata>
1604 // The msid-id is a 1*64 token char representing the media stream id, and the
1605 // msid-appdata is a 1*64 token char representing the track id. There is a
1606 // line for every media stream, with a special msid-id value of "-"
1607 // representing no streams. The value of "msid-appdata" MUST be identical for
1608 // all lines.
Steve Antone831b8c2018-02-01 12:22:16 -08001609 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
1610 const StreamParamsVec& streams = media_desc->streams();
1611 if (streams.size() == 1u) {
1612 const StreamParams& track = streams[0];
Seth Hampson5b4f0752018-04-02 16:31:36 -07001613 std::vector<std::string> stream_ids = track.stream_ids();
1614 if (stream_ids.empty()) {
1615 stream_ids.push_back(kNoStreamMsid);
1616 }
1617 for (const std::string& stream_id : stream_ids) {
1618 InitAttrLine(kAttributeMsid, &os);
1619 os << kSdpDelimiterColon << stream_id << kSdpDelimiterSpace << track.id;
1620 AddLine(os.str(), message);
1621 }
Steve Antone831b8c2018-02-01 12:22:16 -08001622 } else if (streams.size() > 1u) {
1623 RTC_LOG(LS_WARNING)
1624 << "Trying to serialize Unified Plan SDP with more than "
Jonas Olsson45cc8902018-02-13 10:37:07 +01001625 "one track in a media section. Omitting 'a=msid'.";
deadbeef9d3584c2016-02-16 17:54:10 -08001626 }
1627 }
1628
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001629 // RFC 5761
1630 // a=rtcp-mux
1631 if (media_desc->rtcp_mux()) {
1632 InitAttrLine(kAttributeRtcpMux, &os);
1633 AddLine(os.str(), message);
1634 }
1635
deadbeef13871492015-12-09 12:37:51 -08001636 // RFC 5506
1637 // a=rtcp-rsize
1638 if (media_desc->rtcp_reduced_size()) {
1639 InitAttrLine(kAttributeRtcpReducedSize, &os);
1640 AddLine(os.str(), message);
1641 }
1642
deadbeefd45aea82017-09-16 01:24:29 -07001643 if (media_desc->conference_mode()) {
1644 InitAttrLine(kAttributeXGoogleFlag, &os);
1645 os << kSdpDelimiterColon << kValueConference;
1646 AddLine(os.str(), message);
1647 }
1648
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001649 // RFC 4568
1650 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001651 for (const CryptoParams& crypto_params : media_desc->cryptos()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001652 InitAttrLine(kAttributeCrypto, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001653 os << kSdpDelimiterColon << crypto_params.tag << " "
1654 << crypto_params.cipher_suite << " " << crypto_params.key_params;
1655 if (!crypto_params.session_params.empty()) {
1656 os << " " << crypto_params.session_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001657 }
1658 AddLine(os.str(), message);
1659 }
1660
1661 // RFC 4566
1662 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1663 // [/<encodingparameters>]
1664 BuildRtpMap(media_desc, media_type, message);
1665
Steve Anton4daf66e2018-09-07 14:55:53 -07001666 for (const StreamParams& track : media_desc->streams()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001667 // Build the ssrc-group lines.
Steve Anton4daf66e2018-09-07 14:55:53 -07001668 for (const SsrcGroup& ssrc_group : track.ssrc_groups) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001669 // RFC 5576
1670 // a=ssrc-group:<semantics> <ssrc-id> ...
Steve Anton4daf66e2018-09-07 14:55:53 -07001671 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001672 continue;
1673 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001674 InitAttrLine(kAttributeSsrcGroup, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001675 os << kSdpDelimiterColon << ssrc_group.semantics;
1676 for (uint32_t ssrc : ssrc_group.ssrcs) {
1677 os << kSdpDelimiterSpace << rtc::ToString(ssrc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001678 }
1679 AddLine(os.str(), message);
1680 }
1681 // Build the ssrc lines for each ssrc.
Steve Anton4daf66e2018-09-07 14:55:53 -07001682 for (uint32_t ssrc : track.ssrcs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001683 // RFC 5576
1684 // a=ssrc:<ssrc-id> cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07001685 AddSsrcLine(ssrc, kSsrcAttributeCname, track.cname, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001686
Steve Antone831b8c2018-02-01 12:22:16 -08001687 if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
1688 // draft-alvestrand-mmusic-msid-00
1689 // a=ssrc:<ssrc-id> msid:identifier [appdata]
1690 // The appdata consists of the "id" attribute of a MediaStreamTrack,
1691 // which corresponds to the "id" attribute of StreamParams.
Seth Hampson5b4f0752018-04-02 16:31:36 -07001692 // Since a=ssrc msid signaling is used in Plan B SDP semantics, and
1693 // multiple stream ids are not supported for Plan B, we are only adding
1694 // a line for the first media stream id here.
Seth Hampson7fa6ee62018-10-17 10:25:28 -07001695 const std::string& track_stream_id = track.first_stream_id();
1696 // We use a special msid-id value of "-" to represent no streams,
1697 // for Unified Plan compatibility. Plan B will always have a
1698 // track_stream_id.
1699 const std::string& stream_id =
1700 track_stream_id.empty() ? kNoStreamMsid : track_stream_id;
Steve Antone831b8c2018-02-01 12:22:16 -08001701 InitAttrLine(kAttributeSsrc, &os);
1702 os << kSdpDelimiterColon << ssrc << kSdpDelimiterSpace
1703 << kSsrcAttributeMsid << kSdpDelimiterColon << stream_id
Steve Anton4daf66e2018-09-07 14:55:53 -07001704 << kSdpDelimiterSpace << track.id;
Steve Antone831b8c2018-02-01 12:22:16 -08001705 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001706
Steve Antone831b8c2018-02-01 12:22:16 -08001707 // TODO(ronghuawu): Remove below code which is for backward
1708 // compatibility.
1709 // draft-alvestrand-rtcweb-mid-01
1710 // a=ssrc:<ssrc-id> mslabel:<value>
1711 // The label isn't yet defined.
1712 // a=ssrc:<ssrc-id> label:<value>
Seth Hampson5b4f0752018-04-02 16:31:36 -07001713 AddSsrcLine(ssrc, kSsrcAttributeMslabel, stream_id, message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001714 AddSsrcLine(ssrc, kSSrcAttributeLabel, track.id, message);
Steve Antone831b8c2018-02-01 12:22:16 -08001715 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001716 }
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001717
1718 // Build the rid lines for each layer of the track
1719 for (const RidDescription& rid_description : track.rids()) {
1720 InitAttrLine(kAttributeRid, &os);
1721 os << kSdpDelimiterColon
1722 << serializer.SerializeRidDescription(rid_description);
1723 AddLine(os.str(), message);
1724 }
1725 }
1726
Amit Hilbucha2012042018-12-03 11:35:05 -08001727 // Simulcast (a=simulcast)
1728 // https://tools.ietf.org/html/draft-ietf-mmusic-sdp-simulcast-13#section-5.1
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001729 if (media_desc->HasSimulcast()) {
1730 const auto& simulcast = media_desc->simulcast_description();
Amit Hilbucha2012042018-12-03 11:35:05 -08001731 InitAttrLine(kAttributeSimulcast, &os);
Amit Hilbucha2012042018-12-03 11:35:05 -08001732 os << kSdpDelimiterColon
1733 << serializer.SerializeSimulcastDescription(simulcast);
1734 AddLine(os.str(), message);
1735 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001736}
1737
Jonas Olssonec9e4922018-09-05 09:53:49 +02001738void WriteFmtpHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001739 // fmtp header: a=fmtp:|payload_type| <parameters>
1740 // Add a=fmtp
1741 InitAttrLine(kAttributeFmtp, os);
1742 // Add :|payload_type|
1743 *os << kSdpDelimiterColon << payload_type;
1744}
1745
Jonas Olssonec9e4922018-09-05 09:53:49 +02001746void WriteRtcpFbHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001747 // rtcp-fb header: a=rtcp-fb:|payload_type|
1748 // <parameters>/<ccm <ccm_parameters>>
1749 // Add a=rtcp-fb
1750 InitAttrLine(kAttributeRtcpFb, os);
1751 // Add :
1752 *os << kSdpDelimiterColon;
1753 if (payload_type == kWildcardPayloadType) {
1754 *os << "*";
1755 } else {
1756 *os << payload_type;
1757 }
1758}
1759
1760void WriteFmtpParameter(const std::string& parameter_name,
1761 const std::string& parameter_value,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001762 rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001763 // fmtp parameters: |parameter_name|=|parameter_value|
1764 *os << parameter_name << kSdpDelimiterEqual << parameter_value;
1765}
1766
1767void WriteFmtpParameters(const cricket::CodecParameterMap& parameters,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001768 rtc::StringBuilder* os) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001769 bool first = true;
1770 for (const auto& entry : parameters) {
1771 const std::string& key = entry.first;
1772 const std::string& value = entry.second;
hta62a216e2016-04-15 11:02:14 -07001773 // Parameters are a semicolon-separated list, no spaces.
1774 // The list is separated from the header by a space.
Steve Anton4daf66e2018-09-07 14:55:53 -07001775 if (first) {
hta62a216e2016-04-15 11:02:14 -07001776 *os << kSdpDelimiterSpace;
Steve Anton4daf66e2018-09-07 14:55:53 -07001777 first = false;
hta62a216e2016-04-15 11:02:14 -07001778 } else {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001779 *os << kSdpDelimiterSemicolon;
1780 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001781 WriteFmtpParameter(key, value, os);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001782 }
1783}
1784
1785bool IsFmtpParam(const std::string& name) {
ossuaa4b0772017-01-30 07:41:18 -08001786 // RFC 4855, section 3 specifies the mapping of media format parameters to SDP
1787 // parameters. Only ptime, maxptime, channels and rate are placed outside of
1788 // the fmtp line. In WebRTC, channels and rate are already handled separately
1789 // and thus not included in the CodecParameterMap.
1790 return name != kCodecParamPTime && name != kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001791}
1792
1793// Retreives fmtp parameters from |params|, which may contain other parameters
1794// as well, and puts them in |fmtp_parameters|.
1795void GetFmtpParams(const cricket::CodecParameterMap& params,
1796 cricket::CodecParameterMap* fmtp_parameters) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001797 for (const auto& entry : params) {
1798 const std::string& key = entry.first;
1799 const std::string& value = entry.second;
1800 if (IsFmtpParam(key)) {
1801 (*fmtp_parameters)[key] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001802 }
1803 }
1804}
1805
1806template <class T>
1807void AddFmtpLine(const T& codec, std::string* message) {
1808 cricket::CodecParameterMap fmtp_parameters;
1809 GetFmtpParams(codec.params, &fmtp_parameters);
1810 if (fmtp_parameters.empty()) {
1811 // No need to add an fmtp if it will have no (optional) parameters.
1812 return;
1813 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001814 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001815 WriteFmtpHeader(codec.id, &os);
1816 WriteFmtpParameters(fmtp_parameters, &os);
1817 AddLine(os.str(), message);
1818 return;
1819}
1820
1821template <class T>
1822void AddRtcpFbLines(const T& codec, std::string* message) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001823 for (const cricket::FeedbackParam& param : codec.feedback_params.params()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001824 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001825 WriteRtcpFbHeader(codec.id, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001826 os << " " << param.id();
1827 if (!param.param().empty()) {
1828 os << " " << param.param();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001829 }
1830 AddLine(os.str(), message);
1831 }
1832}
1833
1834bool GetMinValue(const std::vector<int>& values, int* value) {
1835 if (values.empty()) {
1836 return false;
1837 }
Steve Anton64b626b2019-01-28 17:25:26 -08001838 auto it = absl::c_min_element(values);
1839 *value = *it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001840 return true;
1841}
1842
1843bool GetParameter(const std::string& name,
Yves Gerey665174f2018-06-19 15:03:05 +02001844 const cricket::CodecParameterMap& params,
1845 int* value) {
1846 std::map<std::string, std::string>::const_iterator found = params.find(name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001847 if (found == params.end()) {
1848 return false;
1849 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00001850 if (!rtc::FromString(found->second, value)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001851 return false;
1852 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001853 return true;
1854}
1855
1856void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001857 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001858 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001859 RTC_DCHECK(message != NULL);
1860 RTC_DCHECK(media_desc != NULL);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001861 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001862 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001863 for (const cricket::VideoCodec& codec : media_desc->as_video()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001864 // RFC 4566
1865 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1866 // [/<encodingparameters>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001867 if (codec.id != kWildcardPayloadType) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001868 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001869 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
deadbeefe814a0d2017-02-25 18:15:09 -08001870 << cricket::kVideoCodecClockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001871 AddLine(os.str(), message);
1872 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001873 AddRtcpFbLines(codec, message);
1874 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001875 }
1876 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001877 std::vector<int> ptimes;
1878 std::vector<int> maxptimes;
1879 int max_minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001880 for (const cricket::AudioCodec& codec : media_desc->as_audio()->codecs()) {
1881 RTC_DCHECK(!codec.name.empty());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001882 // RFC 4566
1883 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1884 // [/<encodingparameters>]
1885 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001886 os << kSdpDelimiterColon << codec.id << " ";
1887 os << codec.name << "/" << codec.clockrate;
1888 if (codec.channels != 1) {
1889 os << "/" << codec.channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001890 }
1891 AddLine(os.str(), message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001892 AddRtcpFbLines(codec, message);
1893 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001894 int minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001895 if (GetParameter(kCodecParamMinPTime, codec.params, &minptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001896 max_minptime = std::max(minptime, max_minptime);
1897 }
1898 int ptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001899 if (GetParameter(kCodecParamPTime, codec.params, &ptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001900 ptimes.push_back(ptime);
1901 }
1902 int maxptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001903 if (GetParameter(kCodecParamMaxPTime, codec.params, &maxptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001904 maxptimes.push_back(maxptime);
1905 }
1906 }
1907 // Populate the maxptime attribute with the smallest maxptime of all codecs
1908 // under the same m-line.
1909 int min_maxptime = INT_MAX;
1910 if (GetMinValue(maxptimes, &min_maxptime)) {
1911 AddAttributeLine(kCodecParamMaxPTime, min_maxptime, message);
1912 }
nisseede5da42017-01-12 05:15:36 -08001913 RTC_DCHECK(min_maxptime > max_minptime);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001914 // Populate the ptime attribute with the smallest ptime or the largest
1915 // minptime, whichever is the largest, for all codecs under the same m-line.
1916 int ptime = INT_MAX;
1917 if (GetMinValue(ptimes, &ptime)) {
1918 ptime = std::min(ptime, min_maxptime);
1919 ptime = std::max(ptime, max_minptime);
1920 AddAttributeLine(kCodecParamPTime, ptime, message);
1921 }
1922 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001923 if (media_desc->as_rtp_data()) {
1924 for (const cricket::RtpDataCodec& codec :
1925 media_desc->as_rtp_data()->codecs()) {
1926 // RFC 4566
1927 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1928 // [/<encodingparameters>]
1929 InitAttrLine(kAttributeRtpmap, &os);
1930 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
1931 << codec.clockrate;
1932 AddLine(os.str(), message);
1933 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001934 }
1935 }
1936}
1937
1938void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -08001939 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001940 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001941 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001942
Steve Anton4daf66e2018-09-07 14:55:53 -07001943 for (const Candidate& candidate : candidates) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001944 // RFC 5245
1945 // a=candidate:<foundation> <component-id> <transport> <priority>
1946 // <connection-address> <port> typ <candidate-types>
1947 // [raddr <connection-address>] [rport <port>]
1948 // *(SP extension-att-name SP extension-att-value)
1949 std::string type;
1950 // Map the cricket candidate type to "host" / "srflx" / "prflx" / "relay"
Steve Anton4daf66e2018-09-07 14:55:53 -07001951 if (candidate.type() == cricket::LOCAL_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001952 type = kCandidateHost;
Steve Anton4daf66e2018-09-07 14:55:53 -07001953 } else if (candidate.type() == cricket::STUN_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001954 type = kCandidateSrflx;
Steve Anton4daf66e2018-09-07 14:55:53 -07001955 } else if (candidate.type() == cricket::RELAY_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001956 type = kCandidateRelay;
Steve Anton4daf66e2018-09-07 14:55:53 -07001957 } else if (candidate.type() == cricket::PRFLX_PORT_TYPE) {
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001958 type = kCandidatePrflx;
1959 // Peer reflexive candidate may be signaled for being removed.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001960 } else {
nissec80e7412017-01-11 05:56:46 -08001961 RTC_NOTREACHED();
Peter Thatcher019087f2015-04-28 09:06:26 -07001962 // Never write out candidates if we don't know the type.
1963 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001964 }
1965
1966 InitAttrLine(kAttributeCandidate, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001967 os << kSdpDelimiterColon << candidate.foundation() << " "
1968 << candidate.component() << " " << candidate.protocol() << " "
1969 << candidate.priority() << " "
1970 << (candidate.address().ipaddr().IsNil()
1971 ? candidate.address().hostname()
1972 : candidate.address().ipaddr().ToString())
1973 << " " << candidate.address().PortAsString() << " "
1974 << kAttributeCandidateTyp << " " << type << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001975
1976 // Related address
Steve Anton4daf66e2018-09-07 14:55:53 -07001977 if (!candidate.related_address().IsNil()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001978 os << kAttributeCandidateRaddr << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001979 << candidate.related_address().ipaddr().ToString() << " "
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001980 << kAttributeCandidateRport << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001981 << candidate.related_address().PortAsString() << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001982 }
1983
Steve Anton4daf66e2018-09-07 14:55:53 -07001984 if (candidate.protocol() == cricket::TCP_PROTOCOL_NAME) {
1985 os << kTcpCandidateType << " " << candidate.tcptype() << " ";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001986 }
1987
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001988 // Extensions
Steve Anton4daf66e2018-09-07 14:55:53 -07001989 os << kAttributeCandidateGeneration << " " << candidate.generation();
1990 if (include_ufrag && !candidate.username().empty()) {
1991 os << " " << kAttributeCandidateUfrag << " " << candidate.username();
honghaiza54a0802015-12-16 18:37:23 -08001992 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001993 if (candidate.network_id() > 0) {
1994 os << " " << kAttributeCandidateNetworkId << " "
1995 << candidate.network_id();
honghaiza0c44ea2016-03-23 16:07:48 -07001996 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001997 if (candidate.network_cost() > 0) {
1998 os << " " << kAttributeCandidateNetworkCost << " "
1999 << candidate.network_cost();
honghaize1a0c942016-02-16 14:54:56 -08002000 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002001
2002 AddLine(os.str(), message);
2003 }
2004}
2005
2006void BuildIceOptions(const std::vector<std::string>& transport_options,
2007 std::string* message) {
2008 if (!transport_options.empty()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002009 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002010 InitAttrLine(kAttributeIceOption, &os);
2011 os << kSdpDelimiterColon << transport_options[0];
2012 for (size_t i = 1; i < transport_options.size(); ++i) {
2013 os << kSdpDelimiterSpace << transport_options[i];
2014 }
2015 AddLine(os.str(), message);
2016 }
2017}
2018
zhihuang38989e52017-03-21 11:04:53 -07002019bool ParseConnectionData(const std::string& line,
2020 rtc::SocketAddress* addr,
2021 SdpParseError* error) {
2022 // Parse the line from left to right.
2023 std::string token;
2024 std::string rightpart;
2025 // RFC 4566
2026 // c=<nettype> <addrtype> <connection-address>
2027 // Skip the "c="
Jonas Olssonec9e4922018-09-05 09:53:49 +02002028 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, &token, &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07002029 return ParseFailed(line, "Failed to parse the network type.", error);
2030 }
2031
2032 // Extract and verify the <nettype>
Jonas Olssonec9e4922018-09-05 09:53:49 +02002033 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2034 &rightpart) ||
zhihuang38989e52017-03-21 11:04:53 -07002035 token != kConnectionNettype) {
2036 return ParseFailed(line,
2037 "Failed to parse the connection data. The network type "
2038 "is not currently supported.",
2039 error);
2040 }
2041
2042 // Extract the "<addrtype>" and "<connection-address>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02002043 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2044 &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07002045 return ParseFailed(line, "Failed to parse the address type.", error);
2046 }
2047
2048 // The rightpart part should be the IP address without the slash which is used
2049 // for multicast.
2050 if (rightpart.find('/') != std::string::npos) {
2051 return ParseFailed(line,
2052 "Failed to parse the connection data. Multicast is not "
2053 "currently supported.",
2054 error);
2055 }
2056 addr->SetIP(rightpart);
2057
2058 // Verify that the addrtype matches the type of the parsed address.
2059 if ((addr->family() == AF_INET && token != "IP4") ||
2060 (addr->family() == AF_INET6 && token != "IP6")) {
2061 addr->Clear();
2062 return ParseFailed(
2063 line,
2064 "Failed to parse the connection data. The address type is mismatching.",
2065 error);
2066 }
2067 return true;
2068}
2069
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -08002070bool ParseMediaTransportLine(const std::string& line,
2071 std::string* transport_name,
2072 std::string* transport_setting,
2073 SdpParseError* error) {
2074 std::string value;
2075 if (!GetValue(line, kMediaTransportSettingLine, &value, error)) {
2076 return false;
2077 }
2078 std::string media_transport_settings_base64;
2079 if (!rtc::tokenize_first(value, kSdpDelimiterColonChar, transport_name,
2080 &media_transport_settings_base64)) {
2081 return ParseFailedGetValue(line, kMediaTransportSettingLine, error);
2082 }
2083 if (!rtc::Base64::Decode(media_transport_settings_base64,
2084 rtc::Base64::DO_STRICT, transport_setting,
2085 nullptr)) {
2086 return ParseFailedGetValue(line, kMediaTransportSettingLine, error);
2087 }
2088
2089 return true;
2090}
2091
zhihuang38989e52017-03-21 11:04:53 -07002092bool ParseSessionDescription(const std::string& message,
2093 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002094 std::string* session_id,
2095 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002096 TransportDescription* session_td,
2097 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -07002098 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002099 cricket::SessionDescription* desc,
2100 SdpParseError* error) {
2101 std::string line;
2102
deadbeefc80741f2015-10-22 13:14:45 -07002103 desc->set_msid_supported(false);
Johannes Kron9581bc42018-10-23 10:17:39 +02002104 desc->set_extmap_allow_mixed(false);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002105 // RFC 4566
2106 // v= (protocol version)
2107 if (!GetLineWithType(message, pos, &line, kLineTypeVersion)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002108 return ParseFailedExpectLine(message, *pos, kLineTypeVersion, std::string(),
2109 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002110 }
2111 // RFC 4566
2112 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
2113 // <unicast-address>
2114 if (!GetLineWithType(message, pos, &line, kLineTypeOrigin)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002115 return ParseFailedExpectLine(message, *pos, kLineTypeOrigin, std::string(),
2116 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002117 }
2118 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002119 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002120 const size_t expected_fields = 6;
2121 if (fields.size() != expected_fields) {
2122 return ParseFailedExpectFieldNum(line, expected_fields, error);
2123 }
2124 *session_id = fields[1];
2125 *session_version = fields[2];
2126
2127 // RFC 4566
2128 // s= (session name)
2129 if (!GetLineWithType(message, pos, &line, kLineTypeSessionName)) {
2130 return ParseFailedExpectLine(message, *pos, kLineTypeSessionName,
2131 std::string(), error);
2132 }
2133
Danil Chapovalov66cadcc2018-06-19 16:47:43 +02002134 // absl::optional lines
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002135 // Those are the optional lines, so shouldn't return false if not present.
2136 // RFC 4566
2137 // i=* (session information)
2138 GetLineWithType(message, pos, &line, kLineTypeSessionInfo);
2139
2140 // RFC 4566
2141 // u=* (URI of description)
2142 GetLineWithType(message, pos, &line, kLineTypeSessionUri);
2143
2144 // RFC 4566
2145 // e=* (email address)
2146 GetLineWithType(message, pos, &line, kLineTypeSessionEmail);
2147
2148 // RFC 4566
2149 // p=* (phone number)
2150 GetLineWithType(message, pos, &line, kLineTypeSessionPhone);
2151
2152 // RFC 4566
2153 // c=* (connection information -- not required if included in
2154 // all media)
zhihuang38989e52017-03-21 11:04:53 -07002155 if (GetLineWithType(message, pos, &line, kLineTypeConnection)) {
2156 if (!ParseConnectionData(line, connection_addr, error)) {
2157 return false;
2158 }
2159 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002160
2161 // RFC 4566
2162 // b=* (zero or more bandwidth information lines)
2163 while (GetLineWithType(message, pos, &line, kLineTypeSessionBandwidth)) {
2164 // By pass zero or more b lines.
2165 }
2166
2167 // RFC 4566
2168 // One or more time descriptions ("t=" and "r=" lines; see below)
2169 // t= (time the session is active)
2170 // r=* (zero or more repeat times)
2171 // Ensure there's at least one time description
2172 if (!GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2173 return ParseFailedExpectLine(message, *pos, kLineTypeTiming, std::string(),
2174 error);
2175 }
2176
2177 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2178 // By pass zero or more r lines.
2179 }
2180
2181 // Go through the rest of the time descriptions
2182 while (GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2183 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2184 // By pass zero or more r lines.
2185 }
2186 }
2187
2188 // RFC 4566
2189 // z=* (time zone adjustments)
2190 GetLineWithType(message, pos, &line, kLineTypeTimeZone);
2191
2192 // RFC 4566
2193 // k=* (encryption key)
2194 GetLineWithType(message, pos, &line, kLineTypeEncryptionKey);
2195
2196 // RFC 4566
2197 // a=* (zero or more session attribute lines)
2198 while (GetLineWithType(message, pos, &line, kLineTypeAttributes)) {
2199 if (HasAttribute(line, kAttributeGroup)) {
2200 if (!ParseGroupAttribute(line, desc, error)) {
2201 return false;
2202 }
2203 } else if (HasAttribute(line, kAttributeIceUfrag)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002204 if (!GetValue(line, kAttributeIceUfrag, &(session_td->ice_ufrag),
2205 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002206 return false;
2207 }
2208 } else if (HasAttribute(line, kAttributeIcePwd)) {
2209 if (!GetValue(line, kAttributeIcePwd, &(session_td->ice_pwd), error)) {
2210 return false;
2211 }
2212 } else if (HasAttribute(line, kAttributeIceLite)) {
2213 session_td->ice_mode = cricket::ICEMODE_LITE;
2214 } else if (HasAttribute(line, kAttributeIceOption)) {
2215 if (!ParseIceOptions(line, &(session_td->transport_options), error)) {
2216 return false;
2217 }
2218 } else if (HasAttribute(line, kAttributeFingerprint)) {
2219 if (session_td->identity_fingerprint.get()) {
2220 return ParseFailed(
2221 line,
2222 "Can't have multiple fingerprint attributes at the same level.",
2223 error);
2224 }
Steve Anton4905edb2018-10-15 19:27:44 -07002225 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002226 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2227 return false;
2228 }
Steve Anton4905edb2018-10-15 19:27:44 -07002229 session_td->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002230 } else if (HasAttribute(line, kAttributeSetup)) {
2231 if (!ParseDtlsSetup(line, &(session_td->connection_role), error)) {
2232 return false;
2233 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002234 } else if (HasAttribute(line, kAttributeMsidSemantics)) {
2235 std::string semantics;
2236 if (!GetValue(line, kAttributeMsidSemantics, &semantics, error)) {
2237 return false;
2238 }
deadbeefc80741f2015-10-22 13:14:45 -07002239 desc->set_msid_supported(
2240 CaseInsensitiveFind(semantics, kMediaStreamSemantic));
Johannes Kron0854eb62018-10-10 22:33:20 +02002241 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02002242 desc->set_extmap_allow_mixed(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002243 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002244 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002245 if (!ParseExtmap(line, &extmap, error)) {
2246 return false;
2247 }
2248 session_extmaps->push_back(extmap);
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -08002249 } else if (HasAttribute(line, kMediaTransportSettingLine)) {
2250 std::string transport_name;
2251 std::string transport_setting;
2252 if (!ParseMediaTransportLine(line, &transport_name, &transport_setting,
2253 error)) {
2254 return false;
2255 }
2256
2257 for (const auto& setting : desc->MediaTransportSettings()) {
2258 if (setting.transport_name == transport_name) {
2259 // Ignore repeated transport names rather than failing to parse so
2260 // that in the future the same transport could have multiple configs.
2261 RTC_LOG(INFO) << "x-mt line with repeated transport, transport_name="
2262 << transport_name;
2263 return true;
2264 }
2265 }
2266 desc->AddMediaTransportSetting(transport_name, transport_setting);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002267 }
2268 }
2269
2270 return true;
2271}
2272
2273bool ParseGroupAttribute(const std::string& line,
2274 cricket::SessionDescription* desc,
2275 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002276 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002277
2278 // RFC 5888 and draft-holmberg-mmusic-sdp-bundle-negotiation-00
2279 // a=group:BUNDLE video voice
2280 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002281 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002282 std::string semantics;
2283 if (!GetValue(fields[0], kAttributeGroup, &semantics, error)) {
2284 return false;
2285 }
2286 cricket::ContentGroup group(semantics);
2287 for (size_t i = 1; i < fields.size(); ++i) {
2288 group.AddContentName(fields[i]);
2289 }
2290 desc->AddGroup(group);
2291 return true;
2292}
2293
Steve Anton4905edb2018-10-15 19:27:44 -07002294static bool ParseFingerprintAttribute(
2295 const std::string& line,
2296 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
2297 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002298 if (!IsLineType(line, kLineTypeAttributes) ||
2299 !HasAttribute(line, kAttributeFingerprint)) {
2300 return ParseFailedExpectLine(line, 0, kLineTypeAttributes,
2301 kAttributeFingerprint, error);
2302 }
2303
2304 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002305 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002306 const size_t expected_fields = 2;
2307 if (fields.size() != expected_fields) {
2308 return ParseFailedExpectFieldNum(line, expected_fields, error);
2309 }
2310
2311 // The first field here is "fingerprint:<hash>.
2312 std::string algorithm;
2313 if (!GetValue(fields[0], kAttributeFingerprint, &algorithm, error)) {
2314 return false;
2315 }
2316
2317 // Downcase the algorithm. Note that we don't need to downcase the
2318 // fingerprint because hex_decode can handle upper-case.
Steve Anton64b626b2019-01-28 17:25:26 -08002319 absl::c_transform(algorithm, algorithm.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002320
2321 // The second field is the digest value. De-hexify it.
Steve Anton4905edb2018-10-15 19:27:44 -07002322 *fingerprint =
2323 rtc::SSLFingerprint::CreateUniqueFromRfc4572(algorithm, fields[1]);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002324 if (!*fingerprint) {
Yves Gerey665174f2018-06-19 15:03:05 +02002325 return ParseFailed(line, "Failed to create fingerprint from the digest.",
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002326 error);
2327 }
2328
2329 return true;
2330}
2331
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002332static bool ParseDtlsSetup(const std::string& line,
2333 cricket::ConnectionRole* role,
2334 SdpParseError* error) {
2335 // setup-attr = "a=setup:" role
2336 // role = "active" / "passive" / "actpass" / "holdconn"
2337 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002338 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002339 const size_t expected_fields = 2;
2340 if (fields.size() != expected_fields) {
2341 return ParseFailedExpectFieldNum(line, expected_fields, error);
2342 }
2343 std::string role_str = fields[1];
2344 if (!cricket::StringToConnectionRole(role_str, role)) {
2345 return ParseFailed(line, "Invalid attribute value.", error);
2346 }
2347 return true;
2348}
2349
deadbeef9d3584c2016-02-16 17:54:10 -08002350static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -07002351 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -08002352 std::string* track_id,
2353 SdpParseError* error) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002354 // https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
deadbeef9d3584c2016-02-16 17:54:10 -08002355 // a=msid:<stream id> <track id>
2356 // msid-value = msid-id [ SP msid-appdata ]
2357 // msid-id = 1*64token-char ; see RFC 4566
2358 // msid-appdata = 1*64token-char ; see RFC 4566
2359 std::string field1;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002360 std::string new_stream_id;
2361 std::string new_track_id;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002362 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
2363 kSdpDelimiterSpaceChar, &field1, &new_track_id)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002364 const size_t expected_fields = 2;
2365 return ParseFailedExpectFieldNum(line, expected_fields, error);
2366 }
2367
Seth Hampson5b4f0752018-04-02 16:31:36 -07002368 if (new_track_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002369 return ParseFailed(line, "Missing track ID in msid attribute.", error);
2370 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002371 // All track ids should be the same within an m section in a Unified Plan SDP.
2372 if (!track_id->empty() && new_track_id.compare(*track_id) != 0) {
2373 return ParseFailed(
2374 line, "Two different track IDs in msid attribute in one m= section",
2375 error);
2376 }
2377 *track_id = new_track_id;
deadbeefa4549d62017-02-10 17:26:22 -08002378
deadbeef9d3584c2016-02-16 17:54:10 -08002379 // msid:<msid-id>
Seth Hampson5b4f0752018-04-02 16:31:36 -07002380 if (!GetValue(field1, kAttributeMsid, &new_stream_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002381 return false;
2382 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002383 if (new_stream_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002384 return ParseFailed(line, "Missing stream ID in msid attribute.", error);
2385 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002386 // The special value "-" indicates "no MediaStream".
2387 if (new_stream_id.compare(kNoStreamMsid) != 0) {
2388 stream_ids->push_back(new_stream_id);
2389 }
deadbeef9d3584c2016-02-16 17:54:10 -08002390 return true;
2391}
2392
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002393static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
2394 std::vector<RidDescription>* rids) {
2395 RTC_DCHECK(rids);
2396 std::set<std::string> to_remove;
2397 std::set<std::string> unique_rids;
2398
2399 // Check the rids to see which ones should be removed.
2400 for (RidDescription& rid : *rids) {
2401 // In the case of a duplicate, the entire "a=rid" line, and all "a=rid"
2402 // lines with rid-ids that duplicate this line, are discarded and MUST NOT
2403 // be included in the SDP Answer.
2404 auto pair = unique_rids.insert(rid.rid);
2405 // Insert will "fail" if element already exists.
2406 if (!pair.second) {
2407 to_remove.insert(rid.rid);
2408 continue;
2409 }
2410
2411 // If the "a=rid" line contains a "pt=", the list of payload types
2412 // is verified against the list of valid payload types for the media
2413 // section (that is, those listed on the "m=" line). Any PT missing
2414 // from the "m=" line is discarded from the set of values in the
2415 // "pt=". If no values are left in the "pt=" parameter after this
2416 // processing, then the "a=rid" line is discarded.
2417 if (rid.payload_types.empty()) {
2418 // If formats were not specified, rid should not be removed.
2419 continue;
2420 }
2421
2422 // Note: Spec does not mention how to handle duplicate formats.
2423 // Media section does not handle duplicates either.
2424 std::set<int> removed_formats;
2425 for (int payload_type : rid.payload_types) {
Steve Anton64b626b2019-01-28 17:25:26 -08002426 if (!absl::c_linear_search(payload_types, payload_type)) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002427 removed_formats.insert(payload_type);
2428 }
2429 }
2430
2431 rid.payload_types.erase(
2432 std::remove_if(rid.payload_types.begin(), rid.payload_types.end(),
2433 [&removed_formats](int format) {
2434 return removed_formats.count(format) > 0;
2435 }),
2436 rid.payload_types.end());
2437
2438 // If all formats were removed then remove the rid alogether.
2439 if (rid.payload_types.empty()) {
2440 to_remove.insert(rid.rid);
2441 }
2442 }
2443
2444 // Remove every rid description that appears in the to_remove list.
2445 if (!to_remove.empty()) {
2446 rids->erase(std::remove_if(rids->begin(), rids->end(),
2447 [&to_remove](const RidDescription& rid) {
2448 return to_remove.count(rid.rid) > 0;
2449 }),
2450 rids->end());
2451 }
2452}
2453
2454// Create a new list (because SimulcastLayerList is immutable) without any
2455// layers that have a rid in the to_remove list.
2456// If a group of alternatives is empty after removing layers, the group should
2457// be removed altogether.
2458static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
2459 const std::set<std::string>& to_remove,
2460 const SimulcastLayerList& layers) {
2461 SimulcastLayerList result;
2462 for (const std::vector<SimulcastLayer>& vector : layers) {
2463 std::vector<SimulcastLayer> new_layers;
2464 for (const SimulcastLayer& layer : vector) {
2465 if (to_remove.find(layer.rid) == to_remove.end()) {
2466 new_layers.push_back(layer);
2467 }
2468 }
2469 // If all layers were removed, do not add an entry.
2470 if (!new_layers.empty()) {
2471 result.AddLayerWithAlternatives(new_layers);
2472 }
2473 }
2474
2475 return result;
2476}
2477
2478// Will remove Simulcast Layers if:
2479// 1. They appear in both send and receive directions.
2480// 2. They do not appear in the list of |valid_rids|.
2481static void RemoveInvalidRidsFromSimulcast(
2482 const std::vector<RidDescription>& valid_rids,
2483 SimulcastDescription* simulcast) {
2484 RTC_DCHECK(simulcast);
2485 std::set<std::string> to_remove;
2486 std::vector<SimulcastLayer> all_send_layers =
2487 simulcast->send_layers().GetAllLayers();
2488 std::vector<SimulcastLayer> all_receive_layers =
2489 simulcast->receive_layers().GetAllLayers();
2490
2491 // If a rid appears in both send and receive directions, remove it from both.
2492 // This algorithm runs in O(n^2) time, but for small n (as is the case with
2493 // simulcast layers) it should still perform well.
2494 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002495 if (absl::c_any_of(all_receive_layers,
2496 [&send_layer](const SimulcastLayer& layer) {
2497 return layer.rid == send_layer.rid;
2498 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002499 to_remove.insert(send_layer.rid);
2500 }
2501 }
2502
2503 // Add any rid that is not in the valid list to the remove set.
2504 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002505 if (absl::c_none_of(valid_rids, [&send_layer](const RidDescription& rid) {
2506 return send_layer.rid == rid.rid;
2507 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002508 to_remove.insert(send_layer.rid);
2509 }
2510 }
2511
2512 // Add any rid that is not in the valid list to the remove set.
2513 for (const SimulcastLayer& receive_layer : all_receive_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002514 if (absl::c_none_of(valid_rids,
2515 [&receive_layer](const RidDescription& rid) {
2516 return receive_layer.rid == rid.rid;
2517 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002518 to_remove.insert(receive_layer.rid);
2519 }
2520 }
2521
2522 simulcast->send_layers() =
2523 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->send_layers());
2524 simulcast->receive_layers() =
2525 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->receive_layers());
2526}
2527
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002528// RFC 3551
2529// PT encoding media type clock rate channels
2530// name (Hz)
2531// 0 PCMU A 8,000 1
2532// 1 reserved A
2533// 2 reserved A
2534// 3 GSM A 8,000 1
2535// 4 G723 A 8,000 1
2536// 5 DVI4 A 8,000 1
2537// 6 DVI4 A 16,000 1
2538// 7 LPC A 8,000 1
2539// 8 PCMA A 8,000 1
2540// 9 G722 A 8,000 1
2541// 10 L16 A 44,100 2
2542// 11 L16 A 44,100 1
2543// 12 QCELP A 8,000 1
2544// 13 CN A 8,000 1
2545// 14 MPA A 90,000 (see text)
2546// 15 G728 A 8,000 1
2547// 16 DVI4 A 11,025 1
2548// 17 DVI4 A 22,050 1
2549// 18 G729 A 8,000 1
2550struct StaticPayloadAudioCodec {
2551 const char* name;
2552 int clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002553 size_t channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002554};
2555static const StaticPayloadAudioCodec kStaticPayloadAudioCodecs[] = {
Yves Gerey665174f2018-06-19 15:03:05 +02002556 {"PCMU", 8000, 1}, {"reserved", 0, 0}, {"reserved", 0, 0},
2557 {"GSM", 8000, 1}, {"G723", 8000, 1}, {"DVI4", 8000, 1},
2558 {"DVI4", 16000, 1}, {"LPC", 8000, 1}, {"PCMA", 8000, 1},
2559 {"G722", 8000, 1}, {"L16", 44100, 2}, {"L16", 44100, 1},
2560 {"QCELP", 8000, 1}, {"CN", 8000, 1}, {"MPA", 90000, 1},
2561 {"G728", 8000, 1}, {"DVI4", 11025, 1}, {"DVI4", 22050, 1},
2562 {"G729", 8000, 1},
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002563};
2564
Yves Gerey665174f2018-06-19 15:03:05 +02002565void MaybeCreateStaticPayloadAudioCodecs(const std::vector<int>& fmts,
2566 AudioContentDescription* media_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002567 if (!media_desc) {
2568 return;
2569 }
deadbeef67cf2c12016-04-13 10:07:16 -07002570 RTC_DCHECK(media_desc->codecs().empty());
solenberg9fa49752016-10-08 13:02:44 -07002571 for (int payload_type : fmts) {
Yves Gerey665174f2018-06-19 15:03:05 +02002572 if (!media_desc->HasCodec(payload_type) && payload_type >= 0 &&
kjellander3e33bfe2016-06-20 07:04:09 -07002573 static_cast<uint32_t>(payload_type) <
2574 arraysize(kStaticPayloadAudioCodecs)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002575 std::string encoding_name = kStaticPayloadAudioCodecs[payload_type].name;
2576 int clock_rate = kStaticPayloadAudioCodecs[payload_type].clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002577 size_t channels = kStaticPayloadAudioCodecs[payload_type].channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002578 media_desc->AddCodec(cricket::AudioCodec(payload_type, encoding_name,
deadbeef67cf2c12016-04-13 10:07:16 -07002579 clock_rate, 0, channels));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002580 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002581 }
2582}
2583
2584template <class C>
Steve Anton5a1de872018-12-18 11:25:55 -08002585static std::unique_ptr<C> ParseContentDescription(
2586 const std::string& message,
2587 const cricket::MediaType media_type,
2588 int mline_index,
2589 const std::string& protocol,
2590 const std::vector<int>& payload_types,
2591 size_t* pos,
2592 std::string* content_name,
2593 bool* bundle_only,
2594 int* msid_signaling,
2595 TransportDescription* transport,
2596 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2597 webrtc::SdpParseError* error) {
2598 auto media_desc = absl::make_unique<C>();
deadbeef67cf2c12016-04-13 10:07:16 -07002599 if (!ParseContent(message, media_type, mline_index, protocol, payload_types,
Steve Anton5a1de872018-12-18 11:25:55 -08002600 pos, content_name, bundle_only, msid_signaling,
2601 media_desc.get(), transport, candidates, error)) {
zhihuang38989e52017-03-21 11:04:53 -07002602 return nullptr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002603 }
2604 // Sort the codecs according to the m-line fmt list.
deadbeef67cf2c12016-04-13 10:07:16 -07002605 std::unordered_map<int, int> payload_type_preferences;
2606 // "size + 1" so that the lowest preference payload type has a preference of
2607 // 1, which is greater than the default (0) for payload types not in the fmt
2608 // list.
2609 int preference = static_cast<int>(payload_types.size() + 1);
2610 for (int pt : payload_types) {
2611 payload_type_preferences[pt] = preference--;
2612 }
2613 std::vector<typename C::CodecType> codecs = media_desc->codecs();
Steve Anton64b626b2019-01-28 17:25:26 -08002614 absl::c_sort(
2615 codecs, [&payload_type_preferences](const typename C::CodecType& a,
2616 const typename C::CodecType& b) {
2617 return payload_type_preferences[a.id] > payload_type_preferences[b.id];
2618 });
deadbeef67cf2c12016-04-13 10:07:16 -07002619 media_desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002620 return media_desc;
2621}
2622
Steve Anton5a1de872018-12-18 11:25:55 -08002623bool ParseMediaDescription(
2624 const std::string& message,
2625 const TransportDescription& session_td,
2626 const RtpHeaderExtensions& session_extmaps,
2627 size_t* pos,
2628 const rtc::SocketAddress& session_connection_addr,
2629 cricket::SessionDescription* desc,
2630 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2631 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002632 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002633 std::string line;
2634 int mline_index = -1;
Steve Antone831b8c2018-02-01 12:22:16 -08002635 int msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002636
2637 // Zero or more media descriptions
2638 // RFC 4566
2639 // m=<media> <port> <proto> <fmt>
2640 while (GetLineWithType(message, pos, &line, kLineTypeMedia)) {
2641 ++mline_index;
2642
2643 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002644 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
zstein4b2e0822017-02-17 19:48:38 -08002645
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002646 const size_t expected_min_fields = 4;
2647 if (fields.size() < expected_min_fields) {
2648 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
2649 }
deadbeef25ed4352016-12-12 18:37:36 -08002650 bool port_rejected = false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002651 // RFC 3264
2652 // To reject an offered stream, the port number in the corresponding stream
2653 // in the answer MUST be set to zero.
2654 if (fields[1] == kMediaPortRejected) {
deadbeef25ed4352016-12-12 18:37:36 -08002655 port_rejected = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002656 }
2657
zhihuang38989e52017-03-21 11:04:53 -07002658 int port = 0;
2659 if (!rtc::FromString<int>(fields[1], &port) || !IsValidPort(port)) {
2660 return ParseFailed(line, "The port number is invalid", error);
2661 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002662 std::string protocol = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002663
2664 // <fmt>
deadbeef67cf2c12016-04-13 10:07:16 -07002665 std::vector<int> payload_types;
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002666 if (cricket::IsRtpProtocol(protocol)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002667 for (size_t j = 3; j < fields.size(); ++j) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002668 // TODO(wu): Remove when below bug is fixed.
2669 // https://bugzilla.mozilla.org/show_bug.cgi?id=996329
pbosbb36fdf2015-07-09 07:48:14 -07002670 if (fields[j].empty() && j == fields.size() - 1) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002671 continue;
2672 }
wu@webrtc.org36eda7c2014-04-15 20:37:30 +00002673
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002674 int pl = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00002675 if (!GetPayloadTypeFromString(line, fields[j], &pl, error)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002676 return false;
2677 }
deadbeef67cf2c12016-04-13 10:07:16 -07002678 payload_types.push_back(pl);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002679 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002680 }
2681
2682 // Make a temporary TransportDescription based on |session_td|.
2683 // Some of this gets overwritten by ParseContent.
deadbeef46eed762016-01-28 13:24:37 -08002684 TransportDescription transport(
2685 session_td.transport_options, session_td.ice_ufrag, session_td.ice_pwd,
2686 session_td.ice_mode, session_td.connection_role,
2687 session_td.identity_fingerprint.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002688
kwibergd1fe2812016-04-27 06:47:29 -07002689 std::unique_ptr<MediaContentDescription> content;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002690 std::string content_name;
deadbeef25ed4352016-12-12 18:37:36 -08002691 bool bundle_only = false;
Steve Antone831b8c2018-02-01 12:22:16 -08002692 int section_msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002693 if (HasAttribute(line, kMediaTypeVideo)) {
Steve Anton5a1de872018-12-18 11:25:55 -08002694 content = ParseContentDescription<VideoContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002695 message, cricket::MEDIA_TYPE_VIDEO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002696 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 11:25:55 -08002697 &section_msid_signaling, &transport, candidates, error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002698 } else if (HasAttribute(line, kMediaTypeAudio)) {
Steve Anton5a1de872018-12-18 11:25:55 -08002699 content = ParseContentDescription<AudioContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002700 message, cricket::MEDIA_TYPE_AUDIO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002701 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 11:25:55 -08002702 &section_msid_signaling, &transport, candidates, error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002703 } else if (HasAttribute(line, kMediaTypeData)) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002704 if (cricket::IsDtlsSctp(protocol)) {
2705 // The draft-03 format is:
2706 // m=application <port> DTLS/SCTP <sctp-port>...
2707 // use_sctpmap should be false.
2708 // The draft-26 format is:
2709 // m=application <port> UDP/DTLS/SCTP webrtc-datachannel
2710 // use_sctpmap should be false.
2711 auto data_desc = absl::make_unique<SctpDataContentDescription>();
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +02002712 // Default max message size is 64K
2713 // according to draft-ietf-mmusic-sctp-sdp-26
2714 data_desc->set_max_message_size(kDefaultSctpMaxMessageSize);
zstein4b2e0822017-02-17 19:48:38 -08002715 int p;
2716 if (rtc::FromString(fields[3], &p)) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002717 data_desc->set_port(p);
zstein4b2e0822017-02-17 19:48:38 -08002718 } else if (fields[3] == kDefaultSctpmapProtocol) {
2719 data_desc->set_use_sctpmap(false);
2720 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002721 if (!ParseContent(message, cricket::MEDIA_TYPE_DATA, mline_index,
2722 protocol, payload_types, pos, &content_name,
2723 &bundle_only, &section_msid_signaling,
2724 data_desc.get(), &transport, candidates, error)) {
2725 return false;
2726 }
2727 data_desc->set_protocol(protocol);
2728 content = std::move(data_desc);
2729 } else {
2730 // RTP
2731 std::unique_ptr<RtpDataContentDescription> data_desc =
2732 ParseContentDescription<RtpDataContentDescription>(
2733 message, cricket::MEDIA_TYPE_DATA, mline_index, protocol,
2734 payload_types, pos, &content_name, &bundle_only,
2735 &section_msid_signaling, &transport, candidates, error);
2736 content = std::move(data_desc);
wu@webrtc.org78187522013-10-07 23:32:02 +00002737 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002738 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002739 RTC_LOG(LS_WARNING) << "Unsupported media type: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002740 continue;
2741 }
2742 if (!content.get()) {
2743 // ParseContentDescription returns NULL if failed.
2744 return false;
2745 }
2746
Steve Antone831b8c2018-02-01 12:22:16 -08002747 msid_signaling |= section_msid_signaling;
2748
deadbeef25ed4352016-12-12 18:37:36 -08002749 bool content_rejected = false;
deadbeef12771a12017-01-03 13:53:47 -08002750 // A port of 0 is not interpreted as a rejected m= section when it's
2751 // used along with a=bundle-only.
deadbeef25ed4352016-12-12 18:37:36 -08002752 if (bundle_only) {
deadbeef25ed4352016-12-12 18:37:36 -08002753 if (!port_rejected) {
deadbeef12771a12017-01-03 13:53:47 -08002754 // Usage of bundle-only with a nonzero port is unspecified. So just
2755 // ignore bundle-only if we see this.
2756 bundle_only = false;
Mirko Bonadei675513b2017-11-09 11:09:25 +01002757 RTC_LOG(LS_WARNING)
deadbeef12771a12017-01-03 13:53:47 -08002758 << "a=bundle-only attribute observed with a nonzero "
Jonas Olsson45cc8902018-02-13 10:37:07 +01002759 "port; this usage is unspecified so the attribute is being "
2760 "ignored.";
deadbeef25ed4352016-12-12 18:37:36 -08002761 }
2762 } else {
2763 // If not using bundle-only, interpret port 0 in the normal way; the m=
2764 // section is being rejected.
2765 content_rejected = port_rejected;
2766 }
2767
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002768 if (cricket::IsRtpProtocol(protocol) && !content->as_sctp()) {
2769 content->set_protocol(protocol);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002770 // Set the extmap.
2771 if (!session_extmaps.empty() &&
2772 !content->rtp_header_extensions().empty()) {
2773 return ParseFailed("",
2774 "The a=extmap MUST be either all session level or "
2775 "all media level.",
2776 error);
2777 }
2778 for (size_t i = 0; i < session_extmaps.size(); ++i) {
2779 content->AddRtpHeaderExtension(session_extmaps[i]);
2780 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002781 } else if (content->as_sctp()) {
2782 // Do nothing, it's OK
2783 } else {
2784 RTC_LOG(LS_WARNING) << "Parse failed with unknown protocol " << protocol;
2785 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002786 }
zhihuang38989e52017-03-21 11:04:53 -07002787
2788 // Use the session level connection address if the media level addresses are
2789 // not specified.
2790 rtc::SocketAddress address;
2791 address = content->connection_address().IsNil()
2792 ? session_connection_addr
2793 : content->connection_address();
2794 address.SetPort(port);
2795 content->set_connection_address(address);
2796
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002797 desc->AddContent(content_name,
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002798 cricket::IsDtlsSctp(protocol) ? MediaProtocolType::kSctp
2799 : MediaProtocolType::kRtp,
deadbeef25ed4352016-12-12 18:37:36 -08002800 content_rejected, bundle_only, content.release());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002801 // Create TransportInfo with the media level "ice-pwd" and "ice-ufrag".
Steve Anton06817cd2018-12-18 15:55:30 -08002802 desc->AddTransportInfo(TransportInfo(content_name, transport));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002803 }
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002804
Steve Antone831b8c2018-02-01 12:22:16 -08002805 desc->set_msid_signaling(msid_signaling);
2806
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002807 size_t end_of_message = message.size();
2808 if (mline_index == -1 && *pos != end_of_message) {
2809 ParseFailed(message, *pos, "Expects m line.", error);
2810 return false;
2811 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002812 return true;
2813}
2814
2815bool VerifyCodec(const cricket::Codec& codec) {
2816 // Codec has not been populated correctly unless the name has been set. This
2817 // can happen if an SDP has an fmtp or rtcp-fb with a payload type but doesn't
2818 // have a corresponding "rtpmap" line.
htab39db842016-12-08 01:50:48 -08002819 return !codec.name.empty();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002820}
2821
2822bool VerifyAudioCodecs(const AudioContentDescription* audio_desc) {
Steve Anton64b626b2019-01-28 17:25:26 -08002823 return absl::c_all_of(audio_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002824}
2825
2826bool VerifyVideoCodecs(const VideoContentDescription* video_desc) {
Steve Anton64b626b2019-01-28 17:25:26 -08002827 return absl::c_all_of(video_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002828}
2829
2830void AddParameters(const cricket::CodecParameterMap& parameters,
2831 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002832 for (const auto& entry : parameters) {
2833 const std::string& key = entry.first;
2834 const std::string& value = entry.second;
2835 codec->SetParam(key, value);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002836 }
2837}
2838
2839void AddFeedbackParameter(const cricket::FeedbackParam& feedback_param,
2840 cricket::Codec* codec) {
2841 codec->AddFeedbackParam(feedback_param);
2842}
2843
2844void AddFeedbackParameters(const cricket::FeedbackParams& feedback_params,
2845 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002846 for (const cricket::FeedbackParam& param : feedback_params.params()) {
2847 codec->AddFeedbackParam(param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002848 }
2849}
2850
2851// Gets the current codec setting associated with |payload_type|. If there
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002852// is no Codec associated with that payload type it returns an empty codec
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002853// with that payload type.
2854template <class T>
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002855T GetCodecWithPayloadType(const std::vector<T>& codecs, int payload_type) {
magjedb05fa242016-11-11 04:00:16 -08002856 const T* codec = FindCodecById(codecs, payload_type);
2857 if (codec)
2858 return *codec;
2859 // Return empty codec with |payload_type|.
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002860 T ret_val;
magjedb05fa242016-11-11 04:00:16 -08002861 ret_val.id = payload_type;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002862 return ret_val;
2863}
2864
2865// Updates or creates a new codec entry in the audio description.
2866template <class T, class U>
2867void AddOrReplaceCodec(MediaContentDescription* content_desc, const U& codec) {
2868 T* desc = static_cast<T*>(content_desc);
2869 std::vector<U> codecs = desc->codecs();
2870 bool found = false;
Steve Anton4daf66e2018-09-07 14:55:53 -07002871 for (U& existing_codec : codecs) {
2872 if (codec.id == existing_codec.id) {
2873 // Overwrite existing codec with the new codec.
2874 existing_codec = codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002875 found = true;
2876 break;
2877 }
2878 }
2879 if (!found) {
2880 desc->AddCodec(codec);
2881 return;
2882 }
2883 desc->set_codecs(codecs);
2884}
2885
2886// Adds or updates existing codec corresponding to |payload_type| according
2887// to |parameters|.
2888template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002889void UpdateCodec(MediaContentDescription* content_desc,
2890 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002891 const cricket::CodecParameterMap& parameters) {
2892 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002893 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2894 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002895 AddParameters(parameters, &new_codec);
2896 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2897}
2898
2899// Adds or updates existing codec corresponding to |payload_type| according
2900// to |feedback_param|.
2901template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002902void UpdateCodec(MediaContentDescription* content_desc,
2903 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002904 const cricket::FeedbackParam& feedback_param) {
2905 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002906 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2907 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002908 AddFeedbackParameter(feedback_param, &new_codec);
2909 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2910}
2911
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002912template <class T>
2913bool PopWildcardCodec(std::vector<T>* codecs, T* wildcard_codec) {
2914 for (auto iter = codecs->begin(); iter != codecs->end(); ++iter) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002915 if (iter->id == kWildcardPayloadType) {
2916 *wildcard_codec = *iter;
2917 codecs->erase(iter);
2918 return true;
2919 }
2920 }
2921 return false;
2922}
2923
Yves Gerey665174f2018-06-19 15:03:05 +02002924template <class T>
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002925void UpdateFromWildcardCodecs(cricket::MediaContentDescriptionImpl<T>* desc) {
2926 auto codecs = desc->codecs();
2927 T wildcard_codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002928 if (!PopWildcardCodec(&codecs, &wildcard_codec)) {
2929 return;
2930 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002931 for (auto& codec : codecs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002932 AddFeedbackParameters(wildcard_codec.feedback_params, &codec);
2933 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002934 desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002935}
2936
Yves Gerey665174f2018-06-19 15:03:05 +02002937void AddAudioAttribute(const std::string& name,
2938 const std::string& value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002939 AudioContentDescription* audio_desc) {
2940 if (value.empty()) {
2941 return;
2942 }
2943 std::vector<cricket::AudioCodec> codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002944 for (cricket::AudioCodec& codec : codecs) {
2945 codec.params[name] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002946 }
2947 audio_desc->set_codecs(codecs);
2948}
2949
2950bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002951 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002952 int mline_index,
2953 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002954 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002955 size_t* pos,
2956 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002957 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002958 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002959 MediaContentDescription* media_desc,
2960 TransportDescription* transport,
Steve Anton5a1de872018-12-18 11:25:55 -08002961 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002962 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002963 RTC_DCHECK(media_desc != NULL);
2964 RTC_DCHECK(content_name != NULL);
2965 RTC_DCHECK(transport != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002966
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002967 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002968 MaybeCreateStaticPayloadAudioCodecs(payload_types, media_desc->as_audio());
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002969 }
2970
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002971 // The media level "ice-ufrag" and "ice-pwd".
2972 // The candidates before update the media level "ice-pwd" and "ice-ufrag".
2973 Candidates candidates_orig;
2974 std::string line;
2975 std::string mline_id;
2976 // Tracks created out of the ssrc attributes.
2977 StreamParamsVec tracks;
2978 SsrcInfoVec ssrc_infos;
2979 SsrcGroupVec ssrc_groups;
2980 std::string maxptime_as_string;
2981 std::string ptime_as_string;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002982 std::vector<std::string> stream_ids;
deadbeef9d3584c2016-02-16 17:54:10 -08002983 std::string track_id;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002984 SdpSerializer deserializer;
2985 std::vector<RidDescription> rids;
Amit Hilbucha2012042018-12-03 11:35:05 -08002986 SimulcastDescription simulcast;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002987
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002988 // Loop until the next m line
2989 while (!IsLineType(message, kLineTypeMedia, *pos)) {
2990 if (!GetLine(message, pos, &line)) {
2991 if (*pos >= message.size()) {
2992 break; // Done parsing
2993 } else {
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +00002994 return ParseFailed(message, *pos, "Invalid SDP line.", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002995 }
2996 }
2997
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002998 // RFC 4566
2999 // b=* (zero or more bandwidth information lines)
3000 if (IsLineType(line, kLineTypeSessionBandwidth)) {
3001 std::string bandwidth;
3002 if (HasAttribute(line, kApplicationSpecificMaximum)) {
3003 if (!GetValue(line, kApplicationSpecificMaximum, &bandwidth, error)) {
3004 return false;
3005 } else {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003006 int b = 0;
3007 if (!GetValueFromString(line, bandwidth, &b, error)) {
3008 return false;
3009 }
deadbeef3e8016e2017-08-03 17:49:30 -07003010 // TODO(deadbeef): Historically, applications may be setting a value
3011 // of -1 to mean "unset any previously set bandwidth limit", even
3012 // though ommitting the "b=AS" entirely will do just that. Once we've
3013 // transitioned applications to doing the right thing, it would be
3014 // better to treat this as a hard error instead of just ignoring it.
3015 if (b == -1) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003016 RTC_LOG(LS_WARNING)
3017 << "Ignoring \"b=AS:-1\"; will be treated as \"no "
3018 "bandwidth limit\".";
deadbeef3e8016e2017-08-03 17:49:30 -07003019 continue;
3020 }
deadbeefbc88c6b2017-08-02 11:26:34 -07003021 if (b < 0) {
3022 return ParseFailed(line, "b=AS value can't be negative.", error);
3023 }
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003024 // We should never use more than the default bandwidth for RTP-based
3025 // data channels. Don't allow SDP to set the bandwidth, because
3026 // that would give JS the opportunity to "break the Internet".
3027 // See: https://code.google.com/p/chromium/issues/detail?id=280726
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003028 if (media_type == cricket::MEDIA_TYPE_DATA &&
3029 cricket::IsRtpProtocol(protocol) &&
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003030 b > cricket::kDataMaxBandwidth / 1000) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003031 rtc::StringBuilder description;
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003032 description << "RTP-based data channels may not send more than "
3033 << cricket::kDataMaxBandwidth / 1000 << "kbps.";
3034 return ParseFailed(line, description.str(), error);
3035 }
deadbeefb2362572016-12-13 16:37:06 -08003036 // Prevent integer overflow.
3037 b = std::min(b, INT_MAX / 1000);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003038 media_desc->set_bandwidth(b * 1000);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003039 }
3040 }
3041 continue;
3042 }
3043
zhihuang38989e52017-03-21 11:04:53 -07003044 // Parse the media level connection data.
3045 if (IsLineType(line, kLineTypeConnection)) {
3046 rtc::SocketAddress addr;
3047 if (!ParseConnectionData(line, &addr, error)) {
3048 return false;
3049 }
3050 media_desc->set_connection_address(addr);
3051 continue;
3052 }
3053
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003054 if (!IsLineType(line, kLineTypeAttributes)) {
Steve Anton36b29d12017-10-30 09:57:42 -07003055 // TODO(deadbeef): Handle other lines if needed.
Mirko Bonadei675513b2017-11-09 11:09:25 +01003056 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003057 continue;
3058 }
3059
3060 // Handle attributes common to SCTP and RTP.
3061 if (HasAttribute(line, kAttributeMid)) {
3062 // RFC 3388
3063 // mid-attribute = "a=mid:" identification-tag
3064 // identification-tag = token
3065 // Use the mid identification-tag as the content name.
3066 if (!GetValue(line, kAttributeMid, &mline_id, error)) {
3067 return false;
3068 }
3069 *content_name = mline_id;
deadbeef25ed4352016-12-12 18:37:36 -08003070 } else if (HasAttribute(line, kAttributeBundleOnly)) {
3071 *bundle_only = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003072 } else if (HasAttribute(line, kAttributeCandidate)) {
3073 Candidate candidate;
3074 if (!ParseCandidate(line, &candidate, error, false)) {
3075 return false;
3076 }
deadbeef7bcdb692017-01-20 12:43:58 -08003077 // ParseCandidate will parse non-standard ufrag and password attributes,
3078 // since it's used for candidate trickling, but we only want to process
3079 // the "a=ice-ufrag"/"a=ice-pwd" values in a session description, so
3080 // strip them off at this point.
3081 candidate.set_username(std::string());
3082 candidate.set_password(std::string());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003083 candidates_orig.push_back(candidate);
3084 } else if (HasAttribute(line, kAttributeIceUfrag)) {
3085 if (!GetValue(line, kAttributeIceUfrag, &transport->ice_ufrag, error)) {
3086 return false;
3087 }
3088 } else if (HasAttribute(line, kAttributeIcePwd)) {
3089 if (!GetValue(line, kAttributeIcePwd, &transport->ice_pwd, error)) {
3090 return false;
3091 }
3092 } else if (HasAttribute(line, kAttributeIceOption)) {
3093 if (!ParseIceOptions(line, &transport->transport_options, error)) {
3094 return false;
3095 }
3096 } else if (HasAttribute(line, kAttributeFmtp)) {
3097 if (!ParseFmtpAttributes(line, media_type, media_desc, error)) {
3098 return false;
3099 }
3100 } else if (HasAttribute(line, kAttributeFingerprint)) {
Steve Anton4905edb2018-10-15 19:27:44 -07003101 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003102 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
3103 return false;
3104 }
Steve Anton4905edb2018-10-15 19:27:44 -07003105 transport->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00003106 } else if (HasAttribute(line, kAttributeSetup)) {
3107 if (!ParseDtlsSetup(line, &(transport->connection_role), error)) {
3108 return false;
3109 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003110 } else if (cricket::IsDtlsSctp(protocol) &&
3111 HasAttribute(line, kAttributeSctpPort)) {
deadbeef7e146cb2016-09-28 10:04:34 -07003112 if (media_type != cricket::MEDIA_TYPE_DATA) {
3113 return ParseFailed(
3114 line, "sctp-port attribute found in non-data media description.",
3115 error);
3116 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003117 if (media_desc->as_sctp()->use_sctpmap()) {
3118 return ParseFailed(
3119 line, "sctp-port attribute can't be used with sctpmap.", error);
3120 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00003121 int sctp_port;
3122 if (!ParseSctpPort(line, &sctp_port, error)) {
3123 return false;
3124 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003125 media_desc->as_sctp()->set_port(sctp_port);
3126 } else if (cricket::IsDtlsSctp(protocol) &&
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02003127 HasAttribute(line, kAttributeMaxMessageSize)) {
3128 if (media_type != cricket::MEDIA_TYPE_DATA) {
3129 return ParseFailed(
3130 line,
3131 "max-message-size attribute found in non-data media description.",
3132 error);
3133 }
3134 int max_message_size;
3135 if (!ParseSctpMaxMessageSize(line, &max_message_size, error)) {
3136 return false;
3137 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003138 media_desc->as_sctp()->set_max_message_size(max_message_size);
3139 } else if (cricket::IsRtpProtocol(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003140 //
3141 // RTP specific attrubtes
3142 //
3143 if (HasAttribute(line, kAttributeRtcpMux)) {
3144 media_desc->set_rtcp_mux(true);
deadbeef13871492015-12-09 12:37:51 -08003145 } else if (HasAttribute(line, kAttributeRtcpReducedSize)) {
3146 media_desc->set_rtcp_reduced_size(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003147 } else if (HasAttribute(line, kAttributeSsrcGroup)) {
3148 if (!ParseSsrcGroupAttribute(line, &ssrc_groups, error)) {
3149 return false;
3150 }
3151 } else if (HasAttribute(line, kAttributeSsrc)) {
Steve Antone831b8c2018-02-01 12:22:16 -08003152 if (!ParseSsrcAttribute(line, &ssrc_infos, msid_signaling, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003153 return false;
3154 }
3155 } else if (HasAttribute(line, kAttributeCrypto)) {
3156 if (!ParseCryptoAttribute(line, media_desc, error)) {
3157 return false;
3158 }
3159 } else if (HasAttribute(line, kAttributeRtpmap)) {
deadbeef67cf2c12016-04-13 10:07:16 -07003160 if (!ParseRtpmapAttribute(line, media_type, payload_types, media_desc,
3161 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003162 return false;
3163 }
3164 } else if (HasAttribute(line, kCodecParamMaxPTime)) {
3165 if (!GetValue(line, kCodecParamMaxPTime, &maxptime_as_string, error)) {
3166 return false;
3167 }
3168 } else if (HasAttribute(line, kAttributeRtcpFb)) {
3169 if (!ParseRtcpFbAttribute(line, media_type, media_desc, error)) {
3170 return false;
3171 }
3172 } else if (HasAttribute(line, kCodecParamPTime)) {
3173 if (!GetValue(line, kCodecParamPTime, &ptime_as_string, error)) {
3174 return false;
3175 }
3176 } else if (HasAttribute(line, kAttributeSendOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003177 media_desc->set_direction(RtpTransceiverDirection::kSendOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003178 } else if (HasAttribute(line, kAttributeRecvOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003179 media_desc->set_direction(RtpTransceiverDirection::kRecvOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003180 } else if (HasAttribute(line, kAttributeInactive)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003181 media_desc->set_direction(RtpTransceiverDirection::kInactive);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003182 } else if (HasAttribute(line, kAttributeSendRecv)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003183 media_desc->set_direction(RtpTransceiverDirection::kSendRecv);
Johannes Kron0854eb62018-10-10 22:33:20 +02003184 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02003185 media_desc->set_extmap_allow_mixed_enum(
Johannes Kron0854eb62018-10-10 22:33:20 +02003186 MediaContentDescription::kMedia);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003187 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07003188 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003189 if (!ParseExtmap(line, &extmap, error)) {
3190 return false;
3191 }
3192 media_desc->AddRtpHeaderExtension(extmap);
3193 } else if (HasAttribute(line, kAttributeXGoogleFlag)) {
3194 // Experimental attribute. Conference mode activates more aggressive
3195 // AEC and NS settings.
Steve Anton36b29d12017-10-30 09:57:42 -07003196 // TODO(deadbeef): expose API to set these directly.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003197 std::string flag_value;
3198 if (!GetValue(line, kAttributeXGoogleFlag, &flag_value, error)) {
3199 return false;
3200 }
3201 if (flag_value.compare(kValueConference) == 0)
3202 media_desc->set_conference_mode(true);
deadbeef9d3584c2016-02-16 17:54:10 -08003203 } else if (HasAttribute(line, kAttributeMsid)) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07003204 if (!ParseMsidAttribute(line, &stream_ids, &track_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08003205 return false;
3206 }
Steve Antone831b8c2018-02-01 12:22:16 -08003207 *msid_signaling |= cricket::kMsidSignalingMediaSection;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003208 } else if (HasAttribute(line, kAttributeRid)) {
3209 const size_t kRidPrefixLength =
3210 kLinePrefixLength + arraysize(kAttributeRid);
3211 if (line.size() <= kRidPrefixLength) {
3212 RTC_LOG(LS_INFO) << "Ignoring empty RID attribute: " << line;
3213 continue;
3214 }
3215 RTCErrorOr<RidDescription> error_or_rid_description =
3216 deserializer.DeserializeRidDescription(
3217 line.substr(kRidPrefixLength));
3218
3219 // Malformed a=rid lines are discarded.
3220 if (!error_or_rid_description.ok()) {
3221 RTC_LOG(LS_INFO) << "Ignoring malformed RID line: '" << line
3222 << "'. Error: "
3223 << error_or_rid_description.error().message();
3224 continue;
3225 }
3226
3227 rids.push_back(error_or_rid_description.MoveValue());
Amit Hilbucha2012042018-12-03 11:35:05 -08003228 } else if (HasAttribute(line, kAttributeSimulcast)) {
3229 const size_t kSimulcastPrefixLength =
3230 kLinePrefixLength + arraysize(kAttributeSimulcast);
3231 if (line.size() <= kSimulcastPrefixLength) {
3232 return ParseFailed(line, "Simulcast attribute is empty.", error);
3233 }
3234
3235 if (!simulcast.empty()) {
3236 return ParseFailed(line, "Multiple Simulcast attributes specified.",
3237 error);
3238 }
3239
Amit Hilbucha2012042018-12-03 11:35:05 -08003240 RTCErrorOr<SimulcastDescription> error_or_simulcast =
3241 deserializer.DeserializeSimulcastDescription(
3242 line.substr(kSimulcastPrefixLength));
3243 if (!error_or_simulcast.ok()) {
3244 return ParseFailed(line,
3245 std::string("Malformed simulcast line: ") +
3246 error_or_simulcast.error().message(),
3247 error);
3248 }
3249
3250 simulcast = error_or_simulcast.value();
3251 } else {
3252 // Unrecognized attribute in RTP protocol.
3253 RTC_LOG(LS_INFO) << "Ignored line: " << line;
3254 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003255 }
3256 } else {
3257 // Only parse lines that we are interested of.
Mirko Bonadei675513b2017-11-09 11:09:25 +01003258 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003259 continue;
3260 }
3261 }
3262
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003263 // Remove duplicate or inconsistent rids.
3264 RemoveInvalidRidDescriptions(payload_types, &rids);
3265
3266 // If simulcast is specifed, split the rids into send and receive.
3267 // Rids that do not appear in simulcast attribute will be removed.
3268 // If it is not specified, we assume that all rids are for send layers.
Amit Hilbuchb7446ed2019-01-28 12:25:25 -08003269 std::vector<RidDescription> send_rids;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003270 if (!simulcast.empty()) {
3271 // Verify that the rids in simulcast match rids in sdp.
3272 RemoveInvalidRidsFromSimulcast(rids, &simulcast);
3273
3274 // Use simulcast description to figure out Send / Receive RIDs.
3275 std::map<std::string, RidDescription> rid_map;
3276 for (const RidDescription& rid : rids) {
3277 rid_map[rid.rid] = rid;
3278 }
3279
3280 for (const auto& layer : simulcast.send_layers().GetAllLayers()) {
3281 auto iter = rid_map.find(layer.rid);
3282 RTC_DCHECK(iter != rid_map.end());
3283 send_rids.push_back(iter->second);
3284 }
3285
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003286 media_desc->set_simulcast_description(simulcast);
3287 } else {
3288 send_rids = rids;
3289 }
3290
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003291 // Create tracks from the |ssrc_infos|.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -08003292 // If the stream_id/track_id for all SSRCS are identical, one StreamParams
3293 // will be created in CreateTracksFromSsrcInfos, containing all the SSRCs from
3294 // the m= section.
Seth Hampson5897a6e2018-04-03 11:16:33 -07003295 if (!ssrc_infos.empty()) {
3296 CreateTracksFromSsrcInfos(ssrc_infos, stream_ids, track_id, &tracks,
3297 *msid_signaling);
3298 } else if (media_type != cricket::MEDIA_TYPE_DATA &&
3299 (*msid_signaling & cricket::kMsidSignalingMediaSection)) {
3300 // If the stream_ids/track_id was signaled but SSRCs were unsignaled we
3301 // still create a track. This isn't done for data media types because
3302 // StreamParams aren't used for SCTP streams, and RTP data channels don't
3303 // support unsignaled SSRCs.
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003304 CreateTrackWithNoSsrcs(stream_ids, track_id, send_rids, &tracks);
3305 }
3306
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003307 // Add the ssrc group to the track.
Steve Anton4daf66e2018-09-07 14:55:53 -07003308 for (const SsrcGroup& ssrc_group : ssrc_groups) {
3309 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003310 continue;
3311 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003312 uint32_t ssrc = ssrc_group.ssrcs.front();
3313 for (StreamParams& track : tracks) {
3314 if (track.has_ssrc(ssrc)) {
3315 track.ssrc_groups.push_back(ssrc_group);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003316 }
3317 }
3318 }
3319
3320 // Add the new tracks to the |media_desc|.
deadbeef9d3584c2016-02-16 17:54:10 -08003321 for (StreamParams& track : tracks) {
3322 media_desc->AddStream(track);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003323 }
3324
3325 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003326 AudioContentDescription* audio_desc = media_desc->as_audio();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003327 UpdateFromWildcardCodecs(audio_desc);
3328
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003329 // Verify audio codec ensures that no audio codec has been populated with
3330 // only fmtp.
3331 if (!VerifyAudioCodecs(audio_desc)) {
3332 return ParseFailed("Failed to parse audio codecs correctly.", error);
3333 }
3334 AddAudioAttribute(kCodecParamMaxPTime, maxptime_as_string, audio_desc);
3335 AddAudioAttribute(kCodecParamPTime, ptime_as_string, audio_desc);
3336 }
3337
3338 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003339 VideoContentDescription* video_desc = media_desc->as_video();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003340 UpdateFromWildcardCodecs(video_desc);
3341 // Verify video codec ensures that no video codec has been populated with
3342 // only rtcp-fb.
3343 if (!VerifyVideoCodecs(video_desc)) {
3344 return ParseFailed("Failed to parse video codecs correctly.", error);
3345 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003346 }
3347
3348 // RFC 5245
3349 // Update the candidates with the media level "ice-pwd" and "ice-ufrag".
Steve Anton4daf66e2018-09-07 14:55:53 -07003350 for (Candidate& candidate : candidates_orig) {
3351 RTC_DCHECK(candidate.username().empty() ||
3352 candidate.username() == transport->ice_ufrag);
3353 candidate.set_username(transport->ice_ufrag);
3354 RTC_DCHECK(candidate.password().empty());
3355 candidate.set_password(transport->ice_pwd);
3356 candidates->push_back(
Steve Anton5a1de872018-12-18 11:25:55 -08003357 absl::make_unique<JsepIceCandidate>(mline_id, mline_index, candidate));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003358 }
Amit Hilbucha2012042018-12-03 11:35:05 -08003359
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003360 return true;
3361}
3362
Steve Antone831b8c2018-02-01 12:22:16 -08003363bool ParseSsrcAttribute(const std::string& line,
3364 SsrcInfoVec* ssrc_infos,
3365 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003366 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003367 RTC_DCHECK(ssrc_infos != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003368 // RFC 5576
3369 // a=ssrc:<ssrc-id> <attribute>
3370 // a=ssrc:<ssrc-id> <attribute>:<value>
3371 std::string field1, field2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003372 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3373 kSdpDelimiterSpaceChar, &field1, &field2)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003374 const size_t expected_fields = 2;
3375 return ParseFailedExpectFieldNum(line, expected_fields, error);
3376 }
3377
3378 // ssrc:<ssrc-id>
3379 std::string ssrc_id_s;
3380 if (!GetValue(field1, kAttributeSsrc, &ssrc_id_s, error)) {
3381 return false;
3382 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003383 uint32_t ssrc_id = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003384 if (!GetValueFromString(line, ssrc_id_s, &ssrc_id, error)) {
3385 return false;
3386 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003387
3388 std::string attribute;
3389 std::string value;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003390 if (!rtc::tokenize_first(field2, kSdpDelimiterColonChar, &attribute,
3391 &value)) {
3392 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003393 description << "Failed to get the ssrc attribute value from " << field2
3394 << ". Expected format <attribute>:<value>.";
3395 return ParseFailed(line, description.str(), error);
3396 }
3397
3398 // Check if there's already an item for this |ssrc_id|. Create a new one if
3399 // there isn't.
Steve Anton64b626b2019-01-28 17:25:26 -08003400 auto ssrc_info_it =
3401 absl::c_find_if(*ssrc_infos, [ssrc_id](const SsrcInfo& ssrc_info) {
3402 return ssrc_info.ssrc_id == ssrc_id;
3403 });
Steve Anton4daf66e2018-09-07 14:55:53 -07003404 if (ssrc_info_it == ssrc_infos->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003405 SsrcInfo info;
3406 info.ssrc_id = ssrc_id;
3407 ssrc_infos->push_back(info);
Steve Anton4daf66e2018-09-07 14:55:53 -07003408 ssrc_info_it = ssrc_infos->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003409 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003410 SsrcInfo& ssrc_info = *ssrc_info_it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003411
3412 // Store the info to the |ssrc_info|.
3413 if (attribute == kSsrcAttributeCname) {
3414 // RFC 5576
3415 // cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003416 ssrc_info.cname = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003417 } else if (attribute == kSsrcAttributeMsid) {
3418 // draft-alvestrand-mmusic-msid-00
Seth Hampson5b4f0752018-04-02 16:31:36 -07003419 // msid:identifier [appdata]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003420 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003421 rtc::split(value, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003422 if (fields.size() < 1 || fields.size() > 2) {
Yves Gerey665174f2018-06-19 15:03:05 +02003423 return ParseFailed(
3424 line, "Expected format \"msid:<identifier>[ <appdata>]\".", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003425 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003426 ssrc_info.stream_id = fields[0];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003427 if (fields.size() == 2) {
Steve Anton4daf66e2018-09-07 14:55:53 -07003428 ssrc_info.track_id = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003429 }
Steve Antone831b8c2018-02-01 12:22:16 -08003430 *msid_signaling |= cricket::kMsidSignalingSsrcAttribute;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003431 } else if (attribute == kSsrcAttributeMslabel) {
3432 // draft-alvestrand-rtcweb-mid-01
3433 // mslabel:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003434 ssrc_info.mslabel = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003435 } else if (attribute == kSSrcAttributeLabel) {
3436 // The label isn't defined.
3437 // label:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003438 ssrc_info.label = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003439 }
3440 return true;
3441}
3442
3443bool ParseSsrcGroupAttribute(const std::string& line,
3444 SsrcGroupVec* ssrc_groups,
3445 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003446 RTC_DCHECK(ssrc_groups != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003447 // RFC 5576
3448 // a=ssrc-group:<semantics> <ssrc-id> ...
3449 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003450 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003451 const size_t expected_min_fields = 2;
3452 if (fields.size() < expected_min_fields) {
3453 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3454 }
3455 std::string semantics;
3456 if (!GetValue(fields[0], kAttributeSsrcGroup, &semantics, error)) {
3457 return false;
3458 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003459 std::vector<uint32_t> ssrcs;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003460 for (size_t i = 1; i < fields.size(); ++i) {
Peter Boström0c4e06b2015-10-07 12:23:21 +02003461 uint32_t ssrc = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003462 if (!GetValueFromString(line, fields[i], &ssrc, error)) {
3463 return false;
3464 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003465 ssrcs.push_back(ssrc);
3466 }
3467 ssrc_groups->push_back(SsrcGroup(semantics, ssrcs));
3468 return true;
3469}
3470
3471bool ParseCryptoAttribute(const std::string& line,
3472 MediaContentDescription* media_desc,
3473 SdpParseError* error) {
3474 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003475 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003476 // RFC 4568
3477 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
3478 const size_t expected_min_fields = 3;
3479 if (fields.size() < expected_min_fields) {
3480 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3481 }
3482 std::string tag_value;
3483 if (!GetValue(fields[0], kAttributeCrypto, &tag_value, error)) {
3484 return false;
3485 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003486 int tag = 0;
3487 if (!GetValueFromString(line, tag_value, &tag, error)) {
3488 return false;
3489 }
jbauch083b73f2015-07-16 02:46:32 -07003490 const std::string& crypto_suite = fields[1];
3491 const std::string& key_params = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003492 std::string session_params;
3493 if (fields.size() > 3) {
3494 session_params = fields[3];
3495 }
Yves Gerey665174f2018-06-19 15:03:05 +02003496 media_desc->AddCrypto(
3497 CryptoParams(tag, crypto_suite, key_params, session_params));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003498 return true;
3499}
3500
3501// Updates or creates a new codec entry in the audio description with according
deadbeef67cf2c12016-04-13 10:07:16 -07003502// to |name|, |clockrate|, |bitrate|, and |channels|.
3503void UpdateCodec(int payload_type,
3504 const std::string& name,
3505 int clockrate,
3506 int bitrate,
3507 size_t channels,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003508 AudioContentDescription* audio_desc) {
3509 // Codec may already be populated with (only) optional parameters
3510 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003511 cricket::AudioCodec codec =
3512 GetCodecWithPayloadType(audio_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003513 codec.name = name;
3514 codec.clockrate = clockrate;
3515 codec.bitrate = bitrate;
3516 codec.channels = channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003517 AddOrReplaceCodec<AudioContentDescription, cricket::AudioCodec>(audio_desc,
3518 codec);
3519}
3520
3521// Updates or creates a new codec entry in the video description according to
deadbeef67cf2c12016-04-13 10:07:16 -07003522// |name|, |width|, |height|, and |framerate|.
3523void UpdateCodec(int payload_type,
3524 const std::string& name,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003525 VideoContentDescription* video_desc) {
3526 // Codec may already be populated with (only) optional parameters
3527 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003528 cricket::VideoCodec codec =
3529 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003530 codec.name = name;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003531 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
3532 codec);
3533}
3534
3535bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003536 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -07003537 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003538 MediaContentDescription* media_desc,
3539 SdpParseError* error) {
3540 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003541 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003542 // RFC 4566
3543 // a=rtpmap:<payload type> <encoding name>/<clock rate>[/<encodingparameters>]
3544 const size_t expected_min_fields = 2;
3545 if (fields.size() < expected_min_fields) {
3546 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3547 }
3548 std::string payload_type_value;
3549 if (!GetValue(fields[0], kAttributeRtpmap, &payload_type_value, error)) {
3550 return false;
3551 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003552 int payload_type = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003553 if (!GetPayloadTypeFromString(line, payload_type_value, &payload_type,
3554 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003555 return false;
3556 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003557
Steve Anton64b626b2019-01-28 17:25:26 -08003558 if (!absl::c_linear_search(payload_types, payload_type)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003559 RTC_LOG(LS_WARNING) << "Ignore rtpmap line that did not appear in the "
Jonas Olsson45cc8902018-02-13 10:37:07 +01003560 "<fmt> of the m-line: "
3561 << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003562 return true;
3563 }
jbauch083b73f2015-07-16 02:46:32 -07003564 const std::string& encoder = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003565 std::vector<std::string> codec_params;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00003566 rtc::split(encoder, '/', &codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003567 // <encoding name>/<clock rate>[/<encodingparameters>]
3568 // 2 mandatory fields
3569 if (codec_params.size() < 2 || codec_params.size() > 3) {
3570 return ParseFailed(line,
3571 "Expected format \"<encoding name>/<clock rate>"
3572 "[/<encodingparameters>]\".",
3573 error);
3574 }
jbauch083b73f2015-07-16 02:46:32 -07003575 const std::string& encoding_name = codec_params[0];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003576 int clock_rate = 0;
3577 if (!GetValueFromString(line, codec_params[1], &clock_rate, error)) {
3578 return false;
3579 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003580 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003581 VideoContentDescription* video_desc = media_desc->as_video();
Yves Gerey665174f2018-06-19 15:03:05 +02003582 UpdateCodec(payload_type, encoding_name, video_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003583 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3584 // RFC 4566
3585 // For audio streams, <encoding parameters> indicates the number
3586 // of audio channels. This parameter is OPTIONAL and may be
3587 // omitted if the number of channels is one, provided that no
3588 // additional parameters are needed.
Peter Kasting69558702016-01-12 16:26:35 -08003589 size_t channels = 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003590 if (codec_params.size() == 3) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003591 if (!GetValueFromString(line, codec_params[2], &channels, error)) {
3592 return false;
3593 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003594 }
Steve Antonb1c1de12017-12-21 15:14:30 -08003595 AudioContentDescription* audio_desc = media_desc->as_audio();
ossue1405ad2017-01-23 08:55:48 -08003596 UpdateCodec(payload_type, encoding_name, clock_rate, 0, channels,
deadbeef67cf2c12016-04-13 10:07:16 -07003597 audio_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003598 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003599 RtpDataContentDescription* data_desc = media_desc->as_rtp_data();
3600 if (data_desc) {
3601 data_desc->AddCodec(cricket::RtpDataCodec(payload_type, encoding_name));
3602 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003603 }
3604 return true;
3605}
3606
Yves Gerey665174f2018-06-19 15:03:05 +02003607bool ParseFmtpParam(const std::string& line,
3608 std::string* parameter,
3609 std::string* value,
3610 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003611 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, parameter, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003612 ParseFailed(line, "Unable to parse fmtp parameter. \'=\' missing.", error);
3613 return false;
3614 }
3615 // a=fmtp:<payload_type> <param1>=<value1>; <param2>=<value2>; ...
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003616 return true;
3617}
3618
Yves Gerey665174f2018-06-19 15:03:05 +02003619bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003620 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003621 MediaContentDescription* media_desc,
3622 SdpParseError* error) {
3623 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3624 media_type != cricket::MEDIA_TYPE_VIDEO) {
3625 return true;
3626 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003627
3628 std::string line_payload;
3629 std::string line_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003630
3631 // RFC 5576
3632 // a=fmtp:<format> <format specific parameters>
3633 // At least two fields, whereas the second one is any of the optional
3634 // parameters.
Jonas Olssonec9e4922018-09-05 09:53:49 +02003635 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3636 kSdpDelimiterSpaceChar, &line_payload,
3637 &line_params)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003638 ParseFailedExpectMinFieldNum(line, 2, error);
3639 return false;
3640 }
3641
Donald Curtis0e07f922015-05-15 09:21:23 -07003642 // Parse out the payload information.
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003643 std::string payload_type_str;
Donald Curtis0e07f922015-05-15 09:21:23 -07003644 if (!GetValue(line_payload, kAttributeFmtp, &payload_type_str, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003645 return false;
3646 }
3647
Donald Curtis0e07f922015-05-15 09:21:23 -07003648 int payload_type = 0;
Donald Curtis144d0182015-05-15 13:14:24 -07003649 if (!GetPayloadTypeFromString(line_payload, payload_type_str, &payload_type,
3650 error)) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003651 return false;
3652 }
3653
3654 // Parse out format specific parameters.
3655 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003656 rtc::split(line_params, kSdpDelimiterSemicolonChar, &fields);
Donald Curtis0e07f922015-05-15 09:21:23 -07003657
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003658 cricket::CodecParameterMap codec_params;
Donald Curtis144d0182015-05-15 13:14:24 -07003659 for (auto& iter : fields) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003660 if (iter.find(kSdpDelimiterEqual) == std::string::npos) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003661 // Only fmtps with equals are currently supported. Other fmtp types
3662 // should be ignored. Unknown fmtps do not constitute an error.
3663 continue;
3664 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003665
3666 std::string name;
3667 std::string value;
3668 if (!ParseFmtpParam(rtc::string_trim(iter), &name, &value, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003669 return false;
3670 }
3671 codec_params[name] = value;
3672 }
3673
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003674 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3675 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003676 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003677 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
3678 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003679 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003680 }
3681 return true;
3682}
3683
Yves Gerey665174f2018-06-19 15:03:05 +02003684bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003685 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003686 MediaContentDescription* media_desc,
3687 SdpParseError* error) {
3688 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3689 media_type != cricket::MEDIA_TYPE_VIDEO) {
3690 return true;
3691 }
3692 std::vector<std::string> rtcp_fb_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003693 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &rtcp_fb_fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003694 if (rtcp_fb_fields.size() < 2) {
3695 return ParseFailedGetValue(line, kAttributeRtcpFb, error);
3696 }
3697 std::string payload_type_string;
3698 if (!GetValue(rtcp_fb_fields[0], kAttributeRtcpFb, &payload_type_string,
3699 error)) {
3700 return false;
3701 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003702 int payload_type = kWildcardPayloadType;
3703 if (payload_type_string != "*") {
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003704 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3705 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003706 return false;
3707 }
3708 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003709 std::string id = rtcp_fb_fields[1];
3710 std::string param = "";
3711 for (std::vector<std::string>::iterator iter = rtcp_fb_fields.begin() + 2;
3712 iter != rtcp_fb_fields.end(); ++iter) {
3713 param.append(*iter);
3714 }
3715 const cricket::FeedbackParam feedback_param(id, param);
3716
3717 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003718 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
3719 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003720 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003721 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
3722 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003723 }
3724 return true;
3725}
3726
3727} // namespace webrtc