Options disponibles pour le code d'intégration standard (iframe)
Introduction
le iframe Le code d'implémentation du lecteur offre la facilité d'utilisation du lecteur en tant qu'unité unique et contenue. Cela est souvent nécessaire pour les applications et le partage de médias sociaux.
Utilisation
Pour utiliser le iframe code suivez ces étapes:
- Utilisez le JOUEURS module pour créer un lecteur.
- Allez au MÉDIAS module et publiez une vidéo à l'aide du lecteur nouvellement créé.
- Copiez le la norme code intégré. Le code HTML sera similaire à ce qui suit :
<iframe src="https://players.brightcove.net/.../index.html?videoId=6116779877001" allowfullscreen="" allow="encrypted-media" width="960" height="540"></iframe>
- Copiez le code HTML depuis le navigateur et collez-le dans
body
la page HTML complète. - Parcourez la page HTML pour voir le lecteur fonctionne.
Paramètres de requête
De nombreux paramètres de requête sont disponibles pour le iframe tag pour fournir des informations supplémentaires sur la manière dont un joueur doit se comporter. Le tableau ci-dessous détaille les paramètres disponibles.
Paramètre | Description | Type de données |
---|---|---|
adConfigId |
ID de configuration d'annonce SSAI de livraison dynamique. | Chaîne |
applicationId |
Permet la réutilisation d'un joueur unique, mais différencie les analyses par site ou par application. Voir le Ajout d'un ID d'application au code d'intégration du lecteur document pour tous les détails. | Chaîne |
autoplay |
Indique que le joueur doit commencer à jouer immédiatement, sur les plates-formes où cela est autorisé. Si autoplay est défini sur une valeur booléenne, le comportement de lecture automatique natif du navigateur est utilisé. S'il est défini sur l'une des trois valeurs de chaîne valides suivantes, ce qui suit se produit :
Obtenir une vidéo à la lecture automatique peut être une situation complexe. Voir le Considérations sur la lecture automatique document pour plus de détails. |
Booléen ou Chaîne |
crossorigin |
Si vrai , le sous-jacent < vidéo> élément aura crossorigin="anonyme". Cela signifie que toutes les vidéos ou pistes de texte insérées dans le lecteur doivent comporter des en-têtes CORS. | Booléen |
deliveryConfigId |
ID de configuration des règles de livraison dynamique | Chaîne |
language |
Définit la langue (à l'aide d'un code de langue valide, généralement deux lettres) du lecteur. | Chaîne |
loop |
Déclenchez la vidéo dès qu'elle se termine. | Chaîne |
muted |
Met en sourdine le son de la vidéo. | Booléen |
playlistId |
Définit l'ID ou l'ID de référence de la liste de lecture dans le lecteur. | Chaîne |
playlistVideoId |
Définit la vidéo initiale à lire dans la vidéo, qui doit figurer dans la liste de lecture désignée. | Chaîne |
playsinline |
Si la plate-forme et le système d'exploitation le permettent, affichera le contenu vidéo dans la zone de lecture du lecteur, ce qui signifie qu'il ne sera pas affiché en plein écran ou dans une fenêtre indépendante et redimensionnable; fonctionne sur iPhone et iPad | Booléen |
preload |
Indique au navigateur si les données vidéo doivent commencer ou non à télécharger dès le chargement de la balise vidéo. Les valeurs possibles sont none , metadata ou auto . Consultez la section suivante pour plus de détails. |
Chaîne |
referrer |
Vous permet de passer dans le document.referrer ainsi que d'autres paramètres de l'iframe, vous permettant de suivre avec précision l'URL de référence de la vidéo. Notez que vous devrez encoder la valeur par URI - par exemple: referrer=http%3A%2F%2Ffoo.com . Notez également que ce paramètre est disponible pour la version 6.25 du lecteur ou une version ultérieure. |
Chaîne |
t |
Définit le décalage horaire à partir duquel une vidéo va commencer à lire. Voir le Lien profond document pour plus de détails. | Chaîne |
videoId |
Définit l'ID ou l'ID de référence de la vidéo dans le lecteur. | Chaîne |
détails de préchargement
Le paramètre de préchargement indique au navigateur si le téléchargement des données vidéo doit commencer ou non dès que la balise vidéo est chargée. Les options sont automatique, métadonnées et aucune. Pour la technologie de lecture HLS, les paramètres signifient des choses légèrement différentes et indiquées ci-dessous.
-
auto (défaut): Commencez à charger la vidéo immédiatement (si le navigateur est d'accord). Certains appareils mobiles comme les iPhones et les iPads ne préchargeront pas la vidéo afin de protéger la bande passante de leurs utilisateurs. C'est pourquoi la valeur est appelée auto et non pas quelque chose de plus final comme vrai.
-
métadonnées: Chargez uniquement les métadonnées de la vidéo, qui incluent des informations telles que la durée et les dimensions de la vidéo.
-
aucun: Ne préchargez aucune des données vidéo. Cela attendra que l'utilisateur clique sur Lecture pour commencer le téléchargement. Notez que sur iOS, il peut y avoir un téléchargement de segments même avec ce paramètre. Voir le Lecteur Brightcove et iOS document pour plus d'informations.
<video-js preload ...>
or
{ "preload": "auto" }