Muestra de Brightcove Player: Vídeos más vistos en la lista de reproducción

Ejemplo de jugador

En el siguiente ejemplo, verá el reproductor con una lista de reproducción que aparece a la derecha. La lista de reproducción se completa recuperando los videos más populares, según la mayor cantidad de reproducciones, utilizando el Catálogo Brightcove Player.

Ver la pluma 18175 lista de reproducción de videos más vistos por Brightcove Learning Services ( bcls1969 ) en CodePen.

Código fuente

Ver el solución completa en GitHub.

Resumen

Este ejemplo devuelve los videos más vistos de su cuenta usando el Catálogo Brightcove Player , que accede a la API de reproducción. Es similar al Lista de reproducción de videos populares ejemplo, que utiliza datos de la API de Analytics. Hay pocas diferencias que hay que tener en cuenta:

Catálogo de Brightcove Player (API de reproducción)

  • El plays_total campo es la visualización de vídeo de todos los tiempos de un vídeo.
  • Puedes usar el catalog.getSearch () método para recuperar fácilmente datos de la API de reproducción.

API de análisis

  • Si no especifica el from parámetro y el valor, el valor predeterminado es los últimos 30 días.
  • Para recuperar los mismos resultados del Analytics API que obtendría de la API de reproducción, utilice el ?alltime Parámetro de URL en la solicitud de API.

Uso de CodePen

Estos son algunos consejos para utilizar eficazmente el CodePen anterior:

  • Cambie la visualización real del reproductor haciendo clic en el Result botón.
  • Haga clic en el HTML/CSS/JS botones para mostrar UNO de los tipos de código.
  • Más adelante, en este documento, la lógica, el flujo y el estilo utilizados en la aplicación se analizarán en la configuración de reproductor/HTML, Flujo de aplicaciones y Estilo de la aplicación. secciones. La mejor manera de seguir la información de estas secciones es:
    1. Haga clic en el EDIT ON CODEPEN en el CodePen y tenga el código disponible en un navegador / pestaña del navegador.
    2. En CodePen, ajusta el código que quieres que se muestre. Puede cambiar el ancho de las distintas secciones de código dentro de CodePen.
    3. Ver el Configuración de reproductor / HTML , Flujo de aplicación y / o Estilo de aplicación secciones en otra pestaña del navegador / navegador. Ahora podrá seguir las explicaciones del código y, al mismo tiempo, ver el código.

secuencia de desarrollo

Esta es la secuencia de desarrollo recomendada:

  1. Utilice la implementación del reproductor de incrustación en la página para probar la funcionalidad de su reproductor, complemento y CSS (si es necesario CSS)
  2. Coloque el JavaScript y CSS del plugin en archivos separados para pruebas locales
  3. Implementa el código del plugin y CSS en tu servidor una vez que hayas resuelto cualquier error.
  4. Usa Studio para agregar el plugin y CSS a tu reproductor
  5. Reemplace la implementación del reproductor de incrustación en página si determina que la implementación de iframe se ajusta mejor (se detalla en la siguiente sección)

Para obtener más información sobre estos pasos, consulte la sección Paso a paso: Guía de desarrollo de plugins.

iframe o incrustación en página

Al desarrollar mejoras para Brightcove Player, deberás decidir si el código se ajusta mejor a la implementación de iframe o incrustación en la página. La recomendación de práctica recomendada es crear un complemento para usarlo con una implementación de iframe. Las ventajas de utilizar el reproductor iframe son:

  • Sin colisiones con JavaScript y/o CSS existentes
  • Responde automáticamente
  • El iframe facilita el uso en aplicaciones de redes sociales (o siempre que el vídeo tenga que «viajar» a otras aplicaciones)

Aunque la integración del reproductor de incrustación en la página puede ser más compleja, hay ocasiones en que planificará el código en torno a esa implementación. Para generalizar, este enfoque es mejor cuando la página que contiene necesita comunicarse con el reproductor. En concreto, estos son algunos ejemplos:

  • El código de la página que contiene necesita escuchar y actuar en función de los eventos de los jugadores
  • El reproductor utiliza estilos de la página que lo contiene
  • El iframe hará que la lógica de la aplicación falle, como un redireccionamiento desde la página que contiene

Incluso si tu implementación final no utiliza el código iframe, puedes seguir usando el código de incrustación en la página con un plugin para tu JavaScript y un archivo separado para tu CSS. Esto encapsula tu lógica para que puedas utilizarla fácilmente en varios reproductores.

Recursos de API/plugins utilizados

Métodos de Player API
catalog.getSearch ()
lista de reproducción ()

Configuración de reproductor/HTML

En esta sección se detalla cualquier configuración especial necesaria durante la creación del reproductor. Además, se describen otros elementos HTML que deben agregarse a la página, más allá del código de implementación del reproductor de incrustación de la página.

Configuración del reproductor

No se requiere ninguna configuración especial para el reproductor de Brightcove que crea para este ejemplo.

Otros HTML

Al utilizar el reproductor Avanzado (inserción en la página), debe agregar un elemento HTML para especificar la ubicación de la lista de reproducción. Para obtener más detalles, consulte la Implementación de listas de reproducción documento.

<div class="vjs-playlist"></div>

Recuerda añadir el id atributo a la video-js etiqueta en el código de inserción del reproductor.

<video-js id="myPlayerID"
...

Flujo de aplicaciones

La lógica básica detrás de esta aplicación es:

  • Definir los parámetros de búsqueda
  • Obtener los objetos de vídeo
  • Cargar la lista de reproducción

Definir los parámetros de búsqueda

Busque el código etiquetado:

// +++ Define the search parameters +++

Al usar el catalog.getSearch () método, primero debe definir los parámetros de búsqueda. Esta consulta devolverá 10 videos de su cuenta, ordenados en orden descendente por reproducciones de video de todos los tiempos (plays_total).

Dado que estamos buscando videos en nuestra cuenta de Video Cloud, debemos usar un Clave de política habilitada para búsqueda.

Obtener los objetos de vídeo

Busque el código etiquetado:

// +++ Get the video objects +++

Recupere una matriz de objetos de video en función de los parámetros de búsqueda para el catalog.getSearch() método.

Cargar la lista de reproducción

Busque el código etiquetado:

// +++ Load the playlist +++

Utilizar el playlist() método para cargar los objetos de video devueltos en la lista de reproducción del reproductor.

Estilismo de aplicaciones

CSS se utiliza para diseñar el reproductor y la lista de reproducción.

Código de plugin

Normalmente, al convertir JavaScript en un complemento de Brightcove Player, se necesitan cambios nominales. Un cambio necesario es reemplazar el uso estándar del ready() método por el código que define un complemento.

Aquí está el código de inicio a JavaScript muy utilizado que funcionará con el reproductor:

videojs.getPlayer('myPlayerID').ready(function() {
  var myPlayer = this;
  ...
});

Cambiarás la primera línea para usar la sintaxis estándar para iniciar un plugin de Brightcove Player:

videojs.registerPlugin('pluginName', function(options) {
  var myPlayer = this;
  ...
});

Como se mencionó anteriormente, puede ver el código JavaScript del complemento en el repositorio de GitHub correspondiente de este documento: playlist.js más visto.

Uso del complemento con un reproductor

Una vez que tengas los archivos CSS y JavaScript del plugin almacenados en una ubicación accesible a Internet, puedes usar el plugin con un reproductor. En Studio's JUGADORES módulo puedes elegir un jugador, luego en el PLUGINS sección agregue las URL a los archivos CSS y JavaScript, y también agregue el Nombre y Opciones , si se necesitan opciones.