Google Meet Canlı Paylaşım Ortak İzleme API'si, uygulamanızdaki içerikleri izleyen veya dinleyen birden fazla katılımcının toplantı deneyimini yönetir.
Bu kılavuzda, Birlikte İzleme API'sinin nasıl uygulanacağı açıklanmaktadır.
CoWatchingClient
oluşturun
Başlamak için Başlarken bölümünde oluşturduğunuz AddonSession
bölümünden bir createCoWatchingClient
oluşturun.
CoWatchingCient
oluşturmak için AddonSession.createCoWatchingClient
yöntemini çağırın ve CoWatchingDelegate
yöntemini sağlayın.
CoWatchingDelegate
, Co-Watching API'si yeni bir duruma sahip olduğunda uygulamanızı günceller. CoWatchingDelegate.onCoWatchingStateChanged
yöntemi çağrıldığında uygulamanızın yeni durumu hemen uygulaması beklenir.
Aşağıdaki kod örneğinde Ortak İzleme API'sinin 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ığı yazın.
Mevcut durumu yönet
Kullanıcılar uygulamanızda bir işlem gerçekleştirdiğinde, uygulamanızın sağlanan API yöntemlerini hemen çağırması beklenir.
Bu yöntemleri yalnızca önemli etkinliklere yanıt olarak çağırmalısınız. Örneğin, uygulamanız oynatılan video her ilerlediğinde bunları çağırmanız gerekmez. Yukarıda oluşturduğunuz CoWatchingDelegate
, bu durumlarda güncellenen oynatma konumlarını ele alır.
Birlikte izleme durumunu şu yöntemleri kullanarak kontrol edebilirsiniz:
CoWatchingClient.notifySwitchToMedia
: Aktif olarak oynatılan medya değiştiğinde arama yapar. Örneğin, kullanıcı yeni bir video seçer veya otomatik oynatma sonraki videoyu başlatır.CoWatchingClient.notifyPauseState
: Kullanıcı oynatılan medyayı duraklattığında veya devam ettirdiğinde arama yapın.CoWatchingClient.notifySeekToTimestamp
: Kullanıcı oynatma konumunu açıkça değiştirdiğinde arama yapın.CoWatchingClient.notifyPlayoutRate
: Kullanıcı, oynatma hızını yeni bir değerle güncellediğinde (ör.1,25x) çağrı.CoWatchingClient.notifyBuffering
: Önceki bir medya anahtarı, medya araması veya ağ tıkanıklığı nedeniyle arabelleğe alma işlemi yapıldığında bir kullanıcının uygulaması arabelleğe alınmaya başladığında çağrı yapın.CoWatchingClient.notifyReady
: Arabelleğe alma işlemi tamamlandığında ve medya oynatılmaya hazır olduğunda arama.