ZLMediaKit/webrtc/Sdp.h

754 lines
23 KiB
C++
Raw Normal View History

2021-04-09 20:42:36 +08:00
/*
* Copyright (c) 2016 The ZLMediaKit project authors. All Rights Reserved.
*
* This file is part of ZLMediaKit(https://github.com/xia-chu/ZLMediaKit).
*
* Use of this source code is governed by MIT license that can be found in the
* LICENSE file in the root of the source tree. All contributing project authors
* may be found in the AUTHORS file in the root of the source tree.
*/
2021-03-27 18:33:20 +08:00
#ifndef ZLMEDIAKIT_SDP_H
#define ZLMEDIAKIT_SDP_H
#include <string>
2021-03-27 22:23:38 +08:00
#include <vector>
2021-05-07 14:02:03 +08:00
#include "RtpExt.h"
2021-03-31 18:32:43 +08:00
#include "assert.h"
2021-03-27 22:23:38 +08:00
#include "Extension/Frame.h"
2021-04-15 19:35:25 +08:00
#include "Common/Parser.h"
2021-03-27 18:33:20 +08:00
using namespace std;
2021-03-27 22:23:38 +08:00
using namespace mediakit;
2021-03-27 18:33:20 +08:00
2021-03-27 22:23:38 +08:00
//https://datatracker.ietf.org/doc/rfc4566/?include_text=1
2021-03-28 23:52:26 +08:00
//https://blog.csdn.net/aggresss/article/details/109850434
//https://aggresss.blog.csdn.net/article/details/106436703
2021-03-27 18:33:20 +08:00
//Session description
// v= (protocol version)
// o= (originator and session identifier)
// s= (session name)
// i=* (session information)
// u=* (URI of description)
// e=* (email address)
// p=* (phone number)
// c=* (connection information -- not required if included in
// all media)
// b=* (zero or more bandwidth information lines)
// One or more time descriptions ("t=" and "r=" lines; see below)
// z=* (time zone adjustments)
// k=* (encryption key)
// a=* (zero or more session attribute lines)
// Zero or more media descriptions
//
// Time description
// t= (time the session is active)
// r=* (zero or more repeat times)
//
// Media description, if present
// m= (media name and transport address)
// i=* (media title)
// c=* (connection information -- optional if included at
// session level)
// b=* (zero or more bandwidth information lines)
// k=* (encryption key)
// a=* (zero or more media attribute lines)
2021-03-27 22:23:38 +08:00
enum class RtpDirection {
invalid = -1,
//只发送
sendonly,
//只接收
2021-03-28 17:32:53 +08:00
recvonly,
2021-03-27 22:23:38 +08:00
//同时发送接收
sendrecv,
//禁止发送数据
inactive
};
enum class DtlsRole {
invalid = -1,
//客户端
active,
//服务端
passive,
//既可作做客户端也可以做服务端
actpass,
};
enum class SdpType {
invalid = -1,
offer,
answer
};
2021-03-28 17:32:53 +08:00
DtlsRole getDtlsRole(const string &str);
const char* getDtlsRoleString(DtlsRole role);
RtpDirection getRtpDirection(const string &str);
const char* getRtpDirectionString(RtpDirection val);
2021-03-27 18:33:20 +08:00
class SdpItem {
public:
2021-03-28 09:49:34 +08:00
using Ptr = std::shared_ptr<SdpItem>;
2021-03-27 18:33:20 +08:00
virtual ~SdpItem() = default;
2021-03-28 09:49:34 +08:00
virtual void parse(const string &str) {
value = str;
}
virtual string toString() const {
return value;
}
2021-03-28 23:31:21 +08:00
virtual const char* getKey() const = 0;
2021-03-28 17:32:53 +08:00
2021-04-27 01:16:01 +08:00
void reset() {
value.clear();
}
2021-03-28 17:32:53 +08:00
protected:
mutable string value;
2021-03-27 18:33:20 +08:00
};
2021-03-28 09:49:34 +08:00
template <char KEY>
class SdpString : public SdpItem{
public:
2021-03-30 13:09:02 +08:00
SdpString() = default;
2021-03-30 13:11:59 +08:00
SdpString(string val) {value = std::move(val);}
2021-03-28 09:49:34 +08:00
// *=*
2021-03-28 23:31:21 +08:00
const char* getKey() const override { static string key(1, KEY); return key.data();}
2021-03-28 09:49:34 +08:00
};
class SdpCommon : public SdpItem {
public:
string key;
SdpCommon(string key) { this->key = std::move(key); }
2021-03-30 13:09:02 +08:00
SdpCommon(string key, string val) {
this->key = std::move(key);
this->value = std::move(val);
}
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return key.data();}
2021-03-28 09:49:34 +08:00
};
2021-03-27 18:33:20 +08:00
class SdpTime : public SdpItem{
public:
2021-03-27 22:23:38 +08:00
//5.9. Timing ("t=")
// t=<start-time> <stop-time>
2021-03-28 17:32:53 +08:00
uint64_t start {0};
uint64_t stop {0};
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "t";}
2021-03-27 18:33:20 +08:00
};
class SdpOrigin : public SdpItem{
public:
2021-03-27 22:23:38 +08:00
// 5.2. Origin ("o=")
2021-03-27 18:33:20 +08:00
// o=jdoe 2890844526 2890842807 IN IP4 10.47.16.5
// o=<username> <sess-id> <sess-version> <nettype> <addrtype> <unicast-address>
2021-03-28 17:32:53 +08:00
string username {"-"};
2021-03-27 18:33:20 +08:00
string session_id;
string session_version;
2021-03-28 17:32:53 +08:00
string nettype {"IN"};
string addrtype {"IP4"};
string address {"0.0.0.0"};
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "o";}
bool empty() const {
return username.empty() || session_id.empty() || session_version.empty()
|| nettype.empty() || addrtype.empty() || address.empty();
}
2021-03-27 18:33:20 +08:00
};
class SdpConnection : public SdpItem {
public:
2021-03-27 22:23:38 +08:00
// 5.7. Connection Data ("c=")
2021-03-27 18:33:20 +08:00
// c=IN IP4 224.2.17.12/127
// c=<nettype> <addrtype> <connection-address>
2021-03-28 17:32:53 +08:00
string nettype {"IN"};
string addrtype {"IP4"};
string address {"0.0.0.0"};
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "c";}
2021-04-01 11:02:09 +08:00
bool empty() const {return address.empty();}
2021-03-27 22:23:38 +08:00
};
class SdpBandwidth : public SdpItem {
public:
//5.8. Bandwidth ("b=")
//b=<bwtype>:<bandwidth>
//AS、CT
2021-03-28 17:32:53 +08:00
string bwtype {"AS"};
uint32_t bandwidth {0};
2021-03-27 22:23:38 +08:00
2021-03-28 17:32:53 +08:00
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "b";}
2021-03-30 13:09:02 +08:00
bool empty() const {return bandwidth == 0;}
2021-03-27 22:23:38 +08:00
};
class SdpMedia : public SdpItem {
public:
// 5.14. Media Descriptions ("m=")
// m=<media> <port> <proto> <fmt> ...
TrackType type;
uint16_t port;
2021-03-28 23:36:11 +08:00
//RTP/AVP应用场景为视频/音频的 RTP 协议。参考 RFC 3551
//RTP/SAVP应用场景为视频/音频的 SRTP 协议。参考 RFC 3711
//RTP/AVPF: 应用场景为视频/音频的 RTP 协议,支持 RTCP-based Feedback。参考 RFC 4585
//RTP/SAVPF: 应用场景为视频/音频的 SRTP 协议,支持 RTCP-based Feedback。参考 RFC 5124
2021-03-28 17:32:53 +08:00
string proto;
vector<uint32_t> fmts;
2021-03-27 22:23:38 +08:00
2021-03-28 17:32:53 +08:00
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "m";}
2021-03-27 22:23:38 +08:00
};
class SdpAttr : public SdpItem{
public:
2021-03-28 09:49:34 +08:00
using Ptr = std::shared_ptr<SdpAttr>;
2021-03-27 22:23:38 +08:00
//5.13. Attributes ("a=")
//a=<attribute>
//a=<attribute>:<value>
2021-03-28 09:49:34 +08:00
SdpItem::Ptr detail;
2021-03-27 22:23:38 +08:00
void parse(const string &str) override;
2021-03-28 17:32:53 +08:00
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "a";}
2021-03-27 22:23:38 +08:00
};
class SdpAttrGroup : public SdpItem{
public:
//a=group:BUNDLE line with all the 'mid' identifiers part of the
// BUNDLE group is included at the session-level.
//a=group:LS session level attribute MUST be included wth the 'mid'
// identifiers that are part of the same lip sync group.
2021-03-28 17:32:53 +08:00
string type {"BUNDLE"};
vector<string> mids;
void parse(const string &str) override ;
string toString() const override ;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "group";}
2021-03-27 18:33:20 +08:00
};
2021-03-28 09:49:34 +08:00
class SdpAttrMsidSemantic : public SdpItem {
2021-03-27 18:33:20 +08:00
public:
2021-03-28 17:32:53 +08:00
//https://tools.ietf.org/html/draft-alvestrand-rtcweb-msid-02#section-3
//3. The Msid-Semantic Attribute
//
// In order to fully reproduce the semantics of the SDP and SSRC
// grouping frameworks, a session-level attribute is defined for
// signalling the semantics associated with an msid grouping.
//
// This OPTIONAL attribute gives the message ID and its group semantic.
// a=msid-semantic: examplefoo LS
//
//
// The ABNF of msid-semantic is:
//
// msid-semantic-attr = "msid-semantic:" " " msid token
// token = <as defined in RFC 4566>
//
// The semantic field may hold values from the IANA registries
// "Semantics for the "ssrc-group" SDP Attribute" and "Semantics for the
// "group" SDP Attribute".
//a=msid-semantic: WMS 616cfbb1-33a3-4d8c-8275-a199d6005549
string msid{"WMS"};
string token;
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "msid-semantic";}
bool empty() const {
return msid.empty();
}
2021-03-28 09:49:34 +08:00
};
2021-03-27 18:33:20 +08:00
2021-03-28 09:49:34 +08:00
class SdpAttrRtcp : public SdpItem {
public:
2021-03-28 17:32:53 +08:00
// a=rtcp:9 IN IP4 0.0.0.0
2021-03-30 13:09:02 +08:00
uint16_t port{0};
2021-03-28 17:32:53 +08:00
string nettype {"IN"};
string addrtype {"IP4"};
string address {"0.0.0.0"};
void parse(const string &str) override;;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "rtcp";}
2021-04-01 11:02:09 +08:00
bool empty() const {
return address.empty() || !port;
}
2021-03-28 09:49:34 +08:00
};
class SdpAttrIceUfrag : public SdpItem {
public:
2021-03-30 13:09:02 +08:00
SdpAttrIceUfrag() = default;
SdpAttrIceUfrag(string str) {value = std::move(str);}
2021-03-28 09:49:34 +08:00
//a=ice-ufrag:sXJ3
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "ice-ufrag";}
2021-03-28 09:49:34 +08:00
};
class SdpAttrIcePwd : public SdpItem {
public:
2021-03-30 13:09:02 +08:00
SdpAttrIcePwd() = default;
SdpAttrIcePwd(string str) {value = std::move(str);}
2021-03-28 09:49:34 +08:00
//a=ice-pwd:yEclOTrLg1gEubBFefOqtmyV
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "ice-pwd";}
};
class SdpAttrIceOption : public SdpItem {
public:
//a=ice-options:trickle
2021-04-01 10:35:31 +08:00
bool trickle{false};
bool renomination{false};
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "ice-options";}
2021-03-28 09:49:34 +08:00
};
class SdpAttrFingerprint : public SdpItem {
public:
//a=fingerprint:sha-256 22:14:B5:AF:66:12:C7:C7:8D:EF:4B:DE:40:25:ED:5D:8F:17:54:DD:88:33:C0:13:2E:FD:1A:FA:7E:7A:1B:79
string algorithm;
2021-03-28 17:32:53 +08:00
string hash;
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "fingerprint";}
2021-04-06 22:51:16 +08:00
bool empty() const { return algorithm.empty() || hash.empty(); }
2021-03-28 09:49:34 +08:00
};
class SdpAttrSetup : public SdpItem {
public:
//a=setup:actpass
2021-03-30 13:09:02 +08:00
SdpAttrSetup() = default;
SdpAttrSetup(DtlsRole r) { role = r; }
2021-03-28 17:32:53 +08:00
DtlsRole role{DtlsRole::actpass};
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "setup";}
2021-03-28 09:49:34 +08:00
};
class SdpAttrMid : public SdpItem {
public:
2021-03-30 13:09:02 +08:00
SdpAttrMid() = default;
SdpAttrMid(string val) { value = std::move(val); }
2021-03-28 09:49:34 +08:00
//a=mid:audio
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "mid";}
2021-03-28 09:49:34 +08:00
};
class SdpAttrExtmap : public SdpItem {
public:
2021-03-28 23:52:26 +08:00
//https://aggresss.blog.csdn.net/article/details/106436703
2021-03-29 00:12:20 +08:00
//a=extmap:1[/sendonly] urn:ietf:params:rtp-hdrext:ssrc-audio-level
2021-05-07 14:08:43 +08:00
uint8_t id;
2021-03-29 00:12:20 +08:00
RtpDirection direction{RtpDirection::invalid};
2021-03-28 17:32:53 +08:00
string ext;
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "extmap";}
2021-03-28 09:49:34 +08:00
};
class SdpAttrRtpMap : public SdpItem {
public:
//a=rtpmap:111 opus/48000/2
uint8_t pt;
string codec;
2021-03-29 23:03:55 +08:00
uint32_t sample_rate;
uint32_t channel {0};
2021-03-28 17:32:53 +08:00
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "rtpmap";}
2021-03-28 09:49:34 +08:00
};
class SdpAttrRtcpFb : public SdpItem {
public:
2021-03-28 23:52:26 +08:00
//a=rtcp-fb:98 nack pli
//a=rtcp-fb:120 nack 支持 nack 重传nack (Negative-Acknowledgment) 。
//a=rtcp-fb:120 nack pli 支持 nack 关键帧重传PLI (Picture Loss Indication) 。
//a=rtcp-fb:120 ccm fir 支持编码层关键帧请求CCM (Codec Control Message)FIR (Full Intra Request ),通常与 nack pli 有同样的效果,但是 nack pli 是用于重传时的关键帧请求。
//a=rtcp-fb:120 goog-remb 支持 REMB (Receiver Estimated Maximum Bitrate) 。
//a=rtcp-fb:120 transport-cc 支持 TCC (Transport Congest Control) 。
2021-03-28 09:49:34 +08:00
uint8_t pt;
2021-03-29 23:03:55 +08:00
string rtcp_type;
2021-03-28 17:32:53 +08:00
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "rtcp-fb";}
2021-03-28 09:49:34 +08:00
};
class SdpAttrFmtp : public SdpItem {
public:
2021-03-28 17:32:53 +08:00
//fmtp:96 level-asymmetry-allowed=1;packetization-mode=0;profile-level-id=42e01f
2021-03-28 09:49:34 +08:00
uint8_t pt;
2021-04-15 19:35:25 +08:00
map<string/*key*/, string/*value*/, StrCaseCompare> fmtp;
2021-03-28 17:32:53 +08:00
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "fmtp";}
2021-03-28 09:49:34 +08:00
};
class SdpAttrSSRC : public SdpItem {
public:
2021-03-28 23:52:26 +08:00
//a=ssrc:3245185839 cname:Cx4i/VTR51etgjT7
//a=ssrc:3245185839 msid:cb373bff-0fea-4edb-bc39-e49bb8e8e3b9 0cf7e597-36a2-4480-9796-69bf0955eef5
//a=ssrc:3245185839 mslabel:cb373bff-0fea-4edb-bc39-e49bb8e8e3b9
//a=ssrc:3245185839 label:0cf7e597-36a2-4480-9796-69bf0955eef5
2021-03-28 17:32:53 +08:00
//a=ssrc:<ssrc-id> <attribute>
//a=ssrc:<ssrc-id> <attribute>:<value>
2021-03-28 23:52:26 +08:00
//cname 是必须的msid/mslabel/label 这三个属性都是 WebRTC 自创的,或者说 Google 自创的,可以参考 https://tools.ietf.org/html/draft-ietf-mmusic-msid-17
// 理解它们三者的关系需要先了解三个概念RTP stream / MediaStreamTrack / MediaStream
//一个 a=ssrc 代表一个 RTP stream
//一个 MediaStreamTrack 通常包含一个或多个 RTP stream例如一个视频 MediaStreamTrack 中通常包含两个 RTP stream一个用于常规传输一个用于 nack 重传;
//一个 MediaStream 通常包含一个或多个 MediaStreamTrack ,例如 simulcast 场景下,一个 MediaStream 通常会包含三个不同编码质量的 MediaStreamTrack
//这种标记方式并不被 Firefox 认可,在 Firefox 生成的 SDP 中一个 a=ssrc 通常只有一行,例如:
//a=ssrc:3245185839 cname:Cx4i/VTR51etgjT7
2021-03-28 09:49:34 +08:00
uint32_t ssrc;
2021-03-28 17:32:53 +08:00
string attribute;
string attribute_value;
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "ssrc";}
};
class SdpAttrSSRCGroup : public SdpItem {
public:
2021-03-28 23:52:26 +08:00
//a=ssrc-group 定义参考 RFC 5576(https://tools.ietf.org/html/rfc5576) ,用于描述多个 ssrc 之间的关联,常见的有两种:
2021-03-28 23:31:21 +08:00
//a=ssrc-group:FID 2430709021 3715850271
// FID (Flow Identification) 最初用在 FEC 的关联中WebRTC 中通常用于关联一组常规 RTP stream 和 重传 RTP stream 。
//a=ssrc-group:SIM 360918977 360918978 360918980
// 在 Chrome 独有的 SDP munging 风格的 simulcast 中使用,将三组编码质量由低到高的 MediaStreamTrack 关联在一起。
string type{"FID"};
2021-05-08 18:39:35 +08:00
vector<uint32_t> ssrcs;
2021-03-28 23:31:21 +08:00
2021-03-29 23:03:55 +08:00
bool isFID() const { return type == "FID"; }
bool isSIM() const { return type == "SIM"; }
2021-03-28 23:31:21 +08:00
void parse(const string &str) override;
string toString() const override;
const char* getKey() const override { return "ssrc-group";}
2021-03-28 09:49:34 +08:00
};
class SdpAttrSctpMap : public SdpItem {
public:
2021-03-28 17:32:53 +08:00
//https://tools.ietf.org/html/draft-ietf-mmusic-sctp-sdp-05
//a=sctpmap:5000 webrtc-datachannel 1024
//a=sctpmap: sctpmap-number media-subtypes [streams]
2021-03-28 09:49:34 +08:00
uint16_t port;
2021-03-28 17:32:53 +08:00
string subtypes;
2021-03-29 23:03:55 +08:00
uint32_t streams;
2021-03-28 17:32:53 +08:00
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "sctpmap";}
2021-03-28 09:49:34 +08:00
};
class SdpAttrCandidate : public SdpItem {
public:
2021-04-02 17:08:11 +08:00
using Ptr = std::shared_ptr<SdpAttrCandidate>;
2021-03-28 17:32:53 +08:00
//https://tools.ietf.org/html/rfc5245
//15.1. "candidate" Attribute
//a=candidate:4 1 udp 2 192.168.1.7 58107 typ host
//a=candidate:<foundation> <component-id> <transport> <priority> <address> <port> typ <cand-type>
2021-03-29 12:28:47 +08:00
string foundation;
2021-03-30 13:53:45 +08:00
//传输媒体的类型,1代表RTP;2代表 RTCP。
2021-03-28 17:32:53 +08:00
uint32_t component;
string transport {"udp"};
uint32_t priority;
string address;
uint16_t port;
string type;
vector<std::pair<string, string> > arr;
void parse(const string &str) override;
string toString() const override;
2021-03-28 23:31:21 +08:00
const char* getKey() const override { return "candidate";}
2021-03-28 09:49:34 +08:00
};
2021-03-31 17:15:26 +08:00
class SdpAttrMsid : public SdpItem{
public:
const char* getKey() const override { return "msid";}
};
class SdpAttrExtmapAllowMixed : public SdpItem{
public:
const char* getKey() const override { return "extmap-allow-mixed";}
};
class SdpAttrSimulcast : public SdpItem{
public:
2021-05-08 18:39:35 +08:00
//https://www.meetecho.com/blog/simulcast-janus-ssrc/
//https://tools.ietf.org/html/draft-ietf-mmusic-sdp-simulcast-14
2021-03-31 17:15:26 +08:00
const char* getKey() const override { return "simulcast";}
2021-05-08 18:39:35 +08:00
void parse(const string &str) override;
string toString() const override;
2021-05-08 20:27:46 +08:00
bool empty() const { return rids.empty(); }
2021-05-08 18:39:35 +08:00
string direction;
2021-05-08 20:27:46 +08:00
vector<string> rids;
2021-03-31 17:15:26 +08:00
};
class SdpAttrRid : public SdpItem{
public:
2021-05-08 20:27:46 +08:00
void parse(const string &str) override;
string toString() const override;
2021-03-31 17:15:26 +08:00
const char* getKey() const override { return "rid";}
2021-05-08 20:27:46 +08:00
string direction;
string rid;
2021-03-31 17:15:26 +08:00
};
2021-03-29 11:39:58 +08:00
class RtcSdpBase {
2021-03-28 09:49:34 +08:00
public:
vector<SdpItem::Ptr> items;
2021-03-29 11:39:58 +08:00
public:
2021-03-29 23:03:55 +08:00
virtual ~RtcSdpBase() = default;
2021-03-29 11:39:58 +08:00
virtual string toString() const;
int getVersion() const;
SdpOrigin getOrigin() const;
string getSessionName() const;
string getSessionInfo() const;
SdpTime getSessionTime() const;
SdpConnection getConnection() const;
SdpBandwidth getBandwidth() const;
string getUri() const;
string getEmail() const;
string getPhone() const;
string getTimeZone() const;
string getEncryptKey() const;
string getRepeatTimes() const;
2021-03-28 17:32:53 +08:00
RtpDirection getDirection() const;
2021-03-29 11:39:58 +08:00
template<typename cls>
cls getItemClass(char key, const char *attr_key = nullptr) const{
auto item = dynamic_pointer_cast<cls>(getItem(key, attr_key));
if (!item) {
return cls();
}
return *item;
}
string getStringItem(char key, const char *attr_key = nullptr) const{
auto item = getItem(key, attr_key);
if (!item) {
return "";
}
return item->toString();
}
2021-03-29 12:00:42 +08:00
SdpItem::Ptr getItem(char key, const char *attr_key = nullptr) const;
2021-03-29 23:03:55 +08:00
template<typename cls>
vector<cls> getAllItem(char key_c, const char *attr_key = nullptr) const {
2021-03-29 23:03:55 +08:00
vector<cls> ret;
for (auto item : items) {
string key(1, key_c);
if (strcasecmp(item->getKey(), key.data()) == 0) {
2021-03-29 23:03:55 +08:00
if (!attr_key) {
auto c = dynamic_pointer_cast<cls>(item);
if (c) {
ret.emplace_back(*c);
}
} else {
auto attr = dynamic_pointer_cast<SdpAttr>(item);
if (attr && !strcasecmp(attr->detail->getKey(), attr_key)) {
2021-03-29 23:03:55 +08:00
auto c = dynamic_pointer_cast<cls>(attr->detail);
if (c) {
ret.emplace_back(*c);
}
}
}
}
}
return ret;
}
2021-03-27 18:33:20 +08:00
};
2021-03-27 22:23:38 +08:00
2021-03-29 11:39:58 +08:00
class RtcSessionSdp : public RtcSdpBase{
2021-03-27 18:33:20 +08:00
public:
2021-04-02 23:01:58 +08:00
using Ptr = std::shared_ptr<RtcSessionSdp>;
2021-03-29 11:39:58 +08:00
vector<RtcSdpBase> medias;
2021-03-28 09:49:34 +08:00
void parse(const string &str);
2021-03-29 11:39:58 +08:00
string toString() const override;
2021-03-27 18:33:20 +08:00
};
2021-03-29 10:54:18 +08:00
//////////////////////////////////////////////////////////////////
//ssrc相关信息
class RtcSSRC{
public:
2021-03-29 23:03:55 +08:00
uint32_t ssrc {0};
uint32_t rtx_ssrc {0};
2021-03-29 10:54:18 +08:00
string cname;
string msid;
string mslabel;
string label;
2021-03-29 23:55:29 +08:00
bool empty() const {return ssrc == 0 && cname.empty();}
2021-03-29 10:54:18 +08:00
};
//rtc传输编码方案
2021-03-29 18:31:56 +08:00
class RtcCodecPlan{
2021-03-29 10:54:18 +08:00
public:
using Ptr = shared_ptr<RtcCodecPlan>;
2021-03-29 10:54:18 +08:00
uint8_t pt;
string codec;
uint32_t sample_rate;
//音频时有效
uint32_t channel = 0;
2021-03-29 23:55:29 +08:00
//rtcp反馈
2021-04-28 15:07:15 +08:00
set<string> rtcp_fb;
2021-04-15 19:35:25 +08:00
map<string/*key*/, string/*value*/, StrCaseCompare> fmtp;
2021-03-29 23:55:29 +08:00
string getFmtp(const char *key) const;
2021-03-29 10:54:18 +08:00
};
//rtc 媒体描述
2021-03-29 11:39:58 +08:00
class RtcMedia{
2021-03-29 10:54:18 +08:00
public:
2021-03-29 23:55:29 +08:00
TrackType type{TrackType::TrackInvalid};
2021-03-29 10:54:18 +08:00
string mid;
2021-03-29 23:55:29 +08:00
uint16_t port{0};
SdpConnection addr;
2021-03-29 10:54:18 +08:00
string proto;
2021-03-29 23:55:29 +08:00
RtpDirection direction{RtpDirection::invalid};
vector<RtcCodecPlan> plan;
2021-03-29 10:54:18 +08:00
//////// rtp ////////
2021-05-08 18:39:35 +08:00
vector<RtcSSRC> rtp_rtx_ssrc;
2021-03-29 23:55:29 +08:00
//////// simulcast ////////
2021-05-08 18:39:35 +08:00
vector<RtcSSRC> rtp_ssrc_sim;
2021-05-08 20:27:46 +08:00
vector<string> rtp_rids;
2021-03-29 23:03:55 +08:00
2021-03-29 23:55:29 +08:00
//////// rtcp ////////
bool rtcp_mux{false};
bool rtcp_rsize{false};
2021-03-29 10:54:18 +08:00
SdpAttrRtcp rtcp_addr;
//////// ice ////////
2021-03-29 23:55:29 +08:00
bool ice_trickle{false};
bool ice_lite{false};
bool ice_renomination{false};
2021-03-29 10:54:18 +08:00
string ice_ufrag;
string ice_pwd;
std::vector<SdpAttrCandidate> candidate;
//////// dtls ////////
2021-03-29 23:55:29 +08:00
DtlsRole role{DtlsRole::invalid};
2021-03-29 10:54:18 +08:00
SdpAttrFingerprint fingerprint;
//////// extmap ////////
2021-05-10 10:14:42 +08:00
vector<SdpAttrExtmap> extmap;
2021-03-29 23:03:55 +08:00
//////// sctp ////////////
SdpAttrSctpMap sctpmap;
2021-03-29 23:55:29 +08:00
uint32_t sctp_port{0};
void checkValid() const;
2021-05-10 17:35:22 +08:00
//offer sdp,如果指定了发送rtp,那么应该指定ssrc
void checkValidSSRC() const;
2021-03-29 23:55:29 +08:00
const RtcCodecPlan *getPlan(uint8_t pt) const;
const RtcCodecPlan *getPlan(const char *codec) const;
2021-03-30 10:59:15 +08:00
const RtcCodecPlan *getRelatedRtxPlan(uint8_t pt) const;
2021-05-16 12:28:50 +08:00
uint32_t getRtpSSRC() const;
uint32_t getRtxSSRC() const;
bool supportSimulcast() const;
2021-03-29 10:54:18 +08:00
};
2021-03-27 18:33:20 +08:00
2021-03-29 11:39:58 +08:00
class RtcSession{
public:
2021-03-31 17:15:26 +08:00
using Ptr = std::shared_ptr<RtcSession>;
2021-03-29 23:03:55 +08:00
uint32_t version;
2021-03-29 11:39:58 +08:00
SdpOrigin origin;
string session_name;
string session_info;
SdpTime time;
2021-03-29 11:39:58 +08:00
SdpConnection connection;
SdpBandwidth bandwidth;
2021-03-29 23:03:55 +08:00
SdpAttrMsidSemantic msid_semantic;
2021-03-29 11:39:58 +08:00
vector<RtcMedia> media;
2021-03-29 23:03:55 +08:00
SdpAttrGroup group;
2021-03-29 12:00:42 +08:00
2021-04-02 18:28:01 +08:00
void loadFrom(const string &sdp, bool check = true);
2021-03-29 23:55:29 +08:00
void checkValid() const;
void checkSdp() const;
2021-10-12 17:32:22 +08:00
//offer sdp,如果指定了发送rtp,那么应该指定ssrc
2021-05-10 17:35:22 +08:00
void checkValidSSRC() const;
2021-03-30 13:09:02 +08:00
string toString() const;
2021-04-02 23:01:58 +08:00
string toRtspSdp() const;
const RtcMedia *getMedia(TrackType type) const;
2021-05-10 17:35:22 +08:00
bool haveSSRC() const;
2021-04-28 15:41:36 +08:00
bool supportRtcpFb(const string &name, TrackType type = TrackType::TrackVideo) const;
bool supportSimulcast() const;
2021-04-02 23:01:58 +08:00
private:
RtcSessionSdp::Ptr toRtcSessionSdp() const;
2021-03-29 11:39:58 +08:00
};
2021-03-27 18:33:20 +08:00
2021-03-30 11:51:39 +08:00
class RtcConfigure {
public:
2021-04-02 17:08:11 +08:00
using Ptr = std::shared_ptr<RtcConfigure>;
2021-03-30 11:51:39 +08:00
class RtcTrackConfigure {
public:
bool rtcp_mux;
bool rtcp_rsize;
bool group_bundle;
bool support_rtx;
bool support_red;
bool support_ulpfec;
bool ice_lite;
bool ice_trickle;
bool ice_renomination;
string ice_ufrag;
string ice_pwd;
RtpDirection direction{RtpDirection::invalid};
SdpAttrFingerprint fingerprint;
2021-04-28 15:07:15 +08:00
set<string> rtcp_fb;
2021-05-07 14:02:03 +08:00
set<RtpExtType> extmap;
2021-03-30 11:51:39 +08:00
vector<CodecId> preferred_codec;
vector<SdpAttrCandidate> candidate;
void setDefaultSetting(TrackType type);
2021-04-28 15:07:15 +08:00
void enableTWCC(bool enable = true);
2021-04-30 15:08:43 +08:00
void enableREMB(bool enable = true);
2021-03-30 11:51:39 +08:00
};
RtcTrackConfigure video;
RtcTrackConfigure audio;
RtcTrackConfigure application;
void setDefaultSetting(string ice_ufrag,
string ice_pwd,
RtpDirection direction,
const SdpAttrFingerprint &fingerprint);
void addCandidate(const SdpAttrCandidate &candidate, TrackType type = TrackInvalid);
2021-03-30 18:34:17 +08:00
shared_ptr<RtcSession> createAnswer(const RtcSession &offer);
2021-03-31 18:32:43 +08:00
void setPlayRtspInfo(const string &sdp);
2021-04-28 15:07:15 +08:00
void enableTWCC(bool enable = true, TrackType type = TrackInvalid);
2021-05-06 10:40:21 +08:00
void enableREMB(bool enable = true, TrackType type = TrackInvalid);
2021-04-28 15:07:15 +08:00
2021-03-31 18:32:43 +08:00
private:
void matchMedia(shared_ptr<RtcSession> &ret, TrackType type, const vector<RtcMedia> &medias, const RtcTrackConfigure &configure);
2021-04-06 23:46:45 +08:00
bool onCheckCodecProfile(const RtcCodecPlan &plan, CodecId codec);
2021-04-15 19:35:25 +08:00
void onSelectPlan(RtcCodecPlan &plan, CodecId codec);
private:
RtcCodecPlan::Ptr _rtsp_video_plan;
RtcCodecPlan::Ptr _rtsp_audio_plan;
2021-03-30 11:51:39 +08:00
};
2021-04-30 15:15:35 +08:00
class SdpConst {
public:
static string const kTWCCRtcpFb;
static string const kRembRtcpFb;
private:
SdpConst() = delete;
~SdpConst() = delete;
};
2021-03-27 18:33:20 +08:00
#endif //ZLMEDIAKIT_SDP_H