Thumbnail Seeking mit den Native SDKs

In diesem Thema erfahren Sie mehr über das Suchen von Miniaturansichten mit den nativen SDKs von Brightcove.

Überblick

Mit der Miniaturansichtssuche können Benutzer den Abspielkopf entlang der Zeitachse ziehen und Miniaturansichten als Vorschau des zugehörigen Inhalts anzeigen. Dies gibt Benutzern die Möglichkeit, schnell durch eine Videodatei zu navigieren und den Inhalt zu finden, an dem sie interessiert sind.

Thumbnail suchen
Wann werden Bilder generiert?

Brightcove generiert die Bilder auf Wunsch dynamisch. Für jedes mit Dynamic Delivery aufgenommene Video werden Bilder bei der ersten Anfrage generiert. Dadurch wird sichergestellt, dass keine Bilder für nicht verwendete Videos erstellt werden. Nach der Generierung werden Bilder lokal und auf dem CDN zwischengespeichert, um sie wie jedes andere Bild wiederholt anzuzeigen.

Welche Bildfrequenz hat ein Video?

Bilder werden alle 5 Sekunden für Inhalte von < 1 Stunde und alle 10 Sekunden für Inhalte > 1 Stunde generiert.

Voraussetzungen

Die folgenden Anforderungen sind für die Miniaturansichtssuche mit den Brightcove Native SDKs erforderlich:

Diese Funktion erfordert die Verwendung der Playback API v2.

Gerätebetriebssystemversion

  • Android 6.0+
  • iOS 11.0+

Brightcove Native SDK-Version

  • Natives SDK für Android 6.12.0+
  • Natives SDK für iOS 6.7.4+

Erste Schritte

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

Stellen Sie sicher, dass Ihre Videos für die dynamische Bereitstellung aufgenommen werden.

Android-Implementierung

Gehen Sie folgendermaßen vor, um die Miniaturansichtssuche mit dem Native SDK für Android zu verwenden:

  1. In dem build.gradle fügen Sie die folgende Gradle-Abhängigkeit hinzu: 

    implementation "com.brightcove.player:android-thumbnail-plugin:6.13.0"

  2. In dem MainActivity.java -Datei erstellen Sie eine Instanz der ThumbnailComponent. 

    ThumbnailComponent thumbnailComponent = new ThumbnailComponent(brightcoveVideoView);

  3. Richten Sie den Vorschau-Mediencontroller ein. 

    thumbnailComponent.setupPreviewThumbnailController();
  4. Ein vollständiges Codebeispiel finden Sie im ThumbnailScrubberSampleApp

Zusätzliche Schritte für SSAI

Wenn Sie Server-Side Ad Insertion (SSAI) verwenden, sind zusätzliche Schritte erforderlich.

Um das Thumbnail-Plugin mit dem SSAI-Plugin zu verwenden, müssen Sie Offsets berücksichtigen, die durch die zusammengefügten Anzeigen im Inhalt eingeführt werden.

  1. Kehre zu deinem zurück MainActivity.java Datei.
  2. Hören Sie auf die SSAIEventType.AD_DATA_READY Veranstaltung.
  3. Rufen Sie das Zeitachsenobjekt des SSAI-Videos ab.

  4. Erstellen Sie eine Instanz von SSAIThumbnailDocumentCreatorWrapper mit folgenden Parametern:

    • EIN ThumbnailDocumentCreator. Du kannst das benutzen DefaultThumbnailDocumentCreator.
    • Das Zeitachsenobjekt des SSAI-Videos.
    • Stellen Sie die ThumbnailDocumentCreator zum ThumbnailPlugin.

  5. Hier ist ein Codebeispiel: 

    eventEmitter.once(AD_DATA_READY, event -> {
  Timeline timeline = event.getProperty(SSAIEvent.VMAP_TIMELINE, Timeline.class);
  ThumbnailDocumentCreator creator = new SSAIThumbnailDocumentCreatorWrapper(new   DefaultThumbnailDocumentCreator(), timeline);
  thumbnailComponent.setThumbnailDocumentCreator(creator);
});

iOS-Implementierung

Gehen Sie wie folgt vor, um die Miniaturansichtssuche mit dem Native SDK für iOS zu verwenden

  1. Es gibt eine neue BCOVPlaybackController Eigenschaft, die die Suche nach Miniaturbildern für den Playback-Controller aktiviert oder deaktiviert. Einzelheiten finden Sie im Referenz zum nativen SDK für iOS.

  2. Der Standardwert ist YES. Um die Miniaturbildsuche zu deaktivieren, setzen Sie den Wert auf NO.

    /**
 * Enables or disables thumbnail seeking for this playback controller.
 *
 * Default value is YES
 */
@property (nonatomic, readwrite, assign) BOOL thumbnailScrubbingEnabled;

Einschränkungen

Es gibt ein paar Einschränkungen bei der Verwendung der Miniaturbildsuche mit den nativen SDKs:

  • Die Suche nach Miniaturansichten wird bei der Offline-Wiedergabe nicht unterstützt
  • Bei Verwendung des nativen SDK für Android ist die Suche nach Miniaturansichten für Remote-Asset-Videos nicht verfügbar.