Paso a paso: Aplicación de video simple usando Objective-C

Hay dos formas de probar este ejemplo:

Descarga la muestra

Descarga todo el proyecto de Xcode para experimentar.

1. Clona o descarga el SDK nativo para muestras de iOS a su sistema local.
2. Navega al Reproductor / VideoCloudBasicPlayer / objc aplicación de muestra.
3. Ejecutar el pod install mando.
4. Abra y ejecute el espacio de trabajo recién creado.

Para obtener más detalles, consulte la Ejecución de aplicaciones de muestra para el SDK nativo para iOS / tvOS documento.

Cree la aplicación siguiendo los pasos de esta guía

Siga los pasos a continuación para familiarizarse con la configuración de un proyecto de aplicación que utilice Brightcove Player SDK para tvOS. Puede ver el código completo para cada uno de los siguientes:

1. Implementación de AppDelegate
2. Ver encabezado del controlador
3. Ver implementación del controlador

Importar el archivo de encabezado de Brightcove Player SDK

1. Agregue la siguiente declaración de importación para Brightcove Player SDK:

   @import BrightcovePlayerSDK;

Personaliza el proyecto con tus valores

Agregue valores de identificación de token y lista de reproducción para acceder a su cuenta de Video Cloud.

Este ejemplo reproduce un video devuelto por API de reproducción de Brightcove , que es la API más reciente y recomendada para recuperar contenido de su biblioteca de Video Cloud. Si no está familiarizado con las claves de política, consulte la Descripción general de la API de políticas.

1. Bajo la #import directivas, agregue sus propios valores para lo siguiente:

   • Línea 11: Define la clave de política de la API de reproducción de Brightcove.
   • Línea 12: Define su ID de cuenta de Video Cloud.
   • Línea 13: Define su ID de video de 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";

Declarar propiedades

1. En la sección de la interfaz ViewController, agregue las siguientes declaraciones de clase:

   • Línea 14: Agrega los delegados de Brightcove a la interface. Esto permite que su aplicación escuche y responda a eventos de reproducción de video.
   • Línea 16: Define el BCOVPlaybackService class, que proporciona métodos asincrónicos para recuperar datos de la API de reproducción.
   • Línea 17: Define el BCOVPlaybackController , que tiene métodos para controlar la funcionalidad de reproducción.
   • Línea 18: Define la vista del reproductor para los controles de la interfaz de usuario de Brightcove.
   • Línea 19: Define la vista del contenedor de video.

   @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

Definir el método de inicialización

1. En la sección de implementación de ViewController, defina un init función que llama a setup función que definirá en el siguiente paso.

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

Configurar el reproductor

1. Bajo la init función, crea una función llamada setup , que se llama cuando se carga la aplicación.

   • Línea 38: Utiliza el administrador compartido para crear un controlador de reproducción. La BCOVPlayerSDKManager class es un singleton que le permite crear otros objetos en el ecosistema SDK.

   • Línea 40: Opcional: Si anula el BCOVVideo class o no utilice el catálogo o el servicio de reproducción y reproducción de Brightcove, debe enviar su ID de cuenta de Video Cloud a Video Cloud Analytics. Esto le permite ver los datos de esta aplicación en Video Cloud Analytics.

   • Líneas 42-44: configure el delegado y active las funciones de avance automático y reproducción automática.

   • Línea 46: Inicializa el servicio de reproducción con su ID de cuenta y Clave de política.

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

Configurar el reproductor

1. En el viewDidLoad función haga lo siguiente:

   • Línea 54: Cree y configure los controles del reproductor Brightcove, utilizando el diseño estándar de VOD.
   • Línea 56: Agrega la vista del reproductor como una subvista de la vista principal.
   • Línea 57: Apagar máscara de cambio de tamaño automático.
   • Líneas 58-63: Usar Diseño automático para definir restricciones dinámicas para la vista del jugador.
   • Líneas 64: Asigna la vista del jugador a su variable global asociada.
   • Líneas 67: Asocia la vista del reproductor con el controlador de reproducción.

   • Línea 69: Llama al requestContentFromPlaybackService función, que definirá en el siguiente paso.

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

Solicitar contenido de la biblioteca de Brightcove

Para reproducir contenido de video, solicitará un video de su biblioteca de Video Cloud.

1. Bajo la viewDidLoad función, crea una función llamada requestContentFromPlaybackService como sigue:

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

Ver el código

La implementación de View Controller ahora está completa. Aquí está el código completo:

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

La aplicación está lista para compilarse y ejecutarse en un iPhone, iPad o el simulador de iOS. Debería poder reproducir el video desde su biblioteca de Video Cloud.

Para obtener más detalles, consulte Brightcove Player SDK for iOS Samples .