Ajout de marqueurs temporels

Introduction

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

Il existe deux types de points de repère :

• Points de repère publicitaire : ils sont utilisés pour marquer les endroits où une demande de publicité doit être faite (si la vidéo et le lecteur sont activés pour la publicité).
• Points de repère de code : ils sont utilisés pour effectuer des actions à l'aide de l'API Player - certains usages 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 lecteur.

Exemple d'application

Voir le stylo Exemple d'API CMS : Ajouter des points de repère par Brightcove Learning Services ( @rcrooks1969 ) au Stylo de code.

Présentation de la mise

Vous pouvez ajouter des points de repère dans le module Studio Média. Vous pouvez également les ajouter à l'aide de l'API CMS, qui est la méthode que nous utiliserons dans cet exemple.

Méthode HTTP

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

Point de terminaison

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

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

Corps de la demande

Le corps de la requête est un objet JSON qui peut contenir de nombreux éléments de métadonnées vidéo. Ici, nous allons simplement regarder le cue_points champ, qui est défini sur un tableau d'objets de 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'objet de point de repère

Vous trouverez ci-dessous une description des champs des objets de point de repère.

Remarques

• ^{[ 1]} Techniquement, le point de repère est actif jusqu'à ce que le point de repère suivant soit atteint - par conséquent, dans le tableau de points de repère que vous pouvez récupérer à partir du lecteur Brightcove, vous verrez un startTime et endTime ainsi qu'à un time pour le point de repère.