Asignar contenidos a reproductores mediante programación

Product
Video Cloud
Aplicable a roles
Editor
Versión
Brightcove 5
Edición
Todas
Creado por Chris Howell.

Este documento describe cómo asignar contenidos a reproductores mediante programación en cada uno de los tipos de códigos de publicación de Video Cloud (JavaScript, ActionScript, etiquetas embed de HTML y URL de vínculos).

Una vez que haya cargado el contenido de vídeo y creado los reproductores, deberá asociarlos para que el reproductor correcto reproduzca el contenido de vídeo adecuado. No todas las plantillas de reproductores permiten la asignación de listas de reproducción. Si un reproductor no puede aceptar una lista de reproducción, en el módulo multimedia, contiene la etiqueta "Publique vídeos en este reproductor mediante la función de publicación rápida o las API de Video Cloud."

Conocimientos necesarios

Antes de comenzar, si aún no lo ha hecho, cargue algún contenido en Video Cloud Studio siguiendo los pasos explicados en Introducción al módulo multimedia y en Carga de vídeos con el módulo multimedia. Asimismo, si aún no ha creado ningún reproductor, siga los pasos detallados en Puesta en marcha con Studio: Creación de su primer reproductor de Video Cloud.

Para asignar contenidos a un reproductor, debe definir parámetros en el código de publicación de los reproductores y especificar los vídeos o las listas de reproducción que desea reproducir. Puede utilizar el Id. o el Id. de referencia para especificar los vídeos o las listas de reproducción, pero no puede utilizar ambas opciones en el mismo código de publicación. Existen dos formas de buscar el Id. de vídeo de un vídeo:

  • En el módulo multimedia, identifique el vídeo en Media Library y utilice el valor de la columna Id.
  • Busque el Id. utilizando las Media APIs de Video Cloud. Por ejemplo, puede utilizar el método find_videos_by_text para que se devuelva el Id. de vídeo de un vídeo con un nombre determinado.

Una vez que haya identificado los Id. de los vídeos o las listas de reproducción que desea reproducir en el reproductor, puede asignar el contenido al reproductor de varias formas. El método que elija dependerá de cómo haya publicado el reproductor y de cómo deba controlar los contenidos que se presentan en él. La sintaxis varía en función del tipo de código de publicación que haya utilizado.

También hay otras formas de asignar contenido a los reproductores en el módulo multimedia. Más información al respecto en Asignar contenidos a los reproductores con el módulo multimedia y Publicación rápida de vídeo. También puede utilizar parámetros de configuración en el código de publicación del reproductor para especificar que reproduzca un vídeo específico de una lista de reproducción. Encontrará más información al respecto en Designación de contenidos mostrados en los reproductores.

En este documento aprenderá a asignar vídeos o listas de reproducción únicos a sus reproductores mediante programación en cada uno de los tipos de código de publicación de Video Cloud:

JavaScript

JavaScript: Vídeo único por Id. de vídeo

Para pasar el Id. de vídeo a un reproductor que acepte un vídeo único y que esté publicado con código JavaScript, añada el parámetro siguiente al código de publicación JavaScript:

<param name="@videoPlayer" value="12345" />

donde "12345" es el Id. de vídeo para el vídeo que se reproducirá en el reproductor.

Ejemplo: JavaScript: Vídeo único por Id. de vídeo

El código HTML completo que se utilizaría para publicar el reproductor y asignar la reproducción de un vídeo con el Id. "12345" al cargarse sería:

<script  language="JavaScript" type="text/javascript" src="
http://admin.brightcove.com/js/BrightcoveExperiences.js"></script>
<object id="myPlayer"  class="BrightcoveExperience">
<param name="bgcolor" value="#FFFFFF" />
<param name="width" value="486" />
<param name="height" value="412" />
<param name="playerID" value="1234567890" />
<param name="playerKey" value="AQ~~,AAAAstMe5SE~,5vOZeV6rFDb4JUBomUtNzVLbOfHyhc1i" />
<param name="isVid" value="true" />
<param name="@videoPlayer"  value="12345" />
</object>

JavaScript: Vídeo único por Id. de referencia

Para pasar el Id. de referencia a un reproductor que acepte un vídeo único y que esté publicado con código JavaScript, añada el parámetro siguiente al código de publicación JavaScript:

<param name="@videoPlayer"  value="ref:myVid12345" />

donde "myvid12345" es el Id. de referencia para el vídeo que se reproducirá en el reproductor. Fíjese en cómo debe añadir el prefijo ref: al Id. de referencia.

Ejemplo: JavaScript: Vídeo único por Id. de referencia

El código HTML completo que se utilizaría para publicar el reproductor y asignar la reproducción de un vídeo con el Id. "12345" al cargarse sería:

<script  language="JavaScript" type="text/javascript" src="
http://admin.brightcove.com/js/BrightcoveExperiences.js"></script>
<object id="myPlayer"  class="BrightcoveExperience">
<param name="bgcolor" value="#FFFFFF" />
<param name="width" value="486" />
<param name="height" value="412" />
<param name="playerID" value="1234567890" />
<param name="playerKey" value="AQ~~,AAAAstMe5SE~,5vOZeV6rFDb4JUBomUtNzVLbOfHyhc1i" />
<param name="isVid" value="true" />
<param name="@videoPlayer"  value="ref:myVid12345" />
</object>

JavaScript: Lista de reproducción por Id. de lista de reproducción

Para pasar un Id. de lista de reproducción a un reproductor que acepte varias listas de reproducción y que esté publicado con código JavaScript, añada el parámetro playlistTabs o playlistCombo al código de publicación JavaScript:

<param name="@playlistTabs"  value="6789"/>
<param name="@playlistCombo"  value="6789"/>

donde "6789" es el Id. de lista de reproducción para la lista de reproducción que se reproducirá en el reproductor. Utilice el parámetro de configuración playlistTabs para los reproductores con selección de listas de reproducción con fichas y el parámetro de configuración playlistCombo para reproductores con selección de listas de reproducción de cuadro combinado (desplegable). Para pasar más de un Id. de lista de reproducción, incluya todos los Id. de lista de reproducción separados por comas:

<param name="@playlistTabs"  value="6789,9876,5432"/>

Los reproductores que obtienen los contenidos de un componente List o Tablist, como la plantilla Pantalla panorámica con lista horizontal, sólo aceptan una lista de reproducción única. Para pasar el Id. de lista de reproducción de una lista de reproducción a un reproductor que sólo acepte una lista de reproducción única y que esté publicado con código JavaScript, añada el parámetro videoList al código de publicación JavaScript:

<param name="@videoList" value="6789"/>

Ejemplo: JavaScript: Lista de reproducción por Id. de lista de reproducción

El código HTML completo que se utilizaría para publicar el reproductor y asignar la reproducción de una lista de reproducción con el Id. 6789 al cargarse sería:

<script  language="JavaScript" type="text/javascript"
src="http://admin.brightcove.com/js/BrightcoveExperiences.js"></script>
<object id="myPlayer"  class="BrightcoveExperience">
<param name="bgcolor" value="#FFFFFF" />
<param name="width" value="790" />
<param name="height" value="529" />
<param name="playerID" value="1234567890" />
<param name="playerKey" value="AQ~~,AAAAstMe5SE~,5vOZeV6rFDb4JUBomUtNzVLbOfHyhc1i" />
<param name="isVid" value="true" />
<param name="isUI" value="true" />
<param name="@playlistTabs"  value="6789" />
</object>

JavaScript: Lista de reproducción por Id. de referencia

Para pasar el Id. de referencia de una lista de reproducción a un reproductor que acepte múltiples listas de reproducción y que esté publicado utilizando código JavaScript, añada el parámetro playlistTabs o playlistCombo al código de publicación JavaScript y añada el prefijo ref: al Id. de referencia del valor del parámetro:

<param name="@playlistTabs"  value="ref:myPlaylist6789"/>
<param name="@playlistCombo"  value="ref:myPlaylist6789"/>

donde "myplaylist6789" es el Id. de referencia para la lista de reproducción que se reproducirá en el reproductor. Para pasar más de una lista de reproducción por Id. de referencia, añada el prefijo ref: a una lista separada por comas de los Id. de referencia de todas las listas de reproducción. Asegúrese de que no haya espacios en blanco entre los elementos separados por comas.

<param name="@playlistTabs"  value="ref:myPlaylist6789,yourPlaylist9876,herPlaylist5432"/>

Los reproductores que obtienen los contenidos de un componente List o Tablist, como la plantilla Pantalla panorámica con lista horizontal, sólo aceptan una lista de reproducción única. Para pasar el Id. de referencia de una lista de reproducción a un reproductor que sólo acepte una lista de reproducción única y que esté publicado utilizando código JavaScript, añada el parámetro videoList al código de publicación JavaScript y añada el prefijo ref: al Id. de referencia del valor del parámetro:

<param name="@videoList"  value="ref:myPlaylist6789"/>

Ejemplo: JavaScript: Lista de reproducción por Id. de referencia

El código HTML completo que se utilizaría para publicar el reproductor y asignar la reproducción de una lista de reproducción con el Id. de referencia myPlaylist6789 al cargarse sería:

<script  language="JavaScript" type="text/javascript" 
src="http://admin.brightcove.com/js/BrightcoveExperiences.js"></script>
<object id="myPlayer"  class="BrightcoveExperience">
<param name="bgcolor" value="#FFFFFF" />
<param name="width" value="790" />
<param name="height" value="529" />
<param name="playerID" value="1234567890" />
<param name="playerKey" value="AQ~~,AAAAstMe5SE~,5vOZeV6rFDb4JUBomUtNzVLbOfHyhc1i" />
<param name="isVid" value="true" />
<param name="isUI" value="true" />
<param name="@playlistTabs"  value="ref:myPlaylist6789" />
</object>

ActionScript

ActionScript: Vídeo único por Id. de vídeo

Para pasar el Id. de vídeo al reproductor que acepte un vídeo único y que esté publicado con ActionScript, utilice el parámetro de configuración videoPlayer, como se indica a continuación:

config["@videoPlayer"] = "12345";

donde "12345" es el Id. del vídeo que se reproducirá en el reproductor. Añada este parámetro de configuración al código de publicación ActionScript del reproductor que ha copiado del módulo de publicación.

ActionScript: Vídeo único por Id. de referencia

Para pasar el Id. de referencia de un vídeo al reproductor que acepte un vídeo único y que esté publicado con ActionScript, utilice el parámetro de configuración videoPlayer y añada el prefijo ref: al Id. de referencia, como se indica a continuación:

config["@videoPlayer"] = "ref:myVideo12345";

donde "myVideo12345" es el Id. de referencia del vídeo que se reproducirá en el reproductor. Añada este parámetro de configuración al código de publicación ActionScript del reproductor que ha copiado del módulo de publicación.

ActionScript: Lista de reproducción por Id. de lista de reproducción

Para pasar el Id. de lista de reproducción a un reproductor que acepte múltiples listas de reproducción y que esté publicado con ActionScript, utilice el parámetro de configuración playlistTabs o playlistCombo, como se indica a continuación:

config["@playlistTabs"] = "6789";
config["@playlistCombo"] = "6789";

donde "6789" es el Id. de la lista de reproducción que se reproducirá en el reproductor. Utilice el parámetro de configuración playlistTabs para los reproductores con selección de listas de reproducción con fichas y el parámetro de configuración playlistCombo para reproductores con selección de listas de reproducción de cuadro combinado (desplegable). Añada el parámetro de configuración al código de publicación ActionScript del reproductor que ha copiado del módulo de publicación. Para pasar más de un Id. de lista de reproducción, incluya todos los Id. de lista de reproducción separados por comas:

config["@playlistTabs"] = "6789,9876,5432";

Los reproductores que obtienen los contenidos de un componente List o Tablist, como la plantilla Pantalla panorámica con lista horizontal, sólo aceptan una lista de reproducción única. Para pasar el Id. de lista de reproducción de una lista de reproducción a un reproductor que sólo acepte una lista de reproducción única y que esté publicado con código ActionScript, añada el parámetro videoList al código de publicación ActionScript:

config["@videoList"] = "6789";

ActionScript: Lista de reproducción por Id. de referencia

Para pasar el Id. de referencia de una lista de reproducción a un reproductor que acepte múltiples listas de reproducción y que esté publicado con ActionScript, utilice el parámetro de configuración playlistTabs o playlistCombo y añada el prefijo ref: al Id. de referencia, como se indica a continuación:

config["@playlistTabs"] = "ref:myPlaylist6789";
config["@playlistCombo"] = "ref:myPlaylist6789";

donde "myPlaylist6789" es el Id. de referencia de la lista de reproducción que se reproducirá en el reproductor. Añada este parámetro de configuración al código de publicación ActionScript del reproductor que ha copiado del módulo de publicación. Para pasar más de un Id. de referencia, añada el prefijo ref: a una lista de Id. de referencia separados por comas. Asegúrese de que no haya espacios en blanco entre los elementos separados por comas.

config["@playlistTabs"] = "ref:myPlaylist6789,myPlaylist9876,myPlaylist5432";

Los reproductores que obtienen los contenidos de un componente List o Tablist, como la plantilla Pantalla panorámica con lista horizontal, sólo aceptan una lista de reproducción única. Para pasar el Id. de referencia de una lista de reproducción a un reproductor que sólo acepte una lista de reproducción única y que esté publicado utilizando código ActionScript, añada el parámetro videoList al código de publicación ActionScript y añada el prefijo ref: al Id. de referencia del valor del parámetro:

config["@videoList"] = "ref:myPlaylist6789";

Código HTML para incrustar

Código HTML para incrustar: Vídeo único por Id. de vídeo

Para pasar el Id. de vídeo a un reproductor que acepte un vídeo único y que este incrustado utilizando HTML, añada &@videoPlayer=12345 después de playerID en el código HTML para incrustar, donde "12345" es el Id. del vídeo que desea reproducir (debe añadirse después de las dos apariciones de playerID en el código para incrustar).

Ejemplo: Código HTML para incrustar: Vídeo único por Id. de vídeo

Ejemplo de código HTML para incrustar que fuerza la reproducción de un vídeo con ID = 12345:

<object id="flashObj" width="486" 
     height="412" classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" 
     codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,47,0"> 
   <param name="movie" value="http://c.brightcove.com/services/viewer/federated_f9/19174954001?isVid=1" /> 
   <param name="bgcolor" value="#FFFFFF" /> 
   <param name="flashVars" value="playerID=12345678900&@videoPlayer=12345&domain=embed&" />

   <param name="base" value="http://admin.brightcove.com" /> 
   <param name="seamlesstabbing" value="false" /> 
   <param name="allowFullScreen" value="true" /> 
   <param name="swLiveConnect" value="true" /> 
   <param name="allowScriptAccess" value="always" /> 
   
   <embed src="http://c.brightcove.com/services/viewer/federated_f9/19174954001?isVid=1" 
     bgcolor="#FFFFFF" flashVars="playerID=12345678900&@videoPlayer=12345&domain=embed&" 
     base="http://admin.brightcove.com" name="flashObj" width="486" 
     height="412" seamlesstabbing="false" type="application/x-shockwave-flash" 
     allowFullScreen="true" swLiveConnect="true" 
     allowScriptAccess="always" pluginspage="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash"> 
   </embed>

</object>

Código HTML para incrustar: Vídeo único por Id. de referencia

Para pasar el Id. de referencia de un vídeo a un reproductor que acepte un vídeo único y que esté incrustado utilizando HTML, añada &@videoPlayer=ref:myVideo12345 después de playerID en el código HTML para incrustar, donde "myVideo12345" es el Id. del vídeo que desea reproducir. Debe añadirse después de las dos apariciones de playerID en el código para incrustar.

Código HTML para incrustar: Lista de reproducción por Id. de lista de reproducción

Para pasar el Id. de lista de reproducción a un reproductor que acepte múltiples listas de reproducción y que esté incrustado utilizando HTML, añada &@playlistTabs=6789 o &@playlistCombo=6789 después de playerID en el código HTML para incrustar, donde "6789" es el Id. de la lista de reproducción que desea reproducir. Para pasar más de un Id. de lista de reproducción, incluya todos los Id. de lista de reproducción separados por comas: &@playlistTabs=6789,9876,5432

Si el reproductor sólo acepta una lista de reproducción única, utilice el parámetro @videoList: &@videoList=6789.

Debe añadirse después de las dos apariciones de playerID en el código para incrustar.

Ejemplo: Código HTML para incrustar: Lista de reproducción por Id. de lista de reproducción

Lo siguiente es un ejemplo de código HTML para incrustar que fuerza la reproducción de una lista de reproducción con ID = 6789:

<object id="flashObj" width="486" height="412" 
        classid="clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" 
        codebase="http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=9,0,47,0"> 
    <param name="movie" 
        value="http://c.brightcove.com/services/viewer/federated_f9/19174954001?isVid=1&isUI=1" /> 
    <param name="bgcolor" value="#FFFFFF" /> 
    <param name="flashVars" value="playerID=12345678900&@playlistTabs=6789&domain=embed&" />

    <param name="base" value="http://admin.brightcove.com" /> 
    <param name="seamlesstabbing" value="false" /> 
    <param name="allowFullScreen" value="true" />

    <param name="swLiveConnect" value="true" /> 
    <param name="allowScriptAccess" value="always" /> 
    
    <embed src="http://c.brightcove.com/services/viewer/federated_f9/19174954001?isVid=1&isUI=1" 
      bgcolor="#FFFFFF" flashVars="playerID=12345678900&@playlistTabs=6789&domain=embed&" 
      base="http://admin.brightcove.com" name="flashObj" 
      width="486" height="412" seamlesstabbing="false" 
      type="application/x-shockwave-flash" allowFullScreen="true" 
      swLiveConnect="true" allowScriptAccess="always" 
      pluginspage="http://www.macromedia.com/shockwave/download/index.cgi?P1_Prod_Version=ShockwaveFlash"> 
    </embed>

</object>

Código HTML para incrustar: Lista de reproducción por Id. de referencia

Para pasar el Id. de referencia de una lista de reproducción a un reproductor que acepte múltiples listas de reproducción y esté incrustado mediante HTML, añada lo siguiente:

&@playlistTabs=ref:myPlaylist6789 or &@playlistCombo=ref:myPlaylist6789

Añada este código después de playerID en el código HTML para incrustar, donde "myPlaylist6789" es el Id. de referencia de la lista de reproducción que desea reproducir. Para pasar más de un Id. de referencia, añada el prefijo ref: a una lista de Id. de referencia separados por comas:

&@playlistTabs=ref:myPlaylist6789,myPlaylist9876,myPlaylist5432

Asegúrese de que no haya espacios en blanco entre los elementos separados por comas.

Si el reproductor sólo acepta una lista de reproducción única, utilice el parámetro @videoList parameter: &@videoList=ref:myVideo6789. Debe añadir esto después de las dos apariciones de playerID en el código para incrustar.

Dirección URL del vínculo

Modificación de la dirección URL del reproductor: Vídeo único por Id. de vídeo

Puede incluir el Id. de vídeo en la dirección URL de un reproductor hospedado por Video Cloud añadiendo el sufijo ?bctid=12345 a la dirección URL del reproductor, donde "12345" es el Id. del vídeo que desea reproducir. Por ejemplo:

http://link.brightcove.com/services/player/bcpid0789?bctid=12345

Si hospeda el reproductor utilizando código JavaScript en su propio sitio, también puede modificar la dirección URL para forzar la reproducción de un vídeo en concreto. Añada el sufijo ?bctid=12345 a la dirección URL en la que se hospeda el reproductor, donde "12345" es el Id. del vídeo que desea reproducir. Por ejemplo:

http://www.myexamplesite.com/playerpage.html?bctid=12345

Modificación de la dirección URL del reproductor: Vídeo único por Id. de referencia

Puede usar el ID de referencia de un vídeo en lugar de su ID de vídeo en la URL del reproductor. Añada ?bctid=ref:myvid123 a la dirección URL del reproductor, donde myvid123 corresponde al ID de referencia del vídeo que se desea reproducir. Por ejemplo:

http://link.brightcove.com/services/player/bcpid0789?bctid=ref:myvid123

Si hospeda el reproductor utilizando código JavaScript en su propio sitio, también puede modificar la dirección URL para forzar la reproducción de un vídeo en concreto. Añada ?bctid=ref:myvid123 a la dirección URL del reproductor, donde myvid123 corresponde al ID de referencia del vídeo que se desea reproducir. Por ejemplo:

http://www.myexamplesite.com/playerpage.html?bctid=ref:myvid123

Modificación de la dirección URL del reproductor: Lista de reproducción por Id. de lista de reproducción

Puede incluir el Id. de lista de reproducción en la dirección URL del reproductor hospedado por Brightcove añadiendo el sufijo ?bclid=6789 a la dirección URL del reproductor, donde "6789" es el Id. de la lista de reproducción que se desea reproducir. Por ejemplo:

http://link.brightcove.com/services/player/bcpid0789?bclid=6789

Tenga en cuenta que no puede utilizar esta estrategia para incluir múltiples listas de reproducción en un reproductor.

Si usted aloja en su propio sitio un reproductor utilizando código JavaScript, también puede modificar la dirección URL para forzar la reproducción de una determinada lista de reproducción. Añada el sufijo ?bclid=6789 a la dirección URL en la que se hospeda el reproductor, donde "6789" es el Id. de la lista de reproducción que desea reproducir. Por ejemplo:

http://www.myexamplesite.com/playerpage.html?bclid=6789

Modificación de la dirección URL del reproductor: Lista de reproducción por Id. de referencia

Puede usar el Id. de referencia de una lista de reproducción en lugar de su Id. en la URL del reproductor. Añada ?bclid=ref:mylist123 a la dirección URL del reproductor, donde mylist123 corresponde al identificador de referencia de la lista de reproducción que se desea reproducir. Por ejemplo:

http://link.brightcove.com/services/player/bcpid0789?bclid=ref:mylist123

Si hospeda el reproductor utilizando código JavaScript en su propio sitio, también puede modificar la dirección URL para forzar la reproducción de una determinada lista. Añada ?bctid=ref:mylist123 a la dirección URL del reproductor, donde mylist123 corresponde al identificador de referencia de la lista de reproducción que se desea reproducir. Por ejemplo:

http://www.myexamplesite.com/playerpage.html?bclid=ref:mylist123

Recursos relacionados

Obtenga más información sobre la asignación de contenidos a reproductores en la sección Programación de reproductores.

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