Ortak İzleme API'sini uygulayın

Co-Watching API, uygulamanızda içerik izleyen veya dinleyen birden fazla katılımcının toplantı deneyimini yönetir.

Bu kılavuzda, Co-Watching API'nin nasıl uygulanacağı açıklanmaktadır.

Başlayın

Co-Watching API'yi kullanmak için önce bir Meet eklentisi dağıtmanız gerekir. Bu adımları tamamladıktan sonra yeni eklentinizden Co-Watching API'yi kullanmaya başlayabilirsiniz.

TogetherWatching API'yi kullanmak için Google Meet ortak etkinliklerinin giriş noktası olan bir AddonSession nesnesi elde edin:

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

Ortak izleme istemcisi oluşturma

Başlamak için AddonSession öğenizden 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 uygulamanızı yeni bir durumu olduğunda güncelleyeceği ş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:

 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ğı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 koşullarda güncel oynatma pozisyonlarını alır.

Birlikte izleme durumunu şu yöntemleri kullanarak 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ğerle (örneğin, 1,25x) güncellediğinde çağrı yapılır.

• notifyReady(): Arabelleğe alma işlemi tamamlandığında ve medya oynatılmaya hazır olduğunda arama.

• 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 sonraki videoyu başlatır.