Co-Doing API'sini uygulayın

Ortak Çalışma API'si, toplantı katılımcıları arasında rastgele verileri senkronize etmek için kullanılır. Bu, uygulamanızın ihtiyaç duyduğu herhangi bir veri olabilir.

Verilerin aktarılabilmesi için verileri bir Uint8Array olarak serileştirmeniz gerekir. Daha fazla bilgi için JavaScript standart kitaplığı referansı bölümüne bakın.

Verilerinizi nasıl serileştireceğinizden emin değilseniz aşağıdaki kod örneklerini inceleyin.

Bu kılavuzda, Co-Doing API'nin nasıl uygulanacağı açıklanmaktadır.

Başlayın

Ortak Çalışma API'sini kullanmak için önce Meet eklentisi dağıtmanız gerekir. Bu adımları tamamladıktan sonra, yeni eklentinizden Co-Doing API'yi kullanmaya başlayabilirsiniz.

Co-Doing API'yi kullanmak için öncelikle Google Meet ortak etkinliklerinin giriş noktası olacak bir AddonSession nesnesi edinin:

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

Ortak çalışma istemcisi oluşturma

Başlamak için AddonSession öğenizden bir CoDoingClient nesnesi oluşturun.

CoDoingClient oluşturmak için createCoDoingClient() yöntemini çağırın ve bir CoDoingDelegate nesnesi sağlayın.

CoDoingDelegate, Co-Doing API'nin yeni bir durum olduğunda uygulamanızı güncelleme şeklidir. onCoDoingStateChanged() yöntemi çağrıldığında uygulamanızın yeni durumu hemen uygulaması beklenir.

Aşağıdaki kod örneğinde, Co-Doing API'nin nasıl kullanılacağı gösterilmektedir:

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

Mevcut durumu yönet

Kullanıcılar uygulamanızda işlem yaptığında uygulamanızın hemen broadcastStateUpdate() yöntemini çağırması beklenir.

Aşağıdaki kod örneğinde, broadcastStateUpdate() yönteminin bir uygulaması gösterilmektedir:

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

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