Implementar a API Co-Doing

A API de compartilhamento em tempo real do Google Meet é usada para sincronizar dados arbitrários entre os participantes de uma reunião. Podem ser quaisquer dados de que o app dependa.

É necessário serializar os dados em um Uint8Array para que eles sejam transmitidos. Para mais informações, consulte a referência da biblioteca padrão JavaScript.

Se você não souber como serializar os dados, consulte os exemplos de código abaixo.

Este guia explica como implementar a API Co-Doing.

Criar um CoDoingClient.

Para começar, crie um CoDoingClient do AddonSession que você criou em Começar.

Para criar um CoDoingClient, chame o método AddonSession.createCoDoingClient e forneça um CoDoingDelegate.

A CoDoingDelegate é como a API Co-Doing atualiza o aplicativo sempre que há um novo estado disponível. Espera-se que, quando o método CoDoingDelegate.onCoDoingStateChanged é chamado, o aplicativo aplique o novo estado imediatamente.

O exemplo de código a seguir mostra como usar a API Co-Doing:

interface MyState {
  someString: string;
  someNumber: number;
}

/**
 * Serialize/deserialize using JSON.stringify
 * You can use any method you want; this is included for as an example
 */
function toBytes(state: MyState): Uint8Array {
  return new TextEncoder().encode(JSON.stringify(state));
}

function fromBytes(bytes: Uint8Array): MyState {
  return JSON.parse(new TextDecoder().decode(bytes)) as MyState;
}

  const coDoingClient = await addonSession.createCoDoingClient({
    activityTitle: "ACTIVITY_TITLE",
    onCoDoingStateChanged(coDoingState: CoDoingState) {
      const newState = fromBytes(coDoingState.bytes);
      // This function should apply newState to your ongoing CoDoing activity
    },
  });

Substitua ACTIVITY_TITLE pelo título da sua atividade.

Gerenciar o estado atual

Quando os usuários realizam uma ação no seu aplicativo, é esperado que ele chame CoDoingClient.broadcastStateUpdate imediatamente.

O exemplo de código abaixo mostra uma implementação do CoDoingClient.broadcastStateUpdate:

const myState: MyState = {
  someString: "SOME_STRING",
  someNumber: 0
};

document.getElementById('some-button').onClick(() => {
  myState.someNumber = myState.someNumber + 1;
  coDoingClient.broadcastStateUpdate({ bytes: toBytes(myState) });
});

Substitua SOME_STRING pelo estado atual do app.