Programmer l'affectation du contenu aux lecteurs

Product
Video Cloud
S'applique aux utilisateurs
Éditeur
Version
Brightcove 5
Édition
Tous
Créé par Jessica Nutting.

Ce document décrit le processus de programmation de l’affectation de contenu aux lecteurs dans chacun des types de code de publication de Video Cloud (JavaScript, ActionScript, la balise embed HTML et les URL liées).

Une fois le contenu vidéo chargé et les lecteurs créés, vous devrez les lier de façon à ce que les bons lecteurs diffusent le bon contenu. Certains modèles de lecteurs ne prennent pas en charge l’affectation de sélections. Si un lecteur ne peut pas accepter une sélection, l’information sera mentionnée dans le module médias « Publier des vidéos sur ce lecteur avec la Publication rapide ou les API Video Cloud. »

Connaissances requises

Avant de commencer, et, si vous ne l’avez pas encore fait, chargez du contenu dans Video Cloud Studio en suivant les étapes décrites dans Premiers pas avec le module médias et Chargement des vidéos avec le module médias. De même, si vous n'avez pas créé de lecteur, suivez les étapes décrites dans Formation rapide à Studio Jumpstart : Création de votre premier lecteur Video Cloud pour en créer un.

Pour affecter du contenu à un lecteur, vous devez définir les paramètres dans le code de publication pour les lecteurs en spécifiant les vidéos ou les sélections à diffuser. Vous pouvez utiliser l’ID ou l’ID de référence pour spécifier les vidéos ou les sélections, mais vous ne pouvez pas utiliser les deux dans le même code de publication. Il y a deux façons d'obtenir l’ID d’une vidéo :

  • Dans le module médias, localisez la vidéo dans la médiathèque et utilisez la valeur située dans la colonne ID.
  • Vérifiez l’ID avec les API Média Video Cloud. Vous pouvez par exemple utiliser la méthode find_videos_by_text pour retrouver l'ID d'une vidéo avec un nom donné.

Une fois que vous avez retrouvé les ID des vidéos ou sélections à diffuser dans le lecteur, vous pouvez les affecter à votre lecteur de plusieurs façons différentes. La méthode à utiliser dépend de la manière dont vous avez publié le lecteur et de la méthode de contrôle du contenu présenté dans ce dernier. La syntaxe varie en fonction du type de code de publication utilisé.

Il existe également plusieurs autres façons d’affecter du contenu aux lecteurs dans le module médias. Plus d’informations à ce sujet sont disponibles dans les rubriques Affecter du contenu aux lecteurs avec le module médias et Publication rapide de vidéo. Vous pouvez également utiliser les paramètres de configuration dans le code de publication du lecteur pour spécifier que le lecteur doit diffuser une vidéo spécifique dans une sélection. Plus d’informations à ce sujet sont disponibles dans la rubrique Désigner le contenu à mettre en évidence dans les lecteurs.

Dans ce document, vous apprendrez comment affecter des vidéos ou des sélections uniques à vos lecteurs par le biais de programmes, en utilisant chacun des types de code de publication pris en charge par Video Cloud :

JavaScript

JavaScript : vidéo unique par ID

Pour transmettre l’ID d’une vidéo à un lecteur de vidéo unique publié avec JavaScript, ajoutez le paramètre suivant à votre code de publication JavaScript :

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

Où « 12345 » est l’ID de la vidéo à lire.

Exemple : JavaScript : vidéo unique par ID

Le code HTML complet utilisé pour publier le lecteur et affecter une vidéo avec ID « 12345 » à lire au chargement est structuré comme suit :

<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 : vidéo unique par ID de référence

Pour transmettre l’ID de référence d’une vidéo à un lecteur de vidéo unique publié avec JavaScript, ajoutez le paramètre suivant à votre code de publication JavaScript :

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

Où « myvid12345 » est l’ID de référence de la vidéo à lire. Notez que vous devez ajouter ref: devant votre ID de référence.

Exemple : JavaScript : vidéo unique par ID de référence

Le code HTML complet utilisé pour publier le lecteur et affecter une vidéo avec ID « 12345 » à lire au chargement est structuré comme suit :

<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 : sélection par ID de sélection

Pour transmettre l’ID d’une sélection à un lecteur qui accepte plusieurs sélections et qui est publié avec JavaScript, ajoutez les paramètres playlistTabs ou playlistCombo à votre code de publication JavaScript :

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

Où « 6789 » est l’ID de la sélection à lire. Utilisez le paramètre de configuration playlistTabs pour les lecteurs avec une sélection de sélection par onglets et le paramètre de configuration playlistCombo pour les lecteurs avec une sélection de sélection par boîte combinée (liste déroulante). Pour transmettre plus d’un ID de sélection, saisissez chaque ID de sélection séparé par une virgule :

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

Les lecteurs qui reçoivent leur contenu d’un composant List ou TabList, tel que le modèle Écran large avec liste horizontale, n’acceptent qu’une seule sélection. Pour transmettre l’ID d’une sélection à un lecteur qui n’accepte qu’une seule sélection et qui est publié avec JavaScript, ajoutez le paramètre videoList à votre code de publication JavaScript :

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

Exemple : JavaScript : sélection par ID de sélection

Le code HTML complet utilisé pour publier le lecteur et affecter une sélection avec ID « 6789 » à lire au chargement est structuré comme suit :

<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 : Sélection par ID de référence

Pour transmettre l’ID de référence d’une sélection à un lecteur qui accepte plusieurs sélections et qui est publié avec JavaScript, ajoutez les paramètres playlistTabs ou playlistCombo à votre code de publication JavaScript et ajoutez ref: à votre ID de référence dans la valeur du paramètre, comme suit :

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

Où « myplaylist6789 » est l’ID de référence de la sélection à lire. Pour transmettre plus d’une sélection par ID de référence, ajoutez ref: devant une liste des ID de référence séparés par une virgule, et ce pour chacune des sélections. Vérifiez bien qu’il n’y a pas d’espace entre les éléments séparés par une virgule.

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

Les lecteurs qui reçoivent leur contenu d’un composant List ou TabList, tel que le modèle Écran large avec liste horizontale, n’acceptent qu’une seule sélection. Pour transmettre l’ID de référence d’une sélection à un lecteur de sélection unique qui est publié avec JavaScript, ajoutez le paramètre videoList à votre code de publication JavaScript et attachez ref: devant votre ID de référence dans la valeur du paramètre :

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

Exemple : JavaScript : Sélection par ID de référence

Le code HTML complet utilisé pour publier le lecteur et affecter une sélection avec l’ID de référence myPlaylist6789 à lire au chargement est structuré comme suit :

<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 : vidéo unique par ID

Pour transmettre l’ID d’une vidéo à un lecteur de vidéo unique publié avec ActionScript, utilisez le paramètre de configuration videoPlayer comme suit :

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

Où « 12345 » est l’ID de la vidéo à lire. Ajoutez ce paramètre de configuration au code de publication ActionScript pour le lecteur que vous avez copié du module d’édition.

ActionScript : vidéo unique par ID de référence

Pour transmettre l’ID de référence d’une vidéo à un lecteur de vidéo unique publié avec ActionScript, utilisez le paramètre de configuration videoPlayer et attachez ref: devant votre ID de référence, comme suit :

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

Où « myVideo12345 » est l’ID de référence de la vidéo à lire. Ajoutez ce paramètre de configuration au code de publication ActionScript pour le lecteur que vous avez copié du module d’édition.

ActionScript : sélection par ID de sélection

Pour transmettre l’ID d’une sélection à un lecteur qui accepte plusieurs vidéos et qui est publié avec ActionScript, utilisez les paramètres de configuration playlistTabs ou playlistCombo, comme suit :

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

Où « 6789 » est l’ID de la sélection à lire. Utilisez le paramètre de configuration playlistTabs pour les lecteurs avec une sélection de sélection par onglets et le paramètre de configuration playlistCombo pour les lecteurs avec une sélection de sélection par boîte combinée (liste déroulante). Ajoutez ce paramètre de configuration au code de publication ActionScript pour le lecteur que vous avez copié du module d’édition. Pour transmettre plus d’un ID de sélection, saisissez chaque ID de sélection séparé par une virgule :

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

Les lecteurs qui reçoivent leur contenu d’un composant List ou TabList, tel que le modèle Écran large avec liste horizontale, n’acceptent qu’une seule sélection. Pour transmettre l’ID d’une sélection à un lecteur qui n’accepte qu’une seule sélection et qui est publié avec ActionScript, ajoutez le paramètre videoList à votre code de publication ActionScript, comme suit :

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

ActionScript : Sélection par ID de référence

Pour transmettre l’ID de référence d’une sélection à un lecteur qui accepte plusieurs sélections et qui est publié avec ActionScript, utilisez les paramètres de configuration playlistTabs ou playlistCombo et attachez ref: devant votre ID de référence, comme suit :

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

Où « myPlaylist6789 » est l’ID de référence de la sélection à lire. Ajoutez ce paramètre de configuration au code de publication ActionScript pour le lecteur que vous avez copié du module d’édition. Pour transmettre plus d’un ID de référence, attachez ref: devant une liste d’ID de référence séparés par une virgule. Vérifiez bien qu’il n’y a pas d’espace entre les éléments séparés par une virgule.

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

Les lecteurs qui reçoivent leur contenu d’un composant List ou TabList, tel que le modèle Écran large avec liste horizontale, n’acceptent qu’une seule sélection. Pour transmettre l’ID de référence d’une sélection à un lecteur de sélection unique qui est publié avec ActionScript, ajoutez le paramètre videoList à votre code de publication ActionScript et attachez ref: devant l’ID de référence de la sélection :

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

HTML embarqué

HTML embarqué : vidéo unique par ID

Pour transmettre l’ID d’une vidéo à un lecteur de vidéo unique qui est intégré via HTML, ajoutez &@videoPlayer=12345 à la suite de l’ID du lecteur dans le code HTML embarqué, où « 12345 » est l’ID de la vidéo à lire. Cela doit être répété après chaque occurrence de PlayerID dans le code embarqué.

Exemple : HTML embarqué : vidéo unique par ID

Échantillon de code HTML à intégrer pour forcer la lecture d’une vidéo avec l’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>

HTML embarqué : vidéo unique par ID de référence

Pour transmettre l’ID de référence d’une vidéo à un lecteur de vidéo unique intégré via HTML, attachez &@videoPlayer=ref:myVideo12345 après playerID dans le code HTML embarqué, où « myVideo12345 » est l’ID de la vidéo à lire. Cela doit être répété après chaque occurrence de playerID dans le code embarqué.

HTML embarqué : sélection par ID de sélection

Pour transmettre l’ID d’une sélection à un lecteur qui accepte plusieurs sélections et qui est intégré via HTML, attachez &@playlistTabs=6789 ou &@playlistCombo=6789 après playerID dans le code HTML embarqué, où « 6789 » est l’ID de la sélection à lire. Pour transmettre plus d’un ID de sélection, saisissez chaque ID de sélection séparé par une virgule : &@playlistTabs=6789,9876,5432

Si votre lecteur n’accepte qu’une seule sélection, utilisez le paramètre @videoList à la place : &@videoList=6789.

Cela doit être répété après chaque occurrence de playerID dans le code embarqué.

Exemple : HTML embarqué : sélection par ID de sélection

Voici un échantillon de code HTML à intégrer pour forcer la lecture d’une sélection avec l’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>

HTML embarqué : Sélection par ID de référence

Pour transmettre l’ID de référence d’une sélection à un lecteur qui accepte plusieurs sélections et qui est intégré via HTML, ajoutez ce qui suit :

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

Attachez ce code après playerID dans le code HTML embarqué, où « myPlaylist6789 » est l’ID de référence de la sélection à lire. Pour transmettre plus d’un ID de référence, attachez ref: devant une liste d’ID de référence séparés par une virgule, comme suit :

&@playlistTabs=ref:myPlaylist6789,myPlaylist9876,myPlaylist5432

Vérifiez bien qu’il n’y a pas d’espace entre les éléments séparés par une virgule.

Si votre lecteur n’accepte qu’une seule sélection, utilisez le paramètre @videoList parameter à la place, comme suit : &@videoList=ref:myVideo6789.Cela doit être répété après chaque occurrence de playerID dans le code embarqué.

URL liée

Modification de l’URL du lecteur : vidéo unique par ID

Vous pouvez inclure l’ID d'une vidéo dans l’URL d’un lecteur hébergé par Video Cloud en attachant ?bctid=12345 à l’URL, où « 12345 » est l’ID de la vidéo à lire. Par exemple :

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

Si vous hébergez le lecteur avec un code JavaScript sur votre propre site, vous pouvez également modifier l’URL pour forcer la lecture d’une vidéo en particulier. Attachez ?bctid=12345 à l’URL où le lecteur est hébergé, où « 12345 » est l’ID de la vidéo à lire. Par exemple :

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

Modification de l’URL du lecteur : vidéo unique par ID de référence

Vous pouvez utiliser l'ID de référence d'une vidéo au lieu de son ID vidéo dans l'URL du lecteur. Ajoutez ?bctid=ref:myvid123 à l'URL du lecteur, où myvid123 est l'ID de référence de la vidéo à lire. Par exemple :

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

Si vous hébergez le lecteur avec un code JavaScript sur votre propre site, vous pouvez également modifier l’URL pour forcer la lecture d’une vidéo en particulier. Ajoutez ?bctid=ref:myvid123 à l'URL du lecteur, où myvid123 est l'ID de référence de la vidéo à lire. Par exemple :

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

Modification de l’URL du lecteur : sélection par ID de sélection

Vous pouvez inclure l’ID d'une sélection dans l’URL d’un lecteur hébergé par Brightcove en attachant ?bclid=6789 à l’URL du lecteur, où « 6789 » est l’ID de la sélection à lire. Par exemple :

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

Cette approche ne permet pas d'inclure plusieurs sélections dans un lecteur.

Si vous hébergez le lecteur avec un code JavaScript sur votre propre site, vous pouvez également modifier l’URL pour forcer la lecture d’une sélection en particulier. Attachez ?bctid=6789 à l’URL où le lecteur est hébergé, où « 6789 » est l’ID de la sélection à lire. Par exemple :

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

Modification de l’URL du lecteur : Sélection par ID de référence

Vous pouvez utiliser l'ID de référence d'une sélection dans l'URL du lecteur au lieu de son ID de sélection. Ajoutez ?bclid=ref:mylist123 à l'URL du lecteur, où mylist123 est l'ID de référence de la sélection à lire. Par exemple :

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

Si vous hébergez le lecteur avec un code JavaScript sur votre propre site, vous pouvez également modifier l’URL pour forcer la lecture d’une sélection en particulier. Ajoutez ?bctid=ref:mylist123 à l'URL du lecteur, où mylist123 est l'ID de référence de la sélection à lire. Par exemple :

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

Ressources connexes

Pour en savoir plus sur l’affectation de contenu aux lecteurs, consultez la rubrique Programmation des lecteurs.

Balises
param de config, code d'édition