Hinzufügen von Cue-Points

Einleitung

Cue-Punkte sind festgelegte Stellen auf der Video-Timeline. Wenn das Video abgespielt wird, wird jedes Mal, wenn ein Cue-Point erreicht wird, automatisch ein Ereignis übertragen - mit der Player-API können Sie auf diese Ereignisse hören und jede gewünschte Aktion ausführen. Darüber hinaus können Sie alle Cue-Point-Informationen aus den im Player gespeicherten Video-Metadaten lesen mediainfo Objekt, mit dem Sie Markieren Sie die Cue-Punkte auf der Video-Timeline irgendwie, wenn du willst.

Es gibt zwei Arten von Cue-Points:

• Anzeigen-Cue-Points: Diese werden verwendet, um Stellen zu markieren, an denen eine Anzeigenanfrage gestellt werden sollte (wenn das Video und der Player für Werbung aktiviert sind).
• Code-Cue-Points: Diese werden verwendet, um mithilfe der Player-API eine Aktion auszuführen. Einige typische Anwendungen sind die Anzeige einer Art Call-to-Action (CTA) oder die Anzeige von Bildern oder Texten zu Videoinhalten, möglicherweise als Video-Overlay oder In die Seite um den Player herum.

Beispiel-App

Siehe den Stift CMS-API-Beispiel: Fügen Sie Cue-Points von Brightcove Learning Services ( @rcrooks1969) auf CodePen hinzu.

Überblick über die Implementierung

Sie können Cue-Punkte hinzufügen in das Studio Media-Modul. Sie können sie auch mithilfe der CMS-API hinzufügen. Dies ist die Methode, die wir in diesem Beispiel verwenden werden.

HTTP-Methode

Cue-Punkte können entweder hinzugefügt werden, wenn Sie Erstelle das Video oder später mit an Update-Anfrage. In diesem Beispiel fügen wir sie einem vorhandenen Video hinzu, indem wir a Video-Update Anfrage, was bedeutet, dass Sie die PATCH Methode.

Endpunkt

Der Endpunkt für die Videoaktualisierungsanfrage ist:

          https://cms.api.brightcove.com/v1/accounts/account_id/videos/video_id

Anfragetext

Der Anfragetext ist ein JSON-Objekt, das viele Videometadatenelemente enthalten kann. Hier schauen wir uns nur die an cue_points -Feld, das auf ein Array von Cue-Point-Objekten festgelegt ist, wie im folgenden Beispiel:

          {
          "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
              }
            ]
          }

Cue-Point-Objektfelder

Nachfolgend finden Sie eine Beschreibung der Felder für Cue-Point-Objekte.

Hinweise

• ^[1] Technisch gesehen ist der Cue-Punkt aktiv, bis der nächste Cue-Punkt erreicht ist. Daher wird im Cue-Points-Array, das Sie vom Brightcove-Player abrufen können, ein angezeigt startTime und endTime auch bei a time für den Cue-Point.