Beispiel für Brightcove Spieler: Schaust du immer noch zu?

Beispiel eines Spielers

In diesem Beispiel sehen Sie nach einer festgelegten Zeitspanne eine Overlay-Meldung. In diesem Beispiel wird das Overlay in 6 Sekunden angezeigt, aber die Zeit ist konfigurierbar. Wenn der Betrachter innerhalb einer bestimmten Zeit auf die Nachricht klickt, wird die Wiedergabe fortgesetzt. Wenn nicht, wird das Video angehalten. Diese Technik ist nützlich, wenn Sie Langform-Inhalte haben. Dies verhindert, dass Sie Bandbreite für Zuschauer verschwenden, die anfangen, ein Video abzuspielen und dann etwas anderes zu tun, ohne sich die Mühe zu machen, es zu stoppen.

In diesem Beispiel wird ein Open Source Video.js Plugin verwendet, das sich unter https://github.com/TylerZubke/Videojs-AFK-Monitor befindet. Der Beispielcode in diesem Dokument verwendet dieses Plugin.

Siehst du den Stift Beobachtest du immer noch? von Brightcove Learning Services (@rcrooks1969) auf CodePen.

Quellcode

Sehen Sie sich die Komplettlösung auf GitHub an.

CodePen verwenden

Hier sind einige Tipps zur effektiven Verwendung des obigen CodePen:

  • Schalten Sie die tatsächliche Anzeige des Players um, indem Sie auf klicken Result Taste.
  • Drücke den HTML/CSS/JS Schaltflächen zur Anzeige EINES der Codetypen.
  • Später in diesem Dokument werden die Logik, der Ablauf und das Styling der Anwendung in der Player/HTML-Konfiguration, im Anwendungsfluss und im Anwendungsstyling diskutiert Abschnitte. Der beste Weg, um den Informationen in diesen Abschnitten zu folgen, besteht darin:
    1. Drücke den EDIT ON CODEPEN Klicken Sie im CodePen auf die Schaltfläche und halten Sie den Code in einem Browser / einer Browser-Registerkarte bereit.
    2. Passen Sie in CodePen an, welcher Code angezeigt werden soll. Sie können die Breite verschiedener CodeAbschnitte in CodePen ändern.
    3. Sieh den Player-/HTML-Konfiguration , Bewerbungsablauf und/oder Bewerbungsstyling Abschnitte in einem anderen Browser/Browser-Tab. Sie können nun den Codeerklärungen folgen und gleichzeitig den Code anzeigen.

Entwicklungs-Sequenz

Hier ist die empfohlene Entwicklungssequenz:

  1. Verwenden Sie die In-Page-Embed-Player-Implementierung, um die Funktionalität Ihres Players, Plugins und CSS zu testen (falls CSS benötigt wird)
  2. Legen Sie JavaScript und CSS des Plugins in separate Dateien zum lokalen Testen
  3. Stellen Sie den Plugin-Code und das CSS auf Ihrem Server bereit, sobald Sie Fehler herausgefunden haben
  4. Benutze Studio, um das Plugin und das CSS deinem Player hinzuzufügen
  5. Ersetzen Sie die In-Page-Embed-Player-Implementierung, wenn Sie feststellen, dass die Iframe-Implementierung besser passt (im nächsten Abschnitt beschrieben)

Weitere Informationen zu diesen Schritten finden Sie in der Schritt-für-Schritt-Anleitung: Leitfaden zur Entwicklung von Plugins

iframe oder In-Page einbetten

Bei der Entwicklung von Verbesserungen für den Brightcove Player müssen Sie entscheiden, ob der Code am besten für die Iframe- oder In-Page-Einbettungsimplementierung geeignet ist. Die Best Practice-Empfehlung besteht darin, ein Plugin zur Verwendung mit einer Iframe-Implementierung zu erstellen. Die Vorteile der Verwendung des iFrame-Players sind:

  • Keine Kollisionen mit vorhandenem JavaScript und/oder CSS
  • Reaktionsschnell
  • Der iframe erleichtert die Verwendung in Social-Media-Apps (oder wann immer das Video in andere Apps „reisen“ muss)

Obwohl die Integration des In-Page-Einbettungsplayers komplexer sein kann, planen Sie Ihren Code in dieser Implementierung manchmal. Um zu verallgemeinern, ist dieser Ansatz am besten, wenn die enthaltende Seite mit dem Spieler kommunizieren muss. Im Einzelnen sind hier einige Beispiele:

  • Der Code auf der enthaltenden Seite muss Spielerereignisse abhören und darauf reagieren
  • Der Player verwendet Stile von der enthaltenden Seite
  • Der Iframe führt dazu, dass die App-Logik fehlschlägt, wie eine Weiterleitung von der enthaltenen Seite

Selbst wenn Ihre endgültige Implementierung den Iframe-Code nicht verwendet, können Sie den In-Page-Einbettungscode trotzdem mit einem Plugin für Ihr JavaScript und einer separaten Datei für Ihr CSS verwenden. Dies kapselt Ihre Logik, sodass Sie sie problemlos in mehreren Spielern verwenden können.

Verwendete API/Plugin-Ressourcen

API-Methoden API-Ereignisse Brightcove Player-Plugins
addClass () useractive Overlay-Plugin
removeClass () userinactive  
pausieren ()    
currentTime ()    
eins ()    
am ()    
setTimeout ()    
hasClass ()    
dauer ()    
pausiert ()    
cleArtimeOut ()    
hasStarted ()    
el ()    

Player-/HTML-Konfiguration

Dieser Abschnitt beschreibt jede spezielle Konfiguration, die während der Spielererstellung erforderlich ist. Darüber hinaus werden andere HTML-Elemente beschrieben, die der Seite über den In-Page-Einbettungsplayer-Implementierungscode hinaus hinzugefügt werden müssen.

Player-Konfiguration

Für den Brightcove Player, den Sie für dieses Beispiel erstellen, ist keine spezielle Konfiguration erforderlich.

Anderes HTML

Die CSS- und JavaScript-Dateien des Drittanbieter-Plugins sind enthalten.

Ablauf der Anwendung

Die grundlegende Logik hinter dieser Anwendung lautet:

  • Der useractive Und userinactive Ereignisse werden beobachtet, um die Zeit zu verfolgen.
  • Das Overlay wird nach der angegebenen Zeit angezeigt, um festzustellen, ob der Kunde das Video noch ansieht.
  • Wenn das Overlay für die von Ihnen angegebene Zeit angezeigt wurde und auf den Text nicht geklickt wurde, pausieren Sie das Video.
  • Wenn auf die Schaltfläche geklickt wird oder der Betrachter das Video nach einer Pause startet, initialisieren Sie die Werte neu und beginnen Sie erneut mit der Zeitverfolgung.

Dieses Beispiel verwendet das Plugin

Das Plugin wird mit Best Practices aufgerufen, wie hier gezeigt

  <script>
    videojs.getPlayer('myPlayerID').ready(function() {
      var myPlayer = this;
      var options = {'showMessageAfter': 1000, 'pausePlayerAfter': 1000};
      myPlayer.AFKMonitor(options);
    });
  </script>

Konfigurieren des Plugins

Eine Reihe von Optionen kann verwendet werden, um das Plugin anzupassen. Einige Details sind:

  • Eine vollständige Liste der Konfigurationsoptionen finden Sie in der Readme-Datei des Plugins.
  • Der showMessageAfter(in Millisekunden) bestimmt die Zeit, bis die Schaltfläche angezeigt wird.
  • Die Optionen pausePlayerAfter(in Millisekunden) sind ebenfalls hilfreich. Zu diesem Zeitpunkt erlauben Sie dem Benutzer, auf die Schaltfläche zu klicken, bevor der Player angehalten wird. Dies gibt dem Benutzer die Möglichkeit, auf die Schaltfläche zu klicken, ohne die Videowiedergabe zu unterbrechen.

Styling der Anwendung

Das CSS ist Teil des Plugins von Drittanbietern.

Plugin-Code

Sie möchten das Repo klonen, um auf den Code zuzugreifen, und ihn dann an einem für Sie zugänglichen Ort platzieren.

Wie bereits erwähnt, können Sie den JavaScript-Code des Plugins im entsprechenden GitHub-Repo dieses Dokuments sehen: videojs.afk-monitor.js.

Verwenden des Plugins mit einem Player

Sobald Sie die CSS- und JavaScript-Dateien des Plugins an einem für das Internet zugänglichen Ort gespeichert haben, können Sie das Plugin mit einem Player verwenden. Im Studio SPIELER Modul können Sie einen Spieler wählen, dann in der PLUGINS fügen Sie die URLs zu den CSS- und JavaScript-Dateien hinzu und fügen Sie auch die Name und Optionen , wenn Optionen benötigt werden.