Subscribe or unsubscribe to a scheduled group call.
Method schema is available as of layer 127. Switch »
| Name | Type | Description |
|---|---|---|
| call | InputGroupCall | Scheduled video chat/livestream that has not started yet |
| subscribed | Bool | Whether to receive a service-notification message when the call starts |
| Code | Type | Description |
|---|---|---|
| 403 | GROUPCALL_ALREADY_STARTED | The groupcall has already started, you can join directly using phone.joinGroupCall. |
| 403 | GROUPCALL_FORBIDDEN | The specified group call cannot be used in this context. |
| 400 | GROUPCALL_INVALID | The specified group call is invalid. |
How to start, join and manage group calls and video chats.
Join any group call type ». Conference calls additionally require the E2E joining flow ».
The params field must contain a join payload generated by the local tgcalls group-call engine. It contains a random non-zero audio ssrc, ICE ufrag and pwd, DTLS fingerprints, and, when publishing video, ssrc-groups.
For example, a join payload without published video has the following shape:
{
"ssrc": 123456789,
"ufrag": "...",
"pwd": "...",
"fingerprints": [{
"hash": "sha-256",
"fingerprint": "...",
"setup": "passive"
}]
}
When joining an RTMP-mode call, generate the payload without published video source groups.