Cómo implementar la API de Co-Doing

La API de Co-Doing de Compartir en vivo de Google Meet se usa para sincronizar datos arbitrarios entre los participantes de una reunión. Estos pueden ser cualquier dato de los que dependa tu app.

Debes serializar los datos a un Uint8Array para que se transmitan. Para obtener más información, consulta la referencia de la biblioteca estándar de JavaScript.

Si no sabes cómo serializar tus datos, revisa las siguientes muestras de código.

Esta guía explica cómo implementar la API de Co-Doing.

Cómo crear un CoDoingClient

Para comenzar, crea un CoDoingClient a partir del AddonSession que creaste en Comenzar.

Para crear un CoDoingClient, llama al método AddonSession.createCoDoingClient y proporciona un CoDoingDelegate.

El CoDoingDelegate es la manera en que la API de Co-Doing actualiza tu aplicación cada vez que tiene un nuevo estado disponible. Se espera que, cuando se llama al método CoDoingDelegate.onCoDoingStateChanged, tu aplicación aplica de inmediato el estado nuevo.

En la siguiente muestra de código, se ve cómo usar la API de 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
    },
  });

Reemplaza ACTIVITY_TITLE por el título de tu actividad.

Administrar el estado actual

Cuando los usuarios realizan acciones en tu aplicación, se espera que esta llame inmediatamente a CoDoingClient.broadcastStateUpdate.

En la siguiente muestra de código, se muestra una implementación 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) });
});

Reemplaza SOME_STRING por el estado actual de la app.