Schritt für Schritt: Einfache Video-App mit Objective-C

Es gibt zwei Möglichkeiten, dieses Beispiel auszuprobieren:

Laden Sie das Beispiel herunter

Laden Sie das gesamte Xcode-Projekt zum Experimentieren herunter.

1. Klonen Sie die Native SDK-Beispiele für iOS oder laden Sie sie auf Ihr lokales System herunter.
2. Navigieren Sie zum Player/VideoCloudBasicPlayer/objc Beispiel-App.
3. Führen Sie die pod install Befehl.
4. Öffnen Sie den neu erstellten Arbeitsbereich und führen Sie ihn aus.

Einzelheiten finden Sie im Ausführen von Beispiel-Apps für das native SDK für iOS/tvOS dokumentieren.

Erstellen Sie die App, indem Sie die Schritte in dieser Anleitung befolgen

Gehen Sie wie folgt vor, um sich mit der Einrichtung eines App-Projekts vertraut zu machen, das das Brightcove Player SDK für tvOS verwendet. Sie können den vollständigen Code für jede der folgenden Optionen anzeigen:

1. AppDelegate-Implementierung
2. Controller-Header anzeigen
3. View Controller-Implementierung

Importieren der Brightcove Player SDK-Headerdatei

1. Fügen Sie die folgende Importanweisung für das Brightcove Player SDK hinzu:

   @import BrightcovePlayerSDK;

Passen Sie das Projekt mit Ihren Werten an

Fügen Sie Token- und Playlist-ID-Werte hinzu, um auf Ihr Video Cloud-Konto zuzugreifen.

In diesem Beispiel wird ein Video abgespielt, das von zurückgegeben wird Brightcove-Wiedergabe-API , die neueste und empfohlene API zum Abrufen von Inhalten aus Ihrer Brightcove-Bibliothek. Wenn Sie mit Richtlinienschlüsseln nicht vertraut sind, lesen Sie die Übersicht über die Richtlinien-API.

1. Unter dem #import -Anweisungen, fügen Sie Ihre eigenen Werte für Folgendes hinzu:

   • Zeile 11: Definiert Ihren Brightcove Playback API-Richtlinienschlüssel.
   • Zeile 12: Definiert Ihre Video Cloud-Konto-ID.
   • Zeile 13: Definiert Ihre Video Cloud-Video-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";

Eigenschaften deklarieren

1. Fügen Sie im Abschnitt ViewController-Schnittstelle die folgenden Klassendeklarationen hinzu:

   • Zeile 14: Fügt die Brightcove-Delegaten zum interface. Auf diese Weise kann Ihre App Videowiedergabeereignisse anhören und darauf reagieren.
   • Zeile 16: Definiert die BCOVPlaybackService -Klasse, die asynchrone Methoden zum Abrufen von Daten aus der Playback-API bereitstellt.
   • Zeile 17: Definiert die BCOVPlaybackController, die über Methoden zur Steuerung der Wiedergabefunktion verfügt.
   • Zeile 18: Definiert die Playeransicht für die Brightcove-UI-Steuerelemente.
   • Zeile 19: Definiert die Videocontaineransicht.

   @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

Initialisierungsmethode definieren

1. Definieren Sie im ViewController-Implementierungsabschnitt eine init Funktion, die eine setup Funktion aufruft, die Sie im nächsten Schritt definieren werden.

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

Richten Sie den Player ein

1. Erstellen Sie unter der init Funktion eine Funktion namens setup, die aufgerufen wird, wenn die App geladen wird.

   • Zeile 38: Verwendet den Shared Manager, um einen Playback-Controller zu erstellen. Die BCOVPlayerSDKManager class ist ein Singleton, mit dem Sie andere Objekte im SDK-Ökosystem erstellen können.

   • Zeile 40: Fakultativ: Wenn Sie das überschreiben BCOVVideo Klasse verwenden oder den Brightcove-Player und -Wiedergabedienst oder -Katalog nicht verwenden, müssen Sie Ihre Video Cloud-Konto-ID an Video Cloud Analytics senden. Auf diese Weise können Sie Daten für diese App in Video Cloud Analytics anzeigen.

   • Zeilen 42-44: Legen Sie den Delegierten fest und schalten Sie die Funktionen Autoadvance und Autoplay ein.

   • Zeile 46: Initialisiert den Wiedergabedienst mit Ihrer Konto-ID und Ihrem Richtlinienschlüssel.

   - (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];
   }

Konfigurieren Sie den Player

1. In dem viewDidLoad Funktion gehen Sie wie folgt vor:

   • Zeile 54: Erstellen und legen Sie die Brightcove-Player-Steuerelemente mit dem Standard-VOD-Layout fest.
   • Zeile 56: Fügt die Player-Ansicht als Unteransicht der Hauptansicht hinzu.
   • Zeile 57: Schalte aus Maske mit automatischer Größenanpassung.
   • Zeilen 58-63: Verwenden Automatisches Layout um dynamische Beschränkungen für die Spieleransicht zu definieren.
   • Zeilen 64: Weist die Player-Ansicht der zugehörigen globalen Variablen zu.
   • Zeilen 67: Verknüpft die Player-Ansicht mit dem Wiedergabe-Controller.

   • Zeile 69: Ruft die requestContentFromPlaybackService Funktion, die Sie im nächsten Schritt definieren.

   - (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];
   }

Anfordern von Inhalten aus der Brightcove-Bibliothek

Um Videoinhalte wiederzugeben, fordern Sie ein Video aus Ihrer Video Cloud-Bibliothek an.

1. Unter dem viewDidLoad Funktion, erstellen Sie eine Funktion namens requestContentFromPlaybackService wie folgt:

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

Code ansehen

Die View Controller-Implementierung ist nun abgeschlossen. Hier ist der vollständige Code:

//
//  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

Die App kann auf einem iPhone, iPad oder dem iOS-Simulator erstellt und ausgeführt werden. Sie sollten das Video aus Ihrer Video Cloud-Bibliothek abspielen können.

Weitere Einzelheiten finden Sie in den Brightcove-Player-SDK für iOS-Beispiele.