diff --git a/inbox/jingle-grouping.xml b/inbox/jingle-grouping.xml index cfa7ede9..e46e7def 100644 --- a/inbox/jingle-grouping.xml +++ b/inbox/jingle-grouping.xml @@ -1,829 +1,134 @@ - - - - - -
- - -First draft.
&rfc5888; defines a framework to group SDP 'm' lines for different purposes. A mapping to Jingle as an extension to &xep0166; is defined in this document.
+It is anticipated that the primary use of this is with the &bundle; framework used in WebRTC.
+The SDP format defined in RFC 5888 is shown below.
+
+a=group:semantics identification-tag
+
+ An example follows.
+
+a=group:LS voice webcam
+
+ This SDP attribute is translated to Jingle as a <group/> element qualified by the 'urn:xmpp:jingle:apps:grouping:0' namespace, as shown below. The semantics is mapped to a 'semantics' attribute. The identifiation-tags are mapped to content elements whose name attribute is set to the identification-tag.
+
+
+
+
+ ]]>
+ An example follows.
+
+
+
+
+ ]]>
+ The <group/> element is included as child of the <jingle/> element.
+
+
+
+
+
+
+
+ [ ... ]
+
+
+ [ ... ]
+
+
+
+ ]]>
+ Note: the identification-tags correspond to the <content/> 'name' attributes. These in turn map to the 'mid' attribute in SDP.
+If an entity supports the grouping framework described in RFC 5888, it MUST advertise that fact in its responses to &xep0030; information ("disco#info") requests by returning a feature of 'urn:ietf:rfc:5888':
+In order for an application to determine whether an entity supports this protocol, where possible it SHOULD use the dynamic, presence-based profile of service discovery defined in &xep0115;. However, if an application has not received entity capabilities information from an entity, it SHOULD use explicit service discovery instead.
+Thanks to Emil Ivov and Lance Stout for their feedback.
+The XML format for this specification originates from libjingle
The SDP syntax examples are taken from RFC 5888.
+This document introduces no additional security considerations above and beyond those defined in the documents on which it depends.
+This document requires no interaction with &IANA;.
+This specification defines the following XML namespace:
+You can clone with - HTTPS, - SSH, - or Subversion. - - - - - -
- - - - Clone in Desktop - - - - - - Download ZIP - -Cannot retrieve contributors at this time
-- 1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -33 -34 -35 -36 -37 -38 -39 -40 -41 -42 -43 -44 -45 -46 -47 -48 -49 -50 -51 -52 -53 -54 -55 -56 -57 -58 -59 -60 -61 -62 -63 -64 -65 -66 -67 -68 -69 -70 -71 -72 -73 -74 -75 -76 -77 -78 -79 -80 -81 -82 -83 -84 -85 -86 -87 -88 -89 -90 -91 -92 -93 -94 -95 -96 -97 -98 -99 -100 -101 -102 -103 -104 -105 -106 -107 -108 -109 -110 -111 -112 -113 -114 -115 -116 -117 -118 -119 -120 -121 -122 -123 -124 -125 -126 -127 -128 -129 -130 -131 -132 -133 -134 - - | -
-
|
-
The ®ISTRAR; includes the foregoing namespace to the registry located at &NAMESPACES;, as described in Section 4 of &xep0053;.
+ +TODO
+First draft.
&rfc5576; provides a mechanism to describe attributes of individual media sources (identified by their synchronization source) within a media stream. A mapping to Jingle as an extension to &xep0167; is defined in this document.
+The SDP format defined in RFC 5576 is shown below.
+
+a=ssrc:<ssrc-id> <attribute>
+a=ssrc:<ssrc-id> <attribute>:<value>
+
+ This maps to Jingle as a <source/> element qualified by the 'urn:xmpp:jingle:apps:rtp:ssma:0' namespace. Since 'ssrc' is a media attribute in SDP, the <source/> element is included as child of the Jingle <description/> element.
+
+
+
+
+ ]]>
+ Each ssrc-id maps to a <source/> element whose 'ssrc' attribute is set to the ssrc-id. The associated attributes map to <parameter/> children with 'name' and 'value' attributes. If there is no value in the SDP, the value parameter shall be omitted.
+An example follows:
+
+a=ssrc:1656081975 cname:Yv/wvbCdsDW2Prgd
+a=ssrc:1656081975 msid:MLTJKIHilGn71fNQoszkQ4jlPTuS5vJyKVIv MLTJKIHilGn71fNQoszkQ4jlPTuS5vJyKVIva0
+a=ssrc:1656081975 mslabel:MLTJKIHilGn71fNQoszkQ4jlPTuS5vJyKVIv
+a=ssrc:1656081975 label:MLTJKIHilGn71fNQoszkQ4jlPTuS5vJyKVIva0
+
+
+
+
+
+
+
+ ]]>
+ The SDP format defined in RFC 5576 is shown below.
+
+a=ssrc-group:<semantics> <ssrc-id> ...
+
+ This maps to Jingle as a <ssrc-group/> element qualified by the 'urn:xmpp:jingle:apps:rtp:ssma:0' namespace. Like the <source/> element, this is included as child of the Jingle <description/> element. The SDP 'semantics' parameter is mapped to the type attribute (for consistency with FIXME jingle-grouping FIXME) and the list of ssrc-ids is mapped to <source/> elements whole 'ssrc' attribute is set to the ssrc-id.
+
+
+ [...]
+
+ ]]>
+ The following example is taken from RFC 5576.
+
+m=video 49174 RTP/AVPF 96 98
+a=rtpmap:96 H.264/90000
+a=rtpmap:98 rtx/90000
+a=fmtp:98 apt=96;rtx-time=3000
+a=ssrc-group:FID 11111 22222
+a=ssrc:11111 cname:user3@example.com
+a=ssrc:22222 cname:user3@example.com
+a=ssrc-group:FID 33333 44444
+a=ssrc:33333 cname:user3@example.com
+a=ssrc:44444 cname:user3@example.com
+
+ This is mapped to Jingle as follows:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ ]]>
+If an entity supports source specific media attributes as described in RFC 5576, it MUST advertise that fact in its responses to &xep0030; information ("disco#info") requests by returning a feature of 'urn:ietf:rfc:5576':
+In order for an application to determine whether an entity supports this protocol, where possible it SHOULD use the dynamic, presence-based profile of service discovery defined in &xep0115;. However, if an application has not received entity capabilities information from an entity, it SHOULD use explicit service discovery instead.
+The SDP syntax examples are taken from RFC 5576.
+This document introduces no additional security considerations above and beyond those defined in the documents on which it depends.
+This document requires no interaction with &IANA;.
+This specification defines the following XML namespace:
+You can clone with - HTTPS, - SSH, - or Subversion. - - - - - -
- - - - Clone in Desktop - - - - - - Download ZIP - -Cannot retrieve contributors at this time
-- 1 -2 -3 -4 -5 -6 -7 -8 -9 -10 -11 -12 -13 -14 -15 -16 -17 -18 -19 -20 -21 -22 -23 -24 -25 -26 -27 -28 -29 -30 -31 -32 -33 -34 -35 -36 -37 -38 -39 -40 -41 -42 -43 -44 -45 -46 -47 -48 -49 -50 -51 -52 -53 -54 -55 -56 -57 -58 -59 -60 -61 -62 -63 -64 -65 -66 -67 -68 -69 -70 -71 -72 -73 -74 -75 -76 -77 -78 -79 -80 -81 -82 -83 -84 -85 -86 -87 -88 -89 -90 -91 -92 -93 -94 -95 -96 -97 -98 -99 -100 -101 -102 -103 -104 -105 -106 -107 -108 -109 -110 -111 -112 -113 -114 -115 -116 -117 -118 -119 -120 -121 -122 -123 -124 -125 -126 -127 -128 -129 -130 -131 -132 -133 -134 -135 -136 -137 -138 -139 -140 -141 -142 -143 -144 -145 -146 -147 -148 -149 -150 -151 -152 -153 -154 -155 -156 -157 -158 -159 -160 -161 -162 -163 -164 -165 -166 -167 -168 -169 -170 -171 -172 -173 -174 -175 - - | -
-
|
-
The ®ISTRAR; includes the foregoing namespace to the registry located at &NAMESPACES;, as described in Section 4 of &xep0053;.
+ +TODO
+