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 trasmettere i dati, devi serializzarli in un Uint8Array. Per saperne di più, consulta il riferimento della libreria standard JavaScript.

Se non sai come serializzare i dati, consulta 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 eseguire il deployment di un componente aggiuntivo di Meet. Una volta completati questi passaggi, puoi iniziare a utilizzare l'API Co-Doing all'interno del nuovo componente aggiuntivo.

Per utilizzare l'API Co-Doing, inizia ottenendo un AddonSession oggetto, 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 di progetto del tuo progetto Google Cloud.

Creare un client Co-Doing

Per iniziare, crea un CoDoingClient oggetto da AddonSession.

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

CoDoingDelegate è il modo in cui l'API Co-Doing aggiorna la tua app ogni volta che è disponibile un nuovo stato. Quando viene chiamato il metodo onCoDoingStateChanged() , l'app applica 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 dell'attività.

Gestire lo stato attuale

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

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.