Ortak İzleme API'sini uygulayın

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:

const session = await window.meet.addon.createAddonSession({
    cloudProjectNumber: "CLOUD_PROJECT_NUMBER",
});

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:

 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
    },
  });

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.