ステップバイステップ：Swiftを使用したシンプルなTVビデオアプリ

このサンプルを試すには、次の 2 つの方法があります。

サンプルをダウンロードする

実験のためにXcodeプロジェクト全体をダウンロードしてください。

1. iOS 用ネイティブ SDK サンプルをローカルシステムに複製またはダウンロードします。
2. Player、AppleTV、Swift サンプルアプリに移動します。
3. pod installコマンドを実行します。
4. 新しく作成したワークスペースを開いて実行します。

詳細については、ネイティブ SDK for iOS/tvOS 用のサンプルアプリの実行を参照してください。

このガイドの手順に従ってアプリを構築する

以下の手順に従って、tvOS 用 Brightcove Player SDK を使用するアプリプロジェクトのセットアップについて理解を深めます。次の各について、完全なコードを表示できます。

1. AppDelegate
2. ViewController

ネイティブ SDK のインポート

iOS 用 Brightcove ネイティブプレーヤー SDK は Obj-C で書かれていますが、フレームワークモジュールを Swift プロジェクトにインポートするだけです。

1. import既存のディレクティブの下に以下を追加して、Brightcove ネイティブプレーヤー SDK をインポートします。

   import BrightcovePlayerSDK

あなたの価値でプロジェクトをカスタマイズする

Video Cloud アカウントにアクセスするための値を追加します。

1. importディレクティブの下に、次の値を追加します。

   • 12行目です:Brightcove再生 API ポリシーキーを定義します。この例では、 Brightcove 再生 API から返された動画を再生します。これは、Video Cloud ライブラリからコンテンツを取得するための最新かつ推奨される 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 プレイバックサービスを定義する変数を作成します。これは、最初に呼び出されたときに初期化されます。

   スウィフトを初めて使用する場合は、レイジーストアードプロパティに関するガイドを確認してください。

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

init 関数を作成する

1. init次のように関数を作成します。
   • 64行目です:init () 関数のスーパークラスの実装を呼び出します。

   • 65行線:オプション:Video Cloud アカウント ID を分析に送信します。これは、BCOVVideoクラスをオーバーライドするか、Brightcove Playback サービスまたはカタログを使用しない場合にのみ必要です。

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

Brightcoveライブラリからコンテンツをリクエストする

ビデオコンテンツを再生するには、カタログサービスからプレイリストをリクエストします

1. requestContentFromPlaybackService次の名前の関数を作成します。

   • 75-76行：指定されたビデオ ID に基づいて、再生 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://learning-services-media.brightcove.com/videos/hls/laughing_gull/laughing_gull.m3u8")!),
        videoWithURL(url: NSURL(string: "https://learning-services-media.brightcove.com/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! ] : [])
  }
}