[xiph-commits] r10830 - trunk/vorbis/doc
lu_zero at svn.xiph.org
lu_zero at svn.xiph.org
Sat Feb 18 14:58:50 PST 2006
Author: lu_zero
Date: 2006-02-18 14:58:47 -0800 (Sat, 18 Feb 2006)
New Revision: 10830
Modified:
trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-00.txt
trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-00.xml
Log:
Updates
Modified: trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-00.txt
===================================================================
--- trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-00.txt 2006-02-17 09:15:27 UTC (rev 10829)
+++ trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-00.txt 2006-02-18 22:58:47 UTC (rev 10830)
@@ -7,7 +7,7 @@
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 @@
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,17 +85,18 @@
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
@@ -108,10 +109,9 @@
-
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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 @@
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,11 +1222,18 @@
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
11.1. Normative References
@@ -1227,13 +1244,6 @@
[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 @@
[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 @@
-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 @@
-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 @@
-Barbato Expires August 24, 2006 [Page 25]
+Barbato Expires August 24, 2006 [Page 26]
Modified: trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-00.xml
===================================================================
--- trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-00.xml 2006-02-17 09:15:27 UTC (rev 10829)
+++ trunk/vorbis/doc/draft-ietf-avt-vorbis-rtp-00.xml 2006-02-18 22:58:47 UTC (rev 10830)
@@ -6,7 +6,7 @@
<rfc ipr="full3978" docName="RTP Payload Format for Vorbis Encoded Audio">
<front>
-<title>draft-kerr-avt-vorbis-rtp-05</title>
+<title>draft-kerr-avt-vorbis-rtp-06</title>
<author initials="L" surname="Barbato" fullname="Luca Barbato">
<organization>Xiph.Org</organization>
@@ -828,7 +828,7 @@
<vspace blankLines="1" />
<list style="hanging">
-<t hangText="configuration-uri:"> 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 <xref target="BZ2">bzip2</xref> or <xref target="rfc1952">gzip</xref> and an <xref target="FIPS180">sha1</xref> checksum MAY be provided in the form of "protocol://path/to/resource/! sha1hash"</t>
+<t hangText="configuration-uri:"> 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 <xref target="BZ2">bzip2</xref> or <xref target="rfc1952">gzip</xref> and an <xref target="FIPS180">sha1</xref> checksum MAY be provided in the form of "protocol://path/to/resource/aggregated.bz2!sha1hash"</t>
</list>
</t>
@@ -951,16 +951,19 @@
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>
+<section anchor="SDP Example" title="SDP Example">
+<t>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 <xref target="rfc3548">base16</xref> configuration string is omitted because of the lenght.</t>
-<vspace blankLines="1" />
<list style="empty">
-<t>c=IN IP4/6 </t>
+<t>c=IN IP4 192.0.0.1</t>
<t>m=audio RTP/AVP 98</t>
-<t>a=rtpmap:98 VORBIS/44100/2</t>
+<t>a=rtpmap:98 vorbis/44100/2</t>
<t>a=delivery:out_band/http</t>
-<t>a=fmtp:98 delivery-method:in_band,out_band/http; configuration=base16string1; configuration-uri=http://path/to/the/resource</t>
+<t>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;</t>
</list>
+</section>
+
<t>
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>
@@ -1031,7 +1034,7 @@
</t>
<t>
-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.
</t>
</section>
More information about the commits
mailing list