Skip to content

Commit 9d3b390

Browse files
committed
[skip ci] describe non-standard Jingle stanzas
1 parent 2e86704 commit 9d3b390

File tree

1 file changed

+24
-0
lines changed

1 file changed

+24
-0
lines changed

doc/modules/mod_jingle_sip.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,30 @@ When MongooseIM receives any error code to the INVITE request from range `400` t
5858
it will send Jingle `session-terminate` stanza to the call's initiator.
5959
The stanza has reason `general-error` with the SIP error code in the `sip-error` sub element.
6060

61+
##### Non-standard Jingle stanzas used by jingle.js
62+
63+
The following non-standard Jingle stanzas were integrated with https://github.com/softwarehutpl/jingle.js
64+
65+
* `source-remove`
66+
* `source-add`
67+
* `source-update`
68+
69+
When MongooseIM observes the above Jingle stanzas it will translate them to a SIP in-dialog INVITE request.
70+
In the SDP content of the request, there will be a custom attribute `a=jingle-action`.
71+
The value of the custom attribute is one of the three presented above.
72+
73+
Similarly when MongooseIM gets SIP in-dialog `INVITE` request it will check if there is the custom attribute
74+
and use as the `action` attribute of the Jingle stanza sent to the user.
75+
If there is no such attribute, the action will be set to regular Jingle `transport-info`.
76+
77+
##### Non-stadard Jingle existing-session-initiate stanza
78+
79+
MongooseIM allows a user to ask for an unanswered `session-initiate` request.
80+
This may be useful in web applications when there is a need to handle the call in a new browser window.
81+
82+
In order to get the `session-initiate`, which was not answered yet, the user can send a `get` Jingle stanza to self with action set to `existing-session-initiate`.
83+
In result, MongooseIM will resent the original `session-initiate` request to the device which sent the query.
84+
6185

6286
### Prerequisites
6387

0 commit comments

Comments
 (0)