Co-Watching API, birden fazla kullanıcının toplantı deneyimini yönetir. dinleyen veya izleyen kullanıcılara gösterilir.
Bu kılavuzda, Co-Watching API'nin nasıl uygulanacağı açıklanmaktadır.
Başlayın
Co-Watching API'sini kullanmak için önce Meet eklentisi. 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ına proje numarasını yazın Google Cloud projenize ekleyin.
Birlikte izleme istemcisi oluşturma
Başlamak için bir
CoWatchingClient
AddonSession
cihazınızdaki nesneden istediğinizi alın.
CoWatchingCient
oluşturmak için şunları çağırın:
createCoWatchingClient()
yöntemini kullanarak
CoWatchingDelegate
nesnesini tanımlayı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ğırmalısınız. Örneğin,
Örneğin, uygulamanız bir oyun geliştirdiğinde her seferinde bu kişiyi aramanız gerekmez
videosunu izleyin. 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()
: Arabelleğe alma tamamlandığında ve medya oynatılmaya hazır hale geldiğinde arayın.notifySeekToTimestamp()
: Kullanıcı, oynatma konumunu açıkça değiştirdiğinde çağır.notifySwitchToMedia()
: Aktif olarak oynatılan medya her değiştiğinde çağır. Örneğin, kullanıcı yeni bir video seçtiğinde veya otomatik oynatma sonraki videoyu başlatır.