Exemple de joueur Brightcove : Tu regardes toujours ?

Exemple de lecteur

Dans cet exemple, vous verrez après un laps de temps défini, un message de superposition s'affiche. Cet exemple affichera la superposition dans 6 secondes, mais l'heure est configurable. Si le spectateur clique sur le message dans un délai spécifié, la lecture se poursuit. Sinon, la vidéo est mise en pause. Cette technique est utile si vous avez un contenu de longue durée. Cela vous évitera de gaspiller de la bande passante sur les téléspectateurs qui commencent à lire une vidéo puis partent faire autre chose sans se soucier de l'arrêter.

Cet exemple utilise un plugin Open Source Video.js situé à l'adresse https://github.com/TylerZubke/Videojs-AFK-Monitor. L'exemple de code dans ce document utilisera ce plugin.

Voir le stylo Regardez-vous toujours? par Brightcove Learning Services ( rcrooks1969 ) sur CodePen.

Code source

Voir le solution complète sur GitHub.

Utilisation du CodePen

Voici quelques conseils pour utiliser efficacement le CodePen ci-dessus :

  • Basculez l'affichage réel du joueur en cliquant sur le Result bouton.
  • Cliquez sur les HTML/CSS/JS boutons pour afficher L'UN des types de code.
  • Plus loin dans ce document, la logique, le flux et le style utilisés dans l'application seront discutés dans la configuration Plateur/HTML, le flux d'application et le style de l'application. sections. La meilleure façon de suivre les informations contenues dans ces sections est de :
    1. Cliquez sur le EDIT ON CODEPEN bouton dans le CodePen et ayez le code disponible dans un onglet navigateur/navigateur.
    2. Dans CodePen, réglez le code que vous souhaitez afficher. Vous pouvez modifier la largeur de différentes sections de code dans CodePen.
    3. Voir le Configuration du lecteur/HTML , Flux de candidature et/ou Style d'application sections dans un autre navigateur/onglet de navigateur. Vous pourrez maintenant suivre les explications du code et en même temps afficher le code.

Séquence de développement

Voici la séquence de développement recommandée :

  1. Utilisez l'implémentation du lecteur intégré In-Page pour tester les fonctionnalités de votre lecteur, de votre plugin et de votre CSS (si CSS est nécessaire)
  2. Placez le JavaScript et le CSS du plugin dans des fichiers séparés pour des tests locaux
  3. Déployez le code du plugin et le CSS sur votre serveur une fois que vous avez corrigé des erreurs.
  4. Utilisez Studio pour ajouter le plugin et le CSS à votre lecteur
  5. Remplacez l'implémentation du lecteur intégré dans la page si vous déterminez que l'implémentation iframe est mieux adaptée (détaillée dans la section suivante)

Pour plus de détails sur ces étapes, consultez la section étape par étape : Guide de développement de plug-ins.

Intégrer iFrame ou In-Page

Lorsque vous développez des améliorations pour Brightcove Player, vous devrez décider si le code convient le mieux à l'implémentation intégrée iframe ou In-Page. La recommandation des meilleures pratiques consiste à créer un plugin à utiliser avec une implémentation iframe. Les avantages de l'utilisation du lecteur iframe sont les suivants :

  • Aucune collision avec JavaScript et/ou CSS existants
  • Réactif automatiquement
  • L'iframe facilite l'utilisation dans les applications de médias sociaux (ou lorsque la vidéo devra « voyager » dans d'autres applications)

Bien que l'intégration du lecteur d'intégration dans la page puisse être plus complexe, il y a des moments où vous planifiez votre code autour de cette implémentation. Pour généraliser, cette approche est préférable lorsque la page contenante doit communiquer avec le lecteur. En particulier, voici quelques exemples :

  • Le code dans la page contenant doit écouter et agir sur les événements du joueur
  • Le lecteur utilise des styles de la page contenante
  • L'iframe entraînera l'échec de la logique de l'application, comme une redirection à partir de la page contenant

Même si votre implémentation finale n'utilise pas le code iframe, vous pouvez toujours utiliser le code intégré 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.

Ressources API/Plugin utilisées

Méthodes API Événements API Plugins de lecteur Brightcove
AddClass () utilisateur actif Plugin de superposition
RemoveClass () utilisateur inactif  
pause ()    
Heure actuelle ()    
un ()    
au()    
setTimeout ()    
hasClass ()    
durée ()    
mis en pause ()    
clearTimeout ()    
a commencé()    
el ()    

Configuration du lecteur/HTML

Cette section détaille toute configuration spéciale nécessaire lors de la création du lecteur. En outre, d'autres éléments HTML qui doivent être ajoutés à la page, au-delà du code d'implémentation du lecteur intégré dans la page, sont décrits.

Configuration du lecteur

Aucune configuration spéciale n'est requise pour le lecteur Brightcove que vous créez pour cet exemple.

Autre HTML

Les fichiers CSS et JavaScript du plugin tiers sont inclus.

Flux d'application

La logique de base derrière cette application est la suivante :

  • le useractive et userinactive les événements sont surveillés pour suivre le temps.
  • La superposition s'affiche après l'heure spécifiée pour voir si le client regarde toujours la vidéo.
  • Lorsque la superposition a été affichée pendant la durée que vous spécifiez et que vous n'avez pas cliqué sur le texte, mettez la vidéo en pause.
  • Lorsque vous cliquez sur le bouton ou que le spectateur démarre la vidéo après une pause, réinitialisez les valeurs et recommencez le suivi du temps.

Cet exemple utilise le plugin

Le plugin est appelé en utilisant les meilleures pratiques, comme indiqué ici

  <script>
    videojs.getPlayer('myPlayerID').ready(function() {
      var myPlayer = this;
      var options = {'showMessageAfter': 1000, 'pausePlayerAfter': 1000};
      myPlayer.AFKMonitor(options);
    });
  </script>

Configurer le plugin

Un certain nombre d'options peuvent être utilisées pour personnaliser le plugin. Quelques détails sont:

  • Une liste complète des options de configuration se trouve dans le plugin Lisez-moi fichier.
  • le showMessageAfter (en millisecondes) détermine le délai avant l'affichage du bouton.
  • le pausePlayerAfter (en millisecondes) est également utile. C'est le moment où vous autorisez l'utilisateur à cliquer sur le bouton avant que le lecteur ne soit mis en pause. Cela donne à l'utilisateur la possibilité de cliquer sur le bouton sans interrompre la lecture vidéo.

Style d'application

Le CSS fait partie du plugin tiers.

Code du plug-in

Vous voudrez cloner le dépôt pour accéder au code, puis le placer dans un emplacement accessible par Internet pour votre utilisation.

Comme mentionné précédemment, vous pouvez voir le code JavaScript du plugin dans le référentiel GitHub correspondant de ce document: videojs.afk-monitor.js.

Utilisation du plugin avec un lecteur

Une fois que les fichiers CSS et JavaScript du plugin sont stockés dans un emplacement accessible à Internet, vous pouvez utiliser le plugin avec un lecteur. Dans les studios JOUEURS module, vous pouvez choisir un joueur, puis dans le PLUGINS section ajouter les URL aux fichiers CSS et JavaScript, et également ajouter le Nom et Options , si des options sont nécessaires.