Getting started - ApsaraVideo VOD - Centre de documentation Alibaba Cloud

Utilisez le SDK ApsaraVideo Player pour iOS afin de démarrer rapidement la lecture vidéo.

Prérequis

Vous avez intégré le SDK ApsaraVideo Player pour iOS. Pour plus d'informations, consultez la rubrique Intégrer le SDK.

Projet de démonstration open source

Pour des exemples de code, consultez le module BasicPlayback du projet API-Example. Ce projet de démonstration Objective-C vous aide à intégrer rapidement les fonctionnalités de lecture principales du SDK.

Procédure

Étape 1 : Créer un lecteur

Créez une instance AliPlayer.

// Create a player instance.
AliPlayer mAliPlayer = [[AliPlayer alloc] init];

// Create a view container to display the video and set the rendering view for the player.
UIView playerView = [[UIView alloc] initWithFrame:self.view.bounds];
[self.view addSubview:playerView];
mAliPlayer.playerView = playerView;

[mAliPlayer setTraceID:traceId];

Remarque

La surveillance de la qualité de lecture, le suivi ponctuel et les statistiques de lecture vidéo dépendent tous de la génération de journaux d'instrumentation. La surveillance de la qualité de lecture affiche les données globales relatives à la qualité de la lecture. Le suivi ponctuel vous aide à localiser un utilisateur ou un appareil spécifique, à analyser le comportement de lecture et à identifier rapidement les problèmes.

Les fonctionnalités disponibles varient selon le paramètre setTraceID :

Si vous ne transmettez pas le paramètre setTraceID (valeur par défaut) : la fonctionnalité de génération de journaux d'instrumentation est activée. Vous pouvez utiliser les fonctionnalités de surveillance de la qualité de lecture et de statistiques de lecture vidéo. Vous ne pouvez pas utiliser la fonctionnalité de suivi ponctuel.
Si vous transmettez un traceid au paramètre setTraceID : le traceid est une valeur personnalisée qui doit être un identifiant unique pour votre utilisateur ou l'appareil de l'utilisateur, tel que l'ID utilisateur de votre entreprise, un IMEI (International Mobile Equipment Identity) ou un IDFA (identifier for advertisers). Après avoir transmis le traceid, la fonctionnalité de génération de journaux d'instrumentation est activée. Vous pouvez alors utiliser les fonctionnalités de surveillance de la qualité de lecture, de suivi ponctuel et de statistiques de lecture vidéo.
Si vous définissez le paramètre setTraceID sur DisableAnalytics : la fonctionnalité de génération de journaux d'instrumentation est désactivée. Vous ne pouvez pas utiliser les fonctionnalités de surveillance de la qualité de lecture, de suivi ponctuel ni de statistiques de lecture vidéo.

Étape 2 : Définir la source de lecture

Lecture à l'aide de VidAuth (recommandé)

AVPVidAuthSource *authSource = [[AVPVidAuthSource alloc] init];
authSource.vid = @"Video ID"; // Required. The video ID.
authSource.playAuth = @"<yourPlayAuth>"; // Required. The playback credential. You must call the GetVideoPlayAuth operation of ApsaraVideo VOD to generate the credential.
authSource.region = @"Region"; // For ApsaraVideo Player SDK V5.5.5.0 and later, this parameter is deprecated. You do not need to set the region because the player automatically parses it. For versions earlier than V5.5.5.0, this parameter is required. It specifies the region where ApsaraVideo VOD is activated. Default value: cn-shanghai.
// authSource.authTimeout = 3600; // The validity period of the playback URL, in seconds. This value overwrites the validity period of URL signing that is set in the ApsaraVideo VOD console. If you do not set this parameter, the default value 3600 is used. If you set this parameter, make sure that its value is greater than the actual video duration to prevent the playback URL from expiring before playback is complete.

// Set the playback source.
[mAliPlayer setAuthSource:authSource];

Lecture à l'aide de VidSts

AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
source.vid = @"Video ID"; // Required. The video ID.
source.region = @"Region"; // Required. The region where ApsaraVideo VOD is activated. Default value: cn-shanghai.
source.securityToken = @"<yourSecurityToken>"; // Required. The Security Token Service (STS) token. You must call the AssumeRole operation of STS to generate the token.
source.accessKeySecret = @"<yourAccessKeySecret>"; // Required. The AccessKey secret of the temporary AccessKey pair. You must call the AssumeRole operation of STS to generate the secret.
source.accessKeyId = @"<yourAccessKeyId>"; // Required. The AccessKey ID of the temporary AccessKey pair. You must call the AssumeRole operation of STS to generate the ID.
// source.authTimeout = 3600; // The validity period of the playback URL, in seconds. This value overwrites the validity period of URL signing that is set in the ApsaraVideo VOD console. If you do not set this parameter, the default value 3600 is used. If you set this parameter, make sure that its value is greater than the actual video duration to prevent the playback URL from expiring before playback is complete.
// If you enable HLS encryption parameter pass-through in the ApsaraVideo VOD console and the default parameter name is MtsHlsUriToken, you must set the config and pass it to the vid.

// Set the playback source.
[mAliPlayer setStsSource:source]

Lecture à l'aide de UrlSource

// Create a playback source object and set the playback URL.
// The playback URL can be a third-party video-on-demand (VOD) URL, a playback URL from ApsaraVideo VOD, or a local video URL.
AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:@"Playback URL"];
[mAliPlayer setUrlSource:urlSource];

Remarque

Pour plus d'informations sur les sources de lecture, consultez la rubrique Fonctionnalités de base.

Étape 3 : Démarrer la lecture

// Prepare for playback.
[mAliPlayer prepare];
// After prepare is called, you can synchronously call the start operation. Playback starts automatically after the onPrepared callback is complete.
[mAliPlayer start];

Étape 4 : Arrêter la lecture

// Unbind the player view.
mAliPlayer.playerView = nil;
// Stop playback.
[mAliPlayer stop];
// Release resources synchronously. The stop method is automatically called.
[mAliPlayer destroy];
// Clear the reference to prevent memory leaks.
mAliPlayer = nil;

Références

Pour plus d'informations sur les fonctionnalités du lecteur, telles que le contrôle de la lecture et les écouteurs d'événements, consultez la rubrique Fonctionnalités de base.