[xiph-commits] r10223 - trunk/vorbis/doc
lu_zero at svn.xiph.org
lu_zero at svn.xiph.org
Fri Oct 21 06:52:50 PDT 2005
Author: lu_zero
Date: 2005-10-21 06:52:46 -0700 (Fri, 21 Oct 2005)
New Revision: 10223
Modified:
trunk/vorbis/doc/draft-kerr-avt-vorbis-rtp-05.txt
trunk/vorbis/doc/draft-kerr-avt-vorbis-rtp-05.xml
Log:
Minor changes
Modified: trunk/vorbis/doc/draft-kerr-avt-vorbis-rtp-05.txt
===================================================================
--- trunk/vorbis/doc/draft-kerr-avt-vorbis-rtp-05.txt 2005-10-21 11:04:12 UTC (rev 10222)
+++ trunk/vorbis/doc/draft-kerr-avt-vorbis-rtp-05.txt 2005-10-21 13:52:46 UTC (rev 10223)
@@ -78,12 +78,12 @@
3. Configuration Headers . . . . . . . . . . . . . . . . . . . . 8
3.1. In-band Header Transmission . . . . . . . . . . . . . . . 9
3.1.1. Packed Configuration . . . . . . . . . . . . . . . . . 9
- 3.2. Packed Headers Delivery . . . . . . . . . . . . . . . . . 10
- 3.2.1. Packed Headers IANA Considerations . . . . . . . . . . 11
+ 3.2. Out of Band Transmission . . . . . . . . . . . . . . . . . 10
+ 3.2.1. Packed Headers . . . . . . . . . . . . . . . . . . . . 10
3.3. Loss of Configuration Headers . . . . . . . . . . . . . . 12
4. Comment Headers . . . . . . . . . . . . . . . . . . . . . . . 12
5. Frame Packetizing . . . . . . . . . . . . . . . . . . . . . . 13
- 5.1. Example Fragmented Vorbis Packet . . . . . . . . . . . . . 13
+ 5.1. Example Fragmented Vorbis Packet . . . . . . . . . . . . . 14
5.2. Packet Loss . . . . . . . . . . . . . . . . . . . . . . . 16
6. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 17
6.1. Mapping MIME Parameters into SDP . . . . . . . . . . . . . 18
@@ -95,8 +95,8 @@
11. References . . . . . . . . . . . . . . . . . . . . . . . . . . 21
11.1. Normative References . . . . . . . . . . . . . . . . . . . 21
11.2. Informative References . . . . . . . . . . . . . . . . . . 21
- Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 23
- Intellectual Property and Copyright Statements . . . . . . . . . . 24
+ Author's Address . . . . . . . . . . . . . . . . . . . . . . . . . 22
+ Intellectual Property and Copyright Statements . . . . . . . . . . 23
@@ -414,8 +414,8 @@
requirement poses problems in RTP, which is often used over
unreliable transports.
- Since this information must be transmitted reliably, and as the RTP
- stream may change certain configuration data mid-session there are
+ Since this information must be transmitted reliably and, as the RTP
+ stream may change certain configuration data mid-session, there are
different methods for delivering this configuration data to a client,
both in-band and out-of-band which is detailed below. SDP delivery
is used to setup an initial state for the client application. The
@@ -481,7 +481,7 @@
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Ident | 0 | 1 | 1|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- | Setup length | Identification ..
+ | length | Identification ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Identification ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
@@ -511,8 +511,16 @@
set to 0 since the packet bears the full Packed configuration, the
number of packet is set to 1.
-3.2. Packed Headers Delivery
+3.2. Out of Band Transmission
+ This section, as stated before, won't cover all the possible out-of-
+ band delivery methods since they rely to different protocols and be
+ linked to a specific application. The following packet definition
+ SHOULD be used in out-of-band delivery and MUST be used when
+ Configuration is inlined in the SDP.
+
+3.2.1. Packed Headers
+
As mentioned above the RECOMMENDED delivery vector for Vorbis
configuration data is via a retrieval method that can be performed
using a reliable transport protocol. As the RTP headers are not
@@ -535,15 +543,31 @@
Figure 7: Packed Headers Overview
Since the Configuration Ident and the Identification Header are fixed
- length there is only a 2 byte Setup Length tag to define the length
- of the Setup header.
+ length there is only a 2 byte length tag to define the length of the
+ packed headers.
+
+
+
+
+
+
+
+
+
+
+
+Barbato Expires April 18, 2006 [Page 10]
+
+Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
+
+
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Ident | ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- .. Length | Identification Header ..
+ .. length | Identification Header ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Identification Header |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
@@ -554,19 +578,11 @@
Figure 8: Packed Headers Detail
+ The key difference between the in-band format and this one, is there
+ is no need for the payload header octet.
+3.2.1.1. Packed Headers IANA Considerations
-
-Barbato Expires April 18, 2006 [Page 10]
-
-Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
-
-
- The key difference between the in-band format is there is no need for
- the payload header octet.
-
-3.2.1. Packed Headers IANA Considerations
-
The following IANA considerations MUST only be applied to the packed
headers.
@@ -595,6 +611,13 @@
Published specification:
+
+
+Barbato Expires April 18, 2006 [Page 11]
+
+Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
+
+
See RFC XXXX for details.
Applications which use this media type:
@@ -611,13 +634,6 @@
Author/Change controller:
-
-
-Barbato Expires April 18, 2006 [Page 11]
-
-Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
-
-
Author: Luca Barbato
Change controller: IETF AVT Working Group
@@ -642,6 +658,22 @@
completely. 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-kerr-avt-vorbis-rtp-05 October 2005
+
+
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
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
@@ -666,14 +698,6 @@
Figure 9: Comment Packet
-
-
-
-Barbato Expires April 18, 2006 [Page 12]
-
-Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
-
-
The 2 bytes length field is necessary since this packet could be
fragmented.
@@ -697,39 +721,23 @@
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.
+ number incremented as normal for the subsequent RTP packets. The
-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.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
Barbato Expires April 18, 2006 [Page 13]
Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
+ length field shows the fragment length.
+
+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
@@ -773,14 +781,6 @@
-
-
-
-
-
-
-
-
Barbato Expires April 18, 2006 [Page 14]
Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
@@ -915,7 +915,7 @@
values are:inline, in_band, out_band
configuration: the base16 [9] (hexadecimal) representation of the
- Packed Headers (Section 3.2).
+ Packed Headers (Section 3.2.1).
Optional Parameters:
@@ -1001,15 +1001,18 @@
specified in the rtpmap attribute MUST match the Vorbis sample rate
value. An example is found below.
+ The answer to any offer, [8], MUST NOT change the URI specified in
-
Barbato Expires April 18, 2006 [Page 18]
Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
+ the configuration-uri attribute. The Configuration inlined in the
+ configuration parameter COULD change.
+
c=IN IP4/6
m=audio RTP/AVP 98
a=rtpmap:98 VORBIS/44100/2
@@ -1026,11 +1029,7 @@
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
- the configuration-uri attribute. The Configuration inlined in the
- configuration parameter COULD change.
-
7. Congestion Control
Vorbis clients SHOULD send regular receiver reports detailing
@@ -1058,6 +1057,7 @@
The content itself could be a mix of live stream as the dj's speech
and stored streams as the music she plays.
+ In this situation we don't know in advance how many codebooks we will
@@ -1066,7 +1066,6 @@
Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
- In this situation we don't know in advance how many codebooks we will
use and. The clients can join anytime and users expect to start
listening to the content in a short time
@@ -1114,6 +1113,7 @@
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.
@@ -1122,9 +1122,6 @@
Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
- Juan Carlos De Martin.
-
-
11. References
11.1. Normative References
@@ -1170,66 +1167,13 @@
Available from the Xiph website, http://www.xiph.org".
[13] "Ogg Vorbis I specification: Comment field and header
-
-
-
-Barbato Expires April 18, 2006 [Page 21]
-
-Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
-
-
specification. Available from the Xiph website,
http://www.xiph.org".
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Barbato Expires April 18, 2006 [Page 22]
+Barbato Expires April 18, 2006 [Page 21]
Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
@@ -1285,7 +1229,7 @@
-Barbato Expires April 18, 2006 [Page 23]
+Barbato Expires April 18, 2006 [Page 22]
Internet-Draft draft-kerr-avt-vorbis-rtp-05 October 2005
@@ -1341,6 +1285,6 @@
-Barbato Expires April 18, 2006 [Page 24]
+Barbato Expires April 18, 2006 [Page 23]
Modified: trunk/vorbis/doc/draft-kerr-avt-vorbis-rtp-05.xml
===================================================================
--- trunk/vorbis/doc/draft-kerr-avt-vorbis-rtp-05.xml 2005-10-21 11:04:12 UTC (rev 10222)
+++ trunk/vorbis/doc/draft-kerr-avt-vorbis-rtp-05.xml 2005-10-21 13:52:46 UTC (rev 10223)
@@ -351,8 +351,8 @@
</t>
<t>
-Since this information must be transmitted reliably, and as the RTP
-stream may change certain configuration data mid-session there are
+Since this information must be transmitted reliably and, as the RTP
+stream may change certain configuration data mid-session, there are
different methods for delivering this configuration data to a
client, both in-band and out-of-band which is detailed below. SDP
delivery is used to setup an initial state for the client application.
@@ -397,7 +397,7 @@
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Ident | 0 | 1 | 1|
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- | Setup length | Identification ..
+ | length | Identification ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Identification ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
@@ -416,12 +416,17 @@
<t>The Ident field is set with the value that will be used by the Raw Payload Packets to address this Configuration. The Fragment type is set to 0 since the packet bears the full Packed configuration, the number of packet is set to 1.</t>
</section>
+</section>
+<section anchor="Out of Band Transmission" title="Out of Band Transmission">
-</section>
-<section anchor="Packed Headers Delivery" title="Packed Headers Delivery">
+<t>
+This section, as stated before, won't cover all the possible out-of-band delivery methods since they rely to different protocols and be linked to a specific application. The following packet definition SHOULD be used in out-of-band delivery and MUST be used when Configuration is inlined in the SDP.
+</t>
+<section anchor="Packed Headers" title="Packed Headers">
+
<t>
As mentioned above the RECOMMENDED delivery vector for Vorbis configuration data is via a retrieval method that can be performed using a reliable transport protocol. As the RTP headers are not required for this method of delivery the structure of the configuration data is slightly different. The packed header starts with a 32 bit count field which details the number of packed headers that are contained in the bundle. Next is the Packed header payload for each chained Vorbis stream.
</t>
@@ -441,7 +446,7 @@
</figure>
<t>
-Since the Configuration Ident and the Identification Header are fixed length there is only a 2 byte Setup Length tag to define the length of the Setup header.
+Since the Configuration Ident and the Identification Header are fixed length there is only a 2 byte length tag to define the length of the packed headers.
</t>
<figure anchor="Packed Headers Detail Figure" title="Packed Headers Detail">
@@ -451,7 +456,7 @@
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| Ident | ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
- .. Length | Identification Header ..
+ .. length | Identification Header ..
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
.. Identification Header |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
@@ -462,7 +467,7 @@
]]></artwork>
</figure>
<t>
-The key difference between the in-band format is there is no need for the payload header octet.
+The key difference between the in-band format and this one, is there is no need for the payload header octet.
</t>
<section anchor="Packed Headers IANA Considerations" title="Packed Headers IANA Considerations">
@@ -531,15 +536,8 @@
</section>
</section>
+</section>
-<!--<section anchor="Out-of-band Header Transmission" title="Out-of-band Header Transmission">
-
-<t>
-
-</t>
-
-</section>-->
-
<section anchor="Loss of Configuration Headers" title="Loss of Configuration Headers">
<t>
@@ -608,7 +606,7 @@
</t>
<t>
-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.
+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. The length field shows the fragment length.
</t>
<section anchor="Example Fragmented Vorbis Packet" title="Example Fragmented Vorbis Packet">
@@ -740,7 +738,7 @@
<t>
delivery-method: indicates the delivery methods in use, the possible values are:inline, in_band, out_band
</t><t>
-configuration: the <xref target="rfc3548">base16</xref> (hexadecimal) representation of the <xref target="Packed Headers Delivery">Packed Headers</xref>.
+configuration: the <xref target="rfc3548">base16</xref> (hexadecimal) representation of the <xref target="Packed Headers">Packed Headers</xref>.
</t>
<t>
@@ -829,6 +827,10 @@
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.
</t>
+<t>
+The answer to any offer, <xref target="rfc3264"></xref>, MUST NOT change the URI specified in the configuration-uri attribute. The Configuration inlined in the configuration parameter COULD change.
+</t>
+
<vspace blankLines="1" />
<list style="empty">
<t>c=IN IP4/6 </t>
@@ -842,10 +844,6 @@
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.
</t>
-<t>
-The answer to any offer, <xref target="rfc3264"></xref>, MUST NOT change the URI specified in the configuration-uri attribute. The Configuration inlined in the configuration parameter COULD change.
-</t>
-
</section>
</section>
More information about the commits
mailing list