Implementa l'API Co-Doing

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

Per essere trasmessi, i dati devono essere serializzati in un Uint8Array. Per ulteriori informazioni, consulta il riferimento alla libreria standard JavaScript.

Se non sai come serializzare i dati, esamina gli esempi di codice riportati di seguito.

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

Inizia

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

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

TypeScript

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

Sostituisci CLOUD_PROJECT_NUMBER con il numero del progetto Google Cloud.

Creare un cliente co-doing

Per iniziare, crea un CoDoingClient oggetto dal tuo 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(), la tua app applichi immediatamente il nuovo stato.

Il seguente esempio di codice mostra come utilizzare l'API Co-Doing:

TypeScript

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
    },
  });

Sostituisci ACTIVITY_TITLE con il titolo della tua attività.

Gestire lo stato attuale

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

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

TypeScript

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

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

Sostituisci SOME_STRING con lo stato attuale dell'app.