transformDialogCallIntoGroupCall method

Future<ChatEventsVersionedMixin?> transformDialogCallIntoGroupCall(
  1. ChatId chatId,
  2. List<UserId> additionalMemberIds,
  3. ChatName? groupName
)

Moves an ongoing ChatCall in a Chat-dialog to a newly created Chat-group, optionally adding new members.

The ongoing ChatCall should have its media room being created before moving, otherwise the ChatCall is not considered by this mutation as an ongoing one.

Once this mutation succeeds, the EventChatCallMoved is fired to all Chat-dialog members via callEvents, and it's required to establish a new callEvents using the emitted EventChatCallMoved.newCallId. Note, that the connection to the media room of the moved ChatCall should not be dropped, as it's simply moved to the returned EventChatCallMoved.newCall, ensuring smooth experience for the ChatCall members.

Authentication

Mandatory.

Result

Only the following ChatCallEvents are produced on success:

Non-idempotent

Each time tries to move the ongoing ChatCall into a new unique Chat-group.

Implementation

Future<ChatEventsVersionedMixin?> transformDialogCallIntoGroupCall(
  ChatId chatId,
  List<UserId> additionalMemberIds,
  ChatName? groupName,
) async {
  Log.debug(
    'transformDialogCallIntoGroupCall($chatId, $additionalMemberIds, $groupName)',
    '$runtimeType',
  );

  final variables = TransformDialogCallIntoGroupCallArguments(
    chatId: chatId,
    additionalMemberIds: additionalMemberIds,
    groupName: groupName,
  );
  final QueryResult result = await client.mutate(
    MutationOptions(
      operationName: 'TransformDialogCallIntoGroupCall',
      document:
          TransformDialogCallIntoGroupCallMutation(
            variables: variables,
          ).document,
      variables: variables.toJson(),
    ),
    onException:
        (data) => TransformDialogCallIntoGroupCallException(
          (TransformDialogCallIntoGroupCall$Mutation.fromJson(
                    data,
                  ).transformDialogCallIntoGroupCall
                  as TransformDialogCallIntoGroupCall$Mutation$TransformDialogCallIntoGroupCall$TransformDialogCallIntoGroupCallError)
              .code,
        ),
  );
  return (TransformDialogCallIntoGroupCall$Mutation.fromJson(
        result.data!,
      ).transformDialogCallIntoGroupCall
      as ChatEventsVersionedMixin?);
}