Google Meet Canlı Paylaşım Ortak İzleme API'si, uygulamanızdaki içerikleri izleyen veya dinleyen birden fazla katılımcının gerçekleştirdiği toplantı deneyimini yönetir.
Bu kılavuzda, Co-Watching API'nin 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 bir CoWatchingDelegate
sağlayın.
CoWatchingDelegate
, Co-Watching API'nin uygulamanızı yeni bir durum olduğunda güncellediği yöntemdir. CoWatchingDelegate.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 bir işlem yaptığında uygulamanızın hemen sağlanan API yöntemlerini çağırması beklenir.
Bu yöntemleri yalnızca önemli etkinliklere yanıt olarak çağırmalısınız. Örneğin, uygulamanızda oynatılan her video ilerlediğinde telefon etmeniz gerekmez. Yukarıda oluşturduğunuz CoWatchingDelegate
, bu koşullarda güncellenen
oynatma pozisyonlarını alır.
Birlikte izleme durumunu şu yöntemleri kullanarak kontrol edebilirsiniz:
CoWatchingClient.notifySwitchToMedia
: Aktif olarak oynatılan medya her değiştiğinde çağrı yapılır. Ö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 çağırın.CoWatchingClient.notifySeekToTimestamp
: Kullanıcı, oynatma konumunu açıkça değiştirdiğinde çağrıdır.CoWatchingClient.notifyPlayoutRate
: Kullanıcı, oynatma hızını yeni bir değerle (örneğin, 1,25x) güncellediğinde çağrı yapılır.CoWatchingClient.notifyBuffering
: Bir kullanıcının uygulaması önceki bir medya anahtarından arabelleğe alma, medya arama işlemi veya ağ tıkanıklığı nedeniyle arabelleğe alınmaya başladığında çağrıdır.CoWatchingClient.notifyReady
: Arabelleğe alma tamamlandığında ve medya oynatılmaya hazır olduğunda arama.