Verwendung von Player-Erweiterungen für Live-SSAI mit den nativen SDKs

In diesem Thema erfahren Sie, wie Sie einen Live-Stream mit den nativen SDKs von Brightcove wiedergeben, der serverseitige Anzeigen enthält und Playererweiterungen für Live SSAI für eine verbesserte Benutzererfahrung nutzt.

Einleitung

Mit den Player-Erweiterungen für Live-SSAI von Brightcove können Sie die Werbeunterbrechungen in Live-Streams mit Anzeigenzählungen, Anzeigen-Countdown-Timern, Click-through-Anzeigen und Companion-Anzeigen verbessern. Diese Livestreams können mit den Brightcove Native SDKs wiedergegeben werden.

Clientseitige Anzeigenkomponenten
Clientseitige Anzeigenkomponenten

Da Fernseher keinen Webbrowser unterstützen, sind Companion- und Click-through-Anzeigen auf verbundenen Fernsehern nicht verfügbar.

Wenn Sie diese Funktion noch nicht kennen, lesen Sie Folgendes:

Schritte

Gehen Sie folgendermaßen vor, um Livestreams mit einem erweiterten Player mit den Brightcove Native SDKs abzuspielen:

  1. Folgen Sie dem Workflow in der Implementieren von Spielerverbesserungen für Live-SSAI Dokument, bis hin zum Erstellen Ihres Wiedergabe-Tokens.
  2. Erstellen Sie Ihre App:

  3. Fahren Sie mit dem Workflow in der Implementieren von Spielerverbesserungen für Live-SSAI dokumentieren.

Android-Implementierung

Sie benötigen die folgenden Werte, um Ihre App mit dem Native SDK für Android zu erstellen:

  • Wiedergabe-Token
  • Konto-ID
  • Video-ID
  • Richtlinienschlüssel

Um Ihren Richtlinienschlüssel zu erhalten, lesen Sie die Richtlinienschlüssel dokumentieren.

Führen Sie diese Schritte aus, um Ihre App zu erstellen:

  1. Verwenden Sie die Grundlegende SSAI-Beispiel-App als Ausgangspunkt für Ihren Code.
  2. In dem res/values/strings.xml Datei, ersetzen Sie Folgendes durch Ihre eigenen Werte:
    • Konto-ID
    • Video-ID
    • Richtlinienschlüssel
  3. In dem MainActivity.java Datei, ersetzen Sie die ad_config_id Wert mit deinem Wiedergabe-Token.

    private final String AD_CONFIG_ID_QUERY_PARAM_VALUE = "your playback token";
  4. Die ad_config_id mit Ihrem Wiedergabe-Token-Wert wird der HTTP-Anforderung als Abfrageparameter hinzugefügt.

    HttpRequestConfig httpRequestConfig = new HttpRequestConfig.Builder()
      .addQueryParameter(AD_CONFIG_ID_QUERY_PARAM_KEY, AD_CONFIG_ID_QUERY_PARAM_VALUE)
      .build();
  5. Führen Sie den Katalogaufruf an die Playback API mit Ihrer Livestream-Video-ID und der aktualisierten HTTP-Anfrage aus.

    catalog.findVideoByID(getString(R.string.video_id), httpRequestConfig, new VideoListener() {
         @Override
         public void onVideo(Video video) {
             plugin.processVideo(video);
         }
     });
  6. Dein Spieler ist bereit, deinen Livestream abzuspielen.

iOS-Implementierung

Sie benötigen die folgenden Werte, um Ihre App mit dem Native SDK für iOS zu erstellen:

  • Wiedergabe-Token
  • Konto-ID
  • Video-ID
  • Richtlinienschlüssel

Um Ihren Richtlinienschlüssel zu erhalten, lesen Sie die Richtlinienschlüssel dokumentieren.

Führen Sie diese Schritte aus, um Ihre App zu erstellen:

  1. Verwenden Sie die Grundlegender SSAI-Spieler Beispiel als Ausgangspunkt für Ihren Code.
  2. In dem ViewController.swift Datei, ersetzen Sie Folgendes durch Ihre eigenen Werte:
    • Konto-ID
    • Video-ID
    • Richtlinienschlüssel
  3. Ersetze das AdConfigId Wert mit deinem Wiedergabe-Token.

    static let AdConfigId = "your playback token"
  4. Die AdConfigId mit Ihrem Wiedergabe-Token-Wert wird als Abfrageparameter hinzugefügt.

    let queryParameters = [kBCOVPlaybackServiceParamaterKeyAdConfigId: Constants.AdConfigId]
  5. Führen Sie den Katalogaufruf an die Playback API mit Ihrer Livestream-Video-ID und dem Abfrageparameter durch.

    playbackService.findVideo(withVideoID: Constants.VideoId, parameters: queryParameters)
      { [weak self] (video: BCOVVideo?, jsonResponse: [AnyHashable: Any]?, error: Error?) -> Void in
      guard let _video = video else {
        print("ViewController Debug - Error retrieving video: \(error?.localizedDescription ?? "unknown error")")
        return
      }
      self?.playbackController?.setVideos([_video] as NSFastEnumeration)
    }
  6. Dein Spieler ist bereit, deinen Livestream abzuspielen.