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

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

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

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

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

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

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

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

1. AppDelegate

2. ViewController

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

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

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

   import BrightcovePlayerSDK

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

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

この例では、 Brightcove 再生 API から返された動画を再生します。これは、Video Cloud ライブラリからコンテンツを取得するための最新かつ推奨される API です。ポリシーキーに慣れていない場合は、「ポリシー API の概要」を参照してください。

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

   • 12行目です:Brightcove再生 API ポリシーキーを定義します
   • 13行目:ビデオクラウドアカウント ID を定義します

   • 14行目:ビデオクラウドビデオ ID を定義します

   // ** Customize these values with your own account information **
   let kViewControllerPlaybackServicePolicyKey = "your policy key"
   let kViewControllerAccountID = "your account id"
   let kViewControllerVideoID = "your video id"

クラスデリゲートを設定する

これにより、アプリはビデオ再生イベントとプレーヤーコントロールイベントをリッスンし、応答することができます。

1. ビューコントローラクラスを次のように更新します。

   class ViewController: UIViewController, BCOVPlaybackControllerDelegate {
   

定数を宣言してビューを設定する

1. ViewControllerクラスに、以下を追加します。

   • 16行目です:共有マネージャを初期化します。BCOVPlayerSDKManagerこのクラスは、SDK エコシステム内に他のオブジェクトを作成できるシングルトンです。
   • 17行目:定数を定義し、アカウント ID とポリシーキーを使用して Brightcove プレイバックサービスを初期化します。BCOVPlaybackServiceクラスは、再生 API からデータを取得するための非同期メソッドを提供します。
   • 18行目線:再生コントローラの定数を定義します。BCOVPlaybackControllerには、再生機能を制御するメソッドがあります。

   • 19行目:ビューの変数を定義します。

   class ViewController: UIViewController, BCOVPlaybackControllerDelegate {
     let sharedSDKManager = BCOVPlayerSDKManager.shared()
     let playbackService = BCOVPlaybackService(accountId: kViewControllerAccountID, policyKey: kViewControllerPlaybackServicePolicyKey)
     let playbackController :BCOVPlaybackController
     @IBOutlet weak var videoContainerView: UIView!

init 関数を作成する

1. 前のステップのコードの下に、init()次のように関数を作成します。
   • 23行目です:共有マネージャを使用して再生コントローラを作成します。

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

   • 29-31 行:デリゲートを設定し、自動アドバンスと自動再生機能をオンにします。

    required init?(coder aDecoder: NSCoder) {
   	playbackController = (sharedSDKManager?.createPlaybackController())!
   
   	super.init(coder: aDecoder)
   
   	playbackController.analytics.account = kViewControllerAccountID // Optional
   
   	playbackController.delegate = self
   	playbackController.isAutoAdvance = true
   	playbackController.isAutoPlay = true
   }

プレーヤーを設定する

1. viewDidLoad()関数で、次を追加します。

   • 39行目:標準の VOD レイアウトを使用して、Brightcoveプレーヤーコントロールを作成および設定します。
   • 44行目線:プレーヤービューをメインビューのサブビューとして追加します。
   • 45行目線:自動サイズ変更マスクをオフにします。
   • 46〜51行目は次のとおりです。自動レイアウトを使用して、プレーヤービューの動的拘束を定義します。
   • 54行目線:プレーヤービューを再生コントローラに関連付けます。

   • 56行目です:requestContentFromPlaybackService関数を呼び出します。この関数は次のステップで定義します。

   override func viewDidLoad() {
     super.viewDidLoad()
     // Do any additional setup after loading the view, typically from a nib.
   
     // Set up our player view. Create with a standard VOD layout.
     guard let playerView = BCOVPUIPlayerView(playbackController: self.playbackController, options: nil, controlsView: BCOVPUIBasicControlView.withVODLayout()) else {
         return
     }
   
     // Install in the container view and match its size.
     self.videoContainerView.addSubview(playerView)
     playerView.translatesAutoresizingMaskIntoConstraints = false
     NSLayoutConstraint.activate([
         playerView.topAnchor.constraint(equalTo: self.videoContainerView.topAnchor),
         playerView.rightAnchor.constraint(equalTo: self.videoContainerView.rightAnchor),
         playerView.leftAnchor.constraint(equalTo: self.videoContainerView.leftAnchor),
         playerView.bottomAnchor.constraint(equalTo: self.videoContainerView.bottomAnchor)
     ])
   
     // Associate the playerView with the playback controller.
     playerView.playbackController = playbackController
   
     requestContentFromPlaybackService()
   }

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

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

1. viewDidLoad()関数の下に、requestContentFromPlaybackService()次のような名前の関数を作成します。

   • 60行目線:指定されたビデオ ID に基づいて、再生 API からビデオオブジェクトを返します。
   • 63号線:再生コントローラにビデオを追加します。

   • 65行線:プレイリストが返されなかった場合、エラーメッセージを書き込みます。

   func requestContentFromPlaybackService() {
     playbackService?.findVideo(withVideoID: kViewControllerVideoID, parameters: nil) { (video: BCOVVideo?, jsonResponse: [AnyHashable: Any]?, error: Error?) -> Void in
   
       if let v = video {
           self.playbackController.setVideos([v] as NSArray)
       } else {
           print("ViewController Debug - Error retrieving video: \(error?.localizedDescription ?? "unknown error")")
       }
     }
   }

コードを見る

これで、ビューコントローラが完成しました。ここに完全なコードがあります：

//
//  ViewController.swift
//  VideoCloudBasicPlayer
//
//  Copyright © 2018 Brightcove, Inc. All rights reserved.
//

import UIKit
import BrightcovePlayerSDK

let kViewControllerPlaybackServicePolicyKey = "your policy key"
let kViewControllerAccountID = "your account id"
let kViewControllerVideoID = "your video id"

class ViewController: UIViewController, BCOVPlaybackControllerDelegate {

  let sharedSDKManager = BCOVPlayerSDKManager.shared()
  let playbackService = BCOVPlaybackService(accountId: kViewControllerAccountID, policyKey: kViewControllerPlaybackServicePolicyKey)
  let playbackController :BCOVPlaybackController
  @IBOutlet weak var videoContainerView: UIView!

  required init?(coder aDecoder: NSCoder) {
    playbackController = (sharedSDKManager?.createPlaybackController())!

    super.init(coder: aDecoder)

    playbackController.analytics.account = kViewControllerAccountID // Optional

    playbackController.delegate = self
    playbackController.isAutoAdvance = true
    playbackController.isAutoPlay = true
  }

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

    // Set up our player view. Create with a standard VOD layout.
    guard let playerView = BCOVPUIPlayerView(playbackController: self.playbackController, options: nil, controlsView: BCOVPUIBasicControlView.withVODLayout()) else {
        return
    }

    // Install in the container view and match its size.
    self.videoContainerView.addSubview(playerView)
    playerView.translatesAutoresizingMaskIntoConstraints = false
    NSLayoutConstraint.activate([
      playerView.topAnchor.constraint(equalTo: self.videoContainerView.topAnchor),
      playerView.rightAnchor.constraint(equalTo: self.videoContainerView.rightAnchor),
      playerView.leftAnchor.constraint(equalTo: self.videoContainerView.leftAnchor),
      playerView.bottomAnchor.constraint(equalTo: self.videoContainerView.bottomAnchor)
    ])

    // Associate the playerView with the playback controller.
    playerView.playbackController = playbackController

    requestContentFromPlaybackService()
  }

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

      if let v = video {
        self.playbackController.setVideos([v] as NSArray)
      } else {
        print("ViewController Debug - Error retrieving video: \(error?.localizedDescription ?? "unknown error")")
      }
    }
  }
}

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

import UIKit
import BrightcovePlayerSDK

let kViewControllerAccountID = "your account id" // For Brightcove registration

class ViewController: UIViewController, BCOVPlaybackControllerDelegate {
    let sharedSDKManager = BCOVPlayerSDKManager.shared()
    let playbackController :BCOVPlaybackController
    @IBOutlet weak var videoContainerView: UIView!

    required init?(coder aDecoder: NSCoder) {
        // Create the Brightcove playback controller
        playbackController = (sharedSDKManager?.createPlaybackController())!

        super.init(coder: aDecoder)

        // Register your app with Brightcove
        playbackController.analytics.account = kViewControllerAccountID

        // Configure the player
        playbackController.delegate = self
        playbackController.isAutoAdvance = true
        playbackController.isAutoPlay = true
    }

    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://solutions.brightcove.com/bcls/assets/videos/Great_Horned_Owl.mp4")!),
                      videoWithURL(url: NSURL(string: "https://solutions.brightcove.com/bcls/assets/videos/Great_Blue_Heron.mp4")!)]

        // Set up the player view with a standard VOD layout.
        guard let playerView = BCOVPUIPlayerView(playbackController: self.playbackController, options: nil, controlsView: BCOVPUIBasicControlView.withVODLayout()) else {
            return
        }

        // Install in the container view and match its size.
        self.videoContainerView.addSubview(playerView)
        playerView.translatesAutoresizingMaskIntoConstraints = false
        NSLayoutConstraint.activate([
            playerView.topAnchor.constraint(equalTo: self.videoContainerView.topAnchor),
            playerView.rightAnchor.constraint(equalTo: self.videoContainerView.rightAnchor),
            playerView.leftAnchor.constraint(equalTo: self.videoContainerView.leftAnchor),
            playerView.bottomAnchor.constraint(equalTo: self.videoContainerView.bottomAnchor)
        ])

        // Associate the playerView with the playback controller.
        playerView.playbackController = playbackController

        // Load the video array into the player and start video playback
        playbackController.setVideos(videoArray as NSArray)
        playbackController.play();
    }

    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!
    }
}

アプリは、iPhone、iPad、またはiOSシミュレータでビルドして実行する準備ができました。プレイリストから動画を再生できるはずです。