Co-Watching API, uygulamanızda içerik izleyen veya dinleyen birden fazla katılımcının toplantı deneyimini yönetir.
Bu kılavuzda, Ortak İzleme API'sinin nasıl uygulanacağı açıklanmaktadır.
Başlayın
Birlikte İzleme API'sini kullanmak için önce Meet eklentisi dağıtmanız gerekir. Bir kez Bu adımları tamamladıktan sonra Co-Watching API'sini kullanmaya başlayabilirsiniz. yeni eklentinizi kullanabilirsiniz.
Co-Watching 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ını Google Cloud projenizin proje numarasıyla değiştirin.
Ortak izleme istemcisi oluşturma
Başlamak için AddonSession'ınızdan bir CoWatchingClient nesnesi oluşturun.
CoWatchingCient oluşturmak için createCoWatchingClient() yöntemini çağırın ve bir CoWatchingDelegate nesnesi sağlayın.
CoWatchingDelegate, Co-Watching API'nin uygulamanızı nasıl güncellediğini gösterir
. onCoWatchingStateChanged() yöntemi çağrıldığında uygulamanızın yeni durumu hemen uygulaması beklenir.
Aşağıdaki kod örneğinde, Co-Watching API'nin nasıl kullanılacağı gösterilmektedir:
TypeScript
const coWatchingClient = await addonSession.createCoWatchingClient({
activityTitle: "ACTIVITY_TITLE",
onCoWatchingStateQuery() {
// This function should return the current state of your CoWatching activity
return getMyApplicationCoWatchingState();
},
onCoWatchingStateChanged(coWatchingState: CoWatchingState) {
// This function should apply newState to your ongoing CoWatching activity
},
});
ACTIVITY_TITLE kısmını etkinliğinizin medya başlığıyla değiştirin.
Mevcut durumu yönet
Kullanıcılar uygulamanızda işlem yaptığında, uygulamanızın sağlanan API yöntemlerini hemen çağırması beklenir.
Bu yöntemleri yalnızca önemli etkinliklere yanıt olarak çağırmanız gerekir. Örneğin, uygulamanız oynatılan bir videoyu her ilerlettiğinde bu işlevi çağırmanız gerekmez. Oluşturduğunuz CoWatchingDelegate adlı kullanıcının herkese açık kullanıcı adları güncellenir.
daha iyi bir fırsat olamaz.
Birlikte izleme durumunu şu yöntemleri kullanarak kontrol edebilirsiniz:
notifyBuffering(): Bir kullanıcının uygulaması, önceki bir medyadan arabelleğe alınması nedeniyle arabelleğe alınmaya başladığında çağır veya ağ tıkanıklığı olabilir.notifyPauseState(): Kullanıcı oynatılan medyayı duraklattığında veya devam ettirdiğinde çağır.notifyPlayoutRate(): Kullanıcı oynatma hızını yeni bir değere (ör. 1,25x) güncellediğinde çağrılır.notifyReady(): Aktarımı tamamladığında ve medya oynatılmaya hazır olduğunda çağrılır.notifySeekToTimestamp(): Kullanıcı, oynatma konumunu açıkça değiştirdiğinde çağır.notifySwitchToMedia(): Etkin olarak oynatılan medya değiştiğinde çağrılır. Örneğin, kullanıcı yeni bir video seçer veya otomatik oynatma bir sonraki videoyu başlatır.