Schritt für Schritt: Einfache TV-Video-App mit Swift

Es gibt zwei Möglichkeiten, dieses Beispiel auszuprobieren:

Laden Sie das Beispiel herunter

Laden Sie das gesamte Xcode-Projekt zum Experimentieren herunter.

1. Klonen Sie die Native SDK-Beispiele für iOS oder laden Sie sie auf Ihr lokales System herunter.
2. Navigieren Sie zum Player/AppleTV/swift Beispiel-App.
3. Führen Sie die pod install Befehl.
4. Öffnen Sie den neu erstellten Arbeitsbereich und führen Sie ihn aus.

Einzelheiten finden Sie im Ausführen von Beispiel-Apps für das native SDK für iOS/tvOS dokumentieren.

Erstellen Sie die App, indem Sie die Schritte in dieser Anleitung befolgen

Gehen Sie wie folgt vor, um sich mit der Einrichtung eines App-Projekts vertraut zu machen, das das Brightcove Player SDK für tvOS verwendet. Sie können den vollständigen Code für jede der folgenden Optionen anzeigen:

1. App-Delegate
2. Controller anzeigen

Importieren Sie das native SDK

Obwohl das Brightcove Native Player SDK für iOS in Obj-C geschrieben ist, können wir die Framework-Module einfach in unser Swift-Projekt importieren.

1. Unterhalb der vorhandenen import Anweisung, fügen Sie Folgendes hinzu, um das Brightcove Native Player SDK zu importieren:

   import BrightcovePlayerSDK

Passen Sie das Projekt mit Ihren Werten an

Fügen Sie Werte hinzu, um auf Ihr Video Cloud-Konto zuzugreifen.

1. Unter dem import -Anweisungen, fügen Sie Ihre eigenen Werte für Folgendes hinzu:

   • Zeile 12: Definiert Ihren Brightcove Playback API-Richtlinienschlüssel. In diesem Beispiel wird ein Video abgespielt, das von zurückgegeben wird Brightcove-Wiedergabe-API , die neueste und empfohlene API zum Abrufen von Inhalten aus Ihrer Video Cloud-Bibliothek. Wenn Sie mit Richtlinienschlüsseln nicht vertraut sind, lesen Sie die Übersicht über die Richtlinien-API.

   • Zeile 13: Definiert Ihre Video Cloud-Konto-ID

   • Zeile 14: Definiert Ihre Video Cloud-Video-ID

   fileprivate struct playbackConfig {
     static let policyKey = "your policy key"
     static let accountID = "your account id"
     static let videoID = "your video id"
   }

Erstellen Sie eine Ansichtsvariable

1. In dem ViewController Klasse, fügen Sie eine Variable für die Ansicht hinzu.

   class ViewController: UIViewController {
     @IBOutlet weak var videoContainerView: UIView!

Erstellen Sie den Wiedergabedienst

1. Erstellen Sie eine Variable, die den Brightcove-Wiedergabedienst mit Ihrer Konto-ID und Ihrem Richtlinienschlüssel definiert. Diese wird beim ersten Aufruf initialisiert.

   Wenn Sie neu bei Swift sind, lesen Sie den Leitfaden über Lazy Stored Properties.

   lazy var playbackService: BCOVPlaybackService = {
     return BCOVPlaybackService(accountId: playbackConfig.accountID, policyKey: playbackConfig.policyKey)
   }()

Erstellen Sie den Wiedergabe-Controller

1. Erstellen Sie eine Variable, die den Brightcove-Wiedergabecontroller definiert. Diese wird beim ersten Aufruf erstellt.

   • Zeilen 28-30: Stellen Sie den Delegierten ein und aktivieren Sie die Funktionen für den automatischen Vorlauf und die automatische Wiedergabe.

   lazy var playbackController: BCOVPlaybackController? = {
     guard let _playbackController = BCOVPlayerSDKManager.shared().createPlaybackController() else {
       return nil
     }
     _playbackController.delegate = self
     _playbackController.isAutoAdvance = true
     _playbackController.isAutoPlay = true
   
     return _playbackController
   }()

Definiere die Spieleransicht

1. Erstellen Sie eine Funktion namens createTVPlayerView wie folgt:

   • Zeilen 38-39: Definieren Sie die Player-Ansicht, damit die Registerkartenleistenbereiche andere Ansichts-Controller präsentieren können.
   • Zeilen 42-44: Erstellen Sie die Player-Ansicht und fügen Sie sie der Videocontaineransicht hinzu.
   • Zeile 47: Verknüpfen Sie die Player-Ansicht mit dem Wiedergabe-Controller.
   • Zeile 49: Fügt die Player-Ansicht als Unteransicht der Hauptansicht hinzu.
   • Zeile 51: Schalte aus Maske mit automatischer Größenanpassung.

   • Zeilen 52-57: Verwenden Automatisches Layout um dynamische Beschränkungen für die Spieleransicht zu definieren.

   lazy var playerView: BCOVTVPlayerView? = {
     // Set yourself as the presenting view controller
     // so that tab bar panels can present other view controllers
     let options = BCOVTVPlayerViewOptions()
     options.presentingViewController = self
   
     // Create and add to the video container view
     guard let _playerView = BCOVTVPlayerView(options: options) else {
       return nil
     }
   
     // Link the playback controller to the Player View
     _playerView.playbackController = playbackController
   
     videoContainerView.addSubview(_playerView)
   
     _playerView.translatesAutoresizingMaskIntoConstraints = false
     NSLayoutConstraint.activate([
       _playerView.topAnchor.constraint(equalTo: videoContainerView.topAnchor),
       _playerView.rightAnchor.constraint(equalTo: videoContainerView.rightAnchor),
       _playerView.leftAnchor.constraint(equalTo: videoContainerView.leftAnchor),
       _playerView.bottomAnchor.constraint(equalTo: videoContainerView.bottomAnchor)
     ])
   
     return _playerView
   }()

Erstellen Sie eine Init-Funktion

1. Erstelle ein initFunktion wie folgt:
   • Zeile 64: Ruft die Superklassenimplementierung der Funktion init() auf.

   • Zeile 65: Fakultativ: Sendet Ihre Video Cloud-Konto-ID an Analytics. Dies ist nur erforderlich, wenn Sie die BCOVVideo Klasse verwenden oder den Brightcove-Wiedergabedienst oder -Katalog nicht verwenden.

   required init?(coder aDecoder: NSCoder)
   {
     super.init(coder: aDecoder)
     playbackController?.analytics.account = playbackConfig.accountID;
   }

Vorgang nach dem Laden der Ansicht

1. In dem viewDidLoad Methode fügen Sie Folgendes hinzu:

   • Zeile 72: Ruft die requestContentFromPlaybackService Funktion, die wir im nächsten Schritt definieren werden.

   override func viewDidLoad() {
     super.viewDidLoad()
     // Do any additional setup after loading the view, typically from a nib.
   
     requestContentFromPlaybackService()
   }

Anfordern von Inhalten aus der Brightcove-Bibliothek

Um Videoinhalte abzuspielen, fordern Sie eine Playlist beim Katalogdienst an

1. Erstellen Sie eine Funktion namens requestContentFromPlaybackService wie folgt:

   • Zeilen 75-76: Geben Sie ein Videoobjekt von der Playback-API basierend auf der angegebenen Video-ID zurück.
   • Zeile 80: Fügt das Video zum Wiedergabe-Controller hinzu.
   • Zeile 82: schreibt eine Fehlermeldung, wenn eine Playlist nicht zurückgegeben wird.

   private func requestContentFromPlaybackService() {
     playbackService.findVideo(withVideoID: playbackConfig.videoID, parameters: nil) { [weak self] (video: BCOVVideo?, jsonResponse: [AnyHashable: Any]?, error: Error?) -> Void in
   
       if let _video = video {
         //  since "isAutoPlay" is true, setVideos will begin playing the content
         self?.playbackController?.setVideos([_video] as NSArray)
       } else {
         print("ViewController Debug - Error retrieving video: \(error?.localizedDescription ?? "unknown error")")
       }
     }
   }

Erweitern Sie den Wiedergabe-Controller

Auf diese Weise kann Ihre App Videowiedergabeereignisse anhören und darauf reagieren.

1. Erweitern Sie den Ansichtscontroller, um den Brightcove-Wiedergabecontroller-Delegaten einzuschließen, und warten Sie auf Wiedergabeereignisse. Wenn Sie neu bei Swift sind, lesen Sie den Leitfaden über Erweiterungen.

   // MARK: - BCOVPlaybackControllerDelegate
   extension ViewController: BCOVPlaybackControllerDelegate {
   
     func playbackController(_ controller: BCOVPlaybackController!, didAdvanceTo session: BCOVPlaybackSession!) {
       NSLog("ViewController Debug - Advanced to new session.")
     }
   
     func playbackController(_ controller: BCOVPlaybackController!, playbackSession session: BCOVPlaybackSession!, didReceive lifecycleEvent: BCOVPlaybackSessionLifecycleEvent!) {
       NSLog("Event: %@", lifecycleEvent.eventType)
     }
   }

Der Rest

1. Erstellen Sie Funktionen zum Behandeln von Fokusüberschreibungen für ältere Versionen von tvOS.

   // MARK: - UIFocusEnvironment overrides
   extension ViewController {
   
     // Focus Environment override for tvOS 9
     override var preferredFocusedView: UIView? {
         return playerView
     }
   
     // Focus Environment override for tvOS 10+
     override var preferredFocusEnvironments: [UIFocusEnvironment] {
         return (playerView != nil ? [ playerView! ] : [])
     }
   }

Code ansehen

Der View Controller ist nun fertig. Hier ist der vollständige Code:

//
//  ViewController.swift
//  Simple-Video-Playback
//
//  Copyright © 2018 Brightcove. All rights reserved.
//

import UIKit
import BrightcovePlayerSDK

fileprivate struct playbackConfig {
  static let policyKey = "your policy key"
  static let accountID = "your account id"
  static let videoID = "your video id"
}

class ViewController: UIViewController {
  @IBOutlet weak var videoContainerView: UIView!

  lazy var playbackService: BCOVPlaybackService = {
      return BCOVPlaybackService(accountId: playbackConfig.accountID, policyKey: playbackConfig.policyKey)
  }()

  lazy var playbackController: BCOVPlaybackController? = {
      guard let _playbackController = BCOVPlayerSDKManager.shared().createPlaybackController() else {
        return nil
      }
      _playbackController.delegate = self
      _playbackController.isAutoAdvance = true
      _playbackController.isAutoPlay = true

      return _playbackController
  }()

  lazy var playerView: BCOVTVPlayerView? = {
    // Set yourself as the presenting view controller
    // so that tab bar panels can present other view controllers
    let options = BCOVTVPlayerViewOptions()
    options.presentingViewController = self

    // Create and add to the video container view
    guard let _playerView = BCOVTVPlayerView(options: options) else {
      return nil
    }

    // Link the playback controller to the Player View
    _playerView.playbackController = playbackController

    videoContainerView.addSubview(_playerView)

    _playerView.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
      _playerView.topAnchor.constraint(equalTo: videoContainerView.topAnchor),
      _playerView.rightAnchor.constraint(equalTo: videoContainerView.rightAnchor),
      _playerView.leftAnchor.constraint(equalTo: videoContainerView.leftAnchor),
      _playerView.bottomAnchor.constraint(equalTo: videoContainerView.bottomAnchor)
    ])

    return _playerView
  }()

  required init?(coder aDecoder: NSCoder)
  {
    super.init(coder: aDecoder)
    playbackController?.analytics.account = playbackConfig.accountID; // Optional
  }

  override func viewDidLoad() {
    super.viewDidLoad()
    // Do any additional setup after loading the view, typically from a nib.

    requestContentFromPlaybackService()
  }

  private func requestContentFromPlaybackService() {
    playbackService.findVideo(withVideoID: playbackConfig.videoID, parameters: nil) { [weak self] (video: BCOVVideo?, jsonResponse: [AnyHashable: Any]?, error: Error?) -> Void in

      if let _video = video {
        //  since "isAutoPlay" is true, setVideos will begin playing the content
        self?.playbackController?.setVideos([_video] as NSArray)
      } else {
        print("ViewController Debug - Error retrieving video: \(error?.localizedDescription ?? "unknown error")")
      }
    }
  }
}

// MARK: - BCOVPlaybackControllerDelegate
extension ViewController: BCOVPlaybackControllerDelegate {

  func playbackController(_ controller: BCOVPlaybackController!, didAdvanceTo session: BCOVPlaybackSession!) {
    NSLog("ViewController Debug - Advanced to new session.")
  }

  func playbackController(_ controller: BCOVPlaybackController!, playbackSession session: BCOVPlaybackSession!, didReceive lifecycleEvent: BCOVPlaybackSessionLifecycleEvent!) {
    NSLog("Event: %@", lifecycleEvent.eventType)
  }
}

// MARK: - UIFocusEnvironment overrides
extension ViewController {

  // Focus Environment override for tvOS 9
  override var preferredFocusedView: UIView? {
    return playerView
  }

  // Focus Environment override for tvOS 10+
  override var preferredFocusEnvironments: [UIFocusEnvironment] {
    return (playerView != nil ? [ playerView! ] : [])
  }
}

fileprivate struct playbackConfig {
    static let accountID = "your account id"
}

//
//  ViewController.swift
//  Simple-Video-Playback
//
//  Copyright © 2018 Brightcove. All rights reserved.
//

import UIKit
import BrightcovePlayerSDK

fileprivate struct playbackConfig {
  static let accountID = "1752604059001"
}

class ViewController: UIViewController {
  @IBOutlet weak var videoContainerView: UIView!

  lazy var playbackController: BCOVPlaybackController? = {
    guard let _playbackController = BCOVPlayerSDKManager.shared().createPlaybackController() else {
      return nil
    }
    _playbackController.delegate = self
    _playbackController.isAutoAdvance = true
    _playbackController.isAutoPlay = true

    return _playbackController
  }()

  lazy var playerView: BCOVTVPlayerView? = {
    // Set yourself as the presenting view controller
    // so that tab bar panels can present other view controllers
    let options = BCOVTVPlayerViewOptions()
    options.presentingViewController = self

    // Create and add to the video container view
    guard let _playerView = BCOVTVPlayerView(options: options) else {
      return nil
    }

    // Link the playback controller to the Player View
    _playerView.playbackController = playbackController

    videoContainerView.addSubview(_playerView)

    _playerView.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
      _playerView.topAnchor.constraint(equalTo: videoContainerView.topAnchor),
      _playerView.rightAnchor.constraint(equalTo: videoContainerView.rightAnchor),
      _playerView.leftAnchor.constraint(equalTo: videoContainerView.leftAnchor),
      _playerView.bottomAnchor.constraint(equalTo: videoContainerView.bottomAnchor)
    ])

    return _playerView
  }()

  required init?(coder aDecoder: NSCoder)
  {
    super.init(coder: aDecoder)
    playbackController?.analytics.account = playbackConfig.accountID;
  }

  override func viewDidLoad() {
    super.viewDidLoad()
    // Do any additional setup after loading the view, typically from a nib.

    // create an array of videos
    var videoArray = [AnyObject]()
    videoArray = [videoWithURL(url: NSURL(string: "https://sdks.support.brightcove.com/assets/videos/hls/laughing_gull/laughing_gull.m3u8")!),
        videoWithURL(url: NSURL(string: "https://sdks.support.brightcove.com/assets/videos/hls/greatblueheron/greatblueheron.m3u8")!)]

    playbackController?.setVideos(videoArray as NSFastEnumeration);
  }

  func videoWithURL(url: NSURL) -> BCOVVideo {
    // set the delivery method for BCOVSources that belong to a video
    let source:BCOVSource = BCOVSource(url: url as URL?, deliveryMethod: kBCOVSourceDeliveryHLS, properties: nil)
    let video = BCOVVideo.init(source: source, cuePoints: BCOVCuePointCollection.init(array: []), properties: [NSObject:AnyObject]())
    return video!
  }
}

// MARK: - BCOVPlaybackControllerDelegate
extension ViewController: BCOVPlaybackControllerDelegate {

  func playbackController(_ controller: BCOVPlaybackController!, didAdvanceTo session: BCOVPlaybackSession!) {
    NSLog("ViewController Debug - Advanced to new session.")
  }

  func playbackController(_ controller: BCOVPlaybackController!, playbackSession session: BCOVPlaybackSession!, didReceive lifecycleEvent: BCOVPlaybackSessionLifecycleEvent!) {
    NSLog("Event: %@", lifecycleEvent.eventType)
  }
}

// MARK: - UIFocusEnvironment overrides
extension ViewController {

  // Focus Environment override for tvOS 9
  override var preferredFocusedView: UIView? {
    return playerView
  }

  // Focus Environment override for tvOS 10+
  override var preferredFocusEnvironments: [UIFocusEnvironment] {
    return (playerView != nil ? [ playerView! ] : [])
  }
}