Reproductor de Amazon IVS SDK: integración del reproductor JW - Amazon Interactive Video Service
IntroducciónEventosErroresPolíticas de seguridad del contenidoLimitaciones 

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Reproductor de Amazon IVS SDK: integración del reproductor JW

Este documento describe las funciones más importantes disponibles en la integración de Amazon Interactive Video Service (IVS) con JW Player.

Última versión de la integración de JW Player: 1.24.0 (notas de la versión)

Introducción

La compatibilidad de Amazon IVS para JW Player se implementa a través de un proveedor. El proveedor de Amazon IVS solo se admite en el reproductor web de JW Player. El proveedor se carga a través de una etiqueta de script y cualquier transmisión que requiera la reproducción del proveedor de Amazon IVS debe etiquetarse con type: 'ivs' en la lista de reproducción. Amazon IVS es compatible con la versión 8.18.4 y versiones posteriores de JW Player.

Configuración

En estas instrucciones, JW_PLAYER_DIV es el nombre del <div> de su instancia de JW Player y IVS_STREAM la URL de reproducción de IVS. Para configurar el proveedor de Amazon IVS y habilitar la reproducción:

  1. Incluye la siguiente script etiqueta (para la última versión de la integración del reproductor; en este caso, la 1.24.0):

    <script src="https://player.live-video.net/1.24.0/amazon-ivs-jw-provider.min.js"></script>

  2. Usar el tipo de ivs para marcar los elementos de la lista de reproducción de IVS. Establezca el valor cast en su setup() en null (ya que Chromecast no es compatible).

    jwplayer(JW_PLAYER_DIV).setup({
   playlist: [{
      file:IVS_STREAM,
      type: 'ivs',
   }]
});

  3. Si desea hacer referencia al reproductor de Amazon IVS subyacente para realizar llamadas a la API del reproductor de Amazon IVS o si desea hacer referencias a enumeraciones específicas de Amazon IVS para la gestión de devoluciones de llamada, agregue un agente de escucha al evento 'providerPlayer':

    jwplayer(JW_PLAYER_DIV).on('providerPlayer', function (player) {
   // player object has 'ivsPlayer' and 'ivsEvents' properties
   // ...callback code...
});

Código de muestra

En este ejemplo, JW_PLAYER_LIB es la URL de su script de la biblioteca de JW Player y IVS_STREAM es la URL de reproducción de IVS.

<!DOCTYPE html>
<html lang="en">
<head>
   <script src=JW_PLAYER_LIB></script>
   <script src="https://player.live-video.net/1.24.0/amazon-ivs-jw-provider.min.js"></script>
</head>
<body>
   <div id='player'></div>
   <script>
      // set default values for ivsPlayer and ivsEvents
      var ivsPlayer = {};
      var ivsEvents = {};

      // define our player setup
      const ivsConfig = {
         playlist: [{
            file: IVS_STREAM,
            type: 'ivs',
         }]
      };

      jwplayer('player')
         .setup(ivsConfig)
         .on('providerPlayer', function (player) {
            console.log('Amazon IVS Player: ', player.ivsPlayer);
            console.log('Amazon IVS Player Events: ', player.ivsEvents);

            // store the reference to the Amazon IVS Player
            ivsPlayer = player.ivsPlayer;
            // store the reference to the Amazon IVS Player Events
            ivsEvents = player.ivsEvents;
         });
   </script>
</body>
</html>

Eventos

Para escuchar eventos estándar de JW Player, utilice la función Activado del JW Player.

Para escuchar eventos específicos de Amazon IVS o para agregar y eliminar agentes de escucha de eventos en el reproductor web de Amazon IVS, debe escuchar el evento 'providerPlayer' para obtener una referencia al reproductor de Amazon IVS y, a continuación, agregar el agente de escucha de eventos en él. Por ejemplo:

// store a default value for ivsPlayer
var ivsPlayer = {};

// store references to the Amazon IVS Player and Amazon IVS Events:
jwplayer(JW_PLAYER_DIV).on('providerPlayer', function (player) {
   ivsPlayer = player.ivsPlayer;
});

// set up event listening
ivsPlayer.addEventListener(event, callback);
ivsPlayer.removeEventListener(event, callback);

donde callback es una devolución de llamada que usted define y event es uno de los valores siguientes: PlayerEventType, PlayerState o ErrorType. Para obtener más información acerca de los eventos, consulte la Referencia web de Reproductor de Amazon IVS SDK.

El evento 'providerPlayer' es emitido por JW Player y la devolución de llamada que registre con él recibirá un objeto con los siguientes campos:

Campo Descripción

ivsPlayer

Devuelve la instancia subyacente del reproductor de Amazon IVS. La API web completa del reproductor de Amazon IVS está disponible a través de esta instancia. Recomendamos utilizar la API de reproducción básica de JW Player tanto como sea posible y utilizar esta función solo para acceder a las características específicas de Amazon IVS. Las funciones más comunes a las que probablemente deba acceder en la instancia del reproductor de Amazon IVS son addEventListener() y removeEventListener().

ivsEvents

Devuelve un objeto con los campos PlayerEventType, PlayerState, y ErrorType, que se asignan a sus enumeraciones específicas de Amazon IVS asociadas. Para obtener más información, consulte la Referencia web de Reproductor de Amazon IVS SDK.

Errores

Para errores generales de JW Player, utilice la función Activado del JW Player para escuchar eventos de error.

Para errores específicos de Amazon IVS, escuche en el reproductor de Amazon IVS sus propios errores:

// set default values for ivsPlayer and ivsEvents
var ivsPlayer = {};
var ivsEvents = {};

// store references to the Amazon IVS Player and Amazon IVS Events
jwplayer(JW_PLAYER_DIV).on('providerPlayer', function (player) {
   ivsPlayer = player.ivsPlayer;
   ivsEvents = player.ivsEvents;
});

// set up event listening:
let playerEvent = ivsEvents.PlayerEventType;
ivsPlayer.addEventListener(playerEvent.ERROR, callback);

La devolución de llamada recibirá un objeto con los siguientes campos:

Campo Descripción

type

Tipo de error Corresponde con los eventos ErrorType. Para obtener más información, consulte Reproductor de Amazon IVS SDK: referencia web.

code

Código de error

source

Fuente del error

message

Mensaje de error legible por humanos

Políticas de seguridad del contenido

La API del proveedor de Amazon IVS está configurada para trabajar en páginas que utilizan la Política de seguridad de contenido (CSP). Consulte la sección “Trabajar con la política de seguridad de contenido” en la Reproductor de Amazon IVS SDK: guía para la Web.

Limitaciones 

El proveedor no admite la emisión. Si ha habilitado la emisión en el panel de control de JW Player, puede desactivarla al configurar cast en null al llamar a setup(). Esto oculta el botón de emisión.