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.

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-0353: Jingle Message Initiation -> Call Invite Message #1155

Open
wants to merge 4 commits into
base: master
Choose a base branch
from

Conversation

mar-v-in
Copy link
Contributor

Rendered: https://larma.de/xeps/xep-0353.html
Diff: https://larma.de/xeps/xep-0353-diff.html

tmolitor-stud-tu and others added 4 commits January 28, 2022 23:29
- Restrict to calls only, removing non-call Jingle functionality
- Support multiple and non-Jingle session establishment methods
- Adjust title and namespace
- Define Jingle-independent set of conditions for <reason>
@mar-v-in mar-v-in changed the title Call invite message XEP-0353: Call invite message Jan 30, 2022
@mar-v-in mar-v-in changed the title XEP-0353: Call invite message XEP-0353: Jingle Message Initiation -> Call Invite Message Jan 30, 2022
fiaxh added a commit to dino/dino that referenced this pull request Feb 7, 2022
@mar-v-in mar-v-in marked this pull request as ready for review February 8, 2022 21:39
@mar-v-in
Copy link
Contributor Author

mar-v-in commented Feb 8, 2022

@fippo @stpeter Can you review this, please?

@horazont horazont added the Needs Author The XEP is experimental and the PR was not made by the author. The author needs to acknowledge it. label Feb 15, 2022
Copy link
Contributor

@fippo fippo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

a couple of questions inline.

Overall I do not think bringing groupchat into this is a good idea.

<example caption="Initiator Sends Intent Message"><![CDATA[
<p>
All &MESSAGE; stanzas exchanged by this protocol MUST be of type="chat" when
sent in a direct message or of type="groupchat" when sent to a group chat
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: making this a list will be easier to read

<message from='romeo@montague.example/orchard'
to='juliet@capulet.example'
type='chat'>
<propose xmlns='urn:xmpp:jingle-message:1' id='a73sjjvkla37jfea'>
<description xmlns='urn:xmpp:jingle:apps:rtp:1' media='audio'/>
<propose xmlns='urn:xmpp:call-message:1' id='a73sjjvkla37jfea' audio='true' video='false' multi='false'>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: we usually start counting namespaces at :0, no?

<example caption="One of Responder's Resources Accepts the Call"><![CDATA[
<message from='juliet@capulet.example/phone'
to='romeo@montague.example'
type='chat'>
<accept xmlns='urn:xmpp:jingle-message:1' id='a73sjjvkla37jfea'/>
<accept xmlns='urn:xmpp:call-message:1' id='a73sjjvkla37jfea'>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: the first id is obsolete here, no?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The id of <accept> is referring to the id of a <propose>, the sid of the <jingle> element in <accept> is indeed redundant, as it is the reflected element from the <propose> message.

<p>Next, the device from which Juliet accepted the call sends directed presence to Romeo for the reasons described above.</p>
<p>
Juliet's server broadcasts this accept message to all of her resources (as
described in &xep0280; or, e.g. &xep0045;, respectively), which stop ringing, and
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't see how MUC plays a role in this part.

<busy/>
<text>Busy</text>
</reason>
<reject xmlns='urn:xmpp:call-message:1' id='a73sjjvkla37jfea'>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

if you put the sid into a subelement above you'll need to do this here too.

<example caption="Initiator Sends Finish Message"><![CDATA[
<p>
This protocol in conjunction with &xep0280; and &xep0313; or appropriate
groupchat protocols (like &xep0045;) allows all devices of all involved
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't see how this solves a problem in MUC where the full JIDs are known.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't understand what you mean here. Synchronizing the call state via messages works independently of full JIDs being used in MUCs or not. MUCs do however help with synchronization by providing message history (although nowadays we typically use MAM there as well) and forwarding the messages to all other participating resources in the room (which include your own other devices).

xep-0353.xml Show resolved Hide resolved
xep-0353.xml Show resolved Hide resolved
@mar-v-in
Copy link
Contributor Author

mar-v-in commented Feb 17, 2022

@fippo I guess inviting a group of people to a call is a feature we want, no? Do you think this should always happen with a bunch of direct messages instead of a groupchat message?

PS: Based on feedback outside GitHub I'll also rephrase a few bits that maybe were a bit unclear.

@melvo melvo mentioned this pull request Aug 6, 2022
@Kev
Copy link
Member

Kev commented Mar 31, 2023

Seems to have conflicts.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Needs Author The XEP is experimental and the PR was not made by the author. The author needs to acknowledge it. Needs Changes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants