From 337bf57df13e40615b6c08616be807bffc98f9a2 Mon Sep 17 00:00:00 2001 From: lu_zero Date: Tue, 18 Oct 2005 23:15:34 +0000 Subject: [PATCH] Caching paragraph removed (doesn't apply anymore) Minor retouches svn path=/trunk/vorbis/; revision=10193 --- doc/draft-ietf-avt-vorbis-rtp-01.txt | 132 ++++++++++++++++++----------------- doc/draft-ietf-avt-vorbis-rtp-01.xml | 30 +++----- 2 files changed, 76 insertions(+), 86 deletions(-) diff --git a/doc/draft-ietf-avt-vorbis-rtp-01.txt b/doc/draft-ietf-avt-vorbis-rtp-01.txt index 122b405..54f19a6 100644 --- a/doc/draft-ietf-avt-vorbis-rtp-01.txt +++ b/doc/draft-ietf-avt-vorbis-rtp-01.txt @@ -1,6 +1,7 @@ + AVT Working Group L. Barbato Internet-Draft Xiph.Org Expires: April 18, 2006 October 15, 2005 @@ -79,11 +80,10 @@ Table of Contents 3.1.1. Packed Configuration . . . . . . . . . . . . . . . . . 9 3.2. Packed Headers Delivery . . . . . . . . . . . . . . . . . 10 3.2.1. Packed Headers IANA Considerations . . . . . . . . . . 11 - 3.3. Configuration Caching . . . . . . . . . . . . . . . . . . 12 - 3.4. Loss of Configuration Headers . . . . . . . . . . . . . . 12 + 3.3. Loss of Configuration Headers . . . . . . . . . . . . . . 12 4. Comment Headers . . . . . . . . . . . . . . . . . . . . . . . 12 5. Frame Packetizing . . . . . . . . . . . . . . . . . . . . . . 13 - 5.1. Example Fragmented Vorbis Packet . . . . . . . . . . . . . 14 + 5.1. Example Fragmented Vorbis Packet . . . . . . . . . . . . . 13 5.2. Packet Loss . . . . . . . . . . . . . . . . . . . . . . . 16 6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 17 6.1. Mapping MIME Parameters into SDP . . . . . . . . . . . . . 18 @@ -108,6 +108,7 @@ Table of Contents + Barbato Expires April 18, 2006 [Page 2] Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 @@ -619,15 +620,7 @@ Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 Change controller: IETF AVT Working Group -3.3. Configuration Caching - - Configuration caching allows clients that have previously connected - to a stream to re-use the associated configuration data. When a - client receives a Packed Configuration packet it may store it locally - and can compare the Ident key with that of the new stream and begin - decoding before it has received any of the headers. - -3.4. Loss of Configuration Headers +3.3. Loss of Configuration Headers Unlike the loss of raw Vorbis payload data, loss of a configuration header can lead to a situation where it will not be possible to @@ -644,34 +637,8 @@ Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 contain the comment metadata, such as artist name, track title and so on. These metadata messages are not intended to be fully descriptive but to offer basic track/song information. This packet SHOULD NOT be - sent and clients MAY ignore it completely. During a session the - Details on the format of the comments can be found in the Vorbis - documentation [12]. - - - - - - - - - - - - - - - - - - - - - -Barbato Expires April 18, 2006 [Page 12] - -Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 - + sent and clients MAY ignore it completely. The details on the format + of the comments can be found in the Vorbis documentation [12]. 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 @@ -701,6 +668,12 @@ Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 fragmented. + +Barbato Expires April 18, 2006 [Page 12] + +Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 + + 5. Frame Packetizing Each RTP packet contains either one Vorbis packet fragment, or an @@ -711,16 +684,44 @@ Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 in the RTP packet with as many Vorbis packets as will fit, up to a maximum of 15. Path MTU is detailed in [6] and [7]. - If a Vorbis packet is larger than 65535 octets it MUST be fragmented. - A fragmented packet has a zero in the last four bits of the payload - header. The first fragment will set the Fragment type to 1. Each - fragment after the first will set the Fragment type to 2 in the - payload header. The RTP packet containing the last fragment of the - Vorbis packet will have the Fragment type set to 3. To maintain the - correct sequence for fragmented packet reception the timestamp field - of fragmented packets MUST be the same as the first packet sent, with - the sequence number incremented as normal for the subsequent RTP - packets. + If a Vorbis packet, not only data but also Configuration and Comment, + is larger than 65535 octets it MUST be fragmented. A fragmented + packet has a zero in the last four bits of the payload header. The + first fragment will set the Fragment type to 1. Each fragment after + the first will set the Fragment type to 2 in the payload header. The + RTP packet containing the last fragment of the Vorbis packet will + have the Fragment type set to 3. To maintain the correct sequence + for fragmented packet reception the timestamp field of fragmented + packets MUST be the same as the first packet sent, with the sequence + number incremented as normal for the subsequent RTP packets. + +5.1. Example Fragmented Vorbis Packet + + Here is an example fragmented Vorbis packet split over three RTP + packets. Each packet contains the standard RTP headers as well as + the 4 octet Vorbis headers. + + + + + + + + + + + + + + + + + + + + + + @@ -729,12 +730,6 @@ Barbato Expires April 18, 2006 [Page 13] Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 -5.1. Example Fragmented Vorbis Packet - - Here is an example fragmented Vorbis packet split over three RTP - packets. Each packet contains the standard RTP headers as well as - the 4 octet Vorbis headers. - Packet 1: 0 1 2 3 @@ -750,7 +745,7 @@ Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 | ... | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ - | Ident | 1 | 0 | 0| + | Ident | 1 | 0 | 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | length | vorbis data .. +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ @@ -780,6 +775,12 @@ Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 + + + + + + Barbato Expires April 18, 2006 [Page 14] Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 @@ -917,8 +918,9 @@ Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 Optional Parameters: configuration-uri: the URI of the configuration headers in case of - out of band transmission. In the form of - proto://path/to/resource/Ident + out of band transmission. In the form of proto://path/to/resource/ + Depending on the specific method the single ident packet could be + retrived by their number, or aggregated in a single stream. Encoding considerations: @@ -947,7 +949,6 @@ Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 - Barbato Expires April 18, 2006 [Page 17] Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 @@ -1012,14 +1013,14 @@ Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 a=delivery:out_band/http a=fmtp:98 delivery-method:inline,out_band/http; configuration=base16string1; - configuration-uri=http://path/to/the/resource/159 + configuration-uri=http://path/to/the/resource 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 header URL which MUST be regarded as + sensitivity is the configuration-uri URI which MUST be regarded as being case sensitive. The answer to any offer, [8], MUST NOT change the URI specified in @@ -1070,9 +1071,9 @@ Internet-Draft draft-ietf-avt-vorbis-rtp-01 October 2005 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, Politecnico di Torino (LS)^3/IMG Group in particular - Federico Ridolfo, Francesco Varano, Giampaolo Mancini, Juan Carlos De - Martin. + Barrett, Silvia Pfeiffer, Politecnico di Torino (LS)^3/IMG Group in + particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini, + Juan Carlos De Martin. 10. References @@ -1286,3 +1287,4 @@ Acknowledgment Barbato Expires April 18, 2006 [Page 23] + diff --git a/doc/draft-ietf-avt-vorbis-rtp-01.xml b/doc/draft-ietf-avt-vorbis-rtp-01.xml index 07e8a66..ee781d7 100644 --- a/doc/draft-ietf-avt-vorbis-rtp-01.xml +++ b/doc/draft-ietf-avt-vorbis-rtp-01.xml @@ -242,8 +242,7 @@ Raw Vorbis packets are unbounded in length currently, although at some future po -Each Vorbis payload packet starts with a two octet length header, which is used to represent the size of the following -data payload, followed by the raw Vorbis data. +Each Vorbis payload packet starts with a two octet length header, which is used to represent the size of the following data payload, followed by the raw Vorbis data. @@ -508,13 +507,6 @@ Intended usage: COMMON -
- - -Configuration caching allows clients that have previously connected to a stream to re-use the associated configuration data. When a client receives a Packed Configuration packet it may store it locally and can compare the Ident key with that of the new stream and begin decoding before it has received any of the headers. - - -
@@ -542,7 +534,7 @@ The mapping between the stream and the the configuration is explicit.
-With the payload type flag set to 2, this indicates that the packet contain the comment metadata, such as artist name, track title and so on. These metadata messages are not intended to be fully descriptive but to offer basic track/song information. This packet SHOULD NOT be sent and clients MAY ignore it completely. During a session the Details on the format of the comments can be found in the Vorbis documentation. +With the payload type flag set to 2, this indicates that the packet contain the comment metadata, such as artist name, track title and so on. These metadata messages are not intended to be fully descriptive but to offer basic track/song information. This packet SHOULD NOT be sent and clients MAY ignore it completely. The details on the format of the comments can be found in the Vorbis documentation.
-If a Vorbis packet is larger than 65535 octets it MUST be fragmented. A fragmented packet has a zero in the last four bits of the payload header. The first fragment will set the Fragment type to 1. Each fragment after the first will set the Fragment type to 2 in the payload header. The RTP packet containing the last fragment of the Vorbis packet will have the Fragment type set to 3. To maintain the correct sequence for fragmented packet reception the timestamp field of fragmented packets MUST be the same as the first packet sent, with the sequence number incremented as normal for the subsequent RTP packets. +If a Vorbis packet, not only data but also Configuration and Comment, is larger than 65535 octets it MUST be fragmented. A fragmented packet has a zero in the last four bits of the payload header. The first fragment will set the Fragment type to 1. Each fragment after the first will set the Fragment type to 2 in the payload header. The RTP packet containing the last fragment of the Vorbis packet will have the Fragment type set to 3. To maintain the correct sequence for fragmented packet reception the timestamp field of fragmented packets MUST be the same as the first packet sent, with the sequence number incremented as normal for the subsequent RTP packets.
-Here is an example fragmented Vorbis packet split over three RTP packets. Each packet contains the standard RTP headers as -well as the 4 octet Vorbis headers. +Here is an example fragmented Vorbis packet split over three RTP packets. Each packet contains the standard RTP headers as well as the 4 octet Vorbis headers.
@@ -611,7 +602,7 @@ well as the 4 octet Vorbis headers. | ... | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ - | Ident | 1 | 0 | 0| + | Ident | 1 | 0 | 0| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | length | vorbis data .. +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ @@ -722,7 +713,7 @@ configuration: the base16 (hexadecimal) representa Optional Parameters: -configuration-uri: the URI of the configuration headers in case of out of band transmission. In the form of proto://path/to/resource/Ident +configuration-uri: the URI of the configuration headers in case of out of band transmission. In the form of proto://path/to/resource/ Depending on the specific method the single ident packet could be retrived by their number, or aggregated in a single stream. @@ -812,14 +803,11 @@ The port value is specified by the server application bound to the address speci m=audio RTP/AVP 98 a=rtpmap:98 VORBIS/44100/2 a=delivery:out_band/http -a=fmtp:98 delivery-method:inline,out_band/http; configuration=base16string1; configuration-uri=http://path/to/the/resource/159 +a=fmtp:98 delivery-method:inline,out_band/http; configuration=base16string1; configuration-uri=http://path/to/the/resource -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 header URL -which MUST be regarded as being case sensitive. +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. @@ -862,7 +850,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, 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, Politecnico di Torino (LS)³/IMG Group in particular Federico Ridolfo, Francesco Varano, Giampaolo Mancini, Juan Carlos De Martin.
-- 2.7.4