mirror of
https://github.com/matrix-org/matrix-spec
synced 2026-02-19 12:33:43 +01:00
4fd9f39966
* Change version field to a string And add the notes on how the version field works. * Add spec requiring tracks to be within streams. * Put streams spec in its own section * Add 'invitee' field * Add party_id * Remember how JSON works * Add m.call.select_answer * Update examples * Add select_answer to call flow example diagram * Add m.call.reject * Make party_id required in other events * Add possible ways for client to handle an invite * Convert hangup & reject events to YAML So we can have a bulleted list in the description for the values of 'reason'. * Add new reason codes to hangup & reject * Add m.call.negotiate * Add other sections * Revert changes to package lock * Typos * Fix type of other version fields, fix anchor. * Add newsfragment * Fix reason in hangup/reject * Change tense Co-authored-by: Hubert Chathi <hubertc@matrix.org> * Tense, typos & grammar Co-authored-by: Hubert Chathi <hubertc@matrix.org> * Linkify Co-authored-by: Hubert Chathi <hubertc@matrix.org> * Remove unnecessary parts from link Co-authored-by: Hubert Chathi <hubertc@matrix.org> * Capitalise Co-authored-by: Hubert Chathi <hubertc@matrix.org> * Fix hangup reasons * Clarify who can answer Co-authored-by: Hubert Chathi <hubertc@matrix.org> * Linkify Co-authored-by: Hubert Chathi <hubertc@matrix.org> * Remove reference to 'this MSC'. * Move common VoIP fields into a call event type. * Move common voip events to the content, not the actual event * Remove reason from reject event I confused myself, but it's not in the MSC and it shouldn't be. * Failure to YAML * Fix number of room members allowed when sending voip events. Co-authored-by: Hubert Chathi <hubertc@matrix.org> * Add 'added in' version Co-authored-by: Hubert Chathi <hubertc@matrix.org> * Another added-in Co-authored-by: Hubert Chathi <hubertc@matrix.org> * Add missing comma --------- Co-authored-by: Hubert Chathi <hubertc@matrix.org> Co-authored-by: Travis Ralston <travisr@matrix.org>
55 lines
2.3 KiB
YAML
55 lines
2.3 KiB
YAML
---
|
|
type: object
|
|
description: |
|
|
Sent by either party to signal their termination of the call. This can
|
|
be sent either once the call has has been established or before to abort the call.
|
|
|
|
The meanings of the `reason` field are as follows:
|
|
* `ice_failed`: ICE negotiation has failed and a media connection could not be established.
|
|
* `ice_timeout`: The connection failed after some media was exchanged (as opposed to `ice_failed`
|
|
which means no media connection could be established). Note that, in the case of an ICE
|
|
renegotiation, a client should be sure to send `ice_timeout` rather than `ice_failed` if media
|
|
had previously been received successfully, even if the ICE renegotiation itself failed.
|
|
* `invite_timeout`: The other party did not answer in time.
|
|
* `user_hangup`: Clients must now send this code when the user chooses to end the call, although
|
|
for backwards compatibility with version 0, a clients should treat an absence of the `reason`
|
|
field as `user_hangup`.
|
|
* `user_media_failed`: The client was unable to start capturing media in such a way that it is unable
|
|
to continue the call.
|
|
* `user_busy`: The user is busy. Note that this exists primarily for bridging to other networks such
|
|
as the PSTN. A Matrix client that receives a call whilst already in a call would not generally reject
|
|
the new call unless the user had specifically chosen to do so.
|
|
* `unknown_error`: Some other failure occurred that meant the client was unable to continue the call
|
|
rather than the user choosing to end it.
|
|
allOf:
|
|
- "$ref": core-event-schema/room_event.yaml
|
|
properties:
|
|
content:
|
|
type: object
|
|
allOf:
|
|
- "$ref": core-event-schema/call_event.yaml
|
|
properties:
|
|
reason:
|
|
type: string
|
|
description: Reason for the hangup. Note that this was optional in
|
|
previous previous versions of the spec, so a missing value should be
|
|
treated as `user_hangup`.
|
|
x-changedInMatrixVersion:
|
|
1.7: |-
|
|
Additional values were added.
|
|
enum:
|
|
- ice_timeout
|
|
- ice_failed
|
|
- invite_timeout
|
|
- user_hangup
|
|
- user_media_failed
|
|
- user_busy
|
|
- unknown_error
|
|
required:
|
|
- reason
|
|
type:
|
|
type: string
|
|
enum:
|
|
- m.call.hangup
|
|
|