Ajouter des points de repère

Introduction

Les points de repère sont des emplacements spécifiés sur la chronologie vidéo. Lorsque la vidéo est lue, un événement est automatiquement diffusé chaque fois qu'un point de repère est atteint - à l'aide de la Player API, vous pouvez écouter ces événements et prendre les mesures que vous souhaitez. De plus, vous pouvez lire toutes les informations sur les points de repère des métadonnées vidéo stockées dans le player mediainfo objet, ce qui vous permet de marquer les points de repère sur la timeline vidéo d'une certaine manière si vous voulez.

Il existe deux types de points de repère:

• Points d'annonce: ils sont utilisés pour marquer les endroits où une demande d'annonce doit être faite (si la vidéo et player sont activés pour la publicité).
• Points de repère de code: ceux-ci sont utilisés pour prendre des mesures en utilisant le Player API - certaines utilisations typiques sont l'affichage d'une sorte d'appel à l'action (CTA) ou l'affichage d'une image ou d'un texte relatif au contenu vidéo, peut-être sous forme de superposition vidéo ou dans la page autour du player.

Vue d'ensemble

Vous pouvez ajouter des points de repère dans le module Studio Media. Vous pouvez également les ajouter en utilisant le CMS API, qui est la méthode que nous allons utiliser dans cet exemple.

Méthode HTTP

Les points de repère peuvent être ajoutés soit lorsque vous créer la vidéo ou plus tard avec un mise à jour demande. Dans cet exemple, nous les ajouterons à une vidéo existante en faisant un mise à jour vidéo demande, ce qui signifie que vous utiliserez le PATCH méthode.

Endpoint

Le point de terminaison de la demande de mise à jour de la vidéo est:

          https://cms.api.brightcove.com/v1/accounts/account_id/vidéos/video_id

Demander un corps

Le corps de la requête est un objet JSON pouvant contenir de nombreux éléments de métadonnées vidéo. Ici, nous allons juste regarder le cue_points champ, qui est défini sur un tableau d'objets point de repère, comme dans l'exemple suivant:

          {
          "cue_points": [
              {
                "name": "Ad Cue Point",
                "type": "AD",
                "time": 2.0,
                "metadata": null,
                "force_stop": false
              },
              {
                "name": "Code Cue Point",
                "type": "CODE",
                "time": 4.0,
                "metadata": "The metadata might be text or the url for an image to display",
                "force_stop": true
              }
            ]
          }

Champs d'objets point de repère

Voici une description des champs pour les objets de point de repère.

Notes

• Techniquement, le point de repère est actif jusqu’à ce que le prochain point de repère soit atteint - par conséquent, dans le tableau de points de repère que vous pouvez extraire de la Brightcove Player, vous verrez un startTime et endTime ainsi à un time pour le point de repère.

Exemple d'application

Voir le stylo CMS API Exemple: ajouter des points de repère par Brightcove Learning Services ( @rcrooks1969) Sur CodePen.