Implementa la API de Co-Watching

En esta guía, se explica cómo implementar la API de Co-Watching.

Cómo crear un CoWatchingClient

Para comenzar, crea createCoWatchingClient desde la AddonSession que creaste en Comenzar.

Para crear un CoWatchingCient, llama al AddonSession.createCoWatchingClient y proporciona un CoWatchingDelegate

El CoWatchingDelegate es la manera en que la API de visualización en compañía actualiza tus aplicación cuando hay un nuevo estado disponible. Se espera que, cuando CoWatchingDelegate.onCoWatchingStateChanged de estado, tu aplicación aplicará de inmediato el estado nuevo.

En el siguiente ejemplo de código, se muestra cómo usar la API de Co-Watching:

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

Reemplaza ACTIVITY_TITLE por el título multimedia de tu actividad.

Administrar el estado actual

Cuando los usuarios realizan acciones en tu aplicación, se espera que esta llama inmediatamente a los métodos de la API proporcionados.

Solo debes llamar a estos métodos en respuesta a eventos significativos. Para ejemplo, no necesitas llamarlos cada vez que tu app avanza en un video. La CoWatchingDelegate que creaste anteriormente controla la actualización los puestos de juego en estas circunstancias.

Puedes controlar el estado de visualización en compañía con estos métodos:

• CoWatchingClient.notifySwitchToMedia Llama cada vez que cambie el contenido multimedia que se está reproduciendo. Por ejemplo, el usuario selecciona un video nuevo o la reproducción automática inicia el siguiente.
• CoWatchingClient.notifyPauseState Llama cuando un usuario pausa o reanuda la reproducción de contenido multimedia.
• CoWatchingClient.notifySeekToTimestamp Realiza una llamada cuando un usuario cambie explícitamente la posición de reproducción.
• CoWatchingClient.notifyPlayoutRate Se llama cuando un usuario actualiza la velocidad de reproducción a un nuevo valor (por ejemplo, 1.25x).
• CoWatchingClient.notifyBuffering Llamada cuando la app de un usuario comienza a almacenar en búfer debido al almacenamiento en búfer de un contenido multimedia anterior el interruptor, la búsqueda de contenido multimedia o la congestión de la red.
• CoWatchingClient.notifyReady Realiza una llamada cuando se complete el almacenamiento en búfer y el contenido multimedia esté listo para reproducirse.