Étape par étape : Application vidéo simple utilisant Objective-C

Vous pouvez essayer cet exemple de deux manières :

Télécharger l'exemple

Téléchargez l'intégralité du projet Xcode pour l'expérimentation.

1. Clonez ou téléchargez le Exemples de SDK natif pour iOS à votre système local.
2. Naviguez vers le Player/VideoCloudBasicPlayer/objc exemple d'application.
3. Exécutez le pod install commander.
4. Ouvrez et exécutez l'espace de travail nouvellement créé.

Pour plus de détails, consultez le Exécuter des exemples d'applications pour le SDK natif pour iOS/tvOS document.

Créez l'application en suivant les étapes de ce guide

Suivez les étapes ci-dessous pour vous familiariser avec la configuration d'un projet d'application qui utilise le Brightcove Player SDK pour tvOS. Vous pouvez afficher le code complet pour chacun des éléments suivants :

1. Implémentation d'AppDelegate
2. Afficher l'en-tête du contrôleur
3. Voir la mise en œuvre du contrôleur

Importer le fichier d'en-tête Brightcove Player SDK

1. Ajoutez la déclaration d'importation suivante pour le Brightcove Player SDK :

   @import BrightcovePlayerSDK;

Personnalisez le projet avec vos valeurs

Ajoutez des valeurs d'identifiant de jeton et de liste de lecture pour accéder à votre compte Video Cloud.

Cet exemple montre une vidéo renvoyée par l'API Brightcove Playback, qui est l'API la plus récente et recommandée pour récupérer du contenu de votre bibliothèque Video Cloud. Si vous n'êtes pas familiarisé avec les clés de stratégie, consultez le Présentation de l'API des règles.

1. Sous le #import directives, ajoutez vos propres valeurs pour les éléments suivants :

   • Ligne 11 : Définit votre clé de politique d'API de lecture Brightcove.
   • Ligne 12 : Définit votre ID de compte Video Cloud.
   • Ligne 13 : Définit votre ID vidéo Video Cloud.

   // ** 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";

Déclarer des propriétés

1. Dans la section d'interface ViewController, ajoutez les déclarations de classe suivantes :

   • Ligne 14 : Ajoute les délégués de Brightcove au interface. Cela permet à votre application d'écouter et de répondre aux événements de lecture vidéo.
   • Ligne 16 : Définit le BCOVPlaybackService classe, qui fournit des méthodes asynchrones pour récupérer des données à partir de l'API Playback.
   • Ligne 17 : Définit le BCOVPlaybackController, qui propose des méthodes pour contrôler la fonctionnalité de lecture.
   • Ligne 18 : Définit la vue du lecteur pour les commandes de l'interface utilisateur de Brightcove.
   • Ligne 19 : Définit la vue du conteneur vidéo.

   @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

Définir la méthode d'initialisation

1. Dans la section d'implémentation de ViewController, définissez un init fonction qui appelle un setup fonction que vous définirez à l'étape suivante.

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

Configurer le lecteur

1. Sous la init fonction, créez une fonction nommée setup, qui est appelée lors du chargement de l'application.

   • Ligne 38 : Utilise le gestionnaire partagé pour créer un contrôleur de lecture. Les BCOVPlayerSDKManager class est un singleton qui vous permet de créer d'autres objets dans l'écosystème SDK.

   • Ligne 40 : Facultatif : Si vous remplacez le BCOVVideo ou n'utilisez pas le lecteur et le service ou le catalogue de lecture Brightcove, vous devez envoyer votre ID de compte Video Cloud à Video Cloud Analytics. Cela vous permet d'afficher les données de cette application dans Video Cloud Analytics.

   • Lignes 42 à 44 : définissez le délégué et activez les fonctionnalités d'avance automatique et de lecture automatique.

   • Ligne 46 : Initialise le service de lecture avec votre identifiant de compte et votre clé de stratégie.

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

Configurer le lecteur

1. Dans le viewDidLoad fonction, procédez comme suit :

   • Ligne 54 : Créez et définissez les commandes du lecteur Brightcove à l'aide de la disposition VOD standard.
   • Ligne 56 : Ajoute la vue du lecteur en tant que sous-vue de la vue principale.
   • Ligne 57 : Éteindre masque de redimensionnement automatique.
   • Lignes 58 à 63 : Utilisation Mise en page automatique pour définir des contraintes dynamiques pour la vue joueur.
   • Lignes 64 : Affecte la vue du lecteur à sa variable globale associée.
   • Lignes 67 : Associe la vue du lecteur au contrôleur de lecture.

   • Ligne 69 : Appelle le requestContentFromPlaybackService fonction, que vous définirez à l'étape suivante.

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

Demander du contenu à la bibliothèque Brightcove

Afin de lire le contenu vidéo, vous demanderez une vidéo à votre bibliothèque Video Cloud.

1. Sous la viewDidLoad fonction, créez une fonction nommée requestContentFromPlaybackService comme suit :

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

Voir le code

L'implémentation de View Controller est maintenant terminée. Voici le code complet :

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

L'application est prête à être créée et exécutée sur un iPhone, un iPad ou le simulateur iOS. Vous devriez pouvoir lire la vidéo à partir de votre bibliothèque Video Cloud.

Pour plus de détails, consultez les échantillons du SDK du lecteur Brightcove pour iOS.