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

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

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

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

1. iOS 用ネイティブ SDK サンプルをローカルシステムに複製またはダウンロードします。
2. Player/VideoCloudBasicPlayer サンプルアプリに移動します。このサンプルは Swift で書かれており、Swift Package Manager を使用します。動作する参考として使用し、独自のアプリはこのガイドの Objective-C の手順に従って構築してください。
3. サンプルの .xcodeproj ファイルを Xcode で開きます。初回ビルド時に Xcode が Brightcove パッケージを解決します。pod install の手順はありません。
4. シミュレータまたはデバイスを選択し、サンプルをビルドして実行します。

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

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

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

1. AppDelegateの実装
2. ビューコントローラの実装

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

Video Cloud アカウントにアクセスするための Policy Key、アカウント ID、動画 ID を追加します。

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

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

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

   // ** Customize these values with your own account information **
   static NSString * const kViewControllerPlaybackServicePolicyKey = @"your policy key";
   static NSString * const kViewControllerAccountID = @"your account id";
   static NSString * const kViewControllerVideoID = @"your video id";

プロパティを宣言する

1. ViewController インターフェイスセクションで、次のクラス宣言を追加します。

   • 14行目:Brightcoveの代理オブジェクトをに追加しますinterface。これにより、アプリがビデオ再生イベントをリッスンして応答できるようになります。
   • 16行目:クラスを定義します。BCOVPlaybackServiceこのクラスは、Playback API からデータを取得するための非同期メソッドを提供します。
   • 17行目:を定義します。このにはBCOVPlaybackController、再生機能を制御するためのメソッドがあります。
   • 18行目:Brightcove UI コントロールのプレーヤービューを定義します。
   • 19行目:ビデオコンテナビューを定義します。

   @interface ViewController () <BCOVPlaybackControllerDelegate>
   
   @property (nonatomic, strong) BCOVPlaybackService *playbackService;
   @property (nonatomic, strong) id<BCOVPlaybackController> playbackController;
   @property (nonatomic) BCOVPUIPlayerView *playerView;
   @property (nonatomic, weak) IBOutlet UIView *videoContainer;
   
   @end

初期化方法の定義

1. ViewController実装セクションで、initを呼び出す関数setup次のステップで定義する関数。

   @implementation ViewController
   #pragma mark Setup Methods
   
   - (instancetype)initWithCoder:(NSCoder *)coder
   {
   self = [super initWithCoder:coder];
   if (self)
   {
   		[self setup];
   }
   return self;
   }

プレーヤーを設定する

1. init関数の下に、setupアプリケーションのロード時に呼び出されるという名前の関数を作成します。

   • 38行目:共有マネージャを使用して再生コントローラを作成します。BCOVPlayerSDKManagerこのクラスは、SDK エコシステム内に他のオブジェクトを作成できるシングルトンです。

   • 40行目:オプション：動画にアカウントメタデータが含まれない場合（Playback Service を使用せず URL から作成した場合など）、Video Cloud アカウント ID を Video Cloud Analytics に送信します。これにより、このアプリのデータを Video Cloud Analytics で確認できます。

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

   • 46行目:アカウント ID とポリシーキーでプレイバックサービスを初期化します。

   - (void)setup
   {
   _playbackController = [BCOVPlayerSDKManager.sharedManager createPlaybackController];
   
   _playbackController.analytics.account = kViewControllerAccountID; // Optional
   
   _playbackController.delegate = self;
   _playbackController.autoAdvance = YES;
   _playbackController.autoPlay = YES;
   
   _playbackService = [[BCOVPlaybackService alloc] initWithAccountId:kViewControllerAccountID policyKey:kViewControllerPlaybackServicePolicyKey];
   }

プレーヤーを設定する

1. viewDidLoad関数で、次の操作を実行します。

   • 54行目:標準の VOD レイアウトを使用して、Brightcoveプレーヤーコントロールを作成および設定します。
   • 56行目:プレーヤービューをメインビューのサブビューとして追加します。
   • 57行目:自動サイズ変更マスクをオフにします。
   • 58〜63行目:自動レイアウトを使用して、プレーヤービューの動的拘束を定義します。
   • 64行目:プレーヤービューを、関連付けられたグローバル変数に割り当てます。
   • 67行目:プレーヤービューを再生コントローラに関連付けます。

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

   - (void)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.
     BCOVPUIPlayerView *playerView = [[BCOVPUIPlayerView alloc] initWithPlaybackController:self.playbackController options:nil controlsView:[BCOVPUIBasicControlView basicControlViewWithVODLayout] ];
   
     [_videoContainer addSubview:playerView];
     playerView.translatesAutoresizingMaskIntoConstraints = NO;
     [NSLayoutConstraint activateConstraints:@[
         [playerView.topAnchor constraintEqualToAnchor:_videoContainer.topAnchor],
         [playerView.rightAnchor constraintEqualToAnchor:_videoContainer.rightAnchor],
         [playerView.leftAnchor constraintEqualToAnchor:_videoContainer.leftAnchor],
         [playerView.bottomAnchor constraintEqualToAnchor:_videoContainer.bottomAnchor],
     ]];
     _playerView = playerView;
   
     // Associate the playerView with the playback controller.
     _playerView.playbackController = _playbackController;
   
     [self requestContentFromPlaybackService];
   }

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

ビデオコンテンツを再生するには、Video Cloud ライブラリにビデオをリクエストします。

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

   - (void)requestContentFromPlaybackService
   {
     NSDictionary *configuration = @{BCOVPlaybackService.ConfigurationKeyAssetID:kViewControllerVideoID};
     [self.playbackService findVideoWithConfiguration:configuration queryParameters:nil completion:^(BCOVVideo *video, id jsonResponse, NSError *error) {
   
       if (video)
       {
           [self.playbackController setVideos:@[ video ]];
       }
       else
       {
           NSLog(@"ViewController Debug - Error retrieving video: `%@`", error);
       }
   
     }];
   }

コードを見る

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

//
//  ViewController.m
//  Simple-Video-Playback
//

#import "ViewController.h"
@import BrightcovePlayerSDK;

// ** Customize these values with your own account information **
static NSString * const kViewControllerPlaybackServicePolicyKey = @"your policy key";
static NSString * const kViewControllerAccountID = @"your account id";
static NSString * const kViewControllerVideoID = @"your video id";

@interface ViewController () <BCOVPlaybackControllerDelegate>

@property (nonatomic, strong) BCOVPlaybackService *playbackService;
@property (nonatomic, strong) id<BCOVPlaybackController> playbackController;
@property (nonatomic) BCOVPUIPlayerView *playerView;
@property (nonatomic, weak) IBOutlet UIView *videoContainer;

@end

@implementation ViewController
#pragma mark Setup Methods

- (instancetype)initWithCoder:(NSCoder *)coder
{
self = [super initWithCoder:coder];
if (self)
{
		[self setup];
}
return self;
}

- (void)setup
{
_playbackController = [BCOVPlayerSDKManager.sharedManager createPlaybackController];

_playbackController.analytics.account = kViewControllerAccountID; // optional

_playbackController.delegate = self;
_playbackController.autoAdvance = YES;
_playbackController.autoPlay = YES;

_playbackService = [[BCOVPlaybackService alloc] initWithAccountId:kViewControllerAccountID policyKey:kViewControllerPlaybackServicePolicyKey];
}

- (void)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.
BCOVPUIPlayerView *playerView = [[BCOVPUIPlayerView alloc] initWithPlaybackController:self.playbackController options:nil controlsView:[BCOVPUIBasicControlView basicControlViewWithVODLayout] ];

[_videoContainer addSubview:playerView];
  playerView.translatesAutoresizingMaskIntoConstraints = NO;
  [NSLayoutConstraint activateConstraints:@[
    [playerView.topAnchor constraintEqualToAnchor:_videoContainer.topAnchor],
    [playerView.rightAnchor constraintEqualToAnchor:_videoContainer.rightAnchor],
    [playerView.leftAnchor constraintEqualToAnchor:_videoContainer.leftAnchor],
    [playerView.bottomAnchor constraintEqualToAnchor:_videoContainer.bottomAnchor],
]];
_playerView = playerView;

// Associate the playerView with the playback controller.
_playerView.playbackController = _playbackController;

[self requestContentFromPlaybackService];
}

- (void)requestContentFromPlaybackService
{
  NSDictionary *configuration = @{BCOVPlaybackService.ConfigurationKeyAssetID:kViewControllerVideoID};
  [self.playbackService findVideoWithConfiguration:configuration queryParameters:nil completion:^(BCOVVideo *video, id jsonResponse, NSError *error) {

    if (video)
    {
        [self.playbackController setVideos:@[ video ]];
    }
    else
    {
        NSLog(@"ViewController Debug - Error retrieving video: `%@`", error);
    }
  }];
}

@end

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

#import "ViewController.h"
@import BrightcovePlayerSDK;

// ** Customize these values with your own account information **
static NSString * const kViewControllerAccountID = @"your account id";

@interface ViewController () <BCOVPlaybackControllerDelegate>

@property (nonatomic, strong) id<BCOVPlaybackController> playbackController;
@property (nonatomic) BCOVPUIPlayerView *playerView;
@property (nonatomic, weak) IBOutlet UIView *videoContainer;

@end

@implementation ViewController
#pragma mark Setup Methods

- (instancetype)initWithCoder:(NSCoder *)coder
{
self = [super initWithCoder:coder];
if (self)
{
	[self setup];
}
return self;
}

- (void)setup
{
_playbackController = [BCOVPlayerSDKManager.sharedManager createPlaybackController];

_playbackController.analytics.account = kViewControllerAccountID; // optional

_playbackController.delegate = self;
_playbackController.autoAdvance = YES;
_playbackController.autoPlay = YES;
}

- (void)viewDidLoad {
[super viewDidLoad];
// Do any additional setup after loading the view, typically from a nib.

// create an array of videos
NSArray *videos = @[
	[self videoWithURL:[NSURL URLWithString:@"https://solutions.brightcove.com/bcls/assets/videos/Great_Horned_Owl.mp4"]],
	[self videoWithURL:[NSURL URLWithString:@"https://solutions.brightcove.com/bcls/assets/videos/Great_Blue_Heron.mp4"]]
];

// Set up our player view. Create with a standard VOD layout.
BCOVPUIPlayerView *playerView = [[BCOVPUIPlayerView alloc] initWithPlaybackController:self.playbackController options:nil controlsView:[BCOVPUIBasicControlView basicControlViewWithVODLayout] ];

// add the view as a subview of the main view
[_videoContainer addSubview:playerView];
playerView.translatesAutoresizingMaskIntoConstraints = NO;
[NSLayoutConstraint activateConstraints:@[
  [playerView.topAnchor constraintEqualToAnchor:_videoContainer.topAnchor],
  [playerView.rightAnchor constraintEqualToAnchor:_videoContainer.rightAnchor],
  [playerView.leftAnchor constraintEqualToAnchor:_videoContainer.leftAnchor],
  [playerView.bottomAnchor constraintEqualToAnchor:_videoContainer.bottomAnchor],
]];
_playerView = playerView;

// Associate the playerView with the playback controller.
_playerView.playbackController = _playbackController;

// add the video array to the controller's playback queue
[self.playbackController setVideos:videos];
// play the first video
[self.playbackController play];
}

- (BCOVVideo *)videoWithURL:(NSURL *)url
{
// set the delivery method for BCOVSources that belong to a video
BCOVSource *source = [[BCOVSource alloc] initWithURL:url deliveryMethod:BCOVSource.DeliveryMP4 properties:nil];
return [[BCOVVideo alloc] initWithSource:source cuePoints:[BCOVCuePointCollection collectionWithArray:@[]] properties:@{}];
}

- (void)didReceiveMemoryWarning {
[super didReceiveMemoryWarning];
// Dispose of any resources that can be recreated.
}

@end

アプリは、iPhone、iPad、またはiOSシミュレータでビルドして実行する準備ができました。Video Cloud ライブラリからビデオを再生できるはずです。