stream-deploy/ZLM/3rdpart/media-server/librtsp/include/sdp-a-webrtc.h

203 lines
5.9 KiB
C++

#ifndef _sdp_a_webrtc_h_
#define _sdp_a_webrtc_h_
#include <inttypes.h>
#include <stdint.h>
#ifdef __cplusplus
extern "C" {
#endif
#define ICE_UFRAG_LEN 255
#define ICE_PASSWORD_LEN 255
#define RTP_PORT_INACTIVE 0 // inactive
#define RTP_PORT_UNDEFINED 9 // port by ice candidate
// https://www.rfc-editor.org/rfc/rfc8888.html#name-sdp-signaling
// a=rtcp-fb:* ack ccfb
// a=ecn-capable-rtp:
#define RTCP_FEEDBACK_ACK "ack" // https://datatracker.ietf.org/doc/html/rfc4585#section-9
#define RTCP_FEEDBACK_NACK "nack" // https://datatracker.ietf.org/doc/html/rfc4585#section-9
#define RTCP_FEEDBACK_CCM "ccm" // https://www.rfc-editor.org/rfc/rfc5104.html#section-8
// a=extmap:5 http://www.ietf.org/id/draft-holmer-rmcat-transport-wide-cc-extensions-01
#define RTCP_FEEDBACK_TCC "transport-cc" // https://datatracker.ietf.org/doc/html/draft-holmer-rmcat-transport-wide-cc-extensions-01#section-5
// a=extmap:3 http://www.webrtc.org/experiments/rtp-hdrext/abs-send-time
#define RTCP_FEEDBACK_REMB "goog-remb" // https://datatracker.ietf.org/doc/html/draft-alvestrand-rmcat-remb-03#section-3
#define RTCP_FEEDBACK_ACK_RPSI "rpsi"
#define RTCP_FEEDBACK_ACK_CCFB "ccfb"
#define RTCP_FEEDBACK_NACK_PLI "pli"
#define RTCP_FEEDBACK_NACK_SLI "sli"
#define RTCP_FEEDBACK_NACK_RPSI "rpsi"
#define RTCP_FEEDBACK_CCM_FIR "fir"
#define RTCP_FEEDBACK_CCM_TMMBR "tmmbr"
#define RTCP_FEEDBACK_CCM_VBCM "vbcm"
#define RTCP_FEEDBACK_CCM_TSTR "tstr"
enum OPTIONAL_BOOL { OPTIONAL_BOOL_UNSET = -1, OPTIONAL_BOOL_FALSE = 0, OPTIONAL_BOOL_TRUE = 1, };
// sdp c: connection, address: unicast-source address, mulitcast-multicast address(RFC4566 4.1. Media and Transport Information)
struct sdp_address_t
{
char network[16]; // IN
char addrtype[16]; // IP4/IP6
char address[64]; // ip or dns
char source[64]; // multicast address
int port[2]; // rtcp-mux: port[0] == port[1]
};
// RFC4585 Extended RTP Profile for Real-time Transport Control Protocol (RTCP)-Based Feedback (RTP/AVPF)
// RFC5104 Codec Control Messages in the RTP Audio-Visual Profile with Feedback (AVPF)
struct sdp_rtcp_fb_t
{
int fmt; // payload id, -1 for all(-1 ==> * / all)
char feedback[16]; // ack/nack/ccm
char param[64]; // ack:rpsi,app; nack: pli,sli,rpsi,app; ccm: fir,tmmbr,tstr,vbcm
int trr_int;
};
// RFC3611 RTP Control Protocol Extended Reports (RTCP XR)
struct sdp_rtcp_xr_t
{
int loss; // pkt-loss-rle
int dup; // pkt-dup-rle
int rcpt_times; // pkt-rcpt-times
int rcvr_rtt;
int rcvr_rtt_mode; // 0-sender, 1-all
int stat_summary; // 0x01-loss, 0x02-dup, 0x04-jitt, 0x08-TTL
int voip_metrics;
};
// https://tools.ietf.org/html/draft-ietf-mmusic-ice-sip-sdp-39
// https://www.tech-invite.com/fo-abnf/tinv-fo-abnf-sdpatt-rfc5245.html
// a=candidate:3 1 UDP 1862270847 10.95.49.227 63259 typ prflx raddr 192.168.137.93 rport 7078
struct sdp_ice_candidate_t
{
char foundation[33];
char transport[8]; // UDP
char candtype[8];
uint16_t component; // rtp/rtcp component id, [1, 256]
uint16_t port;
uint32_t priority; // [1, 2**31 - 1]
char address[65];
char** extensions; // include raddr/rport/generation
int nextension;
// extersions
char reladdr[65];
uint16_t relport;
int generation; // google webrtc externsion
};
struct sdp_simulcast_t
{
char** sends;
char** recvs;
int nsend;
int nrecv;
};
struct sdp_ssrc_group_t
{
char key[64];
char** values;
int count;
};
struct sdp_rid_t
{
char rid[65];
char direction[8];
// rid-pt-param-list
char** payloads;
int npayload;
int width; // max-width
int height; // max-height
int fps; // max-fps
int fs; // max-fs
int br; // max-br
int pps; // max-pps
double bpp; // max-bpp
char** depends;
int ndepend;
// rid-param-list(include pt/width/height/fps/fs/br/pps/bpp/depend/...)
char** params;
int nparam;
};
/// @param[out] direction sendonly/receonly/sendrecv/inactive, default sendrecv
/// @return 0-ok, other-error
int sdp_a_extmap(const char* s, int n, int* ext, int* direction, char url[128]);
/// free(*param)
/// @return 0-ok, other-error
int sdp_a_fmtp(const char* s, int n, int* fmt, char **param);
/// @return 0-ok, other-error
int sdp_a_fingerprint(const char* s, int n, char hash[16], char fingerprint[128]);
/// free(groups)
/// @return 0-ok, other-error
int sdp_a_group(const char* s, int n, char semantics[32], char*** groups, int* count);
/// free(c->extensions)
/// @return 0-ok, other-error
int sdp_a_ice_candidate(const char* s, int n, struct sdp_ice_candidate_t* c);
/// @return 0-ok, other-error
int sdp_a_ice_remote_candidates(const char* s, int n, struct sdp_ice_candidate_t* c);
/// @return 0-ok, other-error
int sdp_a_ice_pacing(const char* s, int n, int* pacing);
/// @param[out] options free(options)
/// @param[out] count options number
/// @return 0-ok, other-error
int sdp_a_ice_options(const char* s, int n, char*** options, int* count);
/// @return 0-ok, other-error
int sdp_a_msid(const char* s, int n, char id[65], char appdata[65]);
/// @return 0-ok, other-error
int sdp_a_mid(const char* s, int n, char tag[256]);
/// @param[out] orient portrait / landscape / seascape
/// @return 0-ok, other-error
int sdp_a_orient(const char* s, int n, char orient[16]);
/// free(rid->params) / free(rid->depends) / free(rid->payloads)
/// @return 0-ok, other-error
int sdp_a_rid(const char* s, int n, struct sdp_rid_t* rid);
/// @return 0-ok, other-error
int sdp_a_rtcp(const char* s, int n, struct sdp_address_t* addr);
/// @return 0-ok, other-error
int sdp_a_rtcp_fb(const char* s, int n, struct sdp_rtcp_fb_t* fb);
/// free(simulcast->sends) / free(simulcast->recvs)
/// @return 0-ok, other-error
int sdp_a_simulcast(const char* s, int n, struct sdp_simulcast_t* simulcast);
/// @return 0-ok, other-error
int sdp_a_ssrc(const char* s, int n, uint32_t *ssrc, char attribute[64], char value[128]);
/// free(group->values)
/// @return 0-ok, other-error
int sdp_a_ssrc_group(const char* s, int n, struct sdp_ssrc_group_t* group);
#ifdef __cplusplus
}
#endif
#endif /* !_sdp_a_webrtc_h_ */