phone.joinGroupCallPresentation

Start screen sharing in a non-RTMP video chat/livestream or conference. Presentations are not supported in live stories or RTMP-mode video chats/livestreams, see here » for more info.

 Method schema is available as of layer 129. Switch »

Parameters

Name Type Description
call InputGroupCall Joined non-RTMP video chat/livestream or conference in which to start presenting
params DataJSON Join payload generated by a separate local call-engine instance for the presentation

Result

Updates

Only users can use this method

Possible errors

Code Type Description
400 GROUPCALL_INVALID The specified group call is invalid.
403 PARTICIPANT_JOIN_MISSING Trying to enable a presentation, when the user hasn't joined the Video Chat with phone.joinGroupCall.

Related pages

Group calls

How to start, join and manage group calls and video chats.

phone.joinGroupCall

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.