Opciones disponibles para el código de inserción estándar (iframe)

En este tema, aprenderá sobre el uso y la configuración del iframe código de inserción. Esta versión de la implementación del reproductor también se conoce como Estándar código de jugador.

Introducción

La iframe El código de implementación del reproductor proporciona la facilidad de uso del reproductor como una sola unidad contenida. Esto a menudo es necesario para las aplicaciones de redes sociales y para compartir.

Uso

Usar el iframe código siga estos pasos:

  1. Utilizar el JUGADORES módulo para crear un jugador.
  2. Ve a la MEDIOS DE COMUNICACIÓN módulo y publique un video usando el reproductor recién creado.
  3. Copia el Estándar código de inserción. El HTML será similar al siguiente:
    <iframe src="https://players.brightcove.net/.../index.html?videoId=6116779877001"
      allowfullscreen=""
      allow="encrypted-media"
      width="960" height="540"></iframe>
  4. Copia el HTML del navegador y pégalo en la body de una página HTML completa.
  5. Navega por la página HTML para ver cómo funciona el reproductor.

Parámetros de consulta

Hay numerosos parámetros de consulta disponibles para iframe etiqueta para proporcionar información adicional sobre cómo debe comportarse un jugador. La siguiente tabla detalla los parámetros disponibles.

Parámetro Descripción Tipo de datos
adConfigId Identificador de configuración de anuncios de SSAI de entrega dinámica. Cadena
applicationId Permite la reutilización de un solo jugador, pero diferencia los análisis por sitio o por aplicación. Ver el Agregar una ID de aplicación al código de inserción del reproductor documento para obtener todos los detalles. Cadena
autoplay Indica que el jugador debe empezar a jugar inmediatamente, en plataformas en las que esté permitido.

Si autoplay se establece en un valor booleano se utiliza el comportamiento de reproducción automática nativo del navegador. Si se establece en uno de los tres valores de cadena válidos siguientes, se produce lo siguiente:
  • play: El jugador intentará llamar manualmente al juego.
  • muted: El reproductor silenciará manualmente el reproductor y llamará a la reproducción.
  • any: En primer lugar, el jugador intentará llamar al juego. Si esto falla, silencie el reproductor y llame a play.
Si alguno de los anteriores falla, el jugador mostrará el «Botón de juego grande» como si la reproducción automática se estableciera en false.

Conseguir que un video se reproduzca automáticamente puede ser una situación compleja. Ver el Consideraciones sobre la reproducción automática documento para más detalles.
Booleano o cadena
crossorigin Si verdadero , el subyacente <vídeo> elemento tendrá crossorigin="anonimo". Esto significa que cualquier vídeo o pista de texto que se haya extraído en el reproductor debe tener encabezados CORS. booleano
deliveryConfigId Un ID de configuración de Reglas de entrega dinámicas Cadena
language Establece el idioma (utilizando un código de idioma válido, normalmente dos letras) del reproductor. Cadena
loop Hace que el vídeo se reinicie tan pronto como termina. Cadena
muted Silencia el sonido del vídeo. booleano
playlistId Establece el ID o el identificador de referencia de la lista de reproducción del reproductor. Cadena
playlistVideoId Establece el vídeo inicial que se va a reproducir en el vídeo, que debe estar en la lista de reproducción designada. Cadena
playsinline Si la plataforma y el sistema operativo lo permiten, se mostrará el contenido de video dentro del área de reproducción del reproductor, lo que significa que no se mostrará en pantalla completa o en una ventana independiente de tamaño variable; funciona en iPhone y iPad booleano
preload Informa al navegador si los datos de vídeo deben comenzar a descargarse en cuanto se carga la etiqueta de vídeo. Los valores posibles son none, metadata o auto. Consulte la siguiente sección para obtener más información. Cadena
referrer Le permite pasar en el document.referrer junto con otros parámetros del iframe, lo que le permite realizar un seguimiento preciso de la URL de referencia del video. Tenga en cuenta que deberá codificar el valor mediante URI, por ejemplo: referrer=http%3A%2F%2Ffoo.com. También tenga en cuenta que este parámetro está disponible para la versión 6.25 del reproductor o posterior. Cadena
t Establece el desplazamiento de tiempo desde el que comenzará a reproducirse un vídeo. Ver el Vinculación profunda documento para más detalles. Cadena
videoId Establece el ID o el identificador de referencia del vídeo en el reproductor. Cadena

detalles de precarga

El parámetro de precarga informa al navegador si los datos de video deben comenzar a descargarse tan pronto como se cargue la etiqueta de video. las opciones son auto , metadatos , y ninguno. Para la tecnología de reproducción HLS, los ajustes significan cosas ligeramente diferentes y se indican a continuación.

  • auto (defecto): Comience a cargar el vídeo inmediatamente (si el navegador está de acuerdo). Algunos dispositivos móviles como iPhones y iPads no precargarán el video para proteger el ancho de banda de sus usuarios. Es por eso que el valor se llama auto y no algo más final como true.

  • metadatos: Cargue solo los metadatos del vídeo, que incluye información como la duración y las dimensiones del vídeo.

  • ninguno: No cargues previamente ninguno de los datos de vídeo. Esto esperará hasta que el usuario haga clic en jugar para comenzar a descargar. Tenga en cuenta que en iOS puede haber descargas de segmentos incluso con esta configuración. Ver el Brightcove Player e iOS documento para obtener más información.

      <video-js preload ...>
      or
      { "preload": "auto" }