blob: af8a5277ded715700d3b287dd9f87d5905bf15a3 [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"
Niels Möller198cf002019-05-10 12:29:13 +020048#include "rtc_base/string_utils.h"
Jonas Olssonec9e4922018-09-05 09:53:49 +020049#include "rtc_base/strings/string_builder.h"
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -080050#include "rtc_base/third_party/base64/base64.h"
henrike@webrtc.org28e20752013-07-10 00:45:36 +000051
52using cricket::AudioContentDescription;
53using cricket::Candidate;
54using cricket::Candidates;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000055using cricket::ContentInfo;
56using cricket::CryptoParams;
57using cricket::DataContentDescription;
Harald Alvestrand141c0ad2019-05-05 19:00:00 +000058using cricket::ICE_CANDIDATE_COMPONENT_RTCP;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020059using cricket::ICE_CANDIDATE_COMPONENT_RTP;
60using cricket::kCodecParamAssociatedPayloadType;
61using cricket::kCodecParamMaxAverageBitrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000062using cricket::kCodecParamMaxBitrate;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020063using cricket::kCodecParamMaxPlaybackRate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000064using cricket::kCodecParamMaxPTime;
65using cricket::kCodecParamMaxQuantization;
66using cricket::kCodecParamMinBitrate;
67using cricket::kCodecParamMinPTime;
68using cricket::kCodecParamPTime;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020069using cricket::kCodecParamSctpProtocol;
70using cricket::kCodecParamSctpStreams;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000071using cricket::kCodecParamSPropStereo;
buildbot@webrtc.orged97bb02014-05-07 11:15:20 +000072using cricket::kCodecParamStartBitrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000073using cricket::kCodecParamStereo;
Harald Alvestrand141c0ad2019-05-05 19:00:00 +000074using cricket::kCodecParamUseDtx;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020075using cricket::kCodecParamUseInbandFec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000076using cricket::MediaContentDescription;
Harald Alvestrand141c0ad2019-05-05 19:00:00 +000077using cricket::MediaProtocolType;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020078using cricket::MediaType;
Harald Alvestrand141c0ad2019-05-05 19:00:00 +000079using cricket::RidDescription;
Harald Alvestrand5fc28b12019-05-13 13:36:16 +020080using cricket::RtpDataContentDescription;
Harald Alvestrand37f2b432019-05-09 09:19:54 +020081using cricket::RtpHeaderExtensions;
Harald Alvestrand5fc28b12019-05-13 13:36:16 +020082using cricket::SctpDataContentDescription;
Amit Hilbucha2012042018-12-03 11:35:05 -080083using cricket::SimulcastDescription;
Amit Hilbuchc57d5732018-12-11 15:30:11 -080084using cricket::SimulcastLayer;
85using cricket::SimulcastLayerList;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000086using cricket::SsrcGroup;
87using cricket::StreamParams;
88using cricket::StreamParamsVec;
89using cricket::TransportDescription;
90using cricket::TransportInfo;
91using cricket::VideoContentDescription;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +000092using rtc::SocketAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +000093
henrike@webrtc.org28e20752013-07-10 00:45:36 +000094namespace cricket {
95class SessionDescription;
96}
97
deadbeef90f1e1e2017-02-10 12:35:05 -080098// TODO(deadbeef): Switch to using anonymous namespace rather than declaring
99// everything "static".
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000100namespace webrtc {
101
102// Line type
103// RFC 4566
104// An SDP session description consists of a number of lines of text of
105// the form:
106// <type>=<value>
107// where <type> MUST be exactly one case-significant character.
deadbeef9d3584c2016-02-16 17:54:10 -0800108static const int kLinePrefixLength = 2; // Length of <type>=
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000109static const char kLineTypeVersion = 'v';
110static const char kLineTypeOrigin = 'o';
111static const char kLineTypeSessionName = 's';
112static const char kLineTypeSessionInfo = 'i';
113static const char kLineTypeSessionUri = 'u';
114static const char kLineTypeSessionEmail = 'e';
115static const char kLineTypeSessionPhone = 'p';
116static const char kLineTypeSessionBandwidth = 'b';
117static const char kLineTypeTiming = 't';
118static const char kLineTypeRepeatTimes = 'r';
119static const char kLineTypeTimeZone = 'z';
120static const char kLineTypeEncryptionKey = 'k';
121static const char kLineTypeMedia = 'm';
122static const char kLineTypeConnection = 'c';
123static const char kLineTypeAttributes = 'a';
124
125// Attributes
126static const char kAttributeGroup[] = "group";
127static const char kAttributeMid[] = "mid";
deadbeef9d3584c2016-02-16 17:54:10 -0800128static const char kAttributeMsid[] = "msid";
deadbeef25ed4352016-12-12 18:37:36 -0800129static const char kAttributeBundleOnly[] = "bundle-only";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000130static const char kAttributeRtcpMux[] = "rtcp-mux";
deadbeef13871492015-12-09 12:37:51 -0800131static const char kAttributeRtcpReducedSize[] = "rtcp-rsize";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000132static const char kAttributeSsrc[] = "ssrc";
133static const char kSsrcAttributeCname[] = "cname";
Johannes Kron0854eb62018-10-10 22:33:20 +0200134static const char kAttributeExtmapAllowMixed[] = "extmap-allow-mixed";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000135static const char kAttributeExtmap[] = "extmap";
136// draft-alvestrand-mmusic-msid-01
137// a=msid-semantic: WMS
Seth Hampson5b4f0752018-04-02 16:31:36 -0700138// This is a legacy field supported only for Plan B semantics.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000139static const char kAttributeMsidSemantics[] = "msid-semantic";
140static const char kMediaStreamSemantic[] = "WMS";
141static const char kSsrcAttributeMsid[] = "msid";
142static const char kDefaultMsid[] = "default";
Seth Hampson5b4f0752018-04-02 16:31:36 -0700143static const char kNoStreamMsid[] = "-";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000144static const char kSsrcAttributeMslabel[] = "mslabel";
145static const char kSSrcAttributeLabel[] = "label";
146static const char kAttributeSsrcGroup[] = "ssrc-group";
147static const char kAttributeCrypto[] = "crypto";
148static const char kAttributeCandidate[] = "candidate";
149static const char kAttributeCandidateTyp[] = "typ";
150static const char kAttributeCandidateRaddr[] = "raddr";
151static const char kAttributeCandidateRport[] = "rport";
honghaiza54a0802015-12-16 18:37:23 -0800152static const char kAttributeCandidateUfrag[] = "ufrag";
153static const char kAttributeCandidatePwd[] = "pwd";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000154static const char kAttributeCandidateGeneration[] = "generation";
honghaiza0c44ea2016-03-23 16:07:48 -0700155static const char kAttributeCandidateNetworkId[] = "network-id";
honghaize1a0c942016-02-16 14:54:56 -0800156static const char kAttributeCandidateNetworkCost[] = "network-cost";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000157static const char kAttributeFingerprint[] = "fingerprint";
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000158static const char kAttributeSetup[] = "setup";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000159static const char kAttributeFmtp[] = "fmtp";
160static const char kAttributeRtpmap[] = "rtpmap";
wu@webrtc.org78187522013-10-07 23:32:02 +0000161static const char kAttributeSctpmap[] = "sctpmap";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000162static const char kAttributeRtcp[] = "rtcp";
163static const char kAttributeIceUfrag[] = "ice-ufrag";
164static const char kAttributeIcePwd[] = "ice-pwd";
165static const char kAttributeIceLite[] = "ice-lite";
166static const char kAttributeIceOption[] = "ice-options";
167static const char kAttributeSendOnly[] = "sendonly";
168static const char kAttributeRecvOnly[] = "recvonly";
169static const char kAttributeRtcpFb[] = "rtcp-fb";
170static const char kAttributeSendRecv[] = "sendrecv";
171static const char kAttributeInactive[] = "inactive";
Harald Alvestrand48cce4d2019-04-11 10:41:24 +0200172// draft-ietf-mmusic-sctp-sdp-26
173// a=sctp-port, a=max-message-size
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +0000174static const char kAttributeSctpPort[] = "sctp-port";
Harald Alvestrand48cce4d2019-04-11 10:41:24 +0200175static const char kAttributeMaxMessageSize[] = "max-message-size";
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +0200176static const int kDefaultSctpMaxMessageSize = 65536;
Amit Hilbucha2012042018-12-03 11:35:05 -0800177// draft-ietf-mmusic-sdp-simulcast-13
178// a=simulcast
179static const char kAttributeSimulcast[] = "simulcast";
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800180// draft-ietf-mmusic-rid-15
181// a=rid
182static const char kAttributeRid[] = "rid";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000183
184// Experimental flags
185static const char kAttributeXGoogleFlag[] = "x-google-flag";
186static const char kValueConference[] = "conference";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000187
188// Candidate
189static const char kCandidateHost[] = "host";
190static const char kCandidateSrflx[] = "srflx";
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700191static const char kCandidatePrflx[] = "prflx";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000192static const char kCandidateRelay[] = "relay";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +0000193static const char kTcpCandidateType[] = "tcptype";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000194
Jonas Olssonec9e4922018-09-05 09:53:49 +0200195// rtc::StringBuilder doesn't have a << overload for chars, while rtc::split and
196// rtc::tokenize_first both take a char delimiter. To handle both cases these
197// constants come in pairs of a chars and length-one strings.
198static const char kSdpDelimiterEqual[] = "=";
199static const char kSdpDelimiterEqualChar = '=';
200static const char kSdpDelimiterSpace[] = " ";
201static const char kSdpDelimiterSpaceChar = ' ';
202static const char kSdpDelimiterColon[] = ":";
203static const char kSdpDelimiterColonChar = ':';
204static const char kSdpDelimiterSemicolon[] = ";";
205static const char kSdpDelimiterSemicolonChar = ';';
206static const char kSdpDelimiterSlashChar = '/';
207static const char kNewLine[] = "\n";
208static const char kNewLineChar = '\n';
209static const char kReturnChar = '\r';
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000210static const char kLineBreak[] = "\r\n";
211
Steve Anton36b29d12017-10-30 09:57:42 -0700212// TODO(deadbeef): Generate the Session and Time description
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000213// instead of hardcoding.
214static const char kSessionVersion[] = "v=0";
215// RFC 4566
216static const char kSessionOriginUsername[] = "-";
217static const char kSessionOriginSessionId[] = "0";
218static const char kSessionOriginSessionVersion[] = "0";
219static const char kSessionOriginNettype[] = "IN";
220static const char kSessionOriginAddrtype[] = "IP4";
221static const char kSessionOriginAddress[] = "127.0.0.1";
222static const char kSessionName[] = "s=-";
223static const char kTimeDescription[] = "t=0 0";
224static const char kAttrGroup[] = "a=group:BUNDLE";
225static const char kConnectionNettype[] = "IN";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000226static const char kConnectionIpv4Addrtype[] = "IP4";
227static const char kConnectionIpv6Addrtype[] = "IP6";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000228static const char kMediaTypeVideo[] = "video";
229static const char kMediaTypeAudio[] = "audio";
230static const char kMediaTypeData[] = "application";
231static const char kMediaPortRejected[] = "0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000232// draft-ietf-mmusic-trickle-ice-01
233// When no candidates have been gathered, set the connection
234// address to IP6 ::.
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000235// TODO(perkj): FF can not parse IP6 ::. See http://crbug/430333
236// Use IPV4 per default.
237static const char kDummyAddress[] = "0.0.0.0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000238static const char kDummyPort[] = "9";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000239// RFC 3556
240static const char kApplicationSpecificMaximum[] = "AS";
241
wu@webrtc.org78187522013-10-07 23:32:02 +0000242static const char kDefaultSctpmapProtocol[] = "webrtc-datachannel";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000243
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -0800244// This is a non-standardized media transport settings.
245// This setting is going to be set in the offer. There may be one or more
246// a=x-mt: settings, and they are in the priority order (the most preferred on
247// top). x-mt setting format depends on the media transport, and is generated by
248// |MediaTransportInterface::GetTransportParametersOffer|.
249static const char kMediaTransportSettingLine[] = "x-mt";
250
pkasting@chromium.orgd3245462015-02-23 21:28:22 +0000251// RTP payload type is in the 0-127 range. Use -1 to indicate "all" payload
252// types.
253const int kWildcardPayloadType = -1;
254
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000255struct SsrcInfo {
Peter Boström0c4e06b2015-10-07 12:23:21 +0200256 uint32_t ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000257 std::string cname;
deadbeef9d3584c2016-02-16 17:54:10 -0800258 std::string stream_id;
259 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000260
261 // For backward compatibility.
262 // TODO(ronghuawu): Remove below 2 fields once all the clients support msid.
263 std::string label;
264 std::string mslabel;
265};
266typedef std::vector<SsrcInfo> SsrcInfoVec;
267typedef std::vector<SsrcGroup> SsrcGroupVec;
268
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000269template <class T>
270static void AddFmtpLine(const T& codec, std::string* message);
271static void BuildMediaDescription(const ContentInfo* content_info,
272 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200273 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000274 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -0800275 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000276 std::string* message);
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);
zhihuang38989e52017-03-21 11:04:53 -0700289static bool ParseSessionDescription(const std::string& message,
290 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000291 std::string* session_id,
292 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000293 TransportDescription* session_td,
294 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700295 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000296 cricket::SessionDescription* desc,
297 SdpParseError* error);
298static bool ParseGroupAttribute(const std::string& line,
299 cricket::SessionDescription* desc,
300 SdpParseError* error);
301static bool ParseMediaDescription(
302 const std::string& message,
303 const TransportDescription& session_td,
304 const RtpHeaderExtensions& session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700305 size_t* pos,
306 const rtc::SocketAddress& session_connection_addr,
307 cricket::SessionDescription* desc,
Steve Anton5a1de872018-12-18 11:25:55 -0800308 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000309 SdpParseError* error);
Steve Anton5a1de872018-12-18 11:25:55 -0800310static bool ParseContent(
311 const std::string& message,
312 const cricket::MediaType media_type,
313 int mline_index,
314 const std::string& protocol,
315 const std::vector<int>& payload_types,
316 size_t* pos,
317 std::string* content_name,
318 bool* bundle_only,
319 int* msid_signaling,
320 MediaContentDescription* media_desc,
321 TransportDescription* transport,
322 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
323 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000324static bool ParseSsrcAttribute(const std::string& line,
325 SsrcInfoVec* ssrc_infos,
Steve Antone831b8c2018-02-01 12:22:16 -0800326 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000327 SdpParseError* error);
328static bool ParseSsrcGroupAttribute(const std::string& line,
329 SsrcGroupVec* ssrc_groups,
330 SdpParseError* error);
331static bool ParseCryptoAttribute(const std::string& line,
332 MediaContentDescription* media_desc,
333 SdpParseError* error);
334static bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200335 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -0700336 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000337 MediaContentDescription* media_desc,
338 SdpParseError* error);
339static bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200340 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000341 MediaContentDescription* media_desc,
342 SdpParseError* error);
Yves Gerey665174f2018-06-19 15:03:05 +0200343static bool ParseFmtpParam(const std::string& line,
344 std::string* parameter,
345 std::string* value,
346 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000347static bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200348 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000349 MediaContentDescription* media_desc,
350 SdpParseError* error);
351static bool ParseIceOptions(const std::string& line,
352 std::vector<std::string>* transport_options,
353 SdpParseError* error);
354static bool ParseExtmap(const std::string& line,
isheriff6f8d6862016-05-26 11:24:55 -0700355 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000356 SdpParseError* error);
Steve Anton4905edb2018-10-15 19:27:44 -0700357static bool ParseFingerprintAttribute(
358 const std::string& line,
359 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
360 SdpParseError* error);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000361static bool ParseDtlsSetup(const std::string& line,
362 cricket::ConnectionRole* role,
363 SdpParseError* error);
deadbeef9d3584c2016-02-16 17:54:10 -0800364static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700365 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -0800366 std::string* track_id,
367 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000368
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800369static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
370 std::vector<RidDescription>* rids);
371
372static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
373 const std::set<std::string>& to_remove,
374 const SimulcastLayerList& layers);
375
376static void RemoveInvalidRidsFromSimulcast(
377 const std::vector<RidDescription>& rids,
378 SimulcastDescription* simulcast);
379
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000380// Helper functions
381
382// Below ParseFailed*** functions output the line that caused the parsing
383// failure and the detailed reason (|description|) of the failure to |error|.
384// The functions always return false so that they can be used directly in the
385// following way when error happens:
386// "return ParseFailed***(...);"
387
388// The line starting at |line_start| of |message| is the failing line.
389// The reason for the failure should be provided in the |description|.
390// An example of a description could be "unknown character".
391static bool ParseFailed(const std::string& message,
392 size_t line_start,
393 const std::string& description,
394 SdpParseError* error) {
395 // Get the first line of |message| from |line_start|.
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000396 std::string first_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000397 size_t line_end = message.find(kNewLine, line_start);
398 if (line_end != std::string::npos) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200399 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000400 --line_end;
401 }
402 first_line = message.substr(line_start, (line_end - line_start));
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000403 } else {
404 first_line = message.substr(line_start);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000405 }
406
407 if (error) {
408 error->line = first_line;
409 error->description = description;
410 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100411 RTC_LOG(LS_ERROR) << "Failed to parse: \"" << first_line
412 << "\". Reason: " << description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000413 return false;
414}
415
416// |line| is the failing line. The reason for the failure should be
417// provided in the |description|.
418static bool ParseFailed(const std::string& line,
419 const std::string& description,
420 SdpParseError* error) {
421 return ParseFailed(line, 0, description, error);
422}
423
424// Parses failure where the failing SDP line isn't know or there are multiple
425// failing lines.
Yves Gerey665174f2018-06-19 15:03:05 +0200426static bool ParseFailed(const std::string& description, SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000427 return ParseFailed("", description, error);
428}
429
430// |line| is the failing line. The failure is due to the fact that |line|
431// doesn't have |expected_fields| fields.
432static bool ParseFailedExpectFieldNum(const std::string& line,
433 int expected_fields,
434 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200435 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000436 description << "Expects " << expected_fields << " fields.";
437 return ParseFailed(line, description.str(), error);
438}
439
440// |line| is the failing line. The failure is due to the fact that |line| has
441// less than |expected_min_fields| fields.
442static bool ParseFailedExpectMinFieldNum(const std::string& line,
443 int expected_min_fields,
444 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200445 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000446 description << "Expects at least " << expected_min_fields << " fields.";
447 return ParseFailed(line, description.str(), error);
448}
449
450// |line| is the failing line. The failure is due to the fact that it failed to
451// get the value of |attribute|.
452static bool ParseFailedGetValue(const std::string& line,
453 const std::string& attribute,
454 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200455 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000456 description << "Failed to get the value of attribute: " << attribute;
457 return ParseFailed(line, description.str(), error);
458}
459
460// The line starting at |line_start| of |message| is the failing line. The
461// failure is due to the line type (e.g. the "m" part of the "m-line")
462// not matching what is expected. The expected line type should be
463// provided as |line_type|.
464static bool ParseFailedExpectLine(const std::string& message,
465 size_t line_start,
466 const char line_type,
467 const std::string& line_value,
468 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200469 rtc::StringBuilder description;
470 description << "Expect line: " << std::string(1, line_type) << "="
471 << line_value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000472 return ParseFailed(message, line_start, description.str(), error);
473}
474
475static bool AddLine(const std::string& line, std::string* message) {
476 if (!message)
477 return false;
478
479 message->append(line);
480 message->append(kLineBreak);
481 return true;
482}
483
484static bool GetLine(const std::string& message,
485 size_t* pos,
486 std::string* line) {
487 size_t line_begin = *pos;
488 size_t line_end = message.find(kNewLine, line_begin);
489 if (line_end == std::string::npos) {
490 return false;
491 }
492 // Update the new start position
493 *pos = line_end + 1;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200494 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000495 --line_end;
496 }
497 *line = message.substr(line_begin, (line_end - line_begin));
498 const char* cline = line->c_str();
499 // RFC 4566
500 // An SDP session description consists of a number of lines of text of
501 // the form:
502 // <type>=<value>
503 // where <type> MUST be exactly one case-significant character and
504 // <value> is structured text whose format depends on <type>.
505 // Whitespace MUST NOT be used on either side of the "=" sign.
Taylor Brandstetter93a7b242018-04-16 10:45:24 -0700506 //
507 // However, an exception to the whitespace rule is made for "s=", since
508 // RFC4566 also says:
509 //
510 // If a session has no meaningful name, the value "s= " SHOULD be used
511 // (i.e., a single space as the session name).
512 if (line->length() < 3 || !islower(cline[0]) ||
Jonas Olssonec9e4922018-09-05 09:53:49 +0200513 cline[1] != kSdpDelimiterEqualChar ||
514 (cline[0] != kLineTypeSessionName &&
515 cline[2] == kSdpDelimiterSpaceChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000516 *pos = line_begin;
517 return false;
518 }
519 return true;
520}
521
522// Init |os| to "|type|=|value|".
523static void InitLine(const char type,
524 const std::string& value,
Jonas Olssonec9e4922018-09-05 09:53:49 +0200525 rtc::StringBuilder* os) {
526 os->Clear();
527 *os << std::string(1, type) << kSdpDelimiterEqual << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000528}
529
530// Init |os| to "a=|attribute|".
Jonas Olssonec9e4922018-09-05 09:53:49 +0200531static void InitAttrLine(const std::string& attribute, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000532 InitLine(kLineTypeAttributes, attribute, os);
533}
534
Piotr (Peter) Slatalab1ae10b2019-03-01 11:14:05 -0800535// Writes an x-mt SDP attribute line based on the media transport settings.
536static void AddMediaTransportLine(
537 const cricket::SessionDescription::MediaTransportSetting& setting,
538 std::string* message) {
539 rtc::StringBuilder os;
540 InitAttrLine(kMediaTransportSettingLine, &os);
541 os << kSdpDelimiterColon << setting.transport_name << kSdpDelimiterColon
542 << rtc::Base64::Encode(setting.transport_setting);
543 AddLine(os.str(), message);
544}
545
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000546// Writes a SDP attribute line based on |attribute| and |value| to |message|.
Yves Gerey665174f2018-06-19 15:03:05 +0200547static void AddAttributeLine(const std::string& attribute,
548 int value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000549 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200550 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000551 InitAttrLine(attribute, &os);
552 os << kSdpDelimiterColon << value;
553 AddLine(os.str(), message);
554}
555
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000556static bool IsLineType(const std::string& message,
557 const char type,
558 size_t line_start) {
559 if (message.size() < line_start + kLinePrefixLength) {
560 return false;
561 }
562 const char* cmessage = message.c_str();
563 return (cmessage[line_start] == type &&
Jonas Olssonec9e4922018-09-05 09:53:49 +0200564 cmessage[line_start + 1] == kSdpDelimiterEqualChar);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000565}
566
Yves Gerey665174f2018-06-19 15:03:05 +0200567static bool IsLineType(const std::string& line, const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000568 return IsLineType(line, type, 0);
569}
570
Yves Gerey665174f2018-06-19 15:03:05 +0200571static bool GetLineWithType(const std::string& message,
572 size_t* pos,
573 std::string* line,
574 const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000575 if (!IsLineType(message, type, *pos)) {
576 return false;
577 }
578
579 if (!GetLine(message, pos, line))
580 return false;
581
582 return true;
583}
584
585static bool HasAttribute(const std::string& line,
586 const std::string& attribute) {
Johannes Kron211856b2018-09-06 12:12:28 +0200587 if (line.compare(kLinePrefixLength, attribute.size(), attribute) == 0) {
588 // Make sure that the match is not only a partial match. If length of
589 // strings doesn't match, the next character of the line must be ':' or ' '.
590 // This function is also used for media descriptions (e.g., "m=audio 9..."),
591 // hence the need to also allow space in the end.
592 RTC_CHECK_LE(kLinePrefixLength + attribute.size(), line.size());
593 if ((kLinePrefixLength + attribute.size()) == line.size() ||
594 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterColonChar ||
595 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterSpaceChar) {
596 return true;
597 }
598 }
599 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000600}
601
Peter Boström0c4e06b2015-10-07 12:23:21 +0200602static bool AddSsrcLine(uint32_t ssrc_id,
603 const std::string& attribute,
604 const std::string& value,
605 std::string* message) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000606 // RFC 5576
607 // a=ssrc:<ssrc-id> <attribute>:<value>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200608 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000609 InitAttrLine(kAttributeSsrc, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200610 os << kSdpDelimiterColon << ssrc_id << kSdpDelimiterSpace << attribute
611 << kSdpDelimiterColon << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000612 return AddLine(os.str(), message);
613}
614
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000615// Get value only from <attribute>:<value>.
Yves Gerey665174f2018-06-19 15:03:05 +0200616static bool GetValue(const std::string& message,
617 const std::string& attribute,
618 std::string* value,
619 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000620 std::string leftpart;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200621 if (!rtc::tokenize_first(message, kSdpDelimiterColonChar, &leftpart, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000622 return ParseFailedGetValue(message, attribute, error);
623 }
624 // The left part should end with the expected attribute.
625 if (leftpart.length() < attribute.length() ||
626 leftpart.compare(leftpart.length() - attribute.length(),
627 attribute.length(), attribute) != 0) {
628 return ParseFailedGetValue(message, attribute, error);
629 }
630 return true;
631}
632
633static bool CaseInsensitiveFind(std::string str1, std::string str2) {
Steve Anton64b626b2019-01-28 17:25:26 -0800634 absl::c_transform(str1, str1.begin(), ::tolower);
635 absl::c_transform(str2, str2.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000636 return str1.find(str2) != std::string::npos;
637}
638
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000639template <class T>
640static bool GetValueFromString(const std::string& line,
641 const std::string& s,
642 T* t,
643 SdpParseError* error) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000644 if (!rtc::FromString(s, t)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200645 rtc::StringBuilder description;
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000646 description << "Invalid value: " << s << ".";
647 return ParseFailed(line, description.str(), error);
648 }
649 return true;
650}
651
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000652static bool GetPayloadTypeFromString(const std::string& line,
653 const std::string& s,
654 int* payload_type,
655 SdpParseError* error) {
656 return GetValueFromString(line, s, payload_type, error) &&
Yves Gerey665174f2018-06-19 15:03:05 +0200657 cricket::IsValidRtpPayloadType(*payload_type);
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000658}
659
Seth Hampson5897a6e2018-04-03 11:16:33 -0700660// Creates a StreamParams track in the case when no SSRC lines are signaled.
661// This is a track that does not contain SSRCs and only contains
662// stream_ids/track_id if it's signaled with a=msid lines.
663void CreateTrackWithNoSsrcs(const std::vector<std::string>& msid_stream_ids,
664 const std::string& msid_track_id,
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800665 const std::vector<RidDescription>& rids,
Seth Hampson5897a6e2018-04-03 11:16:33 -0700666 StreamParamsVec* tracks) {
667 StreamParams track;
Amit Hilbuch6df49d82019-04-15 15:47:21 -0700668 if (msid_track_id.empty() && rids.empty()) {
Seth Hampson5897a6e2018-04-03 11:16:33 -0700669 // We only create an unsignaled track if a=msid lines were signaled.
Amit Hilbuch6df49d82019-04-15 15:47:21 -0700670 RTC_LOG(LS_INFO) << "MSID not signaled, skipping creation of StreamParams";
Seth Hampson5897a6e2018-04-03 11:16:33 -0700671 return;
672 }
673 track.set_stream_ids(msid_stream_ids);
674 track.id = msid_track_id;
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800675 track.set_rids(rids);
Seth Hampson5897a6e2018-04-03 11:16:33 -0700676 tracks->push_back(track);
677}
678
679// Creates the StreamParams tracks, for the case when SSRC lines are signaled.
680// |msid_stream_ids| and |msid_track_id| represent the stream/track ID from the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800681// "a=msid" attribute, if it exists. They are empty if the attribute does not
Seth Hampson5897a6e2018-04-03 11:16:33 -0700682// exist. We prioritize getting stream_ids/track_ids signaled in a=msid lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000683void CreateTracksFromSsrcInfos(const SsrcInfoVec& ssrc_infos,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700684 const std::vector<std::string>& msid_stream_ids,
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800685 const std::string& msid_track_id,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700686 StreamParamsVec* tracks,
687 int msid_signaling) {
nisseede5da42017-01-12 05:15:36 -0800688 RTC_DCHECK(tracks != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700689 for (const SsrcInfo& ssrc_info : ssrc_infos) {
690 if (ssrc_info.cname.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000691 continue;
692 }
693
Seth Hampson5b4f0752018-04-02 16:31:36 -0700694 std::vector<std::string> stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000695 std::string track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700696 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
697 // This is the case with Unified Plan SDP msid signaling.
698 stream_ids = msid_stream_ids;
Tomas Gunnarsson191bf5c2018-03-30 10:44:43 +0000699 track_id = msid_track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700700 } else if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
701 // This is the case with Plan B SDP msid signaling.
Steve Anton4daf66e2018-09-07 14:55:53 -0700702 stream_ids.push_back(ssrc_info.stream_id);
703 track_id = ssrc_info.track_id;
704 } else if (!ssrc_info.mslabel.empty()) {
Seth Hampson5b4f0752018-04-02 16:31:36 -0700705 // Since there's no a=msid or a=ssrc msid signaling, this is a sdp from
706 // an older version of client that doesn't support msid.
707 // In that case, we use the mslabel and label to construct the track.
Steve Anton4daf66e2018-09-07 14:55:53 -0700708 stream_ids.push_back(ssrc_info.mslabel);
709 track_id = ssrc_info.label;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700710 } else {
711 // Since no media streams isn't supported with older SDP signaling, we
712 // use a default a stream id.
713 stream_ids.push_back(kDefaultMsid);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000714 }
Seth Hampson5b4f0752018-04-02 16:31:36 -0700715 // If a track ID wasn't populated from the SSRC attributes OR the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800716 // msid attribute, use default/random values.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800717 if (track_id.empty()) {
718 // TODO(ronghuawu): What should we do if the track id doesn't appear?
719 // Create random string (which will be used as track label later)?
720 track_id = rtc::CreateRandomString(8);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000721 }
722
Steve Anton64b626b2019-01-28 17:25:26 -0800723 auto track_it = absl::c_find_if(
724 *tracks,
Steve Anton4daf66e2018-09-07 14:55:53 -0700725 [track_id](const StreamParams& track) { return track.id == track_id; });
726 if (track_it == tracks->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000727 // If we don't find an existing track, create a new one.
728 tracks->push_back(StreamParams());
Steve Anton4daf66e2018-09-07 14:55:53 -0700729 track_it = tracks->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000730 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700731 StreamParams& track = *track_it;
732 track.add_ssrc(ssrc_info.ssrc_id);
733 track.cname = ssrc_info.cname;
734 track.set_stream_ids(stream_ids);
735 track.id = track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000736 }
737}
738
Seth Hampson845e8782018-03-02 11:34:10 -0800739void GetMediaStreamIds(const ContentInfo* content,
740 std::set<std::string>* labels) {
Steve Antonb1c1de12017-12-21 15:14:30 -0800741 for (const StreamParams& stream_params :
742 content->media_description()->streams()) {
Seth Hampson845e8782018-03-02 11:34:10 -0800743 for (const std::string& stream_id : stream_params.stream_ids()) {
744 labels->insert(stream_id);
Steve Anton5a26a3a2018-02-28 11:38:47 -0800745 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000746 }
747}
748
749// RFC 5245
750// It is RECOMMENDED that default candidates be chosen based on the
751// likelihood of those candidates to work with the peer that is being
752// contacted. It is RECOMMENDED that relayed > reflexive > host.
753static const int kPreferenceUnknown = 0;
754static const int kPreferenceHost = 1;
755static const int kPreferenceReflexive = 2;
756static const int kPreferenceRelayed = 3;
757
758static int GetCandidatePreferenceFromType(const std::string& type) {
759 int preference = kPreferenceUnknown;
760 if (type == cricket::LOCAL_PORT_TYPE) {
761 preference = kPreferenceHost;
762 } else if (type == cricket::STUN_PORT_TYPE) {
763 preference = kPreferenceReflexive;
764 } else if (type == cricket::RELAY_PORT_TYPE) {
765 preference = kPreferenceRelayed;
766 } else {
nissec80e7412017-01-11 05:56:46 -0800767 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000768 }
769 return preference;
770}
771
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000772// Get ip and port of the default destination from the |candidates| with the
773// given value of |component_id|. The default candidate should be the one most
774// likely to work, typically IPv4 relay.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000775// RFC 5245
776// The value of |component_id| currently supported are 1 (RTP) and 2 (RTCP).
Steve Anton36b29d12017-10-30 09:57:42 -0700777// TODO(deadbeef): Decide the default destination in webrtcsession and
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000778// pass it down via SessionDescription.
Yves Gerey665174f2018-06-19 15:03:05 +0200779static void GetDefaultDestination(const std::vector<Candidate>& candidates,
780 int component_id,
781 std::string* port,
782 std::string* ip,
783 std::string* addr_type) {
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000784 *addr_type = kConnectionIpv4Addrtype;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000785 *port = kDummyPort;
786 *ip = kDummyAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000787 int current_preference = kPreferenceUnknown;
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000788 int current_family = AF_UNSPEC;
Steve Anton4daf66e2018-09-07 14:55:53 -0700789 for (const Candidate& candidate : candidates) {
790 if (candidate.component() != component_id) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000791 continue;
792 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000793 // Default destination should be UDP only.
Steve Anton4daf66e2018-09-07 14:55:53 -0700794 if (candidate.protocol() != cricket::UDP_PROTOCOL_NAME) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000795 continue;
796 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700797 const int preference = GetCandidatePreferenceFromType(candidate.type());
798 const int family = candidate.address().ipaddr().family();
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000799 // See if this candidate is more preferable then the current one if it's the
800 // same family. Or if the current family is IPv4 already so we could safely
801 // ignore all IPv6 ones. WebRTC bug 4269.
802 // http://code.google.com/p/webrtc/issues/detail?id=4269
803 if ((preference <= current_preference && current_family == family) ||
804 (current_family == AF_INET && family == AF_INET6)) {
805 continue;
806 }
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000807 if (family == AF_INET) {
808 addr_type->assign(kConnectionIpv4Addrtype);
809 } else if (family == AF_INET6) {
810 addr_type->assign(kConnectionIpv6Addrtype);
811 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000812 current_preference = preference;
813 current_family = family;
Steve Anton4daf66e2018-09-07 14:55:53 -0700814 *port = candidate.address().PortAsString();
815 *ip = candidate.address().ipaddr().ToString();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000816 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000817}
818
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000819// Gets "a=rtcp" line if found default RTCP candidate from |candidates|.
820static std::string GetRtcpLine(const std::vector<Candidate>& candidates) {
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000821 std::string rtcp_line, rtcp_port, rtcp_ip, addr_type;
Yves Gerey665174f2018-06-19 15:03:05 +0200822 GetDefaultDestination(candidates, ICE_CANDIDATE_COMPONENT_RTCP, &rtcp_port,
823 &rtcp_ip, &addr_type);
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000824 // Found default RTCP candidate.
825 // RFC 5245
826 // If the agent is utilizing RTCP, it MUST encode the RTCP candidate
827 // using the a=rtcp attribute as defined in RFC 3605.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000828
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000829 // RFC 3605
830 // rtcp-attribute = "a=rtcp:" port [nettype space addrtype space
831 // connection-address] CRLF
Jonas Olssonec9e4922018-09-05 09:53:49 +0200832 rtc::StringBuilder os;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000833 InitAttrLine(kAttributeRtcp, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200834 os << kSdpDelimiterColon << rtcp_port << " " << kConnectionNettype << " "
835 << addr_type << " " << rtcp_ip;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000836 rtcp_line = os.str();
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000837 return rtcp_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000838}
839
840// Get candidates according to the mline index from SessionDescriptionInterface.
841static void GetCandidatesByMindex(const SessionDescriptionInterface& desci,
842 int mline_index,
843 std::vector<Candidate>* candidates) {
844 if (!candidates) {
845 return;
846 }
847 const IceCandidateCollection* cc = desci.candidates(mline_index);
848 for (size_t i = 0; i < cc->count(); ++i) {
849 const IceCandidateInterface* candidate = cc->at(i);
850 candidates->push_back(candidate->candidate());
851 }
852}
853
deadbeef90f1e1e2017-02-10 12:35:05 -0800854static bool IsValidPort(int port) {
855 return port >= 0 && port <= 65535;
856}
857
Steve Antone831b8c2018-02-01 12:22:16 -0800858std::string SdpSerialize(const JsepSessionDescription& jdesc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000859 const cricket::SessionDescription* desc = jdesc.description();
860 if (!desc) {
861 return "";
862 }
863
864 std::string message;
865
866 // Session Description.
867 AddLine(kSessionVersion, &message);
868 // Session Origin
869 // RFC 4566
870 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
871 // <unicast-address>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200872 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000873 InitLine(kLineTypeOrigin, kSessionOriginUsername, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200874 const std::string& session_id =
875 jdesc.session_id().empty() ? kSessionOriginSessionId : jdesc.session_id();
876 const std::string& session_version = jdesc.session_version().empty()
877 ? kSessionOriginSessionVersion
878 : jdesc.session_version();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000879 os << " " << session_id << " " << session_version << " "
880 << kSessionOriginNettype << " " << kSessionOriginAddrtype << " "
881 << kSessionOriginAddress;
882 AddLine(os.str(), &message);
883 AddLine(kSessionName, &message);
884
885 // Time Description.
886 AddLine(kTimeDescription, &message);
887
Piotr (Peter) Slatalab1ae10b2019-03-01 11:14:05 -0800888 for (const cricket::SessionDescription::MediaTransportSetting& settings :
889 desc->MediaTransportSettings()) {
890 AddMediaTransportLine(settings, &message);
891 }
892
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000893 // Group
894 if (desc->HasGroup(cricket::GROUP_TYPE_BUNDLE)) {
895 std::string group_line = kAttrGroup;
896 const cricket::ContentGroup* group =
897 desc->GetGroupByName(cricket::GROUP_TYPE_BUNDLE);
nisseede5da42017-01-12 05:15:36 -0800898 RTC_DCHECK(group != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700899 for (const std::string& content_name : group->content_names()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000900 group_line.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -0700901 group_line.append(content_name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000902 }
903 AddLine(group_line, &message);
904 }
905
Johannes Kron0854eb62018-10-10 22:33:20 +0200906 // Mixed one- and two-byte header extension.
Johannes Kron9581bc42018-10-23 10:17:39 +0200907 if (desc->extmap_allow_mixed()) {
Johannes Kron0854eb62018-10-10 22:33:20 +0200908 InitAttrLine(kAttributeExtmapAllowMixed, &os);
909 AddLine(os.str(), &message);
910 }
911
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000912 // MediaStream semantics
913 InitAttrLine(kAttributeMsidSemantics, &os);
914 os << kSdpDelimiterColon << " " << kMediaStreamSemantic;
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000915
Seth Hampson845e8782018-03-02 11:34:10 -0800916 std::set<std::string> media_stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000917 const ContentInfo* audio_content = GetFirstAudioContent(desc);
918 if (audio_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800919 GetMediaStreamIds(audio_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000920
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000921 const ContentInfo* video_content = GetFirstVideoContent(desc);
922 if (video_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800923 GetMediaStreamIds(video_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000924
Steve Anton4daf66e2018-09-07 14:55:53 -0700925 for (const std::string& id : media_stream_ids) {
926 os << " " << id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000927 }
928 AddLine(os.str(), &message);
929
Taylor Brandstetter2f65ec52018-05-24 11:37:28 -0700930 // a=ice-lite
931 //
932 // TODO(deadbeef): It's weird that we need to iterate TransportInfos for
933 // this, when it's a session-level attribute. It really should be moved to a
934 // session-level structure like SessionDescription.
935 for (const cricket::TransportInfo& transport : desc->transport_infos()) {
936 if (transport.description.ice_mode == cricket::ICEMODE_LITE) {
937 InitAttrLine(kAttributeIceLite, &os);
938 AddLine(os.str(), &message);
939 break;
940 }
941 }
942
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000943 // Preserve the order of the media contents.
944 int mline_index = -1;
Steve Anton4daf66e2018-09-07 14:55:53 -0700945 for (const ContentInfo& content : desc->contents()) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000946 std::vector<Candidate> candidates;
947 GetCandidatesByMindex(jdesc, ++mline_index, &candidates);
Steve Anton4daf66e2018-09-07 14:55:53 -0700948 BuildMediaDescription(&content, desc->GetTransportInfoByName(content.name),
949 content.media_description()->type(), candidates,
950 desc->msid_signaling(), &message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000951 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000952 return message;
953}
954
955// Serializes the passed in IceCandidateInterface to a SDP string.
956// candidate - The candidate to be serialized.
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700957std::string SdpSerializeCandidate(const IceCandidateInterface& candidate) {
958 return SdpSerializeCandidate(candidate.candidate());
959}
960
961// Serializes a cricket Candidate.
962std::string SdpSerializeCandidate(const cricket::Candidate& candidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000963 std::string message;
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700964 std::vector<cricket::Candidate> candidates(1, candidate);
honghaiza54a0802015-12-16 18:37:23 -0800965 BuildCandidate(candidates, true, &message);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000966 // From WebRTC draft section 4.8.1.1 candidate-attribute will be
967 // just candidate:<candidate> not a=candidate:<blah>CRLF
nisseede5da42017-01-12 05:15:36 -0800968 RTC_DCHECK(message.find("a=") == 0);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000969 message.erase(0, 2);
nisseede5da42017-01-12 05:15:36 -0800970 RTC_DCHECK(message.find(kLineBreak) == message.size() - 2);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000971 message.resize(message.size() - 2);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000972 return message;
973}
974
975bool SdpDeserialize(const std::string& message,
976 JsepSessionDescription* jdesc,
977 SdpParseError* error) {
978 std::string session_id;
979 std::string session_version;
Peter Thatcher7cbd1882015-09-17 18:54:52 -0700980 TransportDescription session_td("", "");
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000981 RtpHeaderExtensions session_extmaps;
zhihuang38989e52017-03-21 11:04:53 -0700982 rtc::SocketAddress session_connection_addr;
Steve Anton5a1de872018-12-18 11:25:55 -0800983 auto desc = absl::make_unique<cricket::SessionDescription>();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000984 size_t current_pos = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000985
986 // Session Description
987 if (!ParseSessionDescription(message, &current_pos, &session_id,
deadbeefc80741f2015-10-22 13:14:45 -0700988 &session_version, &session_td, &session_extmaps,
Steve Anton5a1de872018-12-18 11:25:55 -0800989 &session_connection_addr, desc.get(), error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000990 return false;
991 }
992
993 // Media Description
Steve Anton5a1de872018-12-18 11:25:55 -0800994 std::vector<std::unique_ptr<JsepIceCandidate>> candidates;
deadbeefc80741f2015-10-22 13:14:45 -0700995 if (!ParseMediaDescription(message, session_td, session_extmaps, &current_pos,
Steve Anton5a1de872018-12-18 11:25:55 -0800996 session_connection_addr, desc.get(), &candidates,
zhihuang38989e52017-03-21 11:04:53 -0700997 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000998 return false;
999 }
1000
Harald Alvestrand4d7160e2019-04-12 07:01:29 +02001001 jdesc->Initialize(std::move(desc), session_id, session_version);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001002
Steve Anton5a1de872018-12-18 11:25:55 -08001003 for (const auto& candidate : candidates) {
1004 jdesc->AddCandidate(candidate.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001005 }
1006 return true;
1007}
1008
1009bool SdpDeserializeCandidate(const std::string& message,
1010 JsepIceCandidate* jcandidate,
1011 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08001012 RTC_DCHECK(jcandidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001013 Candidate candidate;
1014 if (!ParseCandidate(message, &candidate, error, true)) {
1015 return false;
1016 }
1017 jcandidate->SetCandidate(candidate);
1018 return true;
1019}
1020
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001021bool SdpDeserializeCandidate(const std::string& transport_name,
1022 const std::string& message,
1023 cricket::Candidate* candidate,
1024 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08001025 RTC_DCHECK(candidate != nullptr);
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001026 if (!ParseCandidate(message, candidate, error, true)) {
1027 return false;
1028 }
1029 candidate->set_transport_name(transport_name);
1030 return true;
1031}
1032
Yves Gerey665174f2018-06-19 15:03:05 +02001033bool ParseCandidate(const std::string& message,
1034 Candidate* candidate,
1035 SdpParseError* error,
1036 bool is_raw) {
nisseede5da42017-01-12 05:15:36 -08001037 RTC_DCHECK(candidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001038
1039 // Get the first line from |message|.
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001040 std::string first_line = message;
1041 size_t pos = 0;
1042 GetLine(message, &pos, &first_line);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001043
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001044 // Makes sure |message| contains only one line.
1045 if (message.size() > first_line.size()) {
1046 std::string left, right;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001047 if (rtc::tokenize_first(message, kNewLineChar, &left, &right) &&
Donald Curtis0e07f922015-05-15 09:21:23 -07001048 !right.empty()) {
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001049 return ParseFailed(message, 0, "Expect one line only", error);
1050 }
1051 }
1052
1053 // From WebRTC draft section 4.8.1.1 candidate-attribute should be
1054 // candidate:<candidate> when trickled, but we still support
1055 // a=candidate:<blah>CRLF for backward compatibility and for parsing a line
1056 // from the SDP.
1057 if (IsLineType(first_line, kLineTypeAttributes)) {
1058 first_line = first_line.substr(kLinePrefixLength);
1059 }
1060
1061 std::string attribute_candidate;
1062 std::string candidate_value;
1063
1064 // |first_line| must be in the form of "candidate:<value>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001065 if (!rtc::tokenize_first(first_line, kSdpDelimiterColonChar,
1066 &attribute_candidate, &candidate_value) ||
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001067 attribute_candidate != kAttributeCandidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001068 if (is_raw) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001069 rtc::StringBuilder description;
Yves Gerey665174f2018-06-19 15:03:05 +02001070 description << "Expect line: " << kAttributeCandidate << ":"
1071 << "<candidate-str>";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001072 return ParseFailed(first_line, 0, description.str(), error);
1073 } else {
1074 return ParseFailedExpectLine(first_line, 0, kLineTypeAttributes,
1075 kAttributeCandidate, error);
1076 }
1077 }
1078
1079 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001080 rtc::split(candidate_value, kSdpDelimiterSpaceChar, &fields);
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001081
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001082 // RFC 5245
1083 // a=candidate:<foundation> <component-id> <transport> <priority>
1084 // <connection-address> <port> typ <candidate-types>
1085 // [raddr <connection-address>] [rport <port>]
1086 // *(SP extension-att-name SP extension-att-value)
1087 const size_t expected_min_fields = 8;
1088 if (fields.size() < expected_min_fields ||
1089 (fields[6] != kAttributeCandidateTyp)) {
1090 return ParseFailedExpectMinFieldNum(first_line, expected_min_fields, error);
1091 }
jbauch083b73f2015-07-16 02:46:32 -07001092 const std::string& foundation = fields[0];
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001093
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001094 int component_id = 0;
1095 if (!GetValueFromString(first_line, fields[1], &component_id, error)) {
1096 return false;
1097 }
jbauch083b73f2015-07-16 02:46:32 -07001098 const std::string& transport = fields[2];
Peter Boström0c4e06b2015-10-07 12:23:21 +02001099 uint32_t priority = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001100 if (!GetValueFromString(first_line, fields[3], &priority, error)) {
1101 return false;
1102 }
jbauch083b73f2015-07-16 02:46:32 -07001103 const std::string& connection_address = fields[4];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001104 int port = 0;
1105 if (!GetValueFromString(first_line, fields[5], &port, error)) {
1106 return false;
1107 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001108 if (!IsValidPort(port)) {
1109 return ParseFailed(first_line, "Invalid port number.", error);
1110 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001111 SocketAddress address(connection_address, port);
1112
1113 cricket::ProtocolType protocol;
hnslb68cc752016-12-13 10:33:41 -08001114 if (!StringToProto(transport.c_str(), &protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001115 return ParseFailed(first_line, "Unsupported transport type.", error);
1116 }
hnslb68cc752016-12-13 10:33:41 -08001117 switch (protocol) {
1118 case cricket::PROTO_UDP:
1119 case cricket::PROTO_TCP:
1120 case cricket::PROTO_SSLTCP:
1121 // Supported protocol.
1122 break;
1123 default:
1124 return ParseFailed(first_line, "Unsupported transport type.", error);
1125 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001126
1127 std::string candidate_type;
jbauch083b73f2015-07-16 02:46:32 -07001128 const std::string& type = fields[7];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001129 if (type == kCandidateHost) {
1130 candidate_type = cricket::LOCAL_PORT_TYPE;
1131 } else if (type == kCandidateSrflx) {
1132 candidate_type = cricket::STUN_PORT_TYPE;
1133 } else if (type == kCandidateRelay) {
1134 candidate_type = cricket::RELAY_PORT_TYPE;
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001135 } else if (type == kCandidatePrflx) {
1136 candidate_type = cricket::PRFLX_PORT_TYPE;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001137 } else {
1138 return ParseFailed(first_line, "Unsupported candidate type.", error);
1139 }
1140
1141 size_t current_position = expected_min_fields;
1142 SocketAddress related_address;
1143 // The 2 optional fields for related address
1144 // [raddr <connection-address>] [rport <port>]
1145 if (fields.size() >= (current_position + 2) &&
1146 fields[current_position] == kAttributeCandidateRaddr) {
1147 related_address.SetIP(fields[++current_position]);
1148 ++current_position;
1149 }
1150 if (fields.size() >= (current_position + 2) &&
1151 fields[current_position] == kAttributeCandidateRport) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001152 int port = 0;
Yves Gerey665174f2018-06-19 15:03:05 +02001153 if (!GetValueFromString(first_line, fields[++current_position], &port,
1154 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001155 return false;
1156 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001157 if (!IsValidPort(port)) {
1158 return ParseFailed(first_line, "Invalid port number.", error);
1159 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001160 related_address.SetPort(port);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001161 ++current_position;
1162 }
1163
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001164 // If this is a TCP candidate, it has additional extension as defined in
1165 // RFC 6544.
1166 std::string tcptype;
1167 if (fields.size() >= (current_position + 2) &&
1168 fields[current_position] == kTcpCandidateType) {
1169 tcptype = fields[++current_position];
1170 ++current_position;
1171
1172 if (tcptype != cricket::TCPTYPE_ACTIVE_STR &&
1173 tcptype != cricket::TCPTYPE_PASSIVE_STR &&
1174 tcptype != cricket::TCPTYPE_SIMOPEN_STR) {
1175 return ParseFailed(first_line, "Invalid TCP candidate type.", error);
1176 }
1177
1178 if (protocol != cricket::PROTO_TCP) {
1179 return ParseFailed(first_line, "Invalid non-TCP candidate", error);
1180 }
1181 }
1182
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001183 // Extension
honghaiza54a0802015-12-16 18:37:23 -08001184 // Though non-standard, we support the ICE ufrag and pwd being signaled on
1185 // the candidate to avoid issues with confusing which generation a candidate
1186 // belongs to when trickling multiple generations at the same time.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001187 std::string username;
1188 std::string password;
Peter Boström0c4e06b2015-10-07 12:23:21 +02001189 uint32_t generation = 0;
honghaiza0c44ea2016-03-23 16:07:48 -07001190 uint16_t network_id = 0;
1191 uint16_t network_cost = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001192 for (size_t i = current_position; i + 1 < fields.size(); ++i) {
1193 // RFC 5245
1194 // *(SP extension-att-name SP extension-att-value)
1195 if (fields[i] == kAttributeCandidateGeneration) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001196 if (!GetValueFromString(first_line, fields[++i], &generation, error)) {
1197 return false;
1198 }
honghaiza54a0802015-12-16 18:37:23 -08001199 } else if (fields[i] == kAttributeCandidateUfrag) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001200 username = fields[++i];
honghaiza54a0802015-12-16 18:37:23 -08001201 } else if (fields[i] == kAttributeCandidatePwd) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001202 password = fields[++i];
honghaiza0c44ea2016-03-23 16:07:48 -07001203 } else if (fields[i] == kAttributeCandidateNetworkId) {
1204 if (!GetValueFromString(first_line, fields[++i], &network_id, error)) {
1205 return false;
1206 }
honghaize1a0c942016-02-16 14:54:56 -08001207 } else if (fields[i] == kAttributeCandidateNetworkCost) {
1208 if (!GetValueFromString(first_line, fields[++i], &network_cost, error)) {
1209 return false;
1210 }
Honghai Zhang351d77b2016-05-20 15:08:29 -07001211 network_cost = std::min(network_cost, rtc::kNetworkCostMax);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001212 } else {
1213 // Skip the unknown extension.
1214 ++i;
1215 }
1216 }
1217
guoweis@webrtc.org61c12472015-01-15 06:53:07 +00001218 *candidate = Candidate(component_id, cricket::ProtoToString(protocol),
guoweis@webrtc.org950c5182014-12-16 23:01:31 +00001219 address, priority, username, password, candidate_type,
honghaiza0c44ea2016-03-23 16:07:48 -07001220 generation, foundation, network_id, network_cost);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001221 candidate->set_related_address(related_address);
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001222 candidate->set_tcptype(tcptype);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001223 return true;
1224}
1225
1226bool ParseIceOptions(const std::string& line,
1227 std::vector<std::string>* transport_options,
1228 SdpParseError* error) {
1229 std::string ice_options;
1230 if (!GetValue(line, kAttributeIceOption, &ice_options, error)) {
1231 return false;
1232 }
1233 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001234 rtc::split(ice_options, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001235 for (size_t i = 0; i < fields.size(); ++i) {
1236 transport_options->push_back(fields[i]);
1237 }
1238 return true;
1239}
1240
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001241bool ParseSctpPort(const std::string& line,
1242 int* sctp_port,
1243 SdpParseError* error) {
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02001244 // draft-ietf-mmusic-sctp-sdp-26
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001245 // a=sctp-port
1246 std::vector<std::string> fields;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001247 const size_t expected_min_fields = 2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001248 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
lally69f57602015-10-08 10:15:04 -07001249 if (fields.size() < expected_min_fields) {
1250 fields.resize(0);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001251 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
lally69f57602015-10-08 10:15:04 -07001252 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001253 if (fields.size() < expected_min_fields) {
1254 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1255 }
1256 if (!rtc::FromString(fields[1], sctp_port)) {
lally69f57602015-10-08 10:15:04 -07001257 return ParseFailed(line, "Invalid sctp port value.", error);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001258 }
1259 return true;
1260}
1261
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02001262bool ParseSctpMaxMessageSize(const std::string& line,
1263 int* max_message_size,
1264 SdpParseError* error) {
1265 // draft-ietf-mmusic-sctp-sdp-26
1266 // a=max-message-size:199999
1267 std::vector<std::string> fields;
1268 const size_t expected_min_fields = 2;
1269 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
1270 if (fields.size() < expected_min_fields) {
1271 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1272 }
1273 if (!rtc::FromString(fields[1], max_message_size)) {
1274 return ParseFailed(line, "Invalid SCTP max message size.", error);
1275 }
1276 return true;
1277}
1278
isheriff6f8d6862016-05-26 11:24:55 -07001279bool ParseExtmap(const std::string& line,
1280 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001281 SdpParseError* error) {
1282 // RFC 5285
1283 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1284 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001285 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001286 const size_t expected_min_fields = 2;
1287 if (fields.size() < expected_min_fields) {
1288 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1289 }
1290 std::string uri = fields[1];
1291
1292 std::string value_direction;
1293 if (!GetValue(fields[0], kAttributeExtmap, &value_direction, error)) {
1294 return false;
1295 }
1296 std::vector<std::string> sub_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001297 rtc::split(value_direction, kSdpDelimiterSlashChar, &sub_fields);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001298 int value = 0;
1299 if (!GetValueFromString(line, sub_fields[0], &value, error)) {
1300 return false;
1301 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001302
jbauch5869f502017-06-29 12:31:36 -07001303 bool encrypted = false;
1304 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1305 // RFC 6904
Steve Anton36b29d12017-10-30 09:57:42 -07001306 // a=extmap:<value["/"<direction>] urn:ietf:params:rtp-hdrext:encrypt <URI>
1307 // <extensionattributes>
jbauch5869f502017-06-29 12:31:36 -07001308 const size_t expected_min_fields_encrypted = expected_min_fields + 1;
1309 if (fields.size() < expected_min_fields_encrypted) {
1310 return ParseFailedExpectMinFieldNum(line, expected_min_fields_encrypted,
Yves Gerey665174f2018-06-19 15:03:05 +02001311 error);
jbauch5869f502017-06-29 12:31:36 -07001312 }
1313
1314 encrypted = true;
1315 uri = fields[2];
1316 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1317 return ParseFailed(line, "Recursive encrypted header.", error);
1318 }
1319 }
1320
1321 *extmap = RtpExtension(uri, value, encrypted);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001322 return true;
1323}
1324
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +02001325static void BuildSctpContentAttributes(
1326 std::string* message,
1327 const cricket::SctpDataContentDescription* data_desc) {
1328 rtc::StringBuilder os;
1329 if (data_desc->use_sctpmap()) {
1330 // draft-ietf-mmusic-sctp-sdp-04
1331 // a=sctpmap:sctpmap-number protocol [streams]
1332 rtc::StringBuilder os;
1333 InitAttrLine(kAttributeSctpmap, &os);
1334 os << kSdpDelimiterColon << data_desc->port() << kSdpDelimiterSpace
1335 << kDefaultSctpmapProtocol << kSdpDelimiterSpace
1336 << cricket::kMaxSctpStreams;
1337 AddLine(os.str(), message);
1338 } else {
1339 // draft-ietf-mmusic-sctp-sdp-23
1340 // a=sctp-port:<port>
1341 InitAttrLine(kAttributeSctpPort, &os);
1342 os << kSdpDelimiterColon << data_desc->port();
1343 AddLine(os.str(), message);
1344 if (data_desc->max_message_size() != kDefaultSctpMaxMessageSize) {
1345 InitAttrLine(kAttributeMaxMessageSize, &os);
1346 os << kSdpDelimiterColon << data_desc->max_message_size();
1347 AddLine(os.str(), message);
1348 }
1349 }
1350}
1351
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001352void BuildMediaDescription(const ContentInfo* content_info,
1353 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001354 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001355 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -08001356 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001357 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001358 RTC_DCHECK(message != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001359 if (content_info == NULL || message == NULL) {
1360 return;
1361 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001362 rtc::StringBuilder os;
Steve Antonb1c1de12017-12-21 15:14:30 -08001363 const MediaContentDescription* media_desc = content_info->media_description();
1364 RTC_DCHECK(media_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001365
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001366 // RFC 4566
1367 // m=<media> <port> <proto> <fmt>
1368 // fmt is a list of payload type numbers that MAY be used in the session.
1369 const char* type = NULL;
1370 if (media_type == cricket::MEDIA_TYPE_AUDIO)
1371 type = kMediaTypeAudio;
1372 else if (media_type == cricket::MEDIA_TYPE_VIDEO)
1373 type = kMediaTypeVideo;
1374 else if (media_type == cricket::MEDIA_TYPE_DATA)
1375 type = kMediaTypeData;
1376 else
nissec80e7412017-01-11 05:56:46 -08001377 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001378
1379 std::string fmt;
1380 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001381 const VideoContentDescription* video_desc = media_desc->as_video();
Steve Anton4daf66e2018-09-07 14:55:53 -07001382 for (const cricket::VideoCodec& codec : video_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001383 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001384 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001385 }
1386 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001387 const AudioContentDescription* audio_desc = media_desc->as_audio();
Steve Anton4daf66e2018-09-07 14:55:53 -07001388 for (const cricket::AudioCodec& codec : audio_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001389 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001390 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001391 }
1392 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001393 const cricket::SctpDataContentDescription* sctp_data_desc =
1394 media_desc->as_sctp();
1395 if (sctp_data_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001396 fmt.append(" ");
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001397
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001398 if (sctp_data_desc->use_sctpmap()) {
1399 fmt.append(rtc::ToString(sctp_data_desc->port()));
zstein4b2e0822017-02-17 19:48:38 -08001400 } else {
1401 fmt.append(kDefaultSctpmapProtocol);
1402 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001403 } else {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001404 const RtpDataContentDescription* rtp_data_desc =
1405 media_desc->as_rtp_data();
1406 for (const cricket::RtpDataCodec& codec : rtp_data_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001407 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001408 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001409 }
1410 }
1411 }
1412 // The fmt must never be empty. If no codecs are found, set the fmt attribute
1413 // to 0.
1414 if (fmt.empty()) {
1415 fmt = " 0";
1416 }
1417
deadbeef25ed4352016-12-12 18:37:36 -08001418 // The port number in the m line will be updated later when associated with
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001419 // the candidates.
deadbeef25ed4352016-12-12 18:37:36 -08001420 //
1421 // A port value of 0 indicates that the m= section is rejected.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001422 // RFC 3264
1423 // To reject an offered stream, the port number in the corresponding stream in
1424 // the answer MUST be set to zero.
deadbeef25ed4352016-12-12 18:37:36 -08001425 //
1426 // However, the BUNDLE draft adds a new meaning to port zero, when used along
1427 // with a=bundle-only.
zhihuang38989e52017-03-21 11:04:53 -07001428 std::string port = kDummyPort;
1429 if (content_info->rejected || content_info->bundle_only) {
1430 port = kMediaPortRejected;
1431 } else if (!media_desc->connection_address().IsNil()) {
1432 port = rtc::ToString(media_desc->connection_address().port());
1433 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001434
Yves Gerey665174f2018-06-19 15:03:05 +02001435 rtc::SSLFingerprint* fp =
1436 (transport_info) ? transport_info->description.identity_fingerprint.get()
1437 : NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001438
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001439 // Add the m and c lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001440 InitLine(kLineTypeMedia, type, &os);
1441 os << " " << port << " " << media_desc->protocol() << fmt;
zhihuang38989e52017-03-21 11:04:53 -07001442 AddLine(os.str(), message);
1443
1444 InitLine(kLineTypeConnection, kConnectionNettype, &os);
1445 if (media_desc->connection_address().IsNil()) {
1446 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
1447 } else if (media_desc->connection_address().family() == AF_INET) {
1448 os << " " << kConnectionIpv4Addrtype << " "
1449 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 12:53:06 -08001450 } else if (media_desc->connection_address().family() == AF_INET6) {
zhihuang38989e52017-03-21 11:04:53 -07001451 os << " " << kConnectionIpv6Addrtype << " "
1452 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 12:53:06 -08001453 } else if (!media_desc->connection_address().hostname().empty()) {
1454 // For hostname candidates, we use c=IN IP4 <hostname>.
1455 os << " " << kConnectionIpv4Addrtype << " "
1456 << media_desc->connection_address().hostname();
1457 } else {
1458 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
zhihuang38989e52017-03-21 11:04:53 -07001459 }
1460 AddLine(os.str(), message);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001461
1462 // RFC 4566
1463 // b=AS:<bandwidth>
Peter Thatcherc0c3a862015-06-24 15:31:25 -07001464 if (media_desc->bandwidth() >= 1000) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001465 InitLine(kLineTypeSessionBandwidth, kApplicationSpecificMaximum, &os);
1466 os << kSdpDelimiterColon << (media_desc->bandwidth() / 1000);
1467 AddLine(os.str(), message);
1468 }
1469
deadbeef25ed4352016-12-12 18:37:36 -08001470 // Add the a=bundle-only line.
1471 if (content_info->bundle_only) {
1472 InitAttrLine(kAttributeBundleOnly, &os);
1473 AddLine(os.str(), message);
1474 }
1475
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001476 // Add the a=rtcp line.
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001477 if (cricket::IsRtpProtocol(media_desc->protocol())) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001478 std::string rtcp_line = GetRtcpLine(candidates);
1479 if (!rtcp_line.empty()) {
1480 AddLine(rtcp_line, message);
1481 }
1482 }
1483
honghaiza54a0802015-12-16 18:37:23 -08001484 // Build the a=candidate lines. We don't include ufrag and pwd in the
1485 // candidates in the SDP to avoid redundancy.
1486 BuildCandidate(candidates, false, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001487
1488 // Use the transport_info to build the media level ice-ufrag and ice-pwd.
1489 if (transport_info) {
1490 // RFC 5245
1491 // ice-pwd-att = "ice-pwd" ":" password
1492 // ice-ufrag-att = "ice-ufrag" ":" ufrag
1493 // ice-ufrag
deadbeef3f7219b2015-12-28 15:17:14 -08001494 if (!transport_info->description.ice_ufrag.empty()) {
1495 InitAttrLine(kAttributeIceUfrag, &os);
1496 os << kSdpDelimiterColon << transport_info->description.ice_ufrag;
1497 AddLine(os.str(), message);
1498 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001499 // ice-pwd
deadbeef3f7219b2015-12-28 15:17:14 -08001500 if (!transport_info->description.ice_pwd.empty()) {
1501 InitAttrLine(kAttributeIcePwd, &os);
1502 os << kSdpDelimiterColon << transport_info->description.ice_pwd;
1503 AddLine(os.str(), message);
1504 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001505
1506 // draft-petithuguenin-mmusic-ice-attributes-level-03
1507 BuildIceOptions(transport_info->description.transport_options, message);
1508
1509 // RFC 4572
1510 // fingerprint-attribute =
1511 // "fingerprint" ":" hash-func SP fingerprint
1512 if (fp) {
1513 // Insert the fingerprint attribute.
1514 InitAttrLine(kAttributeFingerprint, &os);
Yves Gerey665174f2018-06-19 15:03:05 +02001515 os << kSdpDelimiterColon << fp->algorithm << kSdpDelimiterSpace
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001516 << fp->GetRfc4572Fingerprint();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001517 AddLine(os.str(), message);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001518
1519 // Inserting setup attribute.
1520 if (transport_info->description.connection_role !=
Yves Gerey665174f2018-06-19 15:03:05 +02001521 cricket::CONNECTIONROLE_NONE) {
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001522 // Making sure we are not using "passive" mode.
1523 cricket::ConnectionRole role =
1524 transport_info->description.connection_role;
mallinath@webrtc.org19f27e62013-10-13 17:18:27 +00001525 std::string dtls_role_str;
nissec16fa5e2017-02-07 07:18:43 -08001526 const bool success =
1527 cricket::ConnectionRoleToString(role, &dtls_role_str);
1528 RTC_DCHECK(success);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001529 InitAttrLine(kAttributeSetup, &os);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001530 os << kSdpDelimiterColon << dtls_role_str;
1531 AddLine(os.str(), message);
1532 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001533 }
1534 }
1535
1536 // RFC 3388
1537 // mid-attribute = "a=mid:" identification-tag
1538 // identification-tag = token
1539 // Use the content name as the mid identification-tag.
1540 InitAttrLine(kAttributeMid, &os);
1541 os << kSdpDelimiterColon << content_info->name;
1542 AddLine(os.str(), message);
1543
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001544 if (cricket::IsDtlsSctp(media_desc->protocol())) {
1545 const cricket::SctpDataContentDescription* data_desc =
1546 media_desc->as_sctp();
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +02001547 BuildSctpContentAttributes(message, data_desc);
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001548 } else if (cricket::IsRtpProtocol(media_desc->protocol())) {
Steve Antone831b8c2018-02-01 12:22:16 -08001549 BuildRtpContentAttributes(media_desc, media_type, msid_signaling, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001550 }
1551}
1552
deadbeef9d3584c2016-02-16 17:54:10 -08001553void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001554 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -08001555 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -08001556 std::string* message) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001557 SdpSerializer serializer;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001558 rtc::StringBuilder os;
Johannes Kron0854eb62018-10-10 22:33:20 +02001559 // RFC 8285
1560 // a=extmap-allow-mixed
1561 // The attribute MUST be either on session level or media level. We support
1562 // responding on both levels, however, we don't respond on media level if it's
1563 // set on session level.
Johannes Kron9581bc42018-10-23 10:17:39 +02001564 if (media_desc->extmap_allow_mixed_enum() ==
Johannes Kron0854eb62018-10-10 22:33:20 +02001565 MediaContentDescription::kMedia) {
1566 InitAttrLine(kAttributeExtmapAllowMixed, &os);
1567 AddLine(os.str(), message);
1568 }
1569 // RFC 8285
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001570 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1571 // The definitions MUST be either all session level or all media level. This
1572 // implementation uses all media level.
1573 for (size_t i = 0; i < media_desc->rtp_header_extensions().size(); ++i) {
jbauch5869f502017-06-29 12:31:36 -07001574 const RtpExtension& extension = media_desc->rtp_header_extensions()[i];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001575 InitAttrLine(kAttributeExtmap, &os);
jbauch5869f502017-06-29 12:31:36 -07001576 os << kSdpDelimiterColon << extension.id;
1577 if (extension.encrypt) {
1578 os << kSdpDelimiterSpace << RtpExtension::kEncryptHeaderExtensionsUri;
1579 }
1580 os << kSdpDelimiterSpace << extension.uri;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001581 AddLine(os.str(), message);
1582 }
1583
1584 // RFC 3264
1585 // a=sendrecv || a=sendonly || a=sendrecv || a=inactive
deadbeefc80741f2015-10-22 13:14:45 -07001586 switch (media_desc->direction()) {
Steve Anton4e70a722017-11-28 14:57:10 -08001587 case RtpTransceiverDirection::kInactive:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001588 InitAttrLine(kAttributeInactive, &os);
1589 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001590 case RtpTransceiverDirection::kSendOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001591 InitAttrLine(kAttributeSendOnly, &os);
1592 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001593 case RtpTransceiverDirection::kRecvOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001594 InitAttrLine(kAttributeRecvOnly, &os);
1595 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001596 case RtpTransceiverDirection::kSendRecv:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001597 default:
1598 InitAttrLine(kAttributeSendRecv, &os);
1599 break;
1600 }
1601 AddLine(os.str(), message);
1602
Seth Hampson5b4f0752018-04-02 16:31:36 -07001603 // Specified in https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
1604 // a=msid:<msid-id> <msid-appdata>
1605 // The msid-id is a 1*64 token char representing the media stream id, and the
1606 // msid-appdata is a 1*64 token char representing the track id. There is a
1607 // line for every media stream, with a special msid-id value of "-"
1608 // representing no streams. The value of "msid-appdata" MUST be identical for
1609 // all lines.
Steve Antone831b8c2018-02-01 12:22:16 -08001610 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
1611 const StreamParamsVec& streams = media_desc->streams();
1612 if (streams.size() == 1u) {
1613 const StreamParams& track = streams[0];
Seth Hampson5b4f0752018-04-02 16:31:36 -07001614 std::vector<std::string> stream_ids = track.stream_ids();
1615 if (stream_ids.empty()) {
1616 stream_ids.push_back(kNoStreamMsid);
1617 }
1618 for (const std::string& stream_id : stream_ids) {
1619 InitAttrLine(kAttributeMsid, &os);
1620 os << kSdpDelimiterColon << stream_id << kSdpDelimiterSpace << track.id;
1621 AddLine(os.str(), message);
1622 }
Steve Antone831b8c2018-02-01 12:22:16 -08001623 } else if (streams.size() > 1u) {
1624 RTC_LOG(LS_WARNING)
1625 << "Trying to serialize Unified Plan SDP with more than "
Jonas Olsson45cc8902018-02-13 10:37:07 +01001626 "one track in a media section. Omitting 'a=msid'.";
deadbeef9d3584c2016-02-16 17:54:10 -08001627 }
1628 }
1629
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001630 // RFC 5761
1631 // a=rtcp-mux
1632 if (media_desc->rtcp_mux()) {
1633 InitAttrLine(kAttributeRtcpMux, &os);
1634 AddLine(os.str(), message);
1635 }
1636
deadbeef13871492015-12-09 12:37:51 -08001637 // RFC 5506
1638 // a=rtcp-rsize
1639 if (media_desc->rtcp_reduced_size()) {
1640 InitAttrLine(kAttributeRtcpReducedSize, &os);
1641 AddLine(os.str(), message);
1642 }
1643
deadbeefd45aea82017-09-16 01:24:29 -07001644 if (media_desc->conference_mode()) {
1645 InitAttrLine(kAttributeXGoogleFlag, &os);
1646 os << kSdpDelimiterColon << kValueConference;
1647 AddLine(os.str(), message);
1648 }
1649
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001650 // RFC 4568
1651 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001652 for (const CryptoParams& crypto_params : media_desc->cryptos()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001653 InitAttrLine(kAttributeCrypto, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001654 os << kSdpDelimiterColon << crypto_params.tag << " "
1655 << crypto_params.cipher_suite << " " << crypto_params.key_params;
1656 if (!crypto_params.session_params.empty()) {
1657 os << " " << crypto_params.session_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001658 }
1659 AddLine(os.str(), message);
1660 }
1661
1662 // RFC 4566
1663 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1664 // [/<encodingparameters>]
1665 BuildRtpMap(media_desc, media_type, message);
1666
Steve Anton4daf66e2018-09-07 14:55:53 -07001667 for (const StreamParams& track : media_desc->streams()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001668 // Build the ssrc-group lines.
Steve Anton4daf66e2018-09-07 14:55:53 -07001669 for (const SsrcGroup& ssrc_group : track.ssrc_groups) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001670 // RFC 5576
1671 // a=ssrc-group:<semantics> <ssrc-id> ...
Steve Anton4daf66e2018-09-07 14:55:53 -07001672 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001673 continue;
1674 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001675 InitAttrLine(kAttributeSsrcGroup, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001676 os << kSdpDelimiterColon << ssrc_group.semantics;
1677 for (uint32_t ssrc : ssrc_group.ssrcs) {
1678 os << kSdpDelimiterSpace << rtc::ToString(ssrc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001679 }
1680 AddLine(os.str(), message);
1681 }
1682 // Build the ssrc lines for each ssrc.
Steve Anton4daf66e2018-09-07 14:55:53 -07001683 for (uint32_t ssrc : track.ssrcs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001684 // RFC 5576
1685 // a=ssrc:<ssrc-id> cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07001686 AddSsrcLine(ssrc, kSsrcAttributeCname, track.cname, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001687
Steve Antone831b8c2018-02-01 12:22:16 -08001688 if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
1689 // draft-alvestrand-mmusic-msid-00
1690 // a=ssrc:<ssrc-id> msid:identifier [appdata]
1691 // The appdata consists of the "id" attribute of a MediaStreamTrack,
1692 // which corresponds to the "id" attribute of StreamParams.
Seth Hampson5b4f0752018-04-02 16:31:36 -07001693 // Since a=ssrc msid signaling is used in Plan B SDP semantics, and
1694 // multiple stream ids are not supported for Plan B, we are only adding
1695 // a line for the first media stream id here.
Seth Hampson7fa6ee62018-10-17 10:25:28 -07001696 const std::string& track_stream_id = track.first_stream_id();
1697 // We use a special msid-id value of "-" to represent no streams,
1698 // for Unified Plan compatibility. Plan B will always have a
1699 // track_stream_id.
1700 const std::string& stream_id =
1701 track_stream_id.empty() ? kNoStreamMsid : track_stream_id;
Steve Antone831b8c2018-02-01 12:22:16 -08001702 InitAttrLine(kAttributeSsrc, &os);
1703 os << kSdpDelimiterColon << ssrc << kSdpDelimiterSpace
1704 << kSsrcAttributeMsid << kSdpDelimiterColon << stream_id
Steve Anton4daf66e2018-09-07 14:55:53 -07001705 << kSdpDelimiterSpace << track.id;
Steve Antone831b8c2018-02-01 12:22:16 -08001706 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001707
Steve Antone831b8c2018-02-01 12:22:16 -08001708 // TODO(ronghuawu): Remove below code which is for backward
1709 // compatibility.
1710 // draft-alvestrand-rtcweb-mid-01
1711 // a=ssrc:<ssrc-id> mslabel:<value>
1712 // The label isn't yet defined.
1713 // a=ssrc:<ssrc-id> label:<value>
Seth Hampson5b4f0752018-04-02 16:31:36 -07001714 AddSsrcLine(ssrc, kSsrcAttributeMslabel, stream_id, message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001715 AddSsrcLine(ssrc, kSSrcAttributeLabel, track.id, message);
Steve Antone831b8c2018-02-01 12:22:16 -08001716 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001717 }
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001718
1719 // Build the rid lines for each layer of the track
1720 for (const RidDescription& rid_description : track.rids()) {
1721 InitAttrLine(kAttributeRid, &os);
1722 os << kSdpDelimiterColon
1723 << serializer.SerializeRidDescription(rid_description);
1724 AddLine(os.str(), message);
1725 }
1726 }
1727
Amit Hilbucha2012042018-12-03 11:35:05 -08001728 // Simulcast (a=simulcast)
1729 // https://tools.ietf.org/html/draft-ietf-mmusic-sdp-simulcast-13#section-5.1
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001730 if (media_desc->HasSimulcast()) {
1731 const auto& simulcast = media_desc->simulcast_description();
Amit Hilbucha2012042018-12-03 11:35:05 -08001732 InitAttrLine(kAttributeSimulcast, &os);
Amit Hilbucha2012042018-12-03 11:35:05 -08001733 os << kSdpDelimiterColon
1734 << serializer.SerializeSimulcastDescription(simulcast);
1735 AddLine(os.str(), message);
1736 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001737}
1738
Jonas Olssonec9e4922018-09-05 09:53:49 +02001739void WriteFmtpHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001740 // fmtp header: a=fmtp:|payload_type| <parameters>
1741 // Add a=fmtp
1742 InitAttrLine(kAttributeFmtp, os);
1743 // Add :|payload_type|
1744 *os << kSdpDelimiterColon << payload_type;
1745}
1746
Jonas Olssonec9e4922018-09-05 09:53:49 +02001747void WriteRtcpFbHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001748 // rtcp-fb header: a=rtcp-fb:|payload_type|
1749 // <parameters>/<ccm <ccm_parameters>>
1750 // Add a=rtcp-fb
1751 InitAttrLine(kAttributeRtcpFb, os);
1752 // Add :
1753 *os << kSdpDelimiterColon;
1754 if (payload_type == kWildcardPayloadType) {
1755 *os << "*";
1756 } else {
1757 *os << payload_type;
1758 }
1759}
1760
1761void WriteFmtpParameter(const std::string& parameter_name,
1762 const std::string& parameter_value,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001763 rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001764 // fmtp parameters: |parameter_name|=|parameter_value|
1765 *os << parameter_name << kSdpDelimiterEqual << parameter_value;
1766}
1767
1768void WriteFmtpParameters(const cricket::CodecParameterMap& parameters,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001769 rtc::StringBuilder* os) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001770 bool first = true;
1771 for (const auto& entry : parameters) {
1772 const std::string& key = entry.first;
1773 const std::string& value = entry.second;
hta62a216e2016-04-15 11:02:14 -07001774 // Parameters are a semicolon-separated list, no spaces.
1775 // The list is separated from the header by a space.
Steve Anton4daf66e2018-09-07 14:55:53 -07001776 if (first) {
hta62a216e2016-04-15 11:02:14 -07001777 *os << kSdpDelimiterSpace;
Steve Anton4daf66e2018-09-07 14:55:53 -07001778 first = false;
hta62a216e2016-04-15 11:02:14 -07001779 } else {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001780 *os << kSdpDelimiterSemicolon;
1781 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001782 WriteFmtpParameter(key, value, os);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001783 }
1784}
1785
1786bool IsFmtpParam(const std::string& name) {
ossuaa4b0772017-01-30 07:41:18 -08001787 // RFC 4855, section 3 specifies the mapping of media format parameters to SDP
1788 // parameters. Only ptime, maxptime, channels and rate are placed outside of
1789 // the fmtp line. In WebRTC, channels and rate are already handled separately
1790 // and thus not included in the CodecParameterMap.
1791 return name != kCodecParamPTime && name != kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001792}
1793
1794// Retreives fmtp parameters from |params|, which may contain other parameters
1795// as well, and puts them in |fmtp_parameters|.
1796void GetFmtpParams(const cricket::CodecParameterMap& params,
1797 cricket::CodecParameterMap* fmtp_parameters) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001798 for (const auto& entry : params) {
1799 const std::string& key = entry.first;
1800 const std::string& value = entry.second;
1801 if (IsFmtpParam(key)) {
1802 (*fmtp_parameters)[key] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001803 }
1804 }
1805}
1806
1807template <class T>
1808void AddFmtpLine(const T& codec, std::string* message) {
1809 cricket::CodecParameterMap fmtp_parameters;
1810 GetFmtpParams(codec.params, &fmtp_parameters);
1811 if (fmtp_parameters.empty()) {
1812 // No need to add an fmtp if it will have no (optional) parameters.
1813 return;
1814 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001815 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001816 WriteFmtpHeader(codec.id, &os);
1817 WriteFmtpParameters(fmtp_parameters, &os);
1818 AddLine(os.str(), message);
1819 return;
1820}
1821
1822template <class T>
1823void AddRtcpFbLines(const T& codec, std::string* message) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001824 for (const cricket::FeedbackParam& param : codec.feedback_params.params()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001825 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001826 WriteRtcpFbHeader(codec.id, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001827 os << " " << param.id();
1828 if (!param.param().empty()) {
1829 os << " " << param.param();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001830 }
1831 AddLine(os.str(), message);
1832 }
1833}
1834
1835bool GetMinValue(const std::vector<int>& values, int* value) {
1836 if (values.empty()) {
1837 return false;
1838 }
Steve Anton64b626b2019-01-28 17:25:26 -08001839 auto it = absl::c_min_element(values);
1840 *value = *it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001841 return true;
1842}
1843
1844bool GetParameter(const std::string& name,
Yves Gerey665174f2018-06-19 15:03:05 +02001845 const cricket::CodecParameterMap& params,
1846 int* value) {
1847 std::map<std::string, std::string>::const_iterator found = params.find(name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001848 if (found == params.end()) {
1849 return false;
1850 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00001851 if (!rtc::FromString(found->second, value)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001852 return false;
1853 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001854 return true;
1855}
1856
1857void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001858 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001859 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001860 RTC_DCHECK(message != NULL);
1861 RTC_DCHECK(media_desc != NULL);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001862 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001863 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001864 for (const cricket::VideoCodec& codec : media_desc->as_video()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001865 // RFC 4566
1866 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1867 // [/<encodingparameters>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001868 if (codec.id != kWildcardPayloadType) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001869 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001870 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
deadbeefe814a0d2017-02-25 18:15:09 -08001871 << cricket::kVideoCodecClockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001872 AddLine(os.str(), message);
1873 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001874 AddRtcpFbLines(codec, message);
1875 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001876 }
1877 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001878 std::vector<int> ptimes;
1879 std::vector<int> maxptimes;
1880 int max_minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001881 for (const cricket::AudioCodec& codec : media_desc->as_audio()->codecs()) {
1882 RTC_DCHECK(!codec.name.empty());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001883 // RFC 4566
1884 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1885 // [/<encodingparameters>]
1886 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001887 os << kSdpDelimiterColon << codec.id << " ";
1888 os << codec.name << "/" << codec.clockrate;
1889 if (codec.channels != 1) {
1890 os << "/" << codec.channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001891 }
1892 AddLine(os.str(), message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001893 AddRtcpFbLines(codec, message);
1894 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001895 int minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001896 if (GetParameter(kCodecParamMinPTime, codec.params, &minptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001897 max_minptime = std::max(minptime, max_minptime);
1898 }
1899 int ptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001900 if (GetParameter(kCodecParamPTime, codec.params, &ptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001901 ptimes.push_back(ptime);
1902 }
1903 int maxptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001904 if (GetParameter(kCodecParamMaxPTime, codec.params, &maxptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001905 maxptimes.push_back(maxptime);
1906 }
1907 }
1908 // Populate the maxptime attribute with the smallest maxptime of all codecs
1909 // under the same m-line.
1910 int min_maxptime = INT_MAX;
1911 if (GetMinValue(maxptimes, &min_maxptime)) {
1912 AddAttributeLine(kCodecParamMaxPTime, min_maxptime, message);
1913 }
nisseede5da42017-01-12 05:15:36 -08001914 RTC_DCHECK(min_maxptime > max_minptime);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001915 // Populate the ptime attribute with the smallest ptime or the largest
1916 // minptime, whichever is the largest, for all codecs under the same m-line.
1917 int ptime = INT_MAX;
1918 if (GetMinValue(ptimes, &ptime)) {
1919 ptime = std::min(ptime, min_maxptime);
1920 ptime = std::max(ptime, max_minptime);
1921 AddAttributeLine(kCodecParamPTime, ptime, message);
1922 }
1923 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001924 if (media_desc->as_rtp_data()) {
1925 for (const cricket::RtpDataCodec& codec :
1926 media_desc->as_rtp_data()->codecs()) {
1927 // RFC 4566
1928 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1929 // [/<encodingparameters>]
1930 InitAttrLine(kAttributeRtpmap, &os);
1931 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
1932 << codec.clockrate;
1933 AddLine(os.str(), message);
1934 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001935 }
1936 }
1937}
1938
1939void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -08001940 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001941 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001942 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001943
Steve Anton4daf66e2018-09-07 14:55:53 -07001944 for (const Candidate& candidate : candidates) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001945 // RFC 5245
1946 // a=candidate:<foundation> <component-id> <transport> <priority>
1947 // <connection-address> <port> typ <candidate-types>
1948 // [raddr <connection-address>] [rport <port>]
1949 // *(SP extension-att-name SP extension-att-value)
1950 std::string type;
1951 // Map the cricket candidate type to "host" / "srflx" / "prflx" / "relay"
Steve Anton4daf66e2018-09-07 14:55:53 -07001952 if (candidate.type() == cricket::LOCAL_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001953 type = kCandidateHost;
Steve Anton4daf66e2018-09-07 14:55:53 -07001954 } else if (candidate.type() == cricket::STUN_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001955 type = kCandidateSrflx;
Steve Anton4daf66e2018-09-07 14:55:53 -07001956 } else if (candidate.type() == cricket::RELAY_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001957 type = kCandidateRelay;
Steve Anton4daf66e2018-09-07 14:55:53 -07001958 } else if (candidate.type() == cricket::PRFLX_PORT_TYPE) {
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001959 type = kCandidatePrflx;
1960 // Peer reflexive candidate may be signaled for being removed.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001961 } else {
nissec80e7412017-01-11 05:56:46 -08001962 RTC_NOTREACHED();
Peter Thatcher019087f2015-04-28 09:06:26 -07001963 // Never write out candidates if we don't know the type.
1964 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001965 }
1966
1967 InitAttrLine(kAttributeCandidate, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001968 os << kSdpDelimiterColon << candidate.foundation() << " "
1969 << candidate.component() << " " << candidate.protocol() << " "
1970 << candidate.priority() << " "
1971 << (candidate.address().ipaddr().IsNil()
1972 ? candidate.address().hostname()
1973 : candidate.address().ipaddr().ToString())
1974 << " " << candidate.address().PortAsString() << " "
1975 << kAttributeCandidateTyp << " " << type << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001976
1977 // Related address
Steve Anton4daf66e2018-09-07 14:55:53 -07001978 if (!candidate.related_address().IsNil()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001979 os << kAttributeCandidateRaddr << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001980 << candidate.related_address().ipaddr().ToString() << " "
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001981 << kAttributeCandidateRport << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07001982 << candidate.related_address().PortAsString() << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001983 }
1984
Steve Anton4daf66e2018-09-07 14:55:53 -07001985 if (candidate.protocol() == cricket::TCP_PROTOCOL_NAME) {
1986 os << kTcpCandidateType << " " << candidate.tcptype() << " ";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001987 }
1988
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001989 // Extensions
Steve Anton4daf66e2018-09-07 14:55:53 -07001990 os << kAttributeCandidateGeneration << " " << candidate.generation();
1991 if (include_ufrag && !candidate.username().empty()) {
1992 os << " " << kAttributeCandidateUfrag << " " << candidate.username();
honghaiza54a0802015-12-16 18:37:23 -08001993 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001994 if (candidate.network_id() > 0) {
1995 os << " " << kAttributeCandidateNetworkId << " "
1996 << candidate.network_id();
honghaiza0c44ea2016-03-23 16:07:48 -07001997 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001998 if (candidate.network_cost() > 0) {
1999 os << " " << kAttributeCandidateNetworkCost << " "
2000 << candidate.network_cost();
honghaize1a0c942016-02-16 14:54:56 -08002001 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002002
2003 AddLine(os.str(), message);
2004 }
2005}
2006
2007void BuildIceOptions(const std::vector<std::string>& transport_options,
2008 std::string* message) {
2009 if (!transport_options.empty()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002010 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002011 InitAttrLine(kAttributeIceOption, &os);
2012 os << kSdpDelimiterColon << transport_options[0];
2013 for (size_t i = 1; i < transport_options.size(); ++i) {
2014 os << kSdpDelimiterSpace << transport_options[i];
2015 }
2016 AddLine(os.str(), message);
2017 }
2018}
2019
zhihuang38989e52017-03-21 11:04:53 -07002020bool ParseConnectionData(const std::string& line,
2021 rtc::SocketAddress* addr,
2022 SdpParseError* error) {
2023 // Parse the line from left to right.
2024 std::string token;
2025 std::string rightpart;
2026 // RFC 4566
2027 // c=<nettype> <addrtype> <connection-address>
2028 // Skip the "c="
Jonas Olssonec9e4922018-09-05 09:53:49 +02002029 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, &token, &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07002030 return ParseFailed(line, "Failed to parse the network type.", error);
2031 }
2032
2033 // Extract and verify the <nettype>
Jonas Olssonec9e4922018-09-05 09:53:49 +02002034 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2035 &rightpart) ||
zhihuang38989e52017-03-21 11:04:53 -07002036 token != kConnectionNettype) {
2037 return ParseFailed(line,
2038 "Failed to parse the connection data. The network type "
2039 "is not currently supported.",
2040 error);
2041 }
2042
2043 // Extract the "<addrtype>" and "<connection-address>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02002044 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2045 &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07002046 return ParseFailed(line, "Failed to parse the address type.", error);
2047 }
2048
2049 // The rightpart part should be the IP address without the slash which is used
2050 // for multicast.
2051 if (rightpart.find('/') != std::string::npos) {
2052 return ParseFailed(line,
2053 "Failed to parse the connection data. Multicast is not "
2054 "currently supported.",
2055 error);
2056 }
2057 addr->SetIP(rightpart);
2058
2059 // Verify that the addrtype matches the type of the parsed address.
2060 if ((addr->family() == AF_INET && token != "IP4") ||
2061 (addr->family() == AF_INET6 && token != "IP6")) {
2062 addr->Clear();
2063 return ParseFailed(
2064 line,
2065 "Failed to parse the connection data. The address type is mismatching.",
2066 error);
2067 }
2068 return true;
2069}
2070
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -08002071bool ParseMediaTransportLine(const std::string& line,
2072 std::string* transport_name,
2073 std::string* transport_setting,
2074 SdpParseError* error) {
2075 std::string value;
2076 if (!GetValue(line, kMediaTransportSettingLine, &value, error)) {
2077 return false;
2078 }
2079 std::string media_transport_settings_base64;
2080 if (!rtc::tokenize_first(value, kSdpDelimiterColonChar, transport_name,
2081 &media_transport_settings_base64)) {
2082 return ParseFailedGetValue(line, kMediaTransportSettingLine, error);
2083 }
2084 if (!rtc::Base64::Decode(media_transport_settings_base64,
2085 rtc::Base64::DO_STRICT, transport_setting,
2086 nullptr)) {
2087 return ParseFailedGetValue(line, kMediaTransportSettingLine, error);
2088 }
2089
2090 return true;
2091}
2092
zhihuang38989e52017-03-21 11:04:53 -07002093bool ParseSessionDescription(const std::string& message,
2094 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002095 std::string* session_id,
2096 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002097 TransportDescription* session_td,
2098 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -07002099 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002100 cricket::SessionDescription* desc,
2101 SdpParseError* error) {
2102 std::string line;
2103
deadbeefc80741f2015-10-22 13:14:45 -07002104 desc->set_msid_supported(false);
Johannes Kron9581bc42018-10-23 10:17:39 +02002105 desc->set_extmap_allow_mixed(false);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002106 // RFC 4566
2107 // v= (protocol version)
2108 if (!GetLineWithType(message, pos, &line, kLineTypeVersion)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002109 return ParseFailedExpectLine(message, *pos, kLineTypeVersion, std::string(),
2110 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002111 }
2112 // RFC 4566
2113 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
2114 // <unicast-address>
2115 if (!GetLineWithType(message, pos, &line, kLineTypeOrigin)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002116 return ParseFailedExpectLine(message, *pos, kLineTypeOrigin, std::string(),
2117 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002118 }
2119 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002120 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002121 const size_t expected_fields = 6;
2122 if (fields.size() != expected_fields) {
2123 return ParseFailedExpectFieldNum(line, expected_fields, error);
2124 }
2125 *session_id = fields[1];
2126 *session_version = fields[2];
2127
2128 // RFC 4566
2129 // s= (session name)
2130 if (!GetLineWithType(message, pos, &line, kLineTypeSessionName)) {
2131 return ParseFailedExpectLine(message, *pos, kLineTypeSessionName,
2132 std::string(), error);
2133 }
2134
Danil Chapovalov66cadcc2018-06-19 16:47:43 +02002135 // absl::optional lines
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002136 // Those are the optional lines, so shouldn't return false if not present.
2137 // RFC 4566
2138 // i=* (session information)
2139 GetLineWithType(message, pos, &line, kLineTypeSessionInfo);
2140
2141 // RFC 4566
2142 // u=* (URI of description)
2143 GetLineWithType(message, pos, &line, kLineTypeSessionUri);
2144
2145 // RFC 4566
2146 // e=* (email address)
2147 GetLineWithType(message, pos, &line, kLineTypeSessionEmail);
2148
2149 // RFC 4566
2150 // p=* (phone number)
2151 GetLineWithType(message, pos, &line, kLineTypeSessionPhone);
2152
2153 // RFC 4566
2154 // c=* (connection information -- not required if included in
2155 // all media)
zhihuang38989e52017-03-21 11:04:53 -07002156 if (GetLineWithType(message, pos, &line, kLineTypeConnection)) {
2157 if (!ParseConnectionData(line, connection_addr, error)) {
2158 return false;
2159 }
2160 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002161
2162 // RFC 4566
2163 // b=* (zero or more bandwidth information lines)
2164 while (GetLineWithType(message, pos, &line, kLineTypeSessionBandwidth)) {
2165 // By pass zero or more b lines.
2166 }
2167
2168 // RFC 4566
2169 // One or more time descriptions ("t=" and "r=" lines; see below)
2170 // t= (time the session is active)
2171 // r=* (zero or more repeat times)
2172 // Ensure there's at least one time description
2173 if (!GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2174 return ParseFailedExpectLine(message, *pos, kLineTypeTiming, std::string(),
2175 error);
2176 }
2177
2178 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2179 // By pass zero or more r lines.
2180 }
2181
2182 // Go through the rest of the time descriptions
2183 while (GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2184 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2185 // By pass zero or more r lines.
2186 }
2187 }
2188
2189 // RFC 4566
2190 // z=* (time zone adjustments)
2191 GetLineWithType(message, pos, &line, kLineTypeTimeZone);
2192
2193 // RFC 4566
2194 // k=* (encryption key)
2195 GetLineWithType(message, pos, &line, kLineTypeEncryptionKey);
2196
2197 // RFC 4566
2198 // a=* (zero or more session attribute lines)
2199 while (GetLineWithType(message, pos, &line, kLineTypeAttributes)) {
2200 if (HasAttribute(line, kAttributeGroup)) {
2201 if (!ParseGroupAttribute(line, desc, error)) {
2202 return false;
2203 }
2204 } else if (HasAttribute(line, kAttributeIceUfrag)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002205 if (!GetValue(line, kAttributeIceUfrag, &(session_td->ice_ufrag),
2206 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002207 return false;
2208 }
2209 } else if (HasAttribute(line, kAttributeIcePwd)) {
2210 if (!GetValue(line, kAttributeIcePwd, &(session_td->ice_pwd), error)) {
2211 return false;
2212 }
2213 } else if (HasAttribute(line, kAttributeIceLite)) {
2214 session_td->ice_mode = cricket::ICEMODE_LITE;
2215 } else if (HasAttribute(line, kAttributeIceOption)) {
2216 if (!ParseIceOptions(line, &(session_td->transport_options), error)) {
2217 return false;
2218 }
2219 } else if (HasAttribute(line, kAttributeFingerprint)) {
2220 if (session_td->identity_fingerprint.get()) {
2221 return ParseFailed(
2222 line,
2223 "Can't have multiple fingerprint attributes at the same level.",
2224 error);
2225 }
Steve Anton4905edb2018-10-15 19:27:44 -07002226 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002227 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2228 return false;
2229 }
Steve Anton4905edb2018-10-15 19:27:44 -07002230 session_td->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002231 } else if (HasAttribute(line, kAttributeSetup)) {
2232 if (!ParseDtlsSetup(line, &(session_td->connection_role), error)) {
2233 return false;
2234 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002235 } else if (HasAttribute(line, kAttributeMsidSemantics)) {
2236 std::string semantics;
2237 if (!GetValue(line, kAttributeMsidSemantics, &semantics, error)) {
2238 return false;
2239 }
deadbeefc80741f2015-10-22 13:14:45 -07002240 desc->set_msid_supported(
2241 CaseInsensitiveFind(semantics, kMediaStreamSemantic));
Johannes Kron0854eb62018-10-10 22:33:20 +02002242 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02002243 desc->set_extmap_allow_mixed(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002244 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002245 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002246 if (!ParseExtmap(line, &extmap, error)) {
2247 return false;
2248 }
2249 session_extmaps->push_back(extmap);
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -08002250 } else if (HasAttribute(line, kMediaTransportSettingLine)) {
2251 std::string transport_name;
2252 std::string transport_setting;
2253 if (!ParseMediaTransportLine(line, &transport_name, &transport_setting,
2254 error)) {
2255 return false;
2256 }
2257
2258 for (const auto& setting : desc->MediaTransportSettings()) {
2259 if (setting.transport_name == transport_name) {
2260 // Ignore repeated transport names rather than failing to parse so
2261 // that in the future the same transport could have multiple configs.
2262 RTC_LOG(INFO) << "x-mt line with repeated transport, transport_name="
2263 << transport_name;
2264 return true;
2265 }
2266 }
2267 desc->AddMediaTransportSetting(transport_name, transport_setting);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002268 }
2269 }
2270
2271 return true;
2272}
2273
2274bool ParseGroupAttribute(const std::string& line,
2275 cricket::SessionDescription* desc,
2276 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002277 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002278
2279 // RFC 5888 and draft-holmberg-mmusic-sdp-bundle-negotiation-00
2280 // a=group:BUNDLE video voice
2281 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002282 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002283 std::string semantics;
2284 if (!GetValue(fields[0], kAttributeGroup, &semantics, error)) {
2285 return false;
2286 }
2287 cricket::ContentGroup group(semantics);
2288 for (size_t i = 1; i < fields.size(); ++i) {
2289 group.AddContentName(fields[i]);
2290 }
2291 desc->AddGroup(group);
2292 return true;
2293}
2294
Steve Anton4905edb2018-10-15 19:27:44 -07002295static bool ParseFingerprintAttribute(
2296 const std::string& line,
2297 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
2298 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002299 if (!IsLineType(line, kLineTypeAttributes) ||
2300 !HasAttribute(line, kAttributeFingerprint)) {
2301 return ParseFailedExpectLine(line, 0, kLineTypeAttributes,
2302 kAttributeFingerprint, error);
2303 }
2304
2305 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002306 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002307 const size_t expected_fields = 2;
2308 if (fields.size() != expected_fields) {
2309 return ParseFailedExpectFieldNum(line, expected_fields, error);
2310 }
2311
2312 // The first field here is "fingerprint:<hash>.
2313 std::string algorithm;
2314 if (!GetValue(fields[0], kAttributeFingerprint, &algorithm, error)) {
2315 return false;
2316 }
2317
2318 // Downcase the algorithm. Note that we don't need to downcase the
2319 // fingerprint because hex_decode can handle upper-case.
Steve Anton64b626b2019-01-28 17:25:26 -08002320 absl::c_transform(algorithm, algorithm.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002321
2322 // The second field is the digest value. De-hexify it.
Steve Anton4905edb2018-10-15 19:27:44 -07002323 *fingerprint =
2324 rtc::SSLFingerprint::CreateUniqueFromRfc4572(algorithm, fields[1]);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002325 if (!*fingerprint) {
Yves Gerey665174f2018-06-19 15:03:05 +02002326 return ParseFailed(line, "Failed to create fingerprint from the digest.",
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002327 error);
2328 }
2329
2330 return true;
2331}
2332
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002333static bool ParseDtlsSetup(const std::string& line,
2334 cricket::ConnectionRole* role,
2335 SdpParseError* error) {
2336 // setup-attr = "a=setup:" role
2337 // role = "active" / "passive" / "actpass" / "holdconn"
2338 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002339 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002340 const size_t expected_fields = 2;
2341 if (fields.size() != expected_fields) {
2342 return ParseFailedExpectFieldNum(line, expected_fields, error);
2343 }
2344 std::string role_str = fields[1];
2345 if (!cricket::StringToConnectionRole(role_str, role)) {
2346 return ParseFailed(line, "Invalid attribute value.", error);
2347 }
2348 return true;
2349}
2350
deadbeef9d3584c2016-02-16 17:54:10 -08002351static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -07002352 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -08002353 std::string* track_id,
2354 SdpParseError* error) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002355 // https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
deadbeef9d3584c2016-02-16 17:54:10 -08002356 // a=msid:<stream id> <track id>
2357 // msid-value = msid-id [ SP msid-appdata ]
2358 // msid-id = 1*64token-char ; see RFC 4566
2359 // msid-appdata = 1*64token-char ; see RFC 4566
2360 std::string field1;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002361 std::string new_stream_id;
2362 std::string new_track_id;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002363 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
2364 kSdpDelimiterSpaceChar, &field1, &new_track_id)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002365 const size_t expected_fields = 2;
2366 return ParseFailedExpectFieldNum(line, expected_fields, error);
2367 }
2368
Seth Hampson5b4f0752018-04-02 16:31:36 -07002369 if (new_track_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002370 return ParseFailed(line, "Missing track ID in msid attribute.", error);
2371 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002372 // All track ids should be the same within an m section in a Unified Plan SDP.
2373 if (!track_id->empty() && new_track_id.compare(*track_id) != 0) {
2374 return ParseFailed(
2375 line, "Two different track IDs in msid attribute in one m= section",
2376 error);
2377 }
2378 *track_id = new_track_id;
deadbeefa4549d62017-02-10 17:26:22 -08002379
deadbeef9d3584c2016-02-16 17:54:10 -08002380 // msid:<msid-id>
Seth Hampson5b4f0752018-04-02 16:31:36 -07002381 if (!GetValue(field1, kAttributeMsid, &new_stream_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002382 return false;
2383 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002384 if (new_stream_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002385 return ParseFailed(line, "Missing stream ID in msid attribute.", error);
2386 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002387 // The special value "-" indicates "no MediaStream".
2388 if (new_stream_id.compare(kNoStreamMsid) != 0) {
2389 stream_ids->push_back(new_stream_id);
2390 }
deadbeef9d3584c2016-02-16 17:54:10 -08002391 return true;
2392}
2393
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002394static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
2395 std::vector<RidDescription>* rids) {
2396 RTC_DCHECK(rids);
2397 std::set<std::string> to_remove;
2398 std::set<std::string> unique_rids;
2399
2400 // Check the rids to see which ones should be removed.
2401 for (RidDescription& rid : *rids) {
2402 // In the case of a duplicate, the entire "a=rid" line, and all "a=rid"
2403 // lines with rid-ids that duplicate this line, are discarded and MUST NOT
2404 // be included in the SDP Answer.
2405 auto pair = unique_rids.insert(rid.rid);
2406 // Insert will "fail" if element already exists.
2407 if (!pair.second) {
2408 to_remove.insert(rid.rid);
2409 continue;
2410 }
2411
2412 // If the "a=rid" line contains a "pt=", the list of payload types
2413 // is verified against the list of valid payload types for the media
2414 // section (that is, those listed on the "m=" line). Any PT missing
2415 // from the "m=" line is discarded from the set of values in the
2416 // "pt=". If no values are left in the "pt=" parameter after this
2417 // processing, then the "a=rid" line is discarded.
2418 if (rid.payload_types.empty()) {
2419 // If formats were not specified, rid should not be removed.
2420 continue;
2421 }
2422
2423 // Note: Spec does not mention how to handle duplicate formats.
2424 // Media section does not handle duplicates either.
2425 std::set<int> removed_formats;
2426 for (int payload_type : rid.payload_types) {
Steve Anton64b626b2019-01-28 17:25:26 -08002427 if (!absl::c_linear_search(payload_types, payload_type)) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002428 removed_formats.insert(payload_type);
2429 }
2430 }
2431
2432 rid.payload_types.erase(
2433 std::remove_if(rid.payload_types.begin(), rid.payload_types.end(),
2434 [&removed_formats](int format) {
2435 return removed_formats.count(format) > 0;
2436 }),
2437 rid.payload_types.end());
2438
2439 // If all formats were removed then remove the rid alogether.
2440 if (rid.payload_types.empty()) {
2441 to_remove.insert(rid.rid);
2442 }
2443 }
2444
2445 // Remove every rid description that appears in the to_remove list.
2446 if (!to_remove.empty()) {
2447 rids->erase(std::remove_if(rids->begin(), rids->end(),
2448 [&to_remove](const RidDescription& rid) {
2449 return to_remove.count(rid.rid) > 0;
2450 }),
2451 rids->end());
2452 }
2453}
2454
2455// Create a new list (because SimulcastLayerList is immutable) without any
2456// layers that have a rid in the to_remove list.
2457// If a group of alternatives is empty after removing layers, the group should
2458// be removed altogether.
2459static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
2460 const std::set<std::string>& to_remove,
2461 const SimulcastLayerList& layers) {
2462 SimulcastLayerList result;
2463 for (const std::vector<SimulcastLayer>& vector : layers) {
2464 std::vector<SimulcastLayer> new_layers;
2465 for (const SimulcastLayer& layer : vector) {
2466 if (to_remove.find(layer.rid) == to_remove.end()) {
2467 new_layers.push_back(layer);
2468 }
2469 }
2470 // If all layers were removed, do not add an entry.
2471 if (!new_layers.empty()) {
2472 result.AddLayerWithAlternatives(new_layers);
2473 }
2474 }
2475
2476 return result;
2477}
2478
2479// Will remove Simulcast Layers if:
2480// 1. They appear in both send and receive directions.
2481// 2. They do not appear in the list of |valid_rids|.
2482static void RemoveInvalidRidsFromSimulcast(
2483 const std::vector<RidDescription>& valid_rids,
2484 SimulcastDescription* simulcast) {
2485 RTC_DCHECK(simulcast);
2486 std::set<std::string> to_remove;
2487 std::vector<SimulcastLayer> all_send_layers =
2488 simulcast->send_layers().GetAllLayers();
2489 std::vector<SimulcastLayer> all_receive_layers =
2490 simulcast->receive_layers().GetAllLayers();
2491
2492 // If a rid appears in both send and receive directions, remove it from both.
2493 // This algorithm runs in O(n^2) time, but for small n (as is the case with
2494 // simulcast layers) it should still perform well.
2495 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002496 if (absl::c_any_of(all_receive_layers,
2497 [&send_layer](const SimulcastLayer& layer) {
2498 return layer.rid == send_layer.rid;
2499 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002500 to_remove.insert(send_layer.rid);
2501 }
2502 }
2503
2504 // Add any rid that is not in the valid list to the remove set.
2505 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002506 if (absl::c_none_of(valid_rids, [&send_layer](const RidDescription& rid) {
2507 return send_layer.rid == rid.rid;
2508 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002509 to_remove.insert(send_layer.rid);
2510 }
2511 }
2512
2513 // Add any rid that is not in the valid list to the remove set.
2514 for (const SimulcastLayer& receive_layer : all_receive_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002515 if (absl::c_none_of(valid_rids,
2516 [&receive_layer](const RidDescription& rid) {
2517 return receive_layer.rid == rid.rid;
2518 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002519 to_remove.insert(receive_layer.rid);
2520 }
2521 }
2522
2523 simulcast->send_layers() =
2524 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->send_layers());
2525 simulcast->receive_layers() =
2526 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->receive_layers());
2527}
2528
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002529// RFC 3551
2530// PT encoding media type clock rate channels
2531// name (Hz)
2532// 0 PCMU A 8,000 1
2533// 1 reserved A
2534// 2 reserved A
2535// 3 GSM A 8,000 1
2536// 4 G723 A 8,000 1
2537// 5 DVI4 A 8,000 1
2538// 6 DVI4 A 16,000 1
2539// 7 LPC A 8,000 1
2540// 8 PCMA A 8,000 1
2541// 9 G722 A 8,000 1
2542// 10 L16 A 44,100 2
2543// 11 L16 A 44,100 1
2544// 12 QCELP A 8,000 1
2545// 13 CN A 8,000 1
2546// 14 MPA A 90,000 (see text)
2547// 15 G728 A 8,000 1
2548// 16 DVI4 A 11,025 1
2549// 17 DVI4 A 22,050 1
2550// 18 G729 A 8,000 1
2551struct StaticPayloadAudioCodec {
2552 const char* name;
2553 int clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002554 size_t channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002555};
2556static const StaticPayloadAudioCodec kStaticPayloadAudioCodecs[] = {
Yves Gerey665174f2018-06-19 15:03:05 +02002557 {"PCMU", 8000, 1}, {"reserved", 0, 0}, {"reserved", 0, 0},
2558 {"GSM", 8000, 1}, {"G723", 8000, 1}, {"DVI4", 8000, 1},
2559 {"DVI4", 16000, 1}, {"LPC", 8000, 1}, {"PCMA", 8000, 1},
2560 {"G722", 8000, 1}, {"L16", 44100, 2}, {"L16", 44100, 1},
2561 {"QCELP", 8000, 1}, {"CN", 8000, 1}, {"MPA", 90000, 1},
2562 {"G728", 8000, 1}, {"DVI4", 11025, 1}, {"DVI4", 22050, 1},
2563 {"G729", 8000, 1},
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002564};
2565
Yves Gerey665174f2018-06-19 15:03:05 +02002566void MaybeCreateStaticPayloadAudioCodecs(const std::vector<int>& fmts,
2567 AudioContentDescription* media_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002568 if (!media_desc) {
2569 return;
2570 }
deadbeef67cf2c12016-04-13 10:07:16 -07002571 RTC_DCHECK(media_desc->codecs().empty());
solenberg9fa49752016-10-08 13:02:44 -07002572 for (int payload_type : fmts) {
Yves Gerey665174f2018-06-19 15:03:05 +02002573 if (!media_desc->HasCodec(payload_type) && payload_type >= 0 &&
kjellander3e33bfe2016-06-20 07:04:09 -07002574 static_cast<uint32_t>(payload_type) <
2575 arraysize(kStaticPayloadAudioCodecs)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002576 std::string encoding_name = kStaticPayloadAudioCodecs[payload_type].name;
2577 int clock_rate = kStaticPayloadAudioCodecs[payload_type].clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002578 size_t channels = kStaticPayloadAudioCodecs[payload_type].channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002579 media_desc->AddCodec(cricket::AudioCodec(payload_type, encoding_name,
deadbeef67cf2c12016-04-13 10:07:16 -07002580 clock_rate, 0, channels));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002581 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002582 }
2583}
2584
2585template <class C>
Steve Anton5a1de872018-12-18 11:25:55 -08002586static std::unique_ptr<C> ParseContentDescription(
2587 const std::string& message,
2588 const cricket::MediaType media_type,
2589 int mline_index,
2590 const std::string& protocol,
2591 const std::vector<int>& payload_types,
2592 size_t* pos,
2593 std::string* content_name,
2594 bool* bundle_only,
2595 int* msid_signaling,
2596 TransportDescription* transport,
2597 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2598 webrtc::SdpParseError* error) {
2599 auto media_desc = absl::make_unique<C>();
deadbeef67cf2c12016-04-13 10:07:16 -07002600 if (!ParseContent(message, media_type, mline_index, protocol, payload_types,
Steve Anton5a1de872018-12-18 11:25:55 -08002601 pos, content_name, bundle_only, msid_signaling,
2602 media_desc.get(), transport, candidates, error)) {
zhihuang38989e52017-03-21 11:04:53 -07002603 return nullptr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002604 }
2605 // Sort the codecs according to the m-line fmt list.
deadbeef67cf2c12016-04-13 10:07:16 -07002606 std::unordered_map<int, int> payload_type_preferences;
2607 // "size + 1" so that the lowest preference payload type has a preference of
2608 // 1, which is greater than the default (0) for payload types not in the fmt
2609 // list.
2610 int preference = static_cast<int>(payload_types.size() + 1);
2611 for (int pt : payload_types) {
2612 payload_type_preferences[pt] = preference--;
2613 }
2614 std::vector<typename C::CodecType> codecs = media_desc->codecs();
Steve Anton64b626b2019-01-28 17:25:26 -08002615 absl::c_sort(
2616 codecs, [&payload_type_preferences](const typename C::CodecType& a,
2617 const typename C::CodecType& b) {
2618 return payload_type_preferences[a.id] > payload_type_preferences[b.id];
2619 });
deadbeef67cf2c12016-04-13 10:07:16 -07002620 media_desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002621 return media_desc;
2622}
2623
Steve Anton5a1de872018-12-18 11:25:55 -08002624bool ParseMediaDescription(
2625 const std::string& message,
2626 const TransportDescription& session_td,
2627 const RtpHeaderExtensions& session_extmaps,
2628 size_t* pos,
2629 const rtc::SocketAddress& session_connection_addr,
2630 cricket::SessionDescription* desc,
2631 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2632 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002633 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002634 std::string line;
2635 int mline_index = -1;
Steve Antone831b8c2018-02-01 12:22:16 -08002636 int msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002637
2638 // Zero or more media descriptions
2639 // RFC 4566
2640 // m=<media> <port> <proto> <fmt>
2641 while (GetLineWithType(message, pos, &line, kLineTypeMedia)) {
2642 ++mline_index;
2643
2644 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002645 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
zstein4b2e0822017-02-17 19:48:38 -08002646
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002647 const size_t expected_min_fields = 4;
2648 if (fields.size() < expected_min_fields) {
2649 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
2650 }
deadbeef25ed4352016-12-12 18:37:36 -08002651 bool port_rejected = false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002652 // RFC 3264
2653 // To reject an offered stream, the port number in the corresponding stream
2654 // in the answer MUST be set to zero.
2655 if (fields[1] == kMediaPortRejected) {
deadbeef25ed4352016-12-12 18:37:36 -08002656 port_rejected = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002657 }
2658
zhihuang38989e52017-03-21 11:04:53 -07002659 int port = 0;
2660 if (!rtc::FromString<int>(fields[1], &port) || !IsValidPort(port)) {
2661 return ParseFailed(line, "The port number is invalid", error);
2662 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002663 std::string protocol = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002664
2665 // <fmt>
deadbeef67cf2c12016-04-13 10:07:16 -07002666 std::vector<int> payload_types;
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002667 if (cricket::IsRtpProtocol(protocol)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002668 for (size_t j = 3; j < fields.size(); ++j) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002669 // TODO(wu): Remove when below bug is fixed.
2670 // https://bugzilla.mozilla.org/show_bug.cgi?id=996329
pbosbb36fdf2015-07-09 07:48:14 -07002671 if (fields[j].empty() && j == fields.size() - 1) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002672 continue;
2673 }
wu@webrtc.org36eda7c2014-04-15 20:37:30 +00002674
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002675 int pl = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00002676 if (!GetPayloadTypeFromString(line, fields[j], &pl, error)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002677 return false;
2678 }
deadbeef67cf2c12016-04-13 10:07:16 -07002679 payload_types.push_back(pl);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002680 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002681 }
2682
2683 // Make a temporary TransportDescription based on |session_td|.
2684 // Some of this gets overwritten by ParseContent.
deadbeef46eed762016-01-28 13:24:37 -08002685 TransportDescription transport(
2686 session_td.transport_options, session_td.ice_ufrag, session_td.ice_pwd,
2687 session_td.ice_mode, session_td.connection_role,
2688 session_td.identity_fingerprint.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002689
kwibergd1fe2812016-04-27 06:47:29 -07002690 std::unique_ptr<MediaContentDescription> content;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002691 std::string content_name;
deadbeef25ed4352016-12-12 18:37:36 -08002692 bool bundle_only = false;
Steve Antone831b8c2018-02-01 12:22:16 -08002693 int section_msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002694 if (HasAttribute(line, kMediaTypeVideo)) {
Steve Anton5a1de872018-12-18 11:25:55 -08002695 content = ParseContentDescription<VideoContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002696 message, cricket::MEDIA_TYPE_VIDEO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002697 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 11:25:55 -08002698 &section_msid_signaling, &transport, candidates, error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002699 } else if (HasAttribute(line, kMediaTypeAudio)) {
Steve Anton5a1de872018-12-18 11:25:55 -08002700 content = ParseContentDescription<AudioContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002701 message, cricket::MEDIA_TYPE_AUDIO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002702 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 11:25:55 -08002703 &section_msid_signaling, &transport, candidates, error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002704 } else if (HasAttribute(line, kMediaTypeData)) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002705 if (cricket::IsDtlsSctp(protocol)) {
2706 // The draft-03 format is:
2707 // m=application <port> DTLS/SCTP <sctp-port>...
2708 // use_sctpmap should be false.
2709 // The draft-26 format is:
2710 // m=application <port> UDP/DTLS/SCTP webrtc-datachannel
2711 // use_sctpmap should be false.
2712 auto data_desc = absl::make_unique<SctpDataContentDescription>();
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +02002713 // Default max message size is 64K
2714 // according to draft-ietf-mmusic-sctp-sdp-26
2715 data_desc->set_max_message_size(kDefaultSctpMaxMessageSize);
zstein4b2e0822017-02-17 19:48:38 -08002716 int p;
2717 if (rtc::FromString(fields[3], &p)) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002718 data_desc->set_port(p);
zstein4b2e0822017-02-17 19:48:38 -08002719 } else if (fields[3] == kDefaultSctpmapProtocol) {
2720 data_desc->set_use_sctpmap(false);
2721 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002722 if (!ParseContent(message, cricket::MEDIA_TYPE_DATA, mline_index,
2723 protocol, payload_types, pos, &content_name,
2724 &bundle_only, &section_msid_signaling,
2725 data_desc.get(), &transport, candidates, error)) {
2726 return false;
2727 }
2728 data_desc->set_protocol(protocol);
2729 content = std::move(data_desc);
2730 } else {
2731 // RTP
2732 std::unique_ptr<RtpDataContentDescription> data_desc =
2733 ParseContentDescription<RtpDataContentDescription>(
2734 message, cricket::MEDIA_TYPE_DATA, mline_index, protocol,
2735 payload_types, pos, &content_name, &bundle_only,
2736 &section_msid_signaling, &transport, candidates, error);
2737 content = std::move(data_desc);
wu@webrtc.org78187522013-10-07 23:32:02 +00002738 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002739 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002740 RTC_LOG(LS_WARNING) << "Unsupported media type: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002741 continue;
2742 }
2743 if (!content.get()) {
2744 // ParseContentDescription returns NULL if failed.
2745 return false;
2746 }
2747
Steve Antone831b8c2018-02-01 12:22:16 -08002748 msid_signaling |= section_msid_signaling;
2749
deadbeef25ed4352016-12-12 18:37:36 -08002750 bool content_rejected = false;
deadbeef12771a12017-01-03 13:53:47 -08002751 // A port of 0 is not interpreted as a rejected m= section when it's
2752 // used along with a=bundle-only.
deadbeef25ed4352016-12-12 18:37:36 -08002753 if (bundle_only) {
deadbeef25ed4352016-12-12 18:37:36 -08002754 if (!port_rejected) {
deadbeef12771a12017-01-03 13:53:47 -08002755 // Usage of bundle-only with a nonzero port is unspecified. So just
2756 // ignore bundle-only if we see this.
2757 bundle_only = false;
Mirko Bonadei675513b2017-11-09 11:09:25 +01002758 RTC_LOG(LS_WARNING)
deadbeef12771a12017-01-03 13:53:47 -08002759 << "a=bundle-only attribute observed with a nonzero "
Jonas Olsson45cc8902018-02-13 10:37:07 +01002760 "port; this usage is unspecified so the attribute is being "
2761 "ignored.";
deadbeef25ed4352016-12-12 18:37:36 -08002762 }
2763 } else {
2764 // If not using bundle-only, interpret port 0 in the normal way; the m=
2765 // section is being rejected.
2766 content_rejected = port_rejected;
2767 }
2768
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002769 if (cricket::IsRtpProtocol(protocol) && !content->as_sctp()) {
2770 content->set_protocol(protocol);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002771 // Set the extmap.
2772 if (!session_extmaps.empty() &&
2773 !content->rtp_header_extensions().empty()) {
2774 return ParseFailed("",
2775 "The a=extmap MUST be either all session level or "
2776 "all media level.",
2777 error);
2778 }
2779 for (size_t i = 0; i < session_extmaps.size(); ++i) {
2780 content->AddRtpHeaderExtension(session_extmaps[i]);
2781 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002782 } else if (content->as_sctp()) {
2783 // Do nothing, it's OK
2784 } else {
2785 RTC_LOG(LS_WARNING) << "Parse failed with unknown protocol " << protocol;
2786 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002787 }
zhihuang38989e52017-03-21 11:04:53 -07002788
2789 // Use the session level connection address if the media level addresses are
2790 // not specified.
2791 rtc::SocketAddress address;
2792 address = content->connection_address().IsNil()
2793 ? session_connection_addr
2794 : content->connection_address();
2795 address.SetPort(port);
2796 content->set_connection_address(address);
2797
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002798 desc->AddContent(content_name,
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002799 cricket::IsDtlsSctp(protocol) ? MediaProtocolType::kSctp
2800 : MediaProtocolType::kRtp,
Harald Alvestrand1716d392019-06-03 20:35:45 +02002801 content_rejected, bundle_only, std::move(content));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002802 // Create TransportInfo with the media level "ice-pwd" and "ice-ufrag".
Steve Anton06817cd2018-12-18 15:55:30 -08002803 desc->AddTransportInfo(TransportInfo(content_name, transport));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002804 }
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002805
Steve Antone831b8c2018-02-01 12:22:16 -08002806 desc->set_msid_signaling(msid_signaling);
2807
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002808 size_t end_of_message = message.size();
2809 if (mline_index == -1 && *pos != end_of_message) {
2810 ParseFailed(message, *pos, "Expects m line.", error);
2811 return false;
2812 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002813 return true;
2814}
2815
2816bool VerifyCodec(const cricket::Codec& codec) {
2817 // Codec has not been populated correctly unless the name has been set. This
2818 // can happen if an SDP has an fmtp or rtcp-fb with a payload type but doesn't
2819 // have a corresponding "rtpmap" line.
htab39db842016-12-08 01:50:48 -08002820 return !codec.name.empty();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002821}
2822
2823bool VerifyAudioCodecs(const AudioContentDescription* audio_desc) {
Steve Anton64b626b2019-01-28 17:25:26 -08002824 return absl::c_all_of(audio_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002825}
2826
2827bool VerifyVideoCodecs(const VideoContentDescription* video_desc) {
Steve Anton64b626b2019-01-28 17:25:26 -08002828 return absl::c_all_of(video_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002829}
2830
2831void AddParameters(const cricket::CodecParameterMap& parameters,
2832 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002833 for (const auto& entry : parameters) {
2834 const std::string& key = entry.first;
2835 const std::string& value = entry.second;
2836 codec->SetParam(key, value);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002837 }
2838}
2839
2840void AddFeedbackParameter(const cricket::FeedbackParam& feedback_param,
2841 cricket::Codec* codec) {
2842 codec->AddFeedbackParam(feedback_param);
2843}
2844
2845void AddFeedbackParameters(const cricket::FeedbackParams& feedback_params,
2846 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002847 for (const cricket::FeedbackParam& param : feedback_params.params()) {
2848 codec->AddFeedbackParam(param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002849 }
2850}
2851
2852// Gets the current codec setting associated with |payload_type|. If there
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002853// is no Codec associated with that payload type it returns an empty codec
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002854// with that payload type.
2855template <class T>
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002856T GetCodecWithPayloadType(const std::vector<T>& codecs, int payload_type) {
magjedb05fa242016-11-11 04:00:16 -08002857 const T* codec = FindCodecById(codecs, payload_type);
2858 if (codec)
2859 return *codec;
2860 // Return empty codec with |payload_type|.
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002861 T ret_val;
magjedb05fa242016-11-11 04:00:16 -08002862 ret_val.id = payload_type;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002863 return ret_val;
2864}
2865
2866// Updates or creates a new codec entry in the audio description.
2867template <class T, class U>
2868void AddOrReplaceCodec(MediaContentDescription* content_desc, const U& codec) {
2869 T* desc = static_cast<T*>(content_desc);
2870 std::vector<U> codecs = desc->codecs();
2871 bool found = false;
Steve Anton4daf66e2018-09-07 14:55:53 -07002872 for (U& existing_codec : codecs) {
2873 if (codec.id == existing_codec.id) {
2874 // Overwrite existing codec with the new codec.
2875 existing_codec = codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002876 found = true;
2877 break;
2878 }
2879 }
2880 if (!found) {
2881 desc->AddCodec(codec);
2882 return;
2883 }
2884 desc->set_codecs(codecs);
2885}
2886
2887// Adds or updates existing codec corresponding to |payload_type| according
2888// to |parameters|.
2889template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002890void UpdateCodec(MediaContentDescription* content_desc,
2891 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002892 const cricket::CodecParameterMap& parameters) {
2893 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002894 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2895 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002896 AddParameters(parameters, &new_codec);
2897 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2898}
2899
2900// Adds or updates existing codec corresponding to |payload_type| according
2901// to |feedback_param|.
2902template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002903void UpdateCodec(MediaContentDescription* content_desc,
2904 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002905 const cricket::FeedbackParam& feedback_param) {
2906 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002907 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2908 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002909 AddFeedbackParameter(feedback_param, &new_codec);
2910 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2911}
2912
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002913template <class T>
2914bool PopWildcardCodec(std::vector<T>* codecs, T* wildcard_codec) {
2915 for (auto iter = codecs->begin(); iter != codecs->end(); ++iter) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002916 if (iter->id == kWildcardPayloadType) {
2917 *wildcard_codec = *iter;
2918 codecs->erase(iter);
2919 return true;
2920 }
2921 }
2922 return false;
2923}
2924
Yves Gerey665174f2018-06-19 15:03:05 +02002925template <class T>
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002926void UpdateFromWildcardCodecs(cricket::MediaContentDescriptionImpl<T>* desc) {
2927 auto codecs = desc->codecs();
2928 T wildcard_codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002929 if (!PopWildcardCodec(&codecs, &wildcard_codec)) {
2930 return;
2931 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002932 for (auto& codec : codecs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002933 AddFeedbackParameters(wildcard_codec.feedback_params, &codec);
2934 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002935 desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002936}
2937
Yves Gerey665174f2018-06-19 15:03:05 +02002938void AddAudioAttribute(const std::string& name,
2939 const std::string& value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002940 AudioContentDescription* audio_desc) {
2941 if (value.empty()) {
2942 return;
2943 }
2944 std::vector<cricket::AudioCodec> codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002945 for (cricket::AudioCodec& codec : codecs) {
2946 codec.params[name] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002947 }
2948 audio_desc->set_codecs(codecs);
2949}
2950
2951bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002952 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002953 int mline_index,
2954 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002955 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002956 size_t* pos,
2957 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08002958 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08002959 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002960 MediaContentDescription* media_desc,
2961 TransportDescription* transport,
Steve Anton5a1de872018-12-18 11:25:55 -08002962 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002963 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002964 RTC_DCHECK(media_desc != NULL);
2965 RTC_DCHECK(content_name != NULL);
2966 RTC_DCHECK(transport != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002967
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002968 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08002969 MaybeCreateStaticPayloadAudioCodecs(payload_types, media_desc->as_audio());
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00002970 }
2971
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002972 // The media level "ice-ufrag" and "ice-pwd".
2973 // The candidates before update the media level "ice-pwd" and "ice-ufrag".
2974 Candidates candidates_orig;
2975 std::string line;
2976 std::string mline_id;
2977 // Tracks created out of the ssrc attributes.
2978 StreamParamsVec tracks;
2979 SsrcInfoVec ssrc_infos;
2980 SsrcGroupVec ssrc_groups;
2981 std::string maxptime_as_string;
2982 std::string ptime_as_string;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002983 std::vector<std::string> stream_ids;
deadbeef9d3584c2016-02-16 17:54:10 -08002984 std::string track_id;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002985 SdpSerializer deserializer;
2986 std::vector<RidDescription> rids;
Amit Hilbucha2012042018-12-03 11:35:05 -08002987 SimulcastDescription simulcast;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002988
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002989 // Loop until the next m line
2990 while (!IsLineType(message, kLineTypeMedia, *pos)) {
2991 if (!GetLine(message, pos, &line)) {
2992 if (*pos >= message.size()) {
2993 break; // Done parsing
2994 } else {
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +00002995 return ParseFailed(message, *pos, "Invalid SDP line.", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002996 }
2997 }
2998
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002999 // RFC 4566
3000 // b=* (zero or more bandwidth information lines)
3001 if (IsLineType(line, kLineTypeSessionBandwidth)) {
3002 std::string bandwidth;
3003 if (HasAttribute(line, kApplicationSpecificMaximum)) {
3004 if (!GetValue(line, kApplicationSpecificMaximum, &bandwidth, error)) {
3005 return false;
3006 } else {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003007 int b = 0;
3008 if (!GetValueFromString(line, bandwidth, &b, error)) {
3009 return false;
3010 }
deadbeef3e8016e2017-08-03 17:49:30 -07003011 // TODO(deadbeef): Historically, applications may be setting a value
3012 // of -1 to mean "unset any previously set bandwidth limit", even
3013 // though ommitting the "b=AS" entirely will do just that. Once we've
3014 // transitioned applications to doing the right thing, it would be
3015 // better to treat this as a hard error instead of just ignoring it.
3016 if (b == -1) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003017 RTC_LOG(LS_WARNING)
3018 << "Ignoring \"b=AS:-1\"; will be treated as \"no "
3019 "bandwidth limit\".";
deadbeef3e8016e2017-08-03 17:49:30 -07003020 continue;
3021 }
deadbeefbc88c6b2017-08-02 11:26:34 -07003022 if (b < 0) {
3023 return ParseFailed(line, "b=AS value can't be negative.", error);
3024 }
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003025 // We should never use more than the default bandwidth for RTP-based
3026 // data channels. Don't allow SDP to set the bandwidth, because
3027 // that would give JS the opportunity to "break the Internet".
3028 // See: https://code.google.com/p/chromium/issues/detail?id=280726
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003029 if (media_type == cricket::MEDIA_TYPE_DATA &&
3030 cricket::IsRtpProtocol(protocol) &&
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003031 b > cricket::kDataMaxBandwidth / 1000) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003032 rtc::StringBuilder description;
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003033 description << "RTP-based data channels may not send more than "
3034 << cricket::kDataMaxBandwidth / 1000 << "kbps.";
3035 return ParseFailed(line, description.str(), error);
3036 }
deadbeefb2362572016-12-13 16:37:06 -08003037 // Prevent integer overflow.
3038 b = std::min(b, INT_MAX / 1000);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003039 media_desc->set_bandwidth(b * 1000);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003040 }
3041 }
3042 continue;
3043 }
3044
zhihuang38989e52017-03-21 11:04:53 -07003045 // Parse the media level connection data.
3046 if (IsLineType(line, kLineTypeConnection)) {
3047 rtc::SocketAddress addr;
3048 if (!ParseConnectionData(line, &addr, error)) {
3049 return false;
3050 }
3051 media_desc->set_connection_address(addr);
3052 continue;
3053 }
3054
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003055 if (!IsLineType(line, kLineTypeAttributes)) {
Steve Anton36b29d12017-10-30 09:57:42 -07003056 // TODO(deadbeef): Handle other lines if needed.
Mirko Bonadei675513b2017-11-09 11:09:25 +01003057 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003058 continue;
3059 }
3060
3061 // Handle attributes common to SCTP and RTP.
3062 if (HasAttribute(line, kAttributeMid)) {
3063 // RFC 3388
3064 // mid-attribute = "a=mid:" identification-tag
3065 // identification-tag = token
3066 // Use the mid identification-tag as the content name.
3067 if (!GetValue(line, kAttributeMid, &mline_id, error)) {
3068 return false;
3069 }
3070 *content_name = mline_id;
deadbeef25ed4352016-12-12 18:37:36 -08003071 } else if (HasAttribute(line, kAttributeBundleOnly)) {
3072 *bundle_only = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003073 } else if (HasAttribute(line, kAttributeCandidate)) {
3074 Candidate candidate;
3075 if (!ParseCandidate(line, &candidate, error, false)) {
3076 return false;
3077 }
deadbeef7bcdb692017-01-20 12:43:58 -08003078 // ParseCandidate will parse non-standard ufrag and password attributes,
3079 // since it's used for candidate trickling, but we only want to process
3080 // the "a=ice-ufrag"/"a=ice-pwd" values in a session description, so
3081 // strip them off at this point.
3082 candidate.set_username(std::string());
3083 candidate.set_password(std::string());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003084 candidates_orig.push_back(candidate);
3085 } else if (HasAttribute(line, kAttributeIceUfrag)) {
3086 if (!GetValue(line, kAttributeIceUfrag, &transport->ice_ufrag, error)) {
3087 return false;
3088 }
3089 } else if (HasAttribute(line, kAttributeIcePwd)) {
3090 if (!GetValue(line, kAttributeIcePwd, &transport->ice_pwd, error)) {
3091 return false;
3092 }
3093 } else if (HasAttribute(line, kAttributeIceOption)) {
3094 if (!ParseIceOptions(line, &transport->transport_options, error)) {
3095 return false;
3096 }
3097 } else if (HasAttribute(line, kAttributeFmtp)) {
3098 if (!ParseFmtpAttributes(line, media_type, media_desc, error)) {
3099 return false;
3100 }
3101 } else if (HasAttribute(line, kAttributeFingerprint)) {
Steve Anton4905edb2018-10-15 19:27:44 -07003102 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003103 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
3104 return false;
3105 }
Steve Anton4905edb2018-10-15 19:27:44 -07003106 transport->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00003107 } else if (HasAttribute(line, kAttributeSetup)) {
3108 if (!ParseDtlsSetup(line, &(transport->connection_role), error)) {
3109 return false;
3110 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003111 } else if (cricket::IsDtlsSctp(protocol) &&
3112 HasAttribute(line, kAttributeSctpPort)) {
deadbeef7e146cb2016-09-28 10:04:34 -07003113 if (media_type != cricket::MEDIA_TYPE_DATA) {
3114 return ParseFailed(
3115 line, "sctp-port attribute found in non-data media description.",
3116 error);
3117 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003118 if (media_desc->as_sctp()->use_sctpmap()) {
3119 return ParseFailed(
3120 line, "sctp-port attribute can't be used with sctpmap.", error);
3121 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00003122 int sctp_port;
3123 if (!ParseSctpPort(line, &sctp_port, error)) {
3124 return false;
3125 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003126 media_desc->as_sctp()->set_port(sctp_port);
3127 } else if (cricket::IsDtlsSctp(protocol) &&
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02003128 HasAttribute(line, kAttributeMaxMessageSize)) {
3129 if (media_type != cricket::MEDIA_TYPE_DATA) {
3130 return ParseFailed(
3131 line,
3132 "max-message-size attribute found in non-data media description.",
3133 error);
3134 }
3135 int max_message_size;
3136 if (!ParseSctpMaxMessageSize(line, &max_message_size, error)) {
3137 return false;
3138 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003139 media_desc->as_sctp()->set_max_message_size(max_message_size);
3140 } else if (cricket::IsRtpProtocol(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003141 //
3142 // RTP specific attrubtes
3143 //
3144 if (HasAttribute(line, kAttributeRtcpMux)) {
3145 media_desc->set_rtcp_mux(true);
deadbeef13871492015-12-09 12:37:51 -08003146 } else if (HasAttribute(line, kAttributeRtcpReducedSize)) {
3147 media_desc->set_rtcp_reduced_size(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003148 } else if (HasAttribute(line, kAttributeSsrcGroup)) {
3149 if (!ParseSsrcGroupAttribute(line, &ssrc_groups, error)) {
3150 return false;
3151 }
3152 } else if (HasAttribute(line, kAttributeSsrc)) {
Steve Antone831b8c2018-02-01 12:22:16 -08003153 if (!ParseSsrcAttribute(line, &ssrc_infos, msid_signaling, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003154 return false;
3155 }
3156 } else if (HasAttribute(line, kAttributeCrypto)) {
3157 if (!ParseCryptoAttribute(line, media_desc, error)) {
3158 return false;
3159 }
3160 } else if (HasAttribute(line, kAttributeRtpmap)) {
deadbeef67cf2c12016-04-13 10:07:16 -07003161 if (!ParseRtpmapAttribute(line, media_type, payload_types, media_desc,
3162 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003163 return false;
3164 }
3165 } else if (HasAttribute(line, kCodecParamMaxPTime)) {
3166 if (!GetValue(line, kCodecParamMaxPTime, &maxptime_as_string, error)) {
3167 return false;
3168 }
3169 } else if (HasAttribute(line, kAttributeRtcpFb)) {
3170 if (!ParseRtcpFbAttribute(line, media_type, media_desc, error)) {
3171 return false;
3172 }
3173 } else if (HasAttribute(line, kCodecParamPTime)) {
3174 if (!GetValue(line, kCodecParamPTime, &ptime_as_string, error)) {
3175 return false;
3176 }
3177 } else if (HasAttribute(line, kAttributeSendOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003178 media_desc->set_direction(RtpTransceiverDirection::kSendOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003179 } else if (HasAttribute(line, kAttributeRecvOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003180 media_desc->set_direction(RtpTransceiverDirection::kRecvOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003181 } else if (HasAttribute(line, kAttributeInactive)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003182 media_desc->set_direction(RtpTransceiverDirection::kInactive);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003183 } else if (HasAttribute(line, kAttributeSendRecv)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003184 media_desc->set_direction(RtpTransceiverDirection::kSendRecv);
Johannes Kron0854eb62018-10-10 22:33:20 +02003185 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02003186 media_desc->set_extmap_allow_mixed_enum(
Johannes Kron0854eb62018-10-10 22:33:20 +02003187 MediaContentDescription::kMedia);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003188 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07003189 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003190 if (!ParseExtmap(line, &extmap, error)) {
3191 return false;
3192 }
3193 media_desc->AddRtpHeaderExtension(extmap);
3194 } else if (HasAttribute(line, kAttributeXGoogleFlag)) {
3195 // Experimental attribute. Conference mode activates more aggressive
3196 // AEC and NS settings.
Steve Anton36b29d12017-10-30 09:57:42 -07003197 // TODO(deadbeef): expose API to set these directly.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003198 std::string flag_value;
3199 if (!GetValue(line, kAttributeXGoogleFlag, &flag_value, error)) {
3200 return false;
3201 }
3202 if (flag_value.compare(kValueConference) == 0)
3203 media_desc->set_conference_mode(true);
deadbeef9d3584c2016-02-16 17:54:10 -08003204 } else if (HasAttribute(line, kAttributeMsid)) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07003205 if (!ParseMsidAttribute(line, &stream_ids, &track_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08003206 return false;
3207 }
Steve Antone831b8c2018-02-01 12:22:16 -08003208 *msid_signaling |= cricket::kMsidSignalingMediaSection;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003209 } else if (HasAttribute(line, kAttributeRid)) {
3210 const size_t kRidPrefixLength =
3211 kLinePrefixLength + arraysize(kAttributeRid);
3212 if (line.size() <= kRidPrefixLength) {
3213 RTC_LOG(LS_INFO) << "Ignoring empty RID attribute: " << line;
3214 continue;
3215 }
3216 RTCErrorOr<RidDescription> error_or_rid_description =
3217 deserializer.DeserializeRidDescription(
3218 line.substr(kRidPrefixLength));
3219
3220 // Malformed a=rid lines are discarded.
3221 if (!error_or_rid_description.ok()) {
3222 RTC_LOG(LS_INFO) << "Ignoring malformed RID line: '" << line
3223 << "'. Error: "
3224 << error_or_rid_description.error().message();
3225 continue;
3226 }
3227
3228 rids.push_back(error_or_rid_description.MoveValue());
Amit Hilbucha2012042018-12-03 11:35:05 -08003229 } else if (HasAttribute(line, kAttributeSimulcast)) {
3230 const size_t kSimulcastPrefixLength =
3231 kLinePrefixLength + arraysize(kAttributeSimulcast);
3232 if (line.size() <= kSimulcastPrefixLength) {
3233 return ParseFailed(line, "Simulcast attribute is empty.", error);
3234 }
3235
3236 if (!simulcast.empty()) {
3237 return ParseFailed(line, "Multiple Simulcast attributes specified.",
3238 error);
3239 }
3240
Amit Hilbucha2012042018-12-03 11:35:05 -08003241 RTCErrorOr<SimulcastDescription> error_or_simulcast =
3242 deserializer.DeserializeSimulcastDescription(
3243 line.substr(kSimulcastPrefixLength));
3244 if (!error_or_simulcast.ok()) {
3245 return ParseFailed(line,
3246 std::string("Malformed simulcast line: ") +
3247 error_or_simulcast.error().message(),
3248 error);
3249 }
3250
3251 simulcast = error_or_simulcast.value();
3252 } else {
3253 // Unrecognized attribute in RTP protocol.
3254 RTC_LOG(LS_INFO) << "Ignored line: " << line;
3255 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003256 }
3257 } else {
3258 // Only parse lines that we are interested of.
Mirko Bonadei675513b2017-11-09 11:09:25 +01003259 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003260 continue;
3261 }
3262 }
3263
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003264 // Remove duplicate or inconsistent rids.
3265 RemoveInvalidRidDescriptions(payload_types, &rids);
3266
3267 // If simulcast is specifed, split the rids into send and receive.
3268 // Rids that do not appear in simulcast attribute will be removed.
3269 // If it is not specified, we assume that all rids are for send layers.
Amit Hilbuchb7446ed2019-01-28 12:25:25 -08003270 std::vector<RidDescription> send_rids;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003271 if (!simulcast.empty()) {
3272 // Verify that the rids in simulcast match rids in sdp.
3273 RemoveInvalidRidsFromSimulcast(rids, &simulcast);
3274
3275 // Use simulcast description to figure out Send / Receive RIDs.
3276 std::map<std::string, RidDescription> rid_map;
3277 for (const RidDescription& rid : rids) {
3278 rid_map[rid.rid] = rid;
3279 }
3280
3281 for (const auto& layer : simulcast.send_layers().GetAllLayers()) {
3282 auto iter = rid_map.find(layer.rid);
3283 RTC_DCHECK(iter != rid_map.end());
3284 send_rids.push_back(iter->second);
3285 }
3286
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003287 media_desc->set_simulcast_description(simulcast);
3288 } else {
3289 send_rids = rids;
3290 }
3291
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003292 // Create tracks from the |ssrc_infos|.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -08003293 // If the stream_id/track_id for all SSRCS are identical, one StreamParams
3294 // will be created in CreateTracksFromSsrcInfos, containing all the SSRCs from
3295 // the m= section.
Seth Hampson5897a6e2018-04-03 11:16:33 -07003296 if (!ssrc_infos.empty()) {
3297 CreateTracksFromSsrcInfos(ssrc_infos, stream_ids, track_id, &tracks,
3298 *msid_signaling);
3299 } else if (media_type != cricket::MEDIA_TYPE_DATA &&
3300 (*msid_signaling & cricket::kMsidSignalingMediaSection)) {
3301 // If the stream_ids/track_id was signaled but SSRCs were unsignaled we
3302 // still create a track. This isn't done for data media types because
3303 // StreamParams aren't used for SCTP streams, and RTP data channels don't
3304 // support unsignaled SSRCs.
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003305 CreateTrackWithNoSsrcs(stream_ids, track_id, send_rids, &tracks);
3306 }
3307
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003308 // Add the ssrc group to the track.
Steve Anton4daf66e2018-09-07 14:55:53 -07003309 for (const SsrcGroup& ssrc_group : ssrc_groups) {
3310 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003311 continue;
3312 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003313 uint32_t ssrc = ssrc_group.ssrcs.front();
3314 for (StreamParams& track : tracks) {
3315 if (track.has_ssrc(ssrc)) {
3316 track.ssrc_groups.push_back(ssrc_group);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003317 }
3318 }
3319 }
3320
3321 // Add the new tracks to the |media_desc|.
deadbeef9d3584c2016-02-16 17:54:10 -08003322 for (StreamParams& track : tracks) {
3323 media_desc->AddStream(track);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003324 }
3325
3326 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003327 AudioContentDescription* audio_desc = media_desc->as_audio();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003328 UpdateFromWildcardCodecs(audio_desc);
3329
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003330 // Verify audio codec ensures that no audio codec has been populated with
3331 // only fmtp.
3332 if (!VerifyAudioCodecs(audio_desc)) {
3333 return ParseFailed("Failed to parse audio codecs correctly.", error);
3334 }
3335 AddAudioAttribute(kCodecParamMaxPTime, maxptime_as_string, audio_desc);
3336 AddAudioAttribute(kCodecParamPTime, ptime_as_string, audio_desc);
3337 }
3338
3339 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003340 VideoContentDescription* video_desc = media_desc->as_video();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003341 UpdateFromWildcardCodecs(video_desc);
3342 // Verify video codec ensures that no video codec has been populated with
3343 // only rtcp-fb.
3344 if (!VerifyVideoCodecs(video_desc)) {
3345 return ParseFailed("Failed to parse video codecs correctly.", error);
3346 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003347 }
3348
3349 // RFC 5245
3350 // Update the candidates with the media level "ice-pwd" and "ice-ufrag".
Steve Anton4daf66e2018-09-07 14:55:53 -07003351 for (Candidate& candidate : candidates_orig) {
3352 RTC_DCHECK(candidate.username().empty() ||
3353 candidate.username() == transport->ice_ufrag);
3354 candidate.set_username(transport->ice_ufrag);
3355 RTC_DCHECK(candidate.password().empty());
3356 candidate.set_password(transport->ice_pwd);
3357 candidates->push_back(
Steve Anton5a1de872018-12-18 11:25:55 -08003358 absl::make_unique<JsepIceCandidate>(mline_id, mline_index, candidate));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003359 }
Amit Hilbucha2012042018-12-03 11:35:05 -08003360
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003361 return true;
3362}
3363
Steve Antone831b8c2018-02-01 12:22:16 -08003364bool ParseSsrcAttribute(const std::string& line,
3365 SsrcInfoVec* ssrc_infos,
3366 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003367 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003368 RTC_DCHECK(ssrc_infos != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003369 // RFC 5576
3370 // a=ssrc:<ssrc-id> <attribute>
3371 // a=ssrc:<ssrc-id> <attribute>:<value>
3372 std::string field1, field2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003373 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3374 kSdpDelimiterSpaceChar, &field1, &field2)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003375 const size_t expected_fields = 2;
3376 return ParseFailedExpectFieldNum(line, expected_fields, error);
3377 }
3378
3379 // ssrc:<ssrc-id>
3380 std::string ssrc_id_s;
3381 if (!GetValue(field1, kAttributeSsrc, &ssrc_id_s, error)) {
3382 return false;
3383 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003384 uint32_t ssrc_id = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003385 if (!GetValueFromString(line, ssrc_id_s, &ssrc_id, error)) {
3386 return false;
3387 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003388
3389 std::string attribute;
3390 std::string value;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003391 if (!rtc::tokenize_first(field2, kSdpDelimiterColonChar, &attribute,
3392 &value)) {
3393 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003394 description << "Failed to get the ssrc attribute value from " << field2
3395 << ". Expected format <attribute>:<value>.";
3396 return ParseFailed(line, description.str(), error);
3397 }
3398
3399 // Check if there's already an item for this |ssrc_id|. Create a new one if
3400 // there isn't.
Steve Anton64b626b2019-01-28 17:25:26 -08003401 auto ssrc_info_it =
3402 absl::c_find_if(*ssrc_infos, [ssrc_id](const SsrcInfo& ssrc_info) {
3403 return ssrc_info.ssrc_id == ssrc_id;
3404 });
Steve Anton4daf66e2018-09-07 14:55:53 -07003405 if (ssrc_info_it == ssrc_infos->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003406 SsrcInfo info;
3407 info.ssrc_id = ssrc_id;
3408 ssrc_infos->push_back(info);
Steve Anton4daf66e2018-09-07 14:55:53 -07003409 ssrc_info_it = ssrc_infos->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003410 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003411 SsrcInfo& ssrc_info = *ssrc_info_it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003412
3413 // Store the info to the |ssrc_info|.
3414 if (attribute == kSsrcAttributeCname) {
3415 // RFC 5576
3416 // cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003417 ssrc_info.cname = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003418 } else if (attribute == kSsrcAttributeMsid) {
3419 // draft-alvestrand-mmusic-msid-00
Seth Hampson5b4f0752018-04-02 16:31:36 -07003420 // msid:identifier [appdata]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003421 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003422 rtc::split(value, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003423 if (fields.size() < 1 || fields.size() > 2) {
Yves Gerey665174f2018-06-19 15:03:05 +02003424 return ParseFailed(
3425 line, "Expected format \"msid:<identifier>[ <appdata>]\".", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003426 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003427 ssrc_info.stream_id = fields[0];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003428 if (fields.size() == 2) {
Steve Anton4daf66e2018-09-07 14:55:53 -07003429 ssrc_info.track_id = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003430 }
Steve Antone831b8c2018-02-01 12:22:16 -08003431 *msid_signaling |= cricket::kMsidSignalingSsrcAttribute;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003432 } else if (attribute == kSsrcAttributeMslabel) {
3433 // draft-alvestrand-rtcweb-mid-01
3434 // mslabel:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003435 ssrc_info.mslabel = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003436 } else if (attribute == kSSrcAttributeLabel) {
3437 // The label isn't defined.
3438 // label:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003439 ssrc_info.label = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003440 }
3441 return true;
3442}
3443
3444bool ParseSsrcGroupAttribute(const std::string& line,
3445 SsrcGroupVec* ssrc_groups,
3446 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003447 RTC_DCHECK(ssrc_groups != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003448 // RFC 5576
3449 // a=ssrc-group:<semantics> <ssrc-id> ...
3450 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003451 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003452 const size_t expected_min_fields = 2;
3453 if (fields.size() < expected_min_fields) {
3454 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3455 }
3456 std::string semantics;
3457 if (!GetValue(fields[0], kAttributeSsrcGroup, &semantics, error)) {
3458 return false;
3459 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003460 std::vector<uint32_t> ssrcs;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003461 for (size_t i = 1; i < fields.size(); ++i) {
Peter Boström0c4e06b2015-10-07 12:23:21 +02003462 uint32_t ssrc = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003463 if (!GetValueFromString(line, fields[i], &ssrc, error)) {
3464 return false;
3465 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003466 ssrcs.push_back(ssrc);
3467 }
3468 ssrc_groups->push_back(SsrcGroup(semantics, ssrcs));
3469 return true;
3470}
3471
3472bool ParseCryptoAttribute(const std::string& line,
3473 MediaContentDescription* media_desc,
3474 SdpParseError* error) {
3475 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003476 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003477 // RFC 4568
3478 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
3479 const size_t expected_min_fields = 3;
3480 if (fields.size() < expected_min_fields) {
3481 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3482 }
3483 std::string tag_value;
3484 if (!GetValue(fields[0], kAttributeCrypto, &tag_value, error)) {
3485 return false;
3486 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003487 int tag = 0;
3488 if (!GetValueFromString(line, tag_value, &tag, error)) {
3489 return false;
3490 }
jbauch083b73f2015-07-16 02:46:32 -07003491 const std::string& crypto_suite = fields[1];
3492 const std::string& key_params = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003493 std::string session_params;
3494 if (fields.size() > 3) {
3495 session_params = fields[3];
3496 }
Yves Gerey665174f2018-06-19 15:03:05 +02003497 media_desc->AddCrypto(
3498 CryptoParams(tag, crypto_suite, key_params, session_params));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003499 return true;
3500}
3501
3502// Updates or creates a new codec entry in the audio description with according
deadbeef67cf2c12016-04-13 10:07:16 -07003503// to |name|, |clockrate|, |bitrate|, and |channels|.
3504void UpdateCodec(int payload_type,
3505 const std::string& name,
3506 int clockrate,
3507 int bitrate,
3508 size_t channels,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003509 AudioContentDescription* audio_desc) {
3510 // Codec may already be populated with (only) optional parameters
3511 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003512 cricket::AudioCodec codec =
3513 GetCodecWithPayloadType(audio_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003514 codec.name = name;
3515 codec.clockrate = clockrate;
3516 codec.bitrate = bitrate;
3517 codec.channels = channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003518 AddOrReplaceCodec<AudioContentDescription, cricket::AudioCodec>(audio_desc,
3519 codec);
3520}
3521
3522// Updates or creates a new codec entry in the video description according to
deadbeef67cf2c12016-04-13 10:07:16 -07003523// |name|, |width|, |height|, and |framerate|.
3524void UpdateCodec(int payload_type,
3525 const std::string& name,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003526 VideoContentDescription* video_desc) {
3527 // Codec may already be populated with (only) optional parameters
3528 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003529 cricket::VideoCodec codec =
3530 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003531 codec.name = name;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003532 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
3533 codec);
3534}
3535
3536bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003537 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -07003538 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003539 MediaContentDescription* media_desc,
3540 SdpParseError* error) {
3541 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003542 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003543 // RFC 4566
3544 // a=rtpmap:<payload type> <encoding name>/<clock rate>[/<encodingparameters>]
3545 const size_t expected_min_fields = 2;
3546 if (fields.size() < expected_min_fields) {
3547 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3548 }
3549 std::string payload_type_value;
3550 if (!GetValue(fields[0], kAttributeRtpmap, &payload_type_value, error)) {
3551 return false;
3552 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003553 int payload_type = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003554 if (!GetPayloadTypeFromString(line, payload_type_value, &payload_type,
3555 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003556 return false;
3557 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003558
Steve Anton64b626b2019-01-28 17:25:26 -08003559 if (!absl::c_linear_search(payload_types, payload_type)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003560 RTC_LOG(LS_WARNING) << "Ignore rtpmap line that did not appear in the "
Jonas Olsson45cc8902018-02-13 10:37:07 +01003561 "<fmt> of the m-line: "
3562 << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003563 return true;
3564 }
jbauch083b73f2015-07-16 02:46:32 -07003565 const std::string& encoder = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003566 std::vector<std::string> codec_params;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00003567 rtc::split(encoder, '/', &codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003568 // <encoding name>/<clock rate>[/<encodingparameters>]
3569 // 2 mandatory fields
3570 if (codec_params.size() < 2 || codec_params.size() > 3) {
3571 return ParseFailed(line,
3572 "Expected format \"<encoding name>/<clock rate>"
3573 "[/<encodingparameters>]\".",
3574 error);
3575 }
jbauch083b73f2015-07-16 02:46:32 -07003576 const std::string& encoding_name = codec_params[0];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003577 int clock_rate = 0;
3578 if (!GetValueFromString(line, codec_params[1], &clock_rate, error)) {
3579 return false;
3580 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003581 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003582 VideoContentDescription* video_desc = media_desc->as_video();
Yves Gerey665174f2018-06-19 15:03:05 +02003583 UpdateCodec(payload_type, encoding_name, video_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003584 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3585 // RFC 4566
3586 // For audio streams, <encoding parameters> indicates the number
3587 // of audio channels. This parameter is OPTIONAL and may be
3588 // omitted if the number of channels is one, provided that no
3589 // additional parameters are needed.
Peter Kasting69558702016-01-12 16:26:35 -08003590 size_t channels = 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003591 if (codec_params.size() == 3) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003592 if (!GetValueFromString(line, codec_params[2], &channels, error)) {
3593 return false;
3594 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003595 }
Steve Antonb1c1de12017-12-21 15:14:30 -08003596 AudioContentDescription* audio_desc = media_desc->as_audio();
ossue1405ad2017-01-23 08:55:48 -08003597 UpdateCodec(payload_type, encoding_name, clock_rate, 0, channels,
deadbeef67cf2c12016-04-13 10:07:16 -07003598 audio_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003599 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003600 RtpDataContentDescription* data_desc = media_desc->as_rtp_data();
3601 if (data_desc) {
3602 data_desc->AddCodec(cricket::RtpDataCodec(payload_type, encoding_name));
3603 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003604 }
3605 return true;
3606}
3607
Yves Gerey665174f2018-06-19 15:03:05 +02003608bool ParseFmtpParam(const std::string& line,
3609 std::string* parameter,
3610 std::string* value,
3611 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003612 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, parameter, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003613 ParseFailed(line, "Unable to parse fmtp parameter. \'=\' missing.", error);
3614 return false;
3615 }
3616 // a=fmtp:<payload_type> <param1>=<value1>; <param2>=<value2>; ...
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003617 return true;
3618}
3619
Yves Gerey665174f2018-06-19 15:03:05 +02003620bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003621 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003622 MediaContentDescription* media_desc,
3623 SdpParseError* error) {
3624 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3625 media_type != cricket::MEDIA_TYPE_VIDEO) {
3626 return true;
3627 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003628
3629 std::string line_payload;
3630 std::string line_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003631
3632 // RFC 5576
3633 // a=fmtp:<format> <format specific parameters>
3634 // At least two fields, whereas the second one is any of the optional
3635 // parameters.
Jonas Olssonec9e4922018-09-05 09:53:49 +02003636 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3637 kSdpDelimiterSpaceChar, &line_payload,
3638 &line_params)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003639 ParseFailedExpectMinFieldNum(line, 2, error);
3640 return false;
3641 }
3642
Donald Curtis0e07f922015-05-15 09:21:23 -07003643 // Parse out the payload information.
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003644 std::string payload_type_str;
Donald Curtis0e07f922015-05-15 09:21:23 -07003645 if (!GetValue(line_payload, kAttributeFmtp, &payload_type_str, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003646 return false;
3647 }
3648
Donald Curtis0e07f922015-05-15 09:21:23 -07003649 int payload_type = 0;
Donald Curtis144d0182015-05-15 13:14:24 -07003650 if (!GetPayloadTypeFromString(line_payload, payload_type_str, &payload_type,
3651 error)) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003652 return false;
3653 }
3654
3655 // Parse out format specific parameters.
3656 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003657 rtc::split(line_params, kSdpDelimiterSemicolonChar, &fields);
Donald Curtis0e07f922015-05-15 09:21:23 -07003658
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003659 cricket::CodecParameterMap codec_params;
Donald Curtis144d0182015-05-15 13:14:24 -07003660 for (auto& iter : fields) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003661 if (iter.find(kSdpDelimiterEqual) == std::string::npos) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003662 // Only fmtps with equals are currently supported. Other fmtp types
3663 // should be ignored. Unknown fmtps do not constitute an error.
3664 continue;
3665 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003666
3667 std::string name;
3668 std::string value;
3669 if (!ParseFmtpParam(rtc::string_trim(iter), &name, &value, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003670 return false;
3671 }
3672 codec_params[name] = value;
3673 }
3674
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003675 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3676 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003677 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003678 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
3679 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003680 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003681 }
3682 return true;
3683}
3684
Yves Gerey665174f2018-06-19 15:03:05 +02003685bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003686 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003687 MediaContentDescription* media_desc,
3688 SdpParseError* error) {
3689 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3690 media_type != cricket::MEDIA_TYPE_VIDEO) {
3691 return true;
3692 }
3693 std::vector<std::string> rtcp_fb_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003694 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &rtcp_fb_fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003695 if (rtcp_fb_fields.size() < 2) {
3696 return ParseFailedGetValue(line, kAttributeRtcpFb, error);
3697 }
3698 std::string payload_type_string;
3699 if (!GetValue(rtcp_fb_fields[0], kAttributeRtcpFb, &payload_type_string,
3700 error)) {
3701 return false;
3702 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003703 int payload_type = kWildcardPayloadType;
3704 if (payload_type_string != "*") {
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003705 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3706 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003707 return false;
3708 }
3709 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003710 std::string id = rtcp_fb_fields[1];
3711 std::string param = "";
3712 for (std::vector<std::string>::iterator iter = rtcp_fb_fields.begin() + 2;
3713 iter != rtcp_fb_fields.end(); ++iter) {
3714 param.append(*iter);
3715 }
3716 const cricket::FeedbackParam feedback_param(id, param);
3717
3718 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003719 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
3720 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003721 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003722 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
3723 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003724 }
3725 return true;
3726}
3727
3728} // namespace webrtc