Options disponibles pour le code d'intégration standard (iframe)

Dans cette rubrique, vous découvrirez l'utilisation et la configuration du iframe code intégré. Cette version de l'implémentation du lecteur est également appelée la norme code du joueur.

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:

  1. Utilisez le JOUEURS module pour créer un lecteur.
  2. Allez au MÉDIAS module et publiez une vidéo à l'aide du lecteur nouvellement créé.
  3. 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>
  4. Copiez le code HTML depuis le navigateur et collez-le dans body la page HTML complète.
  5. 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 :
  • play: Le joueur essaiera manuellement d'appeler la lecture.
  • muted: Le joueur éteindra manuellement le joueur et appelle la lecture.
  • any: Le joueur essaiera d'abord d'appeler le jeu. Si cela échoue, coupez le lecteur et appelez la lecture.
Si l'un des éléments ci-dessus échoue, le joueur affiche le « Big Play Button » comme si la lecture automatique était définie sur false.

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" }