Choix du bon code d'intégration

Cette rubrique fournit une vue d'ensemble des types de code d'intégration disponibles lors de la publication de vidéos à l'aide de Brightcove Player.

Lorsque vous publiez des vidéos à l'aide du module Media, vous pouvez utiliser l'URL du lecteur pour prévisualiser la vidéo ou copier le code d'intégration iframe ou In-Page à coller dans votre page Web ou application.

Les Standard Le lien affiche le code d'intégration iframe et le Avancée Le lien affiche le code d'intégration In-Page. Du point de vue de l'API de gestion des joueurs, vous verrez également le Avancée code du joueur appelé le embed_in_page la mise en oeuvre.

code d'intégration iFrame (Standard)

Le code intégré iframe typique apparaîtra comme suit :

<iframe src="https://players.brightcove.net/1507807800001/rf1BTdKk6M_default/index.html?videoId=6116779877001"
  allowfullscreen=""
  allow="encrypted-media"
  width="960" height="540"></iframe>

Quelques avantages de l'utilisation du code d'intégration iframe

  • Aucune collision avec JavaScript et/ou CSS existants
  • Réactif automatiquement
  • L'iframe facilite l'utilisation dans les applications de médias sociaux ou chaque fois que la vidéo devra être utilisée dans un environnement extérieur ; par exemple, Facebook perçoit que la menace de sécurité est beaucoup moins importante lorsque l'iframe est utilisé que la mise en place de l'option <video> balise et JavaScript associé sur leur site (ce que Facebook n'autorise pas)

Code intégré dans la page (Avancé)

Le code intégré typique de la page s'affiche comme suit :

<video-js data-account="1507807800001"
  data-player="rf1BTdKk6M"
  data-embed="default"
  controls=""
  data-video-id="6116779877001"
  data-playlist-id=""
  data-application-id=""
  width="960" height="540"></video-js>
<script src="https://players.brightcove.net/1507807800001/rf1BTdKk6M_default/index.min.js"></script>

Bien que l'intégration du code de publication dans la page puisse être plus complexe, il est préférable d'utiliser le code In-Page lorsque la page contenant le lecteur doit communiquer avec le lecteur. Voici quelques exemples pour savoir quand utiliser le code intégré dans la page :

  • Le code de la page contenant doit écouter et agir sur les événements des joueurs.
  • Le lecteur utilise des styles de la page parente
  • Le code iframe entraîne l'échec de la logique de l'application, comme une redirection à partir de la page parente

Même si votre implémentation finale n'utilise pas le code intégré iframe, vous pouvez toujours utiliser le code In-Page avec un plugin pour votre JavaScript et un fichier séparé pour votre CSS. Cela encapsule votre logique afin que vous puissiez facilement l'utiliser sur plusieurs joueurs.

Recommandation

La meilleure pratique consiste à utiliser l'implémentation standard (iframe) à moins que la logique de l'application ne nécessite l'utilisation du code avancé (dans la page). Si vous utilisez le module Audience pour suivre l'engagement des spectateurs, le code d'intégration avancé (dans la page) doit être utilisé.