PORTAL und PPS Knowledge Base

JW-Player Videovorschau

Bei der Verwendung des JW-Player-Upload-Plugins wird auch eine Videovorschau generiert, welche in allen Teasercard-Typen ausgespielt wird.

Funktionalitäten der JW-Player Videovorschau

  • Erhaltung eines Einblickes des Videos für Benutzer:innen

  • Ausspielung auf unterschiedlichen Teasercards

Inhaltsverzeichnis

Allgemeine Beschreibung

Eine JW-Player Videovorschau kann nur in Verbindung mit dem JW-Player-Upload-Plugin generiert und verwendet werden. Die Videovorschau wird vom Hoster JW Player generiert und über die JW-Player API per Webhook bei PEIQ gespeichert und dem PORTAL zur Verfügung gestellt.

Die Videovorschau wird automatisch von JW generiert und PEIQ hat keinen Einfluss auf den Inhalt. Das bedeutet, dass die Vorschauen vom PORTAL nur so verwendet werden können, wie es von JW angeliefert wird.

Wurde die Videovorschau von JW generiert und an das PORTAL übermittelt, so steht sie im Medienstream-Formular als Vorschau zur Verfügung und kann übernommen werden.

Automatische Ausspielung in unterschiedlichen Teasercard-Typen

Die Videovorschau wird über das gesamte PORTAL verteilt automatisch in unterschiedlichen Teasercard-Typen mit zum Teil unterschiedlichen Konfigurationen ausgespielt. Aufgrund der Varianz der Teasercard-Typen und der Ausspielung über ein responsives Grid, welches die Größe des Endgerätes berücksichtigt, kann es dazu kommen, dass die Videovorschau nicht in allen Varianten der Teasercards in gleicher Größe dargestellt wird.

Die Video-Preview wird nur im PORTAL verwendet und hat keine Auswirkungen auf den Export des Beitrags in angeschlossene Systeme.

Ausspielung der Video-Previews auf unterschiedlichen Endgeräten (Mobile / Desktop)

Ausspielung Mobile & Tablet:

Auf mobilen Endgeräten werden alle Videovorschauen abgespielt, die sich innerhalb des sichtbaren Bereichs befinden.

Ausspielung Desktop:

Auf Desktops werden Videovorschauen abgespielt, sobald sich der Mauszeiger über der jeweiligen Teasercard mit einer Videovorschau befindet.

Ausspielen der Videovorschau

Eine Videovorschau kann auf unterschiedliche Arten zum Ausspielen markiert werden. Mögliche Arten werden folgend erläutert.

Aktivieren der Video-Preview

Innerhalb eines Beitrags muss ein Status für den Medienstream im PORTAL definiert werden. Der Status definiert, ob der Medienstream ausgespielt werden soll oder nicht. Soll die Videovorschau eines Medienstreams dargestellt werden, so muss der Medienstream auch ausgespielt werden können, also den Status “AKTIV“ besitzen. Weitere Infos siehe Medienstream aktivieren/deaktivieren.

Definition des Status

Ist der Status auf AKTIV gesetzt, kann die generierte Videovorschau von JW für den Medienstream im Medienstream-Formular übernommen werden:

Übernahme der Videovorschau von JW

 

Übernommene Vorschau

 

Wurde die Vorschau übernommen, so werden vom PORTAL ein statisches Bild und die Videovorschau angewendet. Die Videovorschau wird dargestellt, sobald ein Mouseover über das statische Bild erfolgt, oder der Medienstream in den Fokus gescrollt wird. Trifft keine dieser Bedingungen zu, wird das statische Bild als Vorschau verwendet.

Videovorschau im Hero-Image anzeigen

Innerhalb des Beitrags-Editors kann der erste Medienstream als Hero-Image definiert und verwendet werden. Siehe Medienstream als Hero-Image verwenden.

Medienstream als Hero-Image verwenden

Ist ein Medienstream als Hero-Image definiert und wurde die generierte Videovorschau übernommen, ist die Videovorschau im Hero-Image verfügbar.

Eigene Vorschau verwenden und Video-Preview ausspielen

Für einen Medienstream kann ebenso eine eigene Vorschau verwendet werden. Hierzu wird die automatisch generierte Vorschau nicht übernommen oder gelöscht und stattdessen ein eigenes Bild über den Button “BILD HOCHLADEN” im Medienstream-Formular verwendet.

Automatisch generierte Vorschau mit eigener Vorschau ersetzen.

 Im Nachhinein kann auch die automatisch generierte Videovorschau von JW nachgeladen werden.

Ausspielen der Videovorschau verhindern

Ist eine Videovorschau einmal nicht erwünscht, aber das Video soll weiterhin aufrufbar sein, kann die Videovorschau auch verhindert werden.

Im Medienstream-Formular muss die Vorschau nicht zwingend übernommen werden und kann ebenso durch ein statisches Bild ersetzt werden. Solange das Nachladen der Vorschau nicht manuell angestoßen wird, kann auch keine Video-Preview ausgespielt werden. Stattdessen wird das statische Bild dargestellt und zeitgleich bleibt das Video aufrufbar.

Soll die Videovorschau jedoch wieder dargestellt werden, so kann das statische Bild aus der Vorschau gelöscht und generierte Videovorschau von JW erneut als Vorschau übernommen werden.

Manuelle Synchronisation der Vorschauen

Sollte einmal die Kommunikation der Server seitens JW fehlschlagen - also keine Vorschau zur Verfügung stehen - kann die Synchronisation der Vorschauen manuell erneut angestoßen werden.

Bei der Verarbeitung von Medienstreams beim Hoster JW können verschiedene Fälle eintreten, welche dazu führen, dass dem PORTAL keine Vorschauen zu Videos übermittelt werden. Nach Knopfdruck synchronisiert das PORTAL die Previews neu und Benutzer:innen können daraufhin die Inhalte in der Verwaltung wieder bearbeiten.

Medienstream manuell synchronisieren

Während der Verarbeitung beim Drittanbieter noch läuft, weist der Medienstream einen entsprechenden technischen Status (MEDIENSTREAM WIRD VERARBEITET) auf. Es ist nicht möglich, Medienstreams mit diesem Status zu bearbeiten, sie können jedoch in Inhalten verwendet werden.

Der technische Status wird zusätzlich zum Status des Medienstreams (AKTIV / INAKTIV) in diversen Ansichten angezeigt. Der Status MEDIENSTREAM WIRD VERARBEITET wird entfernt, sobald der Drittanbieter die Verarbeitung abgeschlossen und die Referenz für das Video sowie eine Vorschau zur Verfügung gestellt hat.

Mögliche Zustände, die ein Medienstream einnehmen kann

Es gibt vier mögliche Zustände, die ein Medienstream - je nach Antwort des Hosters - einnehmen kann:

  1. Der Medienstream wird verarbeitet: Die Verarbeitung beim Hoster ist noch nicht abgeschlossen.

  2. Der Medienstream wurde aktualisiert: Die Überprüfung wurde fertiggestellt (mit oder ohne Vorschau, je nach Verfügbarkeit).

  3. Der Medienstream wurde aktualisiert, es ist noch keine Vorschau verfügbar: Der Medienstream war fertiggestellt, hatte noch keine Vorschau und durch die Überprüfung wurde auch keine Vorschau hinzugefügt (da nicht vorhanden).

  4. Die Verarbeitung des Medienstreams ist fehlgeschlagen: Durch die Überprüfung wurde festgestellt, dass die Verarbeitung fehlgeschlagen ist.

Jeder dieser Zustände ist mit entsprechenden Fehlermeldungen / Erfolgsmeldungen versehen. Im Sonderfall kann die Bearbeitung des Medienstreams fehlschlagen, beispielsweise wenn das Video vom Hoster nicht konvertiert werden konnte. Für diesen Fall kann der Medienstream gelöscht werden, sodass diese im Hintergrund mit JW synchronisiert wird.

Verwandte Seiten

 

Nur für PEIQ-Mitarbeiter:innen
https://peiq.atlassian.net/wiki/x/QYDaOg