blob: 7c65f87ca5b1eb6ff4011e31b52ad3ba39d4f342 [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;
Seth Hampson1859dc02019-04-16 20:55:57 +000057using cricket::ICE_CANDIDATE_COMPONENT_RTCP;
Harald Alvestrand26bf7c42019-04-23 05:20:17 +000058using cricket::ICE_CANDIDATE_COMPONENT_RTP;
59using cricket::kCodecParamAssociatedPayloadType;
60using cricket::kCodecParamMaxAverageBitrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000061using cricket::kCodecParamMaxBitrate;
Harald Alvestrand26bf7c42019-04-23 05:20:17 +000062using 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 Alvestrand26bf7c42019-04-23 05:20:17 +000068using 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;
Seth Hampson1859dc02019-04-16 20:55:57 +000073using cricket::kCodecParamUseDtx;
Harald Alvestrand26bf7c42019-04-23 05:20:17 +000074using cricket::kCodecParamUseInbandFec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000075using cricket::MediaContentDescription;
Seth Hampson1859dc02019-04-16 20:55:57 +000076using cricket::MediaProtocolType;
Harald Alvestrand26bf7c42019-04-23 05:20:17 +000077using cricket::MediaType;
Seth Hampson1859dc02019-04-16 20:55:57 +000078using cricket::RidDescription;
Harald Alvestrand26bf7c42019-04-23 05:20:17 +000079using cricket::RtpHeaderExtensions;
80using cricket::SctpDataContentDescription;
Amit Hilbucha2012042018-12-03 11:35:05 -080081using cricket::SimulcastDescription;
Amit Hilbuchc57d5732018-12-11 15:30:11 -080082using cricket::SimulcastLayer;
83using cricket::SimulcastLayerList;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000084using cricket::SsrcGroup;
85using cricket::StreamParams;
86using cricket::StreamParamsVec;
87using cricket::TransportDescription;
88using cricket::TransportInfo;
89using cricket::VideoContentDescription;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +000090using rtc::SocketAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000091
henrike@webrtc.org28e20752013-07-10 00:45:36 +000092namespace cricket {
93class SessionDescription;
94}
95
deadbeef90f1e1e2017-02-10 12:35:05 -080096// TODO(deadbeef): Switch to using anonymous namespace rather than declaring
97// everything "static".
henrike@webrtc.org28e20752013-07-10 00:45:36 +000098namespace webrtc {
99
100// Line type
101// RFC 4566
102// An SDP session description consists of a number of lines of text of
103// the form:
104// <type>=<value>
105// where <type> MUST be exactly one case-significant character.
deadbeef9d3584c2016-02-16 17:54:10 -0800106static const int kLinePrefixLength = 2; // Length of <type>=
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000107static const char kLineTypeVersion = 'v';
108static const char kLineTypeOrigin = 'o';
109static const char kLineTypeSessionName = 's';
110static const char kLineTypeSessionInfo = 'i';
111static const char kLineTypeSessionUri = 'u';
112static const char kLineTypeSessionEmail = 'e';
113static const char kLineTypeSessionPhone = 'p';
114static const char kLineTypeSessionBandwidth = 'b';
115static const char kLineTypeTiming = 't';
116static const char kLineTypeRepeatTimes = 'r';
117static const char kLineTypeTimeZone = 'z';
118static const char kLineTypeEncryptionKey = 'k';
119static const char kLineTypeMedia = 'm';
120static const char kLineTypeConnection = 'c';
121static const char kLineTypeAttributes = 'a';
122
123// Attributes
124static const char kAttributeGroup[] = "group";
125static const char kAttributeMid[] = "mid";
deadbeef9d3584c2016-02-16 17:54:10 -0800126static const char kAttributeMsid[] = "msid";
deadbeef25ed4352016-12-12 18:37:36 -0800127static const char kAttributeBundleOnly[] = "bundle-only";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000128static const char kAttributeRtcpMux[] = "rtcp-mux";
deadbeef13871492015-12-09 12:37:51 -0800129static const char kAttributeRtcpReducedSize[] = "rtcp-rsize";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000130static const char kAttributeSsrc[] = "ssrc";
131static const char kSsrcAttributeCname[] = "cname";
Johannes Kron0854eb62018-10-10 22:33:20 +0200132static const char kAttributeExtmapAllowMixed[] = "extmap-allow-mixed";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000133static const char kAttributeExtmap[] = "extmap";
134// draft-alvestrand-mmusic-msid-01
135// a=msid-semantic: WMS
Seth Hampson5b4f0752018-04-02 16:31:36 -0700136// This is a legacy field supported only for Plan B semantics.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000137static const char kAttributeMsidSemantics[] = "msid-semantic";
138static const char kMediaStreamSemantic[] = "WMS";
139static const char kSsrcAttributeMsid[] = "msid";
140static const char kDefaultMsid[] = "default";
Seth Hampson5b4f0752018-04-02 16:31:36 -0700141static const char kNoStreamMsid[] = "-";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000142static const char kSsrcAttributeMslabel[] = "mslabel";
143static const char kSSrcAttributeLabel[] = "label";
144static const char kAttributeSsrcGroup[] = "ssrc-group";
145static const char kAttributeCrypto[] = "crypto";
146static const char kAttributeCandidate[] = "candidate";
147static const char kAttributeCandidateTyp[] = "typ";
148static const char kAttributeCandidateRaddr[] = "raddr";
149static const char kAttributeCandidateRport[] = "rport";
honghaiza54a0802015-12-16 18:37:23 -0800150static const char kAttributeCandidateUfrag[] = "ufrag";
151static const char kAttributeCandidatePwd[] = "pwd";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000152static const char kAttributeCandidateGeneration[] = "generation";
honghaiza0c44ea2016-03-23 16:07:48 -0700153static const char kAttributeCandidateNetworkId[] = "network-id";
honghaize1a0c942016-02-16 14:54:56 -0800154static const char kAttributeCandidateNetworkCost[] = "network-cost";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000155static const char kAttributeFingerprint[] = "fingerprint";
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000156static const char kAttributeSetup[] = "setup";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000157static const char kAttributeFmtp[] = "fmtp";
158static const char kAttributeRtpmap[] = "rtpmap";
wu@webrtc.org78187522013-10-07 23:32:02 +0000159static const char kAttributeSctpmap[] = "sctpmap";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000160static const char kAttributeRtcp[] = "rtcp";
161static const char kAttributeIceUfrag[] = "ice-ufrag";
162static const char kAttributeIcePwd[] = "ice-pwd";
163static const char kAttributeIceLite[] = "ice-lite";
164static const char kAttributeIceOption[] = "ice-options";
165static const char kAttributeSendOnly[] = "sendonly";
166static const char kAttributeRecvOnly[] = "recvonly";
167static const char kAttributeRtcpFb[] = "rtcp-fb";
168static const char kAttributeSendRecv[] = "sendrecv";
169static const char kAttributeInactive[] = "inactive";
Harald Alvestrand48cce4d2019-04-11 10:41:24 +0200170// draft-ietf-mmusic-sctp-sdp-26
171// a=sctp-port, a=max-message-size
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +0000172static const char kAttributeSctpPort[] = "sctp-port";
Harald Alvestrand48cce4d2019-04-11 10:41:24 +0200173static const char kAttributeMaxMessageSize[] = "max-message-size";
Amit Hilbucha2012042018-12-03 11:35:05 -0800174// draft-ietf-mmusic-sdp-simulcast-13
175// a=simulcast
176static const char kAttributeSimulcast[] = "simulcast";
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800177// draft-ietf-mmusic-rid-15
178// a=rid
179static const char kAttributeRid[] = "rid";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000180
181// Experimental flags
182static const char kAttributeXGoogleFlag[] = "x-google-flag";
183static const char kValueConference[] = "conference";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000184
185// Candidate
186static const char kCandidateHost[] = "host";
187static const char kCandidateSrflx[] = "srflx";
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700188static const char kCandidatePrflx[] = "prflx";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000189static const char kCandidateRelay[] = "relay";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +0000190static const char kTcpCandidateType[] = "tcptype";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000191
Jonas Olssonec9e4922018-09-05 09:53:49 +0200192// rtc::StringBuilder doesn't have a << overload for chars, while rtc::split and
193// rtc::tokenize_first both take a char delimiter. To handle both cases these
194// constants come in pairs of a chars and length-one strings.
195static const char kSdpDelimiterEqual[] = "=";
196static const char kSdpDelimiterEqualChar = '=';
197static const char kSdpDelimiterSpace[] = " ";
198static const char kSdpDelimiterSpaceChar = ' ';
199static const char kSdpDelimiterColon[] = ":";
200static const char kSdpDelimiterColonChar = ':';
201static const char kSdpDelimiterSemicolon[] = ";";
202static const char kSdpDelimiterSemicolonChar = ';';
203static const char kSdpDelimiterSlashChar = '/';
204static const char kNewLine[] = "\n";
205static const char kNewLineChar = '\n';
206static const char kReturnChar = '\r';
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000207static const char kLineBreak[] = "\r\n";
208
Steve Anton36b29d12017-10-30 09:57:42 -0700209// TODO(deadbeef): Generate the Session and Time description
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000210// instead of hardcoding.
211static const char kSessionVersion[] = "v=0";
212// RFC 4566
213static const char kSessionOriginUsername[] = "-";
214static const char kSessionOriginSessionId[] = "0";
215static const char kSessionOriginSessionVersion[] = "0";
216static const char kSessionOriginNettype[] = "IN";
217static const char kSessionOriginAddrtype[] = "IP4";
218static const char kSessionOriginAddress[] = "127.0.0.1";
219static const char kSessionName[] = "s=-";
220static const char kTimeDescription[] = "t=0 0";
221static const char kAttrGroup[] = "a=group:BUNDLE";
222static const char kConnectionNettype[] = "IN";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000223static const char kConnectionIpv4Addrtype[] = "IP4";
224static const char kConnectionIpv6Addrtype[] = "IP6";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000225static const char kMediaTypeVideo[] = "video";
226static const char kMediaTypeAudio[] = "audio";
227static const char kMediaTypeData[] = "application";
228static const char kMediaPortRejected[] = "0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000229// draft-ietf-mmusic-trickle-ice-01
230// When no candidates have been gathered, set the connection
231// address to IP6 ::.
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000232// TODO(perkj): FF can not parse IP6 ::. See http://crbug/430333
233// Use IPV4 per default.
234static const char kDummyAddress[] = "0.0.0.0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000235static const char kDummyPort[] = "9";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000236// RFC 3556
237static const char kApplicationSpecificMaximum[] = "AS";
238
wu@webrtc.org78187522013-10-07 23:32:02 +0000239static const char kDefaultSctpmapProtocol[] = "webrtc-datachannel";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000240
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -0800241// This is a non-standardized media transport settings.
242// This setting is going to be set in the offer. There may be one or more
243// a=x-mt: settings, and they are in the priority order (the most preferred on
244// top). x-mt setting format depends on the media transport, and is generated by
245// |MediaTransportInterface::GetTransportParametersOffer|.
246static const char kMediaTransportSettingLine[] = "x-mt";
247
pkasting@chromium.orgd3245462015-02-23 21:28:22 +0000248// RTP payload type is in the 0-127 range. Use -1 to indicate "all" payload
249// types.
250const int kWildcardPayloadType = -1;
251
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000252struct SsrcInfo {
Peter Boström0c4e06b2015-10-07 12:23:21 +0200253 uint32_t ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000254 std::string cname;
deadbeef9d3584c2016-02-16 17:54:10 -0800255 std::string stream_id;
256 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000257
258 // For backward compatibility.
259 // TODO(ronghuawu): Remove below 2 fields once all the clients support msid.
260 std::string label;
261 std::string mslabel;
262};
263typedef std::vector<SsrcInfo> SsrcInfoVec;
264typedef std::vector<SsrcGroup> SsrcGroupVec;
265
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000266template <class T>
267static void AddFmtpLine(const T& codec, std::string* message);
268static void BuildMediaDescription(const ContentInfo* content_info,
269 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200270 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000271 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -0800272 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000273 std::string* message);
zstein4b2e0822017-02-17 19:48:38 -0800274static void BuildSctpContentAttributes(std::string* message,
275 int sctp_port,
276 bool use_sctpmap);
deadbeef9d3584c2016-02-16 17:54:10 -0800277static void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200278 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -0800279 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -0800280 std::string* message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000281static void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200282 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000283 std::string* message);
284static void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -0800285 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000286 std::string* message);
287static void BuildIceOptions(const std::vector<std::string>& transport_options,
288 std::string* message);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +0000289static bool IsRtp(const std::string& protocol);
290static bool IsDtlsSctp(const std::string& protocol);
zhihuang38989e52017-03-21 11:04:53 -0700291static bool ParseSessionDescription(const std::string& message,
292 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000293 std::string* session_id,
294 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000295 TransportDescription* session_td,
296 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700297 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000298 cricket::SessionDescription* desc,
299 SdpParseError* error);
300static bool ParseGroupAttribute(const std::string& line,
301 cricket::SessionDescription* desc,
302 SdpParseError* error);
303static bool ParseMediaDescription(
304 const std::string& message,
305 const TransportDescription& session_td,
306 const RtpHeaderExtensions& session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700307 size_t* pos,
308 const rtc::SocketAddress& session_connection_addr,
309 cricket::SessionDescription* desc,
Steve Anton5a1de872018-12-18 11:25:55 -0800310 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000311 SdpParseError* error);
Steve Anton5a1de872018-12-18 11:25:55 -0800312static bool ParseContent(
313 const std::string& message,
314 const cricket::MediaType media_type,
315 int mline_index,
316 const std::string& protocol,
317 const std::vector<int>& payload_types,
318 size_t* pos,
319 std::string* content_name,
320 bool* bundle_only,
321 int* msid_signaling,
322 MediaContentDescription* media_desc,
323 TransportDescription* transport,
324 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
325 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000326static bool ParseSsrcAttribute(const std::string& line,
327 SsrcInfoVec* ssrc_infos,
Steve Antone831b8c2018-02-01 12:22:16 -0800328 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000329 SdpParseError* error);
330static bool ParseSsrcGroupAttribute(const std::string& line,
331 SsrcGroupVec* ssrc_groups,
332 SdpParseError* error);
333static bool ParseCryptoAttribute(const std::string& line,
334 MediaContentDescription* media_desc,
335 SdpParseError* error);
336static bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200337 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -0700338 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000339 MediaContentDescription* media_desc,
340 SdpParseError* error);
341static bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200342 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000343 MediaContentDescription* media_desc,
344 SdpParseError* error);
Yves Gerey665174f2018-06-19 15:03:05 +0200345static bool ParseFmtpParam(const std::string& line,
346 std::string* parameter,
347 std::string* value,
348 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000349static bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200350 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000351 MediaContentDescription* media_desc,
352 SdpParseError* error);
353static bool ParseIceOptions(const std::string& line,
354 std::vector<std::string>* transport_options,
355 SdpParseError* error);
356static bool ParseExtmap(const std::string& line,
isheriff6f8d6862016-05-26 11:24:55 -0700357 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000358 SdpParseError* error);
Steve Anton4905edb2018-10-15 19:27:44 -0700359static bool ParseFingerprintAttribute(
360 const std::string& line,
361 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
362 SdpParseError* error);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000363static bool ParseDtlsSetup(const std::string& line,
364 cricket::ConnectionRole* role,
365 SdpParseError* error);
deadbeef9d3584c2016-02-16 17:54:10 -0800366static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700367 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -0800368 std::string* track_id,
369 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000370
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800371static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
372 std::vector<RidDescription>* rids);
373
374static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
375 const std::set<std::string>& to_remove,
376 const SimulcastLayerList& layers);
377
378static void RemoveInvalidRidsFromSimulcast(
379 const std::vector<RidDescription>& rids,
380 SimulcastDescription* simulcast);
381
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000382// Helper functions
383
384// Below ParseFailed*** functions output the line that caused the parsing
385// failure and the detailed reason (|description|) of the failure to |error|.
386// The functions always return false so that they can be used directly in the
387// following way when error happens:
388// "return ParseFailed***(...);"
389
390// The line starting at |line_start| of |message| is the failing line.
391// The reason for the failure should be provided in the |description|.
392// An example of a description could be "unknown character".
393static bool ParseFailed(const std::string& message,
394 size_t line_start,
395 const std::string& description,
396 SdpParseError* error) {
397 // Get the first line of |message| from |line_start|.
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000398 std::string first_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000399 size_t line_end = message.find(kNewLine, line_start);
400 if (line_end != std::string::npos) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200401 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000402 --line_end;
403 }
404 first_line = message.substr(line_start, (line_end - line_start));
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000405 } else {
406 first_line = message.substr(line_start);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000407 }
408
409 if (error) {
410 error->line = first_line;
411 error->description = description;
412 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100413 RTC_LOG(LS_ERROR) << "Failed to parse: \"" << first_line
414 << "\". Reason: " << description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000415 return false;
416}
417
418// |line| is the failing line. The reason for the failure should be
419// provided in the |description|.
420static bool ParseFailed(const std::string& line,
421 const std::string& description,
422 SdpParseError* error) {
423 return ParseFailed(line, 0, description, error);
424}
425
426// Parses failure where the failing SDP line isn't know or there are multiple
427// failing lines.
Yves Gerey665174f2018-06-19 15:03:05 +0200428static bool ParseFailed(const std::string& description, SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000429 return ParseFailed("", description, error);
430}
431
432// |line| is the failing line. The failure is due to the fact that |line|
433// doesn't have |expected_fields| fields.
434static bool ParseFailedExpectFieldNum(const std::string& line,
435 int expected_fields,
436 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200437 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000438 description << "Expects " << expected_fields << " fields.";
439 return ParseFailed(line, description.str(), error);
440}
441
442// |line| is the failing line. The failure is due to the fact that |line| has
443// less than |expected_min_fields| fields.
444static bool ParseFailedExpectMinFieldNum(const std::string& line,
445 int expected_min_fields,
446 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200447 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000448 description << "Expects at least " << expected_min_fields << " fields.";
449 return ParseFailed(line, description.str(), error);
450}
451
452// |line| is the failing line. The failure is due to the fact that it failed to
453// get the value of |attribute|.
454static bool ParseFailedGetValue(const std::string& line,
455 const std::string& attribute,
456 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200457 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000458 description << "Failed to get the value of attribute: " << attribute;
459 return ParseFailed(line, description.str(), error);
460}
461
462// The line starting at |line_start| of |message| is the failing line. The
463// failure is due to the line type (e.g. the "m" part of the "m-line")
464// not matching what is expected. The expected line type should be
465// provided as |line_type|.
466static bool ParseFailedExpectLine(const std::string& message,
467 size_t line_start,
468 const char line_type,
469 const std::string& line_value,
470 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200471 rtc::StringBuilder description;
472 description << "Expect line: " << std::string(1, line_type) << "="
473 << line_value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000474 return ParseFailed(message, line_start, description.str(), error);
475}
476
477static bool AddLine(const std::string& line, std::string* message) {
478 if (!message)
479 return false;
480
481 message->append(line);
482 message->append(kLineBreak);
483 return true;
484}
485
486static bool GetLine(const std::string& message,
487 size_t* pos,
488 std::string* line) {
489 size_t line_begin = *pos;
490 size_t line_end = message.find(kNewLine, line_begin);
491 if (line_end == std::string::npos) {
492 return false;
493 }
494 // Update the new start position
495 *pos = line_end + 1;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200496 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000497 --line_end;
498 }
499 *line = message.substr(line_begin, (line_end - line_begin));
500 const char* cline = line->c_str();
501 // RFC 4566
502 // An SDP session description consists of a number of lines of text of
503 // the form:
504 // <type>=<value>
505 // where <type> MUST be exactly one case-significant character and
506 // <value> is structured text whose format depends on <type>.
507 // Whitespace MUST NOT be used on either side of the "=" sign.
Taylor Brandstetter93a7b242018-04-16 10:45:24 -0700508 //
509 // However, an exception to the whitespace rule is made for "s=", since
510 // RFC4566 also says:
511 //
512 // If a session has no meaningful name, the value "s= " SHOULD be used
513 // (i.e., a single space as the session name).
514 if (line->length() < 3 || !islower(cline[0]) ||
Jonas Olssonec9e4922018-09-05 09:53:49 +0200515 cline[1] != kSdpDelimiterEqualChar ||
516 (cline[0] != kLineTypeSessionName &&
517 cline[2] == kSdpDelimiterSpaceChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000518 *pos = line_begin;
519 return false;
520 }
521 return true;
522}
523
524// Init |os| to "|type|=|value|".
525static void InitLine(const char type,
526 const std::string& value,
Jonas Olssonec9e4922018-09-05 09:53:49 +0200527 rtc::StringBuilder* os) {
528 os->Clear();
529 *os << std::string(1, type) << kSdpDelimiterEqual << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000530}
531
532// Init |os| to "a=|attribute|".
Jonas Olssonec9e4922018-09-05 09:53:49 +0200533static void InitAttrLine(const std::string& attribute, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000534 InitLine(kLineTypeAttributes, attribute, os);
535}
536
Piotr (Peter) Slatalab1ae10b2019-03-01 11:14:05 -0800537// Writes an x-mt SDP attribute line based on the media transport settings.
538static void AddMediaTransportLine(
539 const cricket::SessionDescription::MediaTransportSetting& setting,
540 std::string* message) {
541 rtc::StringBuilder os;
542 InitAttrLine(kMediaTransportSettingLine, &os);
543 os << kSdpDelimiterColon << setting.transport_name << kSdpDelimiterColon
544 << rtc::Base64::Encode(setting.transport_setting);
545 AddLine(os.str(), message);
546}
547
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000548// Writes a SDP attribute line based on |attribute| and |value| to |message|.
Yves Gerey665174f2018-06-19 15:03:05 +0200549static void AddAttributeLine(const std::string& attribute,
550 int value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000551 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200552 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000553 InitAttrLine(attribute, &os);
554 os << kSdpDelimiterColon << value;
555 AddLine(os.str(), message);
556}
557
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000558static bool IsLineType(const std::string& message,
559 const char type,
560 size_t line_start) {
561 if (message.size() < line_start + kLinePrefixLength) {
562 return false;
563 }
564 const char* cmessage = message.c_str();
565 return (cmessage[line_start] == type &&
Jonas Olssonec9e4922018-09-05 09:53:49 +0200566 cmessage[line_start + 1] == kSdpDelimiterEqualChar);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000567}
568
Yves Gerey665174f2018-06-19 15:03:05 +0200569static bool IsLineType(const std::string& line, const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000570 return IsLineType(line, type, 0);
571}
572
Yves Gerey665174f2018-06-19 15:03:05 +0200573static bool GetLineWithType(const std::string& message,
574 size_t* pos,
575 std::string* line,
576 const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000577 if (!IsLineType(message, type, *pos)) {
578 return false;
579 }
580
581 if (!GetLine(message, pos, line))
582 return false;
583
584 return true;
585}
586
587static bool HasAttribute(const std::string& line,
588 const std::string& attribute) {
Johannes Kron211856b2018-09-06 12:12:28 +0200589 if (line.compare(kLinePrefixLength, attribute.size(), attribute) == 0) {
590 // Make sure that the match is not only a partial match. If length of
591 // strings doesn't match, the next character of the line must be ':' or ' '.
592 // This function is also used for media descriptions (e.g., "m=audio 9..."),
593 // hence the need to also allow space in the end.
594 RTC_CHECK_LE(kLinePrefixLength + attribute.size(), line.size());
595 if ((kLinePrefixLength + attribute.size()) == line.size() ||
596 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterColonChar ||
597 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterSpaceChar) {
598 return true;
599 }
600 }
601 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000602}
603
Peter Boström0c4e06b2015-10-07 12:23:21 +0200604static bool AddSsrcLine(uint32_t ssrc_id,
605 const std::string& attribute,
606 const std::string& value,
607 std::string* message) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000608 // RFC 5576
609 // a=ssrc:<ssrc-id> <attribute>:<value>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200610 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000611 InitAttrLine(kAttributeSsrc, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200612 os << kSdpDelimiterColon << ssrc_id << kSdpDelimiterSpace << attribute
613 << kSdpDelimiterColon << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000614 return AddLine(os.str(), message);
615}
616
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000617// Get value only from <attribute>:<value>.
Yves Gerey665174f2018-06-19 15:03:05 +0200618static bool GetValue(const std::string& message,
619 const std::string& attribute,
620 std::string* value,
621 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000622 std::string leftpart;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200623 if (!rtc::tokenize_first(message, kSdpDelimiterColonChar, &leftpart, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000624 return ParseFailedGetValue(message, attribute, error);
625 }
626 // The left part should end with the expected attribute.
627 if (leftpart.length() < attribute.length() ||
628 leftpart.compare(leftpart.length() - attribute.length(),
629 attribute.length(), attribute) != 0) {
630 return ParseFailedGetValue(message, attribute, error);
631 }
632 return true;
633}
634
635static bool CaseInsensitiveFind(std::string str1, std::string str2) {
Steve Anton64b626b2019-01-28 17:25:26 -0800636 absl::c_transform(str1, str1.begin(), ::tolower);
637 absl::c_transform(str2, str2.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000638 return str1.find(str2) != std::string::npos;
639}
640
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000641template <class T>
642static bool GetValueFromString(const std::string& line,
643 const std::string& s,
644 T* t,
645 SdpParseError* error) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000646 if (!rtc::FromString(s, t)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200647 rtc::StringBuilder description;
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000648 description << "Invalid value: " << s << ".";
649 return ParseFailed(line, description.str(), error);
650 }
651 return true;
652}
653
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000654static bool GetPayloadTypeFromString(const std::string& line,
655 const std::string& s,
656 int* payload_type,
657 SdpParseError* error) {
658 return GetValueFromString(line, s, payload_type, error) &&
Yves Gerey665174f2018-06-19 15:03:05 +0200659 cricket::IsValidRtpPayloadType(*payload_type);
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000660}
661
Seth Hampson5897a6e2018-04-03 11:16:33 -0700662// Creates a StreamParams track in the case when no SSRC lines are signaled.
663// This is a track that does not contain SSRCs and only contains
664// stream_ids/track_id if it's signaled with a=msid lines.
665void CreateTrackWithNoSsrcs(const std::vector<std::string>& msid_stream_ids,
666 const std::string& msid_track_id,
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800667 const std::vector<RidDescription>& rids,
Seth Hampson5897a6e2018-04-03 11:16:33 -0700668 StreamParamsVec* tracks) {
669 StreamParams track;
Amit Hilbuch6df49d82019-04-15 15:47:21 -0700670 if (msid_track_id.empty() && rids.empty()) {
Seth Hampson5897a6e2018-04-03 11:16:33 -0700671 // We only create an unsignaled track if a=msid lines were signaled.
Amit Hilbuch6df49d82019-04-15 15:47:21 -0700672 RTC_LOG(LS_INFO) << "MSID not signaled, skipping creation of StreamParams";
Seth Hampson5897a6e2018-04-03 11:16:33 -0700673 return;
674 }
675 track.set_stream_ids(msid_stream_ids);
676 track.id = msid_track_id;
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800677 track.set_rids(rids);
Seth Hampson5897a6e2018-04-03 11:16:33 -0700678 tracks->push_back(track);
679}
680
681// Creates the StreamParams tracks, for the case when SSRC lines are signaled.
682// |msid_stream_ids| and |msid_track_id| represent the stream/track ID from the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800683// "a=msid" attribute, if it exists. They are empty if the attribute does not
Seth Hampson5897a6e2018-04-03 11:16:33 -0700684// exist. We prioritize getting stream_ids/track_ids signaled in a=msid lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000685void CreateTracksFromSsrcInfos(const SsrcInfoVec& ssrc_infos,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700686 const std::vector<std::string>& msid_stream_ids,
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800687 const std::string& msid_track_id,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700688 StreamParamsVec* tracks,
689 int msid_signaling) {
nisseede5da42017-01-12 05:15:36 -0800690 RTC_DCHECK(tracks != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700691 for (const SsrcInfo& ssrc_info : ssrc_infos) {
692 if (ssrc_info.cname.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000693 continue;
694 }
695
Seth Hampson5b4f0752018-04-02 16:31:36 -0700696 std::vector<std::string> stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000697 std::string track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700698 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
699 // This is the case with Unified Plan SDP msid signaling.
700 stream_ids = msid_stream_ids;
Tomas Gunnarsson191bf5c2018-03-30 10:44:43 +0000701 track_id = msid_track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700702 } else if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
703 // This is the case with Plan B SDP msid signaling.
Steve Anton4daf66e2018-09-07 14:55:53 -0700704 stream_ids.push_back(ssrc_info.stream_id);
705 track_id = ssrc_info.track_id;
706 } else if (!ssrc_info.mslabel.empty()) {
Seth Hampson5b4f0752018-04-02 16:31:36 -0700707 // Since there's no a=msid or a=ssrc msid signaling, this is a sdp from
708 // an older version of client that doesn't support msid.
709 // In that case, we use the mslabel and label to construct the track.
Steve Anton4daf66e2018-09-07 14:55:53 -0700710 stream_ids.push_back(ssrc_info.mslabel);
711 track_id = ssrc_info.label;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700712 } else {
713 // Since no media streams isn't supported with older SDP signaling, we
714 // use a default a stream id.
715 stream_ids.push_back(kDefaultMsid);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000716 }
Seth Hampson5b4f0752018-04-02 16:31:36 -0700717 // If a track ID wasn't populated from the SSRC attributes OR the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800718 // msid attribute, use default/random values.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800719 if (track_id.empty()) {
720 // TODO(ronghuawu): What should we do if the track id doesn't appear?
721 // Create random string (which will be used as track label later)?
722 track_id = rtc::CreateRandomString(8);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000723 }
724
Steve Anton64b626b2019-01-28 17:25:26 -0800725 auto track_it = absl::c_find_if(
726 *tracks,
Steve Anton4daf66e2018-09-07 14:55:53 -0700727 [track_id](const StreamParams& track) { return track.id == track_id; });
728 if (track_it == tracks->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000729 // If we don't find an existing track, create a new one.
730 tracks->push_back(StreamParams());
Steve Anton4daf66e2018-09-07 14:55:53 -0700731 track_it = tracks->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000732 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700733 StreamParams& track = *track_it;
734 track.add_ssrc(ssrc_info.ssrc_id);
735 track.cname = ssrc_info.cname;
736 track.set_stream_ids(stream_ids);
737 track.id = track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000738 }
739}
740
Seth Hampson845e8782018-03-02 11:34:10 -0800741void GetMediaStreamIds(const ContentInfo* content,
742 std::set<std::string>* labels) {
Steve Antonb1c1de12017-12-21 15:14:30 -0800743 for (const StreamParams& stream_params :
744 content->media_description()->streams()) {
Seth Hampson845e8782018-03-02 11:34:10 -0800745 for (const std::string& stream_id : stream_params.stream_ids()) {
746 labels->insert(stream_id);
Steve Anton5a26a3a2018-02-28 11:38:47 -0800747 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000748 }
749}
750
751// RFC 5245
752// It is RECOMMENDED that default candidates be chosen based on the
753// likelihood of those candidates to work with the peer that is being
754// contacted. It is RECOMMENDED that relayed > reflexive > host.
755static const int kPreferenceUnknown = 0;
756static const int kPreferenceHost = 1;
757static const int kPreferenceReflexive = 2;
758static const int kPreferenceRelayed = 3;
759
760static int GetCandidatePreferenceFromType(const std::string& type) {
761 int preference = kPreferenceUnknown;
762 if (type == cricket::LOCAL_PORT_TYPE) {
763 preference = kPreferenceHost;
764 } else if (type == cricket::STUN_PORT_TYPE) {
765 preference = kPreferenceReflexive;
766 } else if (type == cricket::RELAY_PORT_TYPE) {
767 preference = kPreferenceRelayed;
768 } else {
nissec80e7412017-01-11 05:56:46 -0800769 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000770 }
771 return preference;
772}
773
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000774// Get ip and port of the default destination from the |candidates| with the
775// given value of |component_id|. The default candidate should be the one most
776// likely to work, typically IPv4 relay.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000777// RFC 5245
778// The value of |component_id| currently supported are 1 (RTP) and 2 (RTCP).
Steve Anton36b29d12017-10-30 09:57:42 -0700779// TODO(deadbeef): Decide the default destination in webrtcsession and
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000780// pass it down via SessionDescription.
Yves Gerey665174f2018-06-19 15:03:05 +0200781static void GetDefaultDestination(const std::vector<Candidate>& candidates,
782 int component_id,
783 std::string* port,
784 std::string* ip,
785 std::string* addr_type) {
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000786 *addr_type = kConnectionIpv4Addrtype;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000787 *port = kDummyPort;
788 *ip = kDummyAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000789 int current_preference = kPreferenceUnknown;
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000790 int current_family = AF_UNSPEC;
Steve Anton4daf66e2018-09-07 14:55:53 -0700791 for (const Candidate& candidate : candidates) {
792 if (candidate.component() != component_id) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000793 continue;
794 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000795 // Default destination should be UDP only.
Steve Anton4daf66e2018-09-07 14:55:53 -0700796 if (candidate.protocol() != cricket::UDP_PROTOCOL_NAME) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000797 continue;
798 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700799 const int preference = GetCandidatePreferenceFromType(candidate.type());
800 const int family = candidate.address().ipaddr().family();
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000801 // See if this candidate is more preferable then the current one if it's the
802 // same family. Or if the current family is IPv4 already so we could safely
803 // ignore all IPv6 ones. WebRTC bug 4269.
804 // http://code.google.com/p/webrtc/issues/detail?id=4269
805 if ((preference <= current_preference && current_family == family) ||
806 (current_family == AF_INET && family == AF_INET6)) {
807 continue;
808 }
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000809 if (family == AF_INET) {
810 addr_type->assign(kConnectionIpv4Addrtype);
811 } else if (family == AF_INET6) {
812 addr_type->assign(kConnectionIpv6Addrtype);
813 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000814 current_preference = preference;
815 current_family = family;
Steve Anton4daf66e2018-09-07 14:55:53 -0700816 *port = candidate.address().PortAsString();
817 *ip = candidate.address().ipaddr().ToString();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000818 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000819}
820
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000821// Gets "a=rtcp" line if found default RTCP candidate from |candidates|.
822static std::string GetRtcpLine(const std::vector<Candidate>& candidates) {
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000823 std::string rtcp_line, rtcp_port, rtcp_ip, addr_type;
Yves Gerey665174f2018-06-19 15:03:05 +0200824 GetDefaultDestination(candidates, ICE_CANDIDATE_COMPONENT_RTCP, &rtcp_port,
825 &rtcp_ip, &addr_type);
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000826 // Found default RTCP candidate.
827 // RFC 5245
828 // If the agent is utilizing RTCP, it MUST encode the RTCP candidate
829 // using the a=rtcp attribute as defined in RFC 3605.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000830
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000831 // RFC 3605
832 // rtcp-attribute = "a=rtcp:" port [nettype space addrtype space
833 // connection-address] CRLF
Jonas Olssonec9e4922018-09-05 09:53:49 +0200834 rtc::StringBuilder os;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000835 InitAttrLine(kAttributeRtcp, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200836 os << kSdpDelimiterColon << rtcp_port << " " << kConnectionNettype << " "
837 << addr_type << " " << rtcp_ip;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000838 rtcp_line = os.str();
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000839 return rtcp_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000840}
841
842// Get candidates according to the mline index from SessionDescriptionInterface.
843static void GetCandidatesByMindex(const SessionDescriptionInterface& desci,
844 int mline_index,
845 std::vector<Candidate>* candidates) {
846 if (!candidates) {
847 return;
848 }
849 const IceCandidateCollection* cc = desci.candidates(mline_index);
850 for (size_t i = 0; i < cc->count(); ++i) {
851 const IceCandidateInterface* candidate = cc->at(i);
852 candidates->push_back(candidate->candidate());
853 }
854}
855
deadbeef90f1e1e2017-02-10 12:35:05 -0800856static bool IsValidPort(int port) {
857 return port >= 0 && port <= 65535;
858}
859
Steve Antone831b8c2018-02-01 12:22:16 -0800860std::string SdpSerialize(const JsepSessionDescription& jdesc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000861 const cricket::SessionDescription* desc = jdesc.description();
862 if (!desc) {
863 return "";
864 }
865
866 std::string message;
867
868 // Session Description.
869 AddLine(kSessionVersion, &message);
870 // Session Origin
871 // RFC 4566
872 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
873 // <unicast-address>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200874 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000875 InitLine(kLineTypeOrigin, kSessionOriginUsername, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200876 const std::string& session_id =
877 jdesc.session_id().empty() ? kSessionOriginSessionId : jdesc.session_id();
878 const std::string& session_version = jdesc.session_version().empty()
879 ? kSessionOriginSessionVersion
880 : jdesc.session_version();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000881 os << " " << session_id << " " << session_version << " "
882 << kSessionOriginNettype << " " << kSessionOriginAddrtype << " "
883 << kSessionOriginAddress;
884 AddLine(os.str(), &message);
885 AddLine(kSessionName, &message);
886
887 // Time Description.
888 AddLine(kTimeDescription, &message);
889
Piotr (Peter) Slatalab1ae10b2019-03-01 11:14:05 -0800890 for (const cricket::SessionDescription::MediaTransportSetting& settings :
891 desc->MediaTransportSettings()) {
892 AddMediaTransportLine(settings, &message);
893 }
894
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000895 // Group
896 if (desc->HasGroup(cricket::GROUP_TYPE_BUNDLE)) {
897 std::string group_line = kAttrGroup;
898 const cricket::ContentGroup* group =
899 desc->GetGroupByName(cricket::GROUP_TYPE_BUNDLE);
nisseede5da42017-01-12 05:15:36 -0800900 RTC_DCHECK(group != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700901 for (const std::string& content_name : group->content_names()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000902 group_line.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -0700903 group_line.append(content_name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000904 }
905 AddLine(group_line, &message);
906 }
907
Johannes Kron0854eb62018-10-10 22:33:20 +0200908 // Mixed one- and two-byte header extension.
Johannes Kron9581bc42018-10-23 10:17:39 +0200909 if (desc->extmap_allow_mixed()) {
Johannes Kron0854eb62018-10-10 22:33:20 +0200910 InitAttrLine(kAttributeExtmapAllowMixed, &os);
911 AddLine(os.str(), &message);
912 }
913
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000914 // MediaStream semantics
915 InitAttrLine(kAttributeMsidSemantics, &os);
916 os << kSdpDelimiterColon << " " << kMediaStreamSemantic;
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000917
Seth Hampson845e8782018-03-02 11:34:10 -0800918 std::set<std::string> media_stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000919 const ContentInfo* audio_content = GetFirstAudioContent(desc);
920 if (audio_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800921 GetMediaStreamIds(audio_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000922
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000923 const ContentInfo* video_content = GetFirstVideoContent(desc);
924 if (video_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800925 GetMediaStreamIds(video_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000926
Steve Anton4daf66e2018-09-07 14:55:53 -0700927 for (const std::string& id : media_stream_ids) {
928 os << " " << id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000929 }
930 AddLine(os.str(), &message);
931
Taylor Brandstetter2f65ec52018-05-24 11:37:28 -0700932 // a=ice-lite
933 //
934 // TODO(deadbeef): It's weird that we need to iterate TransportInfos for
935 // this, when it's a session-level attribute. It really should be moved to a
936 // session-level structure like SessionDescription.
937 for (const cricket::TransportInfo& transport : desc->transport_infos()) {
938 if (transport.description.ice_mode == cricket::ICEMODE_LITE) {
939 InitAttrLine(kAttributeIceLite, &os);
940 AddLine(os.str(), &message);
941 break;
942 }
943 }
944
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000945 // Preserve the order of the media contents.
946 int mline_index = -1;
Steve Anton4daf66e2018-09-07 14:55:53 -0700947 for (const ContentInfo& content : desc->contents()) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000948 std::vector<Candidate> candidates;
949 GetCandidatesByMindex(jdesc, ++mline_index, &candidates);
Steve Anton4daf66e2018-09-07 14:55:53 -0700950 BuildMediaDescription(&content, desc->GetTransportInfoByName(content.name),
951 content.media_description()->type(), candidates,
952 desc->msid_signaling(), &message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000953 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000954 return message;
955}
956
957// Serializes the passed in IceCandidateInterface to a SDP string.
958// candidate - The candidate to be serialized.
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700959std::string SdpSerializeCandidate(const IceCandidateInterface& candidate) {
960 return SdpSerializeCandidate(candidate.candidate());
961}
962
963// Serializes a cricket Candidate.
964std::string SdpSerializeCandidate(const cricket::Candidate& candidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000965 std::string message;
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700966 std::vector<cricket::Candidate> candidates(1, candidate);
honghaiza54a0802015-12-16 18:37:23 -0800967 BuildCandidate(candidates, true, &message);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000968 // From WebRTC draft section 4.8.1.1 candidate-attribute will be
969 // just candidate:<candidate> not a=candidate:<blah>CRLF
nisseede5da42017-01-12 05:15:36 -0800970 RTC_DCHECK(message.find("a=") == 0);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000971 message.erase(0, 2);
nisseede5da42017-01-12 05:15:36 -0800972 RTC_DCHECK(message.find(kLineBreak) == message.size() - 2);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000973 message.resize(message.size() - 2);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000974 return message;
975}
976
977bool SdpDeserialize(const std::string& message,
978 JsepSessionDescription* jdesc,
979 SdpParseError* error) {
980 std::string session_id;
981 std::string session_version;
Peter Thatcher7cbd1882015-09-17 18:54:52 -0700982 TransportDescription session_td("", "");
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000983 RtpHeaderExtensions session_extmaps;
zhihuang38989e52017-03-21 11:04:53 -0700984 rtc::SocketAddress session_connection_addr;
Steve Anton5a1de872018-12-18 11:25:55 -0800985 auto desc = absl::make_unique<cricket::SessionDescription>();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000986 size_t current_pos = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000987
988 // Session Description
989 if (!ParseSessionDescription(message, &current_pos, &session_id,
deadbeefc80741f2015-10-22 13:14:45 -0700990 &session_version, &session_td, &session_extmaps,
Steve Anton5a1de872018-12-18 11:25:55 -0800991 &session_connection_addr, desc.get(), error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000992 return false;
993 }
994
995 // Media Description
Steve Anton5a1de872018-12-18 11:25:55 -0800996 std::vector<std::unique_ptr<JsepIceCandidate>> candidates;
deadbeefc80741f2015-10-22 13:14:45 -0700997 if (!ParseMediaDescription(message, session_td, session_extmaps, &current_pos,
Steve Anton5a1de872018-12-18 11:25:55 -0800998 session_connection_addr, desc.get(), &candidates,
zhihuang38989e52017-03-21 11:04:53 -0700999 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001000 return false;
1001 }
1002
Harald Alvestrand4d7160e2019-04-12 07:01:29 +02001003 jdesc->Initialize(std::move(desc), session_id, session_version);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001004
Steve Anton5a1de872018-12-18 11:25:55 -08001005 for (const auto& candidate : candidates) {
1006 jdesc->AddCandidate(candidate.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001007 }
1008 return true;
1009}
1010
1011bool SdpDeserializeCandidate(const std::string& message,
1012 JsepIceCandidate* jcandidate,
1013 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08001014 RTC_DCHECK(jcandidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001015 Candidate candidate;
1016 if (!ParseCandidate(message, &candidate, error, true)) {
1017 return false;
1018 }
1019 jcandidate->SetCandidate(candidate);
1020 return true;
1021}
1022
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001023bool SdpDeserializeCandidate(const std::string& transport_name,
1024 const std::string& message,
1025 cricket::Candidate* candidate,
1026 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08001027 RTC_DCHECK(candidate != nullptr);
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001028 if (!ParseCandidate(message, candidate, error, true)) {
1029 return false;
1030 }
1031 candidate->set_transport_name(transport_name);
1032 return true;
1033}
1034
Yves Gerey665174f2018-06-19 15:03:05 +02001035bool ParseCandidate(const std::string& message,
1036 Candidate* candidate,
1037 SdpParseError* error,
1038 bool is_raw) {
nisseede5da42017-01-12 05:15:36 -08001039 RTC_DCHECK(candidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001040
1041 // Get the first line from |message|.
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001042 std::string first_line = message;
1043 size_t pos = 0;
1044 GetLine(message, &pos, &first_line);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001045
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001046 // Makes sure |message| contains only one line.
1047 if (message.size() > first_line.size()) {
1048 std::string left, right;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001049 if (rtc::tokenize_first(message, kNewLineChar, &left, &right) &&
Donald Curtis0e07f922015-05-15 09:21:23 -07001050 !right.empty()) {
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001051 return ParseFailed(message, 0, "Expect one line only", error);
1052 }
1053 }
1054
1055 // From WebRTC draft section 4.8.1.1 candidate-attribute should be
1056 // candidate:<candidate> when trickled, but we still support
1057 // a=candidate:<blah>CRLF for backward compatibility and for parsing a line
1058 // from the SDP.
1059 if (IsLineType(first_line, kLineTypeAttributes)) {
1060 first_line = first_line.substr(kLinePrefixLength);
1061 }
1062
1063 std::string attribute_candidate;
1064 std::string candidate_value;
1065
1066 // |first_line| must be in the form of "candidate:<value>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001067 if (!rtc::tokenize_first(first_line, kSdpDelimiterColonChar,
1068 &attribute_candidate, &candidate_value) ||
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001069 attribute_candidate != kAttributeCandidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001070 if (is_raw) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001071 rtc::StringBuilder description;
Yves Gerey665174f2018-06-19 15:03:05 +02001072 description << "Expect line: " << kAttributeCandidate << ":"
1073 << "<candidate-str>";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001074 return ParseFailed(first_line, 0, description.str(), error);
1075 } else {
1076 return ParseFailedExpectLine(first_line, 0, kLineTypeAttributes,
1077 kAttributeCandidate, error);
1078 }
1079 }
1080
1081 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001082 rtc::split(candidate_value, kSdpDelimiterSpaceChar, &fields);
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001083
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001084 // RFC 5245
1085 // a=candidate:<foundation> <component-id> <transport> <priority>
1086 // <connection-address> <port> typ <candidate-types>
1087 // [raddr <connection-address>] [rport <port>]
1088 // *(SP extension-att-name SP extension-att-value)
1089 const size_t expected_min_fields = 8;
1090 if (fields.size() < expected_min_fields ||
1091 (fields[6] != kAttributeCandidateTyp)) {
1092 return ParseFailedExpectMinFieldNum(first_line, expected_min_fields, error);
1093 }
jbauch083b73f2015-07-16 02:46:32 -07001094 const std::string& foundation = fields[0];
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001095
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001096 int component_id = 0;
1097 if (!GetValueFromString(first_line, fields[1], &component_id, error)) {
1098 return false;
1099 }
jbauch083b73f2015-07-16 02:46:32 -07001100 const std::string& transport = fields[2];
Peter Boström0c4e06b2015-10-07 12:23:21 +02001101 uint32_t priority = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001102 if (!GetValueFromString(first_line, fields[3], &priority, error)) {
1103 return false;
1104 }
jbauch083b73f2015-07-16 02:46:32 -07001105 const std::string& connection_address = fields[4];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001106 int port = 0;
1107 if (!GetValueFromString(first_line, fields[5], &port, error)) {
1108 return false;
1109 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001110 if (!IsValidPort(port)) {
1111 return ParseFailed(first_line, "Invalid port number.", error);
1112 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001113 SocketAddress address(connection_address, port);
1114
1115 cricket::ProtocolType protocol;
hnslb68cc752016-12-13 10:33:41 -08001116 if (!StringToProto(transport.c_str(), &protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001117 return ParseFailed(first_line, "Unsupported transport type.", error);
1118 }
hnslb68cc752016-12-13 10:33:41 -08001119 switch (protocol) {
1120 case cricket::PROTO_UDP:
1121 case cricket::PROTO_TCP:
1122 case cricket::PROTO_SSLTCP:
1123 // Supported protocol.
1124 break;
1125 default:
1126 return ParseFailed(first_line, "Unsupported transport type.", error);
1127 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001128
1129 std::string candidate_type;
jbauch083b73f2015-07-16 02:46:32 -07001130 const std::string& type = fields[7];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001131 if (type == kCandidateHost) {
1132 candidate_type = cricket::LOCAL_PORT_TYPE;
1133 } else if (type == kCandidateSrflx) {
1134 candidate_type = cricket::STUN_PORT_TYPE;
1135 } else if (type == kCandidateRelay) {
1136 candidate_type = cricket::RELAY_PORT_TYPE;
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001137 } else if (type == kCandidatePrflx) {
1138 candidate_type = cricket::PRFLX_PORT_TYPE;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001139 } else {
1140 return ParseFailed(first_line, "Unsupported candidate type.", error);
1141 }
1142
1143 size_t current_position = expected_min_fields;
1144 SocketAddress related_address;
1145 // The 2 optional fields for related address
1146 // [raddr <connection-address>] [rport <port>]
1147 if (fields.size() >= (current_position + 2) &&
1148 fields[current_position] == kAttributeCandidateRaddr) {
1149 related_address.SetIP(fields[++current_position]);
1150 ++current_position;
1151 }
1152 if (fields.size() >= (current_position + 2) &&
1153 fields[current_position] == kAttributeCandidateRport) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001154 int port = 0;
Yves Gerey665174f2018-06-19 15:03:05 +02001155 if (!GetValueFromString(first_line, fields[++current_position], &port,
1156 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001157 return false;
1158 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001159 if (!IsValidPort(port)) {
1160 return ParseFailed(first_line, "Invalid port number.", error);
1161 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001162 related_address.SetPort(port);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001163 ++current_position;
1164 }
1165
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001166 // If this is a TCP candidate, it has additional extension as defined in
1167 // RFC 6544.
1168 std::string tcptype;
1169 if (fields.size() >= (current_position + 2) &&
1170 fields[current_position] == kTcpCandidateType) {
1171 tcptype = fields[++current_position];
1172 ++current_position;
1173
1174 if (tcptype != cricket::TCPTYPE_ACTIVE_STR &&
1175 tcptype != cricket::TCPTYPE_PASSIVE_STR &&
1176 tcptype != cricket::TCPTYPE_SIMOPEN_STR) {
1177 return ParseFailed(first_line, "Invalid TCP candidate type.", error);
1178 }
1179
1180 if (protocol != cricket::PROTO_TCP) {
1181 return ParseFailed(first_line, "Invalid non-TCP candidate", error);
1182 }
1183 }
1184
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001185 // Extension
honghaiza54a0802015-12-16 18:37:23 -08001186 // Though non-standard, we support the ICE ufrag and pwd being signaled on
1187 // the candidate to avoid issues with confusing which generation a candidate
1188 // belongs to when trickling multiple generations at the same time.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001189 std::string username;
1190 std::string password;
Peter Boström0c4e06b2015-10-07 12:23:21 +02001191 uint32_t generation = 0;
honghaiza0c44ea2016-03-23 16:07:48 -07001192 uint16_t network_id = 0;
1193 uint16_t network_cost = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001194 for (size_t i = current_position; i + 1 < fields.size(); ++i) {
1195 // RFC 5245
1196 // *(SP extension-att-name SP extension-att-value)
1197 if (fields[i] == kAttributeCandidateGeneration) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001198 if (!GetValueFromString(first_line, fields[++i], &generation, error)) {
1199 return false;
1200 }
honghaiza54a0802015-12-16 18:37:23 -08001201 } else if (fields[i] == kAttributeCandidateUfrag) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001202 username = fields[++i];
honghaiza54a0802015-12-16 18:37:23 -08001203 } else if (fields[i] == kAttributeCandidatePwd) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001204 password = fields[++i];
honghaiza0c44ea2016-03-23 16:07:48 -07001205 } else if (fields[i] == kAttributeCandidateNetworkId) {
1206 if (!GetValueFromString(first_line, fields[++i], &network_id, error)) {
1207 return false;
1208 }
honghaize1a0c942016-02-16 14:54:56 -08001209 } else if (fields[i] == kAttributeCandidateNetworkCost) {
1210 if (!GetValueFromString(first_line, fields[++i], &network_cost, error)) {
1211 return false;
1212 }
Honghai Zhang351d77b2016-05-20 15:08:29 -07001213 network_cost = std::min(network_cost, rtc::kNetworkCostMax);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001214 } else {
1215 // Skip the unknown extension.
1216 ++i;
1217 }
1218 }
1219
guoweis@webrtc.org61c12472015-01-15 06:53:07 +00001220 *candidate = Candidate(component_id, cricket::ProtoToString(protocol),
guoweis@webrtc.org950c5182014-12-16 23:01:31 +00001221 address, priority, username, password, candidate_type,
honghaiza0c44ea2016-03-23 16:07:48 -07001222 generation, foundation, network_id, network_cost);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001223 candidate->set_related_address(related_address);
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001224 candidate->set_tcptype(tcptype);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001225 return true;
1226}
1227
1228bool ParseIceOptions(const std::string& line,
1229 std::vector<std::string>* transport_options,
1230 SdpParseError* error) {
1231 std::string ice_options;
1232 if (!GetValue(line, kAttributeIceOption, &ice_options, error)) {
1233 return false;
1234 }
1235 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001236 rtc::split(ice_options, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001237 for (size_t i = 0; i < fields.size(); ++i) {
1238 transport_options->push_back(fields[i]);
1239 }
1240 return true;
1241}
1242
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001243bool ParseSctpPort(const std::string& line,
1244 int* sctp_port,
1245 SdpParseError* error) {
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02001246 // draft-ietf-mmusic-sctp-sdp-26
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001247 // a=sctp-port
1248 std::vector<std::string> fields;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001249 const size_t expected_min_fields = 2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001250 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
lally69f57602015-10-08 10:15:04 -07001251 if (fields.size() < expected_min_fields) {
1252 fields.resize(0);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001253 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
lally69f57602015-10-08 10:15:04 -07001254 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001255 if (fields.size() < expected_min_fields) {
1256 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1257 }
1258 if (!rtc::FromString(fields[1], sctp_port)) {
lally69f57602015-10-08 10:15:04 -07001259 return ParseFailed(line, "Invalid sctp port value.", error);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001260 }
1261 return true;
1262}
1263
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02001264bool ParseSctpMaxMessageSize(const std::string& line,
1265 int* max_message_size,
1266 SdpParseError* error) {
1267 // draft-ietf-mmusic-sctp-sdp-26
1268 // a=max-message-size:199999
1269 std::vector<std::string> fields;
1270 const size_t expected_min_fields = 2;
1271 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
1272 if (fields.size() < expected_min_fields) {
1273 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1274 }
1275 if (!rtc::FromString(fields[1], max_message_size)) {
1276 return ParseFailed(line, "Invalid SCTP max message size.", error);
1277 }
1278 return true;
1279}
1280
isheriff6f8d6862016-05-26 11:24:55 -07001281bool ParseExtmap(const std::string& line,
1282 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001283 SdpParseError* error) {
1284 // RFC 5285
1285 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1286 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001287 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001288 const size_t expected_min_fields = 2;
1289 if (fields.size() < expected_min_fields) {
1290 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1291 }
1292 std::string uri = fields[1];
1293
1294 std::string value_direction;
1295 if (!GetValue(fields[0], kAttributeExtmap, &value_direction, error)) {
1296 return false;
1297 }
1298 std::vector<std::string> sub_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001299 rtc::split(value_direction, kSdpDelimiterSlashChar, &sub_fields);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001300 int value = 0;
1301 if (!GetValueFromString(line, sub_fields[0], &value, error)) {
1302 return false;
1303 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001304
jbauch5869f502017-06-29 12:31:36 -07001305 bool encrypted = false;
1306 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1307 // RFC 6904
Steve Anton36b29d12017-10-30 09:57:42 -07001308 // a=extmap:<value["/"<direction>] urn:ietf:params:rtp-hdrext:encrypt <URI>
1309 // <extensionattributes>
jbauch5869f502017-06-29 12:31:36 -07001310 const size_t expected_min_fields_encrypted = expected_min_fields + 1;
1311 if (fields.size() < expected_min_fields_encrypted) {
1312 return ParseFailedExpectMinFieldNum(line, expected_min_fields_encrypted,
Yves Gerey665174f2018-06-19 15:03:05 +02001313 error);
jbauch5869f502017-06-29 12:31:36 -07001314 }
1315
1316 encrypted = true;
1317 uri = fields[2];
1318 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1319 return ParseFailed(line, "Recursive encrypted header.", error);
1320 }
1321 }
1322
1323 *extmap = RtpExtension(uri, value, encrypted);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001324 return true;
1325}
1326
1327void BuildMediaDescription(const ContentInfo* content_info,
1328 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001329 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001330 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -08001331 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001332 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001333 RTC_DCHECK(message != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001334 if (content_info == NULL || message == NULL) {
1335 return;
1336 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001337 rtc::StringBuilder os;
Steve Antonb1c1de12017-12-21 15:14:30 -08001338 const MediaContentDescription* media_desc = content_info->media_description();
1339 RTC_DCHECK(media_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001340
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001341 // RFC 4566
1342 // m=<media> <port> <proto> <fmt>
1343 // fmt is a list of payload type numbers that MAY be used in the session.
1344 const char* type = NULL;
1345 if (media_type == cricket::MEDIA_TYPE_AUDIO)
1346 type = kMediaTypeAudio;
1347 else if (media_type == cricket::MEDIA_TYPE_VIDEO)
1348 type = kMediaTypeVideo;
1349 else if (media_type == cricket::MEDIA_TYPE_DATA)
1350 type = kMediaTypeData;
1351 else
nissec80e7412017-01-11 05:56:46 -08001352 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001353
1354 std::string fmt;
1355 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001356 const VideoContentDescription* video_desc = media_desc->as_video();
Steve Anton4daf66e2018-09-07 14:55:53 -07001357 for (const cricket::VideoCodec& codec : video_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001358 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001359 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001360 }
1361 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001362 const AudioContentDescription* audio_desc = media_desc->as_audio();
Steve Anton4daf66e2018-09-07 14:55:53 -07001363 for (const cricket::AudioCodec& codec : audio_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001364 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001365 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001366 }
1367 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001368 if (IsDtlsSctp(media_desc->protocol())) {
Harald Alvestrand26bf7c42019-04-23 05:20:17 +00001369 const cricket::SctpDataContentDescription* data_desc =
1370 media_desc->as_sctp();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001371 fmt.append(" ");
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001372
zstein4b2e0822017-02-17 19:48:38 -08001373 if (data_desc->use_sctpmap()) {
Harald Alvestrand26bf7c42019-04-23 05:20:17 +00001374 fmt.append(rtc::ToString(data_desc->port()));
zstein4b2e0822017-02-17 19:48:38 -08001375 } else {
1376 fmt.append(kDefaultSctpmapProtocol);
1377 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001378 } else {
Harald Alvestrand26bf7c42019-04-23 05:20:17 +00001379 const DataContentDescription* data_desc = media_desc->as_data();
Steve Anton4daf66e2018-09-07 14:55:53 -07001380 for (const cricket::DataCodec& codec : data_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001381 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001382 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001383 }
1384 }
1385 }
1386 // The fmt must never be empty. If no codecs are found, set the fmt attribute
1387 // to 0.
1388 if (fmt.empty()) {
1389 fmt = " 0";
1390 }
1391
deadbeef25ed4352016-12-12 18:37:36 -08001392 // The port number in the m line will be updated later when associated with
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001393 // the candidates.
deadbeef25ed4352016-12-12 18:37:36 -08001394 //
1395 // A port value of 0 indicates that the m= section is rejected.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001396 // RFC 3264
1397 // To reject an offered stream, the port number in the corresponding stream in
1398 // the answer MUST be set to zero.
deadbeef25ed4352016-12-12 18:37:36 -08001399 //
1400 // However, the BUNDLE draft adds a new meaning to port zero, when used along
1401 // with a=bundle-only.
zhihuang38989e52017-03-21 11:04:53 -07001402 std::string port = kDummyPort;
1403 if (content_info->rejected || content_info->bundle_only) {
1404 port = kMediaPortRejected;
1405 } else if (!media_desc->connection_address().IsNil()) {
1406 port = rtc::ToString(media_desc->connection_address().port());
1407 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001408
Yves Gerey665174f2018-06-19 15:03:05 +02001409 rtc::SSLFingerprint* fp =
1410 (transport_info) ? transport_info->description.identity_fingerprint.get()
1411 : NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001412
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001413 // Add the m and c lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001414 InitLine(kLineTypeMedia, type, &os);
1415 os << " " << port << " " << media_desc->protocol() << fmt;
zhihuang38989e52017-03-21 11:04:53 -07001416 AddLine(os.str(), message);
1417
1418 InitLine(kLineTypeConnection, kConnectionNettype, &os);
1419 if (media_desc->connection_address().IsNil()) {
1420 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
1421 } else if (media_desc->connection_address().family() == AF_INET) {
1422 os << " " << kConnectionIpv4Addrtype << " "
1423 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 12:53:06 -08001424 } else if (media_desc->connection_address().family() == AF_INET6) {
zhihuang38989e52017-03-21 11:04:53 -07001425 os << " " << kConnectionIpv6Addrtype << " "
1426 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 12:53:06 -08001427 } else if (!media_desc->connection_address().hostname().empty()) {
1428 // For hostname candidates, we use c=IN IP4 <hostname>.
1429 os << " " << kConnectionIpv4Addrtype << " "
1430 << media_desc->connection_address().hostname();
1431 } else {
1432 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
zhihuang38989e52017-03-21 11:04:53 -07001433 }
1434 AddLine(os.str(), message);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001435
1436 // RFC 4566
1437 // b=AS:<bandwidth>
Peter Thatcherc0c3a862015-06-24 15:31:25 -07001438 if (media_desc->bandwidth() >= 1000) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001439 InitLine(kLineTypeSessionBandwidth, kApplicationSpecificMaximum, &os);
1440 os << kSdpDelimiterColon << (media_desc->bandwidth() / 1000);
1441 AddLine(os.str(), message);
1442 }
1443
deadbeef25ed4352016-12-12 18:37:36 -08001444 // Add the a=bundle-only line.
1445 if (content_info->bundle_only) {
1446 InitAttrLine(kAttributeBundleOnly, &os);
1447 AddLine(os.str(), message);
1448 }
1449
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001450 // Add the a=rtcp line.
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001451 if (IsRtp(media_desc->protocol())) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001452 std::string rtcp_line = GetRtcpLine(candidates);
1453 if (!rtcp_line.empty()) {
1454 AddLine(rtcp_line, message);
1455 }
1456 }
1457
honghaiza54a0802015-12-16 18:37:23 -08001458 // Build the a=candidate lines. We don't include ufrag and pwd in the
1459 // candidates in the SDP to avoid redundancy.
1460 BuildCandidate(candidates, false, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001461
1462 // Use the transport_info to build the media level ice-ufrag and ice-pwd.
1463 if (transport_info) {
1464 // RFC 5245
1465 // ice-pwd-att = "ice-pwd" ":" password
1466 // ice-ufrag-att = "ice-ufrag" ":" ufrag
1467 // ice-ufrag
deadbeef3f7219b2015-12-28 15:17:14 -08001468 if (!transport_info->description.ice_ufrag.empty()) {
1469 InitAttrLine(kAttributeIceUfrag, &os);
1470 os << kSdpDelimiterColon << transport_info->description.ice_ufrag;
1471 AddLine(os.str(), message);
1472 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001473 // ice-pwd
deadbeef3f7219b2015-12-28 15:17:14 -08001474 if (!transport_info->description.ice_pwd.empty()) {
1475 InitAttrLine(kAttributeIcePwd, &os);
1476 os << kSdpDelimiterColon << transport_info->description.ice_pwd;
1477 AddLine(os.str(), message);
1478 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001479
1480 // draft-petithuguenin-mmusic-ice-attributes-level-03
1481 BuildIceOptions(transport_info->description.transport_options, message);
1482
1483 // RFC 4572
1484 // fingerprint-attribute =
1485 // "fingerprint" ":" hash-func SP fingerprint
1486 if (fp) {
1487 // Insert the fingerprint attribute.
1488 InitAttrLine(kAttributeFingerprint, &os);
Yves Gerey665174f2018-06-19 15:03:05 +02001489 os << kSdpDelimiterColon << fp->algorithm << kSdpDelimiterSpace
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001490 << fp->GetRfc4572Fingerprint();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001491 AddLine(os.str(), message);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001492
1493 // Inserting setup attribute.
1494 if (transport_info->description.connection_role !=
Yves Gerey665174f2018-06-19 15:03:05 +02001495 cricket::CONNECTIONROLE_NONE) {
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001496 // Making sure we are not using "passive" mode.
1497 cricket::ConnectionRole role =
1498 transport_info->description.connection_role;
mallinath@webrtc.org19f27e62013-10-13 17:18:27 +00001499 std::string dtls_role_str;
nissec16fa5e2017-02-07 07:18:43 -08001500 const bool success =
1501 cricket::ConnectionRoleToString(role, &dtls_role_str);
1502 RTC_DCHECK(success);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001503 InitAttrLine(kAttributeSetup, &os);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001504 os << kSdpDelimiterColon << dtls_role_str;
1505 AddLine(os.str(), message);
1506 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001507 }
1508 }
1509
1510 // RFC 3388
1511 // mid-attribute = "a=mid:" identification-tag
1512 // identification-tag = token
1513 // Use the content name as the mid identification-tag.
1514 InitAttrLine(kAttributeMid, &os);
1515 os << kSdpDelimiterColon << content_info->name;
1516 AddLine(os.str(), message);
1517
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001518 if (IsDtlsSctp(media_desc->protocol())) {
Harald Alvestrand26bf7c42019-04-23 05:20:17 +00001519 const cricket::SctpDataContentDescription* data_desc =
1520 media_desc->as_sctp();
zstein4b2e0822017-02-17 19:48:38 -08001521 bool use_sctpmap = data_desc->use_sctpmap();
Harald Alvestrand26bf7c42019-04-23 05:20:17 +00001522 BuildSctpContentAttributes(message, data_desc->port(), use_sctpmap);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00001523 } else if (IsRtp(media_desc->protocol())) {
Steve Antone831b8c2018-02-01 12:22:16 -08001524 BuildRtpContentAttributes(media_desc, media_type, msid_signaling, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001525 }
1526}
1527
zstein4b2e0822017-02-17 19:48:38 -08001528void BuildSctpContentAttributes(std::string* message,
1529 int sctp_port,
1530 bool use_sctpmap) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001531 rtc::StringBuilder os;
zstein4b2e0822017-02-17 19:48:38 -08001532 if (use_sctpmap) {
1533 // draft-ietf-mmusic-sctp-sdp-04
1534 // a=sctpmap:sctpmap-number protocol [streams]
1535 InitAttrLine(kAttributeSctpmap, &os);
1536 os << kSdpDelimiterColon << sctp_port << kSdpDelimiterSpace
1537 << kDefaultSctpmapProtocol << kSdpDelimiterSpace
1538 << cricket::kMaxSctpStreams;
1539 } else {
1540 // draft-ietf-mmusic-sctp-sdp-23
1541 // a=sctp-port:<port>
1542 InitAttrLine(kAttributeSctpPort, &os);
1543 os << kSdpDelimiterColon << sctp_port;
1544 // TODO(zstein): emit max-message-size here
1545 }
wu@webrtc.org78187522013-10-07 23:32:02 +00001546 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001547}
1548
deadbeef9d3584c2016-02-16 17:54:10 -08001549void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001550 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -08001551 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -08001552 std::string* message) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001553 SdpSerializer serializer;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001554 rtc::StringBuilder os;
Johannes Kron0854eb62018-10-10 22:33:20 +02001555 // RFC 8285
1556 // a=extmap-allow-mixed
1557 // The attribute MUST be either on session level or media level. We support
1558 // responding on both levels, however, we don't respond on media level if it's
1559 // set on session level.
Johannes Kron9581bc42018-10-23 10:17:39 +02001560 if (media_desc->extmap_allow_mixed_enum() ==
Johannes Kron0854eb62018-10-10 22:33:20 +02001561 MediaContentDescription::kMedia) {
1562 InitAttrLine(kAttributeExtmapAllowMixed, &os);
1563 AddLine(os.str(), message);
1564 }
1565 // RFC 8285
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001566 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1567 // The definitions MUST be either all session level or all media level. This
1568 // implementation uses all media level.
1569 for (size_t i = 0; i < media_desc->rtp_header_extensions().size(); ++i) {
jbauch5869f502017-06-29 12:31:36 -07001570 const RtpExtension& extension = media_desc->rtp_header_extensions()[i];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001571 InitAttrLine(kAttributeExtmap, &os);
jbauch5869f502017-06-29 12:31:36 -07001572 os << kSdpDelimiterColon << extension.id;
1573 if (extension.encrypt) {
1574 os << kSdpDelimiterSpace << RtpExtension::kEncryptHeaderExtensionsUri;
1575 }
1576 os << kSdpDelimiterSpace << extension.uri;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001577 AddLine(os.str(), message);
1578 }
1579
1580 // RFC 3264
1581 // a=sendrecv || a=sendonly || a=sendrecv || a=inactive
deadbeefc80741f2015-10-22 13:14:45 -07001582 switch (media_desc->direction()) {
Steve Anton4e70a722017-11-28 14:57:10 -08001583 case RtpTransceiverDirection::kInactive:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001584 InitAttrLine(kAttributeInactive, &os);
1585 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001586 case RtpTransceiverDirection::kSendOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001587 InitAttrLine(kAttributeSendOnly, &os);
1588 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001589 case RtpTransceiverDirection::kRecvOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001590 InitAttrLine(kAttributeRecvOnly, &os);
1591 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001592 case RtpTransceiverDirection::kSendRecv:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001593 default:
1594 InitAttrLine(kAttributeSendRecv, &os);
1595 break;
1596 }
1597 AddLine(os.str(), message);
1598
Seth Hampson5b4f0752018-04-02 16:31:36 -07001599 // Specified in https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
1600 // a=msid:<msid-id> <msid-appdata>
1601 // The msid-id is a 1*64 token char representing the media stream id, and the
1602 // msid-appdata is a 1*64 token char representing the track id. There is a
1603 // line for every media stream, with a special msid-id value of "-"
1604 // representing no streams. The value of "msid-appdata" MUST be identical for
1605 // all lines.
Steve Antone831b8c2018-02-01 12:22:16 -08001606 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
1607 const StreamParamsVec& streams = media_desc->streams();
1608 if (streams.size() == 1u) {
1609 const StreamParams& track = streams[0];
Seth Hampson5b4f0752018-04-02 16:31:36 -07001610 std::vector<std::string> stream_ids = track.stream_ids();
1611 if (stream_ids.empty()) {
1612 stream_ids.push_back(kNoStreamMsid);
1613 }
1614 for (const std::string& stream_id : stream_ids) {
1615 InitAttrLine(kAttributeMsid, &os);
1616 os << kSdpDelimiterColon << stream_id << kSdpDelimiterSpace << track.id;
1617 AddLine(os.str(), message);
1618 }
Steve Antone831b8c2018-02-01 12:22:16 -08001619 } else if (streams.size() > 1u) {
1620 RTC_LOG(LS_WARNING)
1621 << "Trying to serialize Unified Plan SDP with more than "
Jonas Olsson45cc8902018-02-13 10:37:07 +01001622 "one track in a media section. Omitting 'a=msid'.";
deadbeef9d3584c2016-02-16 17:54:10 -08001623 }
1624 }
1625
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001626 // RFC 5761
1627 // a=rtcp-mux
1628 if (media_desc->rtcp_mux()) {
1629 InitAttrLine(kAttributeRtcpMux, &os);
1630 AddLine(os.str(), message);
1631 }
1632
deadbeef13871492015-12-09 12:37:51 -08001633 // RFC 5506
1634 // a=rtcp-rsize
1635 if (media_desc->rtcp_reduced_size()) {
1636 InitAttrLine(kAttributeRtcpReducedSize, &os);
1637 AddLine(os.str(), message);
1638 }
1639
deadbeefd45aea82017-09-16 01:24:29 -07001640 if (media_desc->conference_mode()) {
1641 InitAttrLine(kAttributeXGoogleFlag, &os);
1642 os << kSdpDelimiterColon << kValueConference;
1643 AddLine(os.str(), message);
1644 }
1645
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001646 // RFC 4568
1647 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001648 for (const CryptoParams& crypto_params : media_desc->cryptos()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001649 InitAttrLine(kAttributeCrypto, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001650 os << kSdpDelimiterColon << crypto_params.tag << " "
1651 << crypto_params.cipher_suite << " " << crypto_params.key_params;
1652 if (!crypto_params.session_params.empty()) {
1653 os << " " << crypto_params.session_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001654 }
1655 AddLine(os.str(), message);
1656 }
1657
1658 // RFC 4566
1659 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1660 // [/<encodingparameters>]
1661 BuildRtpMap(media_desc, media_type, message);
1662
Steve Anton4daf66e2018-09-07 14:55:53 -07001663 for (const StreamParams& track : media_desc->streams()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001664 // Build the ssrc-group lines.
Steve Anton4daf66e2018-09-07 14:55:53 -07001665 for (const SsrcGroup& ssrc_group : track.ssrc_groups) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001666 // RFC 5576
1667 // a=ssrc-group:<semantics> <ssrc-id> ...
Steve Anton4daf66e2018-09-07 14:55:53 -07001668 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001669 continue;
1670 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001671 InitAttrLine(kAttributeSsrcGroup, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001672 os << kSdpDelimiterColon << ssrc_group.semantics;
1673 for (uint32_t ssrc : ssrc_group.ssrcs) {
1674 os << kSdpDelimiterSpace << rtc::ToString(ssrc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001675 }
1676 AddLine(os.str(), message);
1677 }
1678 // Build the ssrc lines for each ssrc.
Steve Anton4daf66e2018-09-07 14:55:53 -07001679 for (uint32_t ssrc : track.ssrcs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001680 // RFC 5576
1681 // a=ssrc:<ssrc-id> cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07001682 AddSsrcLine(ssrc, kSsrcAttributeCname, track.cname, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001683
Steve Antone831b8c2018-02-01 12:22:16 -08001684 if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
1685 // draft-alvestrand-mmusic-msid-00
1686 // a=ssrc:<ssrc-id> msid:identifier [appdata]
1687 // The appdata consists of the "id" attribute of a MediaStreamTrack,
1688 // which corresponds to the "id" attribute of StreamParams.
Seth Hampson5b4f0752018-04-02 16:31:36 -07001689 // Since a=ssrc msid signaling is used in Plan B SDP semantics, and
1690 // multiple stream ids are not supported for Plan B, we are only adding
1691 // a line for the first media stream id here.
Seth Hampson7fa6ee62018-10-17 10:25:28 -07001692 const std::string& track_stream_id = track.first_stream_id();
1693 // We use a special msid-id value of "-" to represent no streams,
1694 // for Unified Plan compatibility. Plan B will always have a
1695 // track_stream_id.
1696 const std::string& stream_id =
1697 track_stream_id.empty() ? kNoStreamMsid : track_stream_id;
Steve Antone831b8c2018-02-01 12:22:16 -08001698 InitAttrLine(kAttributeSsrc, &os);
1699 os << kSdpDelimiterColon << ssrc << kSdpDelimiterSpace
1700 << kSsrcAttributeMsid << kSdpDelimiterColon << stream_id
Steve Anton4daf66e2018-09-07 14:55:53 -07001701 << kSdpDelimiterSpace << track.id;
Steve Antone831b8c2018-02-01 12:22:16 -08001702 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001703
Steve Antone831b8c2018-02-01 12:22:16 -08001704 // TODO(ronghuawu): Remove below code which is for backward
1705 // compatibility.
1706 // draft-alvestrand-rtcweb-mid-01
1707 // a=ssrc:<ssrc-id> mslabel:<value>
1708 // The label isn't yet defined.
1709 // a=ssrc:<ssrc-id> label:<value>
Seth Hampson5b4f0752018-04-02 16:31:36 -07001710 AddSsrcLine(ssrc, kSsrcAttributeMslabel, stream_id, message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001711 AddSsrcLine(ssrc, kSSrcAttributeLabel, track.id, message);
Steve Antone831b8c2018-02-01 12:22:16 -08001712 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001713 }
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001714
1715 // Build the rid lines for each layer of the track
1716 for (const RidDescription& rid_description : track.rids()) {
1717 InitAttrLine(kAttributeRid, &os);
1718 os << kSdpDelimiterColon
1719 << serializer.SerializeRidDescription(rid_description);
1720 AddLine(os.str(), message);
1721 }
1722 }
1723
Amit Hilbucha2012042018-12-03 11:35:05 -08001724 // Simulcast (a=simulcast)
1725 // https://tools.ietf.org/html/draft-ietf-mmusic-sdp-simulcast-13#section-5.1
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001726 if (media_desc->HasSimulcast()) {
1727 const auto& simulcast = media_desc->simulcast_description();
Amit Hilbucha2012042018-12-03 11:35:05 -08001728 InitAttrLine(kAttributeSimulcast, &os);
Amit Hilbucha2012042018-12-03 11:35:05 -08001729 os << kSdpDelimiterColon
1730 << serializer.SerializeSimulcastDescription(simulcast);
1731 AddLine(os.str(), message);
1732 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001733}
1734
Jonas Olssonec9e4922018-09-05 09:53:49 +02001735void WriteFmtpHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001736 // fmtp header: a=fmtp:|payload_type| <parameters>
1737 // Add a=fmtp
1738 InitAttrLine(kAttributeFmtp, os);
1739 // Add :|payload_type|
1740 *os << kSdpDelimiterColon << payload_type;
1741}
1742
Jonas Olssonec9e4922018-09-05 09:53:49 +02001743void WriteRtcpFbHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001744 // rtcp-fb header: a=rtcp-fb:|payload_type|
1745 // <parameters>/<ccm <ccm_parameters>>
1746 // Add a=rtcp-fb
1747 InitAttrLine(kAttributeRtcpFb, os);
1748 // Add :
1749 *os << kSdpDelimiterColon;
1750 if (payload_type == kWildcardPayloadType) {
1751 *os << "*";
1752 } else {
1753 *os << payload_type;
1754 }
1755}
1756
1757void WriteFmtpParameter(const std::string& parameter_name,
1758 const std::string& parameter_value,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001759 rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001760 // fmtp parameters: |parameter_name|=|parameter_value|
1761 *os << parameter_name << kSdpDelimiterEqual << parameter_value;
1762}
1763
1764void WriteFmtpParameters(const cricket::CodecParameterMap& parameters,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001765 rtc::StringBuilder* os) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001766 bool first = true;
1767 for (const auto& entry : parameters) {
1768 const std::string& key = entry.first;
1769 const std::string& value = entry.second;
hta62a216e2016-04-15 11:02:14 -07001770 // Parameters are a semicolon-separated list, no spaces.
1771 // The list is separated from the header by a space.
Steve Anton4daf66e2018-09-07 14:55:53 -07001772 if (first) {
hta62a216e2016-04-15 11:02:14 -07001773 *os << kSdpDelimiterSpace;
Steve Anton4daf66e2018-09-07 14:55:53 -07001774 first = false;
hta62a216e2016-04-15 11:02:14 -07001775 } else {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001776 *os << kSdpDelimiterSemicolon;
1777 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001778 WriteFmtpParameter(key, value, os);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001779 }
1780}
1781
1782bool IsFmtpParam(const std::string& name) {
ossuaa4b0772017-01-30 07:41:18 -08001783 // RFC 4855, section 3 specifies the mapping of media format parameters to SDP
1784 // parameters. Only ptime, maxptime, channels and rate are placed outside of
1785 // the fmtp line. In WebRTC, channels and rate are already handled separately
1786 // and thus not included in the CodecParameterMap.
1787 return name != kCodecParamPTime && name != kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001788}
1789
1790// Retreives fmtp parameters from |params|, which may contain other parameters
1791// as well, and puts them in |fmtp_parameters|.
1792void GetFmtpParams(const cricket::CodecParameterMap& params,
1793 cricket::CodecParameterMap* fmtp_parameters) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001794 for (const auto& entry : params) {
1795 const std::string& key = entry.first;
1796 const std::string& value = entry.second;
1797 if (IsFmtpParam(key)) {
1798 (*fmtp_parameters)[key] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001799 }
1800 }
1801}
1802
1803template <class T>
1804void AddFmtpLine(const T& codec, std::string* message) {
1805 cricket::CodecParameterMap fmtp_parameters;
1806 GetFmtpParams(codec.params, &fmtp_parameters);
1807 if (fmtp_parameters.empty()) {
1808 // No need to add an fmtp if it will have no (optional) parameters.
1809 return;
1810 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001811 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001812 WriteFmtpHeader(codec.id, &os);
1813 WriteFmtpParameters(fmtp_parameters, &os);
1814 AddLine(os.str(), message);
1815 return;
1816}
1817
1818template <class T>
1819void AddRtcpFbLines(const T& codec, std::string* message) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001820 for (const cricket::FeedbackParam& param : codec.feedback_params.params()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001821 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001822 WriteRtcpFbHeader(codec.id, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001823 os << " " << param.id();
1824 if (!param.param().empty()) {
1825 os << " " << param.param();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001826 }
1827 AddLine(os.str(), message);
1828 }
1829}
1830
1831bool GetMinValue(const std::vector<int>& values, int* value) {
1832 if (values.empty()) {
1833 return false;
1834 }
Steve Anton64b626b2019-01-28 17:25:26 -08001835 auto it = absl::c_min_element(values);
1836 *value = *it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001837 return true;
1838}
1839
1840bool GetParameter(const std::string& name,
Yves Gerey665174f2018-06-19 15:03:05 +02001841 const cricket::CodecParameterMap& params,
1842 int* value) {
1843 std::map<std::string, std::string>::const_iterator found = params.find(name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001844 if (found == params.end()) {
1845 return false;
1846 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00001847 if (!rtc::FromString(found->second, value)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001848 return false;
1849 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001850 return true;
1851}
1852
1853void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001854 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001855 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001856 RTC_DCHECK(message != NULL);
1857 RTC_DCHECK(media_desc != NULL);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001858 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001859 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001860 for (const cricket::VideoCodec& codec : media_desc->as_video()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001861 // RFC 4566
1862 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1863 // [/<encodingparameters>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001864 if (codec.id != kWildcardPayloadType) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001865 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001866 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
deadbeefe814a0d2017-02-25 18:15:09 -08001867 << cricket::kVideoCodecClockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001868 AddLine(os.str(), message);
1869 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001870 AddRtcpFbLines(codec, message);
1871 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001872 }
1873 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001874 std::vector<int> ptimes;
1875 std::vector<int> maxptimes;
1876 int max_minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001877 for (const cricket::AudioCodec& codec : media_desc->as_audio()->codecs()) {
1878 RTC_DCHECK(!codec.name.empty());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001879 // RFC 4566
1880 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1881 // [/<encodingparameters>]
1882 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001883 os << kSdpDelimiterColon << codec.id << " ";
1884 os << codec.name << "/" << codec.clockrate;
1885 if (codec.channels != 1) {
1886 os << "/" << codec.channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001887 }
1888 AddLine(os.str(), message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001889 AddRtcpFbLines(codec, message);
1890 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001891 int minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001892 if (GetParameter(kCodecParamMinPTime, codec.params, &minptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001893 max_minptime = std::max(minptime, max_minptime);
1894 }
1895 int ptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001896 if (GetParameter(kCodecParamPTime, codec.params, &ptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001897 ptimes.push_back(ptime);
1898 }
1899 int maxptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001900 if (GetParameter(kCodecParamMaxPTime, codec.params, &maxptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001901 maxptimes.push_back(maxptime);
1902 }
1903 }
1904 // Populate the maxptime attribute with the smallest maxptime of all codecs
1905 // under the same m-line.
1906 int min_maxptime = INT_MAX;
1907 if (GetMinValue(maxptimes, &min_maxptime)) {
1908 AddAttributeLine(kCodecParamMaxPTime, min_maxptime, message);
1909 }
nisseede5da42017-01-12 05:15:36 -08001910 RTC_DCHECK(min_maxptime > max_minptime);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001911 // Populate the ptime attribute with the smallest ptime or the largest
1912 // minptime, whichever is the largest, for all codecs under the same m-line.
1913 int ptime = INT_MAX;
1914 if (GetMinValue(ptimes, &ptime)) {
1915 ptime = std::min(ptime, min_maxptime);
1916 ptime = std::max(ptime, max_minptime);
1917 AddAttributeLine(kCodecParamPTime, ptime, message);
1918 }
1919 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001920 for (const cricket::DataCodec& codec : media_desc->as_data()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001921 // RFC 4566
1922 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1923 // [/<encodingparameters>]
1924 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001925 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
1926 << codec.clockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001927 AddLine(os.str(), message);
1928 }
1929 }
1930}
1931
1932void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -08001933 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001934 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001935 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001936
Steve Anton4daf66e2018-09-07 14:55:53 -07001937 for (const Candidate& candidate : candidates) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001938 // RFC 5245
1939 // a=candidate:<foundation> <component-id> <transport> <priority>
1940 // <connection-address> <port> typ <candidate-types>
1941 // [raddr <connection-address>] [rport <port>]
1942 // *(SP extension-att-name SP extension-att-value)
1943 std::string type;
1944 // Map the cricket candidate type to "host" / "srflx" / "prflx" / "relay"
Steve Anton4daf66e2018-09-07 14:55:53 -07001945 if (candidate.type() == cricket::LOCAL_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001946 type = kCandidateHost;
Steve Anton4daf66e2018-09-07 14:55:53 -07001947 } else if (candidate.type() == cricket::STUN_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001948 type = kCandidateSrflx;
Steve Anton4daf66e2018-09-07 14:55:53 -07001949 } else if (candidate.type() == cricket::RELAY_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001950 type = kCandidateRelay;
Steve Anton4daf66e2018-09-07 14:55:53 -07001951 } else if (candidate.type() == cricket::PRFLX_PORT_TYPE) {
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001952 type = kCandidatePrflx;
1953 // Peer reflexive candidate may be signaled for being removed.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001954 } else {
nissec80e7412017-01-11 05:56:46 -08001955 RTC_NOTREACHED();
Peter Thatcher019087f2015-04-28 09:06:26 -07001956 // Never write out candidates if we don't know the type.
1957 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001958 }
1959
1960 InitAttrLine(kAttributeCandidate, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001961 os << kSdpDelimiterColon << candidate.foundation() << " "
1962 << candidate.component() << " " << candidate.protocol() << " "
1963 << candidate.priority() << " "
1964 << (candidate.address().ipaddr().IsNil()
1965 ? candidate.address().hostname()
1966 : candidate.address().ipaddr().ToString())
1967 << " " << candidate.address().PortAsString() << " "
1968 << kAttributeCandidateTyp << " " << type << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001969
1970 // Related address
Steve Anton4daf66e2018-09-07 14:55:53 -07001971 if (!candidate.related_address().IsNil()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001972 os << kAttributeCandidateRaddr << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001973 << candidate.related_address().ipaddr().ToString() << " "
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001974 << kAttributeCandidateRport << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001975 << candidate.related_address().PortAsString() << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001976 }
1977
Steve Anton4daf66e2018-09-07 14:55:53 -07001978 if (candidate.protocol() == cricket::TCP_PROTOCOL_NAME) {
1979 os << kTcpCandidateType << " " << candidate.tcptype() << " ";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001980 }
1981
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001982 // Extensions
Steve Anton4daf66e2018-09-07 14:55:53 -07001983 os << kAttributeCandidateGeneration << " " << candidate.generation();
1984 if (include_ufrag && !candidate.username().empty()) {
1985 os << " " << kAttributeCandidateUfrag << " " << candidate.username();
honghaiza54a0802015-12-16 18:37:23 -08001986 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001987 if (candidate.network_id() > 0) {
1988 os << " " << kAttributeCandidateNetworkId << " "
1989 << candidate.network_id();
honghaiza0c44ea2016-03-23 16:07:48 -07001990 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001991 if (candidate.network_cost() > 0) {
1992 os << " " << kAttributeCandidateNetworkCost << " "
1993 << candidate.network_cost();
honghaize1a0c942016-02-16 14:54:56 -08001994 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001995
1996 AddLine(os.str(), message);
1997 }
1998}
1999
2000void BuildIceOptions(const std::vector<std::string>& transport_options,
2001 std::string* message) {
2002 if (!transport_options.empty()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002003 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002004 InitAttrLine(kAttributeIceOption, &os);
2005 os << kSdpDelimiterColon << transport_options[0];
2006 for (size_t i = 1; i < transport_options.size(); ++i) {
2007 os << kSdpDelimiterSpace << transport_options[i];
2008 }
2009 AddLine(os.str(), message);
2010 }
2011}
2012
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002013bool IsRtp(const std::string& protocol) {
2014 return protocol.empty() ||
Yves Gerey665174f2018-06-19 15:03:05 +02002015 (protocol.find(cricket::kMediaProtocolRtpPrefix) != std::string::npos);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002016}
2017
2018bool IsDtlsSctp(const std::string& protocol) {
2019 // This intentionally excludes "SCTP" and "SCTP/DTLS".
lally@webrtc.orga7470932015-02-24 20:19:21 +00002020 return protocol.find(cricket::kMediaProtocolDtlsSctp) != std::string::npos;
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002021}
2022
zhihuang38989e52017-03-21 11:04:53 -07002023bool ParseConnectionData(const std::string& line,
2024 rtc::SocketAddress* addr,
2025 SdpParseError* error) {
2026 // Parse the line from left to right.
2027 std::string token;
2028 std::string rightpart;
2029 // RFC 4566
2030 // c=<nettype> <addrtype> <connection-address>
2031 // Skip the "c="
Jonas Olssonec9e4922018-09-05 09:53:49 +02002032 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, &token, &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07002033 return ParseFailed(line, "Failed to parse the network type.", error);
2034 }
2035
2036 // Extract and verify the <nettype>
Jonas Olssonec9e4922018-09-05 09:53:49 +02002037 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2038 &rightpart) ||
zhihuang38989e52017-03-21 11:04:53 -07002039 token != kConnectionNettype) {
2040 return ParseFailed(line,
2041 "Failed to parse the connection data. The network type "
2042 "is not currently supported.",
2043 error);
2044 }
2045
2046 // Extract the "<addrtype>" and "<connection-address>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02002047 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2048 &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07002049 return ParseFailed(line, "Failed to parse the address type.", error);
2050 }
2051
2052 // The rightpart part should be the IP address without the slash which is used
2053 // for multicast.
2054 if (rightpart.find('/') != std::string::npos) {
2055 return ParseFailed(line,
2056 "Failed to parse the connection data. Multicast is not "
2057 "currently supported.",
2058 error);
2059 }
2060 addr->SetIP(rightpart);
2061
2062 // Verify that the addrtype matches the type of the parsed address.
2063 if ((addr->family() == AF_INET && token != "IP4") ||
2064 (addr->family() == AF_INET6 && token != "IP6")) {
2065 addr->Clear();
2066 return ParseFailed(
2067 line,
2068 "Failed to parse the connection data. The address type is mismatching.",
2069 error);
2070 }
2071 return true;
2072}
2073
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -08002074bool ParseMediaTransportLine(const std::string& line,
2075 std::string* transport_name,
2076 std::string* transport_setting,
2077 SdpParseError* error) {
2078 std::string value;
2079 if (!GetValue(line, kMediaTransportSettingLine, &value, error)) {
2080 return false;
2081 }
2082 std::string media_transport_settings_base64;
2083 if (!rtc::tokenize_first(value, kSdpDelimiterColonChar, transport_name,
2084 &media_transport_settings_base64)) {
2085 return ParseFailedGetValue(line, kMediaTransportSettingLine, error);
2086 }
2087 if (!rtc::Base64::Decode(media_transport_settings_base64,
2088 rtc::Base64::DO_STRICT, transport_setting,
2089 nullptr)) {
2090 return ParseFailedGetValue(line, kMediaTransportSettingLine, error);
2091 }
2092
2093 return true;
2094}
2095
zhihuang38989e52017-03-21 11:04:53 -07002096bool ParseSessionDescription(const std::string& message,
2097 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002098 std::string* session_id,
2099 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002100 TransportDescription* session_td,
2101 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -07002102 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002103 cricket::SessionDescription* desc,
2104 SdpParseError* error) {
2105 std::string line;
2106
deadbeefc80741f2015-10-22 13:14:45 -07002107 desc->set_msid_supported(false);
Johannes Kron9581bc42018-10-23 10:17:39 +02002108 desc->set_extmap_allow_mixed(false);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002109 // RFC 4566
2110 // v= (protocol version)
2111 if (!GetLineWithType(message, pos, &line, kLineTypeVersion)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002112 return ParseFailedExpectLine(message, *pos, kLineTypeVersion, std::string(),
2113 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002114 }
2115 // RFC 4566
2116 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
2117 // <unicast-address>
2118 if (!GetLineWithType(message, pos, &line, kLineTypeOrigin)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002119 return ParseFailedExpectLine(message, *pos, kLineTypeOrigin, std::string(),
2120 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002121 }
2122 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002123 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002124 const size_t expected_fields = 6;
2125 if (fields.size() != expected_fields) {
2126 return ParseFailedExpectFieldNum(line, expected_fields, error);
2127 }
2128 *session_id = fields[1];
2129 *session_version = fields[2];
2130
2131 // RFC 4566
2132 // s= (session name)
2133 if (!GetLineWithType(message, pos, &line, kLineTypeSessionName)) {
2134 return ParseFailedExpectLine(message, *pos, kLineTypeSessionName,
2135 std::string(), error);
2136 }
2137
Danil Chapovalov66cadcc2018-06-19 16:47:43 +02002138 // absl::optional lines
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002139 // Those are the optional lines, so shouldn't return false if not present.
2140 // RFC 4566
2141 // i=* (session information)
2142 GetLineWithType(message, pos, &line, kLineTypeSessionInfo);
2143
2144 // RFC 4566
2145 // u=* (URI of description)
2146 GetLineWithType(message, pos, &line, kLineTypeSessionUri);
2147
2148 // RFC 4566
2149 // e=* (email address)
2150 GetLineWithType(message, pos, &line, kLineTypeSessionEmail);
2151
2152 // RFC 4566
2153 // p=* (phone number)
2154 GetLineWithType(message, pos, &line, kLineTypeSessionPhone);
2155
2156 // RFC 4566
2157 // c=* (connection information -- not required if included in
2158 // all media)
zhihuang38989e52017-03-21 11:04:53 -07002159 if (GetLineWithType(message, pos, &line, kLineTypeConnection)) {
2160 if (!ParseConnectionData(line, connection_addr, error)) {
2161 return false;
2162 }
2163 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002164
2165 // RFC 4566
2166 // b=* (zero or more bandwidth information lines)
2167 while (GetLineWithType(message, pos, &line, kLineTypeSessionBandwidth)) {
2168 // By pass zero or more b lines.
2169 }
2170
2171 // RFC 4566
2172 // One or more time descriptions ("t=" and "r=" lines; see below)
2173 // t= (time the session is active)
2174 // r=* (zero or more repeat times)
2175 // Ensure there's at least one time description
2176 if (!GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2177 return ParseFailedExpectLine(message, *pos, kLineTypeTiming, std::string(),
2178 error);
2179 }
2180
2181 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2182 // By pass zero or more r lines.
2183 }
2184
2185 // Go through the rest of the time descriptions
2186 while (GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2187 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2188 // By pass zero or more r lines.
2189 }
2190 }
2191
2192 // RFC 4566
2193 // z=* (time zone adjustments)
2194 GetLineWithType(message, pos, &line, kLineTypeTimeZone);
2195
2196 // RFC 4566
2197 // k=* (encryption key)
2198 GetLineWithType(message, pos, &line, kLineTypeEncryptionKey);
2199
2200 // RFC 4566
2201 // a=* (zero or more session attribute lines)
2202 while (GetLineWithType(message, pos, &line, kLineTypeAttributes)) {
2203 if (HasAttribute(line, kAttributeGroup)) {
2204 if (!ParseGroupAttribute(line, desc, error)) {
2205 return false;
2206 }
2207 } else if (HasAttribute(line, kAttributeIceUfrag)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002208 if (!GetValue(line, kAttributeIceUfrag, &(session_td->ice_ufrag),
2209 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002210 return false;
2211 }
2212 } else if (HasAttribute(line, kAttributeIcePwd)) {
2213 if (!GetValue(line, kAttributeIcePwd, &(session_td->ice_pwd), error)) {
2214 return false;
2215 }
2216 } else if (HasAttribute(line, kAttributeIceLite)) {
2217 session_td->ice_mode = cricket::ICEMODE_LITE;
2218 } else if (HasAttribute(line, kAttributeIceOption)) {
2219 if (!ParseIceOptions(line, &(session_td->transport_options), error)) {
2220 return false;
2221 }
2222 } else if (HasAttribute(line, kAttributeFingerprint)) {
2223 if (session_td->identity_fingerprint.get()) {
2224 return ParseFailed(
2225 line,
2226 "Can't have multiple fingerprint attributes at the same level.",
2227 error);
2228 }
Steve Anton4905edb2018-10-15 19:27:44 -07002229 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002230 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2231 return false;
2232 }
Steve Anton4905edb2018-10-15 19:27:44 -07002233 session_td->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002234 } else if (HasAttribute(line, kAttributeSetup)) {
2235 if (!ParseDtlsSetup(line, &(session_td->connection_role), error)) {
2236 return false;
2237 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002238 } else if (HasAttribute(line, kAttributeMsidSemantics)) {
2239 std::string semantics;
2240 if (!GetValue(line, kAttributeMsidSemantics, &semantics, error)) {
2241 return false;
2242 }
deadbeefc80741f2015-10-22 13:14:45 -07002243 desc->set_msid_supported(
2244 CaseInsensitiveFind(semantics, kMediaStreamSemantic));
Johannes Kron0854eb62018-10-10 22:33:20 +02002245 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02002246 desc->set_extmap_allow_mixed(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002247 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002248 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002249 if (!ParseExtmap(line, &extmap, error)) {
2250 return false;
2251 }
2252 session_extmaps->push_back(extmap);
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -08002253 } else if (HasAttribute(line, kMediaTransportSettingLine)) {
2254 std::string transport_name;
2255 std::string transport_setting;
2256 if (!ParseMediaTransportLine(line, &transport_name, &transport_setting,
2257 error)) {
2258 return false;
2259 }
2260
2261 for (const auto& setting : desc->MediaTransportSettings()) {
2262 if (setting.transport_name == transport_name) {
2263 // Ignore repeated transport names rather than failing to parse so
2264 // that in the future the same transport could have multiple configs.
2265 RTC_LOG(INFO) << "x-mt line with repeated transport, transport_name="
2266 << transport_name;
2267 return true;
2268 }
2269 }
2270 desc->AddMediaTransportSetting(transport_name, transport_setting);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002271 }
2272 }
2273
2274 return true;
2275}
2276
2277bool ParseGroupAttribute(const std::string& line,
2278 cricket::SessionDescription* desc,
2279 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002280 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002281
2282 // RFC 5888 and draft-holmberg-mmusic-sdp-bundle-negotiation-00
2283 // a=group:BUNDLE video voice
2284 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002285 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002286 std::string semantics;
2287 if (!GetValue(fields[0], kAttributeGroup, &semantics, error)) {
2288 return false;
2289 }
2290 cricket::ContentGroup group(semantics);
2291 for (size_t i = 1; i < fields.size(); ++i) {
2292 group.AddContentName(fields[i]);
2293 }
2294 desc->AddGroup(group);
2295 return true;
2296}
2297
Steve Anton4905edb2018-10-15 19:27:44 -07002298static bool ParseFingerprintAttribute(
2299 const std::string& line,
2300 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
2301 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002302 if (!IsLineType(line, kLineTypeAttributes) ||
2303 !HasAttribute(line, kAttributeFingerprint)) {
2304 return ParseFailedExpectLine(line, 0, kLineTypeAttributes,
2305 kAttributeFingerprint, error);
2306 }
2307
2308 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002309 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002310 const size_t expected_fields = 2;
2311 if (fields.size() != expected_fields) {
2312 return ParseFailedExpectFieldNum(line, expected_fields, error);
2313 }
2314
2315 // The first field here is "fingerprint:<hash>.
2316 std::string algorithm;
2317 if (!GetValue(fields[0], kAttributeFingerprint, &algorithm, error)) {
2318 return false;
2319 }
2320
2321 // Downcase the algorithm. Note that we don't need to downcase the
2322 // fingerprint because hex_decode can handle upper-case.
Steve Anton64b626b2019-01-28 17:25:26 -08002323 absl::c_transform(algorithm, algorithm.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002324
2325 // The second field is the digest value. De-hexify it.
Steve Anton4905edb2018-10-15 19:27:44 -07002326 *fingerprint =
2327 rtc::SSLFingerprint::CreateUniqueFromRfc4572(algorithm, fields[1]);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002328 if (!*fingerprint) {
Yves Gerey665174f2018-06-19 15:03:05 +02002329 return ParseFailed(line, "Failed to create fingerprint from the digest.",
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002330 error);
2331 }
2332
2333 return true;
2334}
2335
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002336static bool ParseDtlsSetup(const std::string& line,
2337 cricket::ConnectionRole* role,
2338 SdpParseError* error) {
2339 // setup-attr = "a=setup:" role
2340 // role = "active" / "passive" / "actpass" / "holdconn"
2341 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002342 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002343 const size_t expected_fields = 2;
2344 if (fields.size() != expected_fields) {
2345 return ParseFailedExpectFieldNum(line, expected_fields, error);
2346 }
2347 std::string role_str = fields[1];
2348 if (!cricket::StringToConnectionRole(role_str, role)) {
2349 return ParseFailed(line, "Invalid attribute value.", error);
2350 }
2351 return true;
2352}
2353
deadbeef9d3584c2016-02-16 17:54:10 -08002354static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -07002355 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -08002356 std::string* track_id,
2357 SdpParseError* error) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002358 // https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
deadbeef9d3584c2016-02-16 17:54:10 -08002359 // a=msid:<stream id> <track id>
2360 // msid-value = msid-id [ SP msid-appdata ]
2361 // msid-id = 1*64token-char ; see RFC 4566
2362 // msid-appdata = 1*64token-char ; see RFC 4566
2363 std::string field1;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002364 std::string new_stream_id;
2365 std::string new_track_id;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002366 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
2367 kSdpDelimiterSpaceChar, &field1, &new_track_id)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002368 const size_t expected_fields = 2;
2369 return ParseFailedExpectFieldNum(line, expected_fields, error);
2370 }
2371
Seth Hampson5b4f0752018-04-02 16:31:36 -07002372 if (new_track_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002373 return ParseFailed(line, "Missing track ID in msid attribute.", error);
2374 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002375 // All track ids should be the same within an m section in a Unified Plan SDP.
2376 if (!track_id->empty() && new_track_id.compare(*track_id) != 0) {
2377 return ParseFailed(
2378 line, "Two different track IDs in msid attribute in one m= section",
2379 error);
2380 }
2381 *track_id = new_track_id;
deadbeefa4549d62017-02-10 17:26:22 -08002382
deadbeef9d3584c2016-02-16 17:54:10 -08002383 // msid:<msid-id>
Seth Hampson5b4f0752018-04-02 16:31:36 -07002384 if (!GetValue(field1, kAttributeMsid, &new_stream_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002385 return false;
2386 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002387 if (new_stream_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002388 return ParseFailed(line, "Missing stream ID in msid attribute.", error);
2389 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002390 // The special value "-" indicates "no MediaStream".
2391 if (new_stream_id.compare(kNoStreamMsid) != 0) {
2392 stream_ids->push_back(new_stream_id);
2393 }
deadbeef9d3584c2016-02-16 17:54:10 -08002394 return true;
2395}
2396
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002397static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
2398 std::vector<RidDescription>* rids) {
2399 RTC_DCHECK(rids);
2400 std::set<std::string> to_remove;
2401 std::set<std::string> unique_rids;
2402
2403 // Check the rids to see which ones should be removed.
2404 for (RidDescription& rid : *rids) {
2405 // In the case of a duplicate, the entire "a=rid" line, and all "a=rid"
2406 // lines with rid-ids that duplicate this line, are discarded and MUST NOT
2407 // be included in the SDP Answer.
2408 auto pair = unique_rids.insert(rid.rid);
2409 // Insert will "fail" if element already exists.
2410 if (!pair.second) {
2411 to_remove.insert(rid.rid);
2412 continue;
2413 }
2414
2415 // If the "a=rid" line contains a "pt=", the list of payload types
2416 // is verified against the list of valid payload types for the media
2417 // section (that is, those listed on the "m=" line). Any PT missing
2418 // from the "m=" line is discarded from the set of values in the
2419 // "pt=". If no values are left in the "pt=" parameter after this
2420 // processing, then the "a=rid" line is discarded.
2421 if (rid.payload_types.empty()) {
2422 // If formats were not specified, rid should not be removed.
2423 continue;
2424 }
2425
2426 // Note: Spec does not mention how to handle duplicate formats.
2427 // Media section does not handle duplicates either.
2428 std::set<int> removed_formats;
2429 for (int payload_type : rid.payload_types) {
Steve Anton64b626b2019-01-28 17:25:26 -08002430 if (!absl::c_linear_search(payload_types, payload_type)) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002431 removed_formats.insert(payload_type);
2432 }
2433 }
2434
2435 rid.payload_types.erase(
2436 std::remove_if(rid.payload_types.begin(), rid.payload_types.end(),
2437 [&removed_formats](int format) {
2438 return removed_formats.count(format) > 0;
2439 }),
2440 rid.payload_types.end());
2441
2442 // If all formats were removed then remove the rid alogether.
2443 if (rid.payload_types.empty()) {
2444 to_remove.insert(rid.rid);
2445 }
2446 }
2447
2448 // Remove every rid description that appears in the to_remove list.
2449 if (!to_remove.empty()) {
2450 rids->erase(std::remove_if(rids->begin(), rids->end(),
2451 [&to_remove](const RidDescription& rid) {
2452 return to_remove.count(rid.rid) > 0;
2453 }),
2454 rids->end());
2455 }
2456}
2457
2458// Create a new list (because SimulcastLayerList is immutable) without any
2459// layers that have a rid in the to_remove list.
2460// If a group of alternatives is empty after removing layers, the group should
2461// be removed altogether.
2462static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
2463 const std::set<std::string>& to_remove,
2464 const SimulcastLayerList& layers) {
2465 SimulcastLayerList result;
2466 for (const std::vector<SimulcastLayer>& vector : layers) {
2467 std::vector<SimulcastLayer> new_layers;
2468 for (const SimulcastLayer& layer : vector) {
2469 if (to_remove.find(layer.rid) == to_remove.end()) {
2470 new_layers.push_back(layer);
2471 }
2472 }
2473 // If all layers were removed, do not add an entry.
2474 if (!new_layers.empty()) {
2475 result.AddLayerWithAlternatives(new_layers);
2476 }
2477 }
2478
2479 return result;
2480}
2481
2482// Will remove Simulcast Layers if:
2483// 1. They appear in both send and receive directions.
2484// 2. They do not appear in the list of |valid_rids|.
2485static void RemoveInvalidRidsFromSimulcast(
2486 const std::vector<RidDescription>& valid_rids,
2487 SimulcastDescription* simulcast) {
2488 RTC_DCHECK(simulcast);
2489 std::set<std::string> to_remove;
2490 std::vector<SimulcastLayer> all_send_layers =
2491 simulcast->send_layers().GetAllLayers();
2492 std::vector<SimulcastLayer> all_receive_layers =
2493 simulcast->receive_layers().GetAllLayers();
2494
2495 // If a rid appears in both send and receive directions, remove it from both.
2496 // This algorithm runs in O(n^2) time, but for small n (as is the case with
2497 // simulcast layers) it should still perform well.
2498 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002499 if (absl::c_any_of(all_receive_layers,
2500 [&send_layer](const SimulcastLayer& layer) {
2501 return layer.rid == send_layer.rid;
2502 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002503 to_remove.insert(send_layer.rid);
2504 }
2505 }
2506
2507 // Add any rid that is not in the valid list to the remove set.
2508 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002509 if (absl::c_none_of(valid_rids, [&send_layer](const RidDescription& rid) {
2510 return send_layer.rid == rid.rid;
2511 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002512 to_remove.insert(send_layer.rid);
2513 }
2514 }
2515
2516 // Add any rid that is not in the valid list to the remove set.
2517 for (const SimulcastLayer& receive_layer : all_receive_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002518 if (absl::c_none_of(valid_rids,
2519 [&receive_layer](const RidDescription& rid) {
2520 return receive_layer.rid == rid.rid;
2521 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002522 to_remove.insert(receive_layer.rid);
2523 }
2524 }
2525
2526 simulcast->send_layers() =
2527 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->send_layers());
2528 simulcast->receive_layers() =
2529 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->receive_layers());
2530}
2531
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002532// RFC 3551
2533// PT encoding media type clock rate channels
2534// name (Hz)
2535// 0 PCMU A 8,000 1
2536// 1 reserved A
2537// 2 reserved A
2538// 3 GSM A 8,000 1
2539// 4 G723 A 8,000 1
2540// 5 DVI4 A 8,000 1
2541// 6 DVI4 A 16,000 1
2542// 7 LPC A 8,000 1
2543// 8 PCMA A 8,000 1
2544// 9 G722 A 8,000 1
2545// 10 L16 A 44,100 2
2546// 11 L16 A 44,100 1
2547// 12 QCELP A 8,000 1
2548// 13 CN A 8,000 1
2549// 14 MPA A 90,000 (see text)
2550// 15 G728 A 8,000 1
2551// 16 DVI4 A 11,025 1
2552// 17 DVI4 A 22,050 1
2553// 18 G729 A 8,000 1
2554struct StaticPayloadAudioCodec {
2555 const char* name;
2556 int clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002557 size_t channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002558};
2559static const StaticPayloadAudioCodec kStaticPayloadAudioCodecs[] = {
Yves Gerey665174f2018-06-19 15:03:05 +02002560 {"PCMU", 8000, 1}, {"reserved", 0, 0}, {"reserved", 0, 0},
2561 {"GSM", 8000, 1}, {"G723", 8000, 1}, {"DVI4", 8000, 1},
2562 {"DVI4", 16000, 1}, {"LPC", 8000, 1}, {"PCMA", 8000, 1},
2563 {"G722", 8000, 1}, {"L16", 44100, 2}, {"L16", 44100, 1},
2564 {"QCELP", 8000, 1}, {"CN", 8000, 1}, {"MPA", 90000, 1},
2565 {"G728", 8000, 1}, {"DVI4", 11025, 1}, {"DVI4", 22050, 1},
2566 {"G729", 8000, 1},
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002567};
2568
Yves Gerey665174f2018-06-19 15:03:05 +02002569void MaybeCreateStaticPayloadAudioCodecs(const std::vector<int>& fmts,
2570 AudioContentDescription* media_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002571 if (!media_desc) {
2572 return;
2573 }
deadbeef67cf2c12016-04-13 10:07:16 -07002574 RTC_DCHECK(media_desc->codecs().empty());
solenberg9fa49752016-10-08 13:02:44 -07002575 for (int payload_type : fmts) {
Yves Gerey665174f2018-06-19 15:03:05 +02002576 if (!media_desc->HasCodec(payload_type) && payload_type >= 0 &&
kjellander3e33bfe2016-06-20 07:04:09 -07002577 static_cast<uint32_t>(payload_type) <
2578 arraysize(kStaticPayloadAudioCodecs)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002579 std::string encoding_name = kStaticPayloadAudioCodecs[payload_type].name;
2580 int clock_rate = kStaticPayloadAudioCodecs[payload_type].clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002581 size_t channels = kStaticPayloadAudioCodecs[payload_type].channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002582 media_desc->AddCodec(cricket::AudioCodec(payload_type, encoding_name,
deadbeef67cf2c12016-04-13 10:07:16 -07002583 clock_rate, 0, channels));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002584 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002585 }
2586}
2587
2588template <class C>
Steve Anton5a1de872018-12-18 11:25:55 -08002589static std::unique_ptr<C> ParseContentDescription(
2590 const std::string& message,
2591 const cricket::MediaType media_type,
2592 int mline_index,
2593 const std::string& protocol,
2594 const std::vector<int>& payload_types,
2595 size_t* pos,
2596 std::string* content_name,
2597 bool* bundle_only,
2598 int* msid_signaling,
2599 TransportDescription* transport,
2600 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2601 webrtc::SdpParseError* error) {
2602 auto media_desc = absl::make_unique<C>();
deadbeef67cf2c12016-04-13 10:07:16 -07002603 if (!ParseContent(message, media_type, mline_index, protocol, payload_types,
Steve Anton5a1de872018-12-18 11:25:55 -08002604 pos, content_name, bundle_only, msid_signaling,
2605 media_desc.get(), transport, candidates, error)) {
zhihuang38989e52017-03-21 11:04:53 -07002606 return nullptr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002607 }
2608 // Sort the codecs according to the m-line fmt list.
deadbeef67cf2c12016-04-13 10:07:16 -07002609 std::unordered_map<int, int> payload_type_preferences;
2610 // "size + 1" so that the lowest preference payload type has a preference of
2611 // 1, which is greater than the default (0) for payload types not in the fmt
2612 // list.
2613 int preference = static_cast<int>(payload_types.size() + 1);
2614 for (int pt : payload_types) {
2615 payload_type_preferences[pt] = preference--;
2616 }
2617 std::vector<typename C::CodecType> codecs = media_desc->codecs();
Steve Anton64b626b2019-01-28 17:25:26 -08002618 absl::c_sort(
2619 codecs, [&payload_type_preferences](const typename C::CodecType& a,
2620 const typename C::CodecType& b) {
2621 return payload_type_preferences[a.id] > payload_type_preferences[b.id];
2622 });
deadbeef67cf2c12016-04-13 10:07:16 -07002623 media_desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002624 return media_desc;
2625}
2626
Steve Anton5a1de872018-12-18 11:25:55 -08002627bool ParseMediaDescription(
2628 const std::string& message,
2629 const TransportDescription& session_td,
2630 const RtpHeaderExtensions& session_extmaps,
2631 size_t* pos,
2632 const rtc::SocketAddress& session_connection_addr,
2633 cricket::SessionDescription* desc,
2634 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2635 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002636 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002637 std::string line;
2638 int mline_index = -1;
Steve Antone831b8c2018-02-01 12:22:16 -08002639 int msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002640
2641 // Zero or more media descriptions
2642 // RFC 4566
2643 // m=<media> <port> <proto> <fmt>
2644 while (GetLineWithType(message, pos, &line, kLineTypeMedia)) {
2645 ++mline_index;
2646
2647 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002648 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
zstein4b2e0822017-02-17 19:48:38 -08002649
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002650 const size_t expected_min_fields = 4;
2651 if (fields.size() < expected_min_fields) {
2652 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
2653 }
deadbeef25ed4352016-12-12 18:37:36 -08002654 bool port_rejected = false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002655 // RFC 3264
2656 // To reject an offered stream, the port number in the corresponding stream
2657 // in the answer MUST be set to zero.
2658 if (fields[1] == kMediaPortRejected) {
deadbeef25ed4352016-12-12 18:37:36 -08002659 port_rejected = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002660 }
2661
zhihuang38989e52017-03-21 11:04:53 -07002662 int port = 0;
2663 if (!rtc::FromString<int>(fields[1], &port) || !IsValidPort(port)) {
2664 return ParseFailed(line, "The port number is invalid", error);
2665 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002666 std::string protocol = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002667
2668 // <fmt>
deadbeef67cf2c12016-04-13 10:07:16 -07002669 std::vector<int> payload_types;
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002670 if (IsRtp(protocol)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002671 for (size_t j = 3; j < fields.size(); ++j) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002672 // TODO(wu): Remove when below bug is fixed.
2673 // https://bugzilla.mozilla.org/show_bug.cgi?id=996329
pbosbb36fdf2015-07-09 07:48:14 -07002674 if (fields[j].empty() && j == fields.size() - 1) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002675 continue;
2676 }
wu@webrtc.org36eda7c2014-04-15 20:37:30 +00002677
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002678 int pl = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00002679 if (!GetPayloadTypeFromString(line, fields[j], &pl, error)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002680 return false;
2681 }
deadbeef67cf2c12016-04-13 10:07:16 -07002682 payload_types.push_back(pl);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002683 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002684 }
2685
2686 // Make a temporary TransportDescription based on |session_td|.
2687 // Some of this gets overwritten by ParseContent.
deadbeef46eed762016-01-28 13:24:37 -08002688 TransportDescription transport(
2689 session_td.transport_options, session_td.ice_ufrag, session_td.ice_pwd,
2690 session_td.ice_mode, session_td.connection_role,
2691 session_td.identity_fingerprint.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002692
kwibergd1fe2812016-04-27 06:47:29 -07002693 std::unique_ptr<MediaContentDescription> content;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002694 std::string content_name;
deadbeef25ed4352016-12-12 18:37:36 -08002695 bool bundle_only = false;
Steve Antone831b8c2018-02-01 12:22:16 -08002696 int section_msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002697 if (HasAttribute(line, kMediaTypeVideo)) {
Steve Anton5a1de872018-12-18 11:25:55 -08002698 content = ParseContentDescription<VideoContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002699 message, cricket::MEDIA_TYPE_VIDEO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002700 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 11:25:55 -08002701 &section_msid_signaling, &transport, candidates, error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002702 } else if (HasAttribute(line, kMediaTypeAudio)) {
Steve Anton5a1de872018-12-18 11:25:55 -08002703 content = ParseContentDescription<AudioContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002704 message, cricket::MEDIA_TYPE_AUDIO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002705 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 11:25:55 -08002706 &section_msid_signaling, &transport, candidates, error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002707 } else if (HasAttribute(line, kMediaTypeData)) {
Harald Alvestrand26bf7c42019-04-23 05:20:17 +00002708 if (IsDtlsSctp(protocol)) {
2709 auto data_desc = absl::make_unique<SctpDataContentDescription>();
zstein4b2e0822017-02-17 19:48:38 -08002710 int p;
2711 if (rtc::FromString(fields[3], &p)) {
Harald Alvestrand26bf7c42019-04-23 05:20:17 +00002712 data_desc->set_port(p);
zstein4b2e0822017-02-17 19:48:38 -08002713 } else if (fields[3] == kDefaultSctpmapProtocol) {
2714 data_desc->set_use_sctpmap(false);
2715 }
Harald Alvestrand26bf7c42019-04-23 05:20:17 +00002716 if (!ParseContent(message, cricket::MEDIA_TYPE_DATA, mline_index,
2717 protocol, payload_types, pos, &content_name,
2718 &bundle_only, &section_msid_signaling,
2719 data_desc.get(), &transport, candidates, error)) {
2720 return false;
2721 }
2722 content = std::move(data_desc);
2723 } else {
2724 // RTP
2725 std::unique_ptr<DataContentDescription> data_desc =
2726 ParseContentDescription<DataContentDescription>(
2727 message, cricket::MEDIA_TYPE_DATA, mline_index, protocol,
2728 payload_types, pos, &content_name, &bundle_only,
2729 &section_msid_signaling, &transport, candidates, error);
2730 content = std::move(data_desc);
wu@webrtc.org78187522013-10-07 23:32:02 +00002731 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002732 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002733 RTC_LOG(LS_WARNING) << "Unsupported media type: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002734 continue;
2735 }
2736 if (!content.get()) {
2737 // ParseContentDescription returns NULL if failed.
2738 return false;
2739 }
2740
Steve Antone831b8c2018-02-01 12:22:16 -08002741 msid_signaling |= section_msid_signaling;
2742
deadbeef25ed4352016-12-12 18:37:36 -08002743 bool content_rejected = false;
deadbeef12771a12017-01-03 13:53:47 -08002744 // A port of 0 is not interpreted as a rejected m= section when it's
2745 // used along with a=bundle-only.
deadbeef25ed4352016-12-12 18:37:36 -08002746 if (bundle_only) {
deadbeef25ed4352016-12-12 18:37:36 -08002747 if (!port_rejected) {
deadbeef12771a12017-01-03 13:53:47 -08002748 // Usage of bundle-only with a nonzero port is unspecified. So just
2749 // ignore bundle-only if we see this.
2750 bundle_only = false;
Mirko Bonadei675513b2017-11-09 11:09:25 +01002751 RTC_LOG(LS_WARNING)
deadbeef12771a12017-01-03 13:53:47 -08002752 << "a=bundle-only attribute observed with a nonzero "
Jonas Olsson45cc8902018-02-13 10:37:07 +01002753 "port; this usage is unspecified so the attribute is being "
2754 "ignored.";
deadbeef25ed4352016-12-12 18:37:36 -08002755 }
2756 } else {
2757 // If not using bundle-only, interpret port 0 in the normal way; the m=
2758 // section is being rejected.
2759 content_rejected = port_rejected;
2760 }
2761
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00002762 if (IsRtp(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002763 // Set the extmap.
2764 if (!session_extmaps.empty() &&
2765 !content->rtp_header_extensions().empty()) {
2766 return ParseFailed("",
2767 "The a=extmap MUST be either all session level or "
2768 "all media level.",
2769 error);
2770 }
2771 for (size_t i = 0; i < session_extmaps.size(); ++i) {
2772 content->AddRtpHeaderExtension(session_extmaps[i]);
2773 }
2774 }
2775 content->set_protocol(protocol);
zhihuang38989e52017-03-21 11:04:53 -07002776
2777 // Use the session level connection address if the media level addresses are
2778 // not specified.
2779 rtc::SocketAddress address;
2780 address = content->connection_address().IsNil()
2781 ? session_connection_addr
2782 : content->connection_address();
2783 address.SetPort(port);
2784 content->set_connection_address(address);
2785
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002786 desc->AddContent(content_name,
Steve Anton5adfafd2017-12-20 16:34:00 -08002787 IsDtlsSctp(protocol) ? MediaProtocolType::kSctp
2788 : MediaProtocolType::kRtp,
deadbeef25ed4352016-12-12 18:37:36 -08002789 content_rejected, bundle_only, content.release());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002790 // Create TransportInfo with the media level "ice-pwd" and "ice-ufrag".
Steve Anton06817cd2018-12-18 15:55:30 -08002791 desc->AddTransportInfo(TransportInfo(content_name, transport));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002792 }
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002793
Steve Antone831b8c2018-02-01 12:22:16 -08002794 desc->set_msid_signaling(msid_signaling);
2795
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002796 size_t end_of_message = message.size();
2797 if (mline_index == -1 && *pos != end_of_message) {
2798 ParseFailed(message, *pos, "Expects m line.", error);
2799 return false;
2800 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002801 return true;
2802}
2803
2804bool VerifyCodec(const cricket::Codec& codec) {
2805 // Codec has not been populated correctly unless the name has been set. This
2806 // can happen if an SDP has an fmtp or rtcp-fb with a payload type but doesn't
2807 // have a corresponding "rtpmap" line.
htab39db842016-12-08 01:50:48 -08002808 return !codec.name.empty();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002809}
2810
2811bool VerifyAudioCodecs(const AudioContentDescription* audio_desc) {
Steve Anton64b626b2019-01-28 17:25:26 -08002812 return absl::c_all_of(audio_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002813}
2814
2815bool VerifyVideoCodecs(const VideoContentDescription* video_desc) {
Steve Anton64b626b2019-01-28 17:25:26 -08002816 return absl::c_all_of(video_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002817}
2818
2819void AddParameters(const cricket::CodecParameterMap& parameters,
2820 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002821 for (const auto& entry : parameters) {
2822 const std::string& key = entry.first;
2823 const std::string& value = entry.second;
2824 codec->SetParam(key, value);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002825 }
2826}
2827
2828void AddFeedbackParameter(const cricket::FeedbackParam& feedback_param,
2829 cricket::Codec* codec) {
2830 codec->AddFeedbackParam(feedback_param);
2831}
2832
2833void AddFeedbackParameters(const cricket::FeedbackParams& feedback_params,
2834 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002835 for (const cricket::FeedbackParam& param : feedback_params.params()) {
2836 codec->AddFeedbackParam(param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002837 }
2838}
2839
2840// Gets the current codec setting associated with |payload_type|. If there
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002841// is no Codec associated with that payload type it returns an empty codec
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002842// with that payload type.
2843template <class T>
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002844T GetCodecWithPayloadType(const std::vector<T>& codecs, int payload_type) {
magjedb05fa242016-11-11 04:00:16 -08002845 const T* codec = FindCodecById(codecs, payload_type);
2846 if (codec)
2847 return *codec;
2848 // Return empty codec with |payload_type|.
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002849 T ret_val;
magjedb05fa242016-11-11 04:00:16 -08002850 ret_val.id = payload_type;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002851 return ret_val;
2852}
2853
2854// Updates or creates a new codec entry in the audio description.
2855template <class T, class U>
2856void AddOrReplaceCodec(MediaContentDescription* content_desc, const U& codec) {
2857 T* desc = static_cast<T*>(content_desc);
2858 std::vector<U> codecs = desc->codecs();
2859 bool found = false;
Steve Anton4daf66e2018-09-07 14:55:53 -07002860 for (U& existing_codec : codecs) {
2861 if (codec.id == existing_codec.id) {
2862 // Overwrite existing codec with the new codec.
2863 existing_codec = codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002864 found = true;
2865 break;
2866 }
2867 }
2868 if (!found) {
2869 desc->AddCodec(codec);
2870 return;
2871 }
2872 desc->set_codecs(codecs);
2873}
2874
2875// Adds or updates existing codec corresponding to |payload_type| according
2876// to |parameters|.
2877template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002878void UpdateCodec(MediaContentDescription* content_desc,
2879 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002880 const cricket::CodecParameterMap& parameters) {
2881 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002882 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2883 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002884 AddParameters(parameters, &new_codec);
2885 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2886}
2887
2888// Adds or updates existing codec corresponding to |payload_type| according
2889// to |feedback_param|.
2890template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002891void UpdateCodec(MediaContentDescription* content_desc,
2892 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002893 const cricket::FeedbackParam& feedback_param) {
2894 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002895 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2896 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002897 AddFeedbackParameter(feedback_param, &new_codec);
2898 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2899}
2900
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002901template <class T>
2902bool PopWildcardCodec(std::vector<T>* codecs, T* wildcard_codec) {
2903 for (auto iter = codecs->begin(); iter != codecs->end(); ++iter) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002904 if (iter->id == kWildcardPayloadType) {
2905 *wildcard_codec = *iter;
2906 codecs->erase(iter);
2907 return true;
2908 }
2909 }
2910 return false;
2911}
2912
Yves Gerey665174f2018-06-19 15:03:05 +02002913template <class T>
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002914void UpdateFromWildcardCodecs(cricket::MediaContentDescriptionImpl<T>* desc) {
2915 auto codecs = desc->codecs();
2916 T wildcard_codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002917 if (!PopWildcardCodec(&codecs, &wildcard_codec)) {
2918 return;
2919 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002920 for (auto& codec : codecs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002921 AddFeedbackParameters(wildcard_codec.feedback_params, &codec);
2922 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002923 desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002924}
2925
Yves Gerey665174f2018-06-19 15:03:05 +02002926void AddAudioAttribute(const std::string& name,
2927 const std::string& value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002928 AudioContentDescription* audio_desc) {
2929 if (value.empty()) {
2930 return;
2931 }
2932 std::vector<cricket::AudioCodec> codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002933 for (cricket::AudioCodec& codec : codecs) {
2934 codec.params[name] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002935 }
2936 audio_desc->set_codecs(codecs);
2937}
2938
2939bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002940 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002941 int mline_index,
2942 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002943 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002944 size_t* pos,
2945 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002946 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002947 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002948 MediaContentDescription* media_desc,
2949 TransportDescription* transport,
Steve Anton5a1de872018-12-18 11:25:55 -08002950 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002951 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002952 RTC_DCHECK(media_desc != NULL);
2953 RTC_DCHECK(content_name != NULL);
2954 RTC_DCHECK(transport != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002955
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002956 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002957 MaybeCreateStaticPayloadAudioCodecs(payload_types, media_desc->as_audio());
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002958 }
2959
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002960 // The media level "ice-ufrag" and "ice-pwd".
2961 // The candidates before update the media level "ice-pwd" and "ice-ufrag".
2962 Candidates candidates_orig;
2963 std::string line;
2964 std::string mline_id;
2965 // Tracks created out of the ssrc attributes.
2966 StreamParamsVec tracks;
2967 SsrcInfoVec ssrc_infos;
2968 SsrcGroupVec ssrc_groups;
2969 std::string maxptime_as_string;
2970 std::string ptime_as_string;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002971 std::vector<std::string> stream_ids;
deadbeef9d3584c2016-02-16 17:54:10 -08002972 std::string track_id;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002973 SdpSerializer deserializer;
2974 std::vector<RidDescription> rids;
Amit Hilbucha2012042018-12-03 11:35:05 -08002975 SimulcastDescription simulcast;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002976
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002977 // Loop until the next m line
2978 while (!IsLineType(message, kLineTypeMedia, *pos)) {
2979 if (!GetLine(message, pos, &line)) {
2980 if (*pos >= message.size()) {
2981 break; // Done parsing
2982 } else {
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +00002983 return ParseFailed(message, *pos, "Invalid SDP line.", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002984 }
2985 }
2986
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002987 // RFC 4566
2988 // b=* (zero or more bandwidth information lines)
2989 if (IsLineType(line, kLineTypeSessionBandwidth)) {
2990 std::string bandwidth;
2991 if (HasAttribute(line, kApplicationSpecificMaximum)) {
2992 if (!GetValue(line, kApplicationSpecificMaximum, &bandwidth, error)) {
2993 return false;
2994 } else {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002995 int b = 0;
2996 if (!GetValueFromString(line, bandwidth, &b, error)) {
2997 return false;
2998 }
deadbeef3e8016e2017-08-03 17:49:30 -07002999 // TODO(deadbeef): Historically, applications may be setting a value
3000 // of -1 to mean "unset any previously set bandwidth limit", even
3001 // though ommitting the "b=AS" entirely will do just that. Once we've
3002 // transitioned applications to doing the right thing, it would be
3003 // better to treat this as a hard error instead of just ignoring it.
3004 if (b == -1) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003005 RTC_LOG(LS_WARNING)
3006 << "Ignoring \"b=AS:-1\"; will be treated as \"no "
3007 "bandwidth limit\".";
deadbeef3e8016e2017-08-03 17:49:30 -07003008 continue;
3009 }
deadbeefbc88c6b2017-08-02 11:26:34 -07003010 if (b < 0) {
3011 return ParseFailed(line, "b=AS value can't be negative.", error);
3012 }
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003013 // We should never use more than the default bandwidth for RTP-based
3014 // data channels. Don't allow SDP to set the bandwidth, because
3015 // that would give JS the opportunity to "break the Internet".
3016 // See: https://code.google.com/p/chromium/issues/detail?id=280726
3017 if (media_type == cricket::MEDIA_TYPE_DATA && IsRtp(protocol) &&
3018 b > cricket::kDataMaxBandwidth / 1000) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003019 rtc::StringBuilder description;
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003020 description << "RTP-based data channels may not send more than "
3021 << cricket::kDataMaxBandwidth / 1000 << "kbps.";
3022 return ParseFailed(line, description.str(), error);
3023 }
deadbeefb2362572016-12-13 16:37:06 -08003024 // Prevent integer overflow.
3025 b = std::min(b, INT_MAX / 1000);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003026 media_desc->set_bandwidth(b * 1000);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003027 }
3028 }
3029 continue;
3030 }
3031
zhihuang38989e52017-03-21 11:04:53 -07003032 // Parse the media level connection data.
3033 if (IsLineType(line, kLineTypeConnection)) {
3034 rtc::SocketAddress addr;
3035 if (!ParseConnectionData(line, &addr, error)) {
3036 return false;
3037 }
3038 media_desc->set_connection_address(addr);
3039 continue;
3040 }
3041
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003042 if (!IsLineType(line, kLineTypeAttributes)) {
Steve Anton36b29d12017-10-30 09:57:42 -07003043 // TODO(deadbeef): Handle other lines if needed.
Mirko Bonadei675513b2017-11-09 11:09:25 +01003044 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003045 continue;
3046 }
3047
3048 // Handle attributes common to SCTP and RTP.
3049 if (HasAttribute(line, kAttributeMid)) {
3050 // RFC 3388
3051 // mid-attribute = "a=mid:" identification-tag
3052 // identification-tag = token
3053 // Use the mid identification-tag as the content name.
3054 if (!GetValue(line, kAttributeMid, &mline_id, error)) {
3055 return false;
3056 }
3057 *content_name = mline_id;
deadbeef25ed4352016-12-12 18:37:36 -08003058 } else if (HasAttribute(line, kAttributeBundleOnly)) {
3059 *bundle_only = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003060 } else if (HasAttribute(line, kAttributeCandidate)) {
3061 Candidate candidate;
3062 if (!ParseCandidate(line, &candidate, error, false)) {
3063 return false;
3064 }
deadbeef7bcdb692017-01-20 12:43:58 -08003065 // ParseCandidate will parse non-standard ufrag and password attributes,
3066 // since it's used for candidate trickling, but we only want to process
3067 // the "a=ice-ufrag"/"a=ice-pwd" values in a session description, so
3068 // strip them off at this point.
3069 candidate.set_username(std::string());
3070 candidate.set_password(std::string());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003071 candidates_orig.push_back(candidate);
3072 } else if (HasAttribute(line, kAttributeIceUfrag)) {
3073 if (!GetValue(line, kAttributeIceUfrag, &transport->ice_ufrag, error)) {
3074 return false;
3075 }
3076 } else if (HasAttribute(line, kAttributeIcePwd)) {
3077 if (!GetValue(line, kAttributeIcePwd, &transport->ice_pwd, error)) {
3078 return false;
3079 }
3080 } else if (HasAttribute(line, kAttributeIceOption)) {
3081 if (!ParseIceOptions(line, &transport->transport_options, error)) {
3082 return false;
3083 }
3084 } else if (HasAttribute(line, kAttributeFmtp)) {
3085 if (!ParseFmtpAttributes(line, media_type, media_desc, error)) {
3086 return false;
3087 }
3088 } else if (HasAttribute(line, kAttributeFingerprint)) {
Steve Anton4905edb2018-10-15 19:27:44 -07003089 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003090 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
3091 return false;
3092 }
Steve Anton4905edb2018-10-15 19:27:44 -07003093 transport->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00003094 } else if (HasAttribute(line, kAttributeSetup)) {
3095 if (!ParseDtlsSetup(line, &(transport->connection_role), error)) {
3096 return false;
3097 }
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00003098 } else if (IsDtlsSctp(protocol) && HasAttribute(line, kAttributeSctpPort)) {
deadbeef7e146cb2016-09-28 10:04:34 -07003099 if (media_type != cricket::MEDIA_TYPE_DATA) {
3100 return ParseFailed(
3101 line, "sctp-port attribute found in non-data media description.",
3102 error);
3103 }
Harald Alvestrand26bf7c42019-04-23 05:20:17 +00003104 if (media_desc->as_sctp()->use_sctpmap()) {
3105 return ParseFailed(
3106 line, "sctp-port attribute can't be used with sctpmap.", error);
3107 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00003108 int sctp_port;
3109 if (!ParseSctpPort(line, &sctp_port, error)) {
3110 return false;
3111 }
Harald Alvestrand26bf7c42019-04-23 05:20:17 +00003112 media_desc->as_sctp()->set_port(sctp_port);
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02003113 } else if (IsDtlsSctp(protocol) &&
3114 HasAttribute(line, kAttributeMaxMessageSize)) {
3115 if (media_type != cricket::MEDIA_TYPE_DATA) {
3116 return ParseFailed(
3117 line,
3118 "max-message-size attribute found in non-data media description.",
3119 error);
3120 }
3121 int max_message_size;
3122 if (!ParseSctpMaxMessageSize(line, &max_message_size, error)) {
3123 return false;
3124 }
Harald Alvestrand26bf7c42019-04-23 05:20:17 +00003125 media_desc->as_sctp()->set_max_message_size(max_message_size);
pthatcher@webrtc.org3341b402015-02-13 21:14:22 +00003126 } else if (IsRtp(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003127 //
3128 // RTP specific attrubtes
3129 //
3130 if (HasAttribute(line, kAttributeRtcpMux)) {
3131 media_desc->set_rtcp_mux(true);
deadbeef13871492015-12-09 12:37:51 -08003132 } else if (HasAttribute(line, kAttributeRtcpReducedSize)) {
3133 media_desc->set_rtcp_reduced_size(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003134 } else if (HasAttribute(line, kAttributeSsrcGroup)) {
3135 if (!ParseSsrcGroupAttribute(line, &ssrc_groups, error)) {
3136 return false;
3137 }
3138 } else if (HasAttribute(line, kAttributeSsrc)) {
Steve Antone831b8c2018-02-01 12:22:16 -08003139 if (!ParseSsrcAttribute(line, &ssrc_infos, msid_signaling, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003140 return false;
3141 }
3142 } else if (HasAttribute(line, kAttributeCrypto)) {
3143 if (!ParseCryptoAttribute(line, media_desc, error)) {
3144 return false;
3145 }
3146 } else if (HasAttribute(line, kAttributeRtpmap)) {
deadbeef67cf2c12016-04-13 10:07:16 -07003147 if (!ParseRtpmapAttribute(line, media_type, payload_types, media_desc,
3148 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003149 return false;
3150 }
3151 } else if (HasAttribute(line, kCodecParamMaxPTime)) {
3152 if (!GetValue(line, kCodecParamMaxPTime, &maxptime_as_string, error)) {
3153 return false;
3154 }
3155 } else if (HasAttribute(line, kAttributeRtcpFb)) {
3156 if (!ParseRtcpFbAttribute(line, media_type, media_desc, error)) {
3157 return false;
3158 }
3159 } else if (HasAttribute(line, kCodecParamPTime)) {
3160 if (!GetValue(line, kCodecParamPTime, &ptime_as_string, error)) {
3161 return false;
3162 }
3163 } else if (HasAttribute(line, kAttributeSendOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003164 media_desc->set_direction(RtpTransceiverDirection::kSendOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003165 } else if (HasAttribute(line, kAttributeRecvOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003166 media_desc->set_direction(RtpTransceiverDirection::kRecvOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003167 } else if (HasAttribute(line, kAttributeInactive)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003168 media_desc->set_direction(RtpTransceiverDirection::kInactive);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003169 } else if (HasAttribute(line, kAttributeSendRecv)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003170 media_desc->set_direction(RtpTransceiverDirection::kSendRecv);
Johannes Kron0854eb62018-10-10 22:33:20 +02003171 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02003172 media_desc->set_extmap_allow_mixed_enum(
Johannes Kron0854eb62018-10-10 22:33:20 +02003173 MediaContentDescription::kMedia);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003174 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07003175 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003176 if (!ParseExtmap(line, &extmap, error)) {
3177 return false;
3178 }
3179 media_desc->AddRtpHeaderExtension(extmap);
3180 } else if (HasAttribute(line, kAttributeXGoogleFlag)) {
3181 // Experimental attribute. Conference mode activates more aggressive
3182 // AEC and NS settings.
Steve Anton36b29d12017-10-30 09:57:42 -07003183 // TODO(deadbeef): expose API to set these directly.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003184 std::string flag_value;
3185 if (!GetValue(line, kAttributeXGoogleFlag, &flag_value, error)) {
3186 return false;
3187 }
3188 if (flag_value.compare(kValueConference) == 0)
3189 media_desc->set_conference_mode(true);
deadbeef9d3584c2016-02-16 17:54:10 -08003190 } else if (HasAttribute(line, kAttributeMsid)) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07003191 if (!ParseMsidAttribute(line, &stream_ids, &track_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08003192 return false;
3193 }
Steve Antone831b8c2018-02-01 12:22:16 -08003194 *msid_signaling |= cricket::kMsidSignalingMediaSection;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003195 } else if (HasAttribute(line, kAttributeRid)) {
3196 const size_t kRidPrefixLength =
3197 kLinePrefixLength + arraysize(kAttributeRid);
3198 if (line.size() <= kRidPrefixLength) {
3199 RTC_LOG(LS_INFO) << "Ignoring empty RID attribute: " << line;
3200 continue;
3201 }
3202 RTCErrorOr<RidDescription> error_or_rid_description =
3203 deserializer.DeserializeRidDescription(
3204 line.substr(kRidPrefixLength));
3205
3206 // Malformed a=rid lines are discarded.
3207 if (!error_or_rid_description.ok()) {
3208 RTC_LOG(LS_INFO) << "Ignoring malformed RID line: '" << line
3209 << "'. Error: "
3210 << error_or_rid_description.error().message();
3211 continue;
3212 }
3213
3214 rids.push_back(error_or_rid_description.MoveValue());
Amit Hilbucha2012042018-12-03 11:35:05 -08003215 } else if (HasAttribute(line, kAttributeSimulcast)) {
3216 const size_t kSimulcastPrefixLength =
3217 kLinePrefixLength + arraysize(kAttributeSimulcast);
3218 if (line.size() <= kSimulcastPrefixLength) {
3219 return ParseFailed(line, "Simulcast attribute is empty.", error);
3220 }
3221
3222 if (!simulcast.empty()) {
3223 return ParseFailed(line, "Multiple Simulcast attributes specified.",
3224 error);
3225 }
3226
Amit Hilbucha2012042018-12-03 11:35:05 -08003227 RTCErrorOr<SimulcastDescription> error_or_simulcast =
3228 deserializer.DeserializeSimulcastDescription(
3229 line.substr(kSimulcastPrefixLength));
3230 if (!error_or_simulcast.ok()) {
3231 return ParseFailed(line,
3232 std::string("Malformed simulcast line: ") +
3233 error_or_simulcast.error().message(),
3234 error);
3235 }
3236
3237 simulcast = error_or_simulcast.value();
3238 } else {
3239 // Unrecognized attribute in RTP protocol.
3240 RTC_LOG(LS_INFO) << "Ignored line: " << line;
3241 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003242 }
3243 } else {
3244 // Only parse lines that we are interested of.
Mirko Bonadei675513b2017-11-09 11:09:25 +01003245 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003246 continue;
3247 }
3248 }
3249
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003250 // Remove duplicate or inconsistent rids.
3251 RemoveInvalidRidDescriptions(payload_types, &rids);
3252
3253 // If simulcast is specifed, split the rids into send and receive.
3254 // Rids that do not appear in simulcast attribute will be removed.
3255 // If it is not specified, we assume that all rids are for send layers.
Amit Hilbuchb7446ed2019-01-28 12:25:25 -08003256 std::vector<RidDescription> send_rids;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003257 if (!simulcast.empty()) {
3258 // Verify that the rids in simulcast match rids in sdp.
3259 RemoveInvalidRidsFromSimulcast(rids, &simulcast);
3260
3261 // Use simulcast description to figure out Send / Receive RIDs.
3262 std::map<std::string, RidDescription> rid_map;
3263 for (const RidDescription& rid : rids) {
3264 rid_map[rid.rid] = rid;
3265 }
3266
3267 for (const auto& layer : simulcast.send_layers().GetAllLayers()) {
3268 auto iter = rid_map.find(layer.rid);
3269 RTC_DCHECK(iter != rid_map.end());
3270 send_rids.push_back(iter->second);
3271 }
3272
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003273 media_desc->set_simulcast_description(simulcast);
3274 } else {
3275 send_rids = rids;
3276 }
3277
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003278 // Create tracks from the |ssrc_infos|.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -08003279 // If the stream_id/track_id for all SSRCS are identical, one StreamParams
3280 // will be created in CreateTracksFromSsrcInfos, containing all the SSRCs from
3281 // the m= section.
Seth Hampson5897a6e2018-04-03 11:16:33 -07003282 if (!ssrc_infos.empty()) {
3283 CreateTracksFromSsrcInfos(ssrc_infos, stream_ids, track_id, &tracks,
3284 *msid_signaling);
3285 } else if (media_type != cricket::MEDIA_TYPE_DATA &&
3286 (*msid_signaling & cricket::kMsidSignalingMediaSection)) {
3287 // If the stream_ids/track_id was signaled but SSRCs were unsignaled we
3288 // still create a track. This isn't done for data media types because
3289 // StreamParams aren't used for SCTP streams, and RTP data channels don't
3290 // support unsignaled SSRCs.
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003291 CreateTrackWithNoSsrcs(stream_ids, track_id, send_rids, &tracks);
3292 }
3293
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003294 // Add the ssrc group to the track.
Steve Anton4daf66e2018-09-07 14:55:53 -07003295 for (const SsrcGroup& ssrc_group : ssrc_groups) {
3296 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003297 continue;
3298 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003299 uint32_t ssrc = ssrc_group.ssrcs.front();
3300 for (StreamParams& track : tracks) {
3301 if (track.has_ssrc(ssrc)) {
3302 track.ssrc_groups.push_back(ssrc_group);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003303 }
3304 }
3305 }
3306
3307 // Add the new tracks to the |media_desc|.
deadbeef9d3584c2016-02-16 17:54:10 -08003308 for (StreamParams& track : tracks) {
3309 media_desc->AddStream(track);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003310 }
3311
3312 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003313 AudioContentDescription* audio_desc = media_desc->as_audio();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003314 UpdateFromWildcardCodecs(audio_desc);
3315
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003316 // Verify audio codec ensures that no audio codec has been populated with
3317 // only fmtp.
3318 if (!VerifyAudioCodecs(audio_desc)) {
3319 return ParseFailed("Failed to parse audio codecs correctly.", error);
3320 }
3321 AddAudioAttribute(kCodecParamMaxPTime, maxptime_as_string, audio_desc);
3322 AddAudioAttribute(kCodecParamPTime, ptime_as_string, audio_desc);
3323 }
3324
3325 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003326 VideoContentDescription* video_desc = media_desc->as_video();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003327 UpdateFromWildcardCodecs(video_desc);
3328 // Verify video codec ensures that no video codec has been populated with
3329 // only rtcp-fb.
3330 if (!VerifyVideoCodecs(video_desc)) {
3331 return ParseFailed("Failed to parse video codecs correctly.", error);
3332 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003333 }
3334
3335 // RFC 5245
3336 // Update the candidates with the media level "ice-pwd" and "ice-ufrag".
Steve Anton4daf66e2018-09-07 14:55:53 -07003337 for (Candidate& candidate : candidates_orig) {
3338 RTC_DCHECK(candidate.username().empty() ||
3339 candidate.username() == transport->ice_ufrag);
3340 candidate.set_username(transport->ice_ufrag);
3341 RTC_DCHECK(candidate.password().empty());
3342 candidate.set_password(transport->ice_pwd);
3343 candidates->push_back(
Steve Anton5a1de872018-12-18 11:25:55 -08003344 absl::make_unique<JsepIceCandidate>(mline_id, mline_index, candidate));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003345 }
Amit Hilbucha2012042018-12-03 11:35:05 -08003346
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003347 return true;
3348}
3349
Steve Antone831b8c2018-02-01 12:22:16 -08003350bool ParseSsrcAttribute(const std::string& line,
3351 SsrcInfoVec* ssrc_infos,
3352 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003353 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003354 RTC_DCHECK(ssrc_infos != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003355 // RFC 5576
3356 // a=ssrc:<ssrc-id> <attribute>
3357 // a=ssrc:<ssrc-id> <attribute>:<value>
3358 std::string field1, field2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003359 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3360 kSdpDelimiterSpaceChar, &field1, &field2)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003361 const size_t expected_fields = 2;
3362 return ParseFailedExpectFieldNum(line, expected_fields, error);
3363 }
3364
3365 // ssrc:<ssrc-id>
3366 std::string ssrc_id_s;
3367 if (!GetValue(field1, kAttributeSsrc, &ssrc_id_s, error)) {
3368 return false;
3369 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003370 uint32_t ssrc_id = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003371 if (!GetValueFromString(line, ssrc_id_s, &ssrc_id, error)) {
3372 return false;
3373 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003374
3375 std::string attribute;
3376 std::string value;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003377 if (!rtc::tokenize_first(field2, kSdpDelimiterColonChar, &attribute,
3378 &value)) {
3379 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003380 description << "Failed to get the ssrc attribute value from " << field2
3381 << ". Expected format <attribute>:<value>.";
3382 return ParseFailed(line, description.str(), error);
3383 }
3384
3385 // Check if there's already an item for this |ssrc_id|. Create a new one if
3386 // there isn't.
Steve Anton64b626b2019-01-28 17:25:26 -08003387 auto ssrc_info_it =
3388 absl::c_find_if(*ssrc_infos, [ssrc_id](const SsrcInfo& ssrc_info) {
3389 return ssrc_info.ssrc_id == ssrc_id;
3390 });
Steve Anton4daf66e2018-09-07 14:55:53 -07003391 if (ssrc_info_it == ssrc_infos->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003392 SsrcInfo info;
3393 info.ssrc_id = ssrc_id;
3394 ssrc_infos->push_back(info);
Steve Anton4daf66e2018-09-07 14:55:53 -07003395 ssrc_info_it = ssrc_infos->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003396 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003397 SsrcInfo& ssrc_info = *ssrc_info_it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003398
3399 // Store the info to the |ssrc_info|.
3400 if (attribute == kSsrcAttributeCname) {
3401 // RFC 5576
3402 // cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003403 ssrc_info.cname = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003404 } else if (attribute == kSsrcAttributeMsid) {
3405 // draft-alvestrand-mmusic-msid-00
Seth Hampson5b4f0752018-04-02 16:31:36 -07003406 // msid:identifier [appdata]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003407 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003408 rtc::split(value, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003409 if (fields.size() < 1 || fields.size() > 2) {
Yves Gerey665174f2018-06-19 15:03:05 +02003410 return ParseFailed(
3411 line, "Expected format \"msid:<identifier>[ <appdata>]\".", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003412 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003413 ssrc_info.stream_id = fields[0];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003414 if (fields.size() == 2) {
Steve Anton4daf66e2018-09-07 14:55:53 -07003415 ssrc_info.track_id = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003416 }
Steve Antone831b8c2018-02-01 12:22:16 -08003417 *msid_signaling |= cricket::kMsidSignalingSsrcAttribute;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003418 } else if (attribute == kSsrcAttributeMslabel) {
3419 // draft-alvestrand-rtcweb-mid-01
3420 // mslabel:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003421 ssrc_info.mslabel = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003422 } else if (attribute == kSSrcAttributeLabel) {
3423 // The label isn't defined.
3424 // label:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003425 ssrc_info.label = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003426 }
3427 return true;
3428}
3429
3430bool ParseSsrcGroupAttribute(const std::string& line,
3431 SsrcGroupVec* ssrc_groups,
3432 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003433 RTC_DCHECK(ssrc_groups != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003434 // RFC 5576
3435 // a=ssrc-group:<semantics> <ssrc-id> ...
3436 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003437 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003438 const size_t expected_min_fields = 2;
3439 if (fields.size() < expected_min_fields) {
3440 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3441 }
3442 std::string semantics;
3443 if (!GetValue(fields[0], kAttributeSsrcGroup, &semantics, error)) {
3444 return false;
3445 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003446 std::vector<uint32_t> ssrcs;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003447 for (size_t i = 1; i < fields.size(); ++i) {
Peter Boström0c4e06b2015-10-07 12:23:21 +02003448 uint32_t ssrc = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003449 if (!GetValueFromString(line, fields[i], &ssrc, error)) {
3450 return false;
3451 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003452 ssrcs.push_back(ssrc);
3453 }
3454 ssrc_groups->push_back(SsrcGroup(semantics, ssrcs));
3455 return true;
3456}
3457
3458bool ParseCryptoAttribute(const std::string& line,
3459 MediaContentDescription* media_desc,
3460 SdpParseError* error) {
3461 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003462 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003463 // RFC 4568
3464 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
3465 const size_t expected_min_fields = 3;
3466 if (fields.size() < expected_min_fields) {
3467 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3468 }
3469 std::string tag_value;
3470 if (!GetValue(fields[0], kAttributeCrypto, &tag_value, error)) {
3471 return false;
3472 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003473 int tag = 0;
3474 if (!GetValueFromString(line, tag_value, &tag, error)) {
3475 return false;
3476 }
jbauch083b73f2015-07-16 02:46:32 -07003477 const std::string& crypto_suite = fields[1];
3478 const std::string& key_params = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003479 std::string session_params;
3480 if (fields.size() > 3) {
3481 session_params = fields[3];
3482 }
Yves Gerey665174f2018-06-19 15:03:05 +02003483 media_desc->AddCrypto(
3484 CryptoParams(tag, crypto_suite, key_params, session_params));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003485 return true;
3486}
3487
3488// Updates or creates a new codec entry in the audio description with according
deadbeef67cf2c12016-04-13 10:07:16 -07003489// to |name|, |clockrate|, |bitrate|, and |channels|.
3490void UpdateCodec(int payload_type,
3491 const std::string& name,
3492 int clockrate,
3493 int bitrate,
3494 size_t channels,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003495 AudioContentDescription* audio_desc) {
3496 // Codec may already be populated with (only) optional parameters
3497 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003498 cricket::AudioCodec codec =
3499 GetCodecWithPayloadType(audio_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003500 codec.name = name;
3501 codec.clockrate = clockrate;
3502 codec.bitrate = bitrate;
3503 codec.channels = channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003504 AddOrReplaceCodec<AudioContentDescription, cricket::AudioCodec>(audio_desc,
3505 codec);
3506}
3507
3508// Updates or creates a new codec entry in the video description according to
deadbeef67cf2c12016-04-13 10:07:16 -07003509// |name|, |width|, |height|, and |framerate|.
3510void UpdateCodec(int payload_type,
3511 const std::string& name,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003512 VideoContentDescription* video_desc) {
3513 // Codec may already be populated with (only) optional parameters
3514 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003515 cricket::VideoCodec codec =
3516 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003517 codec.name = name;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003518 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
3519 codec);
3520}
3521
3522bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003523 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -07003524 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003525 MediaContentDescription* media_desc,
3526 SdpParseError* error) {
3527 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003528 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003529 // RFC 4566
3530 // a=rtpmap:<payload type> <encoding name>/<clock rate>[/<encodingparameters>]
3531 const size_t expected_min_fields = 2;
3532 if (fields.size() < expected_min_fields) {
3533 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3534 }
3535 std::string payload_type_value;
3536 if (!GetValue(fields[0], kAttributeRtpmap, &payload_type_value, error)) {
3537 return false;
3538 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003539 int payload_type = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003540 if (!GetPayloadTypeFromString(line, payload_type_value, &payload_type,
3541 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003542 return false;
3543 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003544
Steve Anton64b626b2019-01-28 17:25:26 -08003545 if (!absl::c_linear_search(payload_types, payload_type)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003546 RTC_LOG(LS_WARNING) << "Ignore rtpmap line that did not appear in the "
Jonas Olsson45cc8902018-02-13 10:37:07 +01003547 "<fmt> of the m-line: "
3548 << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003549 return true;
3550 }
jbauch083b73f2015-07-16 02:46:32 -07003551 const std::string& encoder = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003552 std::vector<std::string> codec_params;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00003553 rtc::split(encoder, '/', &codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003554 // <encoding name>/<clock rate>[/<encodingparameters>]
3555 // 2 mandatory fields
3556 if (codec_params.size() < 2 || codec_params.size() > 3) {
3557 return ParseFailed(line,
3558 "Expected format \"<encoding name>/<clock rate>"
3559 "[/<encodingparameters>]\".",
3560 error);
3561 }
jbauch083b73f2015-07-16 02:46:32 -07003562 const std::string& encoding_name = codec_params[0];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003563 int clock_rate = 0;
3564 if (!GetValueFromString(line, codec_params[1], &clock_rate, error)) {
3565 return false;
3566 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003567 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003568 VideoContentDescription* video_desc = media_desc->as_video();
Yves Gerey665174f2018-06-19 15:03:05 +02003569 UpdateCodec(payload_type, encoding_name, video_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003570 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3571 // RFC 4566
3572 // For audio streams, <encoding parameters> indicates the number
3573 // of audio channels. This parameter is OPTIONAL and may be
3574 // omitted if the number of channels is one, provided that no
3575 // additional parameters are needed.
Peter Kasting69558702016-01-12 16:26:35 -08003576 size_t channels = 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003577 if (codec_params.size() == 3) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003578 if (!GetValueFromString(line, codec_params[2], &channels, error)) {
3579 return false;
3580 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003581 }
Steve Antonb1c1de12017-12-21 15:14:30 -08003582 AudioContentDescription* audio_desc = media_desc->as_audio();
ossue1405ad2017-01-23 08:55:48 -08003583 UpdateCodec(payload_type, encoding_name, clock_rate, 0, channels,
deadbeef67cf2c12016-04-13 10:07:16 -07003584 audio_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003585 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003586 DataContentDescription* data_desc = media_desc->as_data();
deadbeef67cf2c12016-04-13 10:07:16 -07003587 data_desc->AddCodec(cricket::DataCodec(payload_type, encoding_name));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003588 }
3589 return true;
3590}
3591
Yves Gerey665174f2018-06-19 15:03:05 +02003592bool ParseFmtpParam(const std::string& line,
3593 std::string* parameter,
3594 std::string* value,
3595 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003596 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, parameter, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003597 ParseFailed(line, "Unable to parse fmtp parameter. \'=\' missing.", error);
3598 return false;
3599 }
3600 // a=fmtp:<payload_type> <param1>=<value1>; <param2>=<value2>; ...
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003601 return true;
3602}
3603
Yves Gerey665174f2018-06-19 15:03:05 +02003604bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003605 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003606 MediaContentDescription* media_desc,
3607 SdpParseError* error) {
3608 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3609 media_type != cricket::MEDIA_TYPE_VIDEO) {
3610 return true;
3611 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003612
3613 std::string line_payload;
3614 std::string line_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003615
3616 // RFC 5576
3617 // a=fmtp:<format> <format specific parameters>
3618 // At least two fields, whereas the second one is any of the optional
3619 // parameters.
Jonas Olssonec9e4922018-09-05 09:53:49 +02003620 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3621 kSdpDelimiterSpaceChar, &line_payload,
3622 &line_params)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003623 ParseFailedExpectMinFieldNum(line, 2, error);
3624 return false;
3625 }
3626
Donald Curtis0e07f922015-05-15 09:21:23 -07003627 // Parse out the payload information.
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003628 std::string payload_type_str;
Donald Curtis0e07f922015-05-15 09:21:23 -07003629 if (!GetValue(line_payload, kAttributeFmtp, &payload_type_str, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003630 return false;
3631 }
3632
Donald Curtis0e07f922015-05-15 09:21:23 -07003633 int payload_type = 0;
Donald Curtis144d0182015-05-15 13:14:24 -07003634 if (!GetPayloadTypeFromString(line_payload, payload_type_str, &payload_type,
3635 error)) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003636 return false;
3637 }
3638
3639 // Parse out format specific parameters.
3640 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003641 rtc::split(line_params, kSdpDelimiterSemicolonChar, &fields);
Donald Curtis0e07f922015-05-15 09:21:23 -07003642
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003643 cricket::CodecParameterMap codec_params;
Donald Curtis144d0182015-05-15 13:14:24 -07003644 for (auto& iter : fields) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003645 if (iter.find(kSdpDelimiterEqual) == std::string::npos) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003646 // Only fmtps with equals are currently supported. Other fmtp types
3647 // should be ignored. Unknown fmtps do not constitute an error.
3648 continue;
3649 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003650
3651 std::string name;
3652 std::string value;
3653 if (!ParseFmtpParam(rtc::string_trim(iter), &name, &value, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003654 return false;
3655 }
3656 codec_params[name] = value;
3657 }
3658
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003659 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3660 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003661 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003662 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
3663 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003664 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003665 }
3666 return true;
3667}
3668
Yves Gerey665174f2018-06-19 15:03:05 +02003669bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003670 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003671 MediaContentDescription* media_desc,
3672 SdpParseError* error) {
3673 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3674 media_type != cricket::MEDIA_TYPE_VIDEO) {
3675 return true;
3676 }
3677 std::vector<std::string> rtcp_fb_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003678 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &rtcp_fb_fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003679 if (rtcp_fb_fields.size() < 2) {
3680 return ParseFailedGetValue(line, kAttributeRtcpFb, error);
3681 }
3682 std::string payload_type_string;
3683 if (!GetValue(rtcp_fb_fields[0], kAttributeRtcpFb, &payload_type_string,
3684 error)) {
3685 return false;
3686 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003687 int payload_type = kWildcardPayloadType;
3688 if (payload_type_string != "*") {
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003689 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3690 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003691 return false;
3692 }
3693 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003694 std::string id = rtcp_fb_fields[1];
3695 std::string param = "";
3696 for (std::vector<std::string>::iterator iter = rtcp_fb_fields.begin() + 2;
3697 iter != rtcp_fb_fields.end(); ++iter) {
3698 param.append(*iter);
3699 }
3700 const cricket::FeedbackParam feedback_param(id, param);
3701
3702 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003703 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
3704 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003705 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003706 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
3707 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003708 }
3709 return true;
3710}
3711
3712} // namespace webrtc