Implementar a API Co-Doing

A API Google Meet Live Share Co-Doing é usada para sincronizar dados arbitrários entre reuniões participantes. Podem ser quaisquer dados de que seu app dependa.

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

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 fornecem uma CoDoingDelegate

O CoDoingDelegate é como a API Co-Doing atualiza o aplicativo sempre que há um novo estado disponível. É esperado que, quando CoDoingDelegate.onCoDoingStateChanged for chamado, seu aplicativo aplicará imediatamente o novo estado.

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 chama imediatamente CoDoingClient.broadcastStateUpdate

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