逐步：簡單的電視視頻應用程序

有兩種方法可以嘗試這個範例：

下載範例

下載整個 Xcode 項目進行實驗。

1. 克隆或下載適用於 iOS 示例的本機 SDK到您的本地系統。
2. 導航到播放器/AppleTV/swift示例應用程序。
3. 跑過pod install命令。
4. 開啟並執行新建立的工作區。

有關詳細信息，請參閱為適用於 iOS/tvOS 的本機 SDK 運行示例應用程序文檔。

依照本指南中的步驟建置應用程式

請依照下列步驟熟悉設定使用適用於 tvOS 的 Brightcove 播放程式 SDK 的應用程式專案。您可以檢視下列各項的完整程式碼：

1. 應用程式代表
2. 檢視控制器

匯入原生 SDK

雖然 iOS 的布萊特灣本機播放器 SDK 是用 Obj-C 編寫的，我們可以簡單地導入框架模塊到我們的 Swift 項目。

1. 低於現有的import指令，添加以下內容以導入 Brightcove Native Player SDK：

   import BrightcovePlayerSDK

使用您的價值自訂專案

新增值以存取您的視訊雲端帳戶。

1. 以下import指令，為以下內容添加您自己的值：

   • 第 12 行：定義您的布萊特灣播放 API 原則金鑰。此示例播放從Brightcove 回放 API，這是最新推薦的 API，用於從您的視頻雲庫中檢索內容。如果您不熟悉策略密鑰，請參閱策略 API 概述 .

   • 第 13 行：定義您的視訊雲端帳戶 ID

   • 第 14 行：定義您的視訊雲端視訊 ID

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

建立視圖變數

1. 在裡面ViewController類，為視圖添加一個變量。

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

創建播放服務

1. 創建一個變量，該變量使用您的帳戶ID和策略密鑰定義Brightcove回放服務。它將在第一次調用時初始化。

   如果您是 swift 的新手，請查看有關的指南惰性存儲屬性 .

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

建立播放控制器

1. 建立定義 Brightcove 播放控制器的變數。這將在第一次被調用時創建。

   • 第28-30行：設置代表並打開自動前進和自動播放功能。

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

定義播放器檢視

1. 創建一個名為createTVPlayerView如下：

   • 38-39行：定義播放器視圖，以便標籤欄面板可以呈現其他視圖控制器。
   • 第42-44行：創建播放器視圖並將其添加到視頻容器視圖。
   • 第47行：將播放器視圖與播放控制器產生關聯。
   • 第 49 行：添加播放器視圖作為主視圖的子視圖。
   • 第51行：關自動調整掩碼 .

   • 第52-57行：使用「自動佈局」來定義播放器視圖的動態約束。

   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
   }()

創建一個初創函數

1. 創建一個init功能如下：
   • 第64行：調用 init（）函數的超類實現。

   • 第 65 行：選用性：將您的視訊雲端帳號 ID 傳送至分析。僅當您覆蓋BCOVVideo類或不使用 Brightcove 回放服務或目錄。

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

加載視圖後的處理

1. 在裡面viewDidLoad方法添加以下內容：

   • 第72行：調用requestContentFromPlaybackService函數，我們將在下一步中定義。

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

向布萊特灣圖書館索取內容

為了播放視頻內容，您將從目錄服務請求播放列表

1. 創建一個名為requestContentFromPlaybackService如下：

   • 第75-76行：根據給定的視頻ID，從Playback API返回視頻對象。
   • 第80行：將視頻添加到播放控制器。
   • 第82行：如果未返回播放列表，則會寫入錯誤消息。

   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")")
       }
     }
   }

延伸播放控制器

這可讓您的應用程式聆聽和回應視訊播放事件。

1. 擴展視圖控制器以包含 Brightcove 播放控制器委託，並監聽播放事件。如果您是 swift 的新手，請查看有關的指南擴展 .

   // 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)
     }
   }

剩下的

1. 建立功能來處理舊版 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! ] : [])
     }
   }

檢視程式碼

視圖控制器現在已完成。這是完整的代碼：

//
//  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! ] : [])
  }
}