Application native iPhone

Ce document décrit l’application créée à l’aide de la version 2.0 du SDK Brightcove pour iOS. Si vous voulez en savoir plus sur le SDK, dont les documents à télécharger pour commencer à créer vos applications pour l'iPhone, consultez la rubrique Guide de démarrage avec le SDK iOS de Brightcove.

Veuillez télécharger le fichier source One Planet pour iPhone.

Il est possible que vous connaissiez déjà l’application One Planet qui a fait l'objet d'un article précédent. Le présent article traite d’une application parallèle propre à l’iPhone et à l’iPod Touch, à la différence de l’application en ligne accessible à l'aide du navigateur Safari. Pour plus de simplicité, nous utiliserons la dénomination « One Planet » pour faire référence à l’application test.

Vous pourrez également consulter les autres documents relatifs au SDK pour iOS de Brightcove :

• Guide de démarrage avec le SDK iOS de Brightcove. Présentation du SDK.
• Cet épisode sur DevTV est une présentation vidéo du SDK iOS de Brightcove.
• SDK iOS de Brightcove. Liens vers les fichiers zip qui contiennent les dernières versions des classes de SDK, des documents de référence et des échantillons de code pour l’application OnePlanet native à l’iPhone.
• Référence pour le SDK pour iOS de Brightcove. Une référence en ligne pour le SDK iOS de Brightcove.
• Meilleures pratiques pour développer des applications Brightcove pour iOS. Astuces, conseils et points importants à propos du développement d'applications Brightcove pour iOS.
• Problèmes connus pour le SDK iOS de Brightcove

Voici un aperçu de One Planet :

Nous avons mis au point One Planet à l’aide du SDK pour iOS de Brightcove et les API médias de Brightcove (Lecture). Ce SDK, actuellement en phase de développement, offre une structure qui permettra de créer votre application iOS native à même de diffuser les vidéos Brightcove sur l'iPhone, l'iPad et les autres périphériques iOS. En savoir plus sur l’installation et l’utilisation du SDK Brightcove pour iOS.

Installation, conception et démarrage d'One Planet

Vous pouvez lancer One Planet de deux manières sur votre périphérique :

• A l’aide de Xcode
• A l’aide d’Apple Store et iTunes

A l’aide de Xcode

Avant d’installer One Planet sur votre appareil à l’aide d’Xcode, vous devrez demander et obtenir un certificat de développement et un profil provisoire. Pour ce faire, consultez le Programme des développeurs pour l’iPhone sur Apple Developer Connection.

L’installation par Xcode suppose que vous ayez déjà Xcode et le SDK pour iPhone de Brightcove installés sur votre ordinateur. Téléchargez le SDK pour iOS et ouvrez le fichier BrightcoveDemo.Xcodeproj. Vous pouvez exécuter One Planet à l'aide de votre périphérique ou par le simulateur d'iPhone d'Xcode. Si vous décidez d’installer et d’exécuter One Planet sur votre périphérique, veillez à ce que votre appareil soit connecté à Internet. Une fois la cible de l'installation choisie, cliquez sur Build & Go et One Planet créera, installera et exécutera les fichiers sur la cible.

A l’aide d’Apple Store et iTunes

One Planet est disponible sur l'iTunes Store. Après avoir téléchargé et installé l’application, sélectionnez-la à l’aide de l’écran de votre appareil.

One Planet en action

Le meilleur moyen de décrire le comportement d’One Planet consiste à faire appel à une série de scénarios, en commençant par le démarrage de l'application.

Démarrage et menus

Au démarrage d'One Planet, la fenêtre Channels (Canaux) s'affiche. L’affichage contient un appel à PlaylistTableViewController.fetchAllPlaylists, qui renvoie une BCItemCollection de sélections (maximum 10).

En cas de sélection d’un canal, un nouveau VideoTableViewController est affecté et ajouté aux commandes de navigation. Pour charger les vidéos du canal, VideoTableViewController lance un appel à loadTableDataFromBrightcoveForPlaylist. 

- (void)loadTableDataFromBrightcoveForPlaylist {

// affiche un indicateur de chargement et la répartition

BrightcoveDemoAppDelegate *delegate = (BrightcoveDemoAppDelegate *)[[UIApplication sharedApplication] delegate];

BCMediaAPI *bc = delegate.bcServices;

NSError *err;

BCPlaylist *playlist = [bc findPlaylistById:self.playlistId videoFields:[NSArray arrayWithObjects:@"id", @"FLVURL", @"thumbnailURL", @"name", @"shortDescription", @"renditions", nil] playlistFields:[NSArray arrayWithObjects:@"name", @"videos", nil] customFields:nil error:&err];

if (!playlist) {
[ErrorHandlerService logMediaAPIError:err];
}

self.videos = playlist.videos;
self.title = playlist.name;
[self.tableView reloadData];
}

La liste des vidéos figure dans l'objet BCPlaylist.

Affichage « Newest Videos »

En cas de sélection de l’affichage Newest Videos (Dernières vidéo), la fonction VideoTableViewController est affectée et ajoutée aux commandes de navigation. La commande VideoTableViewController lance un appel à initWithNibAndType, et la fonction listType présente l’attribut RECENT_VIDEOS. Avec la méthode initWithNibAndType, l’appel est adressé à loadTableDataFromBrightcoveForAllVideos. 

- (void)loadTableDataFromBrightcoveForAllVideos {

//[self showLoaderScreen];
BrightcoveDemoAppDelegate *delegate = (BrightcoveDemoAppDelegate *)[[UIApplication sharedApplication] delegate];
BCMediaAPI *bc = delegate.bcServices;
BCSortOrderType sortOrder;
NSError *err;
BCItemCollection *videoCollection;

if (videoListType == POPULAR) {
sortOrder = BCSortByTypePlaysTrailingWeek;
}

else {
sortOrder = BCSortByTypeModifiedDate;
}

videoCollection = [bc findAllVideos:10 pageNumber:0 sortBy:sortOrder sortOrder:BCSortOrderTypeDESC getItemCount:NO videoFields:[NSArray arrayWithObjects:@"id", @"FLVURL", @"thumbnailURL", @"name", @"shortDescription", @"renditions", nil] customFields:nil error:&err];

if (!videoCollection) {
[ErrorHandlerService logMediaAPIError:err];
}

self.videos = videoCollection.items;
[self.tableView reloadData];
}

Dans loadTableDataFromBrightcoveForAllVideos, le paramètre sortBy présente la valeur BCSortByTypeModifiedDate, la fonction sortOrder présente la valeur DESC, et un appel est envoyé à BCMediaAPI.findAllVideos avec ces paramètres. Un ensemble BCItemCollection de vidéos est renvoyé (max. : 10).

Affichage « Popular Videos »

En cas de sélection de l’affichage Popular Videos (Vidéos populaires), la fonction VideoTableViewController est affectée et ajoutée aux commandes de navigation. La commande VideoTableViewController lance un appel à initWithNibAndType, et la fonction listType présente l’attribut POPULAR. Avec la méthode initWithNibAndType, l’appel est adressé à loadTableDataFromBrightcoveForAllVideos.  Dans loadTableDataFromBrightcoveForAllVideos, le paramètre sortBy présente la valeur BCSortByTypePlaysTrailingWeek, la fonction sortOrder présente la valeur DESC et un appel est adressé à BCMediaAPI.findAllVideos avec ces paramètres. Un ensemble BCItemCollection de vidéos est renvoyé (max. : 10).

- (void)loadTableDataFromBrightcoveForAllVideos {

//[self showLoaderScreen];

BrightcoveDemoAppDelegate *delegate = (BrightcoveDemoAppDelegate *)
  [[UIApplication sharedApplication] delegate];
BCMediaAPI *bc = delegate.bcServices;
BCSortOrderType sortOrder;
NSError *err;
BCItemCollection *videoCollection;

if (videoListType == POPULAR) {
sortOrder = BCSortByTypePlaysTrailingWeek;
}

else {
sortOrder = BCSortByTypeModifiedDate;
}

videoCollection = [bc findAllVideos:10 pageNumber:0 sortBy:sortOrder
  sortOrder:BCSortOrderTypeDESC getItemCount:NO
  videoFields:[NSArray arrayWithObjects:@"id", @"FLVURL", @"thumbnailURL", @"name",
     @"shortDescription", @"renditions", nil] customFields:nil error:&err];

if (!videoCollection) {
[ErrorHandlerService logMediaAPIError:err];
}

self.videos = videoCollection.items;
[self.tableView reloadData];
}

- (id)initWithType:(videoList) pListType {
 [super init];
 listType = pListType;
 
 return self;
 }

Si vous avez besoin d’aide ou avez une question, consultez nos forums. Vous pouvez aussi suivre le SDK pour iOS de Brightcove sur Twitter : http://twitter.com/bciphonesdk ou vous abonner aux mises à jour et annonces sur les SDK mobiles par courrier électronique.