CV multi-appareils avec Brightcove Player

Aperçu

La reprise inter-appareils permet aux spectateurs de commencer à regarder une vidéo sur un appareil et de la reprendre ultérieurement là où ils l'ont laissée, sur le même appareil ou sur un appareil différent.

Disons que quelqu'un commence à regarder une vidéo sur son appareil mobile. Plus tard, ils peuvent continuer à regarder la même vidéo avec un lecteur sur leur navigateur Web. La lecture se poursuivra là où elle s'était arrêtée, pour ne rien manquer.

Si vous n'êtes pas familier avec cette fonctionnalité, reportez-vous à l' aperçu : CV multi-appareils document.

Exigences

Les exigences suivantes s'appliquent au CV multi-appareil:

• Brightcove Player version 6.41.0+

Configuration

Cette fonctionnalité est disponible pour toute personne disposant d'un compte Brightcove Video Cloud.

Pour commencer, procédez comme suit :

• Contactez votre responsable de compte pour activer votre compte pour le CV multi-appareils
• Assurez-vous que les vidéos que vous utilisez sont ingérées pour la diffusion dynamique

Implémentation d'un CV multi-appareils

Pour implémenter la reprise multi-appareils, procédez comme suit:

1. Définir l'identifiant de l'utilisateur dans Brightcove Analytics
2. Obtenir la position de lecture du spectateur
3. Reprendre la lecture sur un lecteur Brightcove

Envoi de l'identifiant du spectateur - Lecteur Brightcove

Tout d'abord, vous devez définir l'identifiant de l'utilisateur pour stocker son activité de visualisation.

Lecteur Brightcove

Si vous utilisez Brightcove Player, procédez comme suit:

1. Même si les données de la visionneuse sont envoyées automatiquement à Brightcove Analytics, vous devez définir l'identifiant de l'utilisateur. Pour ce faire, utilisez la setUser() méthode. Par exemple :

   myPlayer.bcAnalytics.client.setUser('viewer id');

   Sur vos sites Web hébergeant Brightcove Player, vous pouvez utiliser une passerelle d'authentification ou une solution de gestion des identités pour suivre les spectateurs. Utilisez cet identifiant de visionneuse comme identifiant de visionneuse pour passer à Brightcove Analytics.

2. Il est important de définir l'identifiant du spectateur avant de définir une source sur le lecteur. Il doit être appelé immédiatement après l'initialisation du lecteur.

   <video-js
     id="myPlayerID"
     data-account="1752604059001"
     data-player="hyQW6GByl"
     data-embed="default"
     controls=""
     data-video-id="6156696074001"
     data-playlist-id=""
     data-application-id=""
     width="640" height="360"></video-js>
   <script src="https://players.brightcove.net/1752604059001/hyQW6GByl_default/index.min.js"></script>
   
   <script>
     videojs.getPlayer('myPlayerID').ready(function() {
       var myPlayer = this;
   
       // Set the viewer id for Brightcove analytics
       myPlayer.bcAnalytics.client.setUser('viewer id');
     });
   </script>

3. Quand le setUser() est utilisée, la valeur n'est pas hachée et sera envoyée en clair avec toutes les balises suivantes.

   Notez que le player_init l'événement n'inclura pas le user champ dans ce cas, mais tous video_* les événements devraient l'inclure.

Lecteur web personnalisé

Si vous créez une implémentation personnalisée qui n'utilise pas Brightcove Player, ajoutez le user paramètre à vos demandes d'API de collecte de données. Pour plus de détails, consultez la présentation : API de collecte de données v2 document.

Sur vos sites Web qui hébergent votre lecteur, vous pouvez utiliser une passerelle d'authentification ou une solution de gestion des identités pour suivre les spectateurs. Utilisez cet identifiant de visionneuse comme identifiant de visionneuse pour passer à Brightcove Analytics.

Ce user Le paramètre passé à Brightcove peut être utilisé dans la section suivante pour récupérer la position de lecture à partir de l'API XDR.

Obtenir la position de lecture du spectateur

Ensuite, vous obtiendrez la position de lecture du spectateur à partir de l'API Cross-Device Resume (XDR).

Vous aurez besoin d'une application côté serveur pour effectuer la demande d'API REST afin d'obtenir la position de lecture du spectateur.

Pour plus de détails, consultez le Obtenir la position de lecture à partir de l'API XDR document.

Reprendre la lecture

Une fois que vous avez obtenu la position de lecture de la visionneuse à partir de l'API XDR, vous pouvez reprendre la lecture à partir de ce point.

1. Avec la position de lecture de la visionneuse de la section précédente, définissez la position de la tête de lecture à l'aide du currentTime() méthode.

   Voici un exemple :

   // The specific event to use may require some experimentation
   player.on('loadstart', function() {
   
     // This initialPlayhead variable will have to come from the publisher's
     // custom integration.
     player.currentTime(viewer playhead position);
   });

2. Pour un exemple de lecteur Web qui appelle un proxy côté serveur pour obtenir la tête de lecture à partir de l'API XDR, consultez le Exemple de CV multi-appareils sur github.