mirror of
https://github.com/matrix-org/matrix-spec
synced 2026-03-23 19:44:09 +01:00
7633d2c299
MSC2746, merged in v1.17, introduced the end-of-candidates candidate, where only the `candidate` property is set to an empty string. Besides, the [WebRTC specification](https://www.w3.org/TR/webrtc/) says that only one of those fields is required in a normal candidate. Signed-off-by: Kévin Commaille <zecakeh@tedomum.fr>
48 lines
1.5 KiB
YAML
48 lines
1.5 KiB
YAML
type: object
|
|
description: |-
|
|
This event is sent by callers after sending an invite and by the callee after
|
|
answering. Its purpose is to give the other party additional ICE candidates to
|
|
try using to communicate.
|
|
allOf:
|
|
- $ref: core-event-schema/room_event.yaml
|
|
properties:
|
|
content:
|
|
type: object
|
|
allOf:
|
|
- $ref: core-event-schema/call_event.yaml
|
|
properties:
|
|
candidates:
|
|
type: array
|
|
description: Array of objects describing the candidates.
|
|
items:
|
|
type: object
|
|
title: Candidate
|
|
properties:
|
|
sdpMid:
|
|
type: string
|
|
description: |-
|
|
The SDP media type this candidate is intended for.
|
|
|
|
At least one of `sdpMid` or `sdpMLineIndex` is required, unless
|
|
this an end-of-candidates candidate.
|
|
sdpMLineIndex:
|
|
type: number
|
|
description: |-
|
|
The index of the SDP 'm' line this candidate is intended for.
|
|
|
|
At least one of `sdpMid` or `sdpMLineIndex` is required, unless
|
|
this an end-of-candidates candidate.
|
|
candidate:
|
|
type: string
|
|
description: |-
|
|
The SDP 'a' line of the candidate.
|
|
|
|
If this is an end-of-candidates candidate, this is empty.
|
|
required:
|
|
- candidate
|
|
required:
|
|
- candidates
|
|
type:
|
|
type: string
|
|
enum:
|
|
- m.call.candidates |