Ortak İzleme API'sini uygulayın

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:

 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.