Implementar a API Co-Doing

A API de compartilhamento ao vivo do Google Meet é usada para sincronizar dados arbitrários entre os participantes da reunião. Podem ser quaisquer dados de que seu app dependa.

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

Se você não tiver certeza de 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.

O CoDoingDelegate é como a API Co-Doing atualiza seu aplicativo sempre que há um novo estado disponível. Espera-se que, quando o método CoDoingDelegate.onCoDoingStateChanged for 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 agem no seu aplicativo, é esperado que ele chame CoDoingClient.broadcastStateUpdate imediatamente.

O exemplo de código abaixo mostra uma implementação de 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.