Co-Doing API, toplantılar arasında rastgele verileri senkronize etmek için kullanılır katılımcı sayısı. Bu, uygulamanızın ihtiyaç duyduğu herhangi bir veri olabilir.
Aktarılması için verileri Uint8Array
cihazına 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
Co-Doing API'yi kullanmak için önce Meet eklentisi. Bu adımları tamamladıktan sonra, yeni eklentinizden Co-Doing API'yi kullanmaya başlayabilirsiniz.
Co-Doing API'yi kullanmak için öncelikle bir
AddonSession
nesne,
başlangıç noktası niteliğindeki bu slaytta:
TypeScript
const session = await window.meet.addon.createAddonSession({
cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});
CLOUD_PROJECT_NUMBER kısmına proje numarasını yazın Google Cloud projenize ekleyin.
Ortak çalışma istemcisi oluşturma
Başlamak için bir
CoDoingClient
AddonSession
cihazınızdaki nesneden istediğinizi alın.
CoDoingClient
oluşturmak için şunları çağırın:
createCoDoingClient()
yöntemini kullanarak
CoDoingDelegate
nesnesini tanımlayı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:
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
},
});
ACTIVITY_TITLE yerine etkinliğinizin başlığını yazın.
Mevcut durumu yönetme
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öntem:
TypeScript
const myState: MyState = {
someString: "SOME_STRING",
someNumber: 0
};
document.getElementById('some-button').onClick(() => {
myState.someNumber = myState.someNumber + 1;
coDoingClient.broadcastStateUpdate({ bytes: toBytes(myState) });
});
SOME_STRING değerini uygulamanın mevcut durumuyla değiştirin.