joinChatCall method

Future<JoinCall$Mutation$JoinChatCall$JoinChatCallOk> joinChatCall(
  1. ChatId chatId,
  2. ChatCallCredentials creds
)

Joins the ongoing ChatCall in the specified Chat by the authenticated MyUser.

Use this mutation when an EventChatCallStarted is received via Subscription.chatEvents and MyUser wants to accept the ChatCall, or he wants to join an ongoing ChatCall.

Once this mutation succeeds the EventChatCallMemberJoined is fired to all ChatCall members via callEvents, and it's required to use callEvents for the authenticated MyUser to be able to react on all ChatCallEvents happening during the accepted ChatCall.

Authentication

Mandatory.

Result

Only the following ChatEvent may be produced on success:

Idempotent

Succeeds as no-op (and returns no ChatEvent) if the authenticated MyUser joined the current ChatCall already (is a member of it).

Implementation

Future<JoinCall$Mutation$JoinChatCall$JoinChatCallOk> joinChatCall(
  ChatId chatId,
  ChatCallCredentials creds,
) async {
  Log.debug('joinChatCall($chatId, $creds)', '$runtimeType');

  final variables = JoinCallArguments(chatId: chatId, creds: creds);
  final QueryResult result = await client.mutate(
    MutationOptions(
      operationName: 'JoinCall',
      document: JoinCallMutation(variables: variables).document,
      variables: variables.toJson(),
    ),
    onException:
        (data) => JoinChatCallException(
          (JoinCall$Mutation.fromJson(data).joinChatCall
                  as JoinCall$Mutation$JoinChatCall$JoinChatCallError)
              .code,
        ),
  );
  return (JoinCall$Mutation.fromJson(result.data!).joinChatCall
      as JoinCall$Mutation$JoinChatCall$JoinChatCallOk);
}