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 bir Meet eklentisi dağıtmanız gerekir. Bu adımları tamamladıktan sonra, yeni eklentinizden Birlikte İzleme API'yi kullanmaya başlayabilirsiniz.
TogetherWatching API'yi kullanmak için Google Meet ortak etkinliklerinin giriş noktası olan bir AddonSession nesnesi elde edin:
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 yeni bir durum olduğunda uygulamanızı güncelleme şeklidir. 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 yerine etkinliğinizin medya başlığını yazın.
Mevcut durumu yönetme
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, bu durumlarda güncel oynatma konumlarını alır.
Ortak izleme durumunu aşağıdaki yöntemlerle kontrol edebilirsiniz:
notifyBuffering(): Kullanıcı uygulaması, önceki bir medya anahtarlama, medya arama veya ağ tıkanıklığı nedeniyle arabelleğe almaya başladığında çağrılır.notifyPauseState(): Kullanıcı oynatılan medyayı duraklattığında veya duraklatmayı kaldırdığında çağrılır.notifyPlayoutRate(): Kullanıcı oynatma hızını yeni bir değere (ör.1,25x) güncellediğinde çağrılır.notifyReady(): Aktarıcı tamamlandığı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ılır.notifySwitchToMedia(): Etkin olarak oynatılan medya değiştiğinde çağrı yapılır. Örneğin, kullanıcı yeni bir video seçer veya otomatik oynatma bir sonraki videoyu başlatır.