Parámetros de configuración del reproductor

Product
Video Cloud
Aplicable a roles
Editor
Versión
Brightcove 5
Módulos
Módulo de publicación
Edición
Todas
Creado por Chris Howell.

Algunos aspectos del comportamiento de un reproductor de Video Cloud se pueden configurar editando el código de publicación del reproductor. Este tema de referencia enumera los parámetros de configuración de reproductores admisibles en Video Cloud y muestra las diversas sintaxis utilizadas para especificar parámetros de configuración de reproductores en código de incrustación JavaScript, ActionScript y HTML.

La configuración de parámetros de reproductores puede ser útil cuando se desee que una misma instancia del reproductor se comporte de forma distinta en dos sitios distintos.

En este tema explicamos:

Sintaxis de los parámetros de configuración de reproductores en código de incrustación JavaScript, ActionScript y HTML

Los nombres de los parámetros de configuración son los mismos, independientemente del tipo de código de publicación que se utilice. Sin embargo, la sintaxis es diferente para el código de incrustación en JavaScript, ActionScript y HTML: Más información sobre códigos de publicación de reproductores.

Parámetros de configuración del código de publicación JavaScript

Si utiliza JavaScript, debe incluir los parámetros de configuración entre las etiquetas <object> del código de publicación del reproductor. Los parámetros de configuración del reproductor JavaScript tienen el formato siguiente:

<param name="param_name" value="param_value" />

Parámetros de configuración del código de publicación ActionScript

Si utiliza ActionScript, debe incluir los parámetros de configuración en la función init del código de publicación del reproductor. Los parámetros de configuración del reproductor ActionScript tienen el formato siguiente:

config["param_name"] = "param_value";

Parámetros de configuración del código de publicación para incrustar

Si utiliza código HTML para embed, debe incluir los parámetros de configuración en el parámetro flashVars del código de publicación del reproductor. Los parámetros de configuración del reproductor del código HTML para embed tienen el formato siguiente:

<param name="flashVars" value="playerID=13578640001&domain=embed
             &param_name1=param_value1&param_name2=param_value2" />

Parámetros de configuración de reproductores admisibles

La tabla siguiente enumera los parámetros de configuración del reproductor admitidos en Video Cloud. Tenga en cuenta que todos estos nombres de parámetro distinguen entre mayúsculas y minúsculas. Conviene recordar que los parámetros de configuración utilizados con reproductores ActionScript 2 de Brightcove (creados con Brightcove Console o antes de la versión Brightcove 3) no funcionan con reproductores ActionScript 3 de Video Cloud.

Parámetros Tipo Descripción
@videoPlayer Cadena El Id. o el Id. de referencia de un vídeo que se programará en el reproductor. Consulte Asignar contenidos a reproductores mediante programación.
@playlistTabs Cadena El Id. o el Id. de referencia de una o varias listas de reproducción que se programarán en un reproductor que utilice fichas para la selección de listas de reproducción. Consulte Asignar contenidos a reproductores mediante programación.
@playlistCombo Cadena El Id. o el Id. de referencia de una o varias listas de reproducción que se programarán en un reproductor que utilice un cuadro combinado (lista desplegable) para la selección de listas de reproducción. Consulte Asignar contenidos a reproductores mediante programación.
@videoList Cadena El Id. o el Id. de referencia de una lista de reproducción que se programará en el reproductor. Consulte Designación de contenidos mostrados.
width Número La anchura total del reproductor en píxeles.
height Número La altura total del reproductor en píxeles.
autoStart Booleano Si está establecido en true, la reproducción del vídeo empieza al cargarse el reproductor.
bgcolor Cadena Representación hexadecimal de seis dígitos del color de fondo del reproductor. Por ejemplo, bgcolor = "#FFFFFF;" (valor predeterminado) representa blanco. Si omite este parámetro, el reproductor tendrá un fondo blanco hasta que se cargue completamente, y puede no tener el aspecto deseado. A modo de sugerencia, haga coincidir el color de fondo con el color de la página en la que se cargue el reproductor.
dynamicStreaming Booleano Si está establecido en true (la configuración predeterminada), el reproductor puede utilizar las sencillas funciones de transmisión de secuencias de Flash Media Server 3.5 y Flash Player 10. Consulte Transmisión de secuencias dinámica.
includeAPI Booleano Debe ser verdadero para poder utilizar la API de reproductores inteligentes Smart Player API con este reproductor.
isUI Booleano Debe ser verdadero para los reproductores de vídeo cuyas plantillas contengan elementos de la interfaz de usuario distintos del componente VideoPlayer, como los componentes ChromelessVideoPlayer o VideoDisplay y MediaControls.
isVid Booleano Debe ser verdadero para todos los reproductores de vídeo.
labels Cadena La dirección URL de un archivo XML que describe el conjunto de etiquetas a utilizar para este reproductor. Consulte Traducción de reproductores para obtener más información sobre cómo crear un archivo del conjunto de etiquetas.
language Enumeración El idioma que se utilizará para las etiquetas predeterminadas del reproductor; puede ser en (inglés), fr (francés), de (alemán), it (italiano), jp (japonés) o es (español). Este valor redefine el ajuste de idioma establecido para el reproductor del módulo de publicación de Video Cloud Studio.
linkBaseURL Cadena La dirección URL base que se utilizará cuando el espectador haga clic en el botón "Share", "Get Link" o "Email" del reproductor. Redefine el valor de linkBaseURL predeterminado y permite establecer un vínculo a la página antecesora del reproductor. Consulte Personalización de la dirección URL del vínculo.
localizedErrorXML Cadena La dirección URL del archivo de mensajes de error de un reproductor. Este archivo XML especifica los mensajes que se visualizarán si se producen errores en un reproductor. Consulte Traducción de los mensajes de error del reproductor.
majorVersion Cadena El número de la versión principal de Flash necesaria. De forma predeterminada, los reproductores de Video Cloud requieren la versión de Flash 9.0.28 o posterior. Para que requieran Flash 10, utilice este parámetro: <param name="majorVersion" value="10" />.
minorRevision Cadena El número de la revisión menor de Flash 9 necesaria. De forma predeterminada, los reproductores de Video Cloud requieren la versión de Flash 9.0.28 o posterior. Para que se exija una versión más reciente de Flash 9, utilice un parámetro como <param name="minorRevision" value="115" />.
playerId Número El identificador (ID) del reproductor. Este parámetro está siendo reemplazado por el parámetro playerKey. Si desea que se cargue otro reproductor en una página, debe cambiar los valores de ambos parámetros playerId y playerKey.
playerKey Cadena Un identificador único para el reproductor, incluyendo una representación cifrada del identificador del reproductor.
secureConnections Booleano Si está establecido en true, impide que un reproductor publicado en una página que utilice HTTPS desencadene advertencias de seguridad. Recuerde que esto sólo suprime los avisos de seguridad; no hará que el reproductor de Brightcove utilice HTTPS. Recuerde también que sólo debe utilizar este ajuste en páginas HTTPS; usarlo en páginas HTTP puede causar errores. Únicamente es aplicable al código de publicación JavaScript. Consulte Publicación de un reproductor de Video Cloud en una página HTTPS para obtener más información.
skipContentCall Booleano Si está establecido en true, impide que se realicen llamadas de contenido cuando se utiliza la Player API solo para Flash para recuperar contenidos.
showNoContentMessage Booleano Si está establecido en true, permite que se muestre un mensaje de advertencia si no se ha asignado contenido al reproductor.
templateErrorHandler Cadena El nombre de una función JavaScript definida por el usuario que deba ejecutarse automáticamente en respuesta a eventos de error del reproductor.
templateLoadHandler Cadena El nombre de una función JavaScript definida por el usuario que deba ejecutarse automáticamente cuando se carga el reproductor. Proporciona un punto de entrada a la Smart Player API.
templateReadyHandler Cadena El nombre de una función JavaScript definida por el usuario que deba ejecutarse automáticamente al producirse eventos de reproductor listo.
videoSmoothing Booleano Redefine el comportamiento de suavizado de vídeo predeterminado del reproductor; si está establecido en true (el valor predeterminado), siempre se aplica el suavizado de vídeo; si está establecido en false, no se aplica nunca. En su ausencia, el reproductor utiliza el suavizado de vídeo.

Parámetros de configuración de reproductores para solicitud de anuncios

Además, los siguientes parámetros de configuración del reproductor modifican el comportamiento de solicitudes de anuncios de un reproductor. Para obtener información sobre estos parámetros, consulte Parámetros de configuración del reproductor para las operaciones publicitarias. Los parámetros de configuración del comportamiento de solicitudes de anuncios de un reproductor son los siguientes:

  • additionalAdTargetingParams
  • adServerURL
  • overrideAds
  • externalAds
  • playlistTargeting

 

Etiquetas
parámetros de configuración, código de publicación