Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

XEP-0272: Update to adjust for current XMPP protocols #1139

Merged
merged 4 commits into from
Sep 17, 2024
Merged

XEP-0272: Update to adjust for current XMPP protocols #1139

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
aa4d5e6
XEP-0272: Send Jingle IQs to real JID
mar-v-in Feb 2, 2022
dac9c45
XEP-0272: Adjust namespace
mar-v-in Feb 2, 2022
e84ccee
XEP-0272: Define how to use with XEP-0482
mar-v-in Feb 2, 2022
8732ccd
XEP-0272: Add revision block
mar-v-in Feb 6, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
80 changes: 59 additions & 21 deletions xep-0272.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
</abstract>
&LEGALNOTICE;
<number>0272</number>
<status>Deferred</status>
<status>Experimental</status>
<type>Standards Track</type>
<sig>Standards</sig>
<approver>Council</approver>
Expand All @@ -37,6 +37,17 @@
<email>[email protected]</email>
<jid>[email protected]</jid>
</author>
&larma;
<revision>
<version>0.2.0</version>
<date>2024-08-21</date>
<initials>lmw</initials>
<remark><ul>
<li>Send Jingle IQs to real JID</li>
<li>Define how to use with XEP-0482</li>
<li>Adjust namespace</li>
</ul></remark>
</revision>
<revision>
<version>0.1.2</version>
<date>2022-08-06</date>
Expand Down Expand Up @@ -110,7 +121,7 @@
node="http://telepathy.freedesktop.org/wiki/Muji"
ver="48QdBuXRCJFb8qIzgy1FOHSGO0U="
hash="sha-1" />
<muji xmlns='http://telepathy.freedesktop.org/muji'>
<muji xmlns='urn:xmpp:jingle:muji:0'>
<preparing />
</muji>
</presence>
Expand All @@ -130,7 +141,7 @@
node="http://telepathy.freedesktop.org/wiki/Muji"
ver="48QdBuXRCJFb8qIzgy1FOHSGO0U="
hash="sha-1" />
<muji xmlns='http://telepathy.freedesktop.org/muji'>
<muji xmlns='urn:xmpp:jingle:muji:0'>
<content creator='initiator' name='video'>
<description xmlns='urn:xmpp:jingle:apps:rtp:0' media='video'>
<payload-type id='97' name='theora' clockrate='90000'/>
Expand All @@ -140,9 +151,9 @@
<description xmlns='urn:xmpp:jingle:apps:rtp:0' media='audio'>
<payload-type id='97' name='speex' clockrate='8000'/>
<payload-type id='18' name='G729'/>
</description>
</content>
</muji>
</description>
</content>
</muji>
</presence>
]]></code>

Expand Down Expand Up @@ -172,13 +183,27 @@
</p>

<p>

Jingle sessions are initiated between the MUC JIDs of participants. That is,
the Jingle session-initiate stanza is sent from one MUC JID to another. This
allows participants to easily identify sessions as belonging to a Muji
conference. Content names inside Muji-related Jingle sessions always refer
to the content with the same name inside the Muji conference.
Jingle sessions are initiated between the real JIDs of participants, since IQ routing is not guaranteed to work in
&xep0045; and in &xep0369;. To indicate that a Jingle session-initiate belongs to a MUJI conference, a &lt;muji&gt;
element is placed in the &lt;jingle&gt; element. The receiver SHOULD only assume that a Jingle session-initiate
belongs to a Muji conference if the sender is actually part of the referenced MUC. Content names inside Muji-related
Jingle sessions always refer to the content with the same name inside the Muji conference.
</p>

<example caption="Jingle session-initiate referencing a Muji conference"><![CDATA[
<iq to='[email protected]/laptop' type='set' id='id1'>
<jingle xmlns='urn:xmpp:jingle:1'
action='session-initiate'
initiator='[email protected]/mobile'
sid='sid1'>
<muji room='[email protected]' xmlns='urn:xmpp:jingle:muji:0' />
<content creator='initiator' name='this-is-a-stub'>
<description xmlns='urn:xmpp:jingle:apps:stub:0'/>
<transport xmlns='urn:xmpp:jingle:transports:stub:0'/>
</content>
</jingle>
</iq>
]]></example>
</section1>

<section1 topic='Leaving a Conference' anchor='leaving'>
Expand All @@ -205,15 +230,15 @@
node="http://telepathy.freedesktop.org/wiki/Muji"
ver="48QdBuXRCJFb8qIzgy1FOHSGO0U="
hash="sha-1" />
<muji xmlns='http://telepathy.freedesktop.org/muji'>
<muji xmlns='urn:xmpp:jingle:muji:0'>
<content creator='initiator' name='voice'>
<description xmlns='urn:xmpp:jingle:apps:rtp:0' media='audio'>
<payload-type id='97' name='speex' clockrate='8000'/>
<payload-type id='18' name='G729'/>
</description>
</content>
<preparing/>
</muji>
</description>
</content>
<preparing/>
</muji>
</presence>
]]></code>

Expand All @@ -236,7 +261,7 @@
node="http://telepathy.freedesktop.org/wiki/Muji"
ver="48QdBuXRCJFb8qIzgy1FOHSGO0U="
hash="sha-1" />
<muji xmlns='http://telepathy.freedesktop.org/muji'>
<muji xmlns='urn:xmpp:jingle:muji:0'>
<content creator='initiator' name='video'>
<description xmlns='urn:xmpp:jingle:apps:rtp:0' media='video'>
<payload-type id='97' name='theora' clockrate='90000'/>
Expand All @@ -246,9 +271,9 @@
<description xmlns='urn:xmpp:jingle:apps:rtp:0' media='audio'>
<payload-type id='97' name='speex' clockrate='8000'/>
<payload-type id='18' name='G729'/>
</description>
</content>
</muji>
</description>
</content>
</muji>
</presence>
]]></code>
</section1>
Expand Down Expand Up @@ -284,4 +309,17 @@
other clients.
</p>
</section1>

<section1 topic='Call Invites'>
<p>
To invite someone to a Muji conference, a &xep0482; &lt;invite&gt; is sent containing a &lt;muji&gt; element in the
urn:xmpp:jingle:muji:0 namespace with a 'room' attribute specifying the JID of the Muji MUC.
</p>
<example caption="Invite to a MUJI conference"><![CDATA[
<message to='[email protected]' type='chat'>
<invite xmlns='urn:xmpp:call-invites:0'>
<muji xmlns='urn:xmpp:jingle:muji:0' room='[email protected]' />
</invite>
</message>>]]></example>
</section1>
</xep>