eden-emu/opus
19
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Removed a few dozen warnings from the RTP XML draft.

Browse source
This commit is contained in:
Jean-Marc Valin 2009-02-27 09:23:28 -05:00
parent dd91338b0a
commit aa4c217f2a
1 changed files with 56 additions and 39 deletions
Download patch file Download diff file Expand all files Collapse all files

95
doc/ietf/draft-valin-celt-rtp-profile.xml
View file

@ -2,7 +2,7 @@
<!DOCTYPE rfc SYSTEM 'rfc2629.dtd'> <!DOCTYPE rfc SYSTEM 'rfc2629.dtd'>
<?rfc toc="yes" ?> <?rfc toc="yes" ?>
<rfc ipr="full3667" docName="RTP Payload Format for the CELT Codec"> <rfc ipr="full3978" docName="RTP Payload Format for the CELT Codec">
<front> <front>
<title>draft-valin-celt-rtp-profile-01</title> <title>draft-valin-celt-rtp-profile-01</title>
@ -12,7 +12,6 @@
<author initials="J-M" surname="Valin" fullname="Jean-Marc Valin"> <author initials="J-M" surname="Valin" fullname="Jean-Marc Valin">
<organization>Octasic Semiconductor</organization> <organization>Octasic Semiconductor</organization>
<address> <address>
<email>jean-marc.valin@octasic.com</email>
<postal> <postal>
<street>4101, Molson Street, suite 300</street> <street>4101, Molson Street, suite 300</street>
<city>Montreal</city> <city>Montreal</city>
@ -20,11 +19,23 @@
<code>H1Y 3L1</code> <code>H1Y 3L1</code>
<country>Canada</country> <country>Canada</country>
</postal> </postal>
<email>jean-marc.valin@octasic.com</email>
</address> </address>
</author> </author>
<author initials="et" surname="al." fullname="et al.">
<organization></organization> <author initials="G" surname="Maxwell" fullname="Gregory">
<organization>Juniper Networks</organization>
<address>
<postal>
<street></street>
<city></city>
<region></region>
<code></code>
<country>USA</country>
</postal>
<email>gmaxwell@juniper.net</email>
</address>
</author> </author>
<date day="20" month="November" year="2008" /> <date day="20" month="November" year="2008" />
@ -86,6 +97,9 @@ For RTP based transportation of CELT encoded audio the standard
RTP header [2] is followed by one or more payload data blocks. RTP header [2] is followed by one or more payload data blocks.
An optional padding terminator may also be used. An optional padding terminator may also be used.
</t> </t>
<t>
<figure>
<artwork><![CDATA[ <artwork><![CDATA[
0 1 2 3 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 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
@ -97,11 +111,15 @@ An optional padding terminator may also be used.
| one or more frames of CELT .... | | one or more frames of CELT .... |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
]]></artwork> ]]></artwork>
</figure>
</t>
</section> </section>
<section anchor="RTP Header" title="RTP Header"> <section anchor="RTP Header" title="RTP Header">
<t>
<figure>
<artwork><![CDATA[ <artwork><![CDATA[
0 1 2 3 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 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
@ -116,6 +134,8 @@ An optional padding terminator may also be used.
| ... | | ... |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
]]></artwork> ]]></artwork>
</figure>
</t>
<t> <t>
The RTP header begins with an octet of fields (V, P, X, and CC) to The RTP header begins with an octet of fields (V, P, X, and CC) to
@ -235,6 +255,8 @@ no padding is ever required.
In the example below we have a single CELT frame in the RTP packet. In the example below we have a single CELT frame in the RTP packet.
</t> </t>
<t>
<figure>
<artwork><![CDATA[ <artwork><![CDATA[
0 1 2 3 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 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
@ -258,6 +280,8 @@ In the example below we have a single CELT frame in the RTP packet.
| ..celt data.. | | ..celt data.. |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
]]></artwork> ]]></artwork>
</figure>
</t>
</section> </section>
@ -280,7 +304,7 @@ Below is an example of two CELT frames contained within one RTP
packet. packet.
</t> </t>
<t><figure>
<artwork><![CDATA[ <artwork><![CDATA[
0 1 2 3 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 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
@ -302,6 +326,7 @@ packet.
| ..celt data.. | | ..celt data.. |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
]]></artwork> ]]></artwork>
</figure></t>
</section> </section>
@ -372,11 +397,13 @@ offering a single channel of CELT at 48000 samples per second might
be: be:
</t> </t>
<t>
<vspace blankLines="1" /> <vspace blankLines="1" />
<list style="empty"> <list style="empty">
<t>m=audio 8088 RTP/AVP 97</t> <t>m=audio 8088 RTP/AVP 97</t>
<t>a=rtpmap:97 CELT/48000</t> <t>a=rtpmap:97 CELT/48000</t>
</list> </list>
</t>
<t> <t>
Note that the RTP payload type code of 97 is defined in this media Note that the RTP payload type code of 97 is defined in this media
@ -396,12 +423,14 @@ illustrates the case where the offerer cannot receive more than
10 kbit/s. 10 kbit/s.
</t> </t>
<t>
<vspace blankLines="1" /> <vspace blankLines="1" />
<list style="empty"> <list style="empty">
<t>m=audio 8088 RTP/AVP 97</t> <t>m=audio 8088 RTP/AVP 97</t>
<t>b=AS:64</t> <t>b=AS:64</t>
<t>a=rtmap:97 CELT/48000</t> <t>a=rtmap:97 CELT/48000</t>
</list> </list>
</t>
<t> <t>
In this case, if the remote part agrees, it should configure its In this case, if the remote part agrees, it should configure its
@ -416,9 +445,11 @@ is to use its specific parameters via the a=fmtp: directive. The
following parameters are defined for use in this way: following parameters are defined for use in this way:
</t> </t>
<t>
<vspace blankLines="1" /> <vspace blankLines="1" />
<list style="empty"> <list style="empty">
<t>frame-size: duration of each frame in samples (default is 256).<vspace blankLines="1" /></t> <t>frame-size: duration of each frame in samples (default is 256).<vspace blankLines="1" />
</t>
<t>nb-frames: number of frames per packet (default is 1).<vspace blankLines="1" /></t> <t>nb-frames: number of frames per packet (default is 1).<vspace blankLines="1" /></t>
@ -426,15 +457,18 @@ following parameters are defined for use in this way:
(defaults to off). If on, variable bit rate is (defaults to off). If on, variable bit rate is
enabled. If off, disabled.<vspace blankLines="1" /></t> enabled. If off, disabled.<vspace blankLines="1" /></t>
</list> </list>
</t>
<t>Examples:</t> <t>Examples:</t>
<t>
<vspace blankLines="1" /> <vspace blankLines="1" />
<list style="empty"> <list style="empty">
<t>m=audio 8008 RTP/AVP 97</t> <t>m=audio 8008 RTP/AVP 97</t>
<t>a=rtpmap:97 CELT/44100</t> <t>a=rtpmap:97 CELT/44100</t>
<t>a=fmtp:97 frame-size=512;nb-frames=2</t> <t>a=fmtp:97 frame-size=512;nb-frames=2</t>
</list> </list>
</t>
<t> <t>
This examples illustrate an offerer that wishes to receive This examples illustrate an offerer that wishes to receive
@ -536,7 +570,7 @@ CELT and AVT communities for their input:
<reference anchor="rfc2119"> <reference anchor="rfc2119">
<front> <front>
<title>Key words for use in RFCs to Indicate Requirement Levels </title> <title>Key words for use in RFCs to Indicate Requirement Levels </title>
<author initials="S." surname="Bradner" fullname="Scott Bradner"></author> <author initials="S." surname="Bradner" fullname="Scott Bradner"><organization/></author>
</front> </front>
<seriesInfo name="RFC" value="2119" /> <seriesInfo name="RFC" value="2119" />
</reference> </reference>
@ -544,10 +578,10 @@ CELT and AVT communities for their input:
<reference anchor="rfc3550"> <reference anchor="rfc3550">
<front> <front>
<title>RTP: A Transport Protocol for real-time applications</title> <title>RTP: A Transport Protocol for real-time applications</title>
<author initials="H." surname="Schulzrinne" fullname=""></author> <author initials="H." surname="Schulzrinne" fullname=""><organization/></author>
<author initials="S." surname="Casner" fullname=""></author> <author initials="S." surname="Casner" fullname=""><organization/></author>
<author initials="R." surname="Frederick" fullname=""></author> <author initials="R." surname="Frederick" fullname=""><organization/></author>
<author initials="V." surname="Jacobson" fullname=""></author> <author initials="V." surname="Jacobson" fullname=""><organization/></author>
</front> </front>
<seriesInfo name="RFC" value="3550" /> <seriesInfo name="RFC" value="3550" />
</reference> </reference>
@ -555,56 +589,38 @@ CELT and AVT communities for their input:
<reference anchor="rfc2045"> <reference anchor="rfc2045">
<front> <front>
<title>Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies</title> <title>Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies</title>
<author initials="" surname="" fullname=""></author> <author initials="" surname="" fullname=""><organization/></author>
</front>
<date month="November" year="1998" /> <date month="November" year="1998" />
</front>
<seriesInfo name="RFC" value="2045" /> <seriesInfo name="RFC" value="2045" />
</reference> </reference>
<reference anchor="rfc2327"> <reference anchor="rfc2327">
<front> <front>
<title>SDP: Session Description Protocol</title> <title>SDP: Session Description Protocol</title>
<author initials="V." surname="Jacobson" fullname=""></author> <author initials="V." surname="Jacobson" fullname=""><organization/></author>
<author initials="M." surname="Handley" fullname=""></author> <author initials="M." surname="Handley" fullname=""><organization/></author>
</front>
<date month="April" year="1998" /> <date month="April" year="1998" />
</front>
<seriesInfo name="RFC" value="2327" /> <seriesInfo name="RFC" value="2327" />
</reference> </reference>
<reference anchor="H323">
<front>
<title>Packet-based Multimedia Communications Systems</title>
<author initials="" surname="" fullname=""></author>
</front>
<date month="" year="1998" />
<seriesInfo name="ITU-T Recommendation" value="H.323" />
</reference>
<reference anchor="H245">
<front>
<title>Control of communications between Visual Telephone Systems and Terminal Equipment</title>
<author initials="" surname="" fullname=""></author>
</front>
<date month="" year="1998" />
<seriesInfo name="ITU-T Recommendation" value="H.245" />
</reference>
<reference anchor="rfc3551"> <reference anchor="rfc3551">
<front> <front>
<title>RTP Profile for Audio and Video Conferences with Minimal Control.</title> <title>RTP Profile for Audio and Video Conferences with Minimal Control.</title>
<author initials="H." surname="Schulzrinne" fullname=""></author> <author initials="H." surname="Schulzrinne" fullname=""><organization/></author>
<author initials="S." surname="Casner" fullname=""></author> <author initials="S." surname="Casner" fullname=""><organization/></author>
</front>
<date month="July" year="2003" /> <date month="July" year="2003" />
</front>
<seriesInfo name="RFC" value="3551" /> <seriesInfo name="RFC" value="3551" />
</reference> </reference>
<reference anchor="rfc3534"> <reference anchor="rfc3534">
<front> <front>
<title>The application/ogg Media Type</title> <title>The application/ogg Media Type</title>
<author initials="L." surname="Walleij" fullname=""></author> <author initials="L." surname="Walleij" fullname=""><organization/></author>
</front>
<date month="May" year="2003" /> <date month="May" year="2003" />
</front>
<seriesInfo name="RFC" value="3534" /> <seriesInfo name="RFC" value="3534" />
</reference> </reference>
@ -615,6 +631,7 @@ CELT and AVT communities for their input:
<reference anchor="celt-website"> <reference anchor="celt-website">
<front> <front>
<title>The CELT ultra-low delay audio codec</title> <title>The CELT ultra-low delay audio codec</title>
<author initials="" surname="Xiph.Org Foundation" fullname="Xiph.Org Foundation"><organization/></author>
</front> </front>
<seriesInfo name="CELT website" value="http://www.celt-codec.org/" /> <seriesInfo name="CELT website" value="http://www.celt-codec.org/" />
</reference> </reference>