FFmpeg
Macros | Functions | Variables
rtpdec.c File Reference
#include "libavutil/mathematics.h"
#include "libavutil/avstring.h"
#include "libavutil/intreadwrite.h"
#include "libavutil/time.h"
#include "avformat.h"
#include "network.h"
#include "srtp.h"
#include "url.h"
#include "rtpdec.h"
#include "rtpdec_formats.h"

Go to the source code of this file.

Macros

#define MIN_FEEDBACK_INTERVAL   200000 /* 200 ms in us */
 
#define RTP_SEQ_MOD   (1 << 16)
 

Functions

const RTPDynamicProtocolHandlerff_rtp_handler_iterate (void **opaque)
 Iterate over all registered rtp dynamic protocol handlers. More...
 
const RTPDynamicProtocolHandlerff_rtp_handler_find_by_name (const char *name, enum AVMediaType codec_type)
 Find a registered rtp dynamic protocol handler with the specified name. More...
 
const RTPDynamicProtocolHandlerff_rtp_handler_find_by_id (int id, enum AVMediaType codec_type)
 Find a registered rtp dynamic protocol handler with a matching codec ID. More...
 
static int rtcp_parse_packet (RTPDemuxContext *s, const unsigned char *buf, int len)
 
static void rtp_init_statistics (RTPStatistics *s, uint16_t base_sequence)
 
static void rtp_init_sequence (RTPStatistics *s, uint16_t seq)
 
static int rtp_valid_packet_in_sequence (RTPStatistics *s, uint16_t seq)
 
static void rtcp_update_jitter (RTPStatistics *s, uint32_t sent_timestamp, uint32_t arrival_timestamp)
 
int ff_rtp_check_and_send_back_rr (RTPDemuxContext *s, URLContext *fd, AVIOContext *avio, int count)
 some rtp servers assume client is dead if they don't hear from them... More...
 
void ff_rtp_send_punch_packets (URLContext *rtp_handle)
 Send a dummy packet on both port pairs to set up the connection state in potential NAT routers, so that we're able to receive packets. More...
 
static int find_missing_packets (RTPDemuxContext *s, uint16_t *first_missing, uint16_t *missing_mask)
 
int ff_rtp_send_rtcp_feedback (RTPDemuxContext *s, URLContext *fd, AVIOContext *avio)
 
RTPDemuxContextff_rtp_parse_open (AVFormatContext *s1, AVStream *st, int payload_type, int queue_size)
 open a new RTP parse context for stream 'st'. More...
 
void ff_rtp_parse_set_dynamic_protocol (RTPDemuxContext *s, PayloadContext *ctx, const RTPDynamicProtocolHandler *handler)
 
void ff_rtp_parse_set_crypto (RTPDemuxContext *s, const char *suite, const char *params)
 
static void finalize_packet (RTPDemuxContext *s, AVPacket *pkt, uint32_t timestamp)
 This was the second switch in rtp_parse packet. More...
 
static int rtp_parse_packet_internal (RTPDemuxContext *s, AVPacket *pkt, const uint8_t *buf, int len)
 
void ff_rtp_reset_packet_queue (RTPDemuxContext *s)
 
static int enqueue_packet (RTPDemuxContext *s, uint8_t *buf, int len)
 
static int has_next_packet (RTPDemuxContext *s)
 
int64_t ff_rtp_queued_packet_time (RTPDemuxContext *s)
 
static int rtp_parse_queued_packet (RTPDemuxContext *s, AVPacket *pkt)
 
static int rtp_parse_one_packet (RTPDemuxContext *s, AVPacket *pkt, uint8_t **bufptr, int len)
 
int ff_rtp_parse_packet (RTPDemuxContext *s, AVPacket *pkt, uint8_t **bufptr, int len)
 Parse an RTP or RTCP packet directly sent as a buffer. More...
 
void ff_rtp_parse_close (RTPDemuxContext *s)
 
int ff_parse_fmtp (AVFormatContext *s, AVStream *stream, PayloadContext *data, const char *p, int(*parse_fmtp)(AVFormatContext *s, AVStream *stream, PayloadContext *data, const char *attr, const char *value))
 
int ff_rtp_finalize_packet (AVPacket *pkt, AVIOContext **dyn_buf, int stream_idx)
 Close the dynamic buffer and make a packet from it. More...
 

Variables

static RTPDynamicProtocolHandler l24_dynamic_handler
 
static RTPDynamicProtocolHandler gsm_dynamic_handler
 
static RTPDynamicProtocolHandler realmedia_mp3_dynamic_handler
 
static RTPDynamicProtocolHandler speex_dynamic_handler
 
static RTPDynamicProtocolHandler opus_dynamic_handler
 
static RTPDynamicProtocolHandler t140_dynamic_handler
 
RTPDynamicProtocolHandler ff_rdt_video_handler
 
RTPDynamicProtocolHandler ff_rdt_audio_handler
 
RTPDynamicProtocolHandler ff_rdt_live_video_handler
 
RTPDynamicProtocolHandler ff_rdt_live_audio_handler
 
static const RTPDynamicProtocolHandlerrtp_dynamic_protocol_handler_list []
 

Macro Definition Documentation

◆ MIN_FEEDBACK_INTERVAL

#define MIN_FEEDBACK_INTERVAL   200000 /* 200 ms in us */

Definition at line 34 of file rtpdec.c.

◆ RTP_SEQ_MOD

#define RTP_SEQ_MOD   (1 << 16)

Definition at line 208 of file rtpdec.c.

Function Documentation

◆ ff_rtp_handler_iterate()

const RTPDynamicProtocolHandler* ff_rtp_handler_iterate ( void **  opaque)

Iterate over all registered rtp dynamic protocol handlers.

Parameters
opaquea pointer where libavformat will store the iteration state. Must point to NULL to start the iteration.
Returns
the next registered rtp dynamic protocol handler or NULL when the iteration is finished

Definition at line 135 of file rtpdec.c.

Referenced by ff_rtp_handler_find_by_id(), and ff_rtp_handler_find_by_name().

◆ ff_rtp_handler_find_by_name()

const RTPDynamicProtocolHandler* ff_rtp_handler_find_by_name ( const char *  name,
enum AVMediaType  codec_type 
)

Find a registered rtp dynamic protocol handler with the specified name.

Parameters
namename of the requested rtp dynamic protocol handler
Returns
A rtp dynamic protocol handler if one was found, NULL otherwise.

Definition at line 146 of file rtpdec.c.

◆ ff_rtp_handler_find_by_id()

const RTPDynamicProtocolHandler* ff_rtp_handler_find_by_id ( int  id,
enum AVMediaType  codec_type 
)

Find a registered rtp dynamic protocol handler with a matching codec ID.

Parameters
idAVCodecID of the requested rtp dynamic protocol handler.
Returns
A rtp dynamic protocol handler if one was found, NULL otherwise.

Definition at line 160 of file rtpdec.c.

◆ rtcp_parse_packet()

static int rtcp_parse_packet ( RTPDemuxContext s,
const unsigned char *  buf,
int  len 
)
static

Definition at line 173 of file rtpdec.c.

Referenced by rtp_parse_one_packet().

◆ rtp_init_statistics()

static void rtp_init_statistics ( RTPStatistics s,
uint16_t  base_sequence 
)
static

Definition at line 210 of file rtpdec.c.

Referenced by ff_rtp_parse_open().

◆ rtp_init_sequence()

static void rtp_init_sequence ( RTPStatistics s,
uint16_t  seq 
)
static

Definition at line 221 of file rtpdec.c.

Referenced by rtp_valid_packet_in_sequence().

◆ rtp_valid_packet_in_sequence()

static int rtp_valid_packet_in_sequence ( RTPStatistics s,
uint16_t  seq 
)
static

Definition at line 235 of file rtpdec.c.

Referenced by rtp_parse_packet_internal().

◆ rtcp_update_jitter()

static void rtcp_update_jitter ( RTPStatistics s,
uint32_t  sent_timestamp,
uint32_t  arrival_timestamp 
)
static

Definition at line 281 of file rtpdec.c.

Referenced by rtp_parse_one_packet().

◆ ff_rtp_check_and_send_back_rr()

int ff_rtp_check_and_send_back_rr ( RTPDemuxContext s,
URLContext fd,
AVIOContext avio,
int  count 
)

some rtp servers assume client is dead if they don't hear from them...

so we send a Receiver Report to the provided URLContext or AVIOContext (we don't have access to the rtcp handle from here)

Definition at line 299 of file rtpdec.c.

◆ ff_rtp_send_punch_packets()

void ff_rtp_send_punch_packets ( URLContext rtp_handle)

Send a dummy packet on both port pairs to set up the connection state in potential NAT routers, so that we're able to receive packets.

Note, this only works if the NAT router doesn't remap ports. This isn't a standardized procedure, but it works in many cases in practice.

The same routine is used with RDT too, even if RDT doesn't use normal RTP packets otherwise.

Definition at line 402 of file rtpdec.c.

Referenced by rtsp_read_play().

◆ find_missing_packets()

static int find_missing_packets ( RTPDemuxContext s,
uint16_t *  first_missing,
uint16_t *  missing_mask 
)
static

Definition at line 440 of file rtpdec.c.

Referenced by ff_rtp_send_rtcp_feedback().

◆ ff_rtp_send_rtcp_feedback()

int ff_rtp_send_rtcp_feedback ( RTPDemuxContext s,
URLContext fd,
AVIOContext avio 
)

Definition at line 470 of file rtpdec.c.

◆ ff_rtp_parse_open()

RTPDemuxContext* ff_rtp_parse_open ( AVFormatContext s1,
AVStream st,
int  payload_type,
int  queue_size 
)

open a new RTP parse context for stream 'st'.

'st' can be NULL for MPEG-2 TS streams.

Definition at line 538 of file rtpdec.c.

Referenced by ff_rtsp_open_transport_ctx().

◆ ff_rtp_parse_set_dynamic_protocol()

void ff_rtp_parse_set_dynamic_protocol ( RTPDemuxContext s,
PayloadContext ctx,
const RTPDynamicProtocolHandler handler 
)

Definition at line 574 of file rtpdec.c.

Referenced by ff_rtsp_open_transport_ctx().

◆ ff_rtp_parse_set_crypto()

void ff_rtp_parse_set_crypto ( RTPDemuxContext s,
const char *  suite,
const char *  params 
)

Definition at line 581 of file rtpdec.c.

Referenced by ff_rtsp_open_transport_ctx().

◆ finalize_packet()

static void finalize_packet ( RTPDemuxContext s,
AVPacket pkt,
uint32_t  timestamp 
)
static

This was the second switch in rtp_parse packet.

Normalizes time, if required, sets stream_index, etc.

Definition at line 592 of file rtpdec.c.

Referenced by rtp_parse_one_packet(), and rtp_parse_packet_internal().

◆ rtp_parse_packet_internal()

static int rtp_parse_packet_internal ( RTPDemuxContext s,
AVPacket pkt,
const uint8_t buf,
int  len 
)
static

Definition at line 627 of file rtpdec.c.

Referenced by rtp_parse_one_packet(), and rtp_parse_queued_packet().

◆ ff_rtp_reset_packet_queue()

void ff_rtp_reset_packet_queue ( RTPDemuxContext s)

Definition at line 710 of file rtpdec.c.

Referenced by ff_rtp_parse_close(), and rtsp_read_play().

◆ enqueue_packet()

static int enqueue_packet ( RTPDemuxContext s,
uint8_t buf,
int  len 
)
static

Definition at line 723 of file rtpdec.c.

Referenced by rtp_parse_one_packet().

◆ has_next_packet()

static int has_next_packet ( RTPDemuxContext s)
static

Definition at line 750 of file rtpdec.c.

Referenced by ff_rtp_parse_packet(), and rtp_parse_queued_packet().

◆ ff_rtp_queued_packet_time()

int64_t ff_rtp_queued_packet_time ( RTPDemuxContext s)

Definition at line 755 of file rtpdec.c.

◆ rtp_parse_queued_packet()

static int rtp_parse_queued_packet ( RTPDemuxContext s,
AVPacket pkt 
)
static

Definition at line 760 of file rtpdec.c.

Referenced by ff_rtp_parse_packet(), and rtp_parse_one_packet().

◆ rtp_parse_one_packet()

static int rtp_parse_one_packet ( RTPDemuxContext s,
AVPacket pkt,
uint8_t **  bufptr,
int  len 
)
static

Definition at line 782 of file rtpdec.c.

Referenced by ff_rtp_parse_packet().

◆ ff_rtp_parse_packet()

int ff_rtp_parse_packet ( RTPDemuxContext s,
AVPacket pkt,
uint8_t **  bufptr,
int  len 
)

Parse an RTP or RTCP packet directly sent as a buffer.

Parameters
sRTP parse context.
pktreturned packet
bufptrpointer to the input buffer or NULL to read the next packets
lenbuffer len
Returns
0 if a packet is returned, 1 if a packet is returned and more can follow (use buf as NULL to read the next). -1 if no packet (error or no more packet).

Definition at line 869 of file rtpdec.c.

◆ ff_rtp_parse_close()

void ff_rtp_parse_close ( RTPDemuxContext s)

Definition at line 882 of file rtpdec.c.

Referenced by ff_rtsp_undo_setup().

◆ ff_parse_fmtp()

int ff_parse_fmtp ( AVFormatContext s,
AVStream stream,
PayloadContext data,
const char *  p,
int(*)(AVFormatContext *s, AVStream *stream, PayloadContext *data, const char *attr, const char *value parse_fmtp 
)

◆ ff_rtp_finalize_packet()

int ff_rtp_finalize_packet ( AVPacket pkt,
AVIOContext **  dyn_buf,
int  stream_idx 
)

Variable Documentation

◆ l24_dynamic_handler

RTPDynamicProtocolHandler l24_dynamic_handler
static
Initial value:
= {
.enc_name = "L24",
.codec_type = AVMEDIA_TYPE_AUDIO,
.codec_id = AV_CODEC_ID_PCM_S24BE,
}

Definition at line 36 of file rtpdec.c.

◆ gsm_dynamic_handler

RTPDynamicProtocolHandler gsm_dynamic_handler
static
Initial value:
= {
.enc_name = "GSM",
.codec_type = AVMEDIA_TYPE_AUDIO,
.codec_id = AV_CODEC_ID_GSM,
}

Definition at line 42 of file rtpdec.c.

◆ realmedia_mp3_dynamic_handler

RTPDynamicProtocolHandler realmedia_mp3_dynamic_handler
static
Initial value:
= {
.enc_name = "X-MP3-draft-00",
.codec_type = AVMEDIA_TYPE_AUDIO,
.codec_id = AV_CODEC_ID_MP3ADU,
}

Definition at line 48 of file rtpdec.c.

◆ speex_dynamic_handler

RTPDynamicProtocolHandler speex_dynamic_handler
static
Initial value:
= {
.enc_name = "speex",
.codec_type = AVMEDIA_TYPE_AUDIO,
.codec_id = AV_CODEC_ID_SPEEX,
}

Definition at line 54 of file rtpdec.c.

◆ opus_dynamic_handler

RTPDynamicProtocolHandler opus_dynamic_handler
static
Initial value:
= {
.enc_name = "opus",
.codec_type = AVMEDIA_TYPE_AUDIO,
.codec_id = AV_CODEC_ID_OPUS,
}

Definition at line 60 of file rtpdec.c.

◆ t140_dynamic_handler

RTPDynamicProtocolHandler t140_dynamic_handler
static
Initial value:
= {
.enc_name = "t140",
.codec_type = AVMEDIA_TYPE_SUBTITLE,
.codec_id = AV_CODEC_ID_TEXT,
}

Definition at line 66 of file rtpdec.c.

◆ ff_rdt_video_handler

RTPDynamicProtocolHandler ff_rdt_video_handler

◆ ff_rdt_audio_handler

RTPDynamicProtocolHandler ff_rdt_audio_handler

◆ ff_rdt_live_video_handler

RTPDynamicProtocolHandler ff_rdt_live_video_handler

◆ ff_rdt_live_audio_handler

RTPDynamicProtocolHandler ff_rdt_live_audio_handler

◆ rtp_dynamic_protocol_handler_list

const RTPDynamicProtocolHandler* rtp_dynamic_protocol_handler_list[]
static

Definition at line 77 of file rtpdec.c.

Referenced by ff_rtp_handler_iterate().

AVMEDIA_TYPE_SUBTITLE
@ AVMEDIA_TYPE_SUBTITLE
Definition: avutil.h:204
AV_CODEC_ID_MP3ADU
@ AV_CODEC_ID_MP3ADU
Definition: avcodec.h:577
AV_CODEC_ID_SPEEX
@ AV_CODEC_ID_SPEEX
Definition: avcodec.h:599
AVMEDIA_TYPE_AUDIO
@ AVMEDIA_TYPE_AUDIO
Definition: avutil.h:202
AV_CODEC_ID_GSM
@ AV_CODEC_ID_GSM
as in Berlin toast format
Definition: avcodec.h:582
AV_CODEC_ID_OPUS
@ AV_CODEC_ID_OPUS
Definition: avcodec.h:624
AV_CODEC_ID_TEXT
@ AV_CODEC_ID_TEXT
raw UTF-8 text
Definition: avcodec.h:660
AV_CODEC_ID_PCM_S24BE
@ AV_CODEC_ID_PCM_S24BE
Definition: avcodec.h:476