rtpdec.h
Go to the documentation of this file.
1 /*
2  * RTP demuxer definitions
3  * Copyright (c) 2002 Fabrice Bellard
4  * Copyright (c) 2006 Ryan Martell <rdm4@martellventures.com>
5  *
6  * This file is part of Libav.
7  *
8  * Libav is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * Libav is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with Libav; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22 
23 #ifndef AVFORMAT_RTPDEC_H
24 #define AVFORMAT_RTPDEC_H
25 
26 #include "libavcodec/avcodec.h"
27 #include "avformat.h"
28 #include "rtp.h"
29 #include "url.h"
30 
33 
34 #define RTP_MIN_PACKET_LENGTH 12
35 #define RTP_MAX_PACKET_LENGTH 1500
36 
37 #define RTP_REORDER_QUEUE_DEFAULT_SIZE 10
38 
39 #define RTP_NOTS_VALUE ((uint32_t)-1)
40 
43  int payload_type, int queue_size);
45  RTPDynamicProtocolHandler *handler);
47  uint8_t **buf, int len);
53 
54 int ff_rtp_set_remote_url(URLContext *h, const char *uri);
55 
67 void ff_rtp_send_punch_packets(URLContext* rtp_handle);
68 
75  AVIOContext *avio, int count);
76 
77 // these statistics are used for rtcp receiver reports...
78 typedef struct RTPStatistics {
79  uint16_t max_seq;
80  uint32_t cycles;
81  uint32_t base_seq;
82  uint32_t bad_seq;
83  int probation;
84  int received;
87  uint32_t transit;
88  uint32_t jitter;
90 
91 #define RTP_FLAG_KEY 0x1
92 #define RTP_FLAG_MARKER 0x2
93 
107 typedef int (*DynamicPayloadPacketHandlerProc)(AVFormatContext *ctx,
108  PayloadContext *s,
109  AVStream *st, AVPacket *pkt,
110  uint32_t *timestamp,
111  const uint8_t * buf,
112  int len, uint16_t seq, int flags);
113 
115  const char enc_name[50];
118  int static_payload_id; /* 0 means no payload id is set. 0 is a valid
119  * payload ID (PCMU), too, but that format doesn't
120  * require any custom depacketization code. */
121 
123  int (*init)(AVFormatContext *s, int st_index, PayloadContext *priv_data);
125  int (*parse_sdp_a_line)(AVFormatContext *s, int st_index,
126  PayloadContext *priv_data, const char *line);
128  PayloadContext *(*alloc)(void);
130  void (*free)(PayloadContext *protocol_data);
133 
135 };
136 
137 typedef struct RTPPacket {
138  uint16_t seq;
140  int len;
141  int64_t recvtime;
142  struct RTPPacket *next;
143 } RTPPacket;
144 
149  uint32_t ssrc;
150  uint16_t seq;
151  uint32_t timestamp;
152  uint32_t base_timestamp;
153  uint32_t cur_timestamp;
157  struct MpegTSContext *ts; /* only used for MP2T payloads */
160  /* used to send back RTCP RR */
161  char hostname[256];
162 
165 
167  int prev_ret;
169  int queue_len;
171 
173  /* rtcp sender statistics receive */
177  int64_t rtcp_ts_offset;
178 
179  /* rtcp sender statistics */
180  unsigned int packet_count;
181  unsigned int octet_count;
182  unsigned int last_octet_count;
183  /* buffer for partially parsed packets */
185 
186  /* dynamic payload stuff */
189 };
190 
193  enum AVMediaType codec_type);
195  enum AVMediaType codec_type);
196 
197 /* from rtsp.c, but used by rtp dynamic protocol handlers. */
198 int ff_rtsp_next_attr_and_value(const char **p, char *attr, int attr_size,
199  char *value, int value_size);
200 
201 int ff_parse_fmtp(AVStream *stream, PayloadContext *data, const char *p,
202  int (*parse_fmtp)(AVStream *stream,
203  PayloadContext *data,
204  char *attr, char *value));
205 
207 
211 int ff_rtp_finalize_packet(AVPacket *pkt, AVIOContext **dyn_buf, int stream_idx);
212 
213 #endif /* AVFORMAT_RTPDEC_H */
int queue_size
The size of queue, or 0 if reordering is disabled.
Definition: rtpdec.h:170
Bytestream IO Context.
Definition: avio.h:68
AVFormatContext * ic
Definition: rtpdec.h:146
uint16_t seq
Definition: rtpdec.h:150
RTPDynamicProtocolHandler * ff_rtp_handler_find_by_name(const char *name, enum AVMediaType codec_type)
Definition: rtpdec.c:97
#define RTP_MAX_PACKET_LENGTH
Definition: rtpdec.h:35
int read_buf_index
Definition: rtpdec.h:158
int payload_type
Definition: rtpdec.h:148
int64_t range_start_offset
Definition: rtpdec.h:155
int prev_ret
Fields for packet reordering.
Definition: rtpdec.h:167
RTP/JPEG specific private data.
Definition: rdt.c:83
unsigned int last_octet_count
Definition: rtpdec.h:182
RTPPacket * queue
A sorted queue of buffered packets not yet returned.
Definition: rtpdec.h:168
enum AVMediaType codec_type
Definition: rtp.c:39
int64_t ff_rtp_queued_packet_time(RTPDemuxContext *s)
Definition: rtpdec.c:641
struct MpegTSContext * ts
Definition: rtpdec.h:157
uint32_t cycles
shifted count of sequence number cycles
Definition: rtpdec.h:80
enum AVMediaType codec_type
Definition: rtpdec.h:116
PayloadContext * dynamic_protocol_context
Definition: rtpdec.h:188
Format I/O context.
Definition: avformat.h:828
DynamicPayloadPacketHandlerProc parse_packet
Definition: rtpdec.h:187
uint32_t base_seq
base sequence number
Definition: rtpdec.h:81
uint8_t
int(* init)(AVFormatContext *s, int st_index, PayloadContext *priv_data)
Initialize dynamic protocol handler, called after the full rtpmap line is parsed, may be null...
Definition: rtpdec.h:123
int ff_rtp_finalize_packet(AVPacket *pkt, AVIOContext **dyn_buf, int stream_idx)
Close the dynamic buffer and make a packet from it.
Definition: rtpdec.c:809
int len
Definition: rtpdec.h:140
void(* free)(PayloadContext *protocol_data)
Free any data needed by the rtp parsing for this dynamic data.
Definition: rtpdec.h:130
const char * name
int ff_rtsp_next_attr_and_value(const char **p, char *attr, int attr_size, char *value, int value_size)
const char data[16]
Definition: mxf.c:66
static int flags
Definition: log.c:42
int ff_rtp_get_local_rtcp_port(URLContext *h)
Return the local rtcp port used by the RTP connection.
Definition: rtpproto.c:303
int received
packets received
Definition: rtpdec.h:84
char hostname[256]
Definition: rtpdec.h:161
int ff_parse_fmtp(AVStream *stream, PayloadContext *data, const char *p, int(*parse_fmtp)(AVStream *stream, PayloadContext *data, char *attr, char *value))
Definition: rtpdec.c:773
int ff_rtp_get_local_rtp_port(URLContext *h)
Return the local rtp port used by the RTP connection.
Definition: rtpproto.c:291
void ff_rtp_parse_set_dynamic_protocol(RTPDemuxContext *s, PayloadContext *ctx, RTPDynamicProtocolHandler *handler)
Definition: rtpdec.c:424
AVCodecID
Identify the syntax and semantics of the bitstream.
Definition: avcodec.h:95
uint16_t seq
Definition: rtpdec.h:138
int probation
sequence packets till source is valid
Definition: rtpdec.h:83
Definition: graph2dot.c:48
void ff_register_dynamic_payload_handler(RTPDynamicProtocolHandler *handler)
Definition: rtpdec.c:54
DynamicPayloadPacketHandlerProc parse_packet
Parse handler for this dynamic packet.
Definition: rtpdec.h:132
int64_t rtcp_ts_offset
Definition: rtpdec.h:177
uint32_t timestamp
Definition: rtpdec.h:151
uint32_t transit
relative transit time for previous packet
Definition: rtpdec.h:87
uint32_t jitter
estimated jitter.
Definition: rtpdec.h:88
int queue_len
The number of packets in queue.
Definition: rtpdec.h:169
void ff_rtp_reset_packet_queue(RTPDemuxContext *s)
Definition: rtpdec.c:594
int(* DynamicPayloadPacketHandlerProc)(AVFormatContext *ctx, PayloadContext *s, AVStream *st, AVPacket *pkt, uint32_t *timestamp, const uint8_t *buf, int len, uint16_t seq, int flags)
Packet parsing for "private" payloads in the RTP specs.
Definition: rtpdec.h:107
int64_t first_rtcp_ntp_time
Definition: rtpdec.h:175
int read_buf_size
Definition: rtpdec.h:159
void av_register_rtp_dynamic_payload_handlers(void)
Definition: rtpdec.c:60
int64_t last_rtcp_ntp_time
Definition: rtpdec.h:174
uint8_t buf[RTP_MAX_PACKET_LENGTH]
Definition: rtpdec.h:184
AVFormatContext * stream
Definition: mpegts.c:95
int(* parse_sdp_a_line)(AVFormatContext *s, int st_index, PayloadContext *priv_data, const char *line)
Parse the a= line from the sdp field.
Definition: rtpdec.h:125
int max_payload_size
Definition: rtpdec.h:156
RTPDemuxContext * ff_rtp_parse_open(AVFormatContext *s1, AVStream *st, int payload_type, int queue_size)
open a new RTP parse context for stream 'st'.
Definition: rtpdec.c:374
Stream structure.
Definition: avformat.h:622
external API header
unsigned int packet_count
Definition: rtpdec.h:180
int64_t unwrapped_timestamp
Definition: rtpdec.h:154
uint32_t last_rtcp_timestamp
Definition: rtpdec.h:176
static int parse_fmtp(AVStream *stream, PayloadContext *data, char *attr, char *value)
Definition: rtpdec_latm.c:148
static void(WINAPI *cond_broadcast)(pthread_cond_t *cond)
void ff_rtp_parse_close(RTPDemuxContext *s)
Definition: rtpdec.c:764
unsigned int octet_count
Definition: rtpdec.h:181
enum AVCodecID codec_id
Definition: rtpdec.h:117
Definition: url.h:41
RTPDynamicProtocolHandler * ff_rtp_handler_find_by_id(int id, enum AVMediaType codec_type)
Definition: rtpdec.c:109
RTPStatistics statistics
Statistics for this stream (used by RTCP receiver reports)
Definition: rtpdec.h:164
uint32_t bad_seq
last bad sequence number + 1
Definition: rtpdec.h:82
AVMediaType
Definition: avutil.h:177
const char enc_name[50]
Definition: rtpdec.h:115
#define s1
Definition: regdef.h:38
uint16_t max_seq
highest sequence number seen
Definition: rtpdec.h:79
uint8_t * buf
Definition: rtpdec.h:139
Main libavformat public API header.
struct RTPPacket * next
Definition: rtpdec.h:142
uint32_t ssrc
Definition: rtpdec.h:149
int64_t recvtime
Definition: rtpdec.h:141
int ff_rtp_parse_packet(RTPDemuxContext *s, AVPacket *pkt, uint8_t **buf, int len)
Parse an RTP or RTCP packet directly sent as a buffer.
Definition: rtpdec.c:754
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...
Definition: rtpdec.c:331
struct RTPPacket RTPPacket
uint32_t base_timestamp
Definition: rtpdec.h:152
AVPacket * pkt
packet containing Audio/Video data
Definition: mpegts.c:114
int len
int received_prior
packets received in last interval
Definition: rtpdec.h:86
unbuffered private I/O API
int expected_prior
packets expected in last interval
Definition: rtpdec.h:85
struct RTPStatistics RTPStatistics
uint32_t cur_timestamp
Definition: rtpdec.h:153
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...
Definition: rtpdec.c:229
int ff_rtp_set_remote_url(URLContext *h, const char *uri)
If no filename is given to av_open_input_file because you want to get the local port first...
Definition: rtpproto.c:58
AVStream * st
Definition: rtpdec.h:147
This structure stores compressed data.
Definition: avcodec.h:898
struct RTPDynamicProtocolHandler * next
Definition: rtpdec.h:134