ApsaraVideo VOD:暗号化されたビデオの再生

VOD (VidAuth)

ApsaraVideo VOD の VidAuth 方式を使用して Alibaba Cloud 専用の暗号化で暗号化されたビデオを再生するには、専用の暗号化を有効にするために encryptType: 1 パラメーターも渡す必要があります。これは、標準ビデオの再生には必要ありません。

var player = new Aliplayer({
    id: 'J_prismPlayer',
    width: '100%',
    vid : '<your video ID>',// 必須。 ビデオ ID。 これは、ApsaraVideo VOD コンソールで [メディアライブラリ] > [オーディオ/ビデオ] を選択することで確認できます。 例：1e067a2831b641db90d570b6480f****。
    playauth : '<your PlayAuth>',// 必須。 再生認証情報。 これは、GetVideoPlayAuth オペレーションを呼び出すことで取得できます。
    encryptType: 1, // 必須。 専用の暗号化でストリームを再生する場合は、これを 1 に設定します。 このパラメーターは、他の場合には必要ありません。
    playConfig:{EncryptType:'AliyunVoDEncryption'}, // M3U8 ストリームに専用の暗号化を使用しない他のストリームも含まれている場合に必須です。
    // authTimeout: 7200, // オプション。 再生 URL の有効期間 (秒単位)。 この値は、ApsaraVideo VOD コンソールで設定された URL 署名の有効期間を上書きします。 指定しない場合、デフォルト値は 7200 です。 設定する場合は、再生中に URL が期限切れにならないように、この値がビデオの長さを超えるようにしてください。
  },function(player){
    console.log('The player is created.')
 });

ライブ (LiveStsSource)

LiveStsSource 方式で専用の暗号化を使用するライブストリームを再生するには、ストリーム URL と STS 一時認証情報を提供する必要があります。認証情報の生成方法については、「STS トークンの取得」をご参照ください。

let player = new Aliplayer({
   id: 'J_prismPlayer',
   width: '100%',
   isLive: true, // ライブストリーミングの場合は true に設定します。
   source: '<your live stream url>',// 必須。 専用の暗号化を使用した HLS ライブストリームの再生 URL。
   accessKeyId: '<your AccessKey ID>',// 必須。 STS 一時認証情報ペアの AccessKey ID。 STS の AssumeRole オペレーションを呼び出して生成します。
   accessKeySecret: '<your AccessKey Secret>',// 必須。 STS 一時認証情報ペアの AccessKey Secret。 STS の AssumeRole オペレーションを呼び出して生成します。
   securityToken: '<your STS token>',// 必須。 STS セキュリティトークン。 STS の AssumeRole オペレーションを呼び出して生成します。
   domain: '<your Domain>',// 必須。 ライブストリームのストリーミングドメイン。
   app:'<your App Name>',// 必須。 ライブストリームの AppName。
   stream:'<your Stream Name>',// 必須。 トランスコードされたストリームではなく、元のライブストリームの StreamName。ストリーム名が mystream_lhd.m3u8 の場合は、mystream と入力します。
   regionId: '<region of your video>',// 必須。 サービスリージョン (例：cn-shanghai、eu-central-1、ap-southeast-1)。
 },function(player){
   console.log('The player is created.')
});

VOD (VidAuth)

ApsaraVideo VOD の VidAuth 方式を使用して HLS 標準暗号化でビデオを再生する場合、ビデオに他の非 HLS 標準暗号化ストリームまたは標準トランスコード済みストリームも含まれている場合は、EncryptType パラメーターを HLSEncryption に設定して、HLS 標準暗号化ストリームのみをフィルタリングして再生できます。

let player = new Aliplayer({
   id:'J_prismPlayer',
   vid:'<your video ID>', // 必須。 ビデオ ID。 例：1e067a2831b641db90d570b6480f****。
   playauth:'<your PlayAuth>', // 必須。 ビデオ再生認証情報。
   playConfig: { // オプション。
     MtsHlsUriToken: '', // オプション。 MtsHlsUriToken (ユーザートークン) を検証する必要がある場合は、このパラメーターで渡します。
     EncryptType: 'HLSEncryption', // オプション。 このパラメーターを HLSEncryption に設定すると、HLS 標準暗号化のストリームのみが返されます。
   },
 });

VOD (VidSts)

ApsaraVideo VOD の VidSts 方式を使用して HLS 標準暗号化でビデオを再生する場合、ビデオに他の非 HLS 標準暗号化ストリームまたは標準トランスコード済みストリームも含まれている場合は、EncryptType パラメーターを HLSEncryption に設定して、HLS 標準暗号化ストリームのみをフィルタリングして再生できます。

let player = new Aliplayer({
   id: 'J_prismPlayer',
   vid : '<your video ID>', // 必須。 ビデオ ID。 ID は、ApsaraVideo VOD コンソール ([メディアライブラリ] > [オーディオ/ビデオ]) から取得するか、ビデオのアップロード後に SearchMedia API オペレーションを呼び出すことで取得できます。 例：1e067a2831b641db90d570b6480f****。
   accessKeyId: '<your AccessKey ID>', // 必須。 STS 一時認証情報ペアの AccessKey ID。STS セキュリティトークンを生成する際に返されます。
   securityToken: '<your STS token>', // 必須。 STS セキュリティトークン。 STS の AssumeRole オペレーションを呼び出して生成します。
   accessKeySecret: '<your AccessKey Secret>', // 必須。 STS 一時認証情報ペアの AccessKey Secret。STS セキュリティトークンを生成する際に返されます。
   region: '<region of your video>', // 必須。 サービスリージョン (例：cn-shanghai、eu-central-1、ap-southeast-1)。
   playConfig: { // オプション。
     MtsHlsUriToken: '', // オプション。 MtsHlsUriToken (ユーザートークン) を検証する必要がある場合は、このパラメーターで渡します。
     EncryptType: 'HLSEncryption', // オプション。 このパラメーターを HLSEncryption に設定すると、HLS 標準暗号化のストリームのみが返されます。
   },
 };

UrlSource

UrlSource 方式で HLS 標準暗号化を使用するライブまたはオンデマンドストリームを再生する場合、追加のパラメーターは必要ありません。設定は、標準ビデオの再生と同じです。

  let player = new Aliplayer({
    id:'J_prismPlayer',
    source:'<your play URL>', // 再生 URL。ライブまたはオンデマンドストリーム用です。
    isLive: true, // ライブストリーミングの場合は true に設定します。
  });

VOD (VidSts)

ApsaraVideo VOD の VidSts メソッドを使用して DRM で暗号化された動画を再生するには、さらに isDrm: true パラメーターを渡す必要があります。

var player = new Aliplayer({
   id: 'J_prismPlayer',
   width: '100%',
   isDrm: true,
   vid: '<your video ID>',// 必須。 ビデオ ID。 これは、ApsaraVideo VOD コンソールで [メディアライブラリ] > [オーディオ/ビデオ] を選択することで確認できます。 例：1e067a2831b641db90d570b6480f****。
   accessKeyId: '<your AccessKey ID>',// 必須。 STS 一時認証情報ペアの AccessKey ID。 STS の AssumeRole オペレーションを呼び出して生成します。
   securityToken: '<your STS token>',// 必須。 STS セキュリティトークン。 STS の AssumeRole オペレーションを呼び出して生成します。
   accessKeySecret: '<your AccessKey Secret>',// 必須。 STS 一時認証情報ペアの AccessKey Secret。 STS の AssumeRole オペレーションを呼び出して生成します。
   region: '<region of your video>', // 必須。 サービスリージョン (例：cn-shanghai、eu-central-1、ap-southeast-1)。
   certId: '<your certificate ID>', // Apple デバイスでの再生に必須。 このパラメーターを使用して Apple 証明書を要求します。 DRM の実装に応じて、ApsaraVideo VOD または ApsaraVideo Live コンソールから取得します。
   // authTimeout: 7200, // オプション。 再生 URL の有効期間 (秒単位)。 この値は、ApsaraVideo VOD コンソールで設定された URL 署名の有効期間を上書きします。 指定しない場合、デフォルト値は 7200 です。 設定する場合は、再生中に URL が期限切れにならないように、この値がビデオの長さを超えるようにしてください。
 },function(player){
   console.log('The player is created.')
});

ライブ (LiveStsSource)

LiveStsSource 方式を使用して DRM 暗号化されたライブストリームを再生するには、ストリーム URL と STS 一時認証情報を提供します。STS 一時認証情報の生成方法については、「STS トークンの取得」をご参照ください。

var player = new Aliplayer({
   id: 'J_prismPlayer',
   width: '100%',
   isLive: true, // ライブストリーミングの場合は true に設定します。
   isDrm: true,
   source: '<your live stream url>',// 必須。 DRM 暗号化されたライブストリームの再生 URL。
   accessKeyId: '<your AccessKey ID>',// 必須。 STS 一時認証情報ペアの AccessKey ID。 STS の AssumeRole オペレーションを呼び出して生成します。
   securityToken: '<your STS token>',// 必須。 STS セキュリティトークン。 STS の AssumeRole オペレーションを呼び出して生成します。
   accessKeySecret: '<your AccessKey Secret>',// 必須。 STS 一時認証情報ペアの AccessKey Secret。 STS の AssumeRole オペレーションを呼び出して生成します。
   region: '<region of your video>', // 必須。 サービスリージョン (例：cn-shanghai、eu-central-1、ap-southeast-1)。
   certId: '<your certificate ID>', // Apple デバイスでの再生に必須。 このパラメーターを使用して Apple 証明書を要求します。 DRM の実装に応じて、ApsaraVideo VOD または ApsaraVideo Live コンソールから取得します。
 },function(player){
   console.log('The player is created.')
});

VidSts

まず、「ApsaraVideo VOD の DRM 暗号化を設定する」で説明されているように DRM 暗号化を設定します。ApsaraVideo VOD VidSts を使用して DRM 暗号化されたビデオを再生する場合、設定は暗号化されていないビデオの場合と同じです。追加のパラメーターは必要ありません。

VidSts vidSts = new VidSts();
        vidSts.setVid("your_video_id");// 必須。 ビデオ ID。
        vidSts.setAccessKeyId("<yourAccessKeyId>");// 必須。 一時的な STS 認証情報の AccessKey ID。 これを取得するには、STS の AssumeRole オペレーションを呼び出します。
        vidSts.setAccessKeySecret("<yourAccessKeySecret>");// 必須。 一時的な STS 認証情報の AccessKey Secret。 これを取得するには、STS の AssumeRole オペレーションを呼び出します。
        vidSts.setSecurityToken("<yourSecurityToken>");// 必須。 セキュリティトークン。 これを取得するには、STS の AssumeRole オペレーションを呼び出します。
        vidSts.setRegion("your_region");// 必須。 ApsaraVideo VOD がアクティブ化されているリージョン。 デフォルト値：cn-shanghai。
        // vidSts.setAuthTimeout(3600); // オプション。 再生 URL の有効期間 (秒単位)。 この値は、ApsaraVideo VOD コンソールで設定された URL 認証の有効期間を上書きします。 デフォルト値は 3600 です。 このパラメーターを設定する場合は、再生が完了する前に URL が期限切れにならないように、その値がビデオの長さを超えるようにしてください。
        aliPlayer.setDataSource(vidSts);

LiveSts

まず、「ApsaraVideo Live の DRM 暗号化を設定する」で説明されているように DRM 暗号化を設定します。LiveSts オブジェクトを使用して DRM 暗号化されたライブストリームを再生するには、URL と STS 認証情報を渡し、ビデオ暗号化タイプを WideVine_FairPlay に設定する必要があります。次のコードは例です：

1. データソースを作成します。

   再生ソースとして LiveSts を渡す必要があります。

   // LiveSts オブジェクトを作成し、EncryptionType を WideVine_FairPlay に設定します。
   LiveSts liveSts = new LiveSts();
   liveSts.setUrl("<your live stream url>");// 必須。 DRM 暗号化された HLS ライブストリームの再生 URL。
   liveSts.setAccessKeyId("<your AccessKey ID>");// 必須。 一時的な STS 認証情報の AccessKey ID。 これを取得するには、STS の AssumeRole オペレーションを呼び出します。
   liveSts.setAccessKeySecret("<your AccessKey Secret>");// 必須。 一時的な STS 認証情報の AccessKey Secret。 これを取得するには、STS の AssumeRole オペレーションを呼び出します。
   liveSts.setSecurityToken("<your STS token>");// 必須。 セキュリティトークン。 これを取得するには、STS の AssumeRole オペレーションを呼び出します。
   liveSts.setDomain("<your Domain>");// 必須。 ライブストリームのストリーミングドメイン。
   liveSts.setApp("<your App Name>");// 必須。 ライブストリームの AppName。
   liveSts.setStream("<your Stream Name>");// 必須。 ライブストリームの StreamName。
   liveSts.setEncryptionType(LiveSts.LiveEncryptionType.WideVine_FairPlay);// 必須。 暗号化タイプを WideVine_FairPlay に設定します。 
   liveSts.setRegion("<region of your video>");// 必須。 サービスリージョン (例：cn-shanghai)。
   // 再生ソースを設定します。
   aliPlayer.setDataSource(liveSts);
   // 再生の準備をします。
   aliPlayer.prepare();

2. STS の無効化をリッスンします。

   暗号化されたライブ再生中に、暗号鍵がローテーションされることがあります。キーのローテーションが発生すると、プレーヤーは STS 認証情報を使用して新しいキーを要求します。無効な認証情報は再生を中断させるため、STS 認証情報の有効性を監視する必要があります。

   mAliyunVodPlayer.setOnVerifyTimeExpireCallback(new AliPlayer.OnVerifyTimeExpireCallback() {
   		@Override
       public AliPlayer.Status onVerifySts(StsInfo info) {
           if(info is valid){
               return IPlayer.StsStatus.Valid;
           }
   
           if(a valid STS credential can be obtained){
               getSTS(); // これは非同期または同期にすることができます。
               return IPlayer.StsStatus.Pending;
           }
           // info が無効で、新しい STS 認証情報を取得できない場合は、破損したビデオ出力 を防ぐために再生を停止することをお勧めします。
           mAliyunVodPlayer.stop();
           return IPlayer.StsStatus.Invalid;
       }
   
       @Override
       public AliPlayer.Status onVerifyAuth(VidAuth auth) {
           return AliPlayer.Status.Valid;
       }
   });

   説明

   新しい STS 認証情報を正常に取得した後、updateLiveStsInfo メソッドを呼び出して更新する必要があります。新しい認証情報の取得に失敗した場合は、再生を停止することをお勧めします。STS 認証情報を更新しないと、プレーヤーは期限切れ後も古い認証情報を使用してキーを要求し続けます。STS 認証情報が無効になると、再生の失敗や破損したビデオ出力が発生する可能性があります。

   mAliyunVodPlayer.updateStsInfo(stsInfo);

UrlSource

まず、「VOD パッケージング」を参照して DRM 暗号化を設定します。UrlSource メソッドを使用して DRM 暗号化されたビデオを再生する場合、通常のビデオの設定に加えて、DrmCallback インターフェイスを実装してビデオのキー情報を取得する必要もあります。

// DrmCallback.requestKey インターフェイスを実装して、サードパーティ DRM プロバイダーのドキュメントに従ってキーを取得します。
// 次の例は、PallyCon からキーを取得する方法を示しています。 詳細については、https://pallycon.com/docs/en/multidrm をご参照ください。

player.setDrmCallback(new DrmCallback() {
    @Override
    public byte[] requestKey(byte[] data) {
        // DRM プロバイダーの要件に従って、HTTP POST リクエストを使用してキー情報を要求します。
        String licenseUrl = "https://license-global.pallycon.com/ri/licenseManager.do";
        String[] header = {
            // TOKEN_ID を独自のものに置き換えます。
            "pallycon-customdata-v2: TOKEN_ID"
        };

        // このスレッドを長時間ブロックしないようにしてください。
        byte[] response = async_http_post(licenseUrl, header, data);
        if (response != null) {
            // トークンの response_format が 'original' に設定されている場合は、応答を直接返します。 それ以外の場合は、応答を返す前に解析する必要があります。
            // 詳細については、https://pallycon.com/docs/en/multidrm/license/license-token/#token-json をご参照ください。
            // 応答の形式と構造はプロバイダーによって大きく異なる場合があります。 慎重に確認してください。 応答を復号に使用できない場合、プレーヤーは onError コールバックを通じてエラーを報告します。
            return response;
        } else {
            // 例外を処理します。 プレーヤーは onError を呼び出し、関連するエラーを報告します。
            return null;
        }
    }
});

VOD 用 VidAuth

ApsaraVideo VOD の VidAuth メソッドを使用してプライベート暗号化された HLS または MP4 ビデオを再生する場合、ビデオに暗号化されていないストリームまたは標準のトランスコード済みストリームも含まれている場合は、暗号化タイプを AliyunVoDEncryption に設定して、プライベート暗号化されたストリームのみを再生します。

AVPVidAuthSource *authSource = [[AVPVidAuthSource alloc] init];
authSource.vid = @"Your video ID"; // 必須。 ビデオ ID。
authSource.playAuth = @"<yourPlayAuth>"; // 必須。 再生認証情報。 この認証情報は、ApsaraVideo VOD の GetVideoPlayAuth オペレーションを呼び出すことで取得できます。
authSource.region = @"Your region"; // このパラメーターは、Player SDK V5.5.5.0 以降では非推奨です。 プレーヤーが自動的にリージョンを解析するため、リージョンを設定する必要はありません。 SDK バージョン 5.5.5.0 より前では、このパラメーターは必須です。 ApsaraVideo VOD がアクティブ化されているリージョンを指定します。 デフォルト値：cn-shanghai。
// authSource.authTimeout = 3600; // オプション。 再生 URL の有効期間 (秒単位)。 この値は、ApsaraVideo VOD コンソールで設定された URL 認証の有効期間を上書きします。 このパラメーターを設定しない場合、デフォルト値 3600 が使用されます。 このパラメーターを設定する場合は、再生が完了する前に再生 URL が期限切れにならないように、実際のビデオの長さを超える値に設定してください。

// VidPlayerConfigGenerator を使用して設定を構築します。
VidPlayerConfigGenerator* config = [[VidPlayerConfigGenerator alloc]init];
[config addVidPlayerConfigByStringValue:@"EncryptType" value:@"AliyunVoDEncryption"]; // オプション。 暗号化タイプを AliyunVoDEncryption に設定すると、プライベート暗号化されたビデオストリームのみが返されます。
authSource.playConfig = [config generatePlayerConfig]; 
[self.player setAuthSource:authSource];

VOD 用 VidSts

ApsaraVideo VOD の VidSts メソッドを使用してプライベート暗号化された HLS または MP4 ビデオを再生する場合、ビデオに暗号化されていないストリームまたは標準のトランスコード済みストリームも含まれている場合は、暗号化タイプを AliyunVoDEncryption に設定して、プライベート暗号化されたストリームのみを再生します。

AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
source.region = @"Your region"; // 必須。 ApsaraVideo VOD がアクティブ化されているリージョン。 デフォルト値：cn-shanghai。
source.vid = @"Your video ID"; // 必須。 ビデオ ID。
source.securityToken = @"<yourSecurityToken>"; // 必須。 セキュリティトークン。 このトークンは、STS の AssumeRole オペレーションを呼び出すことで取得できます。
source.accessKeySecret = @"<yourAccessKeySecret>"; // 必須。 一時的な STS 認証情報の AccessKey Secret。 この認証情報は、STS の AssumeRole オペレーションを呼び出すことで取得できます。
source.accessKeyId = @"<yourAccessKeyId>"; // 必須。 一時的な STS 認証情報の AccessKey ID。 この認証情報は、STS の AssumeRole オペレーションを呼び出すことで取得できます。
// source.authTimeout = 3600; // オプション。 再生 URL の有効期間 (秒単位)。 この値は、ApsaraVideo VOD コンソールで設定された URL 認証の有効期間を上書きします。 このパラメーターを設定しない場合、デフォルト値 3600 が使用されます。 このパラメーターを設定する場合は、再生が完了する前に再生 URL が期限切れにならないように、実際のビデオの長さを超える値に設定してください。

// VidPlayerConfigGenerator を使用して設定を構築します。
VidPlayerConfigGenerator* config = [[VidPlayerConfigGenerator alloc]init];
[config addVidPlayerConfigByStringValue:@"EncryptType" value:@"AliyunVoDEncryption"]; // オプション。 暗号化タイプを AliyunVoDEncryption に設定すると、プライベート暗号化されたビデオストリームのみが返されます。
source.playConfig = [config generatePlayerConfig]; 

// 再生ソースを設定します。
[self.player setStsSource:source];

ライブ用 LiveStsSource

LiveStsSource メソッドを使用して HLS または FLV 形式のプライベート暗号化されたライブストリームを再生するには、ストリーム URL と STS 認証情報を提供し、ビデオ暗号化タイプを ENCRYPTION_TYPE_ALIVODENCRYPTION に設定する必要があります。次のコードは例です：

1. データソースを作成します。

   再生ソースとして AVPLiveStsSource を渡す必要があります。

   // LiveSts オブジェクトを作成し、encryptionType を 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];// 必須。 暗号化タイプを ENCRYPTION_TYPE_ALIVODENCRYPTION に設定します。
    // 再生ソースを設定します。
    [self.aliPlayer setLiveStsSource:liveStsSource];
    ......
    // 再生の準備をします。
    [self.aliPlayer prepare];

2. STS 認証情報の無効化をリッスンします。

   暗号化されたライブ再生中に、暗号鍵がローテーションされることがあります。これが発生すると、プレーヤーは STS 認証情報を使用して新しいキーを要求します。無効な認証情報は再生を中断させるため、認証情報の有効性を監視する必要があります。

    __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(); // これは非同期または同期の操作にすることができます。
           return Pending;
       }
       [weakSelf.aliPlayer stop];
       return Invalid;
   }];

   説明

   新しい STS 認証情報を取得した後、updateLiveStsInfo メソッドを呼び出して更新する必要があります。新しい認証情報の取得に失敗した場合は、再生を停止することをお勧めします。STS 認証情報を更新しないと、プレーヤーは期限切れの認証情報を使用してキーを要求しようとし、画面の乱れや再生の失敗を引き起こす可能性があります。

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

VOD 用 UrlSource

UrlSource メソッドを使用してライセンスベースのプライベート暗号化 HLS または MP4 ビデオを再生するには、GetPlayInfo オペレーションを呼び出してビデオの再生 URL を取得できます。ビデオ URL を取得した後、プレーヤーに渡す前に URL に etavirp_nuyila=1 パラメーターを追加する必要があります。このパラメーターはクエリ文字列のどこにでも配置できます。このパラメーターは MP4 ビデオにのみ必要です。HLS ビデオの場合は、元のビデオ URL を使用できます。プレーヤーの設定は、標準ビデオの再生と同じです。追加のパラメーターは必要ありません。

再生 URL の例 1：https://example.aliyundoc.com/test.mp4?etavirp_nuyila=1

再生 URL の例 2：https://example.aliyundoc.com/test.mp4?auth_key=xxxxx&etavirp_nuyila=1

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

// プレーヤー
AliPlayer *player = [[AliPlayer alloc] init];
AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:playURL]; // 必須。 ビデオの再生 URL。 GetPlayInfo オペレーションを呼び出して URL を取得できます。 MP4 ビデオの場合は、URL に `etavirp_nuyila=1` を追加する必要があります。 例：https://example.aliyundoc.com/test.mp4?etavirp_nuyila=1
[player setUrlSource:urlSource];
[player prepare];

// リストプレーヤー
AliListPlayer *listPlayer = [[AliListPlayer alloc] init];
[listPlayer addUrlSource:playURL uid:UUIDString];
[listPlayer moveTo:@"uid"];

// プリロード
AliMedialoader *mediaLoader = [AliMediaLoader shareInstance];
[mediaLoader load:playURL duration:1000];

VOD 用 VidAuth

ApsaraVideo VOD の VidAuth メソッドで HLS 標準暗号化を使用して暗号化されたビデオを再生する場合、ビデオに暗号化されていないストリームまたは標準のトランスコード済みストリームも含まれている場合は、暗号化タイプを HLSEncryption に設定して、HLS 標準暗号化のストリームのみを再生します。次のコードは例です：

AVPVidAuthSource *authSource = [[AVPVidAuthSource alloc] init];
authSource.vid = @"Your video ID"; // 必須。 ビデオ ID。
authSource.playAuth = @"<yourPlayAuth>"; // 必須。 再生認証情報。 この認証情報は、ApsaraVideo VOD の GetVideoPlayAuth オペレーションを呼び出すことで取得できます。
authSource.region = @"Your region"; // このパラメーターは、Player SDK V5.5.5.0 以降では非推奨です。 プレーヤーが自動的にリージョンを解析するため、リージョンを設定する必要はありません。 SDK バージョン 5.5.5.0 より前では、このパラメーターは必須です。 ApsaraVideo VOD がアクティブ化されているリージョンを指定します。 デフォルト値：cn-shanghai。
// authSource.authTimeout = 3600; // オプション。 再生 URL の有効期間 (秒単位)。 この値は、ApsaraVideo VOD コンソールで設定された URL 認証の有効期間を上書きします。 このパラメーターを設定しない場合、デフォルト値 3600 が使用されます。 このパラメーターを設定する場合は、再生が完了する前に再生 URL が期限切れにならないように、実際のビデオの長さを超える値に設定してください。

// VidPlayerConfigGenerator を使用して設定を構築します。
VidPlayerConfigGenerator* config = [[VidPlayerConfigGenerator alloc]init];
[config addVidPlayerConfigByStringValue:@"EncryptType" value:@"HLSEncryption"]; // オプション。 このパラメーターを HLSEncryption に設定すると、HLS 標準暗号化を使用して暗号化されたビデオストリームのみが返されます。
[config setHlsUriToken: @"token"]; // オプション。 このパラメーターを使用して、検証のために MtsHlsUriToken (ユーザートークン) を渡します。
source.playConfig = [config generatePlayerConfig];

// 再生ソースを設定します。
[self.player setAuthSource:authSource];

VOD 用 VidSts

ApsaraVideo VOD の VidSts メソッドで HLS 標準暗号化を使用して暗号化されたビデオを再生する場合、ビデオに暗号化されていないストリームまたは標準のトランスコード済みストリームも含まれている場合は、暗号化タイプを HLSEncryption に設定して、HLS 標準暗号化のストリームのみを再生します。次のコードは例です：

AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
source.vid = @"Your video ID"; // 必須。 ビデオ ID。
source.region = @"Your region"; // 必須。 ApsaraVideo VOD がアクティブ化されているリージョン。 デフォルト値：cn-shanghai。
source.securityToken = @"<yourSecurityToken>"; // 必須。 セキュリティトークン。 このトークンは、STS の AssumeRole オペレーションを呼び出すことで取得できます。
source.accessKeySecret = @"<yourAccessKeySecret>"; // 必須。 一時的な STS 認証情報の AccessKey Secret。 この認証情報は、STS の AssumeRole オペレーションを呼び出すことで取得できます。
source.accessKeyId = @"<yourAccessKeyId>"; // 必須。 一時的な STS 認証情報の AccessKey ID。 この認証情報は、STS の AssumeRole オペレーションを呼び出すことで取得できます。
// source.authTimeout = 3600; // オプション。 再生 URL の有効期間 (秒単位)。 この値は、ApsaraVideo VOD コンソールで設定された URL 認証の有効期間を上書きします。 このパラメーターを設定しない場合、デフォルト値 3600 が使用されます。 このパラメーターを設定する場合は、再生が完了する前に再生 URL が期限切れにならないように、実際のビデオの長さを超える値に設定してください。

// VidPlayerConfigGenerator を使用して設定を構築します。
VidPlayerConfigGenerator* config = [[VidPlayerConfigGenerator alloc]init];
[config addVidPlayerConfigByStringValue:@"EncryptType" value:@"HLSEncryption"]; // オプション。 このパラメーターを HLSEncryption に設定すると、HLS 標準暗号化を使用して暗号化されたビデオストリームのみが返されます。
[config setHlsUriToken: @"token"]; // オプション。 このパラメーターを使用して、検証のために MtsHlsUriToken (ユーザートークン) を渡します。
source.playConfig = [config generatePlayerConfig]; 

// 再生ソースを設定します。
[self.player setStsSource:source];

UrlSource

UrlSource メソッドを使用して HLS 標準暗号化のストリームを再生する場合、プレーヤーの設定は標準ビデオの再生と同じです。追加のパラメーターは必要ありません。

ApsaraVideo VOD の使用をお勧めします。GetPlayInfo オペレーションを呼び出してビデオの再生 URL を取得し、その URL をプレーヤーに渡すことができます。

AVPUrlSource *urlSource = [[AVPUrlSource alloc] urlWithString:url]; // HLS 標準暗号化を使用したライブまたはオンデマンドストリームの再生 URL。
[self.player setUrlSource:urlSource];

VOD 用 VidSts

まず、「VOD の DRM 暗号化を設定する」を参照して DRM 暗号化を設定します。ApsaraVideo VOD の VidSts メソッドを使用して DRM 暗号化されたビデオを再生する場合、設定は標準ビデオの再生と同じです。追加のパラメーターは必要ありません。

AVPVidStsSource *source = [[AVPVidStsSource alloc] init];
source.region = @"Your region"; // 必須。 ApsaraVideo VOD がアクティブ化されているリージョン。 デフォルト値：cn-shanghai。
source.vid = @"Your video ID"; // 必須。 ビデオ ID。
source.securityToken = @"<yourSecurityToken>"; // 必須。 セキュリティトークン。 このトークンは、STS の AssumeRole オペレーションを呼び出すことで取得できます。
source.accessKeySecret = @"<yourAccessKeySecret>"; // 必須。 一時的な STS 認証情報の AccessKey Secret。 この認証情報は、STS の AssumeRole オペレーションを呼び出すことで取得できます。
source.accessKeyId = @"<yourAccessKeyId>"; // 必須。 一時的な STS 認証情報の AccessKey ID。 この認証情報は、STS の AssumeRole オペレーションを呼び出すことで取得できます。
// source.authTimeout = 3600; // オプション。 再生 URL の有効期間 (秒単位)。 この値は、ApsaraVideo VOD コンソールで設定された URL 認証の有効期間を上書きします。 このパラメーターを設定しない場合、デフォルト値 3600 が使用されます。 このパラメーターを設定する場合は、再生が完了する前に再生 URL が期限切れにならないように、実際のビデオの長さを超える値に設定してください。
 // 再生ソースを設定します。
 [self.player setStsSource:source]

ライブ用 LiveStsSource

まず、「ライブストリーミングの DRM 暗号化を設定する」を参照して DRM 暗号化を設定します。LiveStsSource メソッドを使用して DRM 暗号化されたライブストリームを再生するには、ストリーム URL と STS 認証情報を提供し、ビデオ暗号化タイプを ENCRYPTION_TYPE_FAIRPLAY に設定する必要があります。次のコードは例です：

1. データソースを作成します。

   再生ソースとして AVPLiveStsSource を渡す必要があります。

   // LiveSts オブジェクトを作成し、encryptionType を 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];// 必須。 暗号化タイプを ENCRYPTION_TYPE_FAIRPLAY に設定します。
    // 再生ソースを設定します。
    [self.aliPlayer setLiveStsSource:liveStsSource];
    ......
    // 再生の準備をします。
    [self.aliPlayer prepare];

2. STS 認証情報の無効化をリッスンします。

   暗号化されたライブ再生中に、暗号鍵がローテーションされることがあります。これが発生すると、プレーヤーは STS 認証情報を使用して新しいキーを要求します。無効な認証情報は再生を中断させるため、認証情報の有効性を監視する必要があります。

    __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(); // これは非同期または同期の操作にすることができます。
           return Pending;
       }
       [weakSelf.aliPlayer stop];
       return Invalid;
   }];

   説明

   新しい STS 認証情報を取得した後、updateLiveStsInfo メソッドを呼び出して更新する必要があります。新しい認証情報の取得に失敗した場合は、再生を停止することをお勧めします。STS 認証情報を更新しないと、プレーヤーは期限切れの認証情報を使用してキーを要求しようとし、画面の乱れや再生の失敗を引き起こす可能性があります。

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

FairPlay 用 UrlSource

まず、「Live Packaging」を参照して DRM 暗号化を設定します。UrlSource メソッドを使用して DRM 暗号化されたビデオを再生する場合、通常のビデオと同じ設定を使用するだけでなく、AVPDrmDelegate インターフェイスを実装して FairPlay 証明書とビデオキーを取得する必要もあります。

@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"];
    }
    //...
}

// AVPDrmDelegate.requestCert および requestKey インターフェイスを実装します。 サードパーティ DRM プロバイダーのドキュメントに従って、証明書とキーを取得します。
// 次の例は、PallyCon から証明書とキーを取得する方法を示しています。 詳細については、https://pallycon.com/docs/en/multidrm をご参照ください。
#pragma mark AVPDrmDelegate
- (NSData *)requestCert:(AliPlayer *)player {
    // 起動の遅延を減らすために、証明書を事前にフェッチしてキャッシュすることもできます。 その場合は、ここでキャッシュされた証明書を返します。
    // 証明書データが無効な場合、プレーヤーはエラーを報告します。 コンソールで詳細なエラー情報を確認することもできます。
    // SITE_ID を独自のサイト ID に置き換えます。
    const char* url = "https://license.pallycon.com/ri/fpsKeyManager.do?siteId=SITE_ID";

    // DRM プロバイダーの要件に従って、HTTP GET リクエストを使用して FairPlay 証明書を要求します。
    // このスレッドを長時間ブロックしないようにしてください。
    NSData* responseData = [self performAsyncHttpGet:url];
    if (!responseData) {
        // 例外を処理します。 プレーヤーはエラーを報告します。
        return nil;
    }
    
    // 応答データは、プレーヤーに返される前に Base64 デコードする必要があります。
    NSString *base64String = [[NSString alloc] initWithData:responseData encoding:NSUTF8StringEncoding];
    return [self decodeBase64String:base64String];
}

- (NSData *)requestKey:(AliPlayer *)player data:(NSData *)data {
    // DRM プロバイダーの要件に従って、HTTP POST リクエストを使用してキー情報を要求します。
    NSString *urlString = [NSString stringWithFormat:@"https://license-global.pallycon.com/ri/licenseManager.do"];
    const char *url = [urlString UTF8String];

    // TOKEN_ID を独自のトークン ID に置き換えます。
    NSString *headerString = [NSString stringWithFormat:@"pallycon-customdata-v2: TOKEN_ID"];
    const char* headers[] = {
        [headerString UTF8String]
    };
    int headerCount = sizeof(headers) / sizeof(headers[0]);

    // このスレッドを長時間ブロックしないようにしてください。
    NSData* responseData = [self performAsyncHttpPost:url
                                             headers:headers
                                         headerCount:headerCount
                                                data:data];
    if (!responseData) {
        // 例外を処理します。 プレーヤーはエラーを報告します。
        return nil;
    }

    // トークンの response_format が `original` に設定されている場合は、応答を直接返します。 それ以外の場合は、応答を返す前に解析する必要があります。
    // 詳細については、https://pallycon.com/docs/en/multidrm/license/license-token/#token-json をご参照ください。
    // 応答の形式と構造はプロバイダーによって大きく異なる場合があります。 応答を注意深く確認してください。 応答を復号に使用できない場合、プレーヤーはエラーを報告します。
    return [[NSString alloc] initWithData:responseData encoding:NSUTF8StringEncoding];
}

VidAuth

ApsaraVideo for VOD の VidAuth メソッドでプライベート暗号化された HLS または MP4 ビデオを再生する場合、ビデオに暗号化されていないストリームまたは標準のトランスコード済みストリームも含まれている場合は、暗号化タイプを AliyunVoDEncryption に設定して、プライベート暗号化されたストリームのみを再生します。

FlutterAliplayer.setEncryptType(EncryptType.AliyunVoDEncryption); // オプション。 これを AliyunVoDEncryption に設定すると、プライベート暗号化されたビデオストリームのみが返されます。
FlutterAliplayer.generatePlayerConfig().then((value) {
          this.fAliplayer.setVidAuth(
              vid: "The video ID",
              region: "The region ID", // 必須。 ApsaraVideo for VOD がアクティブ化されているリージョン。 デフォルト：cn-shanghai。
              playAuth: "<yourPlayAuth>", // 必須。 PlayAuth。 ApsaraVideo for VOD の GetVideoPlayAuth オペレーションを呼び出して取得します。
              playConfig: value);
});

VidSts

ApsaraVideo for VOD の VidSts メソッドでプライベート暗号化された HLS または MP4 ビデオを再生する場合、ビデオに暗号化されていないストリームまたは標準のトランスコード済みストリームも含まれている場合は、暗号化タイプを AliyunVoDEncryption に設定して、プライベート暗号化されたストリームのみを再生します。

FlutterAliplayer.setEncryptType(EncryptType.AliyunVoDEncryption); // オプション。 これを AliyunVoDEncryption に設定すると、プライベート暗号化されたビデオストリームのみが返されます。
FlutterAliplayer.generatePlayerConfig().then((value) {
          this.fAliplayer.setVidSts(
              vid: "The video ID",
              region: "The region ID",
              accessKeyId: "<yourAccessKeyId>",
              accessKeySecret: "<yourAccessKeySecret>",
              securityToken: "<yourSecurityToken>",
              playConfig: value);
        });

UrlSource

UrlSource ベースの再生でライセンスベースのプライベート暗号化を使用して暗号化された HLS または MP4 形式のビデオを再生する場合、オーディオまたはビデオの再生 URL の取得オペレーションを呼び出して再生 URL を取得します。取得した URL に etavirp_nuyila=1 を追加してからプレーヤーに渡す必要があります。(このパラメーターは MP4 ファイルにのみ必要です。HLS ファイルの場合は、元のビデオ URL を直接使用できます。) プレーヤー SDK の設定は標準ビデオの場合と同じで、追加のパラメーターは必要ありません。

再生 URL の例 1：https://example.aliyundoc.com/test.mp4?etavirp_nuyila=1

再生 URL の例 2：https://example.aliyundoc.com/test.mp4?auth_key=xxxxx&etavirp_nuyila=1

// 再生 URL。
String playURL = "https://example.aliyundoc.com/test.mp4?etavirp_nuyila=1"

// プレーヤーインスタンスを作成します。
FlutterAliplayer fAliplayer = FlutterAliPlayerFactory.createAliPlayer();
fAliplayer.setUrl(playURL);
fAliplayer.prepare();

// リストプレーヤー。
FlutterAliListPlayer fAliListPlayer = FlutterAliPlayerFactory.createAliListPlayer();
fAliListPlayer.addUrlSource(playURL,uid);
fAliListPlayer.moveTo("uid");

// プリロード。
FlutterAliPlayerMediaLoader fAliPlayerMediaLoader = FlutterAliPlayerMediaLoader();
fAliPlayerMediaLoader.load(playURL,"duration");

VidAuth

ApsaraVideo for VOD の VidAuth メソッドで HLS 標準暗号化ビデオを再生する場合、ビデオに他の暗号化タイプのストリームまたは暗号化されていないトランスコード済みストリームも含まれている場合は、暗号化タイプを HLSEncryption に設定して、HLS 標準暗号化ストリームのみを再生できます。次のコードは例です：

FlutterAliplayer.setEncryptType(EncryptType.HLSEncryption); // オプション。 HLSEncryption に設定すると、HLS 標準暗号化ビデオストリームのみが返されます。
FlutterAliplayer.setHlsUriToken("token"); // オプション。 MtsHlsUriToken を検証する必要がある場合は、このパラメーターを使用してトークンを渡します。
FlutterAliplayer.generatePlayerConfig().then((value) {
          this.fAliplayer.setVidAuth(
              vid: "The video ID",
              region: "The region ID", // 必須。 ApsaraVideo for VOD がアクティブ化されているリージョン。 デフォルト：cn-shanghai。
              playAuth: "<yourPlayAuth>", // 必須。 PlayAuth。 ApsaraVideo for VOD の GetVideoPlayAuth オペレーションを呼び出して取得します。
              playConfig: value);
});

VidSts

ApsaraVideo for VOD の VidSts メソッドで HLS 標準暗号化ビデオを再生する場合、ビデオに他の暗号化タイプのストリームまたは暗号化されていないトランスコード済みストリームも含まれている場合は、暗号化タイプを HLSEncryption に設定して、HLS 標準暗号化ストリームのみを再生できます。次のコードは例です：

FlutterAliplayer.setEncryptType(EncryptType.HLSEncryption); // オプション。 これを AliyunVoDEncryption に設定すると、プライベート暗号化されたビデオストリームのみが返されます。
FlutterAliplayer.setHlsUriToken("token"); // オプション。 MtsHlsUriToken を検証する必要がある場合は、このパラメーターを使用してトークンを渡します。
FlutterAliplayer.generatePlayerConfig().then((value) {
          this.fAliplayer.setVidSts(
              vid: "The video ID",
              region: "The region ID",
              accessKeyId: "<yourAccessKeyId>",
              accessKeySecret: "<yourAccessKeySecret>",
              securityToken: "<yourSecurityToken>",
              playConfig: value);
        });

UrlSource

UrlSource メソッドを使用して HLS 標準暗号化のライブまたはオンデマンドストリームを再生する場合、プレーヤー SDK の設定は標準ビデオの場合と同じです。

再生 URL を取得するには、ApsaraVideo for VOD の GetPlayInfo オペレーションを呼び出すことをお勧めします。

// プレーヤーインスタンスを作成します。
FlutterAliplayer fAliplayer = FlutterAliPlayerFactory.createAliPlayer();
// 再生 URL は、HLS 標準暗号化のライブまたはオンデマンドストリーム用です。
fAliplayer.setUrl("The playback URL");
fAliplayer.prepare();