Paramètres de configuration du lecteur

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

Vous pouvez paramétrer certains aspects du comportement d’un lecteur Video Cloud en éditant le code de publication du lecteur. Cette rubrique de référence liste les paramètres de configuration du lecteur pris en charge par Video Cloud. Elle présente également les différentes syntaxes utilisées pour spécifier les paramètres de configuration de lecteur en code JavaScript, ActionScript et HTML embarqué.

La configuration de paramètres de lecteur peut être utile lorsqu'une même instance de lecteur doit se comporter différemment à deux endroits différents.

Dans cette rubrique, vous en apprendrez plus sur les sujets suivants :

Syntaxe des paramètres de configuration de lecteur en code JavaScript, ActionScript et HTML embarqué

Le nom des paramètres de configuration reste le même, quel que soit le code de publication employé, alors que la syntaxe varie selon qu’il s’agisse de JavaScript, ActionScript ou HTML embarqué. En savoir plus sur les codes de publication de lecteur.

Paramètres de configuration du code de publication JavaScript

Si vous utilisez JavaScript, intégrez les paramètres de configuration entre les balises <object> dans le code de publication du lecteur. Les paramètres de configuration JavaScript prennent la forme suivante :

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

Paramètres de configuration du code de publication ActionScript

Si vous utilisez ActionScript, intégrez les paramètres de configuration dans la fonction init dans le code de publication du lecteur. Les paramètres de configuration ActionScript prennent la forme suivante :

config["param_name"] = "param_value";

Paramètres de configuration du code de publication HTML embarqué

Si vous utilisez le HTML embed, intégrez les paramètres de configuration dans le paramètre flashVars dans le code de publication du lecteur. Les paramètres de configuration HTML embed prennent la forme suivante :

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

Paramètres de configuration de lecteur pris en charge

Le tableau suivant liste les paramètres de configuration de lecteur pris en charge par Video Cloud. Tous ces noms de paramètres respectent la casse. Les paramètres utilisés pour les lecteurs Brightcove ActionScript 2 (créés avec la console Brightcove ou avant la sortir de Brightcove 3) ne fonctionnent pas dans les lecteurs Video Cloud ActionScript 3.

Paramètre Type Description
@videoPlayer Chaîne L’ID ou le refid d’une vidéo à programmer dans le lecteur. Consultez la rubrique Programmer l'affectation du contenu aux lecteurs.
@playlistTabs Chaîne L’ID ou le refid d’une ou de plusieurs sélections à programmer dans un lecteur qui utilise des onglets pour les sélections. Consultez la rubrique Programmer l'affectation du contenu aux lecteurs.
@playlistCombo Chaîne L’ID ou le refid d’une ou de plusieurs sélections à programmer dans un lecteur qui utilise une boîte combinée (liste déroulante) pour les sélections. Consultez la rubrique Programmer l'affectation du contenu aux lecteurs.
@videoList Chaîne L’ID ou le refid d’une sélection à programmer dans le lecteur. Consultez la rubrique Désignation du contenu à mettre en évidence.
width Nombre La largeur totale du lecteur, en pixels.
height Nombre La hauteur totale du lecteur, en pixels.
autoStart Booléen Si true, la vidéo se lance automatiquement au chargement du lecteur.
bgcolor Chaîne Une représentation hexadécimale à six caractères de la couleur d’arrière-plan du lecteur. Par exemple, bgcolor = "#FFFFFF;" (par défaut) représente la couleur blanche. Si vous ne configurez pas ce paramètre, le lecteur aura un arrière-plan blanc jusqu’à son chargement complet, ce qui n’est peut-être pas de votre goût. Nous vous suggérons de faire correspondre la couleur d’arrière-plan à la couleur de la page dans laquelle se charge le lecteur.
dynamicStreaming Booléen Si true (par défaut), le lecteur peut profiter des fonctionnalités de diffusion en continu fluide de Flash Media Server 3.5 et Flash Player 10. Voir Diffusion en continu dynamique.
includeAPI Booléen Doit être « true » pour pouvoir utiliser l'API de lecteur intelligent avec ce lecteur.
isUI Booléen Doit être true pour les lecteurs vidéo dont les modèles comprennent des éléments UI (interface utilisateur) autres que le composant VideoPlayer, tels que les composants ChromelessVideoPlayer ou VideoDisplay et MediaControls.
isVid Booléen Doit être true pour tous les lecteurs vidéo.
labels Chaîne L’URL du fichier XML qui décrit le jeu d’étiquettes à utiliser pour ce lecteur. Consultez la rubrique Localisation des lecteurs pour plus d’informations sur la création d’un fichier de jeu d’étiquettes.
language Enum La langue des étiquettes par défaut du lecteur : en (anglais), fr (français), de (allemand), it (italien), jp (japonais) ou es (espagnol). Cette valeur est prioritaire sur le paramètre de langue défini pour ce lecteur dans le module d’édition de Video Cloud Studio.
linkBaseURL Chaîne L’URL de base à utiliser lorsque le spectateur clique sur les boutons « Partager », « Obtenir le lien » ou « Email » dans le lecteur. Elle a priorité sur le linkBaseURL par défaut et peut être liée à la page parente du lecteur. Consultez la rubrique Personnalisation de l’URL liée.
localizedErrorXML Chaîne L’URL d’un fichier de message d’erreur du lecteur. Ce fichier XML spécifie le message à afficher en cas d’erreurs. Consultez la rubrique Localisation des messages d’erreur des lecteurs.
majorVersion Chaîne Le numéro de version principal de Flash requis. Par défaut, les lecteurs Video Cloud nécessitent Flash version 9.0.28 ou ultérieure. Pour inclure Flash 10, utilisez le paramètre suivant : <param name="majorVersion" value="10" />.
minorRevision Chaîne Le numéro de version précis de Flash requis. Par défaut, les lecteurs Video Cloud nécessitent Flash version 9.0.28 ou ultérieure. Pour une version ultérieure de Flash 9, utilisez un paramètre tel que <param name="minorRevision" value="115" />.
playerId Nombre L'identifiant du lecteur. Ce paramètre est en cours de remplacement par le paramètre playerKey. Si vous voulez modifier le lecteur apparaissant sur une page, modifiez les valeurs des paramètres playerId et playerKey.
playerKey Chaîne L'identifiant unique du lecteur qui inclut une représentation chiffrée de celui-ci.
secureConnections Booléen Si true, empêche le lecteur publié sur une page HTTPS de déclencher des alertes de sécurité. Ce paramètre ne fait qu’empêcher les alertes de sécurité, le lecteur n'utilise pas le HTTPS pour autant. Veuillez noter également que ce paramètre n’est conseillé que pour les pages HTTPS ; l’usage de ce paramètre pour des pages HTTP pourrait générer des erreurs. Ce paramètre ne concerne que le code JavaScript. Consultez la rubrique Publication d’un lecteur Video Cloud sur une page HTTPS pour plus d’informations.
skipContentCall Booléen Si true, et si vous utilisez l’API de lecteur Flash pour retrouver du contenu, ce paramètre interdit les appels de contenu.
showNoContentMessage Booléen Si true, active l’affichage d’un message d’avertissement si aucun contenu n’a été affecté au lecteur.
templateErrorHandler Chaîne Le nom d'une fonction JavaScript définie par l'utilisateur qui sera invoquée automatiquement en réponse à des événements d'erreur du lecteur.
templateLoadHandler Chaîne Le nom d'une fonction JavaScript définie par l'utilisateur qui sera invoquée automatiquement lors du chargement du lecteur. C'est un point d'entrée pour l'API de lecteur intelligent.
templateReadyHandler Chaîne Le nom d'une fonction JavaScript définie par l'utilisateur qui sera invoquée automatiquement lors des événements où le lecteur est prêt.
videoSmoothing Booléen Remplace le comportement de lissage de la vidéo par défaut pour le lecteur ; si « true » (par défaut), applique automatiquement le lissage de vidéo et si false, n’applique pas le lissage de vidéo. Si ce paramètre n’est pas présent, le lecteur utilise le lissage vidéo.

Paramètres de configuration de lecteur pour les demandes de publicité

Les paramètres de configuration de lecteur suivants modifient le comportement du lecteur face aux demandes de publicité. Pour plus d’informations, consultez la rubrique Paramètres de configuration de lecteur pour les opérations publicitaires. Les paramètres de configuration pour le comportement face aux demandes de publicités comprennent les paramètres suivants :

  • additionalAdTargetingParams
  • adServerURL
  • overrideAds
  • externalAds
  • playlistTargeting

 

Balises
param de config, code d'édition