ApsaraVideo VOD:Lire une vidéo chiffrée

VidAuth for VOD

Lorsque vous lisez une vidéo HLS ou MP4 chiffrée de manière privée via la méthode VidAuth d'ApsaraVideo VOD, si cette vidéo possède également des flux non chiffrés ou transcodés de façon standard, définissez le type de chiffrement sur AliyunVoDEncryption afin de lire uniquement le flux chiffré de manière privée.

AVPVidAuthSource *authSource = [[AVPVidAuthSource alloc] init];
authSource.vid = @"Your video ID"; // Required. The video ID.
authSource.playAuth = @"<yourPlayAuth>"; // Required. The playback credential. You can obtain this credential by calling the GetVideoPlayAuth operation of ApsaraVideo VOD.
authSource.region = @"Your region"; // This parameter is deprecated in Player SDK V5.5.5.0 and later. You do not need to set the region because the player automatically parses it. For SDK versions earlier than 5.5.5.0, this parameter is required. It specifies the region where ApsaraVideo VOD is activated. Default value: cn-shanghai.
// authSource.authTimeout = 3600; // Optional. The validity period of the playback URL in seconds. This value overrides the validity period of URL authentication that is configured 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 the playback is complete.

// Build the config by using VidPlayerConfigGenerator.
VidPlayerConfigGenerator* config = [[VidPlayerConfigGenerator alloc]init];
[config addVidPlayerConfigByStringValue:@"EncryptType" value:@"AliyunVoDEncryption"]; // Optional. If you set the encryption type to AliyunVoDEncryption, only privately encrypted video streams are returned.
authSource.playConfig = [config generatePlayerConfig]; 
[self.player setAuthSource:authSource];

VidSts for VOD

Si vous lisez une vidéo HLS ou MP4 chiffrée de manière privée avec la méthode VidSts d'ApsaraVideo VOD, et que celle-ci contient aussi des flux non chiffrés ou transcodés de façon standard, définissez le type de chiffrement sur AliyunVoDEncryption pour ne lire que le flux chiffré de manière privée.

AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
source.region = @"Your region"; // Required. The region where ApsaraVideo VOD is activated. Default value: cn-shanghai.
source.vid = @"Your video ID"; // Required. The video ID.
source.securityToken = @"<yourSecurityToken>"; // Required. The security token. You can obtain this token by calling the AssumeRole operation of STS.
source.accessKeySecret = @"<yourAccessKeySecret>"; // Required. The AccessKey secret of the temporary STS credential. You can obtain this credential by calling the AssumeRole operation of STS.
source.accessKeyId = @"<yourAccessKeyId>"; // Required. The AccessKey ID of the temporary STS credential. You can obtain this credential by calling the AssumeRole operation of STS.
// source.authTimeout = 3600; // Optional. The validity period of the playback URL in seconds. This value overrides the validity period of URL authentication that is configured 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 the playback is complete.

// Build the config by using VidPlayerConfigGenerator.
VidPlayerConfigGenerator* config = [[VidPlayerConfigGenerator alloc]init];
[config addVidPlayerConfigByStringValue:@"EncryptType" value:@"AliyunVoDEncryption"]; // Optional. If you set the encryption type to AliyunVoDEncryption, only privately encrypted video streams are returned.
source.playConfig = [config generatePlayerConfig]; 

// Set the playback source.
[self.player setStsSource:source];

LiveStsSource for live

Pour lire un flux en direct chiffré de manière privée au format HLS ou FLV via la méthode LiveStsSource, fournissez l'URL du flux ainsi qu'un identifiant STS, puis définissez le type de chiffrement de la vidéo sur ENCRYPTION_TYPE_ALIVODENCRYPTION. L'exemple de code suivant illustre cette opération :

1. Créez une source de données.

   Vous devez transmettre AVPLiveStsSource comme source de lecture.

   // Create a LiveSts object and set encryptionType to ENCRYPTION_TYPE_ALIVODENCRYPTION.
   AVPLiveStsSource *liveStsSource = [[AVPLiveStsSource alloc] initWithUrl:@"Encrypted live stream URL" 
                                                               accessKeyId:@"Temporary AccessKey ID" 
                                                               accessKeySecret:@"Temporary AccessKey secret" 
                                                               securityToken:@"Security token" 
                                                               region:@"Region value" 
                                                               domain:@"Streaming domain for the URL" 
                                                               app:@"Application name for streaming" 
                                                               stream:@"Stream name for streaming" 
                                                               encryptionType:ENCRYPTION_TYPE_ALIVODENCRYPTION];// Required. Set the encryption type to ENCRYPTION_TYPE_ALIVODENCRYPTION.
    // Set the playback source.
    [self.aliPlayer setLiveStsSource:liveStsSource];
    ......
    // Prepare for playback.
    [self.aliPlayer prepare];

2. Surveillez l'invalidation de l'identifiant STS.

   Pendant la lecture d'un flux en direct chiffré, la clé de chiffrement peut faire l'objet d'une rotation. Le cas échéant, le lecteur utilise l'identifiant STS pour demander la nouvelle clé. Vous devez donc surveiller la validité de cet identifiant, car un identifiant invalide interrompt la lecture.

    __weak typeof(self) weakSelf = self;
   [self.aliPlayer setVerifyStsCallback:^AVPStsStatus(AVPStsInfo info) {
       if (info is valid) {
           return Valid;
       }
       if (a valid STS credential can be obtained) {
           getSTS(); // This can be an asynchronous or synchronous operation.
           return Pending;
       }
       [weakSelf.aliPlayer stop];
       return Invalid;
   }];

   Remarque

   Une fois le nouvel identifiant STS obtenu, appelez la méthode updateLiveStsInfo pour le mettre à jour. Si l'obtention d'un nouvel identifiant échoue, il est recommandé d'arrêter la lecture. Sans mise à jour de l'identifiant STS, le lecteur tente d'utiliser l'identifiant expiré pour demander la clé, ce qui peut provoquer des artefacts visuels ou un échec de la lecture.

   [self.aliPlayer updateLiveStsInfo:self.liveStsSource.accessKeyId accKey:self.liveStsSource.accessKeySecret token:self.liveStsSource.securityToken region:self.liveStsSource.region];

UrlSource for VOD

Pour lire une vidéo HLS ou MP4 chiffrée de manière privée par licence avec la méthode UrlSource, appelez l'opération GetPlayInfo afin d'obtenir l'URL de lecture de la vidéo. Après avoir récupéré cette URL, ajoutez-y le paramètre etavirp_nuyila=1 avant de la transmettre au lecteur. Ce paramètre peut être placé n'importe où dans la chaîne de requête. Il est obligatoire uniquement pour les vidéos MP4 ; pour les vidéos HLS, l'URL d'origine suffit. La configuration du lecteur reste identique à celle d'une vidéo standard. Aucun paramètre supplémentaire n'est nécessaire.

Exemple d'URL de lecture 1 : https://example.aliyundoc.com/test.mp4?etavirp_nuyila=1

Exemple d'URL de lecture 2 : https://example.aliyundoc.com/test.mp4?auth_key=xxxxx&etavirp_nuyila=1

// Playback URL
NSString *playURL = @"https://example.aliyundoc.com/test.mp4?etavirp_nuyila=1";

// Player
AliPlayer *player = [[AliPlayer alloc] init];
AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:playURL]; // Required. The playback URL of the video. You can call the GetPlayInfo operation to obtain the URL. For MP4 videos, you must append `etavirp_nuyila=1` to the URL. Example: https://example.aliyundoc.com/test.mp4?etavirp_nuyila=1
[player setUrlSource:urlSource];
[player prepare];

// List player
AliListPlayer *listPlayer = [[AliListPlayer alloc] init];
[listPlayer addUrlSource:playURL uid:UUIDString];
[listPlayer moveTo:@"uid"];

// Preload
AliMedialoader *mediaLoader = [AliMediaLoader shareInstance];
[mediaLoader load:playURL duration:1000];

VidAuth for VOD

Lorsque vous lisez une vidéo chiffrée avec le chiffrement standard HLS via la méthode VidAuth d'ApsaraVideo VOD, si elle comporte également des flux non chiffrés ou transcodés de façon standard, définissez le type de chiffrement sur HLSEncryption pour lire uniquement le flux chiffré selon la norme HLS. L'exemple de code suivant illustre cette opération :

AVPVidAuthSource *authSource = [[AVPVidAuthSource alloc] init];
authSource.vid = @"Your video ID"; // Required. The video ID.
authSource.playAuth = @"<yourPlayAuth>"; // Required. The playback credential. You can obtain this credential by calling the GetVideoPlayAuth operation of ApsaraVideo VOD.
authSource.region = @"Your region"; // This parameter is deprecated in Player SDK V5.5.5.0 and later. You do not need to set the region because the player automatically parses it. For SDK versions earlier than 5.5.5.0, this parameter is required. It specifies the region where ApsaraVideo VOD is activated. Default value: cn-shanghai.
// authSource.authTimeout = 3600; // Optional. The validity period of the playback URL in seconds. This value overrides the validity period of URL authentication that is configured 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 the playback is complete.

// Build the config by using VidPlayerConfigGenerator.
VidPlayerConfigGenerator* config = [[VidPlayerConfigGenerator alloc]init];
[config addVidPlayerConfigByStringValue:@"EncryptType" value:@"HLSEncryption"]; // Optional. If you set this parameter to HLSEncryption, only video streams that are encrypted by using HLS standard encryption are returned.
[config setHlsUriToken: @"token"]; // Optional. Use this parameter to pass the MtsHlsUriToken (user token) for verification.
source.playConfig = [config generatePlayerConfig];

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

VidSts for VOD

Si vous lisez une vidéo chiffrée avec le chiffrement standard HLS via la méthode VidSts d'ApsaraVideo VOD, et que celle-ci contient aussi des flux non chiffrés ou transcodés de façon standard, définissez le type de chiffrement sur HLSEncryption afin de ne lire que le flux chiffré selon la norme HLS. L'exemple de code suivant illustre cette opération :

AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
source.vid = @"Your video ID"; // Required. The video ID.
source.region = @"Your region"; // Required. The region where ApsaraVideo VOD is activated. Default value: cn-shanghai.
source.securityToken = @"<yourSecurityToken>"; // Required. The security token. You can obtain this token by calling the AssumeRole operation of STS.
source.accessKeySecret = @"<yourAccessKeySecret>"; // Required. The AccessKey secret of the temporary STS credential. You can obtain this credential by calling the AssumeRole operation of STS.
source.accessKeyId = @"<yourAccessKeyId>"; // Required. The AccessKey ID of the temporary STS credential. You can obtain this credential by calling the AssumeRole operation of STS.
// source.authTimeout = 3600; // Optional. The validity period of the playback URL in seconds. This value overrides the validity period of URL authentication that is configured 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 the playback is complete.

// Build the config by using VidPlayerConfigGenerator.
VidPlayerConfigGenerator* config = [[VidPlayerConfigGenerator alloc]init];
[config addVidPlayerConfigByStringValue:@"EncryptType" value:@"HLSEncryption"]; // Optional. If you set this parameter to HLSEncryption, only video streams that are encrypted by using HLS standard encryption are returned.
[config setHlsUriToken: @"token"]; // Optional. Use this parameter to pass the MtsHlsUriToken (user token) for verification.
source.playConfig = [config generatePlayerConfig]; 

// Set the playback source.
[self.player setStsSource:source];

UrlSource

Avec la méthode UrlSource pour lire un flux chiffré selon la norme HLS, la configuration du lecteur reste identique à celle d'une vidéo standard. Aucun paramètre supplémentaire n'est requis.

Nous vous recommandons d'utiliser ApsaraVideo VOD. Appelez l'opération GetPlayInfo pour obtenir l'URL de lecture de la vidéo, puis transmettez-la au lecteur.

AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:url]; // The playback URL of the live or on-demand stream with HLS standard encryption.
[self.player setUrlSource:urlSource];

VidSts for VOD

Commencez par configurer le chiffrement DRM en suivant la procédure décrite dans la rubrique Configurer le chiffrement DRM pour VOD. Lors de la lecture d'une vidéo chiffrée par DRM avec la méthode VidSts d'ApsaraVideo VOD, la configuration est identique à celle d'une vidéo standard. Aucun paramètre supplémentaire n'est nécessaire.

AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
source.region = @"Your region"; // Required. The region where ApsaraVideo VOD is activated. Default value: cn-shanghai.
source.vid = @"Your video ID"; // Required. The video ID.
source.securityToken = @"<yourSecurityToken>"; // Required. The security token. You can obtain this token by calling the AssumeRole operation of STS.
source.accessKeySecret = @"<yourAccessKeySecret>"; // Required. The AccessKey secret of the temporary STS credential. You can obtain this credential by calling the AssumeRole operation of STS.
source.accessKeyId = @"<yourAccessKeyId>"; // Required. The AccessKey ID of the temporary STS credential. You can obtain this credential by calling the AssumeRole operation of STS.
// source.authTimeout = 3600; // Optional. The validity period of the playback URL in seconds. This value overrides the validity period of URL authentication that is configured 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 the playback is complete.
 // Set the playback source.
 [self.player setStsSource:source]

LiveStsSource for live

Commencez par configurer le chiffrement DRM en suivant la procédure décrite dans la rubrique Configurer le chiffrement DRM pour la diffusion en direct. Pour lire un flux en direct chiffré par DRM via la méthode LiveStsSource, fournissez l'URL du flux ainsi qu'un identifiant STS, puis définissez le type de chiffrement de la vidéo sur ENCRYPTION_TYPE_FAIRPLAY. L'exemple de code suivant illustre cette opération :

1. Créez une source de données.

   Vous devez transmettre AVPLiveStsSource comme source de lecture.

   // Create a LiveSts object and set encryptionType to ENCRYPTION_TYPE_FAIRPLAY.
   AVPLiveStsSource *liveStsSource = [[AVPLiveStsSource alloc] initWithUrl:@"Encrypted live stream URL" 
                                                               accessKeyId:@"Temporary AccessKey ID" 
                                                               accessKeySecret:@"Temporary AccessKey secret" 
                                                               securityToken:@"Security token" 
                                                               region:@"Region value" 
                                                               domain:@"Streaming domain for the URL" 
                                                               app:@"Application name for streaming" 
                                                               stream:@"Stream name for streaming" 
                                                               encryptionType:ENCRYPTION_TYPE_FAIRPLAY];// Required. Set the encryption type to ENCRYPTION_TYPE_FAIRPLAY.
    // Set the playback source.
    [self.aliPlayer setLiveStsSource:liveStsSource];
    ......
    // Prepare for playback.
    [self.aliPlayer prepare];

2. Surveillez l'invalidation de l'identifiant STS.

   Pendant la lecture d'un flux en direct chiffré, la clé de chiffrement peut faire l'objet d'une rotation. Le cas échéant, le lecteur utilise l'identifiant STS pour demander la nouvelle clé. Vous devez donc surveiller la validité de cet identifiant, car un identifiant invalide interrompt la lecture.

    __weak typeof(self) weakSelf = self;
   [self.aliPlayer setVerifyStsCallback:^AVPStsStatus(AVPStsInfo info) {
       if (info is valid){
           return Valid;
       }
       if(a valid STS credential can be obtained){
           getSTS(); // This can be an asynchronous or synchronous operation.
           return Pending;
       }
       [weakSelf.aliPlayer stop];
       return Invalid;
   }];

   Remarque

   Une fois le nouvel identifiant STS obtenu, appelez la méthode updateLiveStsInfo pour le mettre à jour. Si l'obtention d'un nouvel identifiant échoue, il est recommandé d'arrêter la lecture. Sans mise à jour de l'identifiant STS, le lecteur tente d'utiliser l'identifiant expiré pour demander la clé, ce qui peut provoquer des artefacts visuels ou un échec de la lecture.

   [self.aliPlayer updateLiveStsInfo:self.liveStsSource.accessKeyId accKey:self.liveStsSource.accessKeySecret token:self.liveStsSource.securityToken region:self.liveStsSource.region];

UrlSource for FairPlay

Commencez par configurer le chiffrement DRM en suivant la procédure décrite dans la rubrique Conditionnement en direct. Lors de la lecture d'une vidéo chiffrée par DRM avec la méthode UrlSource, outre la configuration habituelle d'une vidéo classique, implémentez l'interface AVPDrmDelegate pour récupérer le certificat FairPlay et la clé de la vidéo.

@interface SimplePlayerViewController()<AVPDrmDelegate>
@end
- (void)viewDidLoad {
    self.player = [[AliPlayer alloc] init];
    self.player.playerView = self.avpPlayerView.playerView;
    self.player.drmDelegate = self;
    if(the current URL is for a third-party DRM video){
        [self.player setPreferPlayerName:@"AppleAVPlayer"];
    }
    //...
}

// Implement the AVPDrmDelegate.requestCert and requestKey interfaces. Obtain the certificate and key by following the documentation from your third-party DRM provider.
// The following example shows how to obtain a certificate and key from PallyCon. For more information, see https://pallycon.com/docs/en/multidrm.
#pragma mark AVPDrmDelegate
- (NSData *)requestCert:(AliPlayer *)player {
    // You can also pre-fetch and cache the certificate to reduce startup latency. If you do, return the cached certificate here.
    // If the certificate data is invalid, the player reports an error. You can also check the console for more error information.
    // Replace SITE_ID with your own site ID.
    const char* url = "https://license.pallycon.com/ri/fpsKeyManager.do?siteId=SITE_ID";

    // Request the FairPlay certificate by using an HTTP GET request as required by the DRM provider.
    // Avoid blocking this thread for an extended period.
    NSData* responseData = [self performAsyncHttpGet:url];
    if (!responseData) {
        // Handle the exception. The player will report an error.
        return nil;
    }
    
    // The response data must be Base64-decoded before being returned to the player.
    NSString *base64String = [[NSString alloc] initWithData:responseData encoding:NSUTF8StringEncoding];
    return [self decodeBase64String:base64String];
}

- (NSData *)requestKey:(AliPlayer *)player data:(NSData *)data {
    // Request the key information by using an HTTP POST request as required by the DRM provider.
    NSString *urlString = [NSString stringWithFormat:@"https://license-global.pallycon.com/ri/licenseManager.do"];
    const char *url = [urlString UTF8String];

    // Replace TOKEN_ID with your own token ID.
    NSString *headerString = [NSString stringWithFormat:@"pallycon-customdata-v2: TOKEN_ID"];
    const char* headers[] = {
        [headerString UTF8String]
    };
    int headerCount = sizeof(headers) / sizeof(headers[0]);

    // Avoid blocking this thread for an extended period.
    NSData* responseData = [self performAsyncHttpPost:url
                                             headers:headers
                                         headerCount:headerCount
                                                data:data];
    if (!responseData) {
        // Handle the exception. The player will report an error.
        return nil;
    }

    // If your token's response_format is set to `original`, return the response directly. Otherwise, you must parse the response before returning it.
    // For more information, see https://pallycon.com/docs/en/multidrm/license/license-token/#token-json.
    // The format and structure of the response can vary significantly among providers. Check the response carefully. If the response cannot be used for decryption, the player reports an error.
    return [[NSString alloc] initWithData:responseData encoding:NSUTF8StringEncoding];
}