blob: d89bd783902f21c3ae7459936ec2a5e730f21232 [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;
Danil Chapovalovc6d1d242019-04-23 09:48:11 +000057using cricket::ICE_CANDIDATE_COMPONENT_RTCP;
Harald Alvestrand14b27582019-05-04 11:37:04 +020058using cricket::ICE_CANDIDATE_COMPONENT_RTP;
59using cricket::kCodecParamAssociatedPayloadType;
60using cricket::kCodecParamMaxAverageBitrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000061using cricket::kCodecParamMaxBitrate;
Harald Alvestrand14b27582019-05-04 11:37:04 +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 Alvestrand14b27582019-05-04 11:37:04 +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;
Danil Chapovalovc6d1d242019-04-23 09:48:11 +000073using cricket::kCodecParamUseDtx;
Harald Alvestrand14b27582019-05-04 11:37:04 +020074using cricket::kCodecParamUseInbandFec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000075using cricket::MediaContentDescription;
Danil Chapovalovc6d1d242019-04-23 09:48:11 +000076using cricket::MediaProtocolType;
Harald Alvestrand14b27582019-05-04 11:37:04 +020077using cricket::MediaType;
Danil Chapovalovc6d1d242019-04-23 09:48:11 +000078using cricket::RidDescription;
Harald Alvestrand14b27582019-05-04 11:37:04 +020079using cricket::RtpDataContentDescription;
80using cricket::RtpHeaderExtensions;
81using 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";
Amit Hilbucha2012042018-12-03 11:35:05 -0800175// draft-ietf-mmusic-sdp-simulcast-13
176// a=simulcast
177static const char kAttributeSimulcast[] = "simulcast";
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800178// draft-ietf-mmusic-rid-15
179// a=rid
180static const char kAttributeRid[] = "rid";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000181
182// Experimental flags
183static const char kAttributeXGoogleFlag[] = "x-google-flag";
184static const char kValueConference[] = "conference";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000185
186// Candidate
187static const char kCandidateHost[] = "host";
188static const char kCandidateSrflx[] = "srflx";
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700189static const char kCandidatePrflx[] = "prflx";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000190static const char kCandidateRelay[] = "relay";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +0000191static const char kTcpCandidateType[] = "tcptype";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000192
Jonas Olssonec9e4922018-09-05 09:53:49 +0200193// rtc::StringBuilder doesn't have a << overload for chars, while rtc::split and
194// rtc::tokenize_first both take a char delimiter. To handle both cases these
195// constants come in pairs of a chars and length-one strings.
196static const char kSdpDelimiterEqual[] = "=";
197static const char kSdpDelimiterEqualChar = '=';
198static const char kSdpDelimiterSpace[] = " ";
199static const char kSdpDelimiterSpaceChar = ' ';
200static const char kSdpDelimiterColon[] = ":";
201static const char kSdpDelimiterColonChar = ':';
202static const char kSdpDelimiterSemicolon[] = ";";
203static const char kSdpDelimiterSemicolonChar = ';';
204static const char kSdpDelimiterSlashChar = '/';
205static const char kNewLine[] = "\n";
206static const char kNewLineChar = '\n';
207static const char kReturnChar = '\r';
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000208static const char kLineBreak[] = "\r\n";
209
Steve Anton36b29d12017-10-30 09:57:42 -0700210// TODO(deadbeef): Generate the Session and Time description
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000211// instead of hardcoding.
212static const char kSessionVersion[] = "v=0";
213// RFC 4566
214static const char kSessionOriginUsername[] = "-";
215static const char kSessionOriginSessionId[] = "0";
216static const char kSessionOriginSessionVersion[] = "0";
217static const char kSessionOriginNettype[] = "IN";
218static const char kSessionOriginAddrtype[] = "IP4";
219static const char kSessionOriginAddress[] = "127.0.0.1";
220static const char kSessionName[] = "s=-";
221static const char kTimeDescription[] = "t=0 0";
222static const char kAttrGroup[] = "a=group:BUNDLE";
223static const char kConnectionNettype[] = "IN";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000224static const char kConnectionIpv4Addrtype[] = "IP4";
225static const char kConnectionIpv6Addrtype[] = "IP6";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000226static const char kMediaTypeVideo[] = "video";
227static const char kMediaTypeAudio[] = "audio";
228static const char kMediaTypeData[] = "application";
229static const char kMediaPortRejected[] = "0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000230// draft-ietf-mmusic-trickle-ice-01
231// When no candidates have been gathered, set the connection
232// address to IP6 ::.
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000233// TODO(perkj): FF can not parse IP6 ::. See http://crbug/430333
234// Use IPV4 per default.
235static const char kDummyAddress[] = "0.0.0.0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000236static const char kDummyPort[] = "9";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000237// RFC 3556
238static const char kApplicationSpecificMaximum[] = "AS";
239
wu@webrtc.org78187522013-10-07 23:32:02 +0000240static const char kDefaultSctpmapProtocol[] = "webrtc-datachannel";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000241
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -0800242// This is a non-standardized media transport settings.
243// This setting is going to be set in the offer. There may be one or more
244// a=x-mt: settings, and they are in the priority order (the most preferred on
245// top). x-mt setting format depends on the media transport, and is generated by
246// |MediaTransportInterface::GetTransportParametersOffer|.
247static const char kMediaTransportSettingLine[] = "x-mt";
248
pkasting@chromium.orgd3245462015-02-23 21:28:22 +0000249// RTP payload type is in the 0-127 range. Use -1 to indicate "all" payload
250// types.
251const int kWildcardPayloadType = -1;
252
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000253struct SsrcInfo {
Peter Boström0c4e06b2015-10-07 12:23:21 +0200254 uint32_t ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000255 std::string cname;
deadbeef9d3584c2016-02-16 17:54:10 -0800256 std::string stream_id;
257 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000258
259 // For backward compatibility.
260 // TODO(ronghuawu): Remove below 2 fields once all the clients support msid.
261 std::string label;
262 std::string mslabel;
263};
264typedef std::vector<SsrcInfo> SsrcInfoVec;
265typedef std::vector<SsrcGroup> SsrcGroupVec;
266
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000267template <class T>
268static void AddFmtpLine(const T& codec, std::string* message);
269static void BuildMediaDescription(const ContentInfo* content_info,
270 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200271 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000272 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -0800273 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000274 std::string* message);
zstein4b2e0822017-02-17 19:48:38 -0800275static void BuildSctpContentAttributes(std::string* message,
276 int sctp_port,
277 bool use_sctpmap);
deadbeef9d3584c2016-02-16 17:54:10 -0800278static void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200279 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -0800280 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -0800281 std::string* message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000282static void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200283 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000284 std::string* message);
285static void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -0800286 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000287 std::string* message);
288static void BuildIceOptions(const std::vector<std::string>& transport_options,
289 std::string* message);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +0000290static bool IsRtp(const std::string& protocol);
291static bool IsDtlsSctp(const std::string& protocol);
zhihuang38989e52017-03-21 11:04:53 -0700292static bool ParseSessionDescription(const std::string& message,
293 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000294 std::string* session_id,
295 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000296 TransportDescription* session_td,
297 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700298 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000299 cricket::SessionDescription* desc,
300 SdpParseError* error);
301static bool ParseGroupAttribute(const std::string& line,
302 cricket::SessionDescription* desc,
303 SdpParseError* error);
304static bool ParseMediaDescription(
305 const std::string& message,
306 const TransportDescription& session_td,
307 const RtpHeaderExtensions& session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700308 size_t* pos,
309 const rtc::SocketAddress& session_connection_addr,
310 cricket::SessionDescription* desc,
Steve Anton5a1de872018-12-18 11:25:55 -0800311 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000312 SdpParseError* error);
Steve Anton5a1de872018-12-18 11:25:55 -0800313static bool ParseContent(
314 const std::string& message,
315 const cricket::MediaType media_type,
316 int mline_index,
317 const std::string& protocol,
318 const std::vector<int>& payload_types,
319 size_t* pos,
320 std::string* content_name,
321 bool* bundle_only,
322 int* msid_signaling,
323 MediaContentDescription* media_desc,
324 TransportDescription* transport,
325 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
326 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000327static bool ParseSsrcAttribute(const std::string& line,
328 SsrcInfoVec* ssrc_infos,
Steve Antone831b8c2018-02-01 12:22:16 -0800329 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000330 SdpParseError* error);
331static bool ParseSsrcGroupAttribute(const std::string& line,
332 SsrcGroupVec* ssrc_groups,
333 SdpParseError* error);
334static bool ParseCryptoAttribute(const std::string& line,
335 MediaContentDescription* media_desc,
336 SdpParseError* error);
337static bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200338 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -0700339 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000340 MediaContentDescription* media_desc,
341 SdpParseError* error);
342static bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200343 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000344 MediaContentDescription* media_desc,
345 SdpParseError* error);
Yves Gerey665174f2018-06-19 15:03:05 +0200346static bool ParseFmtpParam(const std::string& line,
347 std::string* parameter,
348 std::string* value,
349 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000350static bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200351 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000352 MediaContentDescription* media_desc,
353 SdpParseError* error);
354static bool ParseIceOptions(const std::string& line,
355 std::vector<std::string>* transport_options,
356 SdpParseError* error);
357static bool ParseExtmap(const std::string& line,
isheriff6f8d6862016-05-26 11:24:55 -0700358 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000359 SdpParseError* error);
Steve Anton4905edb2018-10-15 19:27:44 -0700360static bool ParseFingerprintAttribute(
361 const std::string& line,
362 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
363 SdpParseError* error);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000364static bool ParseDtlsSetup(const std::string& line,
365 cricket::ConnectionRole* role,
366 SdpParseError* error);
deadbeef9d3584c2016-02-16 17:54:10 -0800367static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700368 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -0800369 std::string* track_id,
370 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000371
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800372static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
373 std::vector<RidDescription>* rids);
374
375static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
376 const std::set<std::string>& to_remove,
377 const SimulcastLayerList& layers);
378
379static void RemoveInvalidRidsFromSimulcast(
380 const std::vector<RidDescription>& rids,
381 SimulcastDescription* simulcast);
382
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000383// Helper functions
384
385// Below ParseFailed*** functions output the line that caused the parsing
386// failure and the detailed reason (|description|) of the failure to |error|.
387// The functions always return false so that they can be used directly in the
388// following way when error happens:
389// "return ParseFailed***(...);"
390
391// The line starting at |line_start| of |message| is the failing line.
392// The reason for the failure should be provided in the |description|.
393// An example of a description could be "unknown character".
394static bool ParseFailed(const std::string& message,
395 size_t line_start,
396 const std::string& description,
397 SdpParseError* error) {
398 // Get the first line of |message| from |line_start|.
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000399 std::string first_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000400 size_t line_end = message.find(kNewLine, line_start);
401 if (line_end != std::string::npos) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200402 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000403 --line_end;
404 }
405 first_line = message.substr(line_start, (line_end - line_start));
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000406 } else {
407 first_line = message.substr(line_start);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000408 }
409
410 if (error) {
411 error->line = first_line;
412 error->description = description;
413 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100414 RTC_LOG(LS_ERROR) << "Failed to parse: \"" << first_line
415 << "\". Reason: " << description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000416 return false;
417}
418
419// |line| is the failing line. The reason for the failure should be
420// provided in the |description|.
421static bool ParseFailed(const std::string& line,
422 const std::string& description,
423 SdpParseError* error) {
424 return ParseFailed(line, 0, description, error);
425}
426
427// Parses failure where the failing SDP line isn't know or there are multiple
428// failing lines.
Yves Gerey665174f2018-06-19 15:03:05 +0200429static bool ParseFailed(const std::string& description, SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000430 return ParseFailed("", description, error);
431}
432
433// |line| is the failing line. The failure is due to the fact that |line|
434// doesn't have |expected_fields| fields.
435static bool ParseFailedExpectFieldNum(const std::string& line,
436 int expected_fields,
437 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200438 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000439 description << "Expects " << expected_fields << " fields.";
440 return ParseFailed(line, description.str(), error);
441}
442
443// |line| is the failing line. The failure is due to the fact that |line| has
444// less than |expected_min_fields| fields.
445static bool ParseFailedExpectMinFieldNum(const std::string& line,
446 int expected_min_fields,
447 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200448 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000449 description << "Expects at least " << expected_min_fields << " fields.";
450 return ParseFailed(line, description.str(), error);
451}
452
453// |line| is the failing line. The failure is due to the fact that it failed to
454// get the value of |attribute|.
455static bool ParseFailedGetValue(const std::string& line,
456 const std::string& attribute,
457 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200458 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000459 description << "Failed to get the value of attribute: " << attribute;
460 return ParseFailed(line, description.str(), error);
461}
462
463// The line starting at |line_start| of |message| is the failing line. The
464// failure is due to the line type (e.g. the "m" part of the "m-line")
465// not matching what is expected. The expected line type should be
466// provided as |line_type|.
467static bool ParseFailedExpectLine(const std::string& message,
468 size_t line_start,
469 const char line_type,
470 const std::string& line_value,
471 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200472 rtc::StringBuilder description;
473 description << "Expect line: " << std::string(1, line_type) << "="
474 << line_value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000475 return ParseFailed(message, line_start, description.str(), error);
476}
477
478static bool AddLine(const std::string& line, std::string* message) {
479 if (!message)
480 return false;
481
482 message->append(line);
483 message->append(kLineBreak);
484 return true;
485}
486
487static bool GetLine(const std::string& message,
488 size_t* pos,
489 std::string* line) {
490 size_t line_begin = *pos;
491 size_t line_end = message.find(kNewLine, line_begin);
492 if (line_end == std::string::npos) {
493 return false;
494 }
495 // Update the new start position
496 *pos = line_end + 1;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200497 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000498 --line_end;
499 }
500 *line = message.substr(line_begin, (line_end - line_begin));
501 const char* cline = line->c_str();
502 // RFC 4566
503 // An SDP session description consists of a number of lines of text of
504 // the form:
505 // <type>=<value>
506 // where <type> MUST be exactly one case-significant character and
507 // <value> is structured text whose format depends on <type>.
508 // Whitespace MUST NOT be used on either side of the "=" sign.
Taylor Brandstetter93a7b242018-04-16 10:45:24 -0700509 //
510 // However, an exception to the whitespace rule is made for "s=", since
511 // RFC4566 also says:
512 //
513 // If a session has no meaningful name, the value "s= " SHOULD be used
514 // (i.e., a single space as the session name).
515 if (line->length() < 3 || !islower(cline[0]) ||
Jonas Olssonec9e4922018-09-05 09:53:49 +0200516 cline[1] != kSdpDelimiterEqualChar ||
517 (cline[0] != kLineTypeSessionName &&
518 cline[2] == kSdpDelimiterSpaceChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000519 *pos = line_begin;
520 return false;
521 }
522 return true;
523}
524
525// Init |os| to "|type|=|value|".
526static void InitLine(const char type,
527 const std::string& value,
Jonas Olssonec9e4922018-09-05 09:53:49 +0200528 rtc::StringBuilder* os) {
529 os->Clear();
530 *os << std::string(1, type) << kSdpDelimiterEqual << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000531}
532
533// Init |os| to "a=|attribute|".
Jonas Olssonec9e4922018-09-05 09:53:49 +0200534static void InitAttrLine(const std::string& attribute, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000535 InitLine(kLineTypeAttributes, attribute, os);
536}
537
Piotr (Peter) Slatalab1ae10b2019-03-01 11:14:05 -0800538// Writes an x-mt SDP attribute line based on the media transport settings.
539static void AddMediaTransportLine(
540 const cricket::SessionDescription::MediaTransportSetting& setting,
541 std::string* message) {
542 rtc::StringBuilder os;
543 InitAttrLine(kMediaTransportSettingLine, &os);
544 os << kSdpDelimiterColon << setting.transport_name << kSdpDelimiterColon
545 << rtc::Base64::Encode(setting.transport_setting);
546 AddLine(os.str(), message);
547}
548
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000549// Writes a SDP attribute line based on |attribute| and |value| to |message|.
Yves Gerey665174f2018-06-19 15:03:05 +0200550static void AddAttributeLine(const std::string& attribute,
551 int value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000552 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200553 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000554 InitAttrLine(attribute, &os);
555 os << kSdpDelimiterColon << value;
556 AddLine(os.str(), message);
557}
558
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000559static bool IsLineType(const std::string& message,
560 const char type,
561 size_t line_start) {
562 if (message.size() < line_start + kLinePrefixLength) {
563 return false;
564 }
565 const char* cmessage = message.c_str();
566 return (cmessage[line_start] == type &&
Jonas Olssonec9e4922018-09-05 09:53:49 +0200567 cmessage[line_start + 1] == kSdpDelimiterEqualChar);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000568}
569
Yves Gerey665174f2018-06-19 15:03:05 +0200570static bool IsLineType(const std::string& line, const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000571 return IsLineType(line, type, 0);
572}
573
Yves Gerey665174f2018-06-19 15:03:05 +0200574static bool GetLineWithType(const std::string& message,
575 size_t* pos,
576 std::string* line,
577 const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000578 if (!IsLineType(message, type, *pos)) {
579 return false;
580 }
581
582 if (!GetLine(message, pos, line))
583 return false;
584
585 return true;
586}
587
588static bool HasAttribute(const std::string& line,
589 const std::string& attribute) {
Johannes Kron211856b2018-09-06 12:12:28 +0200590 if (line.compare(kLinePrefixLength, attribute.size(), attribute) == 0) {
591 // Make sure that the match is not only a partial match. If length of
592 // strings doesn't match, the next character of the line must be ':' or ' '.
593 // This function is also used for media descriptions (e.g., "m=audio 9..."),
594 // hence the need to also allow space in the end.
595 RTC_CHECK_LE(kLinePrefixLength + attribute.size(), line.size());
596 if ((kLinePrefixLength + attribute.size()) == line.size() ||
597 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterColonChar ||
598 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterSpaceChar) {
599 return true;
600 }
601 }
602 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000603}
604
Peter Boström0c4e06b2015-10-07 12:23:21 +0200605static bool AddSsrcLine(uint32_t ssrc_id,
606 const std::string& attribute,
607 const std::string& value,
608 std::string* message) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000609 // RFC 5576
610 // a=ssrc:<ssrc-id> <attribute>:<value>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200611 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000612 InitAttrLine(kAttributeSsrc, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200613 os << kSdpDelimiterColon << ssrc_id << kSdpDelimiterSpace << attribute
614 << kSdpDelimiterColon << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000615 return AddLine(os.str(), message);
616}
617
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000618// Get value only from <attribute>:<value>.
Yves Gerey665174f2018-06-19 15:03:05 +0200619static bool GetValue(const std::string& message,
620 const std::string& attribute,
621 std::string* value,
622 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000623 std::string leftpart;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200624 if (!rtc::tokenize_first(message, kSdpDelimiterColonChar, &leftpart, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000625 return ParseFailedGetValue(message, attribute, error);
626 }
627 // The left part should end with the expected attribute.
628 if (leftpart.length() < attribute.length() ||
629 leftpart.compare(leftpart.length() - attribute.length(),
630 attribute.length(), attribute) != 0) {
631 return ParseFailedGetValue(message, attribute, error);
632 }
633 return true;
634}
635
636static bool CaseInsensitiveFind(std::string str1, std::string str2) {
Steve Anton64b626b2019-01-28 17:25:26 -0800637 absl::c_transform(str1, str1.begin(), ::tolower);
638 absl::c_transform(str2, str2.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000639 return str1.find(str2) != std::string::npos;
640}
641
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000642template <class T>
643static bool GetValueFromString(const std::string& line,
644 const std::string& s,
645 T* t,
646 SdpParseError* error) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000647 if (!rtc::FromString(s, t)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200648 rtc::StringBuilder description;
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000649 description << "Invalid value: " << s << ".";
650 return ParseFailed(line, description.str(), error);
651 }
652 return true;
653}
654
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000655static bool GetPayloadTypeFromString(const std::string& line,
656 const std::string& s,
657 int* payload_type,
658 SdpParseError* error) {
659 return GetValueFromString(line, s, payload_type, error) &&
Yves Gerey665174f2018-06-19 15:03:05 +0200660 cricket::IsValidRtpPayloadType(*payload_type);
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000661}
662
Seth Hampson5897a6e2018-04-03 11:16:33 -0700663// Creates a StreamParams track in the case when no SSRC lines are signaled.
664// This is a track that does not contain SSRCs and only contains
665// stream_ids/track_id if it's signaled with a=msid lines.
666void CreateTrackWithNoSsrcs(const std::vector<std::string>& msid_stream_ids,
667 const std::string& msid_track_id,
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800668 const std::vector<RidDescription>& rids,
Seth Hampson5897a6e2018-04-03 11:16:33 -0700669 StreamParamsVec* tracks) {
670 StreamParams track;
Amit Hilbuch6df49d82019-04-15 15:47:21 -0700671 if (msid_track_id.empty() && rids.empty()) {
Seth Hampson5897a6e2018-04-03 11:16:33 -0700672 // We only create an unsignaled track if a=msid lines were signaled.
Amit Hilbuch6df49d82019-04-15 15:47:21 -0700673 RTC_LOG(LS_INFO) << "MSID not signaled, skipping creation of StreamParams";
Seth Hampson5897a6e2018-04-03 11:16:33 -0700674 return;
675 }
676 track.set_stream_ids(msid_stream_ids);
677 track.id = msid_track_id;
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800678 track.set_rids(rids);
Seth Hampson5897a6e2018-04-03 11:16:33 -0700679 tracks->push_back(track);
680}
681
682// Creates the StreamParams tracks, for the case when SSRC lines are signaled.
683// |msid_stream_ids| and |msid_track_id| represent the stream/track ID from the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800684// "a=msid" attribute, if it exists. They are empty if the attribute does not
Seth Hampson5897a6e2018-04-03 11:16:33 -0700685// exist. We prioritize getting stream_ids/track_ids signaled in a=msid lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000686void CreateTracksFromSsrcInfos(const SsrcInfoVec& ssrc_infos,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700687 const std::vector<std::string>& msid_stream_ids,
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800688 const std::string& msid_track_id,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700689 StreamParamsVec* tracks,
690 int msid_signaling) {
nisseede5da42017-01-12 05:15:36 -0800691 RTC_DCHECK(tracks != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700692 for (const SsrcInfo& ssrc_info : ssrc_infos) {
693 if (ssrc_info.cname.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000694 continue;
695 }
696
Seth Hampson5b4f0752018-04-02 16:31:36 -0700697 std::vector<std::string> stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000698 std::string track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700699 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
700 // This is the case with Unified Plan SDP msid signaling.
701 stream_ids = msid_stream_ids;
Tomas Gunnarsson191bf5c2018-03-30 10:44:43 +0000702 track_id = msid_track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700703 } else if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
704 // This is the case with Plan B SDP msid signaling.
Steve Anton4daf66e2018-09-07 14:55:53 -0700705 stream_ids.push_back(ssrc_info.stream_id);
706 track_id = ssrc_info.track_id;
707 } else if (!ssrc_info.mslabel.empty()) {
Seth Hampson5b4f0752018-04-02 16:31:36 -0700708 // Since there's no a=msid or a=ssrc msid signaling, this is a sdp from
709 // an older version of client that doesn't support msid.
710 // In that case, we use the mslabel and label to construct the track.
Steve Anton4daf66e2018-09-07 14:55:53 -0700711 stream_ids.push_back(ssrc_info.mslabel);
712 track_id = ssrc_info.label;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700713 } else {
714 // Since no media streams isn't supported with older SDP signaling, we
715 // use a default a stream id.
716 stream_ids.push_back(kDefaultMsid);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000717 }
Seth Hampson5b4f0752018-04-02 16:31:36 -0700718 // If a track ID wasn't populated from the SSRC attributes OR the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800719 // msid attribute, use default/random values.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800720 if (track_id.empty()) {
721 // TODO(ronghuawu): What should we do if the track id doesn't appear?
722 // Create random string (which will be used as track label later)?
723 track_id = rtc::CreateRandomString(8);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000724 }
725
Steve Anton64b626b2019-01-28 17:25:26 -0800726 auto track_it = absl::c_find_if(
727 *tracks,
Steve Anton4daf66e2018-09-07 14:55:53 -0700728 [track_id](const StreamParams& track) { return track.id == track_id; });
729 if (track_it == tracks->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000730 // If we don't find an existing track, create a new one.
731 tracks->push_back(StreamParams());
Steve Anton4daf66e2018-09-07 14:55:53 -0700732 track_it = tracks->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000733 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700734 StreamParams& track = *track_it;
735 track.add_ssrc(ssrc_info.ssrc_id);
736 track.cname = ssrc_info.cname;
737 track.set_stream_ids(stream_ids);
738 track.id = track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000739 }
740}
741
Seth Hampson845e8782018-03-02 11:34:10 -0800742void GetMediaStreamIds(const ContentInfo* content,
743 std::set<std::string>* labels) {
Steve Antonb1c1de12017-12-21 15:14:30 -0800744 for (const StreamParams& stream_params :
745 content->media_description()->streams()) {
Seth Hampson845e8782018-03-02 11:34:10 -0800746 for (const std::string& stream_id : stream_params.stream_ids()) {
747 labels->insert(stream_id);
Steve Anton5a26a3a2018-02-28 11:38:47 -0800748 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000749 }
750}
751
752// RFC 5245
753// It is RECOMMENDED that default candidates be chosen based on the
754// likelihood of those candidates to work with the peer that is being
755// contacted. It is RECOMMENDED that relayed > reflexive > host.
756static const int kPreferenceUnknown = 0;
757static const int kPreferenceHost = 1;
758static const int kPreferenceReflexive = 2;
759static const int kPreferenceRelayed = 3;
760
761static int GetCandidatePreferenceFromType(const std::string& type) {
762 int preference = kPreferenceUnknown;
763 if (type == cricket::LOCAL_PORT_TYPE) {
764 preference = kPreferenceHost;
765 } else if (type == cricket::STUN_PORT_TYPE) {
766 preference = kPreferenceReflexive;
767 } else if (type == cricket::RELAY_PORT_TYPE) {
768 preference = kPreferenceRelayed;
769 } else {
nissec80e7412017-01-11 05:56:46 -0800770 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000771 }
772 return preference;
773}
774
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000775// Get ip and port of the default destination from the |candidates| with the
776// given value of |component_id|. The default candidate should be the one most
777// likely to work, typically IPv4 relay.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000778// RFC 5245
779// The value of |component_id| currently supported are 1 (RTP) and 2 (RTCP).
Steve Anton36b29d12017-10-30 09:57:42 -0700780// TODO(deadbeef): Decide the default destination in webrtcsession and
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000781// pass it down via SessionDescription.
Yves Gerey665174f2018-06-19 15:03:05 +0200782static void GetDefaultDestination(const std::vector<Candidate>& candidates,
783 int component_id,
784 std::string* port,
785 std::string* ip,
786 std::string* addr_type) {
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000787 *addr_type = kConnectionIpv4Addrtype;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000788 *port = kDummyPort;
789 *ip = kDummyAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000790 int current_preference = kPreferenceUnknown;
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000791 int current_family = AF_UNSPEC;
Steve Anton4daf66e2018-09-07 14:55:53 -0700792 for (const Candidate& candidate : candidates) {
793 if (candidate.component() != component_id) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000794 continue;
795 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000796 // Default destination should be UDP only.
Steve Anton4daf66e2018-09-07 14:55:53 -0700797 if (candidate.protocol() != cricket::UDP_PROTOCOL_NAME) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000798 continue;
799 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700800 const int preference = GetCandidatePreferenceFromType(candidate.type());
801 const int family = candidate.address().ipaddr().family();
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000802 // See if this candidate is more preferable then the current one if it's the
803 // same family. Or if the current family is IPv4 already so we could safely
804 // ignore all IPv6 ones. WebRTC bug 4269.
805 // http://code.google.com/p/webrtc/issues/detail?id=4269
806 if ((preference <= current_preference && current_family == family) ||
807 (current_family == AF_INET && family == AF_INET6)) {
808 continue;
809 }
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000810 if (family == AF_INET) {
811 addr_type->assign(kConnectionIpv4Addrtype);
812 } else if (family == AF_INET6) {
813 addr_type->assign(kConnectionIpv6Addrtype);
814 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000815 current_preference = preference;
816 current_family = family;
Steve Anton4daf66e2018-09-07 14:55:53 -0700817 *port = candidate.address().PortAsString();
818 *ip = candidate.address().ipaddr().ToString();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000819 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000820}
821
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000822// Gets "a=rtcp" line if found default RTCP candidate from |candidates|.
823static std::string GetRtcpLine(const std::vector<Candidate>& candidates) {
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000824 std::string rtcp_line, rtcp_port, rtcp_ip, addr_type;
Yves Gerey665174f2018-06-19 15:03:05 +0200825 GetDefaultDestination(candidates, ICE_CANDIDATE_COMPONENT_RTCP, &rtcp_port,
826 &rtcp_ip, &addr_type);
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000827 // Found default RTCP candidate.
828 // RFC 5245
829 // If the agent is utilizing RTCP, it MUST encode the RTCP candidate
830 // using the a=rtcp attribute as defined in RFC 3605.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000831
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000832 // RFC 3605
833 // rtcp-attribute = "a=rtcp:" port [nettype space addrtype space
834 // connection-address] CRLF
Jonas Olssonec9e4922018-09-05 09:53:49 +0200835 rtc::StringBuilder os;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000836 InitAttrLine(kAttributeRtcp, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200837 os << kSdpDelimiterColon << rtcp_port << " " << kConnectionNettype << " "
838 << addr_type << " " << rtcp_ip;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000839 rtcp_line = os.str();
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000840 return rtcp_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000841}
842
843// Get candidates according to the mline index from SessionDescriptionInterface.
844static void GetCandidatesByMindex(const SessionDescriptionInterface& desci,
845 int mline_index,
846 std::vector<Candidate>* candidates) {
847 if (!candidates) {
848 return;
849 }
850 const IceCandidateCollection* cc = desci.candidates(mline_index);
851 for (size_t i = 0; i < cc->count(); ++i) {
852 const IceCandidateInterface* candidate = cc->at(i);
853 candidates->push_back(candidate->candidate());
854 }
855}
856
deadbeef90f1e1e2017-02-10 12:35:05 -0800857static bool IsValidPort(int port) {
858 return port >= 0 && port <= 65535;
859}
860
Steve Antone831b8c2018-02-01 12:22:16 -0800861std::string SdpSerialize(const JsepSessionDescription& jdesc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000862 const cricket::SessionDescription* desc = jdesc.description();
863 if (!desc) {
864 return "";
865 }
866
867 std::string message;
868
869 // Session Description.
870 AddLine(kSessionVersion, &message);
871 // Session Origin
872 // RFC 4566
873 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
874 // <unicast-address>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200875 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000876 InitLine(kLineTypeOrigin, kSessionOriginUsername, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200877 const std::string& session_id =
878 jdesc.session_id().empty() ? kSessionOriginSessionId : jdesc.session_id();
879 const std::string& session_version = jdesc.session_version().empty()
880 ? kSessionOriginSessionVersion
881 : jdesc.session_version();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000882 os << " " << session_id << " " << session_version << " "
883 << kSessionOriginNettype << " " << kSessionOriginAddrtype << " "
884 << kSessionOriginAddress;
885 AddLine(os.str(), &message);
886 AddLine(kSessionName, &message);
887
888 // Time Description.
889 AddLine(kTimeDescription, &message);
890
Piotr (Peter) Slatalab1ae10b2019-03-01 11:14:05 -0800891 for (const cricket::SessionDescription::MediaTransportSetting& settings :
892 desc->MediaTransportSettings()) {
893 AddMediaTransportLine(settings, &message);
894 }
895
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000896 // Group
897 if (desc->HasGroup(cricket::GROUP_TYPE_BUNDLE)) {
898 std::string group_line = kAttrGroup;
899 const cricket::ContentGroup* group =
900 desc->GetGroupByName(cricket::GROUP_TYPE_BUNDLE);
nisseede5da42017-01-12 05:15:36 -0800901 RTC_DCHECK(group != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700902 for (const std::string& content_name : group->content_names()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000903 group_line.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -0700904 group_line.append(content_name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000905 }
906 AddLine(group_line, &message);
907 }
908
Johannes Kron0854eb62018-10-10 22:33:20 +0200909 // Mixed one- and two-byte header extension.
Johannes Kron9581bc42018-10-23 10:17:39 +0200910 if (desc->extmap_allow_mixed()) {
Johannes Kron0854eb62018-10-10 22:33:20 +0200911 InitAttrLine(kAttributeExtmapAllowMixed, &os);
912 AddLine(os.str(), &message);
913 }
914
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000915 // MediaStream semantics
916 InitAttrLine(kAttributeMsidSemantics, &os);
917 os << kSdpDelimiterColon << " " << kMediaStreamSemantic;
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000918
Seth Hampson845e8782018-03-02 11:34:10 -0800919 std::set<std::string> media_stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000920 const ContentInfo* audio_content = GetFirstAudioContent(desc);
921 if (audio_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800922 GetMediaStreamIds(audio_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000923
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000924 const ContentInfo* video_content = GetFirstVideoContent(desc);
925 if (video_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800926 GetMediaStreamIds(video_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000927
Steve Anton4daf66e2018-09-07 14:55:53 -0700928 for (const std::string& id : media_stream_ids) {
929 os << " " << id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000930 }
931 AddLine(os.str(), &message);
932
Taylor Brandstetter2f65ec52018-05-24 11:37:28 -0700933 // a=ice-lite
934 //
935 // TODO(deadbeef): It's weird that we need to iterate TransportInfos for
936 // this, when it's a session-level attribute. It really should be moved to a
937 // session-level structure like SessionDescription.
938 for (const cricket::TransportInfo& transport : desc->transport_infos()) {
939 if (transport.description.ice_mode == cricket::ICEMODE_LITE) {
940 InitAttrLine(kAttributeIceLite, &os);
941 AddLine(os.str(), &message);
942 break;
943 }
944 }
945
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000946 // Preserve the order of the media contents.
947 int mline_index = -1;
Steve Anton4daf66e2018-09-07 14:55:53 -0700948 for (const ContentInfo& content : desc->contents()) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000949 std::vector<Candidate> candidates;
950 GetCandidatesByMindex(jdesc, ++mline_index, &candidates);
Steve Anton4daf66e2018-09-07 14:55:53 -0700951 BuildMediaDescription(&content, desc->GetTransportInfoByName(content.name),
952 content.media_description()->type(), candidates,
953 desc->msid_signaling(), &message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000954 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000955 return message;
956}
957
958// Serializes the passed in IceCandidateInterface to a SDP string.
959// candidate - The candidate to be serialized.
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700960std::string SdpSerializeCandidate(const IceCandidateInterface& candidate) {
961 return SdpSerializeCandidate(candidate.candidate());
962}
963
964// Serializes a cricket Candidate.
965std::string SdpSerializeCandidate(const cricket::Candidate& candidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000966 std::string message;
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700967 std::vector<cricket::Candidate> candidates(1, candidate);
honghaiza54a0802015-12-16 18:37:23 -0800968 BuildCandidate(candidates, true, &message);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000969 // From WebRTC draft section 4.8.1.1 candidate-attribute will be
970 // just candidate:<candidate> not a=candidate:<blah>CRLF
nisseede5da42017-01-12 05:15:36 -0800971 RTC_DCHECK(message.find("a=") == 0);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000972 message.erase(0, 2);
nisseede5da42017-01-12 05:15:36 -0800973 RTC_DCHECK(message.find(kLineBreak) == message.size() - 2);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000974 message.resize(message.size() - 2);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000975 return message;
976}
977
978bool SdpDeserialize(const std::string& message,
979 JsepSessionDescription* jdesc,
980 SdpParseError* error) {
981 std::string session_id;
982 std::string session_version;
Peter Thatcher7cbd1882015-09-17 18:54:52 -0700983 TransportDescription session_td("", "");
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000984 RtpHeaderExtensions session_extmaps;
zhihuang38989e52017-03-21 11:04:53 -0700985 rtc::SocketAddress session_connection_addr;
Steve Anton5a1de872018-12-18 11:25:55 -0800986 auto desc = absl::make_unique<cricket::SessionDescription>();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000987 size_t current_pos = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000988
989 // Session Description
990 if (!ParseSessionDescription(message, &current_pos, &session_id,
deadbeefc80741f2015-10-22 13:14:45 -0700991 &session_version, &session_td, &session_extmaps,
Steve Anton5a1de872018-12-18 11:25:55 -0800992 &session_connection_addr, desc.get(), error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000993 return false;
994 }
995
996 // Media Description
Steve Anton5a1de872018-12-18 11:25:55 -0800997 std::vector<std::unique_ptr<JsepIceCandidate>> candidates;
deadbeefc80741f2015-10-22 13:14:45 -0700998 if (!ParseMediaDescription(message, session_td, session_extmaps, &current_pos,
Steve Anton5a1de872018-12-18 11:25:55 -0800999 session_connection_addr, desc.get(), &candidates,
zhihuang38989e52017-03-21 11:04:53 -07001000 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001001 return false;
1002 }
1003
Harald Alvestrand4d7160e2019-04-12 07:01:29 +02001004 jdesc->Initialize(std::move(desc), session_id, session_version);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001005
Steve Anton5a1de872018-12-18 11:25:55 -08001006 for (const auto& candidate : candidates) {
1007 jdesc->AddCandidate(candidate.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001008 }
1009 return true;
1010}
1011
1012bool SdpDeserializeCandidate(const std::string& message,
1013 JsepIceCandidate* jcandidate,
1014 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08001015 RTC_DCHECK(jcandidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001016 Candidate candidate;
1017 if (!ParseCandidate(message, &candidate, error, true)) {
1018 return false;
1019 }
1020 jcandidate->SetCandidate(candidate);
1021 return true;
1022}
1023
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001024bool SdpDeserializeCandidate(const std::string& transport_name,
1025 const std::string& message,
1026 cricket::Candidate* candidate,
1027 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08001028 RTC_DCHECK(candidate != nullptr);
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001029 if (!ParseCandidate(message, candidate, error, true)) {
1030 return false;
1031 }
1032 candidate->set_transport_name(transport_name);
1033 return true;
1034}
1035
Yves Gerey665174f2018-06-19 15:03:05 +02001036bool ParseCandidate(const std::string& message,
1037 Candidate* candidate,
1038 SdpParseError* error,
1039 bool is_raw) {
nisseede5da42017-01-12 05:15:36 -08001040 RTC_DCHECK(candidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001041
1042 // Get the first line from |message|.
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001043 std::string first_line = message;
1044 size_t pos = 0;
1045 GetLine(message, &pos, &first_line);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001046
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001047 // Makes sure |message| contains only one line.
1048 if (message.size() > first_line.size()) {
1049 std::string left, right;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001050 if (rtc::tokenize_first(message, kNewLineChar, &left, &right) &&
Donald Curtis0e07f922015-05-15 09:21:23 -07001051 !right.empty()) {
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001052 return ParseFailed(message, 0, "Expect one line only", error);
1053 }
1054 }
1055
1056 // From WebRTC draft section 4.8.1.1 candidate-attribute should be
1057 // candidate:<candidate> when trickled, but we still support
1058 // a=candidate:<blah>CRLF for backward compatibility and for parsing a line
1059 // from the SDP.
1060 if (IsLineType(first_line, kLineTypeAttributes)) {
1061 first_line = first_line.substr(kLinePrefixLength);
1062 }
1063
1064 std::string attribute_candidate;
1065 std::string candidate_value;
1066
1067 // |first_line| must be in the form of "candidate:<value>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001068 if (!rtc::tokenize_first(first_line, kSdpDelimiterColonChar,
1069 &attribute_candidate, &candidate_value) ||
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001070 attribute_candidate != kAttributeCandidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001071 if (is_raw) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001072 rtc::StringBuilder description;
Yves Gerey665174f2018-06-19 15:03:05 +02001073 description << "Expect line: " << kAttributeCandidate << ":"
1074 << "<candidate-str>";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001075 return ParseFailed(first_line, 0, description.str(), error);
1076 } else {
1077 return ParseFailedExpectLine(first_line, 0, kLineTypeAttributes,
1078 kAttributeCandidate, error);
1079 }
1080 }
1081
1082 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001083 rtc::split(candidate_value, kSdpDelimiterSpaceChar, &fields);
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001084
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001085 // RFC 5245
1086 // a=candidate:<foundation> <component-id> <transport> <priority>
1087 // <connection-address> <port> typ <candidate-types>
1088 // [raddr <connection-address>] [rport <port>]
1089 // *(SP extension-att-name SP extension-att-value)
1090 const size_t expected_min_fields = 8;
1091 if (fields.size() < expected_min_fields ||
1092 (fields[6] != kAttributeCandidateTyp)) {
1093 return ParseFailedExpectMinFieldNum(first_line, expected_min_fields, error);
1094 }
jbauch083b73f2015-07-16 02:46:32 -07001095 const std::string& foundation = fields[0];
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001096
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001097 int component_id = 0;
1098 if (!GetValueFromString(first_line, fields[1], &component_id, error)) {
1099 return false;
1100 }
jbauch083b73f2015-07-16 02:46:32 -07001101 const std::string& transport = fields[2];
Peter Boström0c4e06b2015-10-07 12:23:21 +02001102 uint32_t priority = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001103 if (!GetValueFromString(first_line, fields[3], &priority, error)) {
1104 return false;
1105 }
jbauch083b73f2015-07-16 02:46:32 -07001106 const std::string& connection_address = fields[4];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001107 int port = 0;
1108 if (!GetValueFromString(first_line, fields[5], &port, error)) {
1109 return false;
1110 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001111 if (!IsValidPort(port)) {
1112 return ParseFailed(first_line, "Invalid port number.", error);
1113 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001114 SocketAddress address(connection_address, port);
1115
1116 cricket::ProtocolType protocol;
hnslb68cc752016-12-13 10:33:41 -08001117 if (!StringToProto(transport.c_str(), &protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001118 return ParseFailed(first_line, "Unsupported transport type.", error);
1119 }
hnslb68cc752016-12-13 10:33:41 -08001120 switch (protocol) {
1121 case cricket::PROTO_UDP:
1122 case cricket::PROTO_TCP:
1123 case cricket::PROTO_SSLTCP:
1124 // Supported protocol.
1125 break;
1126 default:
1127 return ParseFailed(first_line, "Unsupported transport type.", error);
1128 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001129
1130 std::string candidate_type;
jbauch083b73f2015-07-16 02:46:32 -07001131 const std::string& type = fields[7];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001132 if (type == kCandidateHost) {
1133 candidate_type = cricket::LOCAL_PORT_TYPE;
1134 } else if (type == kCandidateSrflx) {
1135 candidate_type = cricket::STUN_PORT_TYPE;
1136 } else if (type == kCandidateRelay) {
1137 candidate_type = cricket::RELAY_PORT_TYPE;
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001138 } else if (type == kCandidatePrflx) {
1139 candidate_type = cricket::PRFLX_PORT_TYPE;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001140 } else {
1141 return ParseFailed(first_line, "Unsupported candidate type.", error);
1142 }
1143
1144 size_t current_position = expected_min_fields;
1145 SocketAddress related_address;
1146 // The 2 optional fields for related address
1147 // [raddr <connection-address>] [rport <port>]
1148 if (fields.size() >= (current_position + 2) &&
1149 fields[current_position] == kAttributeCandidateRaddr) {
1150 related_address.SetIP(fields[++current_position]);
1151 ++current_position;
1152 }
1153 if (fields.size() >= (current_position + 2) &&
1154 fields[current_position] == kAttributeCandidateRport) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001155 int port = 0;
Yves Gerey665174f2018-06-19 15:03:05 +02001156 if (!GetValueFromString(first_line, fields[++current_position], &port,
1157 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001158 return false;
1159 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001160 if (!IsValidPort(port)) {
1161 return ParseFailed(first_line, "Invalid port number.", error);
1162 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001163 related_address.SetPort(port);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001164 ++current_position;
1165 }
1166
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001167 // If this is a TCP candidate, it has additional extension as defined in
1168 // RFC 6544.
1169 std::string tcptype;
1170 if (fields.size() >= (current_position + 2) &&
1171 fields[current_position] == kTcpCandidateType) {
1172 tcptype = fields[++current_position];
1173 ++current_position;
1174
1175 if (tcptype != cricket::TCPTYPE_ACTIVE_STR &&
1176 tcptype != cricket::TCPTYPE_PASSIVE_STR &&
1177 tcptype != cricket::TCPTYPE_SIMOPEN_STR) {
1178 return ParseFailed(first_line, "Invalid TCP candidate type.", error);
1179 }
1180
1181 if (protocol != cricket::PROTO_TCP) {
1182 return ParseFailed(first_line, "Invalid non-TCP candidate", error);
1183 }
1184 }
1185
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001186 // Extension
honghaiza54a0802015-12-16 18:37:23 -08001187 // Though non-standard, we support the ICE ufrag and pwd being signaled on
1188 // the candidate to avoid issues with confusing which generation a candidate
1189 // belongs to when trickling multiple generations at the same time.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001190 std::string username;
1191 std::string password;
Peter Boström0c4e06b2015-10-07 12:23:21 +02001192 uint32_t generation = 0;
honghaiza0c44ea2016-03-23 16:07:48 -07001193 uint16_t network_id = 0;
1194 uint16_t network_cost = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001195 for (size_t i = current_position; i + 1 < fields.size(); ++i) {
1196 // RFC 5245
1197 // *(SP extension-att-name SP extension-att-value)
1198 if (fields[i] == kAttributeCandidateGeneration) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001199 if (!GetValueFromString(first_line, fields[++i], &generation, error)) {
1200 return false;
1201 }
honghaiza54a0802015-12-16 18:37:23 -08001202 } else if (fields[i] == kAttributeCandidateUfrag) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001203 username = fields[++i];
honghaiza54a0802015-12-16 18:37:23 -08001204 } else if (fields[i] == kAttributeCandidatePwd) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001205 password = fields[++i];
honghaiza0c44ea2016-03-23 16:07:48 -07001206 } else if (fields[i] == kAttributeCandidateNetworkId) {
1207 if (!GetValueFromString(first_line, fields[++i], &network_id, error)) {
1208 return false;
1209 }
honghaize1a0c942016-02-16 14:54:56 -08001210 } else if (fields[i] == kAttributeCandidateNetworkCost) {
1211 if (!GetValueFromString(first_line, fields[++i], &network_cost, error)) {
1212 return false;
1213 }
Honghai Zhang351d77b2016-05-20 15:08:29 -07001214 network_cost = std::min(network_cost, rtc::kNetworkCostMax);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001215 } else {
1216 // Skip the unknown extension.
1217 ++i;
1218 }
1219 }
1220
guoweis@webrtc.org61c12472015-01-15 06:53:07 +00001221 *candidate = Candidate(component_id, cricket::ProtoToString(protocol),
guoweis@webrtc.org950c5182014-12-16 23:01:31 +00001222 address, priority, username, password, candidate_type,
honghaiza0c44ea2016-03-23 16:07:48 -07001223 generation, foundation, network_id, network_cost);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001224 candidate->set_related_address(related_address);
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001225 candidate->set_tcptype(tcptype);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001226 return true;
1227}
1228
1229bool ParseIceOptions(const std::string& line,
1230 std::vector<std::string>* transport_options,
1231 SdpParseError* error) {
1232 std::string ice_options;
1233 if (!GetValue(line, kAttributeIceOption, &ice_options, error)) {
1234 return false;
1235 }
1236 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001237 rtc::split(ice_options, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001238 for (size_t i = 0; i < fields.size(); ++i) {
1239 transport_options->push_back(fields[i]);
1240 }
1241 return true;
1242}
1243
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001244bool ParseSctpPort(const std::string& line,
1245 int* sctp_port,
1246 SdpParseError* error) {
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02001247 // draft-ietf-mmusic-sctp-sdp-26
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001248 // a=sctp-port
1249 std::vector<std::string> fields;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001250 const size_t expected_min_fields = 2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001251 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
lally69f57602015-10-08 10:15:04 -07001252 if (fields.size() < expected_min_fields) {
1253 fields.resize(0);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001254 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
lally69f57602015-10-08 10:15:04 -07001255 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001256 if (fields.size() < expected_min_fields) {
1257 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1258 }
1259 if (!rtc::FromString(fields[1], sctp_port)) {
lally69f57602015-10-08 10:15:04 -07001260 return ParseFailed(line, "Invalid sctp port value.", error);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001261 }
1262 return true;
1263}
1264
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02001265bool ParseSctpMaxMessageSize(const std::string& line,
1266 int* max_message_size,
1267 SdpParseError* error) {
1268 // draft-ietf-mmusic-sctp-sdp-26
1269 // a=max-message-size:199999
1270 std::vector<std::string> fields;
1271 const size_t expected_min_fields = 2;
1272 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
1273 if (fields.size() < expected_min_fields) {
1274 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1275 }
1276 if (!rtc::FromString(fields[1], max_message_size)) {
1277 return ParseFailed(line, "Invalid SCTP max message size.", error);
1278 }
1279 return true;
1280}
1281
isheriff6f8d6862016-05-26 11:24:55 -07001282bool ParseExtmap(const std::string& line,
1283 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001284 SdpParseError* error) {
1285 // RFC 5285
1286 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1287 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001288 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001289 const size_t expected_min_fields = 2;
1290 if (fields.size() < expected_min_fields) {
1291 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1292 }
1293 std::string uri = fields[1];
1294
1295 std::string value_direction;
1296 if (!GetValue(fields[0], kAttributeExtmap, &value_direction, error)) {
1297 return false;
1298 }
1299 std::vector<std::string> sub_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001300 rtc::split(value_direction, kSdpDelimiterSlashChar, &sub_fields);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001301 int value = 0;
1302 if (!GetValueFromString(line, sub_fields[0], &value, error)) {
1303 return false;
1304 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001305
jbauch5869f502017-06-29 12:31:36 -07001306 bool encrypted = false;
1307 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1308 // RFC 6904
Steve Anton36b29d12017-10-30 09:57:42 -07001309 // a=extmap:<value["/"<direction>] urn:ietf:params:rtp-hdrext:encrypt <URI>
1310 // <extensionattributes>
jbauch5869f502017-06-29 12:31:36 -07001311 const size_t expected_min_fields_encrypted = expected_min_fields + 1;
1312 if (fields.size() < expected_min_fields_encrypted) {
1313 return ParseFailedExpectMinFieldNum(line, expected_min_fields_encrypted,
Yves Gerey665174f2018-06-19 15:03:05 +02001314 error);
jbauch5869f502017-06-29 12:31:36 -07001315 }
1316
1317 encrypted = true;
1318 uri = fields[2];
1319 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1320 return ParseFailed(line, "Recursive encrypted header.", error);
1321 }
1322 }
1323
1324 *extmap = RtpExtension(uri, value, encrypted);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001325 return true;
1326}
1327
1328void BuildMediaDescription(const ContentInfo* content_info,
1329 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001330 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001331 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -08001332 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001333 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001334 RTC_DCHECK(message != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001335 if (content_info == NULL || message == NULL) {
1336 return;
1337 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001338 rtc::StringBuilder os;
Steve Antonb1c1de12017-12-21 15:14:30 -08001339 const MediaContentDescription* media_desc = content_info->media_description();
1340 RTC_DCHECK(media_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001341
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001342 // RFC 4566
1343 // m=<media> <port> <proto> <fmt>
1344 // fmt is a list of payload type numbers that MAY be used in the session.
1345 const char* type = NULL;
1346 if (media_type == cricket::MEDIA_TYPE_AUDIO)
1347 type = kMediaTypeAudio;
1348 else if (media_type == cricket::MEDIA_TYPE_VIDEO)
1349 type = kMediaTypeVideo;
1350 else if (media_type == cricket::MEDIA_TYPE_DATA)
1351 type = kMediaTypeData;
1352 else
nissec80e7412017-01-11 05:56:46 -08001353 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001354
1355 std::string fmt;
1356 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001357 const VideoContentDescription* video_desc = media_desc->as_video();
Steve Anton4daf66e2018-09-07 14:55:53 -07001358 for (const cricket::VideoCodec& codec : video_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001359 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001360 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001361 }
1362 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001363 const AudioContentDescription* audio_desc = media_desc->as_audio();
Steve Anton4daf66e2018-09-07 14:55:53 -07001364 for (const cricket::AudioCodec& codec : audio_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001365 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001366 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001367 }
1368 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001369 if (IsDtlsSctp(media_desc->protocol())) {
Harald Alvestrand14b27582019-05-04 11:37:04 +02001370 const cricket::SctpDataContentDescription* data_desc =
1371 media_desc->as_sctp();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001372 fmt.append(" ");
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001373
zstein4b2e0822017-02-17 19:48:38 -08001374 if (data_desc->use_sctpmap()) {
Harald Alvestrand14b27582019-05-04 11:37:04 +02001375 fmt.append(rtc::ToString(data_desc->port()));
zstein4b2e0822017-02-17 19:48:38 -08001376 } else {
1377 fmt.append(kDefaultSctpmapProtocol);
1378 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001379 } else {
Harald Alvestrand14b27582019-05-04 11:37:04 +02001380 const RtpDataContentDescription* data_desc = media_desc->as_rtp_data();
1381 for (const cricket::RtpDataCodec& codec : data_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001382 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001383 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001384 }
1385 }
1386 }
1387 // The fmt must never be empty. If no codecs are found, set the fmt attribute
1388 // to 0.
1389 if (fmt.empty()) {
1390 fmt = " 0";
1391 }
1392
deadbeef25ed4352016-12-12 18:37:36 -08001393 // The port number in the m line will be updated later when associated with
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001394 // the candidates.
deadbeef25ed4352016-12-12 18:37:36 -08001395 //
1396 // A port value of 0 indicates that the m= section is rejected.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001397 // RFC 3264
1398 // To reject an offered stream, the port number in the corresponding stream in
1399 // the answer MUST be set to zero.
deadbeef25ed4352016-12-12 18:37:36 -08001400 //
1401 // However, the BUNDLE draft adds a new meaning to port zero, when used along
1402 // with a=bundle-only.
zhihuang38989e52017-03-21 11:04:53 -07001403 std::string port = kDummyPort;
1404 if (content_info->rejected || content_info->bundle_only) {
1405 port = kMediaPortRejected;
1406 } else if (!media_desc->connection_address().IsNil()) {
1407 port = rtc::ToString(media_desc->connection_address().port());
1408 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001409
Yves Gerey665174f2018-06-19 15:03:05 +02001410 rtc::SSLFingerprint* fp =
1411 (transport_info) ? transport_info->description.identity_fingerprint.get()
1412 : NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001413
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001414 // Add the m and c lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001415 InitLine(kLineTypeMedia, type, &os);
1416 os << " " << port << " " << media_desc->protocol() << fmt;
zhihuang38989e52017-03-21 11:04:53 -07001417 AddLine(os.str(), message);
1418
1419 InitLine(kLineTypeConnection, kConnectionNettype, &os);
1420 if (media_desc->connection_address().IsNil()) {
1421 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
1422 } else if (media_desc->connection_address().family() == AF_INET) {
1423 os << " " << kConnectionIpv4Addrtype << " "
1424 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 12:53:06 -08001425 } else if (media_desc->connection_address().family() == AF_INET6) {
zhihuang38989e52017-03-21 11:04:53 -07001426 os << " " << kConnectionIpv6Addrtype << " "
1427 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 12:53:06 -08001428 } else if (!media_desc->connection_address().hostname().empty()) {
1429 // For hostname candidates, we use c=IN IP4 <hostname>.
1430 os << " " << kConnectionIpv4Addrtype << " "
1431 << media_desc->connection_address().hostname();
1432 } else {
1433 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
zhihuang38989e52017-03-21 11:04:53 -07001434 }
1435 AddLine(os.str(), message);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001436
1437 // RFC 4566
1438 // b=AS:<bandwidth>
Peter Thatcherc0c3a862015-06-24 15:31:25 -07001439 if (media_desc->bandwidth() >= 1000) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001440 InitLine(kLineTypeSessionBandwidth, kApplicationSpecificMaximum, &os);
1441 os << kSdpDelimiterColon << (media_desc->bandwidth() / 1000);
1442 AddLine(os.str(), message);
1443 }
1444
deadbeef25ed4352016-12-12 18:37:36 -08001445 // Add the a=bundle-only line.
1446 if (content_info->bundle_only) {
1447 InitAttrLine(kAttributeBundleOnly, &os);
1448 AddLine(os.str(), message);
1449 }
1450
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001451 // Add the a=rtcp line.
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001452 if (IsRtp(media_desc->protocol())) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001453 std::string rtcp_line = GetRtcpLine(candidates);
1454 if (!rtcp_line.empty()) {
1455 AddLine(rtcp_line, message);
1456 }
1457 }
1458
honghaiza54a0802015-12-16 18:37:23 -08001459 // Build the a=candidate lines. We don't include ufrag and pwd in the
1460 // candidates in the SDP to avoid redundancy.
1461 BuildCandidate(candidates, false, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001462
1463 // Use the transport_info to build the media level ice-ufrag and ice-pwd.
1464 if (transport_info) {
1465 // RFC 5245
1466 // ice-pwd-att = "ice-pwd" ":" password
1467 // ice-ufrag-att = "ice-ufrag" ":" ufrag
1468 // ice-ufrag
deadbeef3f7219b2015-12-28 15:17:14 -08001469 if (!transport_info->description.ice_ufrag.empty()) {
1470 InitAttrLine(kAttributeIceUfrag, &os);
1471 os << kSdpDelimiterColon << transport_info->description.ice_ufrag;
1472 AddLine(os.str(), message);
1473 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001474 // ice-pwd
deadbeef3f7219b2015-12-28 15:17:14 -08001475 if (!transport_info->description.ice_pwd.empty()) {
1476 InitAttrLine(kAttributeIcePwd, &os);
1477 os << kSdpDelimiterColon << transport_info->description.ice_pwd;
1478 AddLine(os.str(), message);
1479 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001480
1481 // draft-petithuguenin-mmusic-ice-attributes-level-03
1482 BuildIceOptions(transport_info->description.transport_options, message);
1483
1484 // RFC 4572
1485 // fingerprint-attribute =
1486 // "fingerprint" ":" hash-func SP fingerprint
1487 if (fp) {
1488 // Insert the fingerprint attribute.
1489 InitAttrLine(kAttributeFingerprint, &os);
Yves Gerey665174f2018-06-19 15:03:05 +02001490 os << kSdpDelimiterColon << fp->algorithm << kSdpDelimiterSpace
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001491 << fp->GetRfc4572Fingerprint();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001492 AddLine(os.str(), message);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001493
1494 // Inserting setup attribute.
1495 if (transport_info->description.connection_role !=
Yves Gerey665174f2018-06-19 15:03:05 +02001496 cricket::CONNECTIONROLE_NONE) {
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001497 // Making sure we are not using "passive" mode.
1498 cricket::ConnectionRole role =
1499 transport_info->description.connection_role;
mallinath@webrtc.org19f27e62013-10-13 17:18:27 +00001500 std::string dtls_role_str;
nissec16fa5e2017-02-07 07:18:43 -08001501 const bool success =
1502 cricket::ConnectionRoleToString(role, &dtls_role_str);
1503 RTC_DCHECK(success);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001504 InitAttrLine(kAttributeSetup, &os);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001505 os << kSdpDelimiterColon << dtls_role_str;
1506 AddLine(os.str(), message);
1507 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001508 }
1509 }
1510
1511 // RFC 3388
1512 // mid-attribute = "a=mid:" identification-tag
1513 // identification-tag = token
1514 // Use the content name as the mid identification-tag.
1515 InitAttrLine(kAttributeMid, &os);
1516 os << kSdpDelimiterColon << content_info->name;
1517 AddLine(os.str(), message);
1518
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001519 if (IsDtlsSctp(media_desc->protocol())) {
Harald Alvestrand14b27582019-05-04 11:37:04 +02001520 const cricket::SctpDataContentDescription* data_desc =
1521 media_desc->as_sctp();
zstein4b2e0822017-02-17 19:48:38 -08001522 bool use_sctpmap = data_desc->use_sctpmap();
Harald Alvestrand14b27582019-05-04 11:37:04 +02001523 BuildSctpContentAttributes(message, data_desc->port(), use_sctpmap);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001524 } else if (IsRtp(media_desc->protocol())) {
Steve Antone831b8c2018-02-01 12:22:16 -08001525 BuildRtpContentAttributes(media_desc, media_type, msid_signaling, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001526 }
1527}
1528
zstein4b2e0822017-02-17 19:48:38 -08001529void BuildSctpContentAttributes(std::string* message,
1530 int sctp_port,
1531 bool use_sctpmap) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001532 rtc::StringBuilder os;
zstein4b2e0822017-02-17 19:48:38 -08001533 if (use_sctpmap) {
1534 // draft-ietf-mmusic-sctp-sdp-04
1535 // a=sctpmap:sctpmap-number protocol [streams]
1536 InitAttrLine(kAttributeSctpmap, &os);
1537 os << kSdpDelimiterColon << sctp_port << kSdpDelimiterSpace
1538 << kDefaultSctpmapProtocol << kSdpDelimiterSpace
1539 << cricket::kMaxSctpStreams;
1540 } else {
1541 // draft-ietf-mmusic-sctp-sdp-23
1542 // a=sctp-port:<port>
1543 InitAttrLine(kAttributeSctpPort, &os);
1544 os << kSdpDelimiterColon << sctp_port;
1545 // TODO(zstein): emit max-message-size here
1546 }
wu@webrtc.org78187522013-10-07 23:32:02 +00001547 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001548}
1549
deadbeef9d3584c2016-02-16 17:54:10 -08001550void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001551 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -08001552 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -08001553 std::string* message) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001554 SdpSerializer serializer;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001555 rtc::StringBuilder os;
Johannes Kron0854eb62018-10-10 22:33:20 +02001556 // RFC 8285
1557 // a=extmap-allow-mixed
1558 // The attribute MUST be either on session level or media level. We support
1559 // responding on both levels, however, we don't respond on media level if it's
1560 // set on session level.
Johannes Kron9581bc42018-10-23 10:17:39 +02001561 if (media_desc->extmap_allow_mixed_enum() ==
Johannes Kron0854eb62018-10-10 22:33:20 +02001562 MediaContentDescription::kMedia) {
1563 InitAttrLine(kAttributeExtmapAllowMixed, &os);
1564 AddLine(os.str(), message);
1565 }
1566 // RFC 8285
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001567 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1568 // The definitions MUST be either all session level or all media level. This
1569 // implementation uses all media level.
1570 for (size_t i = 0; i < media_desc->rtp_header_extensions().size(); ++i) {
jbauch5869f502017-06-29 12:31:36 -07001571 const RtpExtension& extension = media_desc->rtp_header_extensions()[i];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001572 InitAttrLine(kAttributeExtmap, &os);
jbauch5869f502017-06-29 12:31:36 -07001573 os << kSdpDelimiterColon << extension.id;
1574 if (extension.encrypt) {
1575 os << kSdpDelimiterSpace << RtpExtension::kEncryptHeaderExtensionsUri;
1576 }
1577 os << kSdpDelimiterSpace << extension.uri;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001578 AddLine(os.str(), message);
1579 }
1580
1581 // RFC 3264
1582 // a=sendrecv || a=sendonly || a=sendrecv || a=inactive
deadbeefc80741f2015-10-22 13:14:45 -07001583 switch (media_desc->direction()) {
Steve Anton4e70a722017-11-28 14:57:10 -08001584 case RtpTransceiverDirection::kInactive:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001585 InitAttrLine(kAttributeInactive, &os);
1586 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001587 case RtpTransceiverDirection::kSendOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001588 InitAttrLine(kAttributeSendOnly, &os);
1589 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001590 case RtpTransceiverDirection::kRecvOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001591 InitAttrLine(kAttributeRecvOnly, &os);
1592 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001593 case RtpTransceiverDirection::kSendRecv:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001594 default:
1595 InitAttrLine(kAttributeSendRecv, &os);
1596 break;
1597 }
1598 AddLine(os.str(), message);
1599
Seth Hampson5b4f0752018-04-02 16:31:36 -07001600 // Specified in https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
1601 // a=msid:<msid-id> <msid-appdata>
1602 // The msid-id is a 1*64 token char representing the media stream id, and the
1603 // msid-appdata is a 1*64 token char representing the track id. There is a
1604 // line for every media stream, with a special msid-id value of "-"
1605 // representing no streams. The value of "msid-appdata" MUST be identical for
1606 // all lines.
Steve Antone831b8c2018-02-01 12:22:16 -08001607 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
1608 const StreamParamsVec& streams = media_desc->streams();
1609 if (streams.size() == 1u) {
1610 const StreamParams& track = streams[0];
Seth Hampson5b4f0752018-04-02 16:31:36 -07001611 std::vector<std::string> stream_ids = track.stream_ids();
1612 if (stream_ids.empty()) {
1613 stream_ids.push_back(kNoStreamMsid);
1614 }
1615 for (const std::string& stream_id : stream_ids) {
1616 InitAttrLine(kAttributeMsid, &os);
1617 os << kSdpDelimiterColon << stream_id << kSdpDelimiterSpace << track.id;
1618 AddLine(os.str(), message);
1619 }
Steve Antone831b8c2018-02-01 12:22:16 -08001620 } else if (streams.size() > 1u) {
1621 RTC_LOG(LS_WARNING)
1622 << "Trying to serialize Unified Plan SDP with more than "
Jonas Olsson45cc8902018-02-13 10:37:07 +01001623 "one track in a media section. Omitting 'a=msid'.";
deadbeef9d3584c2016-02-16 17:54:10 -08001624 }
1625 }
1626
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001627 // RFC 5761
1628 // a=rtcp-mux
1629 if (media_desc->rtcp_mux()) {
1630 InitAttrLine(kAttributeRtcpMux, &os);
1631 AddLine(os.str(), message);
1632 }
1633
deadbeef13871492015-12-09 12:37:51 -08001634 // RFC 5506
1635 // a=rtcp-rsize
1636 if (media_desc->rtcp_reduced_size()) {
1637 InitAttrLine(kAttributeRtcpReducedSize, &os);
1638 AddLine(os.str(), message);
1639 }
1640
deadbeefd45aea82017-09-16 01:24:29 -07001641 if (media_desc->conference_mode()) {
1642 InitAttrLine(kAttributeXGoogleFlag, &os);
1643 os << kSdpDelimiterColon << kValueConference;
1644 AddLine(os.str(), message);
1645 }
1646
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001647 // RFC 4568
1648 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001649 for (const CryptoParams& crypto_params : media_desc->cryptos()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001650 InitAttrLine(kAttributeCrypto, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001651 os << kSdpDelimiterColon << crypto_params.tag << " "
1652 << crypto_params.cipher_suite << " " << crypto_params.key_params;
1653 if (!crypto_params.session_params.empty()) {
1654 os << " " << crypto_params.session_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001655 }
1656 AddLine(os.str(), message);
1657 }
1658
1659 // RFC 4566
1660 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1661 // [/<encodingparameters>]
1662 BuildRtpMap(media_desc, media_type, message);
1663
Steve Anton4daf66e2018-09-07 14:55:53 -07001664 for (const StreamParams& track : media_desc->streams()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001665 // Build the ssrc-group lines.
Steve Anton4daf66e2018-09-07 14:55:53 -07001666 for (const SsrcGroup& ssrc_group : track.ssrc_groups) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001667 // RFC 5576
1668 // a=ssrc-group:<semantics> <ssrc-id> ...
Steve Anton4daf66e2018-09-07 14:55:53 -07001669 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001670 continue;
1671 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001672 InitAttrLine(kAttributeSsrcGroup, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001673 os << kSdpDelimiterColon << ssrc_group.semantics;
1674 for (uint32_t ssrc : ssrc_group.ssrcs) {
1675 os << kSdpDelimiterSpace << rtc::ToString(ssrc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001676 }
1677 AddLine(os.str(), message);
1678 }
1679 // Build the ssrc lines for each ssrc.
Steve Anton4daf66e2018-09-07 14:55:53 -07001680 for (uint32_t ssrc : track.ssrcs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001681 // RFC 5576
1682 // a=ssrc:<ssrc-id> cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07001683 AddSsrcLine(ssrc, kSsrcAttributeCname, track.cname, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001684
Steve Antone831b8c2018-02-01 12:22:16 -08001685 if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
1686 // draft-alvestrand-mmusic-msid-00
1687 // a=ssrc:<ssrc-id> msid:identifier [appdata]
1688 // The appdata consists of the "id" attribute of a MediaStreamTrack,
1689 // which corresponds to the "id" attribute of StreamParams.
Seth Hampson5b4f0752018-04-02 16:31:36 -07001690 // Since a=ssrc msid signaling is used in Plan B SDP semantics, and
1691 // multiple stream ids are not supported for Plan B, we are only adding
1692 // a line for the first media stream id here.
Seth Hampson7fa6ee62018-10-17 10:25:28 -07001693 const std::string& track_stream_id = track.first_stream_id();
1694 // We use a special msid-id value of "-" to represent no streams,
1695 // for Unified Plan compatibility. Plan B will always have a
1696 // track_stream_id.
1697 const std::string& stream_id =
1698 track_stream_id.empty() ? kNoStreamMsid : track_stream_id;
Steve Antone831b8c2018-02-01 12:22:16 -08001699 InitAttrLine(kAttributeSsrc, &os);
1700 os << kSdpDelimiterColon << ssrc << kSdpDelimiterSpace
1701 << kSsrcAttributeMsid << kSdpDelimiterColon << stream_id
Steve Anton4daf66e2018-09-07 14:55:53 -07001702 << kSdpDelimiterSpace << track.id;
Steve Antone831b8c2018-02-01 12:22:16 -08001703 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001704
Steve Antone831b8c2018-02-01 12:22:16 -08001705 // TODO(ronghuawu): Remove below code which is for backward
1706 // compatibility.
1707 // draft-alvestrand-rtcweb-mid-01
1708 // a=ssrc:<ssrc-id> mslabel:<value>
1709 // The label isn't yet defined.
1710 // a=ssrc:<ssrc-id> label:<value>
Seth Hampson5b4f0752018-04-02 16:31:36 -07001711 AddSsrcLine(ssrc, kSsrcAttributeMslabel, stream_id, message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001712 AddSsrcLine(ssrc, kSSrcAttributeLabel, track.id, message);
Steve Antone831b8c2018-02-01 12:22:16 -08001713 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001714 }
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001715
1716 // Build the rid lines for each layer of the track
1717 for (const RidDescription& rid_description : track.rids()) {
1718 InitAttrLine(kAttributeRid, &os);
1719 os << kSdpDelimiterColon
1720 << serializer.SerializeRidDescription(rid_description);
1721 AddLine(os.str(), message);
1722 }
1723 }
1724
Amit Hilbucha2012042018-12-03 11:35:05 -08001725 // Simulcast (a=simulcast)
1726 // https://tools.ietf.org/html/draft-ietf-mmusic-sdp-simulcast-13#section-5.1
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001727 if (media_desc->HasSimulcast()) {
1728 const auto& simulcast = media_desc->simulcast_description();
Amit Hilbucha2012042018-12-03 11:35:05 -08001729 InitAttrLine(kAttributeSimulcast, &os);
Amit Hilbucha2012042018-12-03 11:35:05 -08001730 os << kSdpDelimiterColon
1731 << serializer.SerializeSimulcastDescription(simulcast);
1732 AddLine(os.str(), message);
1733 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001734}
1735
Jonas Olssonec9e4922018-09-05 09:53:49 +02001736void WriteFmtpHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001737 // fmtp header: a=fmtp:|payload_type| <parameters>
1738 // Add a=fmtp
1739 InitAttrLine(kAttributeFmtp, os);
1740 // Add :|payload_type|
1741 *os << kSdpDelimiterColon << payload_type;
1742}
1743
Jonas Olssonec9e4922018-09-05 09:53:49 +02001744void WriteRtcpFbHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001745 // rtcp-fb header: a=rtcp-fb:|payload_type|
1746 // <parameters>/<ccm <ccm_parameters>>
1747 // Add a=rtcp-fb
1748 InitAttrLine(kAttributeRtcpFb, os);
1749 // Add :
1750 *os << kSdpDelimiterColon;
1751 if (payload_type == kWildcardPayloadType) {
1752 *os << "*";
1753 } else {
1754 *os << payload_type;
1755 }
1756}
1757
1758void WriteFmtpParameter(const std::string& parameter_name,
1759 const std::string& parameter_value,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001760 rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001761 // fmtp parameters: |parameter_name|=|parameter_value|
1762 *os << parameter_name << kSdpDelimiterEqual << parameter_value;
1763}
1764
1765void WriteFmtpParameters(const cricket::CodecParameterMap& parameters,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001766 rtc::StringBuilder* os) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001767 bool first = true;
1768 for (const auto& entry : parameters) {
1769 const std::string& key = entry.first;
1770 const std::string& value = entry.second;
hta62a216e2016-04-15 11:02:14 -07001771 // Parameters are a semicolon-separated list, no spaces.
1772 // The list is separated from the header by a space.
Steve Anton4daf66e2018-09-07 14:55:53 -07001773 if (first) {
hta62a216e2016-04-15 11:02:14 -07001774 *os << kSdpDelimiterSpace;
Steve Anton4daf66e2018-09-07 14:55:53 -07001775 first = false;
hta62a216e2016-04-15 11:02:14 -07001776 } else {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001777 *os << kSdpDelimiterSemicolon;
1778 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001779 WriteFmtpParameter(key, value, os);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001780 }
1781}
1782
1783bool IsFmtpParam(const std::string& name) {
ossuaa4b0772017-01-30 07:41:18 -08001784 // RFC 4855, section 3 specifies the mapping of media format parameters to SDP
1785 // parameters. Only ptime, maxptime, channels and rate are placed outside of
1786 // the fmtp line. In WebRTC, channels and rate are already handled separately
1787 // and thus not included in the CodecParameterMap.
1788 return name != kCodecParamPTime && name != kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001789}
1790
1791// Retreives fmtp parameters from |params|, which may contain other parameters
1792// as well, and puts them in |fmtp_parameters|.
1793void GetFmtpParams(const cricket::CodecParameterMap& params,
1794 cricket::CodecParameterMap* fmtp_parameters) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001795 for (const auto& entry : params) {
1796 const std::string& key = entry.first;
1797 const std::string& value = entry.second;
1798 if (IsFmtpParam(key)) {
1799 (*fmtp_parameters)[key] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001800 }
1801 }
1802}
1803
1804template <class T>
1805void AddFmtpLine(const T& codec, std::string* message) {
1806 cricket::CodecParameterMap fmtp_parameters;
1807 GetFmtpParams(codec.params, &fmtp_parameters);
1808 if (fmtp_parameters.empty()) {
1809 // No need to add an fmtp if it will have no (optional) parameters.
1810 return;
1811 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001812 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001813 WriteFmtpHeader(codec.id, &os);
1814 WriteFmtpParameters(fmtp_parameters, &os);
1815 AddLine(os.str(), message);
1816 return;
1817}
1818
1819template <class T>
1820void AddRtcpFbLines(const T& codec, std::string* message) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001821 for (const cricket::FeedbackParam& param : codec.feedback_params.params()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001822 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001823 WriteRtcpFbHeader(codec.id, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001824 os << " " << param.id();
1825 if (!param.param().empty()) {
1826 os << " " << param.param();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001827 }
1828 AddLine(os.str(), message);
1829 }
1830}
1831
1832bool GetMinValue(const std::vector<int>& values, int* value) {
1833 if (values.empty()) {
1834 return false;
1835 }
Steve Anton64b626b2019-01-28 17:25:26 -08001836 auto it = absl::c_min_element(values);
1837 *value = *it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001838 return true;
1839}
1840
1841bool GetParameter(const std::string& name,
Yves Gerey665174f2018-06-19 15:03:05 +02001842 const cricket::CodecParameterMap& params,
1843 int* value) {
1844 std::map<std::string, std::string>::const_iterator found = params.find(name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001845 if (found == params.end()) {
1846 return false;
1847 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00001848 if (!rtc::FromString(found->second, value)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001849 return false;
1850 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001851 return true;
1852}
1853
1854void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001855 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001856 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001857 RTC_DCHECK(message != NULL);
1858 RTC_DCHECK(media_desc != NULL);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001859 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001860 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001861 for (const cricket::VideoCodec& codec : media_desc->as_video()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001862 // RFC 4566
1863 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1864 // [/<encodingparameters>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001865 if (codec.id != kWildcardPayloadType) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001866 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001867 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
deadbeefe814a0d2017-02-25 18:15:09 -08001868 << cricket::kVideoCodecClockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001869 AddLine(os.str(), message);
1870 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001871 AddRtcpFbLines(codec, message);
1872 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001873 }
1874 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001875 std::vector<int> ptimes;
1876 std::vector<int> maxptimes;
1877 int max_minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001878 for (const cricket::AudioCodec& codec : media_desc->as_audio()->codecs()) {
1879 RTC_DCHECK(!codec.name.empty());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001880 // RFC 4566
1881 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1882 // [/<encodingparameters>]
1883 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001884 os << kSdpDelimiterColon << codec.id << " ";
1885 os << codec.name << "/" << codec.clockrate;
1886 if (codec.channels != 1) {
1887 os << "/" << codec.channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001888 }
1889 AddLine(os.str(), message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001890 AddRtcpFbLines(codec, message);
1891 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001892 int minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001893 if (GetParameter(kCodecParamMinPTime, codec.params, &minptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001894 max_minptime = std::max(minptime, max_minptime);
1895 }
1896 int ptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001897 if (GetParameter(kCodecParamPTime, codec.params, &ptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001898 ptimes.push_back(ptime);
1899 }
1900 int maxptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001901 if (GetParameter(kCodecParamMaxPTime, codec.params, &maxptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001902 maxptimes.push_back(maxptime);
1903 }
1904 }
1905 // Populate the maxptime attribute with the smallest maxptime of all codecs
1906 // under the same m-line.
1907 int min_maxptime = INT_MAX;
1908 if (GetMinValue(maxptimes, &min_maxptime)) {
1909 AddAttributeLine(kCodecParamMaxPTime, min_maxptime, message);
1910 }
nisseede5da42017-01-12 05:15:36 -08001911 RTC_DCHECK(min_maxptime > max_minptime);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001912 // Populate the ptime attribute with the smallest ptime or the largest
1913 // minptime, whichever is the largest, for all codecs under the same m-line.
1914 int ptime = INT_MAX;
1915 if (GetMinValue(ptimes, &ptime)) {
1916 ptime = std::min(ptime, min_maxptime);
1917 ptime = std::max(ptime, max_minptime);
1918 AddAttributeLine(kCodecParamPTime, ptime, message);
1919 }
1920 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand14b27582019-05-04 11:37:04 +02001921 for (const cricket::RtpDataCodec& codec :
1922 media_desc->as_rtp_data()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001923 // RFC 4566
1924 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1925 // [/<encodingparameters>]
1926 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001927 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
1928 << codec.clockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001929 AddLine(os.str(), message);
1930 }
1931 }
1932}
1933
1934void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -08001935 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001936 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001937 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001938
Steve Anton4daf66e2018-09-07 14:55:53 -07001939 for (const Candidate& candidate : candidates) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001940 // RFC 5245
1941 // a=candidate:<foundation> <component-id> <transport> <priority>
1942 // <connection-address> <port> typ <candidate-types>
1943 // [raddr <connection-address>] [rport <port>]
1944 // *(SP extension-att-name SP extension-att-value)
1945 std::string type;
1946 // Map the cricket candidate type to "host" / "srflx" / "prflx" / "relay"
Steve Anton4daf66e2018-09-07 14:55:53 -07001947 if (candidate.type() == cricket::LOCAL_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001948 type = kCandidateHost;
Steve Anton4daf66e2018-09-07 14:55:53 -07001949 } else if (candidate.type() == cricket::STUN_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001950 type = kCandidateSrflx;
Steve Anton4daf66e2018-09-07 14:55:53 -07001951 } else if (candidate.type() == cricket::RELAY_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001952 type = kCandidateRelay;
Steve Anton4daf66e2018-09-07 14:55:53 -07001953 } else if (candidate.type() == cricket::PRFLX_PORT_TYPE) {
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001954 type = kCandidatePrflx;
1955 // Peer reflexive candidate may be signaled for being removed.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001956 } else {
nissec80e7412017-01-11 05:56:46 -08001957 RTC_NOTREACHED();
Peter Thatcher019087f2015-04-28 09:06:26 -07001958 // Never write out candidates if we don't know the type.
1959 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001960 }
1961
1962 InitAttrLine(kAttributeCandidate, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001963 os << kSdpDelimiterColon << candidate.foundation() << " "
1964 << candidate.component() << " " << candidate.protocol() << " "
1965 << candidate.priority() << " "
1966 << (candidate.address().ipaddr().IsNil()
1967 ? candidate.address().hostname()
1968 : candidate.address().ipaddr().ToString())
1969 << " " << candidate.address().PortAsString() << " "
1970 << kAttributeCandidateTyp << " " << type << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001971
1972 // Related address
Steve Anton4daf66e2018-09-07 14:55:53 -07001973 if (!candidate.related_address().IsNil()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001974 os << kAttributeCandidateRaddr << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001975 << candidate.related_address().ipaddr().ToString() << " "
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001976 << kAttributeCandidateRport << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001977 << candidate.related_address().PortAsString() << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001978 }
1979
Steve Anton4daf66e2018-09-07 14:55:53 -07001980 if (candidate.protocol() == cricket::TCP_PROTOCOL_NAME) {
1981 os << kTcpCandidateType << " " << candidate.tcptype() << " ";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001982 }
1983
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001984 // Extensions
Steve Anton4daf66e2018-09-07 14:55:53 -07001985 os << kAttributeCandidateGeneration << " " << candidate.generation();
1986 if (include_ufrag && !candidate.username().empty()) {
1987 os << " " << kAttributeCandidateUfrag << " " << candidate.username();
honghaiza54a0802015-12-16 18:37:23 -08001988 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001989 if (candidate.network_id() > 0) {
1990 os << " " << kAttributeCandidateNetworkId << " "
1991 << candidate.network_id();
honghaiza0c44ea2016-03-23 16:07:48 -07001992 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001993 if (candidate.network_cost() > 0) {
1994 os << " " << kAttributeCandidateNetworkCost << " "
1995 << candidate.network_cost();
honghaize1a0c942016-02-16 14:54:56 -08001996 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001997
1998 AddLine(os.str(), message);
1999 }
2000}
2001
2002void BuildIceOptions(const std::vector<std::string>& transport_options,
2003 std::string* message) {
2004 if (!transport_options.empty()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002005 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002006 InitAttrLine(kAttributeIceOption, &os);
2007 os << kSdpDelimiterColon << transport_options[0];
2008 for (size_t i = 1; i < transport_options.size(); ++i) {
2009 os << kSdpDelimiterSpace << transport_options[i];
2010 }
2011 AddLine(os.str(), message);
2012 }
2013}
2014
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002015bool IsRtp(const std::string& protocol) {
2016 return protocol.empty() ||
Yves Gerey665174f2018-06-19 15:03:05 +02002017 (protocol.find(cricket::kMediaProtocolRtpPrefix) != std::string::npos);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002018}
2019
2020bool IsDtlsSctp(const std::string& protocol) {
2021 // This intentionally excludes "SCTP" and "SCTP/DTLS".
lally@webrtc.orga7470932015-02-24 20:19:21 +00002022 return protocol.find(cricket::kMediaProtocolDtlsSctp) != std::string::npos;
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002023}
2024
zhihuang38989e52017-03-21 11:04:53 -07002025bool ParseConnectionData(const std::string& line,
2026 rtc::SocketAddress* addr,
2027 SdpParseError* error) {
2028 // Parse the line from left to right.
2029 std::string token;
2030 std::string rightpart;
2031 // RFC 4566
2032 // c=<nettype> <addrtype> <connection-address>
2033 // Skip the "c="
Jonas Olssonec9e4922018-09-05 09:53:49 +02002034 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, &token, &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07002035 return ParseFailed(line, "Failed to parse the network type.", error);
2036 }
2037
2038 // Extract and verify the <nettype>
Jonas Olssonec9e4922018-09-05 09:53:49 +02002039 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2040 &rightpart) ||
zhihuang38989e52017-03-21 11:04:53 -07002041 token != kConnectionNettype) {
2042 return ParseFailed(line,
2043 "Failed to parse the connection data. The network type "
2044 "is not currently supported.",
2045 error);
2046 }
2047
2048 // Extract the "<addrtype>" and "<connection-address>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02002049 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2050 &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07002051 return ParseFailed(line, "Failed to parse the address type.", error);
2052 }
2053
2054 // The rightpart part should be the IP address without the slash which is used
2055 // for multicast.
2056 if (rightpart.find('/') != std::string::npos) {
2057 return ParseFailed(line,
2058 "Failed to parse the connection data. Multicast is not "
2059 "currently supported.",
2060 error);
2061 }
2062 addr->SetIP(rightpart);
2063
2064 // Verify that the addrtype matches the type of the parsed address.
2065 if ((addr->family() == AF_INET && token != "IP4") ||
2066 (addr->family() == AF_INET6 && token != "IP6")) {
2067 addr->Clear();
2068 return ParseFailed(
2069 line,
2070 "Failed to parse the connection data. The address type is mismatching.",
2071 error);
2072 }
2073 return true;
2074}
2075
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -08002076bool ParseMediaTransportLine(const std::string& line,
2077 std::string* transport_name,
2078 std::string* transport_setting,
2079 SdpParseError* error) {
2080 std::string value;
2081 if (!GetValue(line, kMediaTransportSettingLine, &value, error)) {
2082 return false;
2083 }
2084 std::string media_transport_settings_base64;
2085 if (!rtc::tokenize_first(value, kSdpDelimiterColonChar, transport_name,
2086 &media_transport_settings_base64)) {
2087 return ParseFailedGetValue(line, kMediaTransportSettingLine, error);
2088 }
2089 if (!rtc::Base64::Decode(media_transport_settings_base64,
2090 rtc::Base64::DO_STRICT, transport_setting,
2091 nullptr)) {
2092 return ParseFailedGetValue(line, kMediaTransportSettingLine, error);
2093 }
2094
2095 return true;
2096}
2097
zhihuang38989e52017-03-21 11:04:53 -07002098bool ParseSessionDescription(const std::string& message,
2099 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002100 std::string* session_id,
2101 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002102 TransportDescription* session_td,
2103 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -07002104 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002105 cricket::SessionDescription* desc,
2106 SdpParseError* error) {
2107 std::string line;
2108
deadbeefc80741f2015-10-22 13:14:45 -07002109 desc->set_msid_supported(false);
Johannes Kron9581bc42018-10-23 10:17:39 +02002110 desc->set_extmap_allow_mixed(false);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002111 // RFC 4566
2112 // v= (protocol version)
2113 if (!GetLineWithType(message, pos, &line, kLineTypeVersion)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002114 return ParseFailedExpectLine(message, *pos, kLineTypeVersion, std::string(),
2115 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002116 }
2117 // RFC 4566
2118 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
2119 // <unicast-address>
2120 if (!GetLineWithType(message, pos, &line, kLineTypeOrigin)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002121 return ParseFailedExpectLine(message, *pos, kLineTypeOrigin, std::string(),
2122 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002123 }
2124 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002125 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002126 const size_t expected_fields = 6;
2127 if (fields.size() != expected_fields) {
2128 return ParseFailedExpectFieldNum(line, expected_fields, error);
2129 }
2130 *session_id = fields[1];
2131 *session_version = fields[2];
2132
2133 // RFC 4566
2134 // s= (session name)
2135 if (!GetLineWithType(message, pos, &line, kLineTypeSessionName)) {
2136 return ParseFailedExpectLine(message, *pos, kLineTypeSessionName,
2137 std::string(), error);
2138 }
2139
Danil Chapovalov66cadcc2018-06-19 16:47:43 +02002140 // absl::optional lines
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002141 // Those are the optional lines, so shouldn't return false if not present.
2142 // RFC 4566
2143 // i=* (session information)
2144 GetLineWithType(message, pos, &line, kLineTypeSessionInfo);
2145
2146 // RFC 4566
2147 // u=* (URI of description)
2148 GetLineWithType(message, pos, &line, kLineTypeSessionUri);
2149
2150 // RFC 4566
2151 // e=* (email address)
2152 GetLineWithType(message, pos, &line, kLineTypeSessionEmail);
2153
2154 // RFC 4566
2155 // p=* (phone number)
2156 GetLineWithType(message, pos, &line, kLineTypeSessionPhone);
2157
2158 // RFC 4566
2159 // c=* (connection information -- not required if included in
2160 // all media)
zhihuang38989e52017-03-21 11:04:53 -07002161 if (GetLineWithType(message, pos, &line, kLineTypeConnection)) {
2162 if (!ParseConnectionData(line, connection_addr, error)) {
2163 return false;
2164 }
2165 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002166
2167 // RFC 4566
2168 // b=* (zero or more bandwidth information lines)
2169 while (GetLineWithType(message, pos, &line, kLineTypeSessionBandwidth)) {
2170 // By pass zero or more b lines.
2171 }
2172
2173 // RFC 4566
2174 // One or more time descriptions ("t=" and "r=" lines; see below)
2175 // t= (time the session is active)
2176 // r=* (zero or more repeat times)
2177 // Ensure there's at least one time description
2178 if (!GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2179 return ParseFailedExpectLine(message, *pos, kLineTypeTiming, std::string(),
2180 error);
2181 }
2182
2183 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2184 // By pass zero or more r lines.
2185 }
2186
2187 // Go through the rest of the time descriptions
2188 while (GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2189 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2190 // By pass zero or more r lines.
2191 }
2192 }
2193
2194 // RFC 4566
2195 // z=* (time zone adjustments)
2196 GetLineWithType(message, pos, &line, kLineTypeTimeZone);
2197
2198 // RFC 4566
2199 // k=* (encryption key)
2200 GetLineWithType(message, pos, &line, kLineTypeEncryptionKey);
2201
2202 // RFC 4566
2203 // a=* (zero or more session attribute lines)
2204 while (GetLineWithType(message, pos, &line, kLineTypeAttributes)) {
2205 if (HasAttribute(line, kAttributeGroup)) {
2206 if (!ParseGroupAttribute(line, desc, error)) {
2207 return false;
2208 }
2209 } else if (HasAttribute(line, kAttributeIceUfrag)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002210 if (!GetValue(line, kAttributeIceUfrag, &(session_td->ice_ufrag),
2211 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002212 return false;
2213 }
2214 } else if (HasAttribute(line, kAttributeIcePwd)) {
2215 if (!GetValue(line, kAttributeIcePwd, &(session_td->ice_pwd), error)) {
2216 return false;
2217 }
2218 } else if (HasAttribute(line, kAttributeIceLite)) {
2219 session_td->ice_mode = cricket::ICEMODE_LITE;
2220 } else if (HasAttribute(line, kAttributeIceOption)) {
2221 if (!ParseIceOptions(line, &(session_td->transport_options), error)) {
2222 return false;
2223 }
2224 } else if (HasAttribute(line, kAttributeFingerprint)) {
2225 if (session_td->identity_fingerprint.get()) {
2226 return ParseFailed(
2227 line,
2228 "Can't have multiple fingerprint attributes at the same level.",
2229 error);
2230 }
Steve Anton4905edb2018-10-15 19:27:44 -07002231 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002232 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2233 return false;
2234 }
Steve Anton4905edb2018-10-15 19:27:44 -07002235 session_td->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002236 } else if (HasAttribute(line, kAttributeSetup)) {
2237 if (!ParseDtlsSetup(line, &(session_td->connection_role), error)) {
2238 return false;
2239 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002240 } else if (HasAttribute(line, kAttributeMsidSemantics)) {
2241 std::string semantics;
2242 if (!GetValue(line, kAttributeMsidSemantics, &semantics, error)) {
2243 return false;
2244 }
deadbeefc80741f2015-10-22 13:14:45 -07002245 desc->set_msid_supported(
2246 CaseInsensitiveFind(semantics, kMediaStreamSemantic));
Johannes Kron0854eb62018-10-10 22:33:20 +02002247 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02002248 desc->set_extmap_allow_mixed(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002249 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002250 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002251 if (!ParseExtmap(line, &extmap, error)) {
2252 return false;
2253 }
2254 session_extmaps->push_back(extmap);
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -08002255 } else if (HasAttribute(line, kMediaTransportSettingLine)) {
2256 std::string transport_name;
2257 std::string transport_setting;
2258 if (!ParseMediaTransportLine(line, &transport_name, &transport_setting,
2259 error)) {
2260 return false;
2261 }
2262
2263 for (const auto& setting : desc->MediaTransportSettings()) {
2264 if (setting.transport_name == transport_name) {
2265 // Ignore repeated transport names rather than failing to parse so
2266 // that in the future the same transport could have multiple configs.
2267 RTC_LOG(INFO) << "x-mt line with repeated transport, transport_name="
2268 << transport_name;
2269 return true;
2270 }
2271 }
2272 desc->AddMediaTransportSetting(transport_name, transport_setting);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002273 }
2274 }
2275
2276 return true;
2277}
2278
2279bool ParseGroupAttribute(const std::string& line,
2280 cricket::SessionDescription* desc,
2281 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002282 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002283
2284 // RFC 5888 and draft-holmberg-mmusic-sdp-bundle-negotiation-00
2285 // a=group:BUNDLE video voice
2286 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002287 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002288 std::string semantics;
2289 if (!GetValue(fields[0], kAttributeGroup, &semantics, error)) {
2290 return false;
2291 }
2292 cricket::ContentGroup group(semantics);
2293 for (size_t i = 1; i < fields.size(); ++i) {
2294 group.AddContentName(fields[i]);
2295 }
2296 desc->AddGroup(group);
2297 return true;
2298}
2299
Steve Anton4905edb2018-10-15 19:27:44 -07002300static bool ParseFingerprintAttribute(
2301 const std::string& line,
2302 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
2303 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002304 if (!IsLineType(line, kLineTypeAttributes) ||
2305 !HasAttribute(line, kAttributeFingerprint)) {
2306 return ParseFailedExpectLine(line, 0, kLineTypeAttributes,
2307 kAttributeFingerprint, error);
2308 }
2309
2310 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002311 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002312 const size_t expected_fields = 2;
2313 if (fields.size() != expected_fields) {
2314 return ParseFailedExpectFieldNum(line, expected_fields, error);
2315 }
2316
2317 // The first field here is "fingerprint:<hash>.
2318 std::string algorithm;
2319 if (!GetValue(fields[0], kAttributeFingerprint, &algorithm, error)) {
2320 return false;
2321 }
2322
2323 // Downcase the algorithm. Note that we don't need to downcase the
2324 // fingerprint because hex_decode can handle upper-case.
Steve Anton64b626b2019-01-28 17:25:26 -08002325 absl::c_transform(algorithm, algorithm.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002326
2327 // The second field is the digest value. De-hexify it.
Steve Anton4905edb2018-10-15 19:27:44 -07002328 *fingerprint =
2329 rtc::SSLFingerprint::CreateUniqueFromRfc4572(algorithm, fields[1]);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002330 if (!*fingerprint) {
Yves Gerey665174f2018-06-19 15:03:05 +02002331 return ParseFailed(line, "Failed to create fingerprint from the digest.",
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002332 error);
2333 }
2334
2335 return true;
2336}
2337
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002338static bool ParseDtlsSetup(const std::string& line,
2339 cricket::ConnectionRole* role,
2340 SdpParseError* error) {
2341 // setup-attr = "a=setup:" role
2342 // role = "active" / "passive" / "actpass" / "holdconn"
2343 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002344 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002345 const size_t expected_fields = 2;
2346 if (fields.size() != expected_fields) {
2347 return ParseFailedExpectFieldNum(line, expected_fields, error);
2348 }
2349 std::string role_str = fields[1];
2350 if (!cricket::StringToConnectionRole(role_str, role)) {
2351 return ParseFailed(line, "Invalid attribute value.", error);
2352 }
2353 return true;
2354}
2355
deadbeef9d3584c2016-02-16 17:54:10 -08002356static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -07002357 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -08002358 std::string* track_id,
2359 SdpParseError* error) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002360 // https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
deadbeef9d3584c2016-02-16 17:54:10 -08002361 // a=msid:<stream id> <track id>
2362 // msid-value = msid-id [ SP msid-appdata ]
2363 // msid-id = 1*64token-char ; see RFC 4566
2364 // msid-appdata = 1*64token-char ; see RFC 4566
2365 std::string field1;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002366 std::string new_stream_id;
2367 std::string new_track_id;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002368 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
2369 kSdpDelimiterSpaceChar, &field1, &new_track_id)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002370 const size_t expected_fields = 2;
2371 return ParseFailedExpectFieldNum(line, expected_fields, error);
2372 }
2373
Seth Hampson5b4f0752018-04-02 16:31:36 -07002374 if (new_track_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002375 return ParseFailed(line, "Missing track ID in msid attribute.", error);
2376 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002377 // All track ids should be the same within an m section in a Unified Plan SDP.
2378 if (!track_id->empty() && new_track_id.compare(*track_id) != 0) {
2379 return ParseFailed(
2380 line, "Two different track IDs in msid attribute in one m= section",
2381 error);
2382 }
2383 *track_id = new_track_id;
deadbeefa4549d62017-02-10 17:26:22 -08002384
deadbeef9d3584c2016-02-16 17:54:10 -08002385 // msid:<msid-id>
Seth Hampson5b4f0752018-04-02 16:31:36 -07002386 if (!GetValue(field1, kAttributeMsid, &new_stream_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002387 return false;
2388 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002389 if (new_stream_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002390 return ParseFailed(line, "Missing stream ID in msid attribute.", error);
2391 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002392 // The special value "-" indicates "no MediaStream".
2393 if (new_stream_id.compare(kNoStreamMsid) != 0) {
2394 stream_ids->push_back(new_stream_id);
2395 }
deadbeef9d3584c2016-02-16 17:54:10 -08002396 return true;
2397}
2398
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002399static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
2400 std::vector<RidDescription>* rids) {
2401 RTC_DCHECK(rids);
2402 std::set<std::string> to_remove;
2403 std::set<std::string> unique_rids;
2404
2405 // Check the rids to see which ones should be removed.
2406 for (RidDescription& rid : *rids) {
2407 // In the case of a duplicate, the entire "a=rid" line, and all "a=rid"
2408 // lines with rid-ids that duplicate this line, are discarded and MUST NOT
2409 // be included in the SDP Answer.
2410 auto pair = unique_rids.insert(rid.rid);
2411 // Insert will "fail" if element already exists.
2412 if (!pair.second) {
2413 to_remove.insert(rid.rid);
2414 continue;
2415 }
2416
2417 // If the "a=rid" line contains a "pt=", the list of payload types
2418 // is verified against the list of valid payload types for the media
2419 // section (that is, those listed on the "m=" line). Any PT missing
2420 // from the "m=" line is discarded from the set of values in the
2421 // "pt=". If no values are left in the "pt=" parameter after this
2422 // processing, then the "a=rid" line is discarded.
2423 if (rid.payload_types.empty()) {
2424 // If formats were not specified, rid should not be removed.
2425 continue;
2426 }
2427
2428 // Note: Spec does not mention how to handle duplicate formats.
2429 // Media section does not handle duplicates either.
2430 std::set<int> removed_formats;
2431 for (int payload_type : rid.payload_types) {
Steve Anton64b626b2019-01-28 17:25:26 -08002432 if (!absl::c_linear_search(payload_types, payload_type)) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002433 removed_formats.insert(payload_type);
2434 }
2435 }
2436
2437 rid.payload_types.erase(
2438 std::remove_if(rid.payload_types.begin(), rid.payload_types.end(),
2439 [&removed_formats](int format) {
2440 return removed_formats.count(format) > 0;
2441 }),
2442 rid.payload_types.end());
2443
2444 // If all formats were removed then remove the rid alogether.
2445 if (rid.payload_types.empty()) {
2446 to_remove.insert(rid.rid);
2447 }
2448 }
2449
2450 // Remove every rid description that appears in the to_remove list.
2451 if (!to_remove.empty()) {
2452 rids->erase(std::remove_if(rids->begin(), rids->end(),
2453 [&to_remove](const RidDescription& rid) {
2454 return to_remove.count(rid.rid) > 0;
2455 }),
2456 rids->end());
2457 }
2458}
2459
2460// Create a new list (because SimulcastLayerList is immutable) without any
2461// layers that have a rid in the to_remove list.
2462// If a group of alternatives is empty after removing layers, the group should
2463// be removed altogether.
2464static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
2465 const std::set<std::string>& to_remove,
2466 const SimulcastLayerList& layers) {
2467 SimulcastLayerList result;
2468 for (const std::vector<SimulcastLayer>& vector : layers) {
2469 std::vector<SimulcastLayer> new_layers;
2470 for (const SimulcastLayer& layer : vector) {
2471 if (to_remove.find(layer.rid) == to_remove.end()) {
2472 new_layers.push_back(layer);
2473 }
2474 }
2475 // If all layers were removed, do not add an entry.
2476 if (!new_layers.empty()) {
2477 result.AddLayerWithAlternatives(new_layers);
2478 }
2479 }
2480
2481 return result;
2482}
2483
2484// Will remove Simulcast Layers if:
2485// 1. They appear in both send and receive directions.
2486// 2. They do not appear in the list of |valid_rids|.
2487static void RemoveInvalidRidsFromSimulcast(
2488 const std::vector<RidDescription>& valid_rids,
2489 SimulcastDescription* simulcast) {
2490 RTC_DCHECK(simulcast);
2491 std::set<std::string> to_remove;
2492 std::vector<SimulcastLayer> all_send_layers =
2493 simulcast->send_layers().GetAllLayers();
2494 std::vector<SimulcastLayer> all_receive_layers =
2495 simulcast->receive_layers().GetAllLayers();
2496
2497 // If a rid appears in both send and receive directions, remove it from both.
2498 // This algorithm runs in O(n^2) time, but for small n (as is the case with
2499 // simulcast layers) it should still perform well.
2500 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002501 if (absl::c_any_of(all_receive_layers,
2502 [&send_layer](const SimulcastLayer& layer) {
2503 return layer.rid == send_layer.rid;
2504 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002505 to_remove.insert(send_layer.rid);
2506 }
2507 }
2508
2509 // Add any rid that is not in the valid list to the remove set.
2510 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002511 if (absl::c_none_of(valid_rids, [&send_layer](const RidDescription& rid) {
2512 return send_layer.rid == rid.rid;
2513 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002514 to_remove.insert(send_layer.rid);
2515 }
2516 }
2517
2518 // Add any rid that is not in the valid list to the remove set.
2519 for (const SimulcastLayer& receive_layer : all_receive_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002520 if (absl::c_none_of(valid_rids,
2521 [&receive_layer](const RidDescription& rid) {
2522 return receive_layer.rid == rid.rid;
2523 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002524 to_remove.insert(receive_layer.rid);
2525 }
2526 }
2527
2528 simulcast->send_layers() =
2529 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->send_layers());
2530 simulcast->receive_layers() =
2531 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->receive_layers());
2532}
2533
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002534// RFC 3551
2535// PT encoding media type clock rate channels
2536// name (Hz)
2537// 0 PCMU A 8,000 1
2538// 1 reserved A
2539// 2 reserved A
2540// 3 GSM A 8,000 1
2541// 4 G723 A 8,000 1
2542// 5 DVI4 A 8,000 1
2543// 6 DVI4 A 16,000 1
2544// 7 LPC A 8,000 1
2545// 8 PCMA A 8,000 1
2546// 9 G722 A 8,000 1
2547// 10 L16 A 44,100 2
2548// 11 L16 A 44,100 1
2549// 12 QCELP A 8,000 1
2550// 13 CN A 8,000 1
2551// 14 MPA A 90,000 (see text)
2552// 15 G728 A 8,000 1
2553// 16 DVI4 A 11,025 1
2554// 17 DVI4 A 22,050 1
2555// 18 G729 A 8,000 1
2556struct StaticPayloadAudioCodec {
2557 const char* name;
2558 int clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002559 size_t channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002560};
2561static const StaticPayloadAudioCodec kStaticPayloadAudioCodecs[] = {
Yves Gerey665174f2018-06-19 15:03:05 +02002562 {"PCMU", 8000, 1}, {"reserved", 0, 0}, {"reserved", 0, 0},
2563 {"GSM", 8000, 1}, {"G723", 8000, 1}, {"DVI4", 8000, 1},
2564 {"DVI4", 16000, 1}, {"LPC", 8000, 1}, {"PCMA", 8000, 1},
2565 {"G722", 8000, 1}, {"L16", 44100, 2}, {"L16", 44100, 1},
2566 {"QCELP", 8000, 1}, {"CN", 8000, 1}, {"MPA", 90000, 1},
2567 {"G728", 8000, 1}, {"DVI4", 11025, 1}, {"DVI4", 22050, 1},
2568 {"G729", 8000, 1},
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002569};
2570
Yves Gerey665174f2018-06-19 15:03:05 +02002571void MaybeCreateStaticPayloadAudioCodecs(const std::vector<int>& fmts,
2572 AudioContentDescription* media_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002573 if (!media_desc) {
2574 return;
2575 }
deadbeef67cf2c12016-04-13 10:07:16 -07002576 RTC_DCHECK(media_desc->codecs().empty());
solenberg9fa49752016-10-08 13:02:44 -07002577 for (int payload_type : fmts) {
Yves Gerey665174f2018-06-19 15:03:05 +02002578 if (!media_desc->HasCodec(payload_type) && payload_type >= 0 &&
kjellander3e33bfe2016-06-20 07:04:09 -07002579 static_cast<uint32_t>(payload_type) <
2580 arraysize(kStaticPayloadAudioCodecs)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002581 std::string encoding_name = kStaticPayloadAudioCodecs[payload_type].name;
2582 int clock_rate = kStaticPayloadAudioCodecs[payload_type].clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002583 size_t channels = kStaticPayloadAudioCodecs[payload_type].channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002584 media_desc->AddCodec(cricket::AudioCodec(payload_type, encoding_name,
deadbeef67cf2c12016-04-13 10:07:16 -07002585 clock_rate, 0, channels));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002586 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002587 }
2588}
2589
2590template <class C>
Steve Anton5a1de872018-12-18 11:25:55 -08002591static std::unique_ptr<C> ParseContentDescription(
2592 const std::string& message,
2593 const cricket::MediaType media_type,
2594 int mline_index,
2595 const std::string& protocol,
2596 const std::vector<int>& payload_types,
2597 size_t* pos,
2598 std::string* content_name,
2599 bool* bundle_only,
2600 int* msid_signaling,
2601 TransportDescription* transport,
2602 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2603 webrtc::SdpParseError* error) {
2604 auto media_desc = absl::make_unique<C>();
deadbeef67cf2c12016-04-13 10:07:16 -07002605 if (!ParseContent(message, media_type, mline_index, protocol, payload_types,
Steve Anton5a1de872018-12-18 11:25:55 -08002606 pos, content_name, bundle_only, msid_signaling,
2607 media_desc.get(), transport, candidates, error)) {
zhihuang38989e52017-03-21 11:04:53 -07002608 return nullptr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002609 }
2610 // Sort the codecs according to the m-line fmt list.
deadbeef67cf2c12016-04-13 10:07:16 -07002611 std::unordered_map<int, int> payload_type_preferences;
2612 // "size + 1" so that the lowest preference payload type has a preference of
2613 // 1, which is greater than the default (0) for payload types not in the fmt
2614 // list.
2615 int preference = static_cast<int>(payload_types.size() + 1);
2616 for (int pt : payload_types) {
2617 payload_type_preferences[pt] = preference--;
2618 }
2619 std::vector<typename C::CodecType> codecs = media_desc->codecs();
Steve Anton64b626b2019-01-28 17:25:26 -08002620 absl::c_sort(
2621 codecs, [&payload_type_preferences](const typename C::CodecType& a,
2622 const typename C::CodecType& b) {
2623 return payload_type_preferences[a.id] > payload_type_preferences[b.id];
2624 });
deadbeef67cf2c12016-04-13 10:07:16 -07002625 media_desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002626 return media_desc;
2627}
2628
Steve Anton5a1de872018-12-18 11:25:55 -08002629bool ParseMediaDescription(
2630 const std::string& message,
2631 const TransportDescription& session_td,
2632 const RtpHeaderExtensions& session_extmaps,
2633 size_t* pos,
2634 const rtc::SocketAddress& session_connection_addr,
2635 cricket::SessionDescription* desc,
2636 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2637 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002638 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002639 std::string line;
2640 int mline_index = -1;
Steve Antone831b8c2018-02-01 12:22:16 -08002641 int msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002642
2643 // Zero or more media descriptions
2644 // RFC 4566
2645 // m=<media> <port> <proto> <fmt>
2646 while (GetLineWithType(message, pos, &line, kLineTypeMedia)) {
2647 ++mline_index;
2648
2649 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002650 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
zstein4b2e0822017-02-17 19:48:38 -08002651
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002652 const size_t expected_min_fields = 4;
2653 if (fields.size() < expected_min_fields) {
2654 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
2655 }
deadbeef25ed4352016-12-12 18:37:36 -08002656 bool port_rejected = false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002657 // RFC 3264
2658 // To reject an offered stream, the port number in the corresponding stream
2659 // in the answer MUST be set to zero.
2660 if (fields[1] == kMediaPortRejected) {
deadbeef25ed4352016-12-12 18:37:36 -08002661 port_rejected = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002662 }
2663
zhihuang38989e52017-03-21 11:04:53 -07002664 int port = 0;
2665 if (!rtc::FromString<int>(fields[1], &port) || !IsValidPort(port)) {
2666 return ParseFailed(line, "The port number is invalid", error);
2667 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002668 std::string protocol = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002669
2670 // <fmt>
deadbeef67cf2c12016-04-13 10:07:16 -07002671 std::vector<int> payload_types;
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002672 if (IsRtp(protocol)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002673 for (size_t j = 3; j < fields.size(); ++j) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002674 // TODO(wu): Remove when below bug is fixed.
2675 // https://bugzilla.mozilla.org/show_bug.cgi?id=996329
pbosbb36fdf2015-07-09 07:48:14 -07002676 if (fields[j].empty() && j == fields.size() - 1) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002677 continue;
2678 }
wu@webrtc.org36eda7c2014-04-15 20:37:30 +00002679
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002680 int pl = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00002681 if (!GetPayloadTypeFromString(line, fields[j], &pl, error)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002682 return false;
2683 }
deadbeef67cf2c12016-04-13 10:07:16 -07002684 payload_types.push_back(pl);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002685 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002686 }
2687
2688 // Make a temporary TransportDescription based on |session_td|.
2689 // Some of this gets overwritten by ParseContent.
deadbeef46eed762016-01-28 13:24:37 -08002690 TransportDescription transport(
2691 session_td.transport_options, session_td.ice_ufrag, session_td.ice_pwd,
2692 session_td.ice_mode, session_td.connection_role,
2693 session_td.identity_fingerprint.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002694
kwibergd1fe2812016-04-27 06:47:29 -07002695 std::unique_ptr<MediaContentDescription> content;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002696 std::string content_name;
deadbeef25ed4352016-12-12 18:37:36 -08002697 bool bundle_only = false;
Steve Antone831b8c2018-02-01 12:22:16 -08002698 int section_msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002699 if (HasAttribute(line, kMediaTypeVideo)) {
Steve Anton5a1de872018-12-18 11:25:55 -08002700 content = ParseContentDescription<VideoContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002701 message, cricket::MEDIA_TYPE_VIDEO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002702 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 11:25:55 -08002703 &section_msid_signaling, &transport, candidates, error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002704 } else if (HasAttribute(line, kMediaTypeAudio)) {
Steve Anton5a1de872018-12-18 11:25:55 -08002705 content = ParseContentDescription<AudioContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002706 message, cricket::MEDIA_TYPE_AUDIO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002707 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 11:25:55 -08002708 &section_msid_signaling, &transport, candidates, error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002709 } else if (HasAttribute(line, kMediaTypeData)) {
Harald Alvestrand14b27582019-05-04 11:37:04 +02002710 if (IsDtlsSctp(protocol)) {
2711 // The draft-03 format is:
2712 // m=application <port> DTLS/SCTP <sctp-port>...
2713 // use_sctpmap should be false.
2714 // The draft-26 format is:
2715 // m=application <port> UDP/DTLS/SCTP webrtc-datachannel
2716 // use_sctpmap should be false.
2717 auto data_desc = absl::make_unique<SctpDataContentDescription>();
zstein4b2e0822017-02-17 19:48:38 -08002718 int p;
2719 if (rtc::FromString(fields[3], &p)) {
Harald Alvestrand14b27582019-05-04 11:37:04 +02002720 data_desc->set_port(p);
zstein4b2e0822017-02-17 19:48:38 -08002721 } else if (fields[3] == kDefaultSctpmapProtocol) {
2722 data_desc->set_use_sctpmap(false);
2723 }
Harald Alvestrand14b27582019-05-04 11:37:04 +02002724 if (!ParseContent(message, cricket::MEDIA_TYPE_DATA, mline_index,
2725 protocol, payload_types, pos, &content_name,
2726 &bundle_only, &section_msid_signaling,
2727 data_desc.get(), &transport, candidates, error)) {
2728 return false;
2729 }
2730 content = std::move(data_desc);
2731 } else {
2732 // RTP
2733 std::unique_ptr<RtpDataContentDescription> data_desc =
2734 ParseContentDescription<RtpDataContentDescription>(
2735 message, cricket::MEDIA_TYPE_DATA, mline_index, protocol,
2736 payload_types, pos, &content_name, &bundle_only,
2737 &section_msid_signaling, &transport, candidates, error);
2738 content = std::move(data_desc);
wu@webrtc.org78187522013-10-07 23:32:02 +00002739 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002740 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002741 RTC_LOG(LS_WARNING) << "Unsupported media type: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002742 continue;
2743 }
2744 if (!content.get()) {
2745 // ParseContentDescription returns NULL if failed.
2746 return false;
2747 }
2748
Steve Antone831b8c2018-02-01 12:22:16 -08002749 msid_signaling |= section_msid_signaling;
2750
deadbeef25ed4352016-12-12 18:37:36 -08002751 bool content_rejected = false;
deadbeef12771a12017-01-03 13:53:47 -08002752 // A port of 0 is not interpreted as a rejected m= section when it's
2753 // used along with a=bundle-only.
deadbeef25ed4352016-12-12 18:37:36 -08002754 if (bundle_only) {
deadbeef25ed4352016-12-12 18:37:36 -08002755 if (!port_rejected) {
deadbeef12771a12017-01-03 13:53:47 -08002756 // Usage of bundle-only with a nonzero port is unspecified. So just
2757 // ignore bundle-only if we see this.
2758 bundle_only = false;
Mirko Bonadei675513b2017-11-09 11:09:25 +01002759 RTC_LOG(LS_WARNING)
deadbeef12771a12017-01-03 13:53:47 -08002760 << "a=bundle-only attribute observed with a nonzero "
Jonas Olsson45cc8902018-02-13 10:37:07 +01002761 "port; this usage is unspecified so the attribute is being "
2762 "ignored.";
deadbeef25ed4352016-12-12 18:37:36 -08002763 }
2764 } else {
2765 // If not using bundle-only, interpret port 0 in the normal way; the m=
2766 // section is being rejected.
2767 content_rejected = port_rejected;
2768 }
2769
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002770 if (IsRtp(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002771 // Set the extmap.
2772 if (!session_extmaps.empty() &&
2773 !content->rtp_header_extensions().empty()) {
2774 return ParseFailed("",
2775 "The a=extmap MUST be either all session level or "
2776 "all media level.",
2777 error);
2778 }
2779 for (size_t i = 0; i < session_extmaps.size(); ++i) {
2780 content->AddRtpHeaderExtension(session_extmaps[i]);
2781 }
2782 }
2783 content->set_protocol(protocol);
zhihuang38989e52017-03-21 11:04:53 -07002784
2785 // Use the session level connection address if the media level addresses are
2786 // not specified.
2787 rtc::SocketAddress address;
2788 address = content->connection_address().IsNil()
2789 ? session_connection_addr
2790 : content->connection_address();
2791 address.SetPort(port);
2792 content->set_connection_address(address);
2793
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002794 desc->AddContent(content_name,
Steve Anton5adfafd2017-12-20 16:34:00 -08002795 IsDtlsSctp(protocol) ? MediaProtocolType::kSctp
2796 : MediaProtocolType::kRtp,
deadbeef25ed4352016-12-12 18:37:36 -08002797 content_rejected, bundle_only, content.release());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002798 // Create TransportInfo with the media level "ice-pwd" and "ice-ufrag".
Steve Anton06817cd2018-12-18 15:55:30 -08002799 desc->AddTransportInfo(TransportInfo(content_name, transport));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002800 }
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002801
Steve Antone831b8c2018-02-01 12:22:16 -08002802 desc->set_msid_signaling(msid_signaling);
2803
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002804 size_t end_of_message = message.size();
2805 if (mline_index == -1 && *pos != end_of_message) {
2806 ParseFailed(message, *pos, "Expects m line.", error);
2807 return false;
2808 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002809 return true;
2810}
2811
2812bool VerifyCodec(const cricket::Codec& codec) {
2813 // Codec has not been populated correctly unless the name has been set. This
2814 // can happen if an SDP has an fmtp or rtcp-fb with a payload type but doesn't
2815 // have a corresponding "rtpmap" line.
htab39db842016-12-08 01:50:48 -08002816 return !codec.name.empty();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002817}
2818
2819bool VerifyAudioCodecs(const AudioContentDescription* audio_desc) {
Steve Anton64b626b2019-01-28 17:25:26 -08002820 return absl::c_all_of(audio_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002821}
2822
2823bool VerifyVideoCodecs(const VideoContentDescription* video_desc) {
Steve Anton64b626b2019-01-28 17:25:26 -08002824 return absl::c_all_of(video_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002825}
2826
2827void AddParameters(const cricket::CodecParameterMap& parameters,
2828 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002829 for (const auto& entry : parameters) {
2830 const std::string& key = entry.first;
2831 const std::string& value = entry.second;
2832 codec->SetParam(key, value);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002833 }
2834}
2835
2836void AddFeedbackParameter(const cricket::FeedbackParam& feedback_param,
2837 cricket::Codec* codec) {
2838 codec->AddFeedbackParam(feedback_param);
2839}
2840
2841void AddFeedbackParameters(const cricket::FeedbackParams& feedback_params,
2842 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002843 for (const cricket::FeedbackParam& param : feedback_params.params()) {
2844 codec->AddFeedbackParam(param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002845 }
2846}
2847
2848// Gets the current codec setting associated with |payload_type|. If there
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002849// is no Codec associated with that payload type it returns an empty codec
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002850// with that payload type.
2851template <class T>
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002852T GetCodecWithPayloadType(const std::vector<T>& codecs, int payload_type) {
magjedb05fa242016-11-11 04:00:16 -08002853 const T* codec = FindCodecById(codecs, payload_type);
2854 if (codec)
2855 return *codec;
2856 // Return empty codec with |payload_type|.
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002857 T ret_val;
magjedb05fa242016-11-11 04:00:16 -08002858 ret_val.id = payload_type;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002859 return ret_val;
2860}
2861
2862// Updates or creates a new codec entry in the audio description.
2863template <class T, class U>
2864void AddOrReplaceCodec(MediaContentDescription* content_desc, const U& codec) {
2865 T* desc = static_cast<T*>(content_desc);
2866 std::vector<U> codecs = desc->codecs();
2867 bool found = false;
Steve Anton4daf66e2018-09-07 14:55:53 -07002868 for (U& existing_codec : codecs) {
2869 if (codec.id == existing_codec.id) {
2870 // Overwrite existing codec with the new codec.
2871 existing_codec = codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002872 found = true;
2873 break;
2874 }
2875 }
2876 if (!found) {
2877 desc->AddCodec(codec);
2878 return;
2879 }
2880 desc->set_codecs(codecs);
2881}
2882
2883// Adds or updates existing codec corresponding to |payload_type| according
2884// to |parameters|.
2885template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002886void UpdateCodec(MediaContentDescription* content_desc,
2887 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002888 const cricket::CodecParameterMap& parameters) {
2889 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002890 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2891 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002892 AddParameters(parameters, &new_codec);
2893 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2894}
2895
2896// Adds or updates existing codec corresponding to |payload_type| according
2897// to |feedback_param|.
2898template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002899void UpdateCodec(MediaContentDescription* content_desc,
2900 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002901 const cricket::FeedbackParam& feedback_param) {
2902 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002903 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2904 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002905 AddFeedbackParameter(feedback_param, &new_codec);
2906 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2907}
2908
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002909template <class T>
2910bool PopWildcardCodec(std::vector<T>* codecs, T* wildcard_codec) {
2911 for (auto iter = codecs->begin(); iter != codecs->end(); ++iter) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002912 if (iter->id == kWildcardPayloadType) {
2913 *wildcard_codec = *iter;
2914 codecs->erase(iter);
2915 return true;
2916 }
2917 }
2918 return false;
2919}
2920
Yves Gerey665174f2018-06-19 15:03:05 +02002921template <class T>
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002922void UpdateFromWildcardCodecs(cricket::MediaContentDescriptionImpl<T>* desc) {
2923 auto codecs = desc->codecs();
2924 T wildcard_codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002925 if (!PopWildcardCodec(&codecs, &wildcard_codec)) {
2926 return;
2927 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002928 for (auto& codec : codecs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002929 AddFeedbackParameters(wildcard_codec.feedback_params, &codec);
2930 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002931 desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002932}
2933
Yves Gerey665174f2018-06-19 15:03:05 +02002934void AddAudioAttribute(const std::string& name,
2935 const std::string& value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002936 AudioContentDescription* audio_desc) {
2937 if (value.empty()) {
2938 return;
2939 }
2940 std::vector<cricket::AudioCodec> codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002941 for (cricket::AudioCodec& codec : codecs) {
2942 codec.params[name] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002943 }
2944 audio_desc->set_codecs(codecs);
2945}
2946
2947bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002948 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002949 int mline_index,
2950 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002951 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002952 size_t* pos,
2953 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002954 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002955 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002956 MediaContentDescription* media_desc,
2957 TransportDescription* transport,
Steve Anton5a1de872018-12-18 11:25:55 -08002958 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002959 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002960 RTC_DCHECK(media_desc != NULL);
2961 RTC_DCHECK(content_name != NULL);
2962 RTC_DCHECK(transport != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002963
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002964 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002965 MaybeCreateStaticPayloadAudioCodecs(payload_types, media_desc->as_audio());
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002966 }
2967
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002968 // The media level "ice-ufrag" and "ice-pwd".
2969 // The candidates before update the media level "ice-pwd" and "ice-ufrag".
2970 Candidates candidates_orig;
2971 std::string line;
2972 std::string mline_id;
2973 // Tracks created out of the ssrc attributes.
2974 StreamParamsVec tracks;
2975 SsrcInfoVec ssrc_infos;
2976 SsrcGroupVec ssrc_groups;
2977 std::string maxptime_as_string;
2978 std::string ptime_as_string;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002979 std::vector<std::string> stream_ids;
deadbeef9d3584c2016-02-16 17:54:10 -08002980 std::string track_id;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002981 SdpSerializer deserializer;
2982 std::vector<RidDescription> rids;
Amit Hilbucha2012042018-12-03 11:35:05 -08002983 SimulcastDescription simulcast;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002984
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002985 // Loop until the next m line
2986 while (!IsLineType(message, kLineTypeMedia, *pos)) {
2987 if (!GetLine(message, pos, &line)) {
2988 if (*pos >= message.size()) {
2989 break; // Done parsing
2990 } else {
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +00002991 return ParseFailed(message, *pos, "Invalid SDP line.", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002992 }
2993 }
2994
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002995 // RFC 4566
2996 // b=* (zero or more bandwidth information lines)
2997 if (IsLineType(line, kLineTypeSessionBandwidth)) {
2998 std::string bandwidth;
2999 if (HasAttribute(line, kApplicationSpecificMaximum)) {
3000 if (!GetValue(line, kApplicationSpecificMaximum, &bandwidth, error)) {
3001 return false;
3002 } else {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003003 int b = 0;
3004 if (!GetValueFromString(line, bandwidth, &b, error)) {
3005 return false;
3006 }
deadbeef3e8016e2017-08-03 17:49:30 -07003007 // TODO(deadbeef): Historically, applications may be setting a value
3008 // of -1 to mean "unset any previously set bandwidth limit", even
3009 // though ommitting the "b=AS" entirely will do just that. Once we've
3010 // transitioned applications to doing the right thing, it would be
3011 // better to treat this as a hard error instead of just ignoring it.
3012 if (b == -1) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003013 RTC_LOG(LS_WARNING)
3014 << "Ignoring \"b=AS:-1\"; will be treated as \"no "
3015 "bandwidth limit\".";
deadbeef3e8016e2017-08-03 17:49:30 -07003016 continue;
3017 }
deadbeefbc88c6b2017-08-02 11:26:34 -07003018 if (b < 0) {
3019 return ParseFailed(line, "b=AS value can't be negative.", error);
3020 }
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003021 // We should never use more than the default bandwidth for RTP-based
3022 // data channels. Don't allow SDP to set the bandwidth, because
3023 // that would give JS the opportunity to "break the Internet".
3024 // See: https://code.google.com/p/chromium/issues/detail?id=280726
3025 if (media_type == cricket::MEDIA_TYPE_DATA && IsRtp(protocol) &&
3026 b > cricket::kDataMaxBandwidth / 1000) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003027 rtc::StringBuilder description;
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003028 description << "RTP-based data channels may not send more than "
3029 << cricket::kDataMaxBandwidth / 1000 << "kbps.";
3030 return ParseFailed(line, description.str(), error);
3031 }
deadbeefb2362572016-12-13 16:37:06 -08003032 // Prevent integer overflow.
3033 b = std::min(b, INT_MAX / 1000);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003034 media_desc->set_bandwidth(b * 1000);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003035 }
3036 }
3037 continue;
3038 }
3039
zhihuang38989e52017-03-21 11:04:53 -07003040 // Parse the media level connection data.
3041 if (IsLineType(line, kLineTypeConnection)) {
3042 rtc::SocketAddress addr;
3043 if (!ParseConnectionData(line, &addr, error)) {
3044 return false;
3045 }
3046 media_desc->set_connection_address(addr);
3047 continue;
3048 }
3049
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003050 if (!IsLineType(line, kLineTypeAttributes)) {
Steve Anton36b29d12017-10-30 09:57:42 -07003051 // TODO(deadbeef): Handle other lines if needed.
Mirko Bonadei675513b2017-11-09 11:09:25 +01003052 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003053 continue;
3054 }
3055
3056 // Handle attributes common to SCTP and RTP.
3057 if (HasAttribute(line, kAttributeMid)) {
3058 // RFC 3388
3059 // mid-attribute = "a=mid:" identification-tag
3060 // identification-tag = token
3061 // Use the mid identification-tag as the content name.
3062 if (!GetValue(line, kAttributeMid, &mline_id, error)) {
3063 return false;
3064 }
3065 *content_name = mline_id;
deadbeef25ed4352016-12-12 18:37:36 -08003066 } else if (HasAttribute(line, kAttributeBundleOnly)) {
3067 *bundle_only = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003068 } else if (HasAttribute(line, kAttributeCandidate)) {
3069 Candidate candidate;
3070 if (!ParseCandidate(line, &candidate, error, false)) {
3071 return false;
3072 }
deadbeef7bcdb692017-01-20 12:43:58 -08003073 // ParseCandidate will parse non-standard ufrag and password attributes,
3074 // since it's used for candidate trickling, but we only want to process
3075 // the "a=ice-ufrag"/"a=ice-pwd" values in a session description, so
3076 // strip them off at this point.
3077 candidate.set_username(std::string());
3078 candidate.set_password(std::string());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003079 candidates_orig.push_back(candidate);
3080 } else if (HasAttribute(line, kAttributeIceUfrag)) {
3081 if (!GetValue(line, kAttributeIceUfrag, &transport->ice_ufrag, error)) {
3082 return false;
3083 }
3084 } else if (HasAttribute(line, kAttributeIcePwd)) {
3085 if (!GetValue(line, kAttributeIcePwd, &transport->ice_pwd, error)) {
3086 return false;
3087 }
3088 } else if (HasAttribute(line, kAttributeIceOption)) {
3089 if (!ParseIceOptions(line, &transport->transport_options, error)) {
3090 return false;
3091 }
3092 } else if (HasAttribute(line, kAttributeFmtp)) {
3093 if (!ParseFmtpAttributes(line, media_type, media_desc, error)) {
3094 return false;
3095 }
3096 } else if (HasAttribute(line, kAttributeFingerprint)) {
Steve Anton4905edb2018-10-15 19:27:44 -07003097 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003098 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
3099 return false;
3100 }
Steve Anton4905edb2018-10-15 19:27:44 -07003101 transport->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00003102 } else if (HasAttribute(line, kAttributeSetup)) {
3103 if (!ParseDtlsSetup(line, &(transport->connection_role), error)) {
3104 return false;
3105 }
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00003106 } else if (IsDtlsSctp(protocol) && HasAttribute(line, kAttributeSctpPort)) {
deadbeef7e146cb2016-09-28 10:04:34 -07003107 if (media_type != cricket::MEDIA_TYPE_DATA) {
3108 return ParseFailed(
3109 line, "sctp-port attribute found in non-data media description.",
3110 error);
3111 }
Harald Alvestrand14b27582019-05-04 11:37:04 +02003112 if (media_desc->as_sctp()->use_sctpmap()) {
3113 return ParseFailed(
3114 line, "sctp-port attribute can't be used with sctpmap.", error);
3115 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00003116 int sctp_port;
3117 if (!ParseSctpPort(line, &sctp_port, error)) {
3118 return false;
3119 }
Harald Alvestrand14b27582019-05-04 11:37:04 +02003120 media_desc->as_sctp()->set_port(sctp_port);
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02003121 } else if (IsDtlsSctp(protocol) &&
3122 HasAttribute(line, kAttributeMaxMessageSize)) {
3123 if (media_type != cricket::MEDIA_TYPE_DATA) {
3124 return ParseFailed(
3125 line,
3126 "max-message-size attribute found in non-data media description.",
3127 error);
3128 }
3129 int max_message_size;
3130 if (!ParseSctpMaxMessageSize(line, &max_message_size, error)) {
3131 return false;
3132 }
Harald Alvestrand14b27582019-05-04 11:37:04 +02003133 media_desc->as_sctp()->set_max_message_size(max_message_size);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00003134 } else if (IsRtp(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003135 //
3136 // RTP specific attrubtes
3137 //
3138 if (HasAttribute(line, kAttributeRtcpMux)) {
3139 media_desc->set_rtcp_mux(true);
deadbeef13871492015-12-09 12:37:51 -08003140 } else if (HasAttribute(line, kAttributeRtcpReducedSize)) {
3141 media_desc->set_rtcp_reduced_size(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003142 } else if (HasAttribute(line, kAttributeSsrcGroup)) {
3143 if (!ParseSsrcGroupAttribute(line, &ssrc_groups, error)) {
3144 return false;
3145 }
3146 } else if (HasAttribute(line, kAttributeSsrc)) {
Steve Antone831b8c2018-02-01 12:22:16 -08003147 if (!ParseSsrcAttribute(line, &ssrc_infos, msid_signaling, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003148 return false;
3149 }
3150 } else if (HasAttribute(line, kAttributeCrypto)) {
3151 if (!ParseCryptoAttribute(line, media_desc, error)) {
3152 return false;
3153 }
3154 } else if (HasAttribute(line, kAttributeRtpmap)) {
deadbeef67cf2c12016-04-13 10:07:16 -07003155 if (!ParseRtpmapAttribute(line, media_type, payload_types, media_desc,
3156 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003157 return false;
3158 }
3159 } else if (HasAttribute(line, kCodecParamMaxPTime)) {
3160 if (!GetValue(line, kCodecParamMaxPTime, &maxptime_as_string, error)) {
3161 return false;
3162 }
3163 } else if (HasAttribute(line, kAttributeRtcpFb)) {
3164 if (!ParseRtcpFbAttribute(line, media_type, media_desc, error)) {
3165 return false;
3166 }
3167 } else if (HasAttribute(line, kCodecParamPTime)) {
3168 if (!GetValue(line, kCodecParamPTime, &ptime_as_string, error)) {
3169 return false;
3170 }
3171 } else if (HasAttribute(line, kAttributeSendOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003172 media_desc->set_direction(RtpTransceiverDirection::kSendOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003173 } else if (HasAttribute(line, kAttributeRecvOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003174 media_desc->set_direction(RtpTransceiverDirection::kRecvOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003175 } else if (HasAttribute(line, kAttributeInactive)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003176 media_desc->set_direction(RtpTransceiverDirection::kInactive);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003177 } else if (HasAttribute(line, kAttributeSendRecv)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003178 media_desc->set_direction(RtpTransceiverDirection::kSendRecv);
Johannes Kron0854eb62018-10-10 22:33:20 +02003179 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02003180 media_desc->set_extmap_allow_mixed_enum(
Johannes Kron0854eb62018-10-10 22:33:20 +02003181 MediaContentDescription::kMedia);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003182 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07003183 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003184 if (!ParseExtmap(line, &extmap, error)) {
3185 return false;
3186 }
3187 media_desc->AddRtpHeaderExtension(extmap);
3188 } else if (HasAttribute(line, kAttributeXGoogleFlag)) {
3189 // Experimental attribute. Conference mode activates more aggressive
3190 // AEC and NS settings.
Steve Anton36b29d12017-10-30 09:57:42 -07003191 // TODO(deadbeef): expose API to set these directly.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003192 std::string flag_value;
3193 if (!GetValue(line, kAttributeXGoogleFlag, &flag_value, error)) {
3194 return false;
3195 }
3196 if (flag_value.compare(kValueConference) == 0)
3197 media_desc->set_conference_mode(true);
deadbeef9d3584c2016-02-16 17:54:10 -08003198 } else if (HasAttribute(line, kAttributeMsid)) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07003199 if (!ParseMsidAttribute(line, &stream_ids, &track_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08003200 return false;
3201 }
Steve Antone831b8c2018-02-01 12:22:16 -08003202 *msid_signaling |= cricket::kMsidSignalingMediaSection;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003203 } else if (HasAttribute(line, kAttributeRid)) {
3204 const size_t kRidPrefixLength =
3205 kLinePrefixLength + arraysize(kAttributeRid);
3206 if (line.size() <= kRidPrefixLength) {
3207 RTC_LOG(LS_INFO) << "Ignoring empty RID attribute: " << line;
3208 continue;
3209 }
3210 RTCErrorOr<RidDescription> error_or_rid_description =
3211 deserializer.DeserializeRidDescription(
3212 line.substr(kRidPrefixLength));
3213
3214 // Malformed a=rid lines are discarded.
3215 if (!error_or_rid_description.ok()) {
3216 RTC_LOG(LS_INFO) << "Ignoring malformed RID line: '" << line
3217 << "'. Error: "
3218 << error_or_rid_description.error().message();
3219 continue;
3220 }
3221
3222 rids.push_back(error_or_rid_description.MoveValue());
Amit Hilbucha2012042018-12-03 11:35:05 -08003223 } else if (HasAttribute(line, kAttributeSimulcast)) {
3224 const size_t kSimulcastPrefixLength =
3225 kLinePrefixLength + arraysize(kAttributeSimulcast);
3226 if (line.size() <= kSimulcastPrefixLength) {
3227 return ParseFailed(line, "Simulcast attribute is empty.", error);
3228 }
3229
3230 if (!simulcast.empty()) {
3231 return ParseFailed(line, "Multiple Simulcast attributes specified.",
3232 error);
3233 }
3234
Amit Hilbucha2012042018-12-03 11:35:05 -08003235 RTCErrorOr<SimulcastDescription> error_or_simulcast =
3236 deserializer.DeserializeSimulcastDescription(
3237 line.substr(kSimulcastPrefixLength));
3238 if (!error_or_simulcast.ok()) {
3239 return ParseFailed(line,
3240 std::string("Malformed simulcast line: ") +
3241 error_or_simulcast.error().message(),
3242 error);
3243 }
3244
3245 simulcast = error_or_simulcast.value();
3246 } else {
3247 // Unrecognized attribute in RTP protocol.
3248 RTC_LOG(LS_INFO) << "Ignored line: " << line;
3249 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003250 }
3251 } else {
3252 // Only parse lines that we are interested of.
Mirko Bonadei675513b2017-11-09 11:09:25 +01003253 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003254 continue;
3255 }
3256 }
3257
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003258 // Remove duplicate or inconsistent rids.
3259 RemoveInvalidRidDescriptions(payload_types, &rids);
3260
3261 // If simulcast is specifed, split the rids into send and receive.
3262 // Rids that do not appear in simulcast attribute will be removed.
3263 // If it is not specified, we assume that all rids are for send layers.
Amit Hilbuchb7446ed2019-01-28 12:25:25 -08003264 std::vector<RidDescription> send_rids;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003265 if (!simulcast.empty()) {
3266 // Verify that the rids in simulcast match rids in sdp.
3267 RemoveInvalidRidsFromSimulcast(rids, &simulcast);
3268
3269 // Use simulcast description to figure out Send / Receive RIDs.
3270 std::map<std::string, RidDescription> rid_map;
3271 for (const RidDescription& rid : rids) {
3272 rid_map[rid.rid] = rid;
3273 }
3274
3275 for (const auto& layer : simulcast.send_layers().GetAllLayers()) {
3276 auto iter = rid_map.find(layer.rid);
3277 RTC_DCHECK(iter != rid_map.end());
3278 send_rids.push_back(iter->second);
3279 }
3280
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003281 media_desc->set_simulcast_description(simulcast);
3282 } else {
3283 send_rids = rids;
3284 }
3285
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003286 // Create tracks from the |ssrc_infos|.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -08003287 // If the stream_id/track_id for all SSRCS are identical, one StreamParams
3288 // will be created in CreateTracksFromSsrcInfos, containing all the SSRCs from
3289 // the m= section.
Seth Hampson5897a6e2018-04-03 11:16:33 -07003290 if (!ssrc_infos.empty()) {
3291 CreateTracksFromSsrcInfos(ssrc_infos, stream_ids, track_id, &tracks,
3292 *msid_signaling);
3293 } else if (media_type != cricket::MEDIA_TYPE_DATA &&
3294 (*msid_signaling & cricket::kMsidSignalingMediaSection)) {
3295 // If the stream_ids/track_id was signaled but SSRCs were unsignaled we
3296 // still create a track. This isn't done for data media types because
3297 // StreamParams aren't used for SCTP streams, and RTP data channels don't
3298 // support unsignaled SSRCs.
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003299 CreateTrackWithNoSsrcs(stream_ids, track_id, send_rids, &tracks);
3300 }
3301
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003302 // Add the ssrc group to the track.
Steve Anton4daf66e2018-09-07 14:55:53 -07003303 for (const SsrcGroup& ssrc_group : ssrc_groups) {
3304 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003305 continue;
3306 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003307 uint32_t ssrc = ssrc_group.ssrcs.front();
3308 for (StreamParams& track : tracks) {
3309 if (track.has_ssrc(ssrc)) {
3310 track.ssrc_groups.push_back(ssrc_group);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003311 }
3312 }
3313 }
3314
3315 // Add the new tracks to the |media_desc|.
deadbeef9d3584c2016-02-16 17:54:10 -08003316 for (StreamParams& track : tracks) {
3317 media_desc->AddStream(track);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003318 }
3319
3320 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003321 AudioContentDescription* audio_desc = media_desc->as_audio();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003322 UpdateFromWildcardCodecs(audio_desc);
3323
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003324 // Verify audio codec ensures that no audio codec has been populated with
3325 // only fmtp.
3326 if (!VerifyAudioCodecs(audio_desc)) {
3327 return ParseFailed("Failed to parse audio codecs correctly.", error);
3328 }
3329 AddAudioAttribute(kCodecParamMaxPTime, maxptime_as_string, audio_desc);
3330 AddAudioAttribute(kCodecParamPTime, ptime_as_string, audio_desc);
3331 }
3332
3333 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003334 VideoContentDescription* video_desc = media_desc->as_video();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003335 UpdateFromWildcardCodecs(video_desc);
3336 // Verify video codec ensures that no video codec has been populated with
3337 // only rtcp-fb.
3338 if (!VerifyVideoCodecs(video_desc)) {
3339 return ParseFailed("Failed to parse video codecs correctly.", error);
3340 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003341 }
3342
3343 // RFC 5245
3344 // Update the candidates with the media level "ice-pwd" and "ice-ufrag".
Steve Anton4daf66e2018-09-07 14:55:53 -07003345 for (Candidate& candidate : candidates_orig) {
3346 RTC_DCHECK(candidate.username().empty() ||
3347 candidate.username() == transport->ice_ufrag);
3348 candidate.set_username(transport->ice_ufrag);
3349 RTC_DCHECK(candidate.password().empty());
3350 candidate.set_password(transport->ice_pwd);
3351 candidates->push_back(
Steve Anton5a1de872018-12-18 11:25:55 -08003352 absl::make_unique<JsepIceCandidate>(mline_id, mline_index, candidate));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003353 }
Amit Hilbucha2012042018-12-03 11:35:05 -08003354
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003355 return true;
3356}
3357
Steve Antone831b8c2018-02-01 12:22:16 -08003358bool ParseSsrcAttribute(const std::string& line,
3359 SsrcInfoVec* ssrc_infos,
3360 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003361 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003362 RTC_DCHECK(ssrc_infos != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003363 // RFC 5576
3364 // a=ssrc:<ssrc-id> <attribute>
3365 // a=ssrc:<ssrc-id> <attribute>:<value>
3366 std::string field1, field2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003367 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3368 kSdpDelimiterSpaceChar, &field1, &field2)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003369 const size_t expected_fields = 2;
3370 return ParseFailedExpectFieldNum(line, expected_fields, error);
3371 }
3372
3373 // ssrc:<ssrc-id>
3374 std::string ssrc_id_s;
3375 if (!GetValue(field1, kAttributeSsrc, &ssrc_id_s, error)) {
3376 return false;
3377 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003378 uint32_t ssrc_id = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003379 if (!GetValueFromString(line, ssrc_id_s, &ssrc_id, error)) {
3380 return false;
3381 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003382
3383 std::string attribute;
3384 std::string value;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003385 if (!rtc::tokenize_first(field2, kSdpDelimiterColonChar, &attribute,
3386 &value)) {
3387 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003388 description << "Failed to get the ssrc attribute value from " << field2
3389 << ". Expected format <attribute>:<value>.";
3390 return ParseFailed(line, description.str(), error);
3391 }
3392
3393 // Check if there's already an item for this |ssrc_id|. Create a new one if
3394 // there isn't.
Steve Anton64b626b2019-01-28 17:25:26 -08003395 auto ssrc_info_it =
3396 absl::c_find_if(*ssrc_infos, [ssrc_id](const SsrcInfo& ssrc_info) {
3397 return ssrc_info.ssrc_id == ssrc_id;
3398 });
Steve Anton4daf66e2018-09-07 14:55:53 -07003399 if (ssrc_info_it == ssrc_infos->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003400 SsrcInfo info;
3401 info.ssrc_id = ssrc_id;
3402 ssrc_infos->push_back(info);
Steve Anton4daf66e2018-09-07 14:55:53 -07003403 ssrc_info_it = ssrc_infos->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003404 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003405 SsrcInfo& ssrc_info = *ssrc_info_it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003406
3407 // Store the info to the |ssrc_info|.
3408 if (attribute == kSsrcAttributeCname) {
3409 // RFC 5576
3410 // cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003411 ssrc_info.cname = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003412 } else if (attribute == kSsrcAttributeMsid) {
3413 // draft-alvestrand-mmusic-msid-00
Seth Hampson5b4f0752018-04-02 16:31:36 -07003414 // msid:identifier [appdata]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003415 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003416 rtc::split(value, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003417 if (fields.size() < 1 || fields.size() > 2) {
Yves Gerey665174f2018-06-19 15:03:05 +02003418 return ParseFailed(
3419 line, "Expected format \"msid:<identifier>[ <appdata>]\".", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003420 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003421 ssrc_info.stream_id = fields[0];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003422 if (fields.size() == 2) {
Steve Anton4daf66e2018-09-07 14:55:53 -07003423 ssrc_info.track_id = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003424 }
Steve Antone831b8c2018-02-01 12:22:16 -08003425 *msid_signaling |= cricket::kMsidSignalingSsrcAttribute;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003426 } else if (attribute == kSsrcAttributeMslabel) {
3427 // draft-alvestrand-rtcweb-mid-01
3428 // mslabel:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003429 ssrc_info.mslabel = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003430 } else if (attribute == kSSrcAttributeLabel) {
3431 // The label isn't defined.
3432 // label:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003433 ssrc_info.label = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003434 }
3435 return true;
3436}
3437
3438bool ParseSsrcGroupAttribute(const std::string& line,
3439 SsrcGroupVec* ssrc_groups,
3440 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003441 RTC_DCHECK(ssrc_groups != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003442 // RFC 5576
3443 // a=ssrc-group:<semantics> <ssrc-id> ...
3444 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003445 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003446 const size_t expected_min_fields = 2;
3447 if (fields.size() < expected_min_fields) {
3448 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3449 }
3450 std::string semantics;
3451 if (!GetValue(fields[0], kAttributeSsrcGroup, &semantics, error)) {
3452 return false;
3453 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003454 std::vector<uint32_t> ssrcs;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003455 for (size_t i = 1; i < fields.size(); ++i) {
Peter Boström0c4e06b2015-10-07 12:23:21 +02003456 uint32_t ssrc = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003457 if (!GetValueFromString(line, fields[i], &ssrc, error)) {
3458 return false;
3459 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003460 ssrcs.push_back(ssrc);
3461 }
3462 ssrc_groups->push_back(SsrcGroup(semantics, ssrcs));
3463 return true;
3464}
3465
3466bool ParseCryptoAttribute(const std::string& line,
3467 MediaContentDescription* media_desc,
3468 SdpParseError* error) {
3469 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003470 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003471 // RFC 4568
3472 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
3473 const size_t expected_min_fields = 3;
3474 if (fields.size() < expected_min_fields) {
3475 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3476 }
3477 std::string tag_value;
3478 if (!GetValue(fields[0], kAttributeCrypto, &tag_value, error)) {
3479 return false;
3480 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003481 int tag = 0;
3482 if (!GetValueFromString(line, tag_value, &tag, error)) {
3483 return false;
3484 }
jbauch083b73f2015-07-16 02:46:32 -07003485 const std::string& crypto_suite = fields[1];
3486 const std::string& key_params = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003487 std::string session_params;
3488 if (fields.size() > 3) {
3489 session_params = fields[3];
3490 }
Yves Gerey665174f2018-06-19 15:03:05 +02003491 media_desc->AddCrypto(
3492 CryptoParams(tag, crypto_suite, key_params, session_params));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003493 return true;
3494}
3495
3496// Updates or creates a new codec entry in the audio description with according
deadbeef67cf2c12016-04-13 10:07:16 -07003497// to |name|, |clockrate|, |bitrate|, and |channels|.
3498void UpdateCodec(int payload_type,
3499 const std::string& name,
3500 int clockrate,
3501 int bitrate,
3502 size_t channels,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003503 AudioContentDescription* audio_desc) {
3504 // Codec may already be populated with (only) optional parameters
3505 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003506 cricket::AudioCodec codec =
3507 GetCodecWithPayloadType(audio_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003508 codec.name = name;
3509 codec.clockrate = clockrate;
3510 codec.bitrate = bitrate;
3511 codec.channels = channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003512 AddOrReplaceCodec<AudioContentDescription, cricket::AudioCodec>(audio_desc,
3513 codec);
3514}
3515
3516// Updates or creates a new codec entry in the video description according to
deadbeef67cf2c12016-04-13 10:07:16 -07003517// |name|, |width|, |height|, and |framerate|.
3518void UpdateCodec(int payload_type,
3519 const std::string& name,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003520 VideoContentDescription* video_desc) {
3521 // Codec may already be populated with (only) optional parameters
3522 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003523 cricket::VideoCodec codec =
3524 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003525 codec.name = name;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003526 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
3527 codec);
3528}
3529
3530bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003531 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -07003532 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003533 MediaContentDescription* media_desc,
3534 SdpParseError* error) {
3535 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003536 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003537 // RFC 4566
3538 // a=rtpmap:<payload type> <encoding name>/<clock rate>[/<encodingparameters>]
3539 const size_t expected_min_fields = 2;
3540 if (fields.size() < expected_min_fields) {
3541 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3542 }
3543 std::string payload_type_value;
3544 if (!GetValue(fields[0], kAttributeRtpmap, &payload_type_value, error)) {
3545 return false;
3546 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003547 int payload_type = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003548 if (!GetPayloadTypeFromString(line, payload_type_value, &payload_type,
3549 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003550 return false;
3551 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003552
Steve Anton64b626b2019-01-28 17:25:26 -08003553 if (!absl::c_linear_search(payload_types, payload_type)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003554 RTC_LOG(LS_WARNING) << "Ignore rtpmap line that did not appear in the "
Jonas Olsson45cc8902018-02-13 10:37:07 +01003555 "<fmt> of the m-line: "
3556 << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003557 return true;
3558 }
jbauch083b73f2015-07-16 02:46:32 -07003559 const std::string& encoder = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003560 std::vector<std::string> codec_params;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00003561 rtc::split(encoder, '/', &codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003562 // <encoding name>/<clock rate>[/<encodingparameters>]
3563 // 2 mandatory fields
3564 if (codec_params.size() < 2 || codec_params.size() > 3) {
3565 return ParseFailed(line,
3566 "Expected format \"<encoding name>/<clock rate>"
3567 "[/<encodingparameters>]\".",
3568 error);
3569 }
jbauch083b73f2015-07-16 02:46:32 -07003570 const std::string& encoding_name = codec_params[0];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003571 int clock_rate = 0;
3572 if (!GetValueFromString(line, codec_params[1], &clock_rate, error)) {
3573 return false;
3574 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003575 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003576 VideoContentDescription* video_desc = media_desc->as_video();
Yves Gerey665174f2018-06-19 15:03:05 +02003577 UpdateCodec(payload_type, encoding_name, video_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003578 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3579 // RFC 4566
3580 // For audio streams, <encoding parameters> indicates the number
3581 // of audio channels. This parameter is OPTIONAL and may be
3582 // omitted if the number of channels is one, provided that no
3583 // additional parameters are needed.
Peter Kasting69558702016-01-12 16:26:35 -08003584 size_t channels = 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003585 if (codec_params.size() == 3) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003586 if (!GetValueFromString(line, codec_params[2], &channels, error)) {
3587 return false;
3588 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003589 }
Steve Antonb1c1de12017-12-21 15:14:30 -08003590 AudioContentDescription* audio_desc = media_desc->as_audio();
ossue1405ad2017-01-23 08:55:48 -08003591 UpdateCodec(payload_type, encoding_name, clock_rate, 0, channels,
deadbeef67cf2c12016-04-13 10:07:16 -07003592 audio_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003593 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand14b27582019-05-04 11:37:04 +02003594 RtpDataContentDescription* data_desc = media_desc->as_rtp_data();
3595 data_desc->AddCodec(cricket::RtpDataCodec(payload_type, encoding_name));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003596 }
3597 return true;
3598}
3599
Yves Gerey665174f2018-06-19 15:03:05 +02003600bool ParseFmtpParam(const std::string& line,
3601 std::string* parameter,
3602 std::string* value,
3603 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003604 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, parameter, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003605 ParseFailed(line, "Unable to parse fmtp parameter. \'=\' missing.", error);
3606 return false;
3607 }
3608 // a=fmtp:<payload_type> <param1>=<value1>; <param2>=<value2>; ...
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003609 return true;
3610}
3611
Yves Gerey665174f2018-06-19 15:03:05 +02003612bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003613 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003614 MediaContentDescription* media_desc,
3615 SdpParseError* error) {
3616 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3617 media_type != cricket::MEDIA_TYPE_VIDEO) {
3618 return true;
3619 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003620
3621 std::string line_payload;
3622 std::string line_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003623
3624 // RFC 5576
3625 // a=fmtp:<format> <format specific parameters>
3626 // At least two fields, whereas the second one is any of the optional
3627 // parameters.
Jonas Olssonec9e4922018-09-05 09:53:49 +02003628 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3629 kSdpDelimiterSpaceChar, &line_payload,
3630 &line_params)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003631 ParseFailedExpectMinFieldNum(line, 2, error);
3632 return false;
3633 }
3634
Donald Curtis0e07f922015-05-15 09:21:23 -07003635 // Parse out the payload information.
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003636 std::string payload_type_str;
Donald Curtis0e07f922015-05-15 09:21:23 -07003637 if (!GetValue(line_payload, kAttributeFmtp, &payload_type_str, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003638 return false;
3639 }
3640
Donald Curtis0e07f922015-05-15 09:21:23 -07003641 int payload_type = 0;
Donald Curtis144d0182015-05-15 13:14:24 -07003642 if (!GetPayloadTypeFromString(line_payload, payload_type_str, &payload_type,
3643 error)) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003644 return false;
3645 }
3646
3647 // Parse out format specific parameters.
3648 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003649 rtc::split(line_params, kSdpDelimiterSemicolonChar, &fields);
Donald Curtis0e07f922015-05-15 09:21:23 -07003650
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003651 cricket::CodecParameterMap codec_params;
Donald Curtis144d0182015-05-15 13:14:24 -07003652 for (auto& iter : fields) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003653 if (iter.find(kSdpDelimiterEqual) == std::string::npos) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003654 // Only fmtps with equals are currently supported. Other fmtp types
3655 // should be ignored. Unknown fmtps do not constitute an error.
3656 continue;
3657 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003658
3659 std::string name;
3660 std::string value;
3661 if (!ParseFmtpParam(rtc::string_trim(iter), &name, &value, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003662 return false;
3663 }
3664 codec_params[name] = value;
3665 }
3666
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003667 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3668 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003669 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003670 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
3671 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003672 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003673 }
3674 return true;
3675}
3676
Yves Gerey665174f2018-06-19 15:03:05 +02003677bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003678 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003679 MediaContentDescription* media_desc,
3680 SdpParseError* error) {
3681 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3682 media_type != cricket::MEDIA_TYPE_VIDEO) {
3683 return true;
3684 }
3685 std::vector<std::string> rtcp_fb_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003686 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &rtcp_fb_fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003687 if (rtcp_fb_fields.size() < 2) {
3688 return ParseFailedGetValue(line, kAttributeRtcpFb, error);
3689 }
3690 std::string payload_type_string;
3691 if (!GetValue(rtcp_fb_fields[0], kAttributeRtcpFb, &payload_type_string,
3692 error)) {
3693 return false;
3694 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003695 int payload_type = kWildcardPayloadType;
3696 if (payload_type_string != "*") {
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003697 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3698 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003699 return false;
3700 }
3701 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003702 std::string id = rtcp_fb_fields[1];
3703 std::string param = "";
3704 for (std::vector<std::string>::iterator iter = rtcp_fb_fields.begin() + 2;
3705 iter != rtcp_fb_fields.end(); ++iter) {
3706 param.append(*iter);
3707 }
3708 const cricket::FeedbackParam feedback_param(id, param);
3709
3710 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003711 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
3712 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003713 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003714 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
3715 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003716 }
3717 return true;
3718}
3719
3720} // namespace webrtc