Implementa l'API Co-Doing

L'API Co-Doing viene utilizzata per sincronizzare dati arbitrari tra i partecipanti alla riunione. Possono essere qualsiasi tipo di dati su cui dipende la tua app.

Per poter essere trasmessi, i dati devono essere serializzati in un Uint8Array. Per ulteriori informazioni, consulta la documentazione di riferimento della libreria standard JavaScript.

Se non sai come serializzare i dati, esamina i seguenti esempi di codice.

Questa guida spiega come implementare l'API Co-Doing.

Inizia

Per utilizzare l'API Co-Doing, devi prima implementare un plug-in di Meet. Una volta completati questi passaggi, puoi iniziare a utilizzare l'API Co-Doing dal tuo nuovo componente aggiuntivo.

Per utilizzare l'API Co-Doing, inizia recuperando un oggetto AddonSession, che funge da punto di contatto per le co-attività di Google Meet:

const session = await window.meet.addon.createAddonSession({
    cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});

Creare un client di co-doing

Per iniziare, crea un oggetto CoDoingClient da AddonSession.

Per creare un CoDoingClient, chiama il metodo createCoDoingClient() e fornisci un oggetto CoDoingDelegate.

CoDoingDelegate è il modo in cui l'API Co-Doing aggiorna la tua app ogni volta che è disponibile un nuovo stato. È previsto che, quando viene chiamato il metodo onCoDoingStateChanged(), l'app applichi immediatamente il nuovo stato.

Il seguente esempio di codice mostra come utilizzare l'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 the new state to your ongoing CoDoing activity
    },
  });

Gestire lo stato attuale

Quando gli utenti intraprendono un'azione nella tua app, è normale che l'app chiami immediatamente il metodo broadcastStateUpdate().

Il seguente esempio di codice mostra un'implementazione del metodo broadcastStateUpdate():

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

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