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 RTPDynamicProtocolHandler *	ff_rtp_handler_iterate (void **opaque)
	Iterate over all registered rtp dynamic protocol handlers. More...
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. More...
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. 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)
RTPDemuxContext *	ff_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 RTPDynamicProtocolHandler *	rtp_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

opaque

a 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

name	name 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

id	AVCodecID 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 438 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 468 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 536 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 572 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 579 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 590 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 625 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 708 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 721 of file rtpdec.c.

Referenced by rtp_parse_one_packet().

has_next_packet()

static int has_next_packet ( RTPDemuxContext *  s )

static

Definition at line 748 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 753 of file rtpdec.c.

rtp_parse_queued_packet()

static int rtp_parse_queued_packet ( RTPDemuxContext *  s, AVPacket *  pkt  )

static

Definition at line 758 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 780 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

s	RTP parse context.
pkt	returned packet
bufptr	pointer to the input buffer or NULL to read the next packets
len	buffer 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 867 of file rtpdec.c.

ff_rtp_parse_close()

void ff_rtp_parse_close

(

RTPDemuxContext *

s

)

Definition at line 880 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
	)

Definition at line 887 of file rtpdec.c.

Referenced by amr_parse_sdp_line(), dv_parse_sdp_line(), hevc_parse_sdp_line(), ilbc_parse_sdp_line(), latm_parse_sdp_line(), parse_h264_sdp_line(), parse_sdp_line(), rfc4175_parse_sdp_line(), and xiph_parse_sdp_line().

ff_rtp_finalize_packet()

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

Close the dynamic buffer and make a packet from it.

Definition at line 925 of file rtpdec.c.

Referenced by ac3_handle_packet(), dv_handle_packet(), h261_handle_packet(), h263_handle_packet(), jpeg_parse_packet(), mpa_robust_parse_packet(), svq3_parse_packet(), vc2hq_handle_frame_fragment(), vp8_handle_packet(), vp9_handle_packet(), and xiph_handle_packet().

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().