Muestra de Brightcove Player: ¿Sigues observando?

Ejemplo de jugador

En esta muestra, verá después de un período de tiempo establecido, se muestra un mensaje superpuesto. Esta muestra mostrará la superposición en 6 segundos, pero el tiempo es configurable. Si el espectador hace clic en el mensaje dentro de un tiempo especificado, la reproducción continúa. Si no es así, el video está en pausa. Esta técnica es útil si tiene contenido de formato largo. Esto evitará que desperdicie ancho de banda en los espectadores que comienzan a reproducir un video y luego se van para hacer otra cosa sin molestarse en detenerlo.

Esta muestra utiliza un complemento Video.js de código abierto ubicado en https://github.com/TylerZubke/Videojs-AFK-Monitor. El código de muestra en este documento utilizará este complemento.

Ver la pluma ¿Sigues viendo? por Brightcove Learning Services ( rcrooks1969 ) en CodePen.

Código fuente

Ver el solución completa en GitHub.

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 API Eventos API Complementos de Brightcove Player
addClass () usuario activo Complemento de superposición
Eliminar clase () usuario inactivo  
pausa ()    
Hora actual ()    
uno ()    
sobre()    
setTimeout ()    
hasClass ()    
duración ()    
pausado ()    
clearTimeout ()    
ha empezado()    
el ()    

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

Se incluyen los archivos CSS y JavaScript del complemento de terceros.

Flujo de aplicaciones

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

  • La useractive y userinactive los eventos se miran para realizar un seguimiento del tiempo.
  • La superposición se muestra después del tiempo especificado para ver si el cliente todavía está viendo el video.
  • Cuando se haya mostrado la superposición durante el tiempo que especifique y no se haya hecho clic en el texto, pause el video.
  • Cuando se hace clic en el botón, o el espectador inicia el video después de una pausa, reinicialice los valores y comience el seguimiento del tiempo nuevamente.

Esta muestra usa el complemento

El complemento se llama utilizando las mejores prácticas, como se muestra aquí

  <script>
    videojs.getPlayer('myPlayerID').ready(function() {
      var myPlayer = this;
      var options = {'showMessageAfter': 1000, 'pausePlayerAfter': 1000};
      myPlayer.AFKMonitor(options);
    });
  </script>

Configurar el complemento

Se pueden utilizar varias opciones para personalizar el complemento. Algunos detalles son:

  • Una lista completa de opciones de configuración se encuentra en el complemento léame expediente.
  • La showMessageAfter (en milisegundos) determina el tiempo antes de que se muestre el botón.
  • La pausePlayerAfter (en milisegundos) las opciones también son útiles. Este es el momento en que permite que el usuario haga clic en el botón antes de que el reproductor se detenga. Esto le da al usuario la oportunidad de hacer clic en el botón sin interrumpir la reproducción de video.

Estilismo de aplicaciones

El CSS es parte del complemento de terceros.

Código de plugin

Querrá clonar el repositorio para acceder al código y luego colocarlo en una ubicación accesible en Internet para su uso.

Como se mencionó anteriormente, puede ver el código JavaScript del complemento en el repositorio de GitHub correspondiente de este documento: videojs.afk-monitor.js.

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.