From 103c5819330f69da077a26304a4123047c030908 Mon Sep 17 00:00:00 2001 From: lu_zero Date: Sat, 18 Feb 2006 22:58:47 +0000 Subject: [PATCH] Updates svn path=/trunk/vorbis/; revision=10830 --- doc/draft-ietf-avt-vorbis-rtp-00.txt | 182 +++++++++++++++++++++++------------ doc/draft-ietf-avt-vorbis-rtp-00.xml | 17 ++-- 2 files changed, 129 insertions(+), 70 deletions(-) diff --git a/doc/draft-ietf-avt-vorbis-rtp-00.txt b/doc/draft-ietf-avt-vorbis-rtp-00.txt index c132ac7..108b1ee 100644 --- a/doc/draft-ietf-avt-vorbis-rtp-00.txt +++ b/doc/draft-ietf-avt-vorbis-rtp-00.txt @@ -7,7 +7,7 @@ Internet-Draft Xiph.Org Expires: August 24, 2006 February 20, 2006 - draft-kerr-avt-vorbis-rtp-05 + draft-kerr-avt-vorbis-rtp-06 RTP Payload Format for Vorbis Encoded Audio Status of this Memo @@ -55,7 +55,7 @@ Abstract Barbato Expires August 24, 2006 [Page 1] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 Editors Note @@ -85,18 +85,18 @@ Table of Contents 5.2. Packet Loss . . . . . . . . . . . . . . . . . . . . . . . 17 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 18 6.1. Mapping MIME Parameters into SDP . . . . . . . . . . . . . 19 - 6.2. Usage with the SDP Offer/Answer Model . . . . . . . . . . 20 + 6.1.1. SDP Example . . . . . . . . . . . . . . . . . . . . . 20 + 6.2. Usage with the SDP Offer/Answer Model . . . . . . . . . . 21 7. Congestion Control . . . . . . . . . . . . . . . . . . . . . . 21 8. Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . 21 8.1. Stream Radio . . . . . . . . . . . . . . . . . . . . . . . 21 9. Security Considerations . . . . . . . . . . . . . . . . . . . 22 10. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 22 - 11. References . . . . . . . . . . . . . . . . . . . . . . . . . . 22 - 11.1. Normative References . . . . . . . . . . . . . . . . . . . 22 + 11. References . . . . . . . . . . . . . . . . . . . . . . . . . . 23 + 11.1. Normative References . . . . . . . . . . . . . . . . . . . 23 11.2. Informative References . . . . . . . . . . . . . . . . . . 23 - Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 24 - Intellectual Property and Copyright Statements . . . . . . . . . . 25 - + Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 25 + Intellectual Property and Copyright Statements . . . . . . . . . . 26 @@ -111,7 +111,7 @@ Table of Contents Barbato Expires August 24, 2006 [Page 2] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 1. Introduction @@ -167,7 +167,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 3] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 0 1 2 3 @@ -223,7 +223,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 4] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 Sequence number: 16 bits @@ -279,7 +279,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 5] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 This field sets the payload type for the Vorbis data in this RTP @@ -335,7 +335,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 6] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 after the RTP packet header. Subsequence packets, if any, MUST @@ -391,7 +391,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 7] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 prefixed by the two octet length field. The Packet Type and Fragment @@ -447,7 +447,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 8] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 detects a change in the Ident value and does not have this @@ -503,7 +503,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 9] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 0 1 2 3 @@ -559,7 +559,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 10] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 configuration data is via a retrieval method that can be performed @@ -615,7 +615,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 11] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 MIME media type name: audio @@ -671,7 +671,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 12] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 Restriction on usage: @@ -727,7 +727,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 13] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 0 1 2 3 @@ -783,7 +783,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 14] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 packets MUST be the same as the first packet sent, with the sequence @@ -839,7 +839,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 15] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 Packet 2: @@ -895,7 +895,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 16] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 Packet 3: @@ -951,7 +951,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 17] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 Loss of any of the Configuration fragment will result in the loss of @@ -984,7 +984,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 number, or aggregated in a single stream, aggregates MAY be compressed using bzip2 [13] or gzip [11] and an sha1 [12] checksum MAY be provided in the form of - "protocol://path/to/resource/! sha1hash" + "protocol://path/to/resource/aggregated.bz2!sha1hash" Encoding considerations: @@ -1007,7 +1007,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 18] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 Published specification: @@ -1063,7 +1063,7 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Barbato Expires August 24, 2006 [Page 19] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 o The MIME type ("audio") goes in SDP "m=" as the media name. @@ -1095,15 +1095,33 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 specified in the rtpmap attribute MUST match the Vorbis sample rate value. An example is found below. - c=IN IP4/6 +6.1.1. SDP Example + + The following example shows a basic SDP single stream. The first + configuration packet is inlined in the sdp, other configurations + could be fetched at any time from the first provided uri using or all + the known configuration could be downloaded using the second uri. + The inline base16 [9] configuration string is omitted because of the + lenght. + c=IN IP4 192.0.0.1 m=audio RTP/AVP 98 - a=rtpmap:98 VORBIS/44100/2 + a=rtpmap:98 vorbis/44100/2 a=delivery:out_band/http - a=fmtp:98 delivery-method:in_band,out_band/http; - configuration=base16string1; - configuration-uri=http://path/to/the/resource + a=fmtp:98 delivery-method=in_band; configuration=base16string1; + delivery-method=out_band/rtsp; + configuration-uri=rtsp://path/to/the/resource; delivery- + method=out_band/http; configuration-uri=http://another/path/to/ + resource/aggregate.bz2!sha1hash; Note that the payload format (encoding) names are commonly shown in + + + +Barbato Expires August 24, 2006 [Page 20] + +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 + + upper case. MIME subtypes are commonly shown in lower case. These names are case-insensitive in both places. Similarly, parameter names are case-insensitive both in MIME types and in the default @@ -1114,14 +1132,6 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 6.2. Usage with the SDP Offer/Answer Model The offer, as described in An Offer/Answer Model Session Description - - - -Barbato Expires August 24, 2006 [Page 20] - -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 - - Protocol [8], may contain a large number of delivery methods per single fmtp attribute, the answerer MUST remove every delivery-method and configuration-uri not supported. All the parameters MUST not be @@ -1160,6 +1170,14 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 listening to the content in a short time. On join the client will receive the current Configuration necessary + + + +Barbato Expires August 24, 2006 [Page 21] + +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 + + to decode the current stream inlined in the SDP so that the decoding will start immediately after. @@ -1170,14 +1188,6 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 The client could choose to fetch the Configuration from the alternate source as soon it discovers a Configuration packet got lost inline or - - - -Barbato Expires August 24, 2006 [Page 21] - -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 - - use selective retransmission [17], if the server supports that feature. @@ -1212,9 +1222,16 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 Hennequin, Ralph Giles, Tor-Einar Jarnbjo, Colin Law, John Lazzaro, Jack Moffitt, Christopher Montgomery, Colin Perkins, Barry Short, Mike Smith, Phil Kerr, Michael Sparks, Magnus Westerlund, David - Barrett, Silvia Pfeiffer, Politecnico di Torino (LS)^3/IMG Group in - particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini, - Juan Carlos De Martin. + Barrett, Silvia Pfeiffer, Stefan Ehmann. Politecnico di Torino + (LS)^3/IMG Group in particular Federico Ridolfo, Francesco Varano, + Giampaolo Mancini, Juan Carlos De Martin. + + + + +Barbato Expires August 24, 2006 [Page 22] + +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 11. References @@ -1227,13 +1244,6 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 [2] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", RFC 2119. - - -Barbato Expires August 24, 2006 [Page 22] - -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 - - [3] Schulzrinne, H., Casner, S., Frederick, R., and V. Jacobson, "RTP: A Transport Protocol for real-time applications", RFC 3550. @@ -1273,6 +1283,13 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 [14] "libvorbis: Available from the Xiph website, http://www.xiph.org". + + +Barbato Expires August 24, 2006 [Page 23] + +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 + + [15] "Ogg Vorbis I specification: Codec setup and packet decode. Available from the Xiph website, http://www.xiph.org". @@ -1285,9 +1302,48 @@ Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 -Barbato Expires August 24, 2006 [Page 23] + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +Barbato Expires August 24, 2006 [Page 24] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 Author's Address @@ -1341,9 +1397,9 @@ Author's Address -Barbato Expires August 24, 2006 [Page 24] +Barbato Expires August 24, 2006 [Page 25] -Internet-Draft draft-kerr-avt-vorbis-rtp-05 February 2006 +Internet-Draft draft-kerr-avt-vorbis-rtp-06 February 2006 Intellectual Property Statement @@ -1397,6 +1453,6 @@ Acknowledgment -Barbato Expires August 24, 2006 [Page 25] +Barbato Expires August 24, 2006 [Page 26] diff --git a/doc/draft-ietf-avt-vorbis-rtp-00.xml b/doc/draft-ietf-avt-vorbis-rtp-00.xml index 1d1b879..eced754 100644 --- a/doc/draft-ietf-avt-vorbis-rtp-00.xml +++ b/doc/draft-ietf-avt-vorbis-rtp-00.xml @@ -6,7 +6,7 @@ -draft-kerr-avt-vorbis-rtp-05 +draft-kerr-avt-vorbis-rtp-06 Xiph.Org @@ -828,7 +828,7 @@ Where "specific_name" is the name of the out of band delivery method. - the URI of the configuration headers in case of out of band transmission. In the form of "protocol://path/to/resource/". Depending on the specific method the single ident packet could be retrived by their number, or aggregated in a single stream, aggregates MAY be compressed using bzip2 or gzip and an sha1 checksum MAY be provided in the form of "protocol://path/to/resource/! sha1hash" + the URI of the configuration headers in case of out of band transmission. In the form of "protocol://path/to/resource/". Depending on the specific method the single ident packet could be retrived by their number, or aggregated in a single stream, aggregates MAY be compressed using bzip2 or gzip and an sha1 checksum MAY be provided in the form of "protocol://path/to/resource/aggregated.bz2!sha1hash" @@ -951,15 +951,18 @@ The URI specified in the configuration-uri attribute MUST point to a location wh The port value is specified by the server application bound to the address specified in the c attribute. The bitrate value and channels specified in the rtpmap attribute MUST match the Vorbis sample rate value. An example is found below. +
+The following example shows a basic SDP single stream. The first configuration packet is inlined in the sdp, other configurations could be fetched at any time from the first provided uri using or all the known configuration could be downloaded using the second uri. The inline base16 configuration string is omitted because of the lenght. - -c=IN IP4/6 +c=IN IP4 192.0.0.1 m=audio RTP/AVP 98 -a=rtpmap:98 VORBIS/44100/2 +a=rtpmap:98 vorbis/44100/2 a=delivery:out_band/http -a=fmtp:98 delivery-method:in_band,out_band/http; configuration=base16string1; configuration-uri=http://path/to/the/resource +a=fmtp:98 delivery-method=in_band; configuration=base16string1; delivery-method=out_band/rtsp; configuration-uri=rtsp://path/to/the/resource; delivery-method=out_band/http; configuration-uri=http://another/path/to/resource/aggregate.bz2!sha1hash; +
+ Note that the payload format (encoding) names are commonly shown in upper case. MIME subtypes are commonly shown in lower case. These names are case-insensitive in both places. Similarly, parameter names are case-insensitive both in MIME types and in the default mapping to the SDP a=fmtp attribute. The exception regarding case sensitivity is the configuration-uri URI which MUST be regarded as being case sensitive. @@ -1031,7 +1034,7 @@ This document is a continuation of draft-moffitt-vorbis-rtp-00.txt and draft-ker -Thanks to the AVT, Ogg Vorbis Communities / Xiph.org including Steve Casner, Aaron Colwell, Ross Finlayson, Fluendo, Ramon Garcia, Pascal Hennequin, Ralph Giles, Tor-Einar Jarnbjo, Colin Law, John Lazzaro, Jack Moffitt, Christopher Montgomery, Colin Perkins, Barry Short, Mike Smith, Phil Kerr, Michael Sparks, Magnus Westerlund, David Barrett, Silvia Pfeiffer, Politecnico di Torino (LS)³/IMG Group in particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini, Juan Carlos De Martin. +Thanks to the AVT, Ogg Vorbis Communities / Xiph.org including Steve Casner, Aaron Colwell, Ross Finlayson, Fluendo, Ramon Garcia, Pascal Hennequin, Ralph Giles, Tor-Einar Jarnbjo, Colin Law, John Lazzaro, Jack Moffitt, Christopher Montgomery, Colin Perkins, Barry Short, Mike Smith, Phil Kerr, Michael Sparks, Magnus Westerlund, David Barrett, Silvia Pfeiffer, Stefan Ehmann. Politecnico di Torino (LS)³/IMG Group in particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini, Juan Carlos De Martin. -- 2.7.4