Geräteübergreifender Lebenslauf mit Brightcove Player

In diesem Thema erfahren Sie, wie Sie geräteübergreifende Fortsetzungen mit dem Brightcove-Player verwenden können.

Überblick

Die geräteübergreifende Fortsetzung ermöglicht es den Zuschauern, ein Video auf einem Gerät zu starten und zu einem späteren Zeitpunkt auf demselben oder einem anderen Gerät fortzusetzen, wo sie das Video unterbrochen haben.

Angenommen, jemand sieht sich auf seinem Mobilgerät ein Video an. Später können sie dasselbe Video mit einem Player in ihrem Webbrowser weiter ansehen. Die Wiedergabe wird dort fortgesetzt, wo sie aufgehört haben, sodass sie nichts verpassen.

Wenn Sie mit dieser Funktion nicht vertraut sind, lesen Sie die Übersicht: Geräteübergreifender Lebenslauf dokumentieren.

Voraussetzungen

Die folgenden Anforderungen gelten für geräteübergreifende Lebensläufe:

  • Brightcove Player Version 6.41.0+

Setup

Diese Funktion steht jedem mit einem Brightcove Video Cloud-Konto zur Verfügung.

Um zu beginnen, gehen Sie wie folgt vor:

  • Wenden Sie sich an Ihren Account Manager, um Ihr Konto für den geräteübergreifenden Lebenslauf zu aktivieren
  • Stellen Sie sicher, dass die von Ihnen verwendeten Videos für Dynamic Delivery aufgenommen werden

Implementieren des geräteübergreifenden Lebenslaufs

Führen Sie die folgenden Schritte aus, um die geräteübergreifende Wiederaufnahme zu implementieren:

  1. Legen Sie die Benutzer-ID fest in Brightcove Analytics
  2. Holen Sie sich die Wiedergabeposition des Betrachters
  3. Wiedergabe fortsetzen auf einem Brightcove-Player

Betrachter-ID senden - Brightcove-Player

Zunächst müssen Sie die Benutzer-ID festlegen, um ihre Anzeigeaktivität zu speichern.

Brightcove-Player

Wenn Sie Brightcove Player verwenden, gehen Sie folgendermaßen vor:

  1. Obwohl Viewer-Daten automatisch an Brightcove Analytics gesendet werden, müssen Sie die Benutzer-ID festlegen. Verwenden Sie dazu die setUser() Methode. Zum Beispiel: 

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

    Auf Ihren Websites, auf denen Brightcove Player gehostet wird, können Sie ein Authentifizierungsgateway oder eine Identitätsverwaltungslösung verwenden, um den Überblick über die Betrachter zu behalten. Verwenden Sie diese Viewer-ID als Viewer-ID, um sie an Brightcove Analytics zu übergeben.

  2. Es ist wichtig, die Viewer-ID festzulegen, bevor eine Quelle auf dem Player festgelegt wird. Es sollte sofort nach der Initialisierung des Players aufgerufen werden. 

    <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. Wenn der setUser() Methode verwendet wird, wird der Wert nicht gehasht und wird mit allen nachfolgenden Beacons im Klartext gesendet.

    Notiere dass der player_init Veranstaltung wird die nicht enthalten user Feld in diesem Fall, aber alle video_* Ereignisse sollten es enthalten.

Benutzerdefinierter Webplayer

Wenn Sie eine benutzerdefinierte Implementierung erstellen, die Brightcove Player nicht verwendet, fügen Sie die hinzu user Parameter für Ihre Datenerfassungs-API-Anforderungen. Einzelheiten finden Sie im Überblick: Datenerfassungs-API v2 Dokument.

Auf Ihren Websites, auf denen sich Ihr Player befindet, können Sie ein Authentifizierungsgateway oder eine Identitätsverwaltungslösung verwenden, um den Überblick über die Betrachter zu behalten. Verwenden Sie diese Viewer-ID als Viewer-ID, um sie an Brightcove Analytics zu übergeben.

Diese user Der an Brightcove übergebene Parameter kann im nächsten Abschnitt verwendet werden, um die Wiedergabeposition von der XDR-API abzurufen.

Holen Sie sich die Wiedergabeposition des Betrachters

Als Nächstes erhalten Sie die Viewer-Wiedergabeposition von der XDR-API (Cross-Device Resume).

Sie benötigen eine serverseitige Anwendung, um die REST-API-Anforderung zum Abrufen der Viewer-Wiedergabeposition zu stellen.

Einzelheiten finden Sie in der Abrufen der Wiedergabeposition von der XDR-API Dokument.

Wiedergabe fortsetzen

Sobald Sie die Wiedergabeposition des Betrachters von der XDR-API erhalten haben, können Sie die Wiedergabe an diesem Punkt fortsetzen.

  1. Stellen Sie mit der Wiedergabeposition des Betrachters aus dem vorherigen Abschnitt die Position des Abspielkopfs mit der Taste ein currentTime() Methode.

    Hier ist ein Beispiel: 

    // 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. Ein Webplayer-Beispiel, das einen serverseitigen Proxy aufruft, um den Abspielkopf von der XDR-API abzurufen, finden Sie unter Beispiel für einen geräteübergreifenden Lebenslauf auf github.