[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