blob: 83bd3782bd6b57ec2678e5e208739656220bb253 [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";
Mirta Dvornicic479a3c02019-06-04 15:38:50 +0200183static const char kAttributePacketization[] = "packetization";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000184
185// Experimental flags
186static const char kAttributeXGoogleFlag[] = "x-google-flag";
187static const char kValueConference[] = "conference";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000188
189// Candidate
190static const char kCandidateHost[] = "host";
191static const char kCandidateSrflx[] = "srflx";
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700192static const char kCandidatePrflx[] = "prflx";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000193static const char kCandidateRelay[] = "relay";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +0000194static const char kTcpCandidateType[] = "tcptype";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000195
Jonas Olssonec9e4922018-09-05 09:53:49 +0200196// rtc::StringBuilder doesn't have a << overload for chars, while rtc::split and
197// rtc::tokenize_first both take a char delimiter. To handle both cases these
198// constants come in pairs of a chars and length-one strings.
199static const char kSdpDelimiterEqual[] = "=";
200static const char kSdpDelimiterEqualChar = '=';
201static const char kSdpDelimiterSpace[] = " ";
202static const char kSdpDelimiterSpaceChar = ' ';
203static const char kSdpDelimiterColon[] = ":";
204static const char kSdpDelimiterColonChar = ':';
205static const char kSdpDelimiterSemicolon[] = ";";
206static const char kSdpDelimiterSemicolonChar = ';';
207static const char kSdpDelimiterSlashChar = '/';
208static const char kNewLine[] = "\n";
209static const char kNewLineChar = '\n';
210static const char kReturnChar = '\r';
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000211static const char kLineBreak[] = "\r\n";
212
Steve Anton36b29d12017-10-30 09:57:42 -0700213// TODO(deadbeef): Generate the Session and Time description
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000214// instead of hardcoding.
215static const char kSessionVersion[] = "v=0";
216// RFC 4566
217static const char kSessionOriginUsername[] = "-";
218static const char kSessionOriginSessionId[] = "0";
219static const char kSessionOriginSessionVersion[] = "0";
220static const char kSessionOriginNettype[] = "IN";
221static const char kSessionOriginAddrtype[] = "IP4";
222static const char kSessionOriginAddress[] = "127.0.0.1";
223static const char kSessionName[] = "s=-";
224static const char kTimeDescription[] = "t=0 0";
225static const char kAttrGroup[] = "a=group:BUNDLE";
226static const char kConnectionNettype[] = "IN";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000227static const char kConnectionIpv4Addrtype[] = "IP4";
228static const char kConnectionIpv6Addrtype[] = "IP6";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000229static const char kMediaTypeVideo[] = "video";
230static const char kMediaTypeAudio[] = "audio";
231static const char kMediaTypeData[] = "application";
232static const char kMediaPortRejected[] = "0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000233// draft-ietf-mmusic-trickle-ice-01
234// When no candidates have been gathered, set the connection
235// address to IP6 ::.
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000236// TODO(perkj): FF can not parse IP6 ::. See http://crbug/430333
237// Use IPV4 per default.
238static const char kDummyAddress[] = "0.0.0.0";
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000239static const char kDummyPort[] = "9";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000240// RFC 3556
241static const char kApplicationSpecificMaximum[] = "AS";
242
wu@webrtc.org78187522013-10-07 23:32:02 +0000243static const char kDefaultSctpmapProtocol[] = "webrtc-datachannel";
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000244
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -0800245// This is a non-standardized media transport settings.
246// This setting is going to be set in the offer. There may be one or more
247// a=x-mt: settings, and they are in the priority order (the most preferred on
248// top). x-mt setting format depends on the media transport, and is generated by
249// |MediaTransportInterface::GetTransportParametersOffer|.
250static const char kMediaTransportSettingLine[] = "x-mt";
251
pkasting@chromium.orgd3245462015-02-23 21:28:22 +0000252// RTP payload type is in the 0-127 range. Use -1 to indicate "all" payload
253// types.
254const int kWildcardPayloadType = -1;
255
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000256struct SsrcInfo {
Peter Boström0c4e06b2015-10-07 12:23:21 +0200257 uint32_t ssrc_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000258 std::string cname;
deadbeef9d3584c2016-02-16 17:54:10 -0800259 std::string stream_id;
260 std::string track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000261
262 // For backward compatibility.
263 // TODO(ronghuawu): Remove below 2 fields once all the clients support msid.
264 std::string label;
265 std::string mslabel;
266};
267typedef std::vector<SsrcInfo> SsrcInfoVec;
268typedef std::vector<SsrcGroup> SsrcGroupVec;
269
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000270template <class T>
271static void AddFmtpLine(const T& codec, std::string* message);
272static void BuildMediaDescription(const ContentInfo* content_info,
273 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200274 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000275 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -0800276 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000277 std::string* message);
deadbeef9d3584c2016-02-16 17:54:10 -0800278static void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200279 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -0800280 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -0800281 std::string* message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000282static void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200283 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000284 std::string* message);
285static void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -0800286 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000287 std::string* message);
288static void BuildIceOptions(const std::vector<std::string>& transport_options,
289 std::string* message);
zhihuang38989e52017-03-21 11:04:53 -0700290static bool ParseSessionDescription(const std::string& message,
291 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000292 std::string* session_id,
293 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000294 TransportDescription* session_td,
295 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700296 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000297 cricket::SessionDescription* desc,
298 SdpParseError* error);
299static bool ParseGroupAttribute(const std::string& line,
300 cricket::SessionDescription* desc,
301 SdpParseError* error);
302static bool ParseMediaDescription(
303 const std::string& message,
304 const TransportDescription& session_td,
305 const RtpHeaderExtensions& session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -0700306 size_t* pos,
307 const rtc::SocketAddress& session_connection_addr,
308 cricket::SessionDescription* desc,
Steve Anton5a1de872018-12-18 11:25:55 -0800309 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000310 SdpParseError* error);
Steve Anton5a1de872018-12-18 11:25:55 -0800311static bool ParseContent(
312 const std::string& message,
313 const cricket::MediaType media_type,
314 int mline_index,
315 const std::string& protocol,
316 const std::vector<int>& payload_types,
317 size_t* pos,
318 std::string* content_name,
319 bool* bundle_only,
320 int* msid_signaling,
321 MediaContentDescription* media_desc,
322 TransportDescription* transport,
323 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
324 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000325static bool ParseSsrcAttribute(const std::string& line,
326 SsrcInfoVec* ssrc_infos,
Steve Antone831b8c2018-02-01 12:22:16 -0800327 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000328 SdpParseError* error);
329static bool ParseSsrcGroupAttribute(const std::string& line,
330 SsrcGroupVec* ssrc_groups,
331 SdpParseError* error);
332static bool ParseCryptoAttribute(const std::string& line,
333 MediaContentDescription* media_desc,
334 SdpParseError* error);
335static bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200336 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -0700337 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000338 MediaContentDescription* media_desc,
339 SdpParseError* error);
340static bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200341 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000342 MediaContentDescription* media_desc,
343 SdpParseError* error);
Yves Gerey665174f2018-06-19 15:03:05 +0200344static bool ParseFmtpParam(const std::string& line,
345 std::string* parameter,
346 std::string* value,
347 SdpParseError* error);
Mirta Dvornicic479a3c02019-06-04 15:38:50 +0200348static bool ParsePacketizationAttribute(const std::string& line,
349 const cricket::MediaType media_type,
350 MediaContentDescription* media_desc,
351 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000352static bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +0200353 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000354 MediaContentDescription* media_desc,
355 SdpParseError* error);
356static bool ParseIceOptions(const std::string& line,
357 std::vector<std::string>* transport_options,
358 SdpParseError* error);
359static bool ParseExtmap(const std::string& line,
isheriff6f8d6862016-05-26 11:24:55 -0700360 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000361 SdpParseError* error);
Steve Anton4905edb2018-10-15 19:27:44 -0700362static bool ParseFingerprintAttribute(
363 const std::string& line,
364 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
365 SdpParseError* error);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +0000366static bool ParseDtlsSetup(const std::string& line,
367 cricket::ConnectionRole* role,
368 SdpParseError* error);
deadbeef9d3584c2016-02-16 17:54:10 -0800369static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700370 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -0800371 std::string* track_id,
372 SdpParseError* error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000373
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800374static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
375 std::vector<RidDescription>* rids);
376
377static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
378 const std::set<std::string>& to_remove,
379 const SimulcastLayerList& layers);
380
381static void RemoveInvalidRidsFromSimulcast(
382 const std::vector<RidDescription>& rids,
383 SimulcastDescription* simulcast);
384
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000385// Helper functions
386
387// Below ParseFailed*** functions output the line that caused the parsing
388// failure and the detailed reason (|description|) of the failure to |error|.
389// The functions always return false so that they can be used directly in the
390// following way when error happens:
391// "return ParseFailed***(...);"
392
393// The line starting at |line_start| of |message| is the failing line.
394// The reason for the failure should be provided in the |description|.
395// An example of a description could be "unknown character".
396static bool ParseFailed(const std::string& message,
397 size_t line_start,
398 const std::string& description,
399 SdpParseError* error) {
400 // Get the first line of |message| from |line_start|.
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000401 std::string first_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000402 size_t line_end = message.find(kNewLine, line_start);
403 if (line_end != std::string::npos) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200404 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000405 --line_end;
406 }
407 first_line = message.substr(line_start, (line_end - line_start));
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +0000408 } else {
409 first_line = message.substr(line_start);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000410 }
411
412 if (error) {
413 error->line = first_line;
414 error->description = description;
415 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100416 RTC_LOG(LS_ERROR) << "Failed to parse: \"" << first_line
417 << "\". Reason: " << description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000418 return false;
419}
420
421// |line| is the failing line. The reason for the failure should be
422// provided in the |description|.
423static bool ParseFailed(const std::string& line,
424 const std::string& description,
425 SdpParseError* error) {
426 return ParseFailed(line, 0, description, error);
427}
428
429// Parses failure where the failing SDP line isn't know or there are multiple
430// failing lines.
Yves Gerey665174f2018-06-19 15:03:05 +0200431static bool ParseFailed(const std::string& description, SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000432 return ParseFailed("", description, error);
433}
434
435// |line| is the failing line. The failure is due to the fact that |line|
436// doesn't have |expected_fields| fields.
437static bool ParseFailedExpectFieldNum(const std::string& line,
438 int expected_fields,
439 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200440 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000441 description << "Expects " << expected_fields << " fields.";
442 return ParseFailed(line, description.str(), error);
443}
444
445// |line| is the failing line. The failure is due to the fact that |line| has
446// less than |expected_min_fields| fields.
447static bool ParseFailedExpectMinFieldNum(const std::string& line,
448 int expected_min_fields,
449 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200450 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000451 description << "Expects at least " << expected_min_fields << " fields.";
452 return ParseFailed(line, description.str(), error);
453}
454
455// |line| is the failing line. The failure is due to the fact that it failed to
456// get the value of |attribute|.
457static bool ParseFailedGetValue(const std::string& line,
458 const std::string& attribute,
459 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200460 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000461 description << "Failed to get the value of attribute: " << attribute;
462 return ParseFailed(line, description.str(), error);
463}
464
465// The line starting at |line_start| of |message| is the failing line. The
466// failure is due to the line type (e.g. the "m" part of the "m-line")
467// not matching what is expected. The expected line type should be
468// provided as |line_type|.
469static bool ParseFailedExpectLine(const std::string& message,
470 size_t line_start,
471 const char line_type,
472 const std::string& line_value,
473 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200474 rtc::StringBuilder description;
475 description << "Expect line: " << std::string(1, line_type) << "="
476 << line_value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000477 return ParseFailed(message, line_start, description.str(), error);
478}
479
480static bool AddLine(const std::string& line, std::string* message) {
481 if (!message)
482 return false;
483
484 message->append(line);
485 message->append(kLineBreak);
486 return true;
487}
488
489static bool GetLine(const std::string& message,
490 size_t* pos,
491 std::string* line) {
492 size_t line_begin = *pos;
493 size_t line_end = message.find(kNewLine, line_begin);
494 if (line_end == std::string::npos) {
495 return false;
496 }
497 // Update the new start position
498 *pos = line_end + 1;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200499 if (line_end > 0 && (message.at(line_end - 1) == kReturnChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000500 --line_end;
501 }
502 *line = message.substr(line_begin, (line_end - line_begin));
503 const char* cline = line->c_str();
504 // RFC 4566
505 // An SDP session description consists of a number of lines of text of
506 // the form:
507 // <type>=<value>
508 // where <type> MUST be exactly one case-significant character and
509 // <value> is structured text whose format depends on <type>.
510 // Whitespace MUST NOT be used on either side of the "=" sign.
Taylor Brandstetter93a7b242018-04-16 10:45:24 -0700511 //
512 // However, an exception to the whitespace rule is made for "s=", since
513 // RFC4566 also says:
514 //
515 // If a session has no meaningful name, the value "s= " SHOULD be used
516 // (i.e., a single space as the session name).
517 if (line->length() < 3 || !islower(cline[0]) ||
Jonas Olssonec9e4922018-09-05 09:53:49 +0200518 cline[1] != kSdpDelimiterEqualChar ||
519 (cline[0] != kLineTypeSessionName &&
520 cline[2] == kSdpDelimiterSpaceChar)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000521 *pos = line_begin;
522 return false;
523 }
524 return true;
525}
526
527// Init |os| to "|type|=|value|".
528static void InitLine(const char type,
529 const std::string& value,
Jonas Olssonec9e4922018-09-05 09:53:49 +0200530 rtc::StringBuilder* os) {
531 os->Clear();
532 *os << std::string(1, type) << kSdpDelimiterEqual << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000533}
534
535// Init |os| to "a=|attribute|".
Jonas Olssonec9e4922018-09-05 09:53:49 +0200536static void InitAttrLine(const std::string& attribute, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000537 InitLine(kLineTypeAttributes, attribute, os);
538}
539
Piotr (Peter) Slatalab1ae10b2019-03-01 11:14:05 -0800540// Writes an x-mt SDP attribute line based on the media transport settings.
541static void AddMediaTransportLine(
542 const cricket::SessionDescription::MediaTransportSetting& setting,
543 std::string* message) {
544 rtc::StringBuilder os;
545 InitAttrLine(kMediaTransportSettingLine, &os);
546 os << kSdpDelimiterColon << setting.transport_name << kSdpDelimiterColon
547 << rtc::Base64::Encode(setting.transport_setting);
548 AddLine(os.str(), message);
549}
550
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000551// Writes a SDP attribute line based on |attribute| and |value| to |message|.
Yves Gerey665174f2018-06-19 15:03:05 +0200552static void AddAttributeLine(const std::string& attribute,
553 int value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000554 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200555 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000556 InitAttrLine(attribute, &os);
557 os << kSdpDelimiterColon << value;
558 AddLine(os.str(), message);
559}
560
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000561static bool IsLineType(const std::string& message,
562 const char type,
563 size_t line_start) {
564 if (message.size() < line_start + kLinePrefixLength) {
565 return false;
566 }
567 const char* cmessage = message.c_str();
568 return (cmessage[line_start] == type &&
Jonas Olssonec9e4922018-09-05 09:53:49 +0200569 cmessage[line_start + 1] == kSdpDelimiterEqualChar);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000570}
571
Yves Gerey665174f2018-06-19 15:03:05 +0200572static bool IsLineType(const std::string& line, const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000573 return IsLineType(line, type, 0);
574}
575
Yves Gerey665174f2018-06-19 15:03:05 +0200576static bool GetLineWithType(const std::string& message,
577 size_t* pos,
578 std::string* line,
579 const char type) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000580 if (!IsLineType(message, type, *pos)) {
581 return false;
582 }
583
584 if (!GetLine(message, pos, line))
585 return false;
586
587 return true;
588}
589
590static bool HasAttribute(const std::string& line,
591 const std::string& attribute) {
Johannes Kron211856b2018-09-06 12:12:28 +0200592 if (line.compare(kLinePrefixLength, attribute.size(), attribute) == 0) {
593 // Make sure that the match is not only a partial match. If length of
594 // strings doesn't match, the next character of the line must be ':' or ' '.
595 // This function is also used for media descriptions (e.g., "m=audio 9..."),
596 // hence the need to also allow space in the end.
597 RTC_CHECK_LE(kLinePrefixLength + attribute.size(), line.size());
598 if ((kLinePrefixLength + attribute.size()) == line.size() ||
599 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterColonChar ||
600 line[kLinePrefixLength + attribute.size()] == kSdpDelimiterSpaceChar) {
601 return true;
602 }
603 }
604 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000605}
606
Peter Boström0c4e06b2015-10-07 12:23:21 +0200607static bool AddSsrcLine(uint32_t ssrc_id,
608 const std::string& attribute,
609 const std::string& value,
610 std::string* message) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000611 // RFC 5576
612 // a=ssrc:<ssrc-id> <attribute>:<value>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200613 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000614 InitAttrLine(kAttributeSsrc, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200615 os << kSdpDelimiterColon << ssrc_id << kSdpDelimiterSpace << attribute
616 << kSdpDelimiterColon << value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000617 return AddLine(os.str(), message);
618}
619
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000620// Get value only from <attribute>:<value>.
Yves Gerey665174f2018-06-19 15:03:05 +0200621static bool GetValue(const std::string& message,
622 const std::string& attribute,
623 std::string* value,
624 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000625 std::string leftpart;
Jonas Olssonec9e4922018-09-05 09:53:49 +0200626 if (!rtc::tokenize_first(message, kSdpDelimiterColonChar, &leftpart, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000627 return ParseFailedGetValue(message, attribute, error);
628 }
629 // The left part should end with the expected attribute.
630 if (leftpart.length() < attribute.length() ||
631 leftpart.compare(leftpart.length() - attribute.length(),
632 attribute.length(), attribute) != 0) {
633 return ParseFailedGetValue(message, attribute, error);
634 }
635 return true;
636}
637
638static bool CaseInsensitiveFind(std::string str1, std::string str2) {
Steve Anton64b626b2019-01-28 17:25:26 -0800639 absl::c_transform(str1, str1.begin(), ::tolower);
640 absl::c_transform(str2, str2.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000641 return str1.find(str2) != std::string::npos;
642}
643
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000644template <class T>
645static bool GetValueFromString(const std::string& line,
646 const std::string& s,
647 T* t,
648 SdpParseError* error) {
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +0000649 if (!rtc::FromString(s, t)) {
Jonas Olssonec9e4922018-09-05 09:53:49 +0200650 rtc::StringBuilder description;
wu@webrtc.org5e760e72014-04-02 23:19:09 +0000651 description << "Invalid value: " << s << ".";
652 return ParseFailed(line, description.str(), error);
653 }
654 return true;
655}
656
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000657static bool GetPayloadTypeFromString(const std::string& line,
658 const std::string& s,
659 int* payload_type,
660 SdpParseError* error) {
661 return GetValueFromString(line, s, payload_type, error) &&
Yves Gerey665174f2018-06-19 15:03:05 +0200662 cricket::IsValidRtpPayloadType(*payload_type);
pkasting@chromium.orge9facf82015-02-17 20:36:28 +0000663}
664
Seth Hampson5897a6e2018-04-03 11:16:33 -0700665// Creates a StreamParams track in the case when no SSRC lines are signaled.
666// This is a track that does not contain SSRCs and only contains
667// stream_ids/track_id if it's signaled with a=msid lines.
668void CreateTrackWithNoSsrcs(const std::vector<std::string>& msid_stream_ids,
669 const std::string& msid_track_id,
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800670 const std::vector<RidDescription>& rids,
Seth Hampson5897a6e2018-04-03 11:16:33 -0700671 StreamParamsVec* tracks) {
672 StreamParams track;
Amit Hilbuch6df49d82019-04-15 15:47:21 -0700673 if (msid_track_id.empty() && rids.empty()) {
Seth Hampson5897a6e2018-04-03 11:16:33 -0700674 // We only create an unsignaled track if a=msid lines were signaled.
Amit Hilbuch6df49d82019-04-15 15:47:21 -0700675 RTC_LOG(LS_INFO) << "MSID not signaled, skipping creation of StreamParams";
Seth Hampson5897a6e2018-04-03 11:16:33 -0700676 return;
677 }
678 track.set_stream_ids(msid_stream_ids);
679 track.id = msid_track_id;
Amit Hilbuchc57d5732018-12-11 15:30:11 -0800680 track.set_rids(rids);
Seth Hampson5897a6e2018-04-03 11:16:33 -0700681 tracks->push_back(track);
682}
683
684// Creates the StreamParams tracks, for the case when SSRC lines are signaled.
685// |msid_stream_ids| and |msid_track_id| represent the stream/track ID from the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800686// "a=msid" attribute, if it exists. They are empty if the attribute does not
Seth Hampson5897a6e2018-04-03 11:16:33 -0700687// exist. We prioritize getting stream_ids/track_ids signaled in a=msid lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000688void CreateTracksFromSsrcInfos(const SsrcInfoVec& ssrc_infos,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700689 const std::vector<std::string>& msid_stream_ids,
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800690 const std::string& msid_track_id,
Seth Hampson5b4f0752018-04-02 16:31:36 -0700691 StreamParamsVec* tracks,
692 int msid_signaling) {
nisseede5da42017-01-12 05:15:36 -0800693 RTC_DCHECK(tracks != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700694 for (const SsrcInfo& ssrc_info : ssrc_infos) {
695 if (ssrc_info.cname.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000696 continue;
697 }
698
Seth Hampson5b4f0752018-04-02 16:31:36 -0700699 std::vector<std::string> stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000700 std::string track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700701 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
702 // This is the case with Unified Plan SDP msid signaling.
703 stream_ids = msid_stream_ids;
Tomas Gunnarsson191bf5c2018-03-30 10:44:43 +0000704 track_id = msid_track_id;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700705 } else if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
706 // This is the case with Plan B SDP msid signaling.
Steve Anton4daf66e2018-09-07 14:55:53 -0700707 stream_ids.push_back(ssrc_info.stream_id);
708 track_id = ssrc_info.track_id;
709 } else if (!ssrc_info.mslabel.empty()) {
Seth Hampson5b4f0752018-04-02 16:31:36 -0700710 // Since there's no a=msid or a=ssrc msid signaling, this is a sdp from
711 // an older version of client that doesn't support msid.
712 // In that case, we use the mslabel and label to construct the track.
Steve Anton4daf66e2018-09-07 14:55:53 -0700713 stream_ids.push_back(ssrc_info.mslabel);
714 track_id = ssrc_info.label;
Seth Hampson5b4f0752018-04-02 16:31:36 -0700715 } else {
716 // Since no media streams isn't supported with older SDP signaling, we
717 // use a default a stream id.
718 stream_ids.push_back(kDefaultMsid);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000719 }
Seth Hampson5b4f0752018-04-02 16:31:36 -0700720 // If a track ID wasn't populated from the SSRC attributes OR the
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800721 // msid attribute, use default/random values.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -0800722 if (track_id.empty()) {
723 // TODO(ronghuawu): What should we do if the track id doesn't appear?
724 // Create random string (which will be used as track label later)?
725 track_id = rtc::CreateRandomString(8);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000726 }
727
Steve Anton64b626b2019-01-28 17:25:26 -0800728 auto track_it = absl::c_find_if(
729 *tracks,
Steve Anton4daf66e2018-09-07 14:55:53 -0700730 [track_id](const StreamParams& track) { return track.id == track_id; });
731 if (track_it == tracks->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000732 // If we don't find an existing track, create a new one.
733 tracks->push_back(StreamParams());
Steve Anton4daf66e2018-09-07 14:55:53 -0700734 track_it = tracks->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000735 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700736 StreamParams& track = *track_it;
737 track.add_ssrc(ssrc_info.ssrc_id);
738 track.cname = ssrc_info.cname;
739 track.set_stream_ids(stream_ids);
740 track.id = track_id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000741 }
742}
743
Seth Hampson845e8782018-03-02 11:34:10 -0800744void GetMediaStreamIds(const ContentInfo* content,
745 std::set<std::string>* labels) {
Steve Antonb1c1de12017-12-21 15:14:30 -0800746 for (const StreamParams& stream_params :
747 content->media_description()->streams()) {
Seth Hampson845e8782018-03-02 11:34:10 -0800748 for (const std::string& stream_id : stream_params.stream_ids()) {
749 labels->insert(stream_id);
Steve Anton5a26a3a2018-02-28 11:38:47 -0800750 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000751 }
752}
753
754// RFC 5245
755// It is RECOMMENDED that default candidates be chosen based on the
756// likelihood of those candidates to work with the peer that is being
757// contacted. It is RECOMMENDED that relayed > reflexive > host.
758static const int kPreferenceUnknown = 0;
759static const int kPreferenceHost = 1;
760static const int kPreferenceReflexive = 2;
761static const int kPreferenceRelayed = 3;
762
763static int GetCandidatePreferenceFromType(const std::string& type) {
764 int preference = kPreferenceUnknown;
765 if (type == cricket::LOCAL_PORT_TYPE) {
766 preference = kPreferenceHost;
767 } else if (type == cricket::STUN_PORT_TYPE) {
768 preference = kPreferenceReflexive;
769 } else if (type == cricket::RELAY_PORT_TYPE) {
770 preference = kPreferenceRelayed;
771 } else {
nissec80e7412017-01-11 05:56:46 -0800772 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000773 }
774 return preference;
775}
776
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000777// Get ip and port of the default destination from the |candidates| with the
778// given value of |component_id|. The default candidate should be the one most
779// likely to work, typically IPv4 relay.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000780// RFC 5245
781// The value of |component_id| currently supported are 1 (RTP) and 2 (RTCP).
Steve Anton36b29d12017-10-30 09:57:42 -0700782// TODO(deadbeef): Decide the default destination in webrtcsession and
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000783// pass it down via SessionDescription.
Yves Gerey665174f2018-06-19 15:03:05 +0200784static void GetDefaultDestination(const std::vector<Candidate>& candidates,
785 int component_id,
786 std::string* port,
787 std::string* ip,
788 std::string* addr_type) {
perkj@webrtc.orgd105cc82014-11-07 11:22:06 +0000789 *addr_type = kConnectionIpv4Addrtype;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000790 *port = kDummyPort;
791 *ip = kDummyAddress;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000792 int current_preference = kPreferenceUnknown;
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000793 int current_family = AF_UNSPEC;
Steve Anton4daf66e2018-09-07 14:55:53 -0700794 for (const Candidate& candidate : candidates) {
795 if (candidate.component() != component_id) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000796 continue;
797 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000798 // Default destination should be UDP only.
Steve Anton4daf66e2018-09-07 14:55:53 -0700799 if (candidate.protocol() != cricket::UDP_PROTOCOL_NAME) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000800 continue;
801 }
Steve Anton4daf66e2018-09-07 14:55:53 -0700802 const int preference = GetCandidatePreferenceFromType(candidate.type());
803 const int family = candidate.address().ipaddr().family();
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000804 // See if this candidate is more preferable then the current one if it's the
805 // same family. Or if the current family is IPv4 already so we could safely
806 // ignore all IPv6 ones. WebRTC bug 4269.
807 // http://code.google.com/p/webrtc/issues/detail?id=4269
808 if ((preference <= current_preference && current_family == family) ||
809 (current_family == AF_INET && family == AF_INET6)) {
810 continue;
811 }
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000812 if (family == AF_INET) {
813 addr_type->assign(kConnectionIpv4Addrtype);
814 } else if (family == AF_INET6) {
815 addr_type->assign(kConnectionIpv6Addrtype);
816 }
guoweis@webrtc.org57ac2c82015-02-06 00:45:13 +0000817 current_preference = preference;
818 current_family = family;
Steve Anton4daf66e2018-09-07 14:55:53 -0700819 *port = candidate.address().PortAsString();
820 *ip = candidate.address().ipaddr().ToString();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000821 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000822}
823
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000824// Gets "a=rtcp" line if found default RTCP candidate from |candidates|.
825static std::string GetRtcpLine(const std::vector<Candidate>& candidates) {
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000826 std::string rtcp_line, rtcp_port, rtcp_ip, addr_type;
Yves Gerey665174f2018-06-19 15:03:05 +0200827 GetDefaultDestination(candidates, ICE_CANDIDATE_COMPONENT_RTCP, &rtcp_port,
828 &rtcp_ip, &addr_type);
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000829 // Found default RTCP candidate.
830 // RFC 5245
831 // If the agent is utilizing RTCP, it MUST encode the RTCP candidate
832 // using the a=rtcp attribute as defined in RFC 3605.
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000833
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000834 // RFC 3605
835 // rtcp-attribute = "a=rtcp:" port [nettype space addrtype space
836 // connection-address] CRLF
Jonas Olssonec9e4922018-09-05 09:53:49 +0200837 rtc::StringBuilder os;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000838 InitAttrLine(kAttributeRtcp, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200839 os << kSdpDelimiterColon << rtcp_port << " " << kConnectionNettype << " "
840 << addr_type << " " << rtcp_ip;
pthatcher@webrtc.orgc9d6d142014-10-23 23:37:22 +0000841 rtcp_line = os.str();
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000842 return rtcp_line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000843}
844
845// Get candidates according to the mline index from SessionDescriptionInterface.
846static void GetCandidatesByMindex(const SessionDescriptionInterface& desci,
847 int mline_index,
848 std::vector<Candidate>* candidates) {
849 if (!candidates) {
850 return;
851 }
852 const IceCandidateCollection* cc = desci.candidates(mline_index);
853 for (size_t i = 0; i < cc->count(); ++i) {
854 const IceCandidateInterface* candidate = cc->at(i);
855 candidates->push_back(candidate->candidate());
856 }
857}
858
deadbeef90f1e1e2017-02-10 12:35:05 -0800859static bool IsValidPort(int port) {
860 return port >= 0 && port <= 65535;
861}
862
Steve Antone831b8c2018-02-01 12:22:16 -0800863std::string SdpSerialize(const JsepSessionDescription& jdesc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000864 const cricket::SessionDescription* desc = jdesc.description();
865 if (!desc) {
866 return "";
867 }
868
869 std::string message;
870
871 // Session Description.
872 AddLine(kSessionVersion, &message);
873 // Session Origin
874 // RFC 4566
875 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
876 // <unicast-address>
Jonas Olssonec9e4922018-09-05 09:53:49 +0200877 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000878 InitLine(kLineTypeOrigin, kSessionOriginUsername, &os);
Yves Gerey665174f2018-06-19 15:03:05 +0200879 const std::string& session_id =
880 jdesc.session_id().empty() ? kSessionOriginSessionId : jdesc.session_id();
881 const std::string& session_version = jdesc.session_version().empty()
882 ? kSessionOriginSessionVersion
883 : jdesc.session_version();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000884 os << " " << session_id << " " << session_version << " "
885 << kSessionOriginNettype << " " << kSessionOriginAddrtype << " "
886 << kSessionOriginAddress;
887 AddLine(os.str(), &message);
888 AddLine(kSessionName, &message);
889
890 // Time Description.
891 AddLine(kTimeDescription, &message);
892
Piotr (Peter) Slatalab1ae10b2019-03-01 11:14:05 -0800893 for (const cricket::SessionDescription::MediaTransportSetting& settings :
894 desc->MediaTransportSettings()) {
895 AddMediaTransportLine(settings, &message);
896 }
897
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000898 // Group
899 if (desc->HasGroup(cricket::GROUP_TYPE_BUNDLE)) {
900 std::string group_line = kAttrGroup;
901 const cricket::ContentGroup* group =
902 desc->GetGroupByName(cricket::GROUP_TYPE_BUNDLE);
nisseede5da42017-01-12 05:15:36 -0800903 RTC_DCHECK(group != NULL);
Steve Anton4daf66e2018-09-07 14:55:53 -0700904 for (const std::string& content_name : group->content_names()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000905 group_line.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -0700906 group_line.append(content_name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000907 }
908 AddLine(group_line, &message);
909 }
910
Johannes Kron0854eb62018-10-10 22:33:20 +0200911 // Mixed one- and two-byte header extension.
Johannes Kron9581bc42018-10-23 10:17:39 +0200912 if (desc->extmap_allow_mixed()) {
Johannes Kron0854eb62018-10-10 22:33:20 +0200913 InitAttrLine(kAttributeExtmapAllowMixed, &os);
914 AddLine(os.str(), &message);
915 }
916
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000917 // MediaStream semantics
918 InitAttrLine(kAttributeMsidSemantics, &os);
919 os << kSdpDelimiterColon << " " << kMediaStreamSemantic;
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000920
Seth Hampson845e8782018-03-02 11:34:10 -0800921 std::set<std::string> media_stream_ids;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000922 const ContentInfo* audio_content = GetFirstAudioContent(desc);
923 if (audio_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800924 GetMediaStreamIds(audio_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000925
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000926 const ContentInfo* video_content = GetFirstVideoContent(desc);
927 if (video_content)
Seth Hampson845e8782018-03-02 11:34:10 -0800928 GetMediaStreamIds(video_content, &media_stream_ids);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000929
Steve Anton4daf66e2018-09-07 14:55:53 -0700930 for (const std::string& id : media_stream_ids) {
931 os << " " << id;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000932 }
933 AddLine(os.str(), &message);
934
Taylor Brandstetter2f65ec52018-05-24 11:37:28 -0700935 // a=ice-lite
936 //
937 // TODO(deadbeef): It's weird that we need to iterate TransportInfos for
938 // this, when it's a session-level attribute. It really should be moved to a
939 // session-level structure like SessionDescription.
940 for (const cricket::TransportInfo& transport : desc->transport_infos()) {
941 if (transport.description.ice_mode == cricket::ICEMODE_LITE) {
942 InitAttrLine(kAttributeIceLite, &os);
943 AddLine(os.str(), &message);
944 break;
945 }
946 }
947
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000948 // Preserve the order of the media contents.
949 int mline_index = -1;
Steve Anton4daf66e2018-09-07 14:55:53 -0700950 for (const ContentInfo& content : desc->contents()) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +0000951 std::vector<Candidate> candidates;
952 GetCandidatesByMindex(jdesc, ++mline_index, &candidates);
Steve Anton4daf66e2018-09-07 14:55:53 -0700953 BuildMediaDescription(&content, desc->GetTransportInfoByName(content.name),
954 content.media_description()->type(), candidates,
955 desc->msid_signaling(), &message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000956 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000957 return message;
958}
959
960// Serializes the passed in IceCandidateInterface to a SDP string.
961// candidate - The candidate to be serialized.
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700962std::string SdpSerializeCandidate(const IceCandidateInterface& candidate) {
963 return SdpSerializeCandidate(candidate.candidate());
964}
965
966// Serializes a cricket Candidate.
967std::string SdpSerializeCandidate(const cricket::Candidate& candidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000968 std::string message;
Honghai Zhang7fb69db2016-03-14 11:59:18 -0700969 std::vector<cricket::Candidate> candidates(1, candidate);
honghaiza54a0802015-12-16 18:37:23 -0800970 BuildCandidate(candidates, true, &message);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000971 // From WebRTC draft section 4.8.1.1 candidate-attribute will be
972 // just candidate:<candidate> not a=candidate:<blah>CRLF
nisseede5da42017-01-12 05:15:36 -0800973 RTC_DCHECK(message.find("a=") == 0);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000974 message.erase(0, 2);
nisseede5da42017-01-12 05:15:36 -0800975 RTC_DCHECK(message.find(kLineBreak) == message.size() - 2);
wu@webrtc.orgec9f5fb2014-06-24 17:05:10 +0000976 message.resize(message.size() - 2);
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000977 return message;
978}
979
980bool SdpDeserialize(const std::string& message,
981 JsepSessionDescription* jdesc,
982 SdpParseError* error) {
983 std::string session_id;
984 std::string session_version;
Peter Thatcher7cbd1882015-09-17 18:54:52 -0700985 TransportDescription session_td("", "");
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000986 RtpHeaderExtensions session_extmaps;
zhihuang38989e52017-03-21 11:04:53 -0700987 rtc::SocketAddress session_connection_addr;
Steve Anton5a1de872018-12-18 11:25:55 -0800988 auto desc = absl::make_unique<cricket::SessionDescription>();
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000989 size_t current_pos = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000990
991 // Session Description
992 if (!ParseSessionDescription(message, &current_pos, &session_id,
deadbeefc80741f2015-10-22 13:14:45 -0700993 &session_version, &session_td, &session_extmaps,
Steve Anton5a1de872018-12-18 11:25:55 -0800994 &session_connection_addr, desc.get(), error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +0000995 return false;
996 }
997
998 // Media Description
Steve Anton5a1de872018-12-18 11:25:55 -0800999 std::vector<std::unique_ptr<JsepIceCandidate>> candidates;
deadbeefc80741f2015-10-22 13:14:45 -07001000 if (!ParseMediaDescription(message, session_td, session_extmaps, &current_pos,
Steve Anton5a1de872018-12-18 11:25:55 -08001001 session_connection_addr, desc.get(), &candidates,
zhihuang38989e52017-03-21 11:04:53 -07001002 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001003 return false;
1004 }
1005
Harald Alvestrand4d7160e2019-04-12 07:01:29 +02001006 jdesc->Initialize(std::move(desc), session_id, session_version);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001007
Steve Anton5a1de872018-12-18 11:25:55 -08001008 for (const auto& candidate : candidates) {
1009 jdesc->AddCandidate(candidate.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001010 }
1011 return true;
1012}
1013
1014bool SdpDeserializeCandidate(const std::string& message,
1015 JsepIceCandidate* jcandidate,
1016 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08001017 RTC_DCHECK(jcandidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001018 Candidate candidate;
1019 if (!ParseCandidate(message, &candidate, error, true)) {
1020 return false;
1021 }
1022 jcandidate->SetCandidate(candidate);
1023 return true;
1024}
1025
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001026bool SdpDeserializeCandidate(const std::string& transport_name,
1027 const std::string& message,
1028 cricket::Candidate* candidate,
1029 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08001030 RTC_DCHECK(candidate != nullptr);
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001031 if (!ParseCandidate(message, candidate, error, true)) {
1032 return false;
1033 }
1034 candidate->set_transport_name(transport_name);
1035 return true;
1036}
1037
Yves Gerey665174f2018-06-19 15:03:05 +02001038bool ParseCandidate(const std::string& message,
1039 Candidate* candidate,
1040 SdpParseError* error,
1041 bool is_raw) {
nisseede5da42017-01-12 05:15:36 -08001042 RTC_DCHECK(candidate != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001043
1044 // Get the first line from |message|.
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001045 std::string first_line = message;
1046 size_t pos = 0;
1047 GetLine(message, &pos, &first_line);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001048
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001049 // Makes sure |message| contains only one line.
1050 if (message.size() > first_line.size()) {
1051 std::string left, right;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001052 if (rtc::tokenize_first(message, kNewLineChar, &left, &right) &&
Donald Curtis0e07f922015-05-15 09:21:23 -07001053 !right.empty()) {
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001054 return ParseFailed(message, 0, "Expect one line only", error);
1055 }
1056 }
1057
1058 // From WebRTC draft section 4.8.1.1 candidate-attribute should be
1059 // candidate:<candidate> when trickled, but we still support
1060 // a=candidate:<blah>CRLF for backward compatibility and for parsing a line
1061 // from the SDP.
1062 if (IsLineType(first_line, kLineTypeAttributes)) {
1063 first_line = first_line.substr(kLinePrefixLength);
1064 }
1065
1066 std::string attribute_candidate;
1067 std::string candidate_value;
1068
1069 // |first_line| must be in the form of "candidate:<value>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02001070 if (!rtc::tokenize_first(first_line, kSdpDelimiterColonChar,
1071 &attribute_candidate, &candidate_value) ||
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001072 attribute_candidate != kAttributeCandidate) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001073 if (is_raw) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001074 rtc::StringBuilder description;
Yves Gerey665174f2018-06-19 15:03:05 +02001075 description << "Expect line: " << kAttributeCandidate << ":"
1076 << "<candidate-str>";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001077 return ParseFailed(first_line, 0, description.str(), error);
1078 } else {
1079 return ParseFailedExpectLine(first_line, 0, kLineTypeAttributes,
1080 kAttributeCandidate, error);
1081 }
1082 }
1083
1084 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001085 rtc::split(candidate_value, kSdpDelimiterSpaceChar, &fields);
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001086
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001087 // RFC 5245
1088 // a=candidate:<foundation> <component-id> <transport> <priority>
1089 // <connection-address> <port> typ <candidate-types>
1090 // [raddr <connection-address>] [rport <port>]
1091 // *(SP extension-att-name SP extension-att-value)
1092 const size_t expected_min_fields = 8;
1093 if (fields.size() < expected_min_fields ||
1094 (fields[6] != kAttributeCandidateTyp)) {
1095 return ParseFailedExpectMinFieldNum(first_line, expected_min_fields, error);
1096 }
jbauch083b73f2015-07-16 02:46:32 -07001097 const std::string& foundation = fields[0];
jiayl@webrtc.org7ec3f9f2014-08-08 23:09:15 +00001098
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001099 int component_id = 0;
1100 if (!GetValueFromString(first_line, fields[1], &component_id, error)) {
1101 return false;
1102 }
jbauch083b73f2015-07-16 02:46:32 -07001103 const std::string& transport = fields[2];
Peter Boström0c4e06b2015-10-07 12:23:21 +02001104 uint32_t priority = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001105 if (!GetValueFromString(first_line, fields[3], &priority, error)) {
1106 return false;
1107 }
jbauch083b73f2015-07-16 02:46:32 -07001108 const std::string& connection_address = fields[4];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001109 int port = 0;
1110 if (!GetValueFromString(first_line, fields[5], &port, error)) {
1111 return false;
1112 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001113 if (!IsValidPort(port)) {
1114 return ParseFailed(first_line, "Invalid port number.", error);
1115 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001116 SocketAddress address(connection_address, port);
1117
1118 cricket::ProtocolType protocol;
hnslb68cc752016-12-13 10:33:41 -08001119 if (!StringToProto(transport.c_str(), &protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001120 return ParseFailed(first_line, "Unsupported transport type.", error);
1121 }
hnslb68cc752016-12-13 10:33:41 -08001122 switch (protocol) {
1123 case cricket::PROTO_UDP:
1124 case cricket::PROTO_TCP:
1125 case cricket::PROTO_SSLTCP:
1126 // Supported protocol.
1127 break;
1128 default:
1129 return ParseFailed(first_line, "Unsupported transport type.", error);
1130 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001131
1132 std::string candidate_type;
jbauch083b73f2015-07-16 02:46:32 -07001133 const std::string& type = fields[7];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001134 if (type == kCandidateHost) {
1135 candidate_type = cricket::LOCAL_PORT_TYPE;
1136 } else if (type == kCandidateSrflx) {
1137 candidate_type = cricket::STUN_PORT_TYPE;
1138 } else if (type == kCandidateRelay) {
1139 candidate_type = cricket::RELAY_PORT_TYPE;
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001140 } else if (type == kCandidatePrflx) {
1141 candidate_type = cricket::PRFLX_PORT_TYPE;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001142 } else {
1143 return ParseFailed(first_line, "Unsupported candidate type.", error);
1144 }
1145
1146 size_t current_position = expected_min_fields;
1147 SocketAddress related_address;
1148 // The 2 optional fields for related address
1149 // [raddr <connection-address>] [rport <port>]
1150 if (fields.size() >= (current_position + 2) &&
1151 fields[current_position] == kAttributeCandidateRaddr) {
1152 related_address.SetIP(fields[++current_position]);
1153 ++current_position;
1154 }
1155 if (fields.size() >= (current_position + 2) &&
1156 fields[current_position] == kAttributeCandidateRport) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001157 int port = 0;
Yves Gerey665174f2018-06-19 15:03:05 +02001158 if (!GetValueFromString(first_line, fields[++current_position], &port,
1159 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001160 return false;
1161 }
deadbeef90f1e1e2017-02-10 12:35:05 -08001162 if (!IsValidPort(port)) {
1163 return ParseFailed(first_line, "Invalid port number.", error);
1164 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001165 related_address.SetPort(port);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001166 ++current_position;
1167 }
1168
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001169 // If this is a TCP candidate, it has additional extension as defined in
1170 // RFC 6544.
1171 std::string tcptype;
1172 if (fields.size() >= (current_position + 2) &&
1173 fields[current_position] == kTcpCandidateType) {
1174 tcptype = fields[++current_position];
1175 ++current_position;
1176
1177 if (tcptype != cricket::TCPTYPE_ACTIVE_STR &&
1178 tcptype != cricket::TCPTYPE_PASSIVE_STR &&
1179 tcptype != cricket::TCPTYPE_SIMOPEN_STR) {
1180 return ParseFailed(first_line, "Invalid TCP candidate type.", error);
1181 }
1182
1183 if (protocol != cricket::PROTO_TCP) {
1184 return ParseFailed(first_line, "Invalid non-TCP candidate", error);
1185 }
1186 }
1187
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001188 // Extension
honghaiza54a0802015-12-16 18:37:23 -08001189 // Though non-standard, we support the ICE ufrag and pwd being signaled on
1190 // the candidate to avoid issues with confusing which generation a candidate
1191 // belongs to when trickling multiple generations at the same time.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001192 std::string username;
1193 std::string password;
Peter Boström0c4e06b2015-10-07 12:23:21 +02001194 uint32_t generation = 0;
honghaiza0c44ea2016-03-23 16:07:48 -07001195 uint16_t network_id = 0;
1196 uint16_t network_cost = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001197 for (size_t i = current_position; i + 1 < fields.size(); ++i) {
1198 // RFC 5245
1199 // *(SP extension-att-name SP extension-att-value)
1200 if (fields[i] == kAttributeCandidateGeneration) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001201 if (!GetValueFromString(first_line, fields[++i], &generation, error)) {
1202 return false;
1203 }
honghaiza54a0802015-12-16 18:37:23 -08001204 } else if (fields[i] == kAttributeCandidateUfrag) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001205 username = fields[++i];
honghaiza54a0802015-12-16 18:37:23 -08001206 } else if (fields[i] == kAttributeCandidatePwd) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001207 password = fields[++i];
honghaiza0c44ea2016-03-23 16:07:48 -07001208 } else if (fields[i] == kAttributeCandidateNetworkId) {
1209 if (!GetValueFromString(first_line, fields[++i], &network_id, error)) {
1210 return false;
1211 }
honghaize1a0c942016-02-16 14:54:56 -08001212 } else if (fields[i] == kAttributeCandidateNetworkCost) {
1213 if (!GetValueFromString(first_line, fields[++i], &network_cost, error)) {
1214 return false;
1215 }
Honghai Zhang351d77b2016-05-20 15:08:29 -07001216 network_cost = std::min(network_cost, rtc::kNetworkCostMax);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001217 } else {
1218 // Skip the unknown extension.
1219 ++i;
1220 }
1221 }
1222
guoweis@webrtc.org61c12472015-01-15 06:53:07 +00001223 *candidate = Candidate(component_id, cricket::ProtoToString(protocol),
guoweis@webrtc.org950c5182014-12-16 23:01:31 +00001224 address, priority, username, password, candidate_type,
honghaiza0c44ea2016-03-23 16:07:48 -07001225 generation, foundation, network_id, network_cost);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001226 candidate->set_related_address(related_address);
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00001227 candidate->set_tcptype(tcptype);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001228 return true;
1229}
1230
1231bool ParseIceOptions(const std::string& line,
1232 std::vector<std::string>* transport_options,
1233 SdpParseError* error) {
1234 std::string ice_options;
1235 if (!GetValue(line, kAttributeIceOption, &ice_options, error)) {
1236 return false;
1237 }
1238 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001239 rtc::split(ice_options, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001240 for (size_t i = 0; i < fields.size(); ++i) {
1241 transport_options->push_back(fields[i]);
1242 }
1243 return true;
1244}
1245
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001246bool ParseSctpPort(const std::string& line,
1247 int* sctp_port,
1248 SdpParseError* error) {
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02001249 // draft-ietf-mmusic-sctp-sdp-26
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001250 // a=sctp-port
1251 std::vector<std::string> fields;
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001252 const size_t expected_min_fields = 2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001253 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
lally69f57602015-10-08 10:15:04 -07001254 if (fields.size() < expected_min_fields) {
1255 fields.resize(0);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001256 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
lally69f57602015-10-08 10:15:04 -07001257 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001258 if (fields.size() < expected_min_fields) {
1259 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1260 }
1261 if (!rtc::FromString(fields[1], sctp_port)) {
lally69f57602015-10-08 10:15:04 -07001262 return ParseFailed(line, "Invalid sctp port value.", error);
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00001263 }
1264 return true;
1265}
1266
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02001267bool ParseSctpMaxMessageSize(const std::string& line,
1268 int* max_message_size,
1269 SdpParseError* error) {
1270 // draft-ietf-mmusic-sctp-sdp-26
1271 // a=max-message-size:199999
1272 std::vector<std::string> fields;
1273 const size_t expected_min_fields = 2;
1274 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
1275 if (fields.size() < expected_min_fields) {
1276 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1277 }
1278 if (!rtc::FromString(fields[1], max_message_size)) {
1279 return ParseFailed(line, "Invalid SCTP max message size.", error);
1280 }
1281 return true;
1282}
1283
isheriff6f8d6862016-05-26 11:24:55 -07001284bool ParseExtmap(const std::string& line,
1285 RtpExtension* extmap,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001286 SdpParseError* error) {
1287 // RFC 5285
1288 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1289 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001290 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001291 const size_t expected_min_fields = 2;
1292 if (fields.size() < expected_min_fields) {
1293 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
1294 }
1295 std::string uri = fields[1];
1296
1297 std::string value_direction;
1298 if (!GetValue(fields[0], kAttributeExtmap, &value_direction, error)) {
1299 return false;
1300 }
1301 std::vector<std::string> sub_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001302 rtc::split(value_direction, kSdpDelimiterSlashChar, &sub_fields);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001303 int value = 0;
1304 if (!GetValueFromString(line, sub_fields[0], &value, error)) {
1305 return false;
1306 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001307
jbauch5869f502017-06-29 12:31:36 -07001308 bool encrypted = false;
1309 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1310 // RFC 6904
Steve Anton36b29d12017-10-30 09:57:42 -07001311 // a=extmap:<value["/"<direction>] urn:ietf:params:rtp-hdrext:encrypt <URI>
1312 // <extensionattributes>
jbauch5869f502017-06-29 12:31:36 -07001313 const size_t expected_min_fields_encrypted = expected_min_fields + 1;
1314 if (fields.size() < expected_min_fields_encrypted) {
1315 return ParseFailedExpectMinFieldNum(line, expected_min_fields_encrypted,
Yves Gerey665174f2018-06-19 15:03:05 +02001316 error);
jbauch5869f502017-06-29 12:31:36 -07001317 }
1318
1319 encrypted = true;
1320 uri = fields[2];
1321 if (uri == RtpExtension::kEncryptHeaderExtensionsUri) {
1322 return ParseFailed(line, "Recursive encrypted header.", error);
1323 }
1324 }
1325
1326 *extmap = RtpExtension(uri, value, encrypted);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001327 return true;
1328}
1329
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +02001330static void BuildSctpContentAttributes(
1331 std::string* message,
1332 const cricket::SctpDataContentDescription* data_desc) {
1333 rtc::StringBuilder os;
1334 if (data_desc->use_sctpmap()) {
1335 // draft-ietf-mmusic-sctp-sdp-04
1336 // a=sctpmap:sctpmap-number protocol [streams]
1337 rtc::StringBuilder os;
1338 InitAttrLine(kAttributeSctpmap, &os);
1339 os << kSdpDelimiterColon << data_desc->port() << kSdpDelimiterSpace
1340 << kDefaultSctpmapProtocol << kSdpDelimiterSpace
1341 << cricket::kMaxSctpStreams;
1342 AddLine(os.str(), message);
1343 } else {
1344 // draft-ietf-mmusic-sctp-sdp-23
1345 // a=sctp-port:<port>
1346 InitAttrLine(kAttributeSctpPort, &os);
1347 os << kSdpDelimiterColon << data_desc->port();
1348 AddLine(os.str(), message);
1349 if (data_desc->max_message_size() != kDefaultSctpMaxMessageSize) {
1350 InitAttrLine(kAttributeMaxMessageSize, &os);
1351 os << kSdpDelimiterColon << data_desc->max_message_size();
1352 AddLine(os.str(), message);
1353 }
1354 }
1355}
1356
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001357void BuildMediaDescription(const ContentInfo* content_info,
1358 const TransportInfo* transport_info,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001359 const cricket::MediaType media_type,
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001360 const std::vector<Candidate>& candidates,
Steve Antone831b8c2018-02-01 12:22:16 -08001361 int msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001362 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001363 RTC_DCHECK(message != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001364 if (content_info == NULL || message == NULL) {
1365 return;
1366 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001367 rtc::StringBuilder os;
Steve Antonb1c1de12017-12-21 15:14:30 -08001368 const MediaContentDescription* media_desc = content_info->media_description();
1369 RTC_DCHECK(media_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001370
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001371 // RFC 4566
1372 // m=<media> <port> <proto> <fmt>
1373 // fmt is a list of payload type numbers that MAY be used in the session.
1374 const char* type = NULL;
1375 if (media_type == cricket::MEDIA_TYPE_AUDIO)
1376 type = kMediaTypeAudio;
1377 else if (media_type == cricket::MEDIA_TYPE_VIDEO)
1378 type = kMediaTypeVideo;
1379 else if (media_type == cricket::MEDIA_TYPE_DATA)
1380 type = kMediaTypeData;
1381 else
nissec80e7412017-01-11 05:56:46 -08001382 RTC_NOTREACHED();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001383
1384 std::string fmt;
1385 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001386 const VideoContentDescription* video_desc = media_desc->as_video();
Steve Anton4daf66e2018-09-07 14:55:53 -07001387 for (const cricket::VideoCodec& codec : video_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001388 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001389 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001390 }
1391 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08001392 const AudioContentDescription* audio_desc = media_desc->as_audio();
Steve Anton4daf66e2018-09-07 14:55:53 -07001393 for (const cricket::AudioCodec& codec : audio_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001394 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001395 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001396 }
1397 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001398 const cricket::SctpDataContentDescription* sctp_data_desc =
1399 media_desc->as_sctp();
1400 if (sctp_data_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001401 fmt.append(" ");
jiayl@webrtc.org9c16c392014-05-01 18:30:30 +00001402
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001403 if (sctp_data_desc->use_sctpmap()) {
1404 fmt.append(rtc::ToString(sctp_data_desc->port()));
zstein4b2e0822017-02-17 19:48:38 -08001405 } else {
1406 fmt.append(kDefaultSctpmapProtocol);
1407 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001408 } else {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001409 const RtpDataContentDescription* rtp_data_desc =
1410 media_desc->as_rtp_data();
1411 for (const cricket::RtpDataCodec& codec : rtp_data_desc->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001412 fmt.append(" ");
Steve Anton4daf66e2018-09-07 14:55:53 -07001413 fmt.append(rtc::ToString(codec.id));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001414 }
1415 }
1416 }
1417 // The fmt must never be empty. If no codecs are found, set the fmt attribute
1418 // to 0.
1419 if (fmt.empty()) {
1420 fmt = " 0";
1421 }
1422
deadbeef25ed4352016-12-12 18:37:36 -08001423 // The port number in the m line will be updated later when associated with
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001424 // the candidates.
deadbeef25ed4352016-12-12 18:37:36 -08001425 //
1426 // A port value of 0 indicates that the m= section is rejected.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001427 // RFC 3264
1428 // To reject an offered stream, the port number in the corresponding stream in
1429 // the answer MUST be set to zero.
deadbeef25ed4352016-12-12 18:37:36 -08001430 //
1431 // However, the BUNDLE draft adds a new meaning to port zero, when used along
1432 // with a=bundle-only.
zhihuang38989e52017-03-21 11:04:53 -07001433 std::string port = kDummyPort;
1434 if (content_info->rejected || content_info->bundle_only) {
1435 port = kMediaPortRejected;
1436 } else if (!media_desc->connection_address().IsNil()) {
1437 port = rtc::ToString(media_desc->connection_address().port());
1438 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001439
Yves Gerey665174f2018-06-19 15:03:05 +02001440 rtc::SSLFingerprint* fp =
1441 (transport_info) ? transport_info->description.identity_fingerprint.get()
1442 : NULL;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001443
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001444 // Add the m and c lines.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001445 InitLine(kLineTypeMedia, type, &os);
1446 os << " " << port << " " << media_desc->protocol() << fmt;
zhihuang38989e52017-03-21 11:04:53 -07001447 AddLine(os.str(), message);
1448
1449 InitLine(kLineTypeConnection, kConnectionNettype, &os);
1450 if (media_desc->connection_address().IsNil()) {
1451 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
1452 } else if (media_desc->connection_address().family() == AF_INET) {
1453 os << " " << kConnectionIpv4Addrtype << " "
1454 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 12:53:06 -08001455 } else if (media_desc->connection_address().family() == AF_INET6) {
zhihuang38989e52017-03-21 11:04:53 -07001456 os << " " << kConnectionIpv6Addrtype << " "
1457 << media_desc->connection_address().ipaddr().ToString();
Qingsi Wang56991422019-02-08 12:53:06 -08001458 } else if (!media_desc->connection_address().hostname().empty()) {
1459 // For hostname candidates, we use c=IN IP4 <hostname>.
1460 os << " " << kConnectionIpv4Addrtype << " "
1461 << media_desc->connection_address().hostname();
1462 } else {
1463 os << " " << kConnectionIpv4Addrtype << " " << kDummyAddress;
zhihuang38989e52017-03-21 11:04:53 -07001464 }
1465 AddLine(os.str(), message);
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001466
1467 // RFC 4566
1468 // b=AS:<bandwidth>
Peter Thatcherc0c3a862015-06-24 15:31:25 -07001469 if (media_desc->bandwidth() >= 1000) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001470 InitLine(kLineTypeSessionBandwidth, kApplicationSpecificMaximum, &os);
1471 os << kSdpDelimiterColon << (media_desc->bandwidth() / 1000);
1472 AddLine(os.str(), message);
1473 }
1474
deadbeef25ed4352016-12-12 18:37:36 -08001475 // Add the a=bundle-only line.
1476 if (content_info->bundle_only) {
1477 InitAttrLine(kAttributeBundleOnly, &os);
1478 AddLine(os.str(), message);
1479 }
1480
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001481 // Add the a=rtcp line.
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001482 if (cricket::IsRtpProtocol(media_desc->protocol())) {
wu@webrtc.org4c3e9912014-07-16 21:03:13 +00001483 std::string rtcp_line = GetRtcpLine(candidates);
1484 if (!rtcp_line.empty()) {
1485 AddLine(rtcp_line, message);
1486 }
1487 }
1488
honghaiza54a0802015-12-16 18:37:23 -08001489 // Build the a=candidate lines. We don't include ufrag and pwd in the
1490 // candidates in the SDP to avoid redundancy.
1491 BuildCandidate(candidates, false, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001492
1493 // Use the transport_info to build the media level ice-ufrag and ice-pwd.
1494 if (transport_info) {
1495 // RFC 5245
1496 // ice-pwd-att = "ice-pwd" ":" password
1497 // ice-ufrag-att = "ice-ufrag" ":" ufrag
1498 // ice-ufrag
deadbeef3f7219b2015-12-28 15:17:14 -08001499 if (!transport_info->description.ice_ufrag.empty()) {
1500 InitAttrLine(kAttributeIceUfrag, &os);
1501 os << kSdpDelimiterColon << transport_info->description.ice_ufrag;
1502 AddLine(os.str(), message);
1503 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001504 // ice-pwd
deadbeef3f7219b2015-12-28 15:17:14 -08001505 if (!transport_info->description.ice_pwd.empty()) {
1506 InitAttrLine(kAttributeIcePwd, &os);
1507 os << kSdpDelimiterColon << transport_info->description.ice_pwd;
1508 AddLine(os.str(), message);
1509 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001510
1511 // draft-petithuguenin-mmusic-ice-attributes-level-03
1512 BuildIceOptions(transport_info->description.transport_options, message);
1513
1514 // RFC 4572
1515 // fingerprint-attribute =
1516 // "fingerprint" ":" hash-func SP fingerprint
1517 if (fp) {
1518 // Insert the fingerprint attribute.
1519 InitAttrLine(kAttributeFingerprint, &os);
Yves Gerey665174f2018-06-19 15:03:05 +02001520 os << kSdpDelimiterColon << fp->algorithm << kSdpDelimiterSpace
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001521 << fp->GetRfc4572Fingerprint();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001522 AddLine(os.str(), message);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001523
1524 // Inserting setup attribute.
1525 if (transport_info->description.connection_role !=
Yves Gerey665174f2018-06-19 15:03:05 +02001526 cricket::CONNECTIONROLE_NONE) {
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001527 // Making sure we are not using "passive" mode.
1528 cricket::ConnectionRole role =
1529 transport_info->description.connection_role;
mallinath@webrtc.org19f27e62013-10-13 17:18:27 +00001530 std::string dtls_role_str;
nissec16fa5e2017-02-07 07:18:43 -08001531 const bool success =
1532 cricket::ConnectionRoleToString(role, &dtls_role_str);
1533 RTC_DCHECK(success);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001534 InitAttrLine(kAttributeSetup, &os);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00001535 os << kSdpDelimiterColon << dtls_role_str;
1536 AddLine(os.str(), message);
1537 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001538 }
1539 }
1540
1541 // RFC 3388
1542 // mid-attribute = "a=mid:" identification-tag
1543 // identification-tag = token
1544 // Use the content name as the mid identification-tag.
1545 InitAttrLine(kAttributeMid, &os);
1546 os << kSdpDelimiterColon << content_info->name;
1547 AddLine(os.str(), message);
1548
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001549 if (cricket::IsDtlsSctp(media_desc->protocol())) {
1550 const cricket::SctpDataContentDescription* data_desc =
1551 media_desc->as_sctp();
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +02001552 BuildSctpContentAttributes(message, data_desc);
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001553 } else if (cricket::IsRtpProtocol(media_desc->protocol())) {
Steve Antone831b8c2018-02-01 12:22:16 -08001554 BuildRtpContentAttributes(media_desc, media_type, msid_signaling, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001555 }
1556}
1557
deadbeef9d3584c2016-02-16 17:54:10 -08001558void BuildRtpContentAttributes(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001559 const cricket::MediaType media_type,
Steve Antone831b8c2018-02-01 12:22:16 -08001560 int msid_signaling,
deadbeef9d3584c2016-02-16 17:54:10 -08001561 std::string* message) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001562 SdpSerializer serializer;
Jonas Olssonec9e4922018-09-05 09:53:49 +02001563 rtc::StringBuilder os;
Johannes Kron0854eb62018-10-10 22:33:20 +02001564 // RFC 8285
1565 // a=extmap-allow-mixed
1566 // The attribute MUST be either on session level or media level. We support
1567 // responding on both levels, however, we don't respond on media level if it's
1568 // set on session level.
Johannes Kron9581bc42018-10-23 10:17:39 +02001569 if (media_desc->extmap_allow_mixed_enum() ==
Johannes Kron0854eb62018-10-10 22:33:20 +02001570 MediaContentDescription::kMedia) {
1571 InitAttrLine(kAttributeExtmapAllowMixed, &os);
1572 AddLine(os.str(), message);
1573 }
1574 // RFC 8285
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001575 // a=extmap:<value>["/"<direction>] <URI> <extensionattributes>
1576 // The definitions MUST be either all session level or all media level. This
1577 // implementation uses all media level.
1578 for (size_t i = 0; i < media_desc->rtp_header_extensions().size(); ++i) {
jbauch5869f502017-06-29 12:31:36 -07001579 const RtpExtension& extension = media_desc->rtp_header_extensions()[i];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001580 InitAttrLine(kAttributeExtmap, &os);
jbauch5869f502017-06-29 12:31:36 -07001581 os << kSdpDelimiterColon << extension.id;
1582 if (extension.encrypt) {
1583 os << kSdpDelimiterSpace << RtpExtension::kEncryptHeaderExtensionsUri;
1584 }
1585 os << kSdpDelimiterSpace << extension.uri;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001586 AddLine(os.str(), message);
1587 }
1588
1589 // RFC 3264
1590 // a=sendrecv || a=sendonly || a=sendrecv || a=inactive
deadbeefc80741f2015-10-22 13:14:45 -07001591 switch (media_desc->direction()) {
Steve Anton4e70a722017-11-28 14:57:10 -08001592 case RtpTransceiverDirection::kInactive:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001593 InitAttrLine(kAttributeInactive, &os);
1594 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001595 case RtpTransceiverDirection::kSendOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001596 InitAttrLine(kAttributeSendOnly, &os);
1597 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001598 case RtpTransceiverDirection::kRecvOnly:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001599 InitAttrLine(kAttributeRecvOnly, &os);
1600 break;
Steve Anton4e70a722017-11-28 14:57:10 -08001601 case RtpTransceiverDirection::kSendRecv:
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001602 default:
1603 InitAttrLine(kAttributeSendRecv, &os);
1604 break;
1605 }
1606 AddLine(os.str(), message);
1607
Seth Hampson5b4f0752018-04-02 16:31:36 -07001608 // Specified in https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
1609 // a=msid:<msid-id> <msid-appdata>
1610 // The msid-id is a 1*64 token char representing the media stream id, and the
1611 // msid-appdata is a 1*64 token char representing the track id. There is a
1612 // line for every media stream, with a special msid-id value of "-"
1613 // representing no streams. The value of "msid-appdata" MUST be identical for
1614 // all lines.
Steve Antone831b8c2018-02-01 12:22:16 -08001615 if (msid_signaling & cricket::kMsidSignalingMediaSection) {
1616 const StreamParamsVec& streams = media_desc->streams();
1617 if (streams.size() == 1u) {
1618 const StreamParams& track = streams[0];
Seth Hampson5b4f0752018-04-02 16:31:36 -07001619 std::vector<std::string> stream_ids = track.stream_ids();
1620 if (stream_ids.empty()) {
1621 stream_ids.push_back(kNoStreamMsid);
1622 }
1623 for (const std::string& stream_id : stream_ids) {
1624 InitAttrLine(kAttributeMsid, &os);
1625 os << kSdpDelimiterColon << stream_id << kSdpDelimiterSpace << track.id;
1626 AddLine(os.str(), message);
1627 }
Steve Antone831b8c2018-02-01 12:22:16 -08001628 } else if (streams.size() > 1u) {
1629 RTC_LOG(LS_WARNING)
1630 << "Trying to serialize Unified Plan SDP with more than "
Jonas Olsson45cc8902018-02-13 10:37:07 +01001631 "one track in a media section. Omitting 'a=msid'.";
deadbeef9d3584c2016-02-16 17:54:10 -08001632 }
1633 }
1634
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001635 // RFC 5761
1636 // a=rtcp-mux
1637 if (media_desc->rtcp_mux()) {
1638 InitAttrLine(kAttributeRtcpMux, &os);
1639 AddLine(os.str(), message);
1640 }
1641
deadbeef13871492015-12-09 12:37:51 -08001642 // RFC 5506
1643 // a=rtcp-rsize
1644 if (media_desc->rtcp_reduced_size()) {
1645 InitAttrLine(kAttributeRtcpReducedSize, &os);
1646 AddLine(os.str(), message);
1647 }
1648
deadbeefd45aea82017-09-16 01:24:29 -07001649 if (media_desc->conference_mode()) {
1650 InitAttrLine(kAttributeXGoogleFlag, &os);
1651 os << kSdpDelimiterColon << kValueConference;
1652 AddLine(os.str(), message);
1653 }
1654
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001655 // RFC 4568
1656 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001657 for (const CryptoParams& crypto_params : media_desc->cryptos()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001658 InitAttrLine(kAttributeCrypto, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001659 os << kSdpDelimiterColon << crypto_params.tag << " "
1660 << crypto_params.cipher_suite << " " << crypto_params.key_params;
1661 if (!crypto_params.session_params.empty()) {
1662 os << " " << crypto_params.session_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001663 }
1664 AddLine(os.str(), message);
1665 }
1666
1667 // RFC 4566
1668 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1669 // [/<encodingparameters>]
1670 BuildRtpMap(media_desc, media_type, message);
1671
Steve Anton4daf66e2018-09-07 14:55:53 -07001672 for (const StreamParams& track : media_desc->streams()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001673 // Build the ssrc-group lines.
Steve Anton4daf66e2018-09-07 14:55:53 -07001674 for (const SsrcGroup& ssrc_group : track.ssrc_groups) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001675 // RFC 5576
1676 // a=ssrc-group:<semantics> <ssrc-id> ...
Steve Anton4daf66e2018-09-07 14:55:53 -07001677 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001678 continue;
1679 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001680 InitAttrLine(kAttributeSsrcGroup, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001681 os << kSdpDelimiterColon << ssrc_group.semantics;
1682 for (uint32_t ssrc : ssrc_group.ssrcs) {
1683 os << kSdpDelimiterSpace << rtc::ToString(ssrc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001684 }
1685 AddLine(os.str(), message);
1686 }
1687 // Build the ssrc lines for each ssrc.
Steve Anton4daf66e2018-09-07 14:55:53 -07001688 for (uint32_t ssrc : track.ssrcs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001689 // RFC 5576
1690 // a=ssrc:<ssrc-id> cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07001691 AddSsrcLine(ssrc, kSsrcAttributeCname, track.cname, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001692
Steve Antone831b8c2018-02-01 12:22:16 -08001693 if (msid_signaling & cricket::kMsidSignalingSsrcAttribute) {
1694 // draft-alvestrand-mmusic-msid-00
1695 // a=ssrc:<ssrc-id> msid:identifier [appdata]
1696 // The appdata consists of the "id" attribute of a MediaStreamTrack,
1697 // which corresponds to the "id" attribute of StreamParams.
Seth Hampson5b4f0752018-04-02 16:31:36 -07001698 // Since a=ssrc msid signaling is used in Plan B SDP semantics, and
1699 // multiple stream ids are not supported for Plan B, we are only adding
1700 // a line for the first media stream id here.
Seth Hampson7fa6ee62018-10-17 10:25:28 -07001701 const std::string& track_stream_id = track.first_stream_id();
1702 // We use a special msid-id value of "-" to represent no streams,
1703 // for Unified Plan compatibility. Plan B will always have a
1704 // track_stream_id.
1705 const std::string& stream_id =
1706 track_stream_id.empty() ? kNoStreamMsid : track_stream_id;
Steve Antone831b8c2018-02-01 12:22:16 -08001707 InitAttrLine(kAttributeSsrc, &os);
1708 os << kSdpDelimiterColon << ssrc << kSdpDelimiterSpace
1709 << kSsrcAttributeMsid << kSdpDelimiterColon << stream_id
Steve Anton4daf66e2018-09-07 14:55:53 -07001710 << kSdpDelimiterSpace << track.id;
Steve Antone831b8c2018-02-01 12:22:16 -08001711 AddLine(os.str(), message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001712
Steve Antone831b8c2018-02-01 12:22:16 -08001713 // TODO(ronghuawu): Remove below code which is for backward
1714 // compatibility.
1715 // draft-alvestrand-rtcweb-mid-01
1716 // a=ssrc:<ssrc-id> mslabel:<value>
1717 // The label isn't yet defined.
1718 // a=ssrc:<ssrc-id> label:<value>
Seth Hampson5b4f0752018-04-02 16:31:36 -07001719 AddSsrcLine(ssrc, kSsrcAttributeMslabel, stream_id, message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001720 AddSsrcLine(ssrc, kSSrcAttributeLabel, track.id, message);
Steve Antone831b8c2018-02-01 12:22:16 -08001721 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001722 }
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001723
1724 // Build the rid lines for each layer of the track
1725 for (const RidDescription& rid_description : track.rids()) {
1726 InitAttrLine(kAttributeRid, &os);
1727 os << kSdpDelimiterColon
1728 << serializer.SerializeRidDescription(rid_description);
1729 AddLine(os.str(), message);
1730 }
1731 }
1732
Amit Hilbucha2012042018-12-03 11:35:05 -08001733 // Simulcast (a=simulcast)
1734 // https://tools.ietf.org/html/draft-ietf-mmusic-sdp-simulcast-13#section-5.1
Amit Hilbuchc57d5732018-12-11 15:30:11 -08001735 if (media_desc->HasSimulcast()) {
1736 const auto& simulcast = media_desc->simulcast_description();
Amit Hilbucha2012042018-12-03 11:35:05 -08001737 InitAttrLine(kAttributeSimulcast, &os);
Amit Hilbucha2012042018-12-03 11:35:05 -08001738 os << kSdpDelimiterColon
1739 << serializer.SerializeSimulcastDescription(simulcast);
1740 AddLine(os.str(), message);
1741 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001742}
1743
Jonas Olssonec9e4922018-09-05 09:53:49 +02001744void WriteFmtpHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001745 // fmtp header: a=fmtp:|payload_type| <parameters>
1746 // Add a=fmtp
1747 InitAttrLine(kAttributeFmtp, os);
1748 // Add :|payload_type|
1749 *os << kSdpDelimiterColon << payload_type;
1750}
1751
Mirta Dvornicic479a3c02019-06-04 15:38:50 +02001752void WritePacketizationHeader(int payload_type, rtc::StringBuilder* os) {
1753 // packetization header: a=packetization:|payload_type| <packetization_format>
1754 // Add a=packetization
1755 InitAttrLine(kAttributePacketization, os);
1756 // Add :|payload_type|
1757 *os << kSdpDelimiterColon << payload_type;
1758}
1759
Jonas Olssonec9e4922018-09-05 09:53:49 +02001760void WriteRtcpFbHeader(int payload_type, rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001761 // rtcp-fb header: a=rtcp-fb:|payload_type|
1762 // <parameters>/<ccm <ccm_parameters>>
1763 // Add a=rtcp-fb
1764 InitAttrLine(kAttributeRtcpFb, os);
1765 // Add :
1766 *os << kSdpDelimiterColon;
1767 if (payload_type == kWildcardPayloadType) {
1768 *os << "*";
1769 } else {
1770 *os << payload_type;
1771 }
1772}
1773
1774void WriteFmtpParameter(const std::string& parameter_name,
1775 const std::string& parameter_value,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001776 rtc::StringBuilder* os) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001777 // fmtp parameters: |parameter_name|=|parameter_value|
1778 *os << parameter_name << kSdpDelimiterEqual << parameter_value;
1779}
1780
1781void WriteFmtpParameters(const cricket::CodecParameterMap& parameters,
Jonas Olssonec9e4922018-09-05 09:53:49 +02001782 rtc::StringBuilder* os) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001783 bool first = true;
1784 for (const auto& entry : parameters) {
1785 const std::string& key = entry.first;
1786 const std::string& value = entry.second;
hta62a216e2016-04-15 11:02:14 -07001787 // Parameters are a semicolon-separated list, no spaces.
1788 // The list is separated from the header by a space.
Steve Anton4daf66e2018-09-07 14:55:53 -07001789 if (first) {
hta62a216e2016-04-15 11:02:14 -07001790 *os << kSdpDelimiterSpace;
Steve Anton4daf66e2018-09-07 14:55:53 -07001791 first = false;
hta62a216e2016-04-15 11:02:14 -07001792 } else {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001793 *os << kSdpDelimiterSemicolon;
1794 }
Steve Anton4daf66e2018-09-07 14:55:53 -07001795 WriteFmtpParameter(key, value, os);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001796 }
1797}
1798
1799bool IsFmtpParam(const std::string& name) {
ossuaa4b0772017-01-30 07:41:18 -08001800 // RFC 4855, section 3 specifies the mapping of media format parameters to SDP
1801 // parameters. Only ptime, maxptime, channels and rate are placed outside of
1802 // the fmtp line. In WebRTC, channels and rate are already handled separately
1803 // and thus not included in the CodecParameterMap.
1804 return name != kCodecParamPTime && name != kCodecParamMaxPTime;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001805}
1806
1807// Retreives fmtp parameters from |params|, which may contain other parameters
1808// as well, and puts them in |fmtp_parameters|.
1809void GetFmtpParams(const cricket::CodecParameterMap& params,
1810 cricket::CodecParameterMap* fmtp_parameters) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001811 for (const auto& entry : params) {
1812 const std::string& key = entry.first;
1813 const std::string& value = entry.second;
1814 if (IsFmtpParam(key)) {
1815 (*fmtp_parameters)[key] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001816 }
1817 }
1818}
1819
1820template <class T>
1821void AddFmtpLine(const T& codec, std::string* message) {
1822 cricket::CodecParameterMap fmtp_parameters;
1823 GetFmtpParams(codec.params, &fmtp_parameters);
1824 if (fmtp_parameters.empty()) {
1825 // No need to add an fmtp if it will have no (optional) parameters.
1826 return;
1827 }
Jonas Olssonec9e4922018-09-05 09:53:49 +02001828 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001829 WriteFmtpHeader(codec.id, &os);
1830 WriteFmtpParameters(fmtp_parameters, &os);
1831 AddLine(os.str(), message);
1832 return;
1833}
1834
1835template <class T>
Mirta Dvornicic479a3c02019-06-04 15:38:50 +02001836void AddPacketizationLine(const T& codec, std::string* message) {
1837 if (!codec.packetization) {
1838 return;
1839 }
1840 rtc::StringBuilder os;
1841 WritePacketizationHeader(codec.id, &os);
1842 os << " " << *codec.packetization;
1843 AddLine(os.str(), message);
1844}
1845
1846template <class T>
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001847void AddRtcpFbLines(const T& codec, std::string* message) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001848 for (const cricket::FeedbackParam& param : codec.feedback_params.params()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001849 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001850 WriteRtcpFbHeader(codec.id, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001851 os << " " << param.id();
1852 if (!param.param().empty()) {
1853 os << " " << param.param();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001854 }
1855 AddLine(os.str(), message);
1856 }
1857}
1858
1859bool GetMinValue(const std::vector<int>& values, int* value) {
1860 if (values.empty()) {
1861 return false;
1862 }
Steve Anton64b626b2019-01-28 17:25:26 -08001863 auto it = absl::c_min_element(values);
1864 *value = *it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001865 return true;
1866}
1867
1868bool GetParameter(const std::string& name,
Yves Gerey665174f2018-06-19 15:03:05 +02001869 const cricket::CodecParameterMap& params,
1870 int* value) {
1871 std::map<std::string, std::string>::const_iterator found = params.find(name);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001872 if (found == params.end()) {
1873 return false;
1874 }
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00001875 if (!rtc::FromString(found->second, value)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00001876 return false;
1877 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001878 return true;
1879}
1880
1881void BuildRtpMap(const MediaContentDescription* media_desc,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02001882 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001883 std::string* message) {
nisseede5da42017-01-12 05:15:36 -08001884 RTC_DCHECK(message != NULL);
1885 RTC_DCHECK(media_desc != NULL);
Jonas Olssonec9e4922018-09-05 09:53:49 +02001886 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001887 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Anton4daf66e2018-09-07 14:55:53 -07001888 for (const cricket::VideoCodec& codec : media_desc->as_video()->codecs()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001889 // RFC 4566
1890 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1891 // [/<encodingparameters>]
Steve Anton4daf66e2018-09-07 14:55:53 -07001892 if (codec.id != kWildcardPayloadType) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001893 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001894 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
deadbeefe814a0d2017-02-25 18:15:09 -08001895 << cricket::kVideoCodecClockrate;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001896 AddLine(os.str(), message);
1897 }
Mirta Dvornicic479a3c02019-06-04 15:38:50 +02001898 AddPacketizationLine(codec, message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001899 AddRtcpFbLines(codec, message);
1900 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001901 }
1902 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001903 std::vector<int> ptimes;
1904 std::vector<int> maxptimes;
1905 int max_minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001906 for (const cricket::AudioCodec& codec : media_desc->as_audio()->codecs()) {
1907 RTC_DCHECK(!codec.name.empty());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001908 // RFC 4566
1909 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1910 // [/<encodingparameters>]
1911 InitAttrLine(kAttributeRtpmap, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001912 os << kSdpDelimiterColon << codec.id << " ";
1913 os << codec.name << "/" << codec.clockrate;
1914 if (codec.channels != 1) {
1915 os << "/" << codec.channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001916 }
1917 AddLine(os.str(), message);
Steve Anton4daf66e2018-09-07 14:55:53 -07001918 AddRtcpFbLines(codec, message);
1919 AddFmtpLine(codec, message);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001920 int minptime = 0;
Steve Anton4daf66e2018-09-07 14:55:53 -07001921 if (GetParameter(kCodecParamMinPTime, codec.params, &minptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001922 max_minptime = std::max(minptime, max_minptime);
1923 }
1924 int ptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001925 if (GetParameter(kCodecParamPTime, codec.params, &ptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001926 ptimes.push_back(ptime);
1927 }
1928 int maxptime;
Steve Anton4daf66e2018-09-07 14:55:53 -07001929 if (GetParameter(kCodecParamMaxPTime, codec.params, &maxptime)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001930 maxptimes.push_back(maxptime);
1931 }
1932 }
1933 // Populate the maxptime attribute with the smallest maxptime of all codecs
1934 // under the same m-line.
1935 int min_maxptime = INT_MAX;
1936 if (GetMinValue(maxptimes, &min_maxptime)) {
1937 AddAttributeLine(kCodecParamMaxPTime, min_maxptime, message);
1938 }
nisseede5da42017-01-12 05:15:36 -08001939 RTC_DCHECK(min_maxptime > max_minptime);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001940 // Populate the ptime attribute with the smallest ptime or the largest
1941 // minptime, whichever is the largest, for all codecs under the same m-line.
1942 int ptime = INT_MAX;
1943 if (GetMinValue(ptimes, &ptime)) {
1944 ptime = std::min(ptime, min_maxptime);
1945 ptime = std::max(ptime, max_minptime);
1946 AddAttributeLine(kCodecParamPTime, ptime, message);
1947 }
1948 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02001949 if (media_desc->as_rtp_data()) {
1950 for (const cricket::RtpDataCodec& codec :
1951 media_desc->as_rtp_data()->codecs()) {
1952 // RFC 4566
1953 // a=rtpmap:<payload type> <encoding name>/<clock rate>
1954 // [/<encodingparameters>]
1955 InitAttrLine(kAttributeRtpmap, &os);
1956 os << kSdpDelimiterColon << codec.id << " " << codec.name << "/"
1957 << codec.clockrate;
1958 AddLine(os.str(), message);
1959 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001960 }
1961 }
1962}
1963
1964void BuildCandidate(const std::vector<Candidate>& candidates,
honghaiza54a0802015-12-16 18:37:23 -08001965 bool include_ufrag,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001966 std::string* message) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02001967 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001968
Steve Anton4daf66e2018-09-07 14:55:53 -07001969 for (const Candidate& candidate : candidates) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001970 // RFC 5245
1971 // a=candidate:<foundation> <component-id> <transport> <priority>
1972 // <connection-address> <port> typ <candidate-types>
1973 // [raddr <connection-address>] [rport <port>]
1974 // *(SP extension-att-name SP extension-att-value)
1975 std::string type;
1976 // Map the cricket candidate type to "host" / "srflx" / "prflx" / "relay"
Steve Anton4daf66e2018-09-07 14:55:53 -07001977 if (candidate.type() == cricket::LOCAL_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001978 type = kCandidateHost;
Steve Anton4daf66e2018-09-07 14:55:53 -07001979 } else if (candidate.type() == cricket::STUN_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001980 type = kCandidateSrflx;
Steve Anton4daf66e2018-09-07 14:55:53 -07001981 } else if (candidate.type() == cricket::RELAY_PORT_TYPE) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001982 type = kCandidateRelay;
Steve Anton4daf66e2018-09-07 14:55:53 -07001983 } else if (candidate.type() == cricket::PRFLX_PORT_TYPE) {
Honghai Zhang7fb69db2016-03-14 11:59:18 -07001984 type = kCandidatePrflx;
1985 // Peer reflexive candidate may be signaled for being removed.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001986 } else {
nissec80e7412017-01-11 05:56:46 -08001987 RTC_NOTREACHED();
Peter Thatcher019087f2015-04-28 09:06:26 -07001988 // Never write out candidates if we don't know the type.
1989 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00001990 }
1991
1992 InitAttrLine(kAttributeCandidate, &os);
Steve Anton4daf66e2018-09-07 14:55:53 -07001993 os << kSdpDelimiterColon << candidate.foundation() << " "
1994 << candidate.component() << " " << candidate.protocol() << " "
1995 << candidate.priority() << " "
1996 << (candidate.address().ipaddr().IsNil()
1997 ? candidate.address().hostname()
1998 : candidate.address().ipaddr().ToString())
1999 << " " << candidate.address().PortAsString() << " "
2000 << kAttributeCandidateTyp << " " << type << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002001
2002 // Related address
Steve Anton4daf66e2018-09-07 14:55:53 -07002003 if (!candidate.related_address().IsNil()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002004 os << kAttributeCandidateRaddr << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07002005 << candidate.related_address().ipaddr().ToString() << " "
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002006 << kAttributeCandidateRport << " "
Steve Anton4daf66e2018-09-07 14:55:53 -07002007 << candidate.related_address().PortAsString() << " ";
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002008 }
2009
Steve Anton4daf66e2018-09-07 14:55:53 -07002010 if (candidate.protocol() == cricket::TCP_PROTOCOL_NAME) {
2011 os << kTcpCandidateType << " " << candidate.tcptype() << " ";
mallinath@webrtc.org2d60c5e2014-08-08 22:29:20 +00002012 }
2013
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002014 // Extensions
Steve Anton4daf66e2018-09-07 14:55:53 -07002015 os << kAttributeCandidateGeneration << " " << candidate.generation();
2016 if (include_ufrag && !candidate.username().empty()) {
2017 os << " " << kAttributeCandidateUfrag << " " << candidate.username();
honghaiza54a0802015-12-16 18:37:23 -08002018 }
Steve Anton4daf66e2018-09-07 14:55:53 -07002019 if (candidate.network_id() > 0) {
2020 os << " " << kAttributeCandidateNetworkId << " "
2021 << candidate.network_id();
honghaiza0c44ea2016-03-23 16:07:48 -07002022 }
Steve Anton4daf66e2018-09-07 14:55:53 -07002023 if (candidate.network_cost() > 0) {
2024 os << " " << kAttributeCandidateNetworkCost << " "
2025 << candidate.network_cost();
honghaize1a0c942016-02-16 14:54:56 -08002026 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002027
2028 AddLine(os.str(), message);
2029 }
2030}
2031
2032void BuildIceOptions(const std::vector<std::string>& transport_options,
2033 std::string* message) {
2034 if (!transport_options.empty()) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02002035 rtc::StringBuilder os;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002036 InitAttrLine(kAttributeIceOption, &os);
2037 os << kSdpDelimiterColon << transport_options[0];
2038 for (size_t i = 1; i < transport_options.size(); ++i) {
2039 os << kSdpDelimiterSpace << transport_options[i];
2040 }
2041 AddLine(os.str(), message);
2042 }
2043}
2044
zhihuang38989e52017-03-21 11:04:53 -07002045bool ParseConnectionData(const std::string& line,
2046 rtc::SocketAddress* addr,
2047 SdpParseError* error) {
2048 // Parse the line from left to right.
2049 std::string token;
2050 std::string rightpart;
2051 // RFC 4566
2052 // c=<nettype> <addrtype> <connection-address>
2053 // Skip the "c="
Jonas Olssonec9e4922018-09-05 09:53:49 +02002054 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, &token, &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07002055 return ParseFailed(line, "Failed to parse the network type.", error);
2056 }
2057
2058 // Extract and verify the <nettype>
Jonas Olssonec9e4922018-09-05 09:53:49 +02002059 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2060 &rightpart) ||
zhihuang38989e52017-03-21 11:04:53 -07002061 token != kConnectionNettype) {
2062 return ParseFailed(line,
2063 "Failed to parse the connection data. The network type "
2064 "is not currently supported.",
2065 error);
2066 }
2067
2068 // Extract the "<addrtype>" and "<connection-address>".
Jonas Olssonec9e4922018-09-05 09:53:49 +02002069 if (!rtc::tokenize_first(rightpart, kSdpDelimiterSpaceChar, &token,
2070 &rightpart)) {
zhihuang38989e52017-03-21 11:04:53 -07002071 return ParseFailed(line, "Failed to parse the address type.", error);
2072 }
2073
2074 // The rightpart part should be the IP address without the slash which is used
2075 // for multicast.
2076 if (rightpart.find('/') != std::string::npos) {
2077 return ParseFailed(line,
2078 "Failed to parse the connection data. Multicast is not "
2079 "currently supported.",
2080 error);
2081 }
2082 addr->SetIP(rightpart);
2083
2084 // Verify that the addrtype matches the type of the parsed address.
2085 if ((addr->family() == AF_INET && token != "IP4") ||
2086 (addr->family() == AF_INET6 && token != "IP6")) {
2087 addr->Clear();
2088 return ParseFailed(
2089 line,
2090 "Failed to parse the connection data. The address type is mismatching.",
2091 error);
2092 }
2093 return true;
2094}
2095
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -08002096bool ParseMediaTransportLine(const std::string& line,
2097 std::string* transport_name,
2098 std::string* transport_setting,
2099 SdpParseError* error) {
2100 std::string value;
2101 if (!GetValue(line, kMediaTransportSettingLine, &value, error)) {
2102 return false;
2103 }
2104 std::string media_transport_settings_base64;
2105 if (!rtc::tokenize_first(value, kSdpDelimiterColonChar, transport_name,
2106 &media_transport_settings_base64)) {
2107 return ParseFailedGetValue(line, kMediaTransportSettingLine, error);
2108 }
2109 if (!rtc::Base64::Decode(media_transport_settings_base64,
2110 rtc::Base64::DO_STRICT, transport_setting,
2111 nullptr)) {
2112 return ParseFailedGetValue(line, kMediaTransportSettingLine, error);
2113 }
2114
2115 return true;
2116}
2117
zhihuang38989e52017-03-21 11:04:53 -07002118bool ParseSessionDescription(const std::string& message,
2119 size_t* pos,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002120 std::string* session_id,
2121 std::string* session_version,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002122 TransportDescription* session_td,
2123 RtpHeaderExtensions* session_extmaps,
zhihuang38989e52017-03-21 11:04:53 -07002124 rtc::SocketAddress* connection_addr,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002125 cricket::SessionDescription* desc,
2126 SdpParseError* error) {
2127 std::string line;
2128
deadbeefc80741f2015-10-22 13:14:45 -07002129 desc->set_msid_supported(false);
Johannes Kron9581bc42018-10-23 10:17:39 +02002130 desc->set_extmap_allow_mixed(false);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002131 // RFC 4566
2132 // v= (protocol version)
2133 if (!GetLineWithType(message, pos, &line, kLineTypeVersion)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002134 return ParseFailedExpectLine(message, *pos, kLineTypeVersion, std::string(),
2135 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002136 }
2137 // RFC 4566
2138 // o=<username> <sess-id> <sess-version> <nettype> <addrtype>
2139 // <unicast-address>
2140 if (!GetLineWithType(message, pos, &line, kLineTypeOrigin)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002141 return ParseFailedExpectLine(message, *pos, kLineTypeOrigin, std::string(),
2142 error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002143 }
2144 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002145 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002146 const size_t expected_fields = 6;
2147 if (fields.size() != expected_fields) {
2148 return ParseFailedExpectFieldNum(line, expected_fields, error);
2149 }
2150 *session_id = fields[1];
2151 *session_version = fields[2];
2152
2153 // RFC 4566
2154 // s= (session name)
2155 if (!GetLineWithType(message, pos, &line, kLineTypeSessionName)) {
2156 return ParseFailedExpectLine(message, *pos, kLineTypeSessionName,
2157 std::string(), error);
2158 }
2159
Danil Chapovalov66cadcc2018-06-19 16:47:43 +02002160 // absl::optional lines
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002161 // Those are the optional lines, so shouldn't return false if not present.
2162 // RFC 4566
2163 // i=* (session information)
2164 GetLineWithType(message, pos, &line, kLineTypeSessionInfo);
2165
2166 // RFC 4566
2167 // u=* (URI of description)
2168 GetLineWithType(message, pos, &line, kLineTypeSessionUri);
2169
2170 // RFC 4566
2171 // e=* (email address)
2172 GetLineWithType(message, pos, &line, kLineTypeSessionEmail);
2173
2174 // RFC 4566
2175 // p=* (phone number)
2176 GetLineWithType(message, pos, &line, kLineTypeSessionPhone);
2177
2178 // RFC 4566
2179 // c=* (connection information -- not required if included in
2180 // all media)
zhihuang38989e52017-03-21 11:04:53 -07002181 if (GetLineWithType(message, pos, &line, kLineTypeConnection)) {
2182 if (!ParseConnectionData(line, connection_addr, error)) {
2183 return false;
2184 }
2185 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002186
2187 // RFC 4566
2188 // b=* (zero or more bandwidth information lines)
2189 while (GetLineWithType(message, pos, &line, kLineTypeSessionBandwidth)) {
2190 // By pass zero or more b lines.
2191 }
2192
2193 // RFC 4566
2194 // One or more time descriptions ("t=" and "r=" lines; see below)
2195 // t= (time the session is active)
2196 // r=* (zero or more repeat times)
2197 // Ensure there's at least one time description
2198 if (!GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2199 return ParseFailedExpectLine(message, *pos, kLineTypeTiming, std::string(),
2200 error);
2201 }
2202
2203 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2204 // By pass zero or more r lines.
2205 }
2206
2207 // Go through the rest of the time descriptions
2208 while (GetLineWithType(message, pos, &line, kLineTypeTiming)) {
2209 while (GetLineWithType(message, pos, &line, kLineTypeRepeatTimes)) {
2210 // By pass zero or more r lines.
2211 }
2212 }
2213
2214 // RFC 4566
2215 // z=* (time zone adjustments)
2216 GetLineWithType(message, pos, &line, kLineTypeTimeZone);
2217
2218 // RFC 4566
2219 // k=* (encryption key)
2220 GetLineWithType(message, pos, &line, kLineTypeEncryptionKey);
2221
2222 // RFC 4566
2223 // a=* (zero or more session attribute lines)
2224 while (GetLineWithType(message, pos, &line, kLineTypeAttributes)) {
2225 if (HasAttribute(line, kAttributeGroup)) {
2226 if (!ParseGroupAttribute(line, desc, error)) {
2227 return false;
2228 }
2229 } else if (HasAttribute(line, kAttributeIceUfrag)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002230 if (!GetValue(line, kAttributeIceUfrag, &(session_td->ice_ufrag),
2231 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002232 return false;
2233 }
2234 } else if (HasAttribute(line, kAttributeIcePwd)) {
2235 if (!GetValue(line, kAttributeIcePwd, &(session_td->ice_pwd), error)) {
2236 return false;
2237 }
2238 } else if (HasAttribute(line, kAttributeIceLite)) {
2239 session_td->ice_mode = cricket::ICEMODE_LITE;
2240 } else if (HasAttribute(line, kAttributeIceOption)) {
2241 if (!ParseIceOptions(line, &(session_td->transport_options), error)) {
2242 return false;
2243 }
2244 } else if (HasAttribute(line, kAttributeFingerprint)) {
2245 if (session_td->identity_fingerprint.get()) {
2246 return ParseFailed(
2247 line,
2248 "Can't have multiple fingerprint attributes at the same level.",
2249 error);
2250 }
Steve Anton4905edb2018-10-15 19:27:44 -07002251 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002252 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
2253 return false;
2254 }
Steve Anton4905edb2018-10-15 19:27:44 -07002255 session_td->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002256 } else if (HasAttribute(line, kAttributeSetup)) {
2257 if (!ParseDtlsSetup(line, &(session_td->connection_role), error)) {
2258 return false;
2259 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002260 } else if (HasAttribute(line, kAttributeMsidSemantics)) {
2261 std::string semantics;
2262 if (!GetValue(line, kAttributeMsidSemantics, &semantics, error)) {
2263 return false;
2264 }
deadbeefc80741f2015-10-22 13:14:45 -07002265 desc->set_msid_supported(
2266 CaseInsensitiveFind(semantics, kMediaStreamSemantic));
Johannes Kron0854eb62018-10-10 22:33:20 +02002267 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02002268 desc->set_extmap_allow_mixed(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002269 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07002270 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002271 if (!ParseExtmap(line, &extmap, error)) {
2272 return false;
2273 }
2274 session_extmaps->push_back(extmap);
Piotr (Peter) Slatala13e570f2019-02-27 11:34:26 -08002275 } else if (HasAttribute(line, kMediaTransportSettingLine)) {
2276 std::string transport_name;
2277 std::string transport_setting;
2278 if (!ParseMediaTransportLine(line, &transport_name, &transport_setting,
2279 error)) {
2280 return false;
2281 }
2282
2283 for (const auto& setting : desc->MediaTransportSettings()) {
2284 if (setting.transport_name == transport_name) {
2285 // Ignore repeated transport names rather than failing to parse so
2286 // that in the future the same transport could have multiple configs.
2287 RTC_LOG(INFO) << "x-mt line with repeated transport, transport_name="
2288 << transport_name;
2289 return true;
2290 }
2291 }
2292 desc->AddMediaTransportSetting(transport_name, transport_setting);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002293 }
2294 }
2295
2296 return true;
2297}
2298
2299bool ParseGroupAttribute(const std::string& line,
2300 cricket::SessionDescription* desc,
2301 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002302 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002303
2304 // RFC 5888 and draft-holmberg-mmusic-sdp-bundle-negotiation-00
2305 // a=group:BUNDLE video voice
2306 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002307 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002308 std::string semantics;
2309 if (!GetValue(fields[0], kAttributeGroup, &semantics, error)) {
2310 return false;
2311 }
2312 cricket::ContentGroup group(semantics);
2313 for (size_t i = 1; i < fields.size(); ++i) {
2314 group.AddContentName(fields[i]);
2315 }
2316 desc->AddGroup(group);
2317 return true;
2318}
2319
Steve Anton4905edb2018-10-15 19:27:44 -07002320static bool ParseFingerprintAttribute(
2321 const std::string& line,
2322 std::unique_ptr<rtc::SSLFingerprint>* fingerprint,
2323 SdpParseError* error) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002324 if (!IsLineType(line, kLineTypeAttributes) ||
2325 !HasAttribute(line, kAttributeFingerprint)) {
2326 return ParseFailedExpectLine(line, 0, kLineTypeAttributes,
2327 kAttributeFingerprint, error);
2328 }
2329
2330 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002331 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002332 const size_t expected_fields = 2;
2333 if (fields.size() != expected_fields) {
2334 return ParseFailedExpectFieldNum(line, expected_fields, error);
2335 }
2336
2337 // The first field here is "fingerprint:<hash>.
2338 std::string algorithm;
2339 if (!GetValue(fields[0], kAttributeFingerprint, &algorithm, error)) {
2340 return false;
2341 }
2342
2343 // Downcase the algorithm. Note that we don't need to downcase the
2344 // fingerprint because hex_decode can handle upper-case.
Steve Anton64b626b2019-01-28 17:25:26 -08002345 absl::c_transform(algorithm, algorithm.begin(), ::tolower);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002346
2347 // The second field is the digest value. De-hexify it.
Steve Anton4905edb2018-10-15 19:27:44 -07002348 *fingerprint =
2349 rtc::SSLFingerprint::CreateUniqueFromRfc4572(algorithm, fields[1]);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002350 if (!*fingerprint) {
Yves Gerey665174f2018-06-19 15:03:05 +02002351 return ParseFailed(line, "Failed to create fingerprint from the digest.",
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002352 error);
2353 }
2354
2355 return true;
2356}
2357
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002358static bool ParseDtlsSetup(const std::string& line,
2359 cricket::ConnectionRole* role,
2360 SdpParseError* error) {
2361 // setup-attr = "a=setup:" role
2362 // role = "active" / "passive" / "actpass" / "holdconn"
2363 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002364 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterColonChar, &fields);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00002365 const size_t expected_fields = 2;
2366 if (fields.size() != expected_fields) {
2367 return ParseFailedExpectFieldNum(line, expected_fields, error);
2368 }
2369 std::string role_str = fields[1];
2370 if (!cricket::StringToConnectionRole(role_str, role)) {
2371 return ParseFailed(line, "Invalid attribute value.", error);
2372 }
2373 return true;
2374}
2375
deadbeef9d3584c2016-02-16 17:54:10 -08002376static bool ParseMsidAttribute(const std::string& line,
Seth Hampson5b4f0752018-04-02 16:31:36 -07002377 std::vector<std::string>* stream_ids,
deadbeef9d3584c2016-02-16 17:54:10 -08002378 std::string* track_id,
2379 SdpParseError* error) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07002380 // https://datatracker.ietf.org/doc/draft-ietf-mmusic-msid/16/
deadbeef9d3584c2016-02-16 17:54:10 -08002381 // a=msid:<stream id> <track id>
2382 // msid-value = msid-id [ SP msid-appdata ]
2383 // msid-id = 1*64token-char ; see RFC 4566
2384 // msid-appdata = 1*64token-char ; see RFC 4566
2385 std::string field1;
Seth Hampson5b4f0752018-04-02 16:31:36 -07002386 std::string new_stream_id;
2387 std::string new_track_id;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002388 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
2389 kSdpDelimiterSpaceChar, &field1, &new_track_id)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002390 const size_t expected_fields = 2;
2391 return ParseFailedExpectFieldNum(line, expected_fields, error);
2392 }
2393
Seth Hampson5b4f0752018-04-02 16:31:36 -07002394 if (new_track_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002395 return ParseFailed(line, "Missing track ID in msid attribute.", error);
2396 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002397 // All track ids should be the same within an m section in a Unified Plan SDP.
2398 if (!track_id->empty() && new_track_id.compare(*track_id) != 0) {
2399 return ParseFailed(
2400 line, "Two different track IDs in msid attribute in one m= section",
2401 error);
2402 }
2403 *track_id = new_track_id;
deadbeefa4549d62017-02-10 17:26:22 -08002404
deadbeef9d3584c2016-02-16 17:54:10 -08002405 // msid:<msid-id>
Seth Hampson5b4f0752018-04-02 16:31:36 -07002406 if (!GetValue(field1, kAttributeMsid, &new_stream_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08002407 return false;
2408 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002409 if (new_stream_id.empty()) {
deadbeefa4549d62017-02-10 17:26:22 -08002410 return ParseFailed(line, "Missing stream ID in msid attribute.", error);
2411 }
Seth Hampson5b4f0752018-04-02 16:31:36 -07002412 // The special value "-" indicates "no MediaStream".
2413 if (new_stream_id.compare(kNoStreamMsid) != 0) {
2414 stream_ids->push_back(new_stream_id);
2415 }
deadbeef9d3584c2016-02-16 17:54:10 -08002416 return true;
2417}
2418
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002419static void RemoveInvalidRidDescriptions(const std::vector<int>& payload_types,
2420 std::vector<RidDescription>* rids) {
2421 RTC_DCHECK(rids);
2422 std::set<std::string> to_remove;
2423 std::set<std::string> unique_rids;
2424
2425 // Check the rids to see which ones should be removed.
2426 for (RidDescription& rid : *rids) {
2427 // In the case of a duplicate, the entire "a=rid" line, and all "a=rid"
2428 // lines with rid-ids that duplicate this line, are discarded and MUST NOT
2429 // be included in the SDP Answer.
2430 auto pair = unique_rids.insert(rid.rid);
2431 // Insert will "fail" if element already exists.
2432 if (!pair.second) {
2433 to_remove.insert(rid.rid);
2434 continue;
2435 }
2436
2437 // If the "a=rid" line contains a "pt=", the list of payload types
2438 // is verified against the list of valid payload types for the media
2439 // section (that is, those listed on the "m=" line). Any PT missing
2440 // from the "m=" line is discarded from the set of values in the
2441 // "pt=". If no values are left in the "pt=" parameter after this
2442 // processing, then the "a=rid" line is discarded.
2443 if (rid.payload_types.empty()) {
2444 // If formats were not specified, rid should not be removed.
2445 continue;
2446 }
2447
2448 // Note: Spec does not mention how to handle duplicate formats.
2449 // Media section does not handle duplicates either.
2450 std::set<int> removed_formats;
2451 for (int payload_type : rid.payload_types) {
Steve Anton64b626b2019-01-28 17:25:26 -08002452 if (!absl::c_linear_search(payload_types, payload_type)) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002453 removed_formats.insert(payload_type);
2454 }
2455 }
2456
2457 rid.payload_types.erase(
2458 std::remove_if(rid.payload_types.begin(), rid.payload_types.end(),
2459 [&removed_formats](int format) {
2460 return removed_formats.count(format) > 0;
2461 }),
2462 rid.payload_types.end());
2463
2464 // If all formats were removed then remove the rid alogether.
2465 if (rid.payload_types.empty()) {
2466 to_remove.insert(rid.rid);
2467 }
2468 }
2469
2470 // Remove every rid description that appears in the to_remove list.
2471 if (!to_remove.empty()) {
2472 rids->erase(std::remove_if(rids->begin(), rids->end(),
2473 [&to_remove](const RidDescription& rid) {
2474 return to_remove.count(rid.rid) > 0;
2475 }),
2476 rids->end());
2477 }
2478}
2479
2480// Create a new list (because SimulcastLayerList is immutable) without any
2481// layers that have a rid in the to_remove list.
2482// If a group of alternatives is empty after removing layers, the group should
2483// be removed altogether.
2484static SimulcastLayerList RemoveRidsFromSimulcastLayerList(
2485 const std::set<std::string>& to_remove,
2486 const SimulcastLayerList& layers) {
2487 SimulcastLayerList result;
2488 for (const std::vector<SimulcastLayer>& vector : layers) {
2489 std::vector<SimulcastLayer> new_layers;
2490 for (const SimulcastLayer& layer : vector) {
2491 if (to_remove.find(layer.rid) == to_remove.end()) {
2492 new_layers.push_back(layer);
2493 }
2494 }
2495 // If all layers were removed, do not add an entry.
2496 if (!new_layers.empty()) {
2497 result.AddLayerWithAlternatives(new_layers);
2498 }
2499 }
2500
2501 return result;
2502}
2503
2504// Will remove Simulcast Layers if:
2505// 1. They appear in both send and receive directions.
2506// 2. They do not appear in the list of |valid_rids|.
2507static void RemoveInvalidRidsFromSimulcast(
2508 const std::vector<RidDescription>& valid_rids,
2509 SimulcastDescription* simulcast) {
2510 RTC_DCHECK(simulcast);
2511 std::set<std::string> to_remove;
2512 std::vector<SimulcastLayer> all_send_layers =
2513 simulcast->send_layers().GetAllLayers();
2514 std::vector<SimulcastLayer> all_receive_layers =
2515 simulcast->receive_layers().GetAllLayers();
2516
2517 // If a rid appears in both send and receive directions, remove it from both.
2518 // This algorithm runs in O(n^2) time, but for small n (as is the case with
2519 // simulcast layers) it should still perform well.
2520 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002521 if (absl::c_any_of(all_receive_layers,
2522 [&send_layer](const SimulcastLayer& layer) {
2523 return layer.rid == send_layer.rid;
2524 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002525 to_remove.insert(send_layer.rid);
2526 }
2527 }
2528
2529 // Add any rid that is not in the valid list to the remove set.
2530 for (const SimulcastLayer& send_layer : all_send_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002531 if (absl::c_none_of(valid_rids, [&send_layer](const RidDescription& rid) {
2532 return send_layer.rid == rid.rid;
2533 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002534 to_remove.insert(send_layer.rid);
2535 }
2536 }
2537
2538 // Add any rid that is not in the valid list to the remove set.
2539 for (const SimulcastLayer& receive_layer : all_receive_layers) {
Steve Anton64b626b2019-01-28 17:25:26 -08002540 if (absl::c_none_of(valid_rids,
2541 [&receive_layer](const RidDescription& rid) {
2542 return receive_layer.rid == rid.rid;
2543 })) {
Amit Hilbuchc57d5732018-12-11 15:30:11 -08002544 to_remove.insert(receive_layer.rid);
2545 }
2546 }
2547
2548 simulcast->send_layers() =
2549 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->send_layers());
2550 simulcast->receive_layers() =
2551 RemoveRidsFromSimulcastLayerList(to_remove, simulcast->receive_layers());
2552}
2553
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002554// RFC 3551
2555// PT encoding media type clock rate channels
2556// name (Hz)
2557// 0 PCMU A 8,000 1
2558// 1 reserved A
2559// 2 reserved A
2560// 3 GSM A 8,000 1
2561// 4 G723 A 8,000 1
2562// 5 DVI4 A 8,000 1
2563// 6 DVI4 A 16,000 1
2564// 7 LPC A 8,000 1
2565// 8 PCMA A 8,000 1
2566// 9 G722 A 8,000 1
2567// 10 L16 A 44,100 2
2568// 11 L16 A 44,100 1
2569// 12 QCELP A 8,000 1
2570// 13 CN A 8,000 1
2571// 14 MPA A 90,000 (see text)
2572// 15 G728 A 8,000 1
2573// 16 DVI4 A 11,025 1
2574// 17 DVI4 A 22,050 1
2575// 18 G729 A 8,000 1
2576struct StaticPayloadAudioCodec {
2577 const char* name;
2578 int clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002579 size_t channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002580};
2581static const StaticPayloadAudioCodec kStaticPayloadAudioCodecs[] = {
Yves Gerey665174f2018-06-19 15:03:05 +02002582 {"PCMU", 8000, 1}, {"reserved", 0, 0}, {"reserved", 0, 0},
2583 {"GSM", 8000, 1}, {"G723", 8000, 1}, {"DVI4", 8000, 1},
2584 {"DVI4", 16000, 1}, {"LPC", 8000, 1}, {"PCMA", 8000, 1},
2585 {"G722", 8000, 1}, {"L16", 44100, 2}, {"L16", 44100, 1},
2586 {"QCELP", 8000, 1}, {"CN", 8000, 1}, {"MPA", 90000, 1},
2587 {"G728", 8000, 1}, {"DVI4", 11025, 1}, {"DVI4", 22050, 1},
2588 {"G729", 8000, 1},
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002589};
2590
Yves Gerey665174f2018-06-19 15:03:05 +02002591void MaybeCreateStaticPayloadAudioCodecs(const std::vector<int>& fmts,
2592 AudioContentDescription* media_desc) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002593 if (!media_desc) {
2594 return;
2595 }
deadbeef67cf2c12016-04-13 10:07:16 -07002596 RTC_DCHECK(media_desc->codecs().empty());
solenberg9fa49752016-10-08 13:02:44 -07002597 for (int payload_type : fmts) {
Yves Gerey665174f2018-06-19 15:03:05 +02002598 if (!media_desc->HasCodec(payload_type) && payload_type >= 0 &&
kjellander3e33bfe2016-06-20 07:04:09 -07002599 static_cast<uint32_t>(payload_type) <
2600 arraysize(kStaticPayloadAudioCodecs)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002601 std::string encoding_name = kStaticPayloadAudioCodecs[payload_type].name;
2602 int clock_rate = kStaticPayloadAudioCodecs[payload_type].clockrate;
Peter Kasting69558702016-01-12 16:26:35 -08002603 size_t channels = kStaticPayloadAudioCodecs[payload_type].channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002604 media_desc->AddCodec(cricket::AudioCodec(payload_type, encoding_name,
deadbeef67cf2c12016-04-13 10:07:16 -07002605 clock_rate, 0, channels));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002606 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002607 }
2608}
2609
2610template <class C>
Steve Anton5a1de872018-12-18 11:25:55 -08002611static std::unique_ptr<C> ParseContentDescription(
2612 const std::string& message,
2613 const cricket::MediaType media_type,
2614 int mline_index,
2615 const std::string& protocol,
2616 const std::vector<int>& payload_types,
2617 size_t* pos,
2618 std::string* content_name,
2619 bool* bundle_only,
2620 int* msid_signaling,
2621 TransportDescription* transport,
2622 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2623 webrtc::SdpParseError* error) {
2624 auto media_desc = absl::make_unique<C>();
deadbeef67cf2c12016-04-13 10:07:16 -07002625 if (!ParseContent(message, media_type, mline_index, protocol, payload_types,
Steve Anton5a1de872018-12-18 11:25:55 -08002626 pos, content_name, bundle_only, msid_signaling,
2627 media_desc.get(), transport, candidates, error)) {
zhihuang38989e52017-03-21 11:04:53 -07002628 return nullptr;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002629 }
2630 // Sort the codecs according to the m-line fmt list.
deadbeef67cf2c12016-04-13 10:07:16 -07002631 std::unordered_map<int, int> payload_type_preferences;
2632 // "size + 1" so that the lowest preference payload type has a preference of
2633 // 1, which is greater than the default (0) for payload types not in the fmt
2634 // list.
2635 int preference = static_cast<int>(payload_types.size() + 1);
2636 for (int pt : payload_types) {
2637 payload_type_preferences[pt] = preference--;
2638 }
2639 std::vector<typename C::CodecType> codecs = media_desc->codecs();
Steve Anton64b626b2019-01-28 17:25:26 -08002640 absl::c_sort(
2641 codecs, [&payload_type_preferences](const typename C::CodecType& a,
2642 const typename C::CodecType& b) {
2643 return payload_type_preferences[a.id] > payload_type_preferences[b.id];
2644 });
deadbeef67cf2c12016-04-13 10:07:16 -07002645 media_desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002646 return media_desc;
2647}
2648
Steve Anton5a1de872018-12-18 11:25:55 -08002649bool ParseMediaDescription(
2650 const std::string& message,
2651 const TransportDescription& session_td,
2652 const RtpHeaderExtensions& session_extmaps,
2653 size_t* pos,
2654 const rtc::SocketAddress& session_connection_addr,
2655 cricket::SessionDescription* desc,
2656 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
2657 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08002658 RTC_DCHECK(desc != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002659 std::string line;
2660 int mline_index = -1;
Steve Antone831b8c2018-02-01 12:22:16 -08002661 int msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002662
2663 // Zero or more media descriptions
2664 // RFC 4566
2665 // m=<media> <port> <proto> <fmt>
2666 while (GetLineWithType(message, pos, &line, kLineTypeMedia)) {
2667 ++mline_index;
2668
2669 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02002670 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
zstein4b2e0822017-02-17 19:48:38 -08002671
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002672 const size_t expected_min_fields = 4;
2673 if (fields.size() < expected_min_fields) {
2674 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
2675 }
deadbeef25ed4352016-12-12 18:37:36 -08002676 bool port_rejected = false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002677 // RFC 3264
2678 // To reject an offered stream, the port number in the corresponding stream
2679 // in the answer MUST be set to zero.
2680 if (fields[1] == kMediaPortRejected) {
deadbeef25ed4352016-12-12 18:37:36 -08002681 port_rejected = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002682 }
2683
zhihuang38989e52017-03-21 11:04:53 -07002684 int port = 0;
2685 if (!rtc::FromString<int>(fields[1], &port) || !IsValidPort(port)) {
2686 return ParseFailed(line, "The port number is invalid", error);
2687 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002688 std::string protocol = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002689
2690 // <fmt>
deadbeef67cf2c12016-04-13 10:07:16 -07002691 std::vector<int> payload_types;
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002692 if (cricket::IsRtpProtocol(protocol)) {
Yves Gerey665174f2018-06-19 15:03:05 +02002693 for (size_t j = 3; j < fields.size(); ++j) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002694 // TODO(wu): Remove when below bug is fixed.
2695 // https://bugzilla.mozilla.org/show_bug.cgi?id=996329
pbosbb36fdf2015-07-09 07:48:14 -07002696 if (fields[j].empty() && j == fields.size() - 1) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002697 continue;
2698 }
wu@webrtc.org36eda7c2014-04-15 20:37:30 +00002699
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002700 int pl = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00002701 if (!GetPayloadTypeFromString(line, fields[j], &pl, error)) {
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00002702 return false;
2703 }
deadbeef67cf2c12016-04-13 10:07:16 -07002704 payload_types.push_back(pl);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00002705 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002706 }
2707
2708 // Make a temporary TransportDescription based on |session_td|.
2709 // Some of this gets overwritten by ParseContent.
deadbeef46eed762016-01-28 13:24:37 -08002710 TransportDescription transport(
2711 session_td.transport_options, session_td.ice_ufrag, session_td.ice_pwd,
2712 session_td.ice_mode, session_td.connection_role,
2713 session_td.identity_fingerprint.get());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002714
kwibergd1fe2812016-04-27 06:47:29 -07002715 std::unique_ptr<MediaContentDescription> content;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002716 std::string content_name;
deadbeef25ed4352016-12-12 18:37:36 -08002717 bool bundle_only = false;
Steve Antone831b8c2018-02-01 12:22:16 -08002718 int section_msid_signaling = 0;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002719 if (HasAttribute(line, kMediaTypeVideo)) {
Steve Anton5a1de872018-12-18 11:25:55 -08002720 content = ParseContentDescription<VideoContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002721 message, cricket::MEDIA_TYPE_VIDEO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002722 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 11:25:55 -08002723 &section_msid_signaling, &transport, candidates, error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002724 } else if (HasAttribute(line, kMediaTypeAudio)) {
Steve Anton5a1de872018-12-18 11:25:55 -08002725 content = ParseContentDescription<AudioContentDescription>(
deadbeef67cf2c12016-04-13 10:07:16 -07002726 message, cricket::MEDIA_TYPE_AUDIO, mline_index, protocol,
Steve Antone831b8c2018-02-01 12:22:16 -08002727 payload_types, pos, &content_name, &bundle_only,
Steve Anton5a1de872018-12-18 11:25:55 -08002728 &section_msid_signaling, &transport, candidates, error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002729 } else if (HasAttribute(line, kMediaTypeData)) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002730 if (cricket::IsDtlsSctp(protocol)) {
2731 // The draft-03 format is:
2732 // m=application <port> DTLS/SCTP <sctp-port>...
2733 // use_sctpmap should be false.
2734 // The draft-26 format is:
2735 // m=application <port> UDP/DTLS/SCTP webrtc-datachannel
2736 // use_sctpmap should be false.
2737 auto data_desc = absl::make_unique<SctpDataContentDescription>();
Harald Alvestrandfbb45bd2019-05-15 08:07:47 +02002738 // Default max message size is 64K
2739 // according to draft-ietf-mmusic-sctp-sdp-26
2740 data_desc->set_max_message_size(kDefaultSctpMaxMessageSize);
zstein4b2e0822017-02-17 19:48:38 -08002741 int p;
2742 if (rtc::FromString(fields[3], &p)) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002743 data_desc->set_port(p);
zstein4b2e0822017-02-17 19:48:38 -08002744 } else if (fields[3] == kDefaultSctpmapProtocol) {
2745 data_desc->set_use_sctpmap(false);
2746 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002747 if (!ParseContent(message, cricket::MEDIA_TYPE_DATA, mline_index,
2748 protocol, payload_types, pos, &content_name,
2749 &bundle_only, &section_msid_signaling,
2750 data_desc.get(), &transport, candidates, error)) {
2751 return false;
2752 }
2753 data_desc->set_protocol(protocol);
2754 content = std::move(data_desc);
2755 } else {
2756 // RTP
2757 std::unique_ptr<RtpDataContentDescription> data_desc =
2758 ParseContentDescription<RtpDataContentDescription>(
2759 message, cricket::MEDIA_TYPE_DATA, mline_index, protocol,
2760 payload_types, pos, &content_name, &bundle_only,
2761 &section_msid_signaling, &transport, candidates, error);
2762 content = std::move(data_desc);
wu@webrtc.org78187522013-10-07 23:32:02 +00002763 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002764 } else {
Mirko Bonadei675513b2017-11-09 11:09:25 +01002765 RTC_LOG(LS_WARNING) << "Unsupported media type: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002766 continue;
2767 }
2768 if (!content.get()) {
2769 // ParseContentDescription returns NULL if failed.
2770 return false;
2771 }
2772
Steve Antone831b8c2018-02-01 12:22:16 -08002773 msid_signaling |= section_msid_signaling;
2774
deadbeef25ed4352016-12-12 18:37:36 -08002775 bool content_rejected = false;
deadbeef12771a12017-01-03 13:53:47 -08002776 // A port of 0 is not interpreted as a rejected m= section when it's
2777 // used along with a=bundle-only.
deadbeef25ed4352016-12-12 18:37:36 -08002778 if (bundle_only) {
deadbeef25ed4352016-12-12 18:37:36 -08002779 if (!port_rejected) {
deadbeef12771a12017-01-03 13:53:47 -08002780 // Usage of bundle-only with a nonzero port is unspecified. So just
2781 // ignore bundle-only if we see this.
2782 bundle_only = false;
Mirko Bonadei675513b2017-11-09 11:09:25 +01002783 RTC_LOG(LS_WARNING)
deadbeef12771a12017-01-03 13:53:47 -08002784 << "a=bundle-only attribute observed with a nonzero "
Jonas Olsson45cc8902018-02-13 10:37:07 +01002785 "port; this usage is unspecified so the attribute is being "
2786 "ignored.";
deadbeef25ed4352016-12-12 18:37:36 -08002787 }
2788 } else {
2789 // If not using bundle-only, interpret port 0 in the normal way; the m=
2790 // section is being rejected.
2791 content_rejected = port_rejected;
2792 }
2793
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002794 if (cricket::IsRtpProtocol(protocol) && !content->as_sctp()) {
2795 content->set_protocol(protocol);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002796 // Set the extmap.
2797 if (!session_extmaps.empty() &&
2798 !content->rtp_header_extensions().empty()) {
2799 return ParseFailed("",
2800 "The a=extmap MUST be either all session level or "
2801 "all media level.",
2802 error);
2803 }
2804 for (size_t i = 0; i < session_extmaps.size(); ++i) {
2805 content->AddRtpHeaderExtension(session_extmaps[i]);
2806 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002807 } else if (content->as_sctp()) {
2808 // Do nothing, it's OK
2809 } else {
2810 RTC_LOG(LS_WARNING) << "Parse failed with unknown protocol " << protocol;
2811 return false;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002812 }
zhihuang38989e52017-03-21 11:04:53 -07002813
2814 // Use the session level connection address if the media level addresses are
2815 // not specified.
2816 rtc::SocketAddress address;
2817 address = content->connection_address().IsNil()
2818 ? session_connection_addr
2819 : content->connection_address();
2820 address.SetPort(port);
2821 content->set_connection_address(address);
2822
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002823 desc->AddContent(content_name,
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02002824 cricket::IsDtlsSctp(protocol) ? MediaProtocolType::kSctp
2825 : MediaProtocolType::kRtp,
Harald Alvestrand1716d392019-06-03 20:35:45 +02002826 content_rejected, bundle_only, std::move(content));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002827 // Create TransportInfo with the media level "ice-pwd" and "ice-ufrag".
Steve Anton06817cd2018-12-18 15:55:30 -08002828 desc->AddTransportInfo(TransportInfo(content_name, transport));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002829 }
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002830
Steve Antone831b8c2018-02-01 12:22:16 -08002831 desc->set_msid_signaling(msid_signaling);
2832
wu@webrtc.orgcecfd182013-10-30 05:18:12 +00002833 size_t end_of_message = message.size();
2834 if (mline_index == -1 && *pos != end_of_message) {
2835 ParseFailed(message, *pos, "Expects m line.", error);
2836 return false;
2837 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002838 return true;
2839}
2840
2841bool VerifyCodec(const cricket::Codec& codec) {
2842 // Codec has not been populated correctly unless the name has been set. This
2843 // can happen if an SDP has an fmtp or rtcp-fb with a payload type but doesn't
2844 // have a corresponding "rtpmap" line.
htab39db842016-12-08 01:50:48 -08002845 return !codec.name.empty();
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002846}
2847
2848bool VerifyAudioCodecs(const AudioContentDescription* audio_desc) {
Steve Anton64b626b2019-01-28 17:25:26 -08002849 return absl::c_all_of(audio_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002850}
2851
2852bool VerifyVideoCodecs(const VideoContentDescription* video_desc) {
Steve Anton64b626b2019-01-28 17:25:26 -08002853 return absl::c_all_of(video_desc->codecs(), &VerifyCodec);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002854}
2855
2856void AddParameters(const cricket::CodecParameterMap& parameters,
2857 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002858 for (const auto& entry : parameters) {
2859 const std::string& key = entry.first;
2860 const std::string& value = entry.second;
2861 codec->SetParam(key, value);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002862 }
2863}
2864
2865void AddFeedbackParameter(const cricket::FeedbackParam& feedback_param,
2866 cricket::Codec* codec) {
2867 codec->AddFeedbackParam(feedback_param);
2868}
2869
2870void AddFeedbackParameters(const cricket::FeedbackParams& feedback_params,
2871 cricket::Codec* codec) {
Steve Anton4daf66e2018-09-07 14:55:53 -07002872 for (const cricket::FeedbackParam& param : feedback_params.params()) {
2873 codec->AddFeedbackParam(param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002874 }
2875}
2876
2877// Gets the current codec setting associated with |payload_type|. If there
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002878// is no Codec associated with that payload type it returns an empty codec
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002879// with that payload type.
2880template <class T>
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002881T GetCodecWithPayloadType(const std::vector<T>& codecs, int payload_type) {
magjedb05fa242016-11-11 04:00:16 -08002882 const T* codec = FindCodecById(codecs, payload_type);
2883 if (codec)
2884 return *codec;
2885 // Return empty codec with |payload_type|.
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002886 T ret_val;
magjedb05fa242016-11-11 04:00:16 -08002887 ret_val.id = payload_type;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002888 return ret_val;
2889}
2890
2891// Updates or creates a new codec entry in the audio description.
2892template <class T, class U>
2893void AddOrReplaceCodec(MediaContentDescription* content_desc, const U& codec) {
2894 T* desc = static_cast<T*>(content_desc);
2895 std::vector<U> codecs = desc->codecs();
2896 bool found = false;
Steve Anton4daf66e2018-09-07 14:55:53 -07002897 for (U& existing_codec : codecs) {
2898 if (codec.id == existing_codec.id) {
2899 // Overwrite existing codec with the new codec.
2900 existing_codec = codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002901 found = true;
2902 break;
2903 }
2904 }
2905 if (!found) {
2906 desc->AddCodec(codec);
2907 return;
2908 }
2909 desc->set_codecs(codecs);
2910}
2911
2912// Adds or updates existing codec corresponding to |payload_type| according
2913// to |parameters|.
2914template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002915void UpdateCodec(MediaContentDescription* content_desc,
2916 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002917 const cricket::CodecParameterMap& parameters) {
2918 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002919 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2920 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002921 AddParameters(parameters, &new_codec);
2922 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2923}
2924
2925// Adds or updates existing codec corresponding to |payload_type| according
2926// to |feedback_param|.
2927template <class T, class U>
Yves Gerey665174f2018-06-19 15:03:05 +02002928void UpdateCodec(MediaContentDescription* content_desc,
2929 int payload_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002930 const cricket::FeedbackParam& feedback_param) {
2931 // Codec might already have been populated (from rtpmap).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00002932 U new_codec = GetCodecWithPayloadType(static_cast<T*>(content_desc)->codecs(),
2933 payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002934 AddFeedbackParameter(feedback_param, &new_codec);
2935 AddOrReplaceCodec<T, U>(content_desc, new_codec);
2936}
2937
Mirta Dvornicic479a3c02019-06-04 15:38:50 +02002938// Adds or updates existing video codec corresponding to |payload_type|
2939// according to |packetization|.
2940void UpdateVideoCodecPacketization(VideoContentDescription* video_desc,
2941 int payload_type,
2942 const std::string& packetization) {
2943 if (packetization != cricket::kPacketizationParamRaw) {
2944 // Ignore unsupported packetization attribute.
2945 return;
2946 }
2947
2948 // Codec might already have been populated (from rtpmap).
2949 cricket::VideoCodec codec =
2950 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
2951 codec.packetization = packetization;
2952 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
2953 codec);
2954}
2955
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002956template <class T>
2957bool PopWildcardCodec(std::vector<T>* codecs, T* wildcard_codec) {
2958 for (auto iter = codecs->begin(); iter != codecs->end(); ++iter) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002959 if (iter->id == kWildcardPayloadType) {
2960 *wildcard_codec = *iter;
2961 codecs->erase(iter);
2962 return true;
2963 }
2964 }
2965 return false;
2966}
2967
Yves Gerey665174f2018-06-19 15:03:05 +02002968template <class T>
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002969void UpdateFromWildcardCodecs(cricket::MediaContentDescriptionImpl<T>* desc) {
2970 auto codecs = desc->codecs();
2971 T wildcard_codec;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002972 if (!PopWildcardCodec(&codecs, &wildcard_codec)) {
2973 return;
2974 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002975 for (auto& codec : codecs) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002976 AddFeedbackParameters(wildcard_codec.feedback_params, &codec);
2977 }
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00002978 desc->set_codecs(codecs);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002979}
2980
Yves Gerey665174f2018-06-19 15:03:05 +02002981void AddAudioAttribute(const std::string& name,
2982 const std::string& value,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002983 AudioContentDescription* audio_desc) {
2984 if (value.empty()) {
2985 return;
2986 }
2987 std::vector<cricket::AudioCodec> codecs = audio_desc->codecs();
Steve Anton4daf66e2018-09-07 14:55:53 -07002988 for (cricket::AudioCodec& codec : codecs) {
2989 codec.params[name] = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002990 }
2991 audio_desc->set_codecs(codecs);
2992}
2993
2994bool ParseContent(const std::string& message,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02002995 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002996 int mline_index,
2997 const std::string& protocol,
deadbeef67cf2c12016-04-13 10:07:16 -07002998 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00002999 size_t* pos,
3000 std::string* content_name,
deadbeef25ed4352016-12-12 18:37:36 -08003001 bool* bundle_only,
Steve Antone831b8c2018-02-01 12:22:16 -08003002 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003003 MediaContentDescription* media_desc,
3004 TransportDescription* transport,
Steve Anton5a1de872018-12-18 11:25:55 -08003005 std::vector<std::unique_ptr<JsepIceCandidate>>* candidates,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003006 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003007 RTC_DCHECK(media_desc != NULL);
3008 RTC_DCHECK(content_name != NULL);
3009 RTC_DCHECK(transport != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003010
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00003011 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003012 MaybeCreateStaticPayloadAudioCodecs(payload_types, media_desc->as_audio());
henrike@webrtc.org704bf9e2014-02-27 17:52:04 +00003013 }
3014
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003015 // The media level "ice-ufrag" and "ice-pwd".
3016 // The candidates before update the media level "ice-pwd" and "ice-ufrag".
3017 Candidates candidates_orig;
3018 std::string line;
3019 std::string mline_id;
3020 // Tracks created out of the ssrc attributes.
3021 StreamParamsVec tracks;
3022 SsrcInfoVec ssrc_infos;
3023 SsrcGroupVec ssrc_groups;
3024 std::string maxptime_as_string;
3025 std::string ptime_as_string;
Seth Hampson5b4f0752018-04-02 16:31:36 -07003026 std::vector<std::string> stream_ids;
deadbeef9d3584c2016-02-16 17:54:10 -08003027 std::string track_id;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003028 SdpSerializer deserializer;
3029 std::vector<RidDescription> rids;
Amit Hilbucha2012042018-12-03 11:35:05 -08003030 SimulcastDescription simulcast;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003031
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003032 // Loop until the next m line
3033 while (!IsLineType(message, kLineTypeMedia, *pos)) {
3034 if (!GetLine(message, pos, &line)) {
3035 if (*pos >= message.size()) {
3036 break; // Done parsing
3037 } else {
sergeyu@chromium.org5bc25c42013-12-05 00:24:06 +00003038 return ParseFailed(message, *pos, "Invalid SDP line.", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003039 }
3040 }
3041
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003042 // RFC 4566
3043 // b=* (zero or more bandwidth information lines)
3044 if (IsLineType(line, kLineTypeSessionBandwidth)) {
3045 std::string bandwidth;
3046 if (HasAttribute(line, kApplicationSpecificMaximum)) {
3047 if (!GetValue(line, kApplicationSpecificMaximum, &bandwidth, error)) {
3048 return false;
3049 } else {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003050 int b = 0;
3051 if (!GetValueFromString(line, bandwidth, &b, error)) {
3052 return false;
3053 }
deadbeef3e8016e2017-08-03 17:49:30 -07003054 // TODO(deadbeef): Historically, applications may be setting a value
3055 // of -1 to mean "unset any previously set bandwidth limit", even
3056 // though ommitting the "b=AS" entirely will do just that. Once we've
3057 // transitioned applications to doing the right thing, it would be
3058 // better to treat this as a hard error instead of just ignoring it.
3059 if (b == -1) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003060 RTC_LOG(LS_WARNING)
3061 << "Ignoring \"b=AS:-1\"; will be treated as \"no "
3062 "bandwidth limit\".";
deadbeef3e8016e2017-08-03 17:49:30 -07003063 continue;
3064 }
deadbeefbc88c6b2017-08-02 11:26:34 -07003065 if (b < 0) {
3066 return ParseFailed(line, "b=AS value can't be negative.", error);
3067 }
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003068 // We should never use more than the default bandwidth for RTP-based
3069 // data channels. Don't allow SDP to set the bandwidth, because
3070 // that would give JS the opportunity to "break the Internet".
3071 // See: https://code.google.com/p/chromium/issues/detail?id=280726
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003072 if (media_type == cricket::MEDIA_TYPE_DATA &&
3073 cricket::IsRtpProtocol(protocol) &&
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003074 b > cricket::kDataMaxBandwidth / 1000) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003075 rtc::StringBuilder description;
Peter Thatcherc0c3a862015-06-24 15:31:25 -07003076 description << "RTP-based data channels may not send more than "
3077 << cricket::kDataMaxBandwidth / 1000 << "kbps.";
3078 return ParseFailed(line, description.str(), error);
3079 }
deadbeefb2362572016-12-13 16:37:06 -08003080 // Prevent integer overflow.
3081 b = std::min(b, INT_MAX / 1000);
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003082 media_desc->set_bandwidth(b * 1000);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003083 }
3084 }
3085 continue;
3086 }
3087
zhihuang38989e52017-03-21 11:04:53 -07003088 // Parse the media level connection data.
3089 if (IsLineType(line, kLineTypeConnection)) {
3090 rtc::SocketAddress addr;
3091 if (!ParseConnectionData(line, &addr, error)) {
3092 return false;
3093 }
3094 media_desc->set_connection_address(addr);
3095 continue;
3096 }
3097
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003098 if (!IsLineType(line, kLineTypeAttributes)) {
Steve Anton36b29d12017-10-30 09:57:42 -07003099 // TODO(deadbeef): Handle other lines if needed.
Mirko Bonadei675513b2017-11-09 11:09:25 +01003100 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003101 continue;
3102 }
3103
3104 // Handle attributes common to SCTP and RTP.
3105 if (HasAttribute(line, kAttributeMid)) {
3106 // RFC 3388
3107 // mid-attribute = "a=mid:" identification-tag
3108 // identification-tag = token
3109 // Use the mid identification-tag as the content name.
3110 if (!GetValue(line, kAttributeMid, &mline_id, error)) {
3111 return false;
3112 }
3113 *content_name = mline_id;
deadbeef25ed4352016-12-12 18:37:36 -08003114 } else if (HasAttribute(line, kAttributeBundleOnly)) {
3115 *bundle_only = true;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003116 } else if (HasAttribute(line, kAttributeCandidate)) {
3117 Candidate candidate;
3118 if (!ParseCandidate(line, &candidate, error, false)) {
3119 return false;
3120 }
deadbeef7bcdb692017-01-20 12:43:58 -08003121 // ParseCandidate will parse non-standard ufrag and password attributes,
3122 // since it's used for candidate trickling, but we only want to process
3123 // the "a=ice-ufrag"/"a=ice-pwd" values in a session description, so
3124 // strip them off at this point.
3125 candidate.set_username(std::string());
3126 candidate.set_password(std::string());
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003127 candidates_orig.push_back(candidate);
3128 } else if (HasAttribute(line, kAttributeIceUfrag)) {
3129 if (!GetValue(line, kAttributeIceUfrag, &transport->ice_ufrag, error)) {
3130 return false;
3131 }
3132 } else if (HasAttribute(line, kAttributeIcePwd)) {
3133 if (!GetValue(line, kAttributeIcePwd, &transport->ice_pwd, error)) {
3134 return false;
3135 }
3136 } else if (HasAttribute(line, kAttributeIceOption)) {
3137 if (!ParseIceOptions(line, &transport->transport_options, error)) {
3138 return false;
3139 }
3140 } else if (HasAttribute(line, kAttributeFmtp)) {
3141 if (!ParseFmtpAttributes(line, media_type, media_desc, error)) {
3142 return false;
3143 }
3144 } else if (HasAttribute(line, kAttributeFingerprint)) {
Steve Anton4905edb2018-10-15 19:27:44 -07003145 std::unique_ptr<rtc::SSLFingerprint> fingerprint;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003146 if (!ParseFingerprintAttribute(line, &fingerprint, error)) {
3147 return false;
3148 }
Steve Anton4905edb2018-10-15 19:27:44 -07003149 transport->identity_fingerprint = std::move(fingerprint);
sergeyu@chromium.org0be6aa02013-08-23 23:21:25 +00003150 } else if (HasAttribute(line, kAttributeSetup)) {
3151 if (!ParseDtlsSetup(line, &(transport->connection_role), error)) {
3152 return false;
3153 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003154 } else if (cricket::IsDtlsSctp(protocol) &&
3155 HasAttribute(line, kAttributeSctpPort)) {
deadbeef7e146cb2016-09-28 10:04:34 -07003156 if (media_type != cricket::MEDIA_TYPE_DATA) {
3157 return ParseFailed(
3158 line, "sctp-port attribute found in non-data media description.",
3159 error);
3160 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003161 if (media_desc->as_sctp()->use_sctpmap()) {
3162 return ParseFailed(
3163 line, "sctp-port attribute can't be used with sctpmap.", error);
3164 }
jiayl@webrtc.orgddb85ab2014-09-05 16:31:56 +00003165 int sctp_port;
3166 if (!ParseSctpPort(line, &sctp_port, error)) {
3167 return false;
3168 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003169 media_desc->as_sctp()->set_port(sctp_port);
3170 } else if (cricket::IsDtlsSctp(protocol) &&
Harald Alvestrand48cce4d2019-04-11 10:41:24 +02003171 HasAttribute(line, kAttributeMaxMessageSize)) {
3172 if (media_type != cricket::MEDIA_TYPE_DATA) {
3173 return ParseFailed(
3174 line,
3175 "max-message-size attribute found in non-data media description.",
3176 error);
3177 }
3178 int max_message_size;
3179 if (!ParseSctpMaxMessageSize(line, &max_message_size, error)) {
3180 return false;
3181 }
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003182 media_desc->as_sctp()->set_max_message_size(max_message_size);
3183 } else if (cricket::IsRtpProtocol(protocol)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003184 //
3185 // RTP specific attrubtes
3186 //
3187 if (HasAttribute(line, kAttributeRtcpMux)) {
3188 media_desc->set_rtcp_mux(true);
deadbeef13871492015-12-09 12:37:51 -08003189 } else if (HasAttribute(line, kAttributeRtcpReducedSize)) {
3190 media_desc->set_rtcp_reduced_size(true);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003191 } else if (HasAttribute(line, kAttributeSsrcGroup)) {
3192 if (!ParseSsrcGroupAttribute(line, &ssrc_groups, error)) {
3193 return false;
3194 }
3195 } else if (HasAttribute(line, kAttributeSsrc)) {
Steve Antone831b8c2018-02-01 12:22:16 -08003196 if (!ParseSsrcAttribute(line, &ssrc_infos, msid_signaling, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003197 return false;
3198 }
3199 } else if (HasAttribute(line, kAttributeCrypto)) {
3200 if (!ParseCryptoAttribute(line, media_desc, error)) {
3201 return false;
3202 }
3203 } else if (HasAttribute(line, kAttributeRtpmap)) {
deadbeef67cf2c12016-04-13 10:07:16 -07003204 if (!ParseRtpmapAttribute(line, media_type, payload_types, media_desc,
3205 error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003206 return false;
3207 }
3208 } else if (HasAttribute(line, kCodecParamMaxPTime)) {
3209 if (!GetValue(line, kCodecParamMaxPTime, &maxptime_as_string, error)) {
3210 return false;
3211 }
Mirta Dvornicic479a3c02019-06-04 15:38:50 +02003212 } else if (HasAttribute(line, kAttributePacketization)) {
3213 if (!ParsePacketizationAttribute(line, media_type, media_desc, error)) {
3214 return false;
3215 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003216 } else if (HasAttribute(line, kAttributeRtcpFb)) {
3217 if (!ParseRtcpFbAttribute(line, media_type, media_desc, error)) {
3218 return false;
3219 }
3220 } else if (HasAttribute(line, kCodecParamPTime)) {
3221 if (!GetValue(line, kCodecParamPTime, &ptime_as_string, error)) {
3222 return false;
3223 }
3224 } else if (HasAttribute(line, kAttributeSendOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003225 media_desc->set_direction(RtpTransceiverDirection::kSendOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003226 } else if (HasAttribute(line, kAttributeRecvOnly)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003227 media_desc->set_direction(RtpTransceiverDirection::kRecvOnly);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003228 } else if (HasAttribute(line, kAttributeInactive)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003229 media_desc->set_direction(RtpTransceiverDirection::kInactive);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003230 } else if (HasAttribute(line, kAttributeSendRecv)) {
Steve Anton4e70a722017-11-28 14:57:10 -08003231 media_desc->set_direction(RtpTransceiverDirection::kSendRecv);
Johannes Kron0854eb62018-10-10 22:33:20 +02003232 } else if (HasAttribute(line, kAttributeExtmapAllowMixed)) {
Johannes Kron9581bc42018-10-23 10:17:39 +02003233 media_desc->set_extmap_allow_mixed_enum(
Johannes Kron0854eb62018-10-10 22:33:20 +02003234 MediaContentDescription::kMedia);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003235 } else if (HasAttribute(line, kAttributeExtmap)) {
isheriff6f8d6862016-05-26 11:24:55 -07003236 RtpExtension extmap;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003237 if (!ParseExtmap(line, &extmap, error)) {
3238 return false;
3239 }
3240 media_desc->AddRtpHeaderExtension(extmap);
3241 } else if (HasAttribute(line, kAttributeXGoogleFlag)) {
3242 // Experimental attribute. Conference mode activates more aggressive
3243 // AEC and NS settings.
Steve Anton36b29d12017-10-30 09:57:42 -07003244 // TODO(deadbeef): expose API to set these directly.
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003245 std::string flag_value;
3246 if (!GetValue(line, kAttributeXGoogleFlag, &flag_value, error)) {
3247 return false;
3248 }
3249 if (flag_value.compare(kValueConference) == 0)
3250 media_desc->set_conference_mode(true);
deadbeef9d3584c2016-02-16 17:54:10 -08003251 } else if (HasAttribute(line, kAttributeMsid)) {
Seth Hampson5b4f0752018-04-02 16:31:36 -07003252 if (!ParseMsidAttribute(line, &stream_ids, &track_id, error)) {
deadbeef9d3584c2016-02-16 17:54:10 -08003253 return false;
3254 }
Steve Antone831b8c2018-02-01 12:22:16 -08003255 *msid_signaling |= cricket::kMsidSignalingMediaSection;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003256 } else if (HasAttribute(line, kAttributeRid)) {
3257 const size_t kRidPrefixLength =
3258 kLinePrefixLength + arraysize(kAttributeRid);
3259 if (line.size() <= kRidPrefixLength) {
3260 RTC_LOG(LS_INFO) << "Ignoring empty RID attribute: " << line;
3261 continue;
3262 }
3263 RTCErrorOr<RidDescription> error_or_rid_description =
3264 deserializer.DeserializeRidDescription(
3265 line.substr(kRidPrefixLength));
3266
3267 // Malformed a=rid lines are discarded.
3268 if (!error_or_rid_description.ok()) {
3269 RTC_LOG(LS_INFO) << "Ignoring malformed RID line: '" << line
3270 << "'. Error: "
3271 << error_or_rid_description.error().message();
3272 continue;
3273 }
3274
3275 rids.push_back(error_or_rid_description.MoveValue());
Amit Hilbucha2012042018-12-03 11:35:05 -08003276 } else if (HasAttribute(line, kAttributeSimulcast)) {
3277 const size_t kSimulcastPrefixLength =
3278 kLinePrefixLength + arraysize(kAttributeSimulcast);
3279 if (line.size() <= kSimulcastPrefixLength) {
3280 return ParseFailed(line, "Simulcast attribute is empty.", error);
3281 }
3282
3283 if (!simulcast.empty()) {
3284 return ParseFailed(line, "Multiple Simulcast attributes specified.",
3285 error);
3286 }
3287
Amit Hilbucha2012042018-12-03 11:35:05 -08003288 RTCErrorOr<SimulcastDescription> error_or_simulcast =
3289 deserializer.DeserializeSimulcastDescription(
3290 line.substr(kSimulcastPrefixLength));
3291 if (!error_or_simulcast.ok()) {
3292 return ParseFailed(line,
3293 std::string("Malformed simulcast line: ") +
3294 error_or_simulcast.error().message(),
3295 error);
3296 }
3297
3298 simulcast = error_or_simulcast.value();
3299 } else {
3300 // Unrecognized attribute in RTP protocol.
3301 RTC_LOG(LS_INFO) << "Ignored line: " << line;
3302 continue;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003303 }
3304 } else {
3305 // Only parse lines that we are interested of.
Mirko Bonadei675513b2017-11-09 11:09:25 +01003306 RTC_LOG(LS_INFO) << "Ignored line: " << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003307 continue;
3308 }
3309 }
3310
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003311 // Remove duplicate or inconsistent rids.
3312 RemoveInvalidRidDescriptions(payload_types, &rids);
3313
3314 // If simulcast is specifed, split the rids into send and receive.
3315 // Rids that do not appear in simulcast attribute will be removed.
3316 // If it is not specified, we assume that all rids are for send layers.
Amit Hilbuchb7446ed2019-01-28 12:25:25 -08003317 std::vector<RidDescription> send_rids;
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003318 if (!simulcast.empty()) {
3319 // Verify that the rids in simulcast match rids in sdp.
3320 RemoveInvalidRidsFromSimulcast(rids, &simulcast);
3321
3322 // Use simulcast description to figure out Send / Receive RIDs.
3323 std::map<std::string, RidDescription> rid_map;
3324 for (const RidDescription& rid : rids) {
3325 rid_map[rid.rid] = rid;
3326 }
3327
3328 for (const auto& layer : simulcast.send_layers().GetAllLayers()) {
3329 auto iter = rid_map.find(layer.rid);
3330 RTC_DCHECK(iter != rid_map.end());
3331 send_rids.push_back(iter->second);
3332 }
3333
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003334 media_desc->set_simulcast_description(simulcast);
3335 } else {
3336 send_rids = rids;
3337 }
3338
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003339 // Create tracks from the |ssrc_infos|.
Taylor Brandstetter5de6b752016-03-09 17:02:30 -08003340 // If the stream_id/track_id for all SSRCS are identical, one StreamParams
3341 // will be created in CreateTracksFromSsrcInfos, containing all the SSRCs from
3342 // the m= section.
Seth Hampson5897a6e2018-04-03 11:16:33 -07003343 if (!ssrc_infos.empty()) {
3344 CreateTracksFromSsrcInfos(ssrc_infos, stream_ids, track_id, &tracks,
3345 *msid_signaling);
3346 } else if (media_type != cricket::MEDIA_TYPE_DATA &&
3347 (*msid_signaling & cricket::kMsidSignalingMediaSection)) {
3348 // If the stream_ids/track_id was signaled but SSRCs were unsignaled we
3349 // still create a track. This isn't done for data media types because
3350 // StreamParams aren't used for SCTP streams, and RTP data channels don't
3351 // support unsignaled SSRCs.
Amit Hilbuchc57d5732018-12-11 15:30:11 -08003352 CreateTrackWithNoSsrcs(stream_ids, track_id, send_rids, &tracks);
3353 }
3354
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003355 // Add the ssrc group to the track.
Steve Anton4daf66e2018-09-07 14:55:53 -07003356 for (const SsrcGroup& ssrc_group : ssrc_groups) {
3357 if (ssrc_group.ssrcs.empty()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003358 continue;
3359 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003360 uint32_t ssrc = ssrc_group.ssrcs.front();
3361 for (StreamParams& track : tracks) {
3362 if (track.has_ssrc(ssrc)) {
3363 track.ssrc_groups.push_back(ssrc_group);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003364 }
3365 }
3366 }
3367
3368 // Add the new tracks to the |media_desc|.
deadbeef9d3584c2016-02-16 17:54:10 -08003369 for (StreamParams& track : tracks) {
3370 media_desc->AddStream(track);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003371 }
3372
3373 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003374 AudioContentDescription* audio_desc = media_desc->as_audio();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003375 UpdateFromWildcardCodecs(audio_desc);
3376
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003377 // Verify audio codec ensures that no audio codec has been populated with
3378 // only fmtp.
3379 if (!VerifyAudioCodecs(audio_desc)) {
3380 return ParseFailed("Failed to parse audio codecs correctly.", error);
3381 }
3382 AddAudioAttribute(kCodecParamMaxPTime, maxptime_as_string, audio_desc);
3383 AddAudioAttribute(kCodecParamPTime, ptime_as_string, audio_desc);
3384 }
3385
3386 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003387 VideoContentDescription* video_desc = media_desc->as_video();
jlmiller@webrtc.orga744a282015-02-18 21:37:46 +00003388 UpdateFromWildcardCodecs(video_desc);
3389 // Verify video codec ensures that no video codec has been populated with
3390 // only rtcp-fb.
3391 if (!VerifyVideoCodecs(video_desc)) {
3392 return ParseFailed("Failed to parse video codecs correctly.", error);
3393 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003394 }
3395
3396 // RFC 5245
3397 // Update the candidates with the media level "ice-pwd" and "ice-ufrag".
Steve Anton4daf66e2018-09-07 14:55:53 -07003398 for (Candidate& candidate : candidates_orig) {
3399 RTC_DCHECK(candidate.username().empty() ||
3400 candidate.username() == transport->ice_ufrag);
3401 candidate.set_username(transport->ice_ufrag);
3402 RTC_DCHECK(candidate.password().empty());
3403 candidate.set_password(transport->ice_pwd);
3404 candidates->push_back(
Steve Anton5a1de872018-12-18 11:25:55 -08003405 absl::make_unique<JsepIceCandidate>(mline_id, mline_index, candidate));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003406 }
Amit Hilbucha2012042018-12-03 11:35:05 -08003407
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003408 return true;
3409}
3410
Steve Antone831b8c2018-02-01 12:22:16 -08003411bool ParseSsrcAttribute(const std::string& line,
3412 SsrcInfoVec* ssrc_infos,
3413 int* msid_signaling,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003414 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003415 RTC_DCHECK(ssrc_infos != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003416 // RFC 5576
3417 // a=ssrc:<ssrc-id> <attribute>
3418 // a=ssrc:<ssrc-id> <attribute>:<value>
3419 std::string field1, field2;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003420 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3421 kSdpDelimiterSpaceChar, &field1, &field2)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003422 const size_t expected_fields = 2;
3423 return ParseFailedExpectFieldNum(line, expected_fields, error);
3424 }
3425
3426 // ssrc:<ssrc-id>
3427 std::string ssrc_id_s;
3428 if (!GetValue(field1, kAttributeSsrc, &ssrc_id_s, error)) {
3429 return false;
3430 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003431 uint32_t ssrc_id = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003432 if (!GetValueFromString(line, ssrc_id_s, &ssrc_id, error)) {
3433 return false;
3434 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003435
3436 std::string attribute;
3437 std::string value;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003438 if (!rtc::tokenize_first(field2, kSdpDelimiterColonChar, &attribute,
3439 &value)) {
3440 rtc::StringBuilder description;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003441 description << "Failed to get the ssrc attribute value from " << field2
3442 << ". Expected format <attribute>:<value>.";
3443 return ParseFailed(line, description.str(), error);
3444 }
3445
3446 // Check if there's already an item for this |ssrc_id|. Create a new one if
3447 // there isn't.
Steve Anton64b626b2019-01-28 17:25:26 -08003448 auto ssrc_info_it =
3449 absl::c_find_if(*ssrc_infos, [ssrc_id](const SsrcInfo& ssrc_info) {
3450 return ssrc_info.ssrc_id == ssrc_id;
3451 });
Steve Anton4daf66e2018-09-07 14:55:53 -07003452 if (ssrc_info_it == ssrc_infos->end()) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003453 SsrcInfo info;
3454 info.ssrc_id = ssrc_id;
3455 ssrc_infos->push_back(info);
Steve Anton4daf66e2018-09-07 14:55:53 -07003456 ssrc_info_it = ssrc_infos->end() - 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003457 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003458 SsrcInfo& ssrc_info = *ssrc_info_it;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003459
3460 // Store the info to the |ssrc_info|.
3461 if (attribute == kSsrcAttributeCname) {
3462 // RFC 5576
3463 // cname:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003464 ssrc_info.cname = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003465 } else if (attribute == kSsrcAttributeMsid) {
3466 // draft-alvestrand-mmusic-msid-00
Seth Hampson5b4f0752018-04-02 16:31:36 -07003467 // msid:identifier [appdata]
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003468 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003469 rtc::split(value, kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003470 if (fields.size() < 1 || fields.size() > 2) {
Yves Gerey665174f2018-06-19 15:03:05 +02003471 return ParseFailed(
3472 line, "Expected format \"msid:<identifier>[ <appdata>]\".", error);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003473 }
Steve Anton4daf66e2018-09-07 14:55:53 -07003474 ssrc_info.stream_id = fields[0];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003475 if (fields.size() == 2) {
Steve Anton4daf66e2018-09-07 14:55:53 -07003476 ssrc_info.track_id = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003477 }
Steve Antone831b8c2018-02-01 12:22:16 -08003478 *msid_signaling |= cricket::kMsidSignalingSsrcAttribute;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003479 } else if (attribute == kSsrcAttributeMslabel) {
3480 // draft-alvestrand-rtcweb-mid-01
3481 // mslabel:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003482 ssrc_info.mslabel = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003483 } else if (attribute == kSSrcAttributeLabel) {
3484 // The label isn't defined.
3485 // label:<value>
Steve Anton4daf66e2018-09-07 14:55:53 -07003486 ssrc_info.label = value;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003487 }
3488 return true;
3489}
3490
3491bool ParseSsrcGroupAttribute(const std::string& line,
3492 SsrcGroupVec* ssrc_groups,
3493 SdpParseError* error) {
nisseede5da42017-01-12 05:15:36 -08003494 RTC_DCHECK(ssrc_groups != NULL);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003495 // RFC 5576
3496 // a=ssrc-group:<semantics> <ssrc-id> ...
3497 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003498 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003499 const size_t expected_min_fields = 2;
3500 if (fields.size() < expected_min_fields) {
3501 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3502 }
3503 std::string semantics;
3504 if (!GetValue(fields[0], kAttributeSsrcGroup, &semantics, error)) {
3505 return false;
3506 }
Peter Boström0c4e06b2015-10-07 12:23:21 +02003507 std::vector<uint32_t> ssrcs;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003508 for (size_t i = 1; i < fields.size(); ++i) {
Peter Boström0c4e06b2015-10-07 12:23:21 +02003509 uint32_t ssrc = 0;
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003510 if (!GetValueFromString(line, fields[i], &ssrc, error)) {
3511 return false;
3512 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003513 ssrcs.push_back(ssrc);
3514 }
3515 ssrc_groups->push_back(SsrcGroup(semantics, ssrcs));
3516 return true;
3517}
3518
3519bool ParseCryptoAttribute(const std::string& line,
3520 MediaContentDescription* media_desc,
3521 SdpParseError* error) {
3522 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003523 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003524 // RFC 4568
3525 // a=crypto:<tag> <crypto-suite> <key-params> [<session-params>]
3526 const size_t expected_min_fields = 3;
3527 if (fields.size() < expected_min_fields) {
3528 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3529 }
3530 std::string tag_value;
3531 if (!GetValue(fields[0], kAttributeCrypto, &tag_value, error)) {
3532 return false;
3533 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003534 int tag = 0;
3535 if (!GetValueFromString(line, tag_value, &tag, error)) {
3536 return false;
3537 }
jbauch083b73f2015-07-16 02:46:32 -07003538 const std::string& crypto_suite = fields[1];
3539 const std::string& key_params = fields[2];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003540 std::string session_params;
3541 if (fields.size() > 3) {
3542 session_params = fields[3];
3543 }
Yves Gerey665174f2018-06-19 15:03:05 +02003544 media_desc->AddCrypto(
3545 CryptoParams(tag, crypto_suite, key_params, session_params));
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003546 return true;
3547}
3548
3549// Updates or creates a new codec entry in the audio description with according
deadbeef67cf2c12016-04-13 10:07:16 -07003550// to |name|, |clockrate|, |bitrate|, and |channels|.
3551void UpdateCodec(int payload_type,
3552 const std::string& name,
3553 int clockrate,
3554 int bitrate,
3555 size_t channels,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003556 AudioContentDescription* audio_desc) {
3557 // Codec may already be populated with (only) optional parameters
3558 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003559 cricket::AudioCodec codec =
3560 GetCodecWithPayloadType(audio_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003561 codec.name = name;
3562 codec.clockrate = clockrate;
3563 codec.bitrate = bitrate;
3564 codec.channels = channels;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003565 AddOrReplaceCodec<AudioContentDescription, cricket::AudioCodec>(audio_desc,
3566 codec);
3567}
3568
3569// Updates or creates a new codec entry in the video description according to
deadbeef67cf2c12016-04-13 10:07:16 -07003570// |name|, |width|, |height|, and |framerate|.
3571void UpdateCodec(int payload_type,
3572 const std::string& name,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003573 VideoContentDescription* video_desc) {
3574 // Codec may already be populated with (only) optional parameters
3575 // (from an fmtp).
changbin.shao@webrtc.org2d25b442015-03-16 04:14:34 +00003576 cricket::VideoCodec codec =
3577 GetCodecWithPayloadType(video_desc->codecs(), payload_type);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003578 codec.name = name;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003579 AddOrReplaceCodec<VideoContentDescription, cricket::VideoCodec>(video_desc,
3580 codec);
3581}
3582
3583bool ParseRtpmapAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003584 const cricket::MediaType media_type,
deadbeef67cf2c12016-04-13 10:07:16 -07003585 const std::vector<int>& payload_types,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003586 MediaContentDescription* media_desc,
3587 SdpParseError* error) {
3588 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003589 rtc::split(line.substr(kLinePrefixLength), kSdpDelimiterSpaceChar, &fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003590 // RFC 4566
3591 // a=rtpmap:<payload type> <encoding name>/<clock rate>[/<encodingparameters>]
3592 const size_t expected_min_fields = 2;
3593 if (fields.size() < expected_min_fields) {
3594 return ParseFailedExpectMinFieldNum(line, expected_min_fields, error);
3595 }
3596 std::string payload_type_value;
3597 if (!GetValue(fields[0], kAttributeRtpmap, &payload_type_value, error)) {
3598 return false;
3599 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003600 int payload_type = 0;
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003601 if (!GetPayloadTypeFromString(line, payload_type_value, &payload_type,
3602 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003603 return false;
3604 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003605
Steve Anton64b626b2019-01-28 17:25:26 -08003606 if (!absl::c_linear_search(payload_types, payload_type)) {
Mirko Bonadei675513b2017-11-09 11:09:25 +01003607 RTC_LOG(LS_WARNING) << "Ignore rtpmap line that did not appear in the "
Jonas Olsson45cc8902018-02-13 10:37:07 +01003608 "<fmt> of the m-line: "
3609 << line;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003610 return true;
3611 }
jbauch083b73f2015-07-16 02:46:32 -07003612 const std::string& encoder = fields[1];
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003613 std::vector<std::string> codec_params;
buildbot@webrtc.orgd4e598d2014-07-29 17:36:52 +00003614 rtc::split(encoder, '/', &codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003615 // <encoding name>/<clock rate>[/<encodingparameters>]
3616 // 2 mandatory fields
3617 if (codec_params.size() < 2 || codec_params.size() > 3) {
3618 return ParseFailed(line,
3619 "Expected format \"<encoding name>/<clock rate>"
3620 "[/<encodingparameters>]\".",
3621 error);
3622 }
jbauch083b73f2015-07-16 02:46:32 -07003623 const std::string& encoding_name = codec_params[0];
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003624 int clock_rate = 0;
3625 if (!GetValueFromString(line, codec_params[1], &clock_rate, error)) {
3626 return false;
3627 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003628 if (media_type == cricket::MEDIA_TYPE_VIDEO) {
Steve Antonb1c1de12017-12-21 15:14:30 -08003629 VideoContentDescription* video_desc = media_desc->as_video();
Yves Gerey665174f2018-06-19 15:03:05 +02003630 UpdateCodec(payload_type, encoding_name, video_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003631 } else if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3632 // RFC 4566
3633 // For audio streams, <encoding parameters> indicates the number
3634 // of audio channels. This parameter is OPTIONAL and may be
3635 // omitted if the number of channels is one, provided that no
3636 // additional parameters are needed.
Peter Kasting69558702016-01-12 16:26:35 -08003637 size_t channels = 1;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003638 if (codec_params.size() == 3) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003639 if (!GetValueFromString(line, codec_params[2], &channels, error)) {
3640 return false;
3641 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003642 }
Steve Antonb1c1de12017-12-21 15:14:30 -08003643 AudioContentDescription* audio_desc = media_desc->as_audio();
ossue1405ad2017-01-23 08:55:48 -08003644 UpdateCodec(payload_type, encoding_name, clock_rate, 0, channels,
deadbeef67cf2c12016-04-13 10:07:16 -07003645 audio_desc);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003646 } else if (media_type == cricket::MEDIA_TYPE_DATA) {
Harald Alvestrand5fc28b12019-05-13 13:36:16 +02003647 RtpDataContentDescription* data_desc = media_desc->as_rtp_data();
3648 if (data_desc) {
3649 data_desc->AddCodec(cricket::RtpDataCodec(payload_type, encoding_name));
3650 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003651 }
3652 return true;
3653}
3654
Yves Gerey665174f2018-06-19 15:03:05 +02003655bool ParseFmtpParam(const std::string& line,
3656 std::string* parameter,
3657 std::string* value,
3658 SdpParseError* error) {
Jonas Olssonec9e4922018-09-05 09:53:49 +02003659 if (!rtc::tokenize_first(line, kSdpDelimiterEqualChar, parameter, value)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003660 ParseFailed(line, "Unable to parse fmtp parameter. \'=\' missing.", error);
3661 return false;
3662 }
3663 // a=fmtp:<payload_type> <param1>=<value1>; <param2>=<value2>; ...
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003664 return true;
3665}
3666
Yves Gerey665174f2018-06-19 15:03:05 +02003667bool ParseFmtpAttributes(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003668 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003669 MediaContentDescription* media_desc,
3670 SdpParseError* error) {
3671 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3672 media_type != cricket::MEDIA_TYPE_VIDEO) {
3673 return true;
3674 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003675
3676 std::string line_payload;
3677 std::string line_params;
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003678
3679 // RFC 5576
3680 // a=fmtp:<format> <format specific parameters>
3681 // At least two fields, whereas the second one is any of the optional
3682 // parameters.
Jonas Olssonec9e4922018-09-05 09:53:49 +02003683 if (!rtc::tokenize_first(line.substr(kLinePrefixLength),
3684 kSdpDelimiterSpaceChar, &line_payload,
3685 &line_params)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003686 ParseFailedExpectMinFieldNum(line, 2, error);
3687 return false;
3688 }
3689
Donald Curtis0e07f922015-05-15 09:21:23 -07003690 // Parse out the payload information.
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003691 std::string payload_type_str;
Donald Curtis0e07f922015-05-15 09:21:23 -07003692 if (!GetValue(line_payload, kAttributeFmtp, &payload_type_str, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003693 return false;
3694 }
3695
Donald Curtis0e07f922015-05-15 09:21:23 -07003696 int payload_type = 0;
Donald Curtis144d0182015-05-15 13:14:24 -07003697 if (!GetPayloadTypeFromString(line_payload, payload_type_str, &payload_type,
3698 error)) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003699 return false;
3700 }
3701
3702 // Parse out format specific parameters.
3703 std::vector<std::string> fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003704 rtc::split(line_params, kSdpDelimiterSemicolonChar, &fields);
Donald Curtis0e07f922015-05-15 09:21:23 -07003705
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003706 cricket::CodecParameterMap codec_params;
Donald Curtis144d0182015-05-15 13:14:24 -07003707 for (auto& iter : fields) {
Donald Curtis0e07f922015-05-15 09:21:23 -07003708 if (iter.find(kSdpDelimiterEqual) == std::string::npos) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003709 // Only fmtps with equals are currently supported. Other fmtp types
3710 // should be ignored. Unknown fmtps do not constitute an error.
3711 continue;
3712 }
Donald Curtis0e07f922015-05-15 09:21:23 -07003713
3714 std::string name;
3715 std::string value;
3716 if (!ParseFmtpParam(rtc::string_trim(iter), &name, &value, error)) {
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003717 return false;
3718 }
3719 codec_params[name] = value;
3720 }
3721
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003722 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
3723 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003724 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003725 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
3726 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003727 media_desc, payload_type, codec_params);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003728 }
3729 return true;
3730}
3731
Mirta Dvornicic479a3c02019-06-04 15:38:50 +02003732bool ParsePacketizationAttribute(const std::string& line,
3733 const cricket::MediaType media_type,
3734 MediaContentDescription* media_desc,
3735 SdpParseError* error) {
3736 if (media_type != cricket::MEDIA_TYPE_VIDEO) {
3737 return true;
3738 }
3739 std::vector<std::string> packetization_fields;
3740 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &packetization_fields);
3741 if (packetization_fields.size() < 2) {
3742 return ParseFailedGetValue(line, kAttributePacketization, error);
3743 }
3744 std::string payload_type_string;
3745 if (!GetValue(packetization_fields[0], kAttributePacketization,
3746 &payload_type_string, error)) {
3747 return false;
3748 }
3749 int payload_type;
3750 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3751 error)) {
3752 return false;
3753 }
3754 std::string packetization = packetization_fields[1];
3755 UpdateVideoCodecPacketization(media_desc->as_video(), payload_type,
3756 packetization);
3757 return true;
3758}
3759
Yves Gerey665174f2018-06-19 15:03:05 +02003760bool ParseRtcpFbAttribute(const std::string& line,
Patrik Höglundb6b29e02018-06-21 16:58:01 +02003761 const cricket::MediaType media_type,
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003762 MediaContentDescription* media_desc,
3763 SdpParseError* error) {
3764 if (media_type != cricket::MEDIA_TYPE_AUDIO &&
3765 media_type != cricket::MEDIA_TYPE_VIDEO) {
3766 return true;
3767 }
3768 std::vector<std::string> rtcp_fb_fields;
Jonas Olssonec9e4922018-09-05 09:53:49 +02003769 rtc::split(line.c_str(), kSdpDelimiterSpaceChar, &rtcp_fb_fields);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003770 if (rtcp_fb_fields.size() < 2) {
3771 return ParseFailedGetValue(line, kAttributeRtcpFb, error);
3772 }
3773 std::string payload_type_string;
3774 if (!GetValue(rtcp_fb_fields[0], kAttributeRtcpFb, &payload_type_string,
3775 error)) {
3776 return false;
3777 }
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003778 int payload_type = kWildcardPayloadType;
3779 if (payload_type_string != "*") {
pkasting@chromium.orge9facf82015-02-17 20:36:28 +00003780 if (!GetPayloadTypeFromString(line, payload_type_string, &payload_type,
3781 error)) {
wu@webrtc.org5e760e72014-04-02 23:19:09 +00003782 return false;
3783 }
3784 }
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003785 std::string id = rtcp_fb_fields[1];
3786 std::string param = "";
3787 for (std::vector<std::string>::iterator iter = rtcp_fb_fields.begin() + 2;
3788 iter != rtcp_fb_fields.end(); ++iter) {
3789 param.append(*iter);
3790 }
3791 const cricket::FeedbackParam feedback_param(id, param);
3792
3793 if (media_type == cricket::MEDIA_TYPE_AUDIO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003794 UpdateCodec<AudioContentDescription, cricket::AudioCodec>(
3795 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003796 } else if (media_type == cricket::MEDIA_TYPE_VIDEO) {
pkasting@chromium.orgd3245462015-02-23 21:28:22 +00003797 UpdateCodec<VideoContentDescription, cricket::VideoCodec>(
3798 media_desc, payload_type, feedback_param);
henrike@webrtc.org28e20752013-07-10 00:45:36 +00003799 }
3800 return true;
3801}
3802
3803} // namespace webrtc