逐步：使用目標 C 的簡單視頻應用程序

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

下載範例

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

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

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

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

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

1. 應用程式代表實作
2. 檢視控制器標頭
3. View Controller實施

導入Brightcove Player SDK頭文件

1. 為Brightcove Player SDK添加以下導入語句：

   @import BrightcovePlayerSDK;

使用您的價值自訂專案

添加令牌和播放列表ID值以訪問您的視頻雲帳戶。

此示例播放從Brightcove 回放 API，這是最新推薦的 API，用於從您的視頻雲庫中檢索內容。如果您不熟悉策略密鑰，請參閱策略 API 概述 .

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

   • 第 11 行：定義您的布萊特灣播放 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 行：定義布萊特灣 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 class 是一個單例，允許您在 SDK 生態系統中創建其他對象。

   • 40行：選用性：如果你覆蓋BCOVVideo類或不使用 Brightcove 播放器和播放服務或目錄，您需要將您的視頻雲帳戶 ID 發送到視頻雲分析。這可讓您在視訊雲端分析中檢視此應用程式的資料。

   • 第 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 佈局，創建和設置布萊特灣播放器控制。
   • 第 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];
   }

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

為了播放視頻內容，您將從視頻雲庫中請求視頻。

1. 以下viewDidLoad函數，創建一個名為requestContentFromPlaybackService如下：

   - (void)requestContentFromPlaybackService
   {
   [self.playbackService findVideoWithVideoID:kViewControllerVideoID parameters:nil completion:^(BCOVVideo *video, NSDictionary *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
{
[self.playbackService findVideoWithVideoID:kViewControllerVideoID parameters:nil completion:^(BCOVVideo *video, NSDictionary *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"

// ** 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:kBCOVSourceDeliveryHLS 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 模擬器上構建和運行。您應該可以從“視頻雲”庫中播放視頻。

有關更多詳細信息，請查看 適用於 iOS 示例的 Brightcove Player SDK 。