Ortak İzleme API'sini uygulayın

Birlikte İzleme API'si, uygulamanızda içerik izleyen veya dinleyen birden fazla katılımcının toplantı deneyimini yönetir.

Bu kılavuzda, birlikte izleme API'sinin nasıl uygulanacağı açıklanmaktadır.

Başlayın

Birlikte İzleme API'sini kullanmak için önce Meet eklentisi dağıtmanız gerekir. Bu adımları tamamladıktan sonra yeni eklentinizden birlikte izleme API'sini kullanmaya başlayabilirsiniz.

Birlikte İzleme API'sini kullanmak için öncelikle Google Meet ortak etkinliklerinin giriş noktası olarak işlev gören bir AddonSession nesnesi alın:

TypeScript

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

CLOUD_PROJECT_NUMBER kısmını, Google Cloud projenizin proje numarasıyla değiştirin.

Birlikte 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 CoWatchingDelegate nesnesi sağlayın.

CoWatchingDelegate, Co-Watching API'nin yeni bir durum olduğunda uygulamanızı güncelleme yöntemidir. onCoWatchingStateChanged() yöntemi çağrıldığında uygulamanızın yeni durumu hemen uygulaması beklenir.

Aşağıdaki kod örneğinde, Birlikte İ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ığını girin.

Mevcut durumu yönetme

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, uygulamanızda oynatılan bir video her ilerlediğinde bu yöntemleri çağırmanız gerekmez. Oluşturduğunuz CoWatchingDelegate, bu durumlarda güncellenen oynatma konumlarını yönetir.

Birlikte izleme durumunu aşağıdaki yöntemlerle kontrol edebilirsiniz:

  • notifyBuffering(): Kullanıcının uygulamasında önceki bir medya geçişi, medya arama veya ağ tıkanıklığı nedeniyle arabelleğe alma işlemi 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ğere (örneğin, 1,25x) güncellediğinde çağrılır.

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

  • notifySeekToTimestamp(): Kullanıcı, oynatma konumunu açıkça değiştirdiğinde çağrılır.

  • notifySwitchToMedia(): Etkin olarak oynatılan medya her değiştiğinde çağrılır. Örneğin, kullanıcı yeni bir video seçtiğinde veya otomatik oynatma bir sonraki videoyu başlattığında.