サポート問い合わせ先| システムステータス
ページコンテンツ

    iOS:メディアコンテンツの操作

    このトピックでは、Native SDK foriOSを使用してビデオを取得して再生する方法を学習します。

    概要

    Video Cloud のお客様は、Video Cloud Studio からメディアデータとメタデータにアクセスできます。Brightcoveプレーヤーのお客様は、メディアコンテンツの URL を指定します。

    ビデオクラウドのお客様

    Video Cloud のお客様は、Video Cloud Studio に保存されているメディアデータにアクセスできます。詳細については、 iOS 用ネイティブ Player SDK コードサンプルを参照してください

    メディアデータを取得しています

    再生 API を使用して、Video Cloud ライブラリからビデオとプレイリストデータを取得できます。API の詳細については、「再生 API の概要」ドキュメントを参照してください。

    1. BCOVPlaybackServiceクラスメソッドを使用して、Brightcoveの再生 API から動画と再生リストを取得します。あなたの要求は、IDビデオ/プレイリストを提供することができますReferenceID .このサービスは、URL 要求を行い、返されたデータを解析します。

    2. このリクエストには、ポリシーキーが必要です。ポリシーキーに慣れていない場合は、「ポリシー API の概要」ドキュメントを参照してください。

      BCOVPlaybackService Swiftのクラスを使用してビデオを取得する方法の例は次のとおりです。

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

      完全なサンプルについては、以下を参照してください。

    3. 以下に示すように、 BCovVVideoオブジェクトは、ビデオのメタデータ情報を提供します。

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

      print()上記のメソッドは、次のメディア情報を返します。

      Video object
      Videoオブジェクト

    ジオフィルタリングされたビデオの操作

    iOS 用 Brightcove Player SDK は、ジオフィルタリングされた動画をサポートしています。

    動画にジオフィルターを追加して、視聴できる (またはできない国) を制御するには、次の 2 つの方法があります。

    iOS アプリで、その動画でジオフィルターが適用されている国で Brightcove BCOVPlaybackServiceのクラス(再生 API)を使用して動画を取得すると、次のメッセージが表示されます。

    Error Domain=kBCOVPlaybackServiceErrorDomain Code=3 "(null)"
    UserInfo={kBCOVPlaybackServiceErrorKeyAPIHTTPStatusCode=403,
    kBCOVPlaybackServiceErrorKeyAPIErrors=
    {type = immutable, count = 1, values = (
    0 : {type = immutable dict, count = 4,
    entries =>
    1 : message = {contents = "Access to this resource is forbidden by access policy."}
    2 : {contents = "client_geo"} = us
    4 : {contents = "error_subcode"} = {contents = "CLIENT_GEO"}
    6 : {contents = "error_code"} = {contents = "ACCESS_DENIED"}
    }
    )}}

    Brightcoveプレーヤーのお客様

    Brightcove Player の顧客は、動画アセットの URL を指定します。

    次に、再生コントローラにビデオの配列を追加して再生を開始する例を示します。

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

    完全なサンプルについては、以下を参照してください。

    これで、iOS 用 Brightcove Player SDK の基本を理解しました。次に、Player SDK を使用するアプリを構築する手順を説明します。


    ページの最終更新日21 May 2021