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 #ifndef AVFORMAT_RTPDEC_H
23 #define AVFORMAT_RTPDEC_H
24 
25 #include "libavcodec/avcodec.h"
26 #include "avformat.h"
27 #include "rtp.h"
28 #include "url.h"
29 
32 
33 #define RTP_MIN_PACKET_LENGTH 12
34 #define RTP_MAX_PACKET_LENGTH 1500 /* XXX: suppress this define */
35 
36 #define RTP_REORDER_QUEUE_DEFAULT_SIZE 10
37 
38 #define RTP_NOTS_VALUE ((uint32_t)-1)
39 
43  RTPDynamicProtocolHandler *handler);
45  uint8_t **buf, int len);
51 
52 int ff_rtp_set_remote_url(URLContext *h, const char *uri);
53 
65 void ff_rtp_send_punch_packets(URLContext* rtp_handle);
66 
73 
78 
79 // these statistics are used for rtcp receiver reports...
80 typedef struct {
81  uint16_t max_seq;
82  uint32_t cycles;
83  uint32_t base_seq;
84  uint32_t bad_seq;
85  int probation;
86  int received;
89  uint32_t transit;
90  uint32_t jitter;
92 
93 #define RTP_FLAG_KEY 0x1
94 #define RTP_FLAG_MARKER 0x2
95 
107 typedef int (*DynamicPayloadPacketHandlerProc) (AVFormatContext *ctx,
108  PayloadContext *s,
109  AVStream *st,
110  AVPacket * pkt,
111  uint32_t *timestamp,
112  const uint8_t * buf,
113  int len, int flags);
114 
116  // fields from AVRtpDynamicPayloadType_s
117  const char enc_name[50]; /* XXX: still why 50 ? ;-) */
120  int static_payload_id; /* 0 means no payload id is set. 0 is a valid
121  * payload ID (PCMU), too, but that format doesn't
122  * require any custom depacketization code. */
123 
124  // may be null
125  int (*init)(AVFormatContext *s, int st_index, PayloadContext *priv_data);
127  int st_index,
128  PayloadContext *priv_data,
129  const char *line);
130  PayloadContext *(*alloc) (void);
131  void (*free)(PayloadContext *protocol_data);
133 
135 };
136 
137 typedef struct RTPPacket {
138  uint16_t seq;
139  uint8_t *buf;
140  int len;
141  int64_t recvtime;
142  struct RTPPacket *next;
143 } RTPPacket;
144 
145 // moved out of rtp.c, because the h264 decoder needs to know about this structure..
150  uint32_t ssrc;
151  uint16_t seq;
152  uint32_t timestamp;
153  uint32_t base_timestamp;
154  uint32_t cur_timestamp;
158  struct MpegTSContext *ts; /* only used for MP2T payloads */
161  /* used to send back RTCP RR */
163  char hostname[256];
164 
166 
168  int prev_ret;
170  int queue_len;
172 
174  /* rtcp sender statistics receive */
175  int64_t last_rtcp_ntp_time; // TODO: move into statistics
176  int64_t first_rtcp_ntp_time; // TODO: move into statistics
177  uint32_t last_rtcp_timestamp; // TODO: move into statistics
178  int64_t rtcp_ts_offset;
179 
180  /* rtcp sender statistics */
181  unsigned int packet_count; // TODO: move into statistics (outgoing)
182  unsigned int octet_count; // TODO: move into statistics (outgoing)
183  unsigned int last_octet_count; // TODO: move into statistics (outgoing)
185  /* buffer for output */
187  uint8_t *buf_ptr;
188 
189  /* dynamic payload stuff */
193 };
194 
197  enum AVMediaType codec_type);
199  enum AVMediaType codec_type);
200 
201 int ff_rtsp_next_attr_and_value(const char **p, char *attr, int attr_size, char *value, int value_size);
202 
203 int ff_parse_fmtp(AVStream *stream, PayloadContext *data, const char *p,
204  int (*parse_fmtp)(AVStream *stream,
205  PayloadContext *data,
206  char *attr, char *value));
207 
209 
210 #endif /* AVFORMAT_RTPDEC_H */
int queue_size
The size of queue, or 0 if reordering is disabled.
Definition: rtpdec.h:171
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:126
void(* free)(PayloadContext *protocol_data)
free any data needed by the rtp parsing for this dynamic data.
Definition: rtpdec.h:131
AVFormatContext * ic
Definition: rtpdec.h:147
uint16_t seq
Definition: rtpdec.h:151
RTPDynamicProtocolHandler * ff_rtp_handler_find_by_name(const char *name, enum AVMediaType codec_type)
Definition: rtpdec.c:93
#define RTP_MAX_PACKET_LENGTH
Definition: rtpdec.h:34
int read_buf_index
Definition: rtpdec.h:159
int payload_type
Definition: rtpdec.h:149
int64_t range_start_offset
Definition: rtpdec.h:156
int prev_ret
Fields for packet reordering.
Definition: rtpdec.h:168
RTP/H264 specific private data.
Definition: rdt.c:83
unsigned int last_octet_count
Definition: rtpdec.h:183
RTPPacket * queue
A sorted queue of buffered packets not yet returned.
Definition: rtpdec.h:169
enum AVMediaType codec_type
Definition: rtpdec.h:118
enum AVMediaType codec_type
Definition: rtp.c:39
int64_t ff_rtp_queued_packet_time(RTPDemuxContext *s)
Definition: rtpdec.c:626
struct MpegTSContext * ts
Definition: rtpdec.h:158
uint32_t cycles
shifted count of sequence number cycles
Definition: rtpdec.h:82
DynamicPayloadPacketHandlerProc parse_packet
parse handler for this dynamic packet.
Definition: rtpdec.h:132
int ff_rtp_check_and_send_back_rr(RTPDemuxContext *s, int count)
some rtp servers assume client is dead if they don't hear from them...
Definition: rtpdec.c:226
PayloadContext * dynamic_protocol_context
This is a copy from the values setup from the sdp parsing, in rtsp.c don't free me.
Definition: rtpdec.h:191
Format I/O context.
Definition: avformat.h:863
DynamicPayloadPacketHandlerProc parse_packet
This is also copied from the dynamic protocol handler structure.
Definition: rtpdec.h:190
uint32_t base_seq
base sequence number
Definition: rtpdec.h:83
int ff_rtp_get_rtcp_file_handle(URLContext *h)
Get the file handle for the RTCP socket.
Definition: rtpproto.c:320
int len
Definition: rtpdec.h:140
int ff_rtsp_next_attr_and_value(const char **p, char *attr, int attr_size, char *value, int value_size)
from rtsp.c, but used by rtp dynamic protocol handlers.
const char data[16]
Definition: mxf.c:60
static int flags
Definition: log.c:34
int ff_rtp_get_local_rtcp_port(URLContext *h)
Return the local rtcp port used by the RTP connection.
Definition: rtpproto.c:308
int received
packets received
Definition: rtpdec.h:86
char hostname[256]
Definition: rtpdec.h:163
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:757
int ff_rtp_get_local_rtp_port(URLContext *h)
Return the local rtp port used by the RTP connection.
Definition: rtpproto.c:296
void ff_rtp_parse_set_dynamic_protocol(RTPDemuxContext *s, PayloadContext *ctx, RTPDynamicProtocolHandler *handler)
Definition: rtpdec.c:415
int max_frames_per_packet
Definition: rtpdec.h:192
uint16_t seq
Definition: rtpdec.h:138
int probation
sequence packets till source is valid
Definition: rtpdec.h:85
Definition: graph2dot.c:39
void ff_register_dynamic_payload_handler(RTPDynamicProtocolHandler *handler)
Definition: rtpdec.c:55
int64_t rtcp_ts_offset
Definition: rtpdec.h:178
const char enc_name[50]
Definition: rtpdec.h:117
uint32_t timestamp
Definition: rtpdec.h:152
int(* init)(AVFormatContext *s, int st_index, PayloadContext *priv_data)
Initialize dynamic protocol handler, called after the full rtpmap line is parsed. ...
Definition: rtpdec.h:125
uint32_t transit
relative transit time for previous packet
Definition: rtpdec.h:89
uint32_t jitter
estimated jitter.
Definition: rtpdec.h:90
int queue_len
The number of packets in queue.
Definition: rtpdec.h:170
void ff_rtp_reset_packet_queue(RTPDemuxContext *s)
Definition: rtpdec.c:579
int64_t first_rtcp_ntp_time
Definition: rtpdec.h:176
int read_buf_size
Definition: rtpdec.h:160
void av_register_rtp_dynamic_payload_handlers(void)
Definition: rtpdec.c:61
int64_t last_rtcp_ntp_time
Definition: rtpdec.h:175
uint8_t buf[RTP_MAX_PACKET_LENGTH]
Definition: rtpdec.h:186
AVFormatContext * stream
Definition: mpegts.c:97
URLContext * rtp_ctx
Definition: rtpdec.h:162
int max_payload_size
Definition: rtpdec.h:157
Stream structure.
Definition: avformat.h:620
external API header
unsigned int packet_count
Definition: rtpdec.h:181
int64_t unwrapped_timestamp
Definition: rtpdec.h:155
uint32_t last_rtcp_timestamp
Definition: rtpdec.h:177
static int parse_fmtp(AVStream *stream, PayloadContext *data, char *attr, char *value)
Definition: rtpdec_latm.c:147
static void(WINAPI *cond_broadcast)(pthread_cond_t *cond)
void ff_rtp_parse_close(RTPDemuxContext *s)
Definition: rtpdec.c:748
unsigned int octet_count
Definition: rtpdec.h:182
Definition: url.h:42
RTPDynamicProtocolHandler * ff_rtp_handler_find_by_id(int id, enum AVMediaType codec_type)
Definition: rtpdec.c:105
RTPStatistics statistics
Statistics for this stream (used by RTCP receiver reports)
Definition: rtpdec.h:165
int(* DynamicPayloadPacketHandlerProc)(AVFormatContext *ctx, PayloadContext *s, AVStream *st, AVPacket *pkt, uint32_t *timestamp, const uint8_t *buf, int len, int flags)
Packet parsing for "private" payloads in the RTP specs.
Definition: rtpdec.h:107
uint32_t bad_seq
last bad sequence number + 1
Definition: rtpdec.h:84
enum CodecID codec_id
Definition: rtpdec.h:119
AVMediaType
Definition: avutil.h:228
#define s1
Definition: regdef.h:38
uint8_t * buf_ptr
Definition: rtpdec.h:187
uint16_t max_seq
highest sequence number seen
Definition: rtpdec.h:81
uint8_t * buf
Definition: rtpdec.h:139
const char * name
Definition: audioconvert.c:61
struct RTPDynamicProtocolHandler_s * next
Definition: rtpdec.h:134
Main libavformat public API header.
struct RTPPacket * next
Definition: rtpdec.h:142
uint32_t ssrc
Definition: rtpdec.h:150
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:738
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:323
RTPDemuxContext * ff_rtp_parse_open(AVFormatContext *s1, AVStream *st, URLContext *rtpc, int payload_type, int queue_size)
open a new RTP parse context for stream 'st'.
Definition: rtpdec.c:367
struct RTPPacket RTPPacket
CodecID
Identify the syntax and semantics of the bitstream.
Definition: avcodec.h:83
uint32_t base_timestamp
Definition: rtpdec.h:153
int len
int received_prior
packets received in last interval
Definition: rtpdec.h:88
unbuffered private I/O API
int expected_prior
packets expected in last interval
Definition: rtpdec.h:87
int first_packet
Definition: rtpdec.h:184
uint32_t cur_timestamp
Definition: rtpdec.h:154
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:63
AVStream * st
Definition: rtpdec.h:148