3 * Copyright (c) 2002 Fabrice Bellard
5 * This file is part of Libav.
7 * Libav is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * Libav is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with Libav; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 #include "libavutil/mathematics.h"
23 #include "libavutil/avstring.h"
24 #include "libavutil/time.h"
25 #include "libavcodec/get_bits.h"
33 #include "rtpdec_formats.h"
37 /* TODO: - add RTCP statistics reporting (should be optional).
39 - add support for h263/mpeg4 packetized output : IDEA: send a
40 buffer to 'rtp_write_packet' contains all the packets for ONE
41 frame. Each packet should have a four byte header containing
42 the length in big endian format (same trick as
43 'ffio_open_dyn_packet_buf')
46 static RTPDynamicProtocolHandler ff_realmedia_mp3_dynamic_handler = {
47 .enc_name = "X-MP3-draft-00",
48 .codec_type = AVMEDIA_TYPE_AUDIO,
49 .codec_id = AV_CODEC_ID_MP3ADU,
52 /* statistics functions */
53 static RTPDynamicProtocolHandler *RTPFirstDynamicPayloadHandler= NULL;
55 void ff_register_dynamic_payload_handler(RTPDynamicProtocolHandler *handler)
57 handler->next= RTPFirstDynamicPayloadHandler;
58 RTPFirstDynamicPayloadHandler= handler;
61 void av_register_rtp_dynamic_payload_handlers(void)
63 ff_register_dynamic_payload_handler(&ff_mp4v_es_dynamic_handler);
64 ff_register_dynamic_payload_handler(&ff_mpeg4_generic_dynamic_handler);
65 ff_register_dynamic_payload_handler(&ff_amr_nb_dynamic_handler);
66 ff_register_dynamic_payload_handler(&ff_amr_wb_dynamic_handler);
67 ff_register_dynamic_payload_handler(&ff_h263_1998_dynamic_handler);
68 ff_register_dynamic_payload_handler(&ff_h263_2000_dynamic_handler);
69 ff_register_dynamic_payload_handler(&ff_h263_rfc2190_dynamic_handler);
70 ff_register_dynamic_payload_handler(&ff_h264_dynamic_handler);
71 ff_register_dynamic_payload_handler(&ff_ilbc_dynamic_handler);
72 ff_register_dynamic_payload_handler(&ff_vorbis_dynamic_handler);
73 ff_register_dynamic_payload_handler(&ff_theora_dynamic_handler);
74 ff_register_dynamic_payload_handler(&ff_qdm2_dynamic_handler);
75 ff_register_dynamic_payload_handler(&ff_svq3_dynamic_handler);
76 ff_register_dynamic_payload_handler(&ff_mp4a_latm_dynamic_handler);
77 ff_register_dynamic_payload_handler(&ff_vp8_dynamic_handler);
78 ff_register_dynamic_payload_handler(&ff_qcelp_dynamic_handler);
79 ff_register_dynamic_payload_handler(&ff_realmedia_mp3_dynamic_handler);
81 ff_register_dynamic_payload_handler(&ff_ms_rtp_asf_pfv_handler);
82 ff_register_dynamic_payload_handler(&ff_ms_rtp_asf_pfa_handler);
84 ff_register_dynamic_payload_handler(&ff_qt_rtp_aud_handler);
85 ff_register_dynamic_payload_handler(&ff_qt_rtp_vid_handler);
86 ff_register_dynamic_payload_handler(&ff_quicktime_rtp_aud_handler);
87 ff_register_dynamic_payload_handler(&ff_quicktime_rtp_vid_handler);
89 ff_register_dynamic_payload_handler(&ff_g726_16_dynamic_handler);
90 ff_register_dynamic_payload_handler(&ff_g726_24_dynamic_handler);
91 ff_register_dynamic_payload_handler(&ff_g726_32_dynamic_handler);
92 ff_register_dynamic_payload_handler(&ff_g726_40_dynamic_handler);
95 RTPDynamicProtocolHandler *ff_rtp_handler_find_by_name(const char *name,
96 enum AVMediaType codec_type)
98 RTPDynamicProtocolHandler *handler;
99 for (handler = RTPFirstDynamicPayloadHandler;
100 handler; handler = handler->next)
101 if (!av_strcasecmp(name, handler->enc_name) &&
102 codec_type == handler->codec_type)
107 RTPDynamicProtocolHandler *ff_rtp_handler_find_by_id(int id,
108 enum AVMediaType codec_type)
110 RTPDynamicProtocolHandler *handler;
111 for (handler = RTPFirstDynamicPayloadHandler;
112 handler; handler = handler->next)
113 if (handler->static_payload_id && handler->static_payload_id == id &&
114 codec_type == handler->codec_type)
119 static int rtcp_parse_packet(RTPDemuxContext *s, const unsigned char *buf, int len)
123 payload_len = FFMIN(len, (AV_RB16(buf + 2) + 1) * 4);
127 if (payload_len < 20) {
128 av_log(NULL, AV_LOG_ERROR, "Invalid length for RTCP SR packet\n");
129 return AVERROR_INVALIDDATA;
132 s->last_rtcp_ntp_time = AV_RB64(buf + 8);
133 s->last_rtcp_timestamp = AV_RB32(buf + 16);
134 if (s->first_rtcp_ntp_time == AV_NOPTS_VALUE) {
135 s->first_rtcp_ntp_time = s->last_rtcp_ntp_time;
136 if (!s->base_timestamp)
137 s->base_timestamp = s->last_rtcp_timestamp;
138 s->rtcp_ts_offset = s->last_rtcp_timestamp - s->base_timestamp;
152 #define RTP_SEQ_MOD (1<<16)
155 * called on parse open packet
157 static void rtp_init_statistics(RTPStatistics *s, uint16_t base_sequence) // called on parse open packet.
159 memset(s, 0, sizeof(RTPStatistics));
160 s->max_seq= base_sequence;
165 * called whenever there is a large jump in sequence numbers, or when they get out of probation...
167 static void rtp_init_sequence(RTPStatistics *s, uint16_t seq)
172 s->bad_seq= RTP_SEQ_MOD + 1;
174 s->expected_prior= 0;
175 s->received_prior= 0;
181 * returns 1 if we should handle this packet.
183 static int rtp_valid_packet_in_sequence(RTPStatistics *s, uint16_t seq)
185 uint16_t udelta= seq - s->max_seq;
186 const int MAX_DROPOUT= 3000;
187 const int MAX_MISORDER = 100;
188 const int MIN_SEQUENTIAL = 2;
190 /* source not valid until MIN_SEQUENTIAL packets with sequence seq. numbers have been received */
193 if(seq==s->max_seq + 1) {
196 if(s->probation==0) {
197 rtp_init_sequence(s, seq);
202 s->probation= MIN_SEQUENTIAL - 1;
205 } else if (udelta < MAX_DROPOUT) {
206 // in order, with permissible gap
207 if(seq < s->max_seq) {
208 //sequence number wrapped; count antother 64k cycles
209 s->cycles += RTP_SEQ_MOD;
212 } else if (udelta <= RTP_SEQ_MOD - MAX_MISORDER) {
213 // sequence made a large jump...
214 if(seq==s->bad_seq) {
215 // two sequential packets-- assume that the other side restarted without telling us; just resync.
216 rtp_init_sequence(s, seq);
218 s->bad_seq= (seq + 1) & (RTP_SEQ_MOD-1);
222 // duplicate or reordered packet...
228 int ff_rtp_check_and_send_back_rr(RTPDemuxContext *s, int count)
234 RTPStatistics *stats= &s->statistics;
236 uint32_t extended_max;
237 uint32_t expected_interval;
238 uint32_t received_interval;
239 uint32_t lost_interval;
242 uint64_t ntp_time= s->last_rtcp_ntp_time; // TODO: Get local ntp time?
244 if (!s->rtp_ctx || (count < 1))
247 /* TODO: I think this is way too often; RFC 1889 has algorithm for this */
248 /* XXX: mpeg pts hardcoded. RTCP send every 0.5 seconds */
249 s->octet_count += count;
250 rtcp_bytes = ((s->octet_count - s->last_octet_count) * RTCP_TX_RATIO_NUM) /
252 rtcp_bytes /= 50; // mmu_man: that's enough for me... VLC sends much less btw !?
255 s->last_octet_count = s->octet_count;
257 if (avio_open_dyn_buf(&pb) < 0)
261 avio_w8(pb, (RTP_VERSION << 6) + 1); /* 1 report block */
262 avio_w8(pb, RTCP_RR);
263 avio_wb16(pb, 7); /* length in words - 1 */
264 // our own SSRC: we use the server's SSRC + 1 to avoid conflicts
265 avio_wb32(pb, s->ssrc + 1);
266 avio_wb32(pb, s->ssrc); // server SSRC
267 // some placeholders we should really fill...
269 extended_max= stats->cycles + stats->max_seq;
270 expected= extended_max - stats->base_seq + 1;
271 lost= expected - stats->received;
272 lost= FFMIN(lost, 0xffffff); // clamp it since it's only 24 bits...
273 expected_interval= expected - stats->expected_prior;
274 stats->expected_prior= expected;
275 received_interval= stats->received - stats->received_prior;
276 stats->received_prior= stats->received;
277 lost_interval= expected_interval - received_interval;
278 if (expected_interval==0 || lost_interval<=0) fraction= 0;
279 else fraction = (lost_interval<<8)/expected_interval;
281 fraction= (fraction<<24) | lost;
283 avio_wb32(pb, fraction); /* 8 bits of fraction, 24 bits of total packets lost */
284 avio_wb32(pb, extended_max); /* max sequence received */
285 avio_wb32(pb, stats->jitter>>4); /* jitter */
287 if(s->last_rtcp_ntp_time==AV_NOPTS_VALUE)
289 avio_wb32(pb, 0); /* last SR timestamp */
290 avio_wb32(pb, 0); /* delay since last SR */
292 uint32_t middle_32_bits= s->last_rtcp_ntp_time>>16; // this is valid, right? do we need to handle 64 bit values special?
293 uint32_t delay_since_last= ntp_time - s->last_rtcp_ntp_time;
295 avio_wb32(pb, middle_32_bits); /* last SR timestamp */
296 avio_wb32(pb, delay_since_last); /* delay since last SR */
300 avio_w8(pb, (RTP_VERSION << 6) + 1); /* 1 report block */
301 avio_w8(pb, RTCP_SDES);
302 len = strlen(s->hostname);
303 avio_wb16(pb, (6 + len + 3) / 4); /* length in words - 1 */
304 avio_wb32(pb, s->ssrc + 1);
307 avio_write(pb, s->hostname, len);
309 for (len = (6 + len) % 4; len % 4; len++) {
314 len = avio_close_dyn_buf(pb, &buf);
315 if ((len > 0) && buf) {
316 int av_unused result;
317 av_dlog(s->ic, "sending %d bytes of RR\n", len);
318 result= ffurl_write(s->rtp_ctx, buf, len);
319 av_dlog(s->ic, "result from ffurl_write: %d\n", result);
325 void ff_rtp_send_punch_packets(URLContext* rtp_handle)
331 /* Send a small RTP packet */
332 if (avio_open_dyn_buf(&pb) < 0)
335 avio_w8(pb, (RTP_VERSION << 6));
336 avio_w8(pb, 0); /* Payload type */
337 avio_wb16(pb, 0); /* Seq */
338 avio_wb32(pb, 0); /* Timestamp */
339 avio_wb32(pb, 0); /* SSRC */
342 len = avio_close_dyn_buf(pb, &buf);
343 if ((len > 0) && buf)
344 ffurl_write(rtp_handle, buf, len);
347 /* Send a minimal RTCP RR */
348 if (avio_open_dyn_buf(&pb) < 0)
351 avio_w8(pb, (RTP_VERSION << 6));
352 avio_w8(pb, RTCP_RR); /* receiver report */
353 avio_wb16(pb, 1); /* length in words - 1 */
354 avio_wb32(pb, 0); /* our own SSRC */
357 len = avio_close_dyn_buf(pb, &buf);
358 if ((len > 0) && buf)
359 ffurl_write(rtp_handle, buf, len);
365 * open a new RTP parse context for stream 'st'. 'st' can be NULL for
366 * MPEG2TS streams to indicate that they should be demuxed inside the
367 * rtp demux (otherwise AV_CODEC_ID_MPEG2TS packets are returned)
369 RTPDemuxContext *ff_rtp_parse_open(AVFormatContext *s1, AVStream *st, URLContext *rtpc, int payload_type, int queue_size)
373 s = av_mallocz(sizeof(RTPDemuxContext));
376 s->payload_type = payload_type;
377 s->last_rtcp_ntp_time = AV_NOPTS_VALUE;
378 s->first_rtcp_ntp_time = AV_NOPTS_VALUE;
381 s->queue_size = queue_size;
382 rtp_init_statistics(&s->statistics, 0); // do we know the initial sequence from sdp?
383 if (!strcmp(ff_rtp_enc_name(payload_type), "MP2T")) {
384 s->ts = ff_mpegts_parse_open(s->ic);
390 switch(st->codec->codec_id) {
391 case AV_CODEC_ID_MPEG1VIDEO:
392 case AV_CODEC_ID_MPEG2VIDEO:
393 case AV_CODEC_ID_MP2:
394 case AV_CODEC_ID_MP3:
395 case AV_CODEC_ID_MPEG4:
396 case AV_CODEC_ID_H263:
397 case AV_CODEC_ID_H264:
398 st->need_parsing = AVSTREAM_PARSE_FULL;
400 case AV_CODEC_ID_VORBIS:
401 st->need_parsing = AVSTREAM_PARSE_HEADERS;
403 case AV_CODEC_ID_ADPCM_G722:
404 /* According to RFC 3551, the stream clock rate is 8000
405 * even if the sample rate is 16000. */
406 if (st->codec->sample_rate == 8000)
407 st->codec->sample_rate = 16000;
413 // needed to send back RTCP RR in RTSP sessions
415 gethostname(s->hostname, sizeof(s->hostname));
420 ff_rtp_parse_set_dynamic_protocol(RTPDemuxContext *s, PayloadContext *ctx,
421 RTPDynamicProtocolHandler *handler)
423 s->dynamic_protocol_context = ctx;
424 s->parse_packet = handler->parse_packet;
428 * This was the second switch in rtp_parse packet. Normalizes time, if required, sets stream_index, etc.
430 static void finalize_packet(RTPDemuxContext *s, AVPacket *pkt, uint32_t timestamp)
432 if (pkt->pts != AV_NOPTS_VALUE || pkt->dts != AV_NOPTS_VALUE)
433 return; /* Timestamp already set by depacketizer */
434 if (timestamp == RTP_NOTS_VALUE)
437 if (s->last_rtcp_ntp_time != AV_NOPTS_VALUE && s->ic->nb_streams > 1) {
441 /* compute pts from timestamp with received ntp_time */
442 delta_timestamp = timestamp - s->last_rtcp_timestamp;
443 /* convert to the PTS timebase */
444 addend = av_rescale(s->last_rtcp_ntp_time - s->first_rtcp_ntp_time, s->st->time_base.den, (uint64_t)s->st->time_base.num << 32);
445 pkt->pts = s->range_start_offset + s->rtcp_ts_offset + addend +
450 if (!s->base_timestamp)
451 s->base_timestamp = timestamp;
452 /* assume that the difference is INT32_MIN < x < INT32_MAX, but allow the first timestamp to exceed INT32_MAX */
454 s->unwrapped_timestamp += timestamp;
456 s->unwrapped_timestamp += (int32_t)(timestamp - s->timestamp);
457 s->timestamp = timestamp;
458 pkt->pts = s->unwrapped_timestamp + s->range_start_offset - s->base_timestamp;
461 static int rtp_parse_packet_internal(RTPDemuxContext *s, AVPacket *pkt,
462 const uint8_t *buf, int len)
464 unsigned int ssrc, h;
465 int payload_type, seq, ret, flags = 0;
472 payload_type = buf[1] & 0x7f;
474 flags |= RTP_FLAG_MARKER;
475 seq = AV_RB16(buf + 2);
476 timestamp = AV_RB32(buf + 4);
477 ssrc = AV_RB32(buf + 8);
478 /* store the ssrc in the RTPDemuxContext */
481 /* NOTE: we can handle only one payload type */
482 if (s->payload_type != payload_type)
486 // only do something with this if all the rtp checks pass...
487 if(!rtp_valid_packet_in_sequence(&s->statistics, seq))
489 av_log(st?st->codec:NULL, AV_LOG_ERROR, "RTP: PT=%02x: bad cseq %04x expected=%04x\n",
490 payload_type, seq, ((s->seq + 1) & 0xffff));
495 int padding = buf[len - 1];
496 if (len >= 12 + padding)
504 /* RFC 3550 Section 5.3.1 RTP Header Extension handling */
508 /* calculate the header extension length (stored as number
509 * of 32-bit words) */
510 ext = (AV_RB16(buf + 2) + 1) << 2;
514 // skip past RTP header extension
520 /* specific MPEG2TS demux support */
521 ret = ff_mpegts_parse_packet(s->ts, pkt, buf, len);
522 /* The only error that can be returned from ff_mpegts_parse_packet
523 * is "no more data to return from the provided buffer", so return
524 * AVERROR(EAGAIN) for all errors */
526 return AVERROR(EAGAIN);
528 s->read_buf_size = len - ret;
529 memcpy(s->buf, buf + ret, s->read_buf_size);
530 s->read_buf_index = 0;
534 } else if (s->parse_packet) {
535 rv = s->parse_packet(s->ic, s->dynamic_protocol_context,
536 s->st, pkt, ×tamp, buf, len, flags);
538 // at this point, the RTP header has been stripped; This is ASSUMING that there is only 1 CSRC, which in't wise.
539 switch(st->codec->codec_id) {
540 case AV_CODEC_ID_MP2:
541 case AV_CODEC_ID_MP3:
542 /* better than nothing: skip mpeg audio RTP header */
548 av_new_packet(pkt, len);
549 memcpy(pkt->data, buf, len);
551 case AV_CODEC_ID_MPEG1VIDEO:
552 case AV_CODEC_ID_MPEG2VIDEO:
553 /* better than nothing: skip mpeg video RTP header */
566 av_new_packet(pkt, len);
567 memcpy(pkt->data, buf, len);
570 av_new_packet(pkt, len);
571 memcpy(pkt->data, buf, len);
575 pkt->stream_index = st->index;
578 // now perform timestamp things....
579 finalize_packet(s, pkt, timestamp);
584 void ff_rtp_reset_packet_queue(RTPDemuxContext *s)
587 RTPPacket *next = s->queue->next;
588 av_free(s->queue->buf);
597 static void enqueue_packet(RTPDemuxContext *s, uint8_t *buf, int len)
599 uint16_t seq = AV_RB16(buf + 2);
600 RTPPacket *cur = s->queue, *prev = NULL, *packet;
602 /* Find the correct place in the queue to insert the packet */
604 int16_t diff = seq - cur->seq;
611 packet = av_mallocz(sizeof(*packet));
614 packet->recvtime = av_gettime();
626 static int has_next_packet(RTPDemuxContext *s)
628 return s->queue && s->queue->seq == (uint16_t) (s->seq + 1);
631 int64_t ff_rtp_queued_packet_time(RTPDemuxContext *s)
633 return s->queue ? s->queue->recvtime : 0;
636 static int rtp_parse_queued_packet(RTPDemuxContext *s, AVPacket *pkt)
641 if (s->queue_len <= 0)
644 if (!has_next_packet(s))
645 av_log(s->st ? s->st->codec : NULL, AV_LOG_WARNING,
646 "RTP: missed %d packets\n", s->queue->seq - s->seq - 1);
648 /* Parse the first packet in the queue, and dequeue it */
649 rv = rtp_parse_packet_internal(s, pkt, s->queue->buf, s->queue->len);
650 next = s->queue->next;
651 av_free(s->queue->buf);
658 static int rtp_parse_one_packet(RTPDemuxContext *s, AVPacket *pkt,
659 uint8_t **bufptr, int len)
661 uint8_t* buf = bufptr ? *bufptr : NULL;
667 /* If parsing of the previous packet actually returned 0 or an error,
668 * there's nothing more to be parsed from that packet, but we may have
669 * indicated that we can return the next enqueued packet. */
670 if (s->prev_ret <= 0)
671 return rtp_parse_queued_packet(s, pkt);
672 /* return the next packets, if any */
673 if(s->st && s->parse_packet) {
674 /* timestamp should be overwritten by parse_packet, if not,
675 * the packet is left with pts == AV_NOPTS_VALUE */
676 timestamp = RTP_NOTS_VALUE;
677 rv= s->parse_packet(s->ic, s->dynamic_protocol_context,
678 s->st, pkt, ×tamp, NULL, 0, flags);
679 finalize_packet(s, pkt, timestamp);
682 // TODO: Move to a dynamic packet handler (like above)
683 if (s->read_buf_index >= s->read_buf_size)
684 return AVERROR(EAGAIN);
685 ret = ff_mpegts_parse_packet(s->ts, pkt, s->buf + s->read_buf_index,
686 s->read_buf_size - s->read_buf_index);
688 return AVERROR(EAGAIN);
689 s->read_buf_index += ret;
690 if (s->read_buf_index < s->read_buf_size)
700 if ((buf[0] & 0xc0) != (RTP_VERSION << 6))
702 if (RTP_PT_IS_RTCP(buf[1])) {
703 return rtcp_parse_packet(s, buf, len);
706 if ((s->seq == 0 && !s->queue) || s->queue_size <= 1) {
707 /* First packet, or no reordering */
708 return rtp_parse_packet_internal(s, pkt, buf, len);
710 uint16_t seq = AV_RB16(buf + 2);
711 int16_t diff = seq - s->seq;
713 /* Packet older than the previously emitted one, drop */
714 av_log(s->st ? s->st->codec : NULL, AV_LOG_WARNING,
715 "RTP: dropping old packet received too late\n");
717 } else if (diff <= 1) {
719 rv = rtp_parse_packet_internal(s, pkt, buf, len);
722 /* Still missing some packet, enqueue this one. */
723 enqueue_packet(s, buf, len);
725 /* Return the first enqueued packet if the queue is full,
726 * even if we're missing something */
727 if (s->queue_len >= s->queue_size)
728 return rtp_parse_queued_packet(s, pkt);
735 * Parse an RTP or RTCP packet directly sent as a buffer.
736 * @param s RTP parse context.
737 * @param pkt returned packet
738 * @param bufptr pointer to the input buffer or NULL to read the next packets
739 * @param len buffer len
740 * @return 0 if a packet is returned, 1 if a packet is returned and more can follow
741 * (use buf as NULL to read the next). -1 if no packet (error or no more packet).
743 int ff_rtp_parse_packet(RTPDemuxContext *s, AVPacket *pkt,
744 uint8_t **bufptr, int len)
746 int rv = rtp_parse_one_packet(s, pkt, bufptr, len);
748 while (rv == AVERROR(EAGAIN) && has_next_packet(s))
749 rv = rtp_parse_queued_packet(s, pkt);
750 return rv ? rv : has_next_packet(s);
753 void ff_rtp_parse_close(RTPDemuxContext *s)
755 ff_rtp_reset_packet_queue(s);
756 if (!strcmp(ff_rtp_enc_name(s->payload_type), "MP2T")) {
757 ff_mpegts_parse_close(s->ts);
762 int ff_parse_fmtp(AVStream *stream, PayloadContext *data, const char *p,
763 int (*parse_fmtp)(AVStream *stream,
764 PayloadContext *data,
765 char *attr, char *value))
770 int value_size = strlen(p) + 1;
772 if (!(value = av_malloc(value_size))) {
773 av_log(stream, AV_LOG_ERROR, "Failed to allocate data for FMTP.");
774 return AVERROR(ENOMEM);
777 // remove protocol identifier
778 while (*p && *p == ' ') p++; // strip spaces
779 while (*p && *p != ' ') p++; // eat protocol identifier
780 while (*p && *p == ' ') p++; // strip trailing spaces
782 while (ff_rtsp_next_attr_and_value(&p,
784 value, value_size)) {
786 res = parse_fmtp(stream, data, attr, value);
787 if (res < 0 && res != AVERROR_PATCHWELCOME) {