ApsaraVideo VOD:高度な機能

透明度を含む動画の再生

/**
 * alpha レンダリングモードを設定します。
 *
 * @param alphaRenderMode 指定された alpha レンダリングモード。{@link AlphaRenderMode} を参照してください。
 */
abstract public void setAlphaRenderMode(AlphaRenderMode alphaRenderMode);

//--------------View の使用方法-------------
// View の場合は、透明度を設定する必要があります。
// TextureView
TextureView aliplayerView; // 再生に使用するビュー
aliplayerView.setOpaque(false);

// SurfaceView
SurfaceView aliplayerView; // 再生に使用するビュー
aliplayerView.getHolder().setFormat(PixelFormat.TRANSLUCENT);
aliplayerView.setZOrderOnTop(true); // SurfaceView を表示ウィンドウの最上位に配置します。

//-----------AliPlayer の使用方法-----------
// alpha モードを設定します。
aliPlayer.setAlphaRenderMode(IPlayer.AlphaRenderMode.RENDER_MODE_ALPHA_AT_RIGHT);
// alpha モードに対応するアセットを設定します。
UrlSource urlSource = new UrlSource();
urlSource.setUri("https://alivc-player.oss-cn-shanghai.aliyuncs.com/video/%E4%B8%9A%E5%8A%A1%E9%9C%80%E6%B1%82%E6%A0%B7%E6%9C%AC/alpha%E9%80%9A%E9%81%93/alpha_right.mp4");
aliPlayer.setDataSource(urlSource);
aliPlayer.setOnCompletionListener(new IPlayer.OnCompletionListener() {
    @Override
    public void onCompletion() {
        // オプション：単一インスタンスの再生完了後に遷移の問題が発生する場合は、画面をクリアします。
        aliPlayer.clearScreen();
    }
}
aliPlayer.setAutoPlay(true);
aliPlayer.prepare();

Android プレーヤー SDK は、SRT、SSA、ASS、VTT フォーマットの外部字幕の追加と切り替えをサポートしています。

1. 字幕を表示するビューを作成します。

   字幕のフォーマットに基づいて、異なるビューを作成します。

   展開してコードを表示

   // SRT および VTT フォーマットの字幕を表示する場合。
   SubtitleView subtitleView = new SubtitleView(getContext());
   // プレーヤー V7.6.0 以降では、SRT および VTT フォーマットの字幕の表示に VttSubtitleView を使用することを推奨します。
   VttSubtitleView vttSubtitleView = new VttSubtitleView(getContext());
   // ASS および SSA フォーマットの字幕を表示する場合。
   AssSubtitleView assSubtitleView = new AssSubtitleView(getContext());
   // 字幕ビューをレイアウトに追加します。
   viewGroup.addView(assSubtitleView);

   プレーヤー V7.6.0 以降を組み込み、VttSubtitleView を使用して SRT および VTT 字幕を表示する場合は、次のリスナーを設定します。

   // プレーヤー V7.6.0 以降で必須です。
   mAliPlayer.setOnVideoSizeChangedListener(new IPlayer.OnVideoSizeChangedListener() {
       @Override
       public void onVideoSizeChanged(int width, int height) {
           int viewWidth = getWidth();
           int viewHeight = getHeight();
           IPlayer.ScaleMode mode = mVideoListPlayer.getScaleMode();
           SubTitleBase.VideoDimensions videoDimensions = SubTitleBase.getVideoDimensionsWhenRenderChanged(width, height, viewWidth, viewHeight, mode);
           vttSubtitleView.setVideoRenderSize(videoDimensions.videoDisplayWidth, videoDimensions.videoDisplayHeight);
       }
   });

2. 字幕を追加します。

   重要

   onPrepared コールバックで字幕ファイルを設定します。

   mAliPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
       @Override
       public void onPrepared() {
           // 字幕を設定します (onPrepared 内で実行する必要があります)。
           mAliPlayer.addExtSubtitle(EXT_SUBTITLE_URL);
       }
   });

3. 字幕関連のリスナーを設定します。

   展開してコードを表示

   mAliPlayer.setOnSubtitleDisplayListener(new IPlayer.OnSubtitleDisplayListener() {
               @Override
               public void onSubtitleExtAdded(int trackIndex, String url) {
                   // 追加された外部字幕トラックを選択して表示します。
                   mAliPlayer.selectExtSubtitle(trackIndex, true);
               }
   
               @Override
               public void onSubtitleShow(int trackIndex, long id, String data) {
                   // 字幕データ。
                   SubtitleView.Subtitle subtitle = new SubtitleView.Subtitle();
                   subtitle.id = String.valueOf(id);
                   subtitle.content = data;
                   // 字幕を表示します。
                   mSubtitleView.show(subtitle);
               }
   
               @Override
               public void onSubtitleHide(int trackIndex, long id) {
                   // 字幕を非表示にします。
                   mSubtitleView.dismiss(String.valueOf(id));
               }
   
               @Override
               public void onSubtitleHeader(int trackIndex, String header) {
               }
           }
       );

外部字幕 (レンダリングコンポーネントによるカスタムレンダリング)

VttSubtitleView と WebVttResolver を使用して WebVTT 外部字幕を完全にサポートしており、字幕のフォントサイズ、フォントカラー、特定のフォントを柔軟にカスタマイズできます。

1. CustomStyleWebVttResolver を作成し、WebVttResolver を実装します。

   public class CustomStyleWebVttResolver extends WebVttResolver {
   
       // 作成メソッドを実装します。
       public CustomStyleWebVttResolver(Context context) {
           super(context);
           // 後ほど、ここでフォントやその他のリソースを初期化します。
       }
   }

2. applyTextSpans をオーバーライドしてスタイルをカスタマイズします。

   このメソッドは、親クラスが基本スタイルを解析した後に呼び出されるため、字幕の二次処理を行うことができます。

   • 方法 1：VttContentAttribute を変更し、親クラスのメソッドを呼び出します。

     /**
      * テキストのスタイル適用ロジックをオーバーライドし、カスタムスタイルを実装します。
      * このメソッドは親クラスが基本スタイルを解析した後に呼び出されるため、フォントサイズ、色、その他の属性の二次処理を行うことができます。
      *
      * @param spannableStringBuilder スタイル付きテキストの構築に使用します。
      * @param vttContentAttribute 現在のテキストセグメントのスタイル属性オブジェクト (フォント、色、サイズなどが含まれます)。
      * @param start スタイル適用の開始位置 (含む)。
      * @param end スタイル適用の終了位置 (含まない)。
      */
     @Override
     protected void applyTextSpans(SpannableStringBuilder spannableStringBuilder, VttContentAttribute vttContentAttribute, int start, int end) {
         // 設定します。
         // 後の調整に備えて、元のフォントサイズ (px) を保存します。
         // デフォルトのフォントサイズは、ビデオの高さの 0.0533f 倍です。
         double originalFontSizePx = vttContentAttribute.fontSizePx;
     
         // フォントサイズを 2 倍にします。
         vttContentAttribute.fontSizePx = originalFontSizePx * 2;
         
         // フォントカラーを赤に変更します。
         vttContentAttribute.mPrimaryColour = Color.argb(255, 255, 0, 0);
     
         // 親クラスのメソッドを呼び出してスタイルを適用します。
         super.applyTextSpans(spannableStringBuilder, vttContentAttribute, start, end);
     }

   • SpannableStringBuilder を直接操作して WebVTT スタイルを変更します。

     重要

     この方法では、ネイティブ WebVTT スタイルが失われる可能性があります。

     /**
      * テキストのスタイル適用ロジックをオーバーライドし、カスタムスタイルを実装します。
      * このメソッドは親クラスが基本スタイルを解析した後に呼び出されるため、フォントサイズ、色、その他の属性の二次処理を行うことができます。
      *
      * @param spannableStringBuilder スタイル付きテキストの構築に使用します。
      * @param vttContentAttribute 現在のテキストセグメントのスタイル属性オブジェクト (フォント、色、サイズなどが含まれます)。
      * @param start スタイル適用の開始位置 (含む)。
      * @param end スタイル適用の終了位置 (含まない)。
      */
     @Override
     protected void applyTextSpans(SpannableStringBuilder spannableStringBuilder, VttContentAttribute vttContentAttribute, int start, int end) {
         // フォントカラーを設定します。
         spannableStringBuilder.setSpan(
             new ForegroundColorSpan(Color.RED),
             start, end,
             Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
         );
         
         // 絶対サイズを設定します。
         spannableStringBuilder.setSpan(
             new AbsoluteSizeSpan(20), // 単位：px。
             start, end,
             Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
         );
         
         // 相対サイズを設定します。
         // spannableStringBuilder.setSpan(
         //     new RelativeSizeSpan(2.0f), // TextView のデフォルトフォントサイズに対する倍率。
         //     start, end,
         //     Spanned.SPAN_EXCLUSIVE_EXCLUSIVE
         // );
     }

3. カスタムフォント (Typeface) を設定します。

   1. asset/fonts/ ディレクトリからカスタムフォントを読み込みます。

      private Typeface mTypeface;
      
      public CustomStyleWebVttResolver(Context context) {
          super(context);
          initializeFonts(context);
      }
      
      private void initializeFonts(Context context) {
          try {
              // assets/fonts/ からフォントを読み込みます。
              mTypeface = Typeface.createFromAsset(context.getAssets(), "fonts/LongCang.ttf");
          } catch (Exception e) {
              Log.e("Font", "Failed to load font", e);
              mTypeface = Typeface.DEFAULT; // 安全なフォールバック。
          }
      }

   2. カスタムフォントを字幕に適用します。

      @Override
      protected void applyTextSpans(SpannableStringBuilder builder, VttContentAttribute attr, int start, int end) {
          // カスタムフォントを適用します。
          // 親クラスで設定されることがあるフォントをオーバーライドするため、super.applyTextSpans() の後に配置する必要があります。
          // super.applyTextSpans() の呼び出しは任意です。
          if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
              builder.setSpan(new TypefaceSpan(mTypeface), start, end, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
          } else {
              builder.setSpan(new CustomTypefaceSpan(mTypeface), start, end, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
          }
      }

      古い Android バージョンとの互換性：Android P (API 28) 未満の TypefaceSpan では Typeface オブジェクトを直接渡すことができないため、カスタム MetricAffectingSpan を作成する必要があります。

      /**
        * カスタム TypefaceSpan クラス。
        * MetricAffectingSpan を継承し、テキストの描画および計測時に Typeface を正しく適用します。
        * 標準の TypefaceSpan では Typeface オブジェクトを直接使用できない問題を解決します。
      */
      private static class CustomTypefaceSpan extends MetricAffectingSpan {
      
          // 適用するカスタムフォント。
          private final Typeface typeface;
      
          /**
            * コンストラクター。
            *
            * @param typeface 適用する Typeface オブジェクト (null 不可)。
            */
          public CustomTypefaceSpan(Typeface typeface) {
              this.typeface = typeface;
          }
      
          /**
            * テキスト描画状態を更新します。
            * 実際のテキスト描画中に呼び出され、ペイントのフォントを設定します。
            *
            * @param tp テキスト描画に使用する TextPaint オブジェクト。
            */
          @Override
          public void updateDrawState(TextPaint tp) {
              tp.setTypeface(typeface);
          }
      
          /**
            * テキスト計測状態を更新します。
            * テキストレイアウト計算 (例：幅、改行) 中に呼び出され、計測結果を実際の描画と一致させます。
            *
            * @param p テキスト計測に使用する TextPaint オブジェクト。
            */
          @Override
          public void updateMeasureState(TextPaint p) {
              p.setTypeface(typeface);
          }
      }

4. プレーヤーに統合します。

   1. 字幕ビューを初期化します。

      // subtitleView を初期化します。
      private void initSubtitleView() {
          // コンテキストを取得します。
          Context context = getContext();
      
          // CustomStyleWebVttResolver を作成します。
          CustomStyleWebVttResolver mResolver = new CustomStyleWebVttResolver(context);
      
          // VttSubtitleView を作成し、CustomStyleWebVttResolver を渡します。
          VttSubtitleView mVttSubtitleView = new VttSubtitleView(context, mResolver);
      
          // ビデオコンテナーに追加します。
          rootView.addView(mVttSubtitleView);
      }

   2. 外部字幕のコールバックをバインドします。

      // 字幕リスナーを設定します。
      mAliPlayer.setOnSubtitleDisplayListener(new IPlayer.OnSubtitleDisplayListener() {
          @Override
          public void onSubtitleExtAdded(int trackIndex, String url) {
              mAliPlayer.selectExtSubtitle(trackIndex, true);
          }
      
          @Override
          public void onSubtitleShow(int trackIndex, long id, String data) {
              if (mVttSubtitleView != null) {
                  // 字幕を表示します。
                  mVttSubtitleView.show(id, data); 
              }
          }
      
          @Override
          public void onSubtitleHide(int trackIndex, long id) {
              // 字幕を非表示にします。
              mVttSubtitleView.dismiss(id);
          }
      
          @Override
          public void onSubtitleHeader(int i, String header) {
              if (!TextUtils.isEmpty(header)) {
                  // WebVTT ヘッダーのスタイルを適用します。
                  mVttSubtitleView.setVttHeader(header);
              }
          }
      });

デバイスがクラウドベースの H.265 ハードウェアデコードブラックリストに登録されている場合や、H.265 ハードウェアデコードに失敗した場合、適応的デグレードが作動します。H.264 バックアップストリームが存在する場合、プレーヤーはそれを使用します。存在しない場合は、H.265 ソフトウェアデコードにデグレードします。

// アプリケーション層で、元の URL とバックアップ URL のキーと値のペアを格納する Map を保持します。切り替え時は、元の URL をキーに Map からバックアップ URL を検索します。
 AliPlayerGlobalSettings.setAdaptiveDecoderGetBackupURLCallback(new AliPlayerGlobalSettings.OnGetBackupUrlCallback() {
    @Override
    public String getBackupUrlCallback(int oriBizScene, int oriCodecType, String original_url) {
        String kurl = original_url;
        if (!H265toH264Map.get(kurl).isEmpty()) {
            return H265toH264Map.get(kurl);
        } else {
            return "";
        }
    }
});

ApsaraVideo VOD を構成すると、Android プレーヤー SDK でプレビュー再生を実装できます。VidSts と VidAuth の両方の再生方式に対応しています (ApsaraVideo VOD では VidAuth を推奨します)。構成および使用方法については、「動画のプレビュー」をご参照ください。

VidSts vidSts = new VidSts;
....
VidPlayerConfigGen configGen = new VidPlayerConfigGen();
configGen.setPreviewTime(20);// 20 秒のプレビュー
vidSts.setPlayConfig(configGen);// 再生ソースに設定
...

Android プレーヤー SDK は、PlayerConfig を通じてキャッシュとレイテンシーを制御するインターフェースを提供します。例：

// まず設定を取得します。
PlayerConfig config = aliPlayer.getConfig();
// 最大レイテンシー。注： ライブストリーミングで有効です。レイテンシーが大きい場合、プレーヤー SDK は内部でフレームを同期し、レイテンシーをこの範囲内に保ちます。
config.mMaxDelayTime = 5000;
// 最大バッファー時間 (ms)。プレーヤーは毎回この時間までのバッファーデータを読み込みます。
config.mMaxBufferDuration = 50000;
// 高バッファー時間 (ms)。ネットワーク状態が悪くバッファリングが発生した場合、バッファー時間がこの値に達すると読み込みを停止します。
config.mHighBufferDuration = 3000;
// 起動バッファー時間 (ms)。この値が小さいほど起動は速くなりますが、再生開始後すぐに読み込み状態に入る可能性があります。
config.mStartBufferDuration = 500;
....// その他の設定。
// 最大後方バッファー時間 (ms)。デフォルトは 0 です。
config.mMaxBackwardBufferDurationMs = 0;

// プレーヤーに設定を適用します。
aliPlayer.setConfig(config);

ピクチャー イン ピクチャー

手順：

1. AndroidManifest.xml ファイルで、ピクチャー イン ピクチャーの権限を宣言します。

   <activity
     android:name=".PictureInPictureActivity"
     android:exported="true"
     android:supportsPictureInPicture="true"
     android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation" />

2. 対象の アクティビティ をピクチャー イン ピクチャー モードに切り替えます。

   Rational aspectRatio = new Rational(16, 9); // ピクチャー イン ピクチャーのアスペクト比。ビジネス要件に基づいて調整してください。
   PictureInPictureParams.Builder pipBuilder = new PictureInPictureParams.Builder();
   pipBuilder.setAspectRatio(aspectRatio);
   enterPictureInPictureMode(pipBuilder.build());

   ピクチャー イン ピクチャー モードは、OnClick (クリックイベント)、アプリを離れるとき、または戻るボタンを押したときにトリガーできます。実装方法：

   OnClick (クリックイベント) のトリガー

   button.setOnClickListener(new View.OnClickListener() {
       @Override
       public void onClick(View v) {
           Rational aspectRatio = new Rational(16, 9); // ピクチャー イン ピクチャーのアスペクト比。
           PictureInPictureParams.Builder pipBuilder = new PictureInPictureParams.Builder();
           pipBuilder.setAspectRatio(aspectRatio);
           enterPictureInPictureMode(pipBuilder.build());
       }
   });

   アプリを離れるときのトリガー

   @Override
   protected void onUserLeaveHint() {
       super.onUserLeaveHint();
       Rational aspectRatio = new Rational(16, 9); // ピクチャー イン ピクチャーのアスペクト比。
       PictureInPictureParams.Builder pipBuilder = new PictureInPictureParams.Builder();
       pipBuilder.setAspectRatio(aspectRatio);
       enterPictureInPictureMode(pipBuilder.build());
   
       Log.e(TAG, "Picture-in-Picture onUserLeaveHint");
   }

   戻るボタン押下時のトリガー

   @Override
   public void onBackPressed() {
       super.onBackPressed();
       // 戻るボタンの押下でトリガーします。
       enterPictureInPictureMode();
   }

3. ピクチャー イン ピクチャーの表示/非表示に応じて UI を処理します。

   @Override
   public void onPictureInPictureModeChanged(boolean isInPictureInPictureMode, Configuration newConfig) {
       super.onPictureInPictureModeChanged(isInPictureInPictureMode, newConfig);
       if (isInPictureInPictureMode) {
           // ピクチャー イン ピクチャー モードへの移行を処理します。
           // UI を非表示にします。
           Log.e(TAG, "Entered Picture-in-Picture mode");
       } else {
           // ピクチャー イン ピクチャー モードの終了を処理します。
           // UI を表示します。 
           Log.e(TAG, "Exited Picture-in-Picture mode");
       }
   }

RTS 超低遅延ライブ再生

RTS ライブ再生

Android プレーヤー SDK は、出力オーディオチャンネルを設定するための setOutputAudioChannel メソッドを提供します。入力ソースがステレオの場合、このメソッドを使用して左または右チャンネルに切り替えることができます。入力ソースがモノラルの場合、設定しても効果はありません。

/*
OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_LEFT は左チャンネル再生に切り替えます。
OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_RIGHT は右チャンネル再生に切り替えます。
OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_NONE はチャンネルを切り替えず、入力ソースのチャンネルを維持します。
*/
aliPlayer.setOutputAudioChannel(OutputAudioChannel.OUTPUT_AUDIO_CHANNEL_LEFT);

リスナーを設定して、オーディオストリームとビデオストリームのデータを取得します。暗号化されたストリームは解析できないため、ストリームは暗号化されていない必要があります。

// 任意の設定 1：下層データのアドレスを返すかどうか。
IPlayer.RenderFrameCallbackConfig config = new IPlayer.RenderFrameCallbackConfig();
config.mVideoDataAddr = true;// 下層ビデオデータのアドレスのみを返すかどうか。
config.mAudioDataAddr = true;// 下層オーディオデータのアドレスのみを返すかどうか。
aliPlayer.setRenderFrameCallbackConfig(config);

// 任意の設定 2：ハードウェアデコーディングの場合、RenderFrame は texture_oes_id を返し、ソフトウェアデコーディングの場合、RenderFrame はソースデータを返します。
aliPlayer.enableHardwareDecoder(true);
// リスナーを設定して、オーディオデータとビデオデータを取得します。
aliPlayer.setOnRenderFrameCallback(frameInfo -> {
    if (frameInfo.frameType == FrameInfo.FrameType_video) {
        // ビデオデータ。
    } else {
        // オーディオデータ。
    }
    return false;
});

Android プレーヤー SDK では、プレーヤーのレンダリング背景色を設定できます。インターフェイスと使用方法は次のとおりです。

インターフェイス例

/**
 * ビデオの背景色を設定します。
 *
 * @param color  ARGB
 */
abstract public void setVideoBackgroundColor(int color);

使用方法

// パラメーターは 8 桁の 16 進数値です。各 2 桁は、順番に A (アルファ透明度)、R (赤)、G (緑)、B (青) を表します。
// 例えば、0xff00ff00 は緑色を表します。
aliPlayer.setVideoBackgroundColor(0xff00ff00);

vidAuth：指定再生ドメインの設定

vidAuth を使用すると、vid のドメインなどのフィールドを指定できます。サポートされているフィールドについては、「GetPlayInfo リクエストパラメーター」をご参照ください。インターフェイスと使用方法：

インターフェイスの例

/**
 * 再生パラメーターを設定します。
 *
 * @param playConfig 再生パラメーター。
 */
public void setPlayConfig(VidPlayerConfigGen playConfig);

使用方法

VidPlayerConfigGen の addPlayerConfig メソッドを使用して、playDomain フィールドを追加します。

vidAuth = new VidAuth();
VidPlayerConfigGen configGen = new VidPlayerConfigGen();
// playDomain フィールドを追加します。追加できるその他のフィールドについては、以下をご参照ください。
// https://www.alibabacloud.com/help/vod/developer-reference/api-vod-2017-03-21-getplayinfo
configGen.addPlayerConfig("playDomain", "com.xxx.xxx");
vidAuth.setPlayConfig(configGen);

H.266 デコーディングプラグイン

H.266 (VVC/Versatile Video Coding) は、同等の画質でビットレートを大幅に削減する次世代ビデオコーディング規格です。H.266 デコーディング機能は、オンデマンドで統合できるよう、プラグインとして独立してパッケージ化されています。

前提条件

1. プレーヤー SDK/統合 SDK のバージョンが V7.6.0 以降であること。

2. Professional Edition のライセンス認証が完了していること。プレーヤー SDK ライセンスの取得

3. H.266 デコーディングプラグインを搭載した ApsaraVideo Player は、ApsaraVideo VOD のオーディオとビデオのトランスコーディングによってトランスコードされた H.266 ビデオのみをサポートします。

プラグインの統合

// x.x.x はプレーヤー SDK のバージョン番号と一致します。
com.aliyun.sdk.android:AlivcVVCCodec:x.x.x

// x.x.x は統合 SDK のバージョン番号と一致します。
com.aliyun.sdk.android:AlivcVVCCodec:x.x.x-aio

プラグインの有効化

AliPlayerGlobalSettings.enableCodecPlugin("vvc", true);

関連エラーコード

H.266 デコーディングプラグインのエラーコードについては、「全プラットフォーム共通のプレーヤーの問題」をご参照ください。

再生ソースの自動更新

再生ソースの自動更新を有効にすると、認証メカニズムによるソースの有効期限切れが原因で発生する再生の中断を防ぐことができます。

前提条件

1. プレーヤー/統合 SDK バージョン V7.9.0 以降。

2. 再生向け VidAuth ソース を使用していること、またはサービス側で URL 署名 を構成していること。

/**
 * VidAuth ソースの有効期限切れイベントのリスナーを設定します。
 *
 * この機能により、期限切れによる再生の中断を回避するために VidAuth ソースを自動更新できます。
 * リスナーがトリガーされると、このコールバック内で VidAuth ソースを更新し、
 * {@link SourceRefreshCallback#onSuccess} を使用して更新済みの VidAuth を返すことができます。
 *
 * @param listener VidAuth ソースの有効期限切れイベントをリッスンするインターフェイス。{@link OnVidAuthExpiredListener} を参照してください。
 */
abstract public void setOnVidAuthExpiredListener(OnVidAuthExpiredListener listener);

/**
 * VidAuth ソースの有効期限切れ通知のリスナーです。
 * VidAuth ソースが有効期限切れになったときのイベントを処理します。
 */
public interface OnVidAuthExpiredListener {

    /**
     * プレーヤーが VidAuth ソースの有効期限切れを検出したときに呼び出されます。
     *
     * このコールバック内で VidAuth ソースを更新し、
     * {@link SourceRefreshCallback#onSuccess} を使用して新しい VidAuth を返すことができます。
     *
     * @param expiredSource 有効期限切れになった VidAuth ソースオブジェクト。{@link VidAuth} を参照してください。
     * @param callback 更新済みの VidAuth ソースをプレーヤーに提供するためのコールバック。{@link SourceRefreshCallback} を参照してください。
     */
    void onVidAuthExpired(VidAuth expiredSource, SourceRefreshCallback<VidAuth> callback);
}

/**
 * 再生ソースの更新結果を処理するためのコールバックインターフェイスです。
 *
 * このインターフェイスは、URL ソースや VidAuth ソースなど、動的な更新が必要な再生ソースタイプに適用されます。
 * プレーヤーが更新リクエストをトリガーすると、このインターフェイスを介して、`onSuccess` または `onError` メソッドのいずれかを呼び出すことで更新結果を返すことができます。
 */
public interface SourceRefreshCallback<T extends SourceBase> {
    /**
     * 更新操作が成功したときに、プレーヤーから呼び出されます。
     *
     * @param newSource 更新済み情報を含む新しい再生ソースオブジェクト。{@link SourceBase} を参照してください。
     *
     * このメソッドは、更新操作が正常に完了したことを示します。開発者はこのメソッド内で新しい再生ソースを提供し、プレーヤーが最新のリソースを読み込めるようにする必要があります。
     */
    void onSuccess(T newSource);

    /**
     * 更新操作が失敗したときに、プレーヤーから呼び出されます。
     *
     * @param errorMsg 失敗理由を示す文字列。
     *
     * このメソッドは、更新操作が失敗したことを示します。開発者は `errorMsg` を使用して失敗の詳細を取得し、その後の処理を進めることができます。
     */
    void onError(String errorMsg);
}

// VID 再生認証情報の有効期限切れリスナーを設定します。
aliPlayer.setOnVidAuthExpiredListener(new AliPlayer.OnVidAuthExpiredListener() {
    @Override
    public void onVidAuthExpired(VidAuth vidAuth, SourceRefreshCallback<VidAuth> sourceRefreshCallback) {
        
        String vid = vidAuth.getVid();

        // ------------------- ユーザーによる実装はここから -------------------
        // アプリケーションサーバーから新しい PlayAuth を取得するために、独自の関数を呼び出します。
        // clientGetPlayAuthFunction は関数名の例です。独自の実装に置き換えてください。
        clientGetPlayAuthFunction(vid, new PlayAuthCallback() {
            
            /**
             * 新しい認証情報の取得に成功したときのコールバック。
             * @param newPlayAuth サーバーから取得した新しい再生認証情報の文字列。
             */
            @Override
            public void onAuthSuccess(String newPlayAuth) {                
                // 1. 新しい PlayAuth を使用して古い vidAuth オブジェクトを更新します。
                vidAuth.setPlayAuth(newPlayAuth);
                
                // 2. SDK のコールバックを介して、更新済みオブジェクトをプレーヤーに返します。
                sourceRefreshCallback.onSuccess(vidAuth);
            }

            /**
             * 新しい認証情報の取得に失敗したときのコールバック。
             * @param errorMessage 詳細なエラーメッセージ。
             */
            @Override
            public void onAuthError(String errorMessage) {                
                // SDK のコールバックを介して、エラーメッセージをプレーヤーに返します。
                sourceRefreshCallback.onError(errorMessage);
            }
        });
        // ------------------- ユーザーによる実装はここまで -------------------
    }
});

/**
 * URL ソースの有効期限切れイベントのリスナーを設定します。
 *
 * この機能により、認証によるURLの有効期限切れが原因の再生中断を避けるため、URLを更新できます。
 * リスナーがトリガーされると、このコールバック内で URL ソースを更新し、
 * {@link SourceRefreshCallback#onSuccess} を使用して更新済みの URL ソースを返すことができます。
 *
 * @param listener URL ソースの有効期限切れイベントを処理するためのリスナー。{@link OnURLSourceExpiredListener} を参照してください。
 *
 * <p>URL 認証の設定の詳細については、
 * <a href="https://www.alibabacloud.com/help/vod/user-guide/configure-url-signing?spm=a2c4g.11186623.0.0.560c4140fGh8MW">URL 認証ドキュメント</a>をご参照ください。</p>
 */
abstract public void setOnURLSourceExpiredListener(OnURLSourceExpiredListener listener);

/**
 * 再生ソースの更新結果を処理するためのコールバックインターフェイスです。
 *
 * このインターフェイスは、URL ソースや VidAuth ソースなど、動的な更新が必要な再生ソースタイプに適用されます。
 * プレーヤーが更新リクエストをトリガーすると、このインターフェイスを介して、`onSuccess` または `onError` メソッドのいずれかを呼び出すことで更新結果を返すことができます。
 */
public interface SourceRefreshCallback<T extends SourceBase> {
    /**
     * 更新操作が成功したときに、プレーヤーから呼び出されます。
     *
     * @param newSource 更新済み情報を含む新しい再生ソースオブジェクト。{@link SourceBase} を参照してください。
     *
     * このメソッドは、更新操作が正常に完了したことを示します。開発者はこのメソッド内で新しい再生ソースを提供し、プレーヤーが最新のリソースを読み込めるようにする必要があります。
     */
    void onSuccess(T newSource);

    /**
     * 更新操作が失敗したときに、プレーヤーから呼び出されます。
     *
     * @param errorMsg 失敗理由を示す文字列。
     *
     * このメソッドは、更新操作が失敗したことを示します。開発者は `errorMsg` を使用して失敗の詳細を取得し、その後の処理を進めることができます。
     */
    void onError(String errorMsg);
}

/**
 * URL ソースの有効期限切れ通知のリスナーです。
 * 有効期限切れのソースを処理して、再生の中断を防止します。
 */
public interface OnURLSourceExpiredListener {

    /**
     * プレーヤーが URL ソース (UrlSource) の有効期限切れを検出したときに呼び出されます。
     *
     * このコールバック内で URL ソースを更新し、
     * {@link SourceRefreshCallback#onSuccess} を使用して新しい UrlSource を返すことができます。
     *
     * @param expiredSource 有効期限切れになった UrlSource オブジェクト。{@link UrlSource} を参照してください。
     * @param callback 更新済みの UrlSource をプレーヤーに返すための更新コールバック。{@link SourceRefreshCallback} を参照してください。
     */
    void onUrlSourceExpired(UrlSource expiredSource, SourceRefreshCallback<UrlSource> callback);
}

// プレーヤーの URL 有効期限切れリスナーを設定します。
mAliyunVodPlayer.setOnURLSourceExpiredListener(new UrlPlayer.OnURLSourceExpiredListener() {
    @Override
    public void onUrlSourceExpired(UrlSource urlSource, UrlPlayer.SourceRefreshCallback<UrlSource> sourceRefreshCallback) {
        String expiredUrl = urlSource.getUri();
        Log.d(TAG, "[onUrlSourceExpired] Received expired URL: " + expiredUrl);

        // 1. 認証キーが有効かどうかを確認します (authenticationKey はクラスのメンバー変数であると仮定します)。
        if (authenticationKey == null || authenticationKey.trim().isEmpty()) {
            Log.e(TAG, "Refresh failed: Authentication key is empty.");
            sourceRefreshCallback.onError("REFRESH_ERROR: Authentication key is missing.");
            return; // キーが無効な場合は早期に終了します。
        }

        // 2. 再生 URL の有効期間 (有効期限) を計算します。
        // クラスのメンバー validTime が有効な場合はそれを使用し、そうでない場合はデフォルトで 3600 秒 (1 時間) にします。
        long validityDuration = (AliyunVodPlayerView.this.validTime > 0) ? validTime : 3600;
        long newExpireTime = (System.currentTimeMillis() / 1000) + validityDuration;

        // 3. 有効期限切れ URL から元の URL を抽出します (認証タイプ A を例とします)。
        // URL パラメーター (例："?auth_key=") を削除して、元のリソースアドレスを復元します。
        int authKeyIndex = expiredUrl.indexOf("?auth_key=");
        if (authKeyIndex == -1) {
            authKeyIndex = expiredUrl.indexOf("&auth_key=");
        }
        // auth_key が見つからない場合にも安全に対応します。
        String originalUrl = (authKeyIndex != -1) ? expiredUrl.substring(0, authKeyIndex) : expiredUrl;

        // 4. ユーティリティクラスを使用して新しい認証済み URL を生成します。
        String newAuthUrl = CdnAuthUtil.aAuth(originalUrl, authenticationKey, newExpireTime);

        // 5. 生成した認証済み URL を確認し、コールバックを介して結果を返します。
        if (newAuthUrl != null && !newAuthUrl.isEmpty()) {
            Log.i(TAG, "Refresh success, new URL: " + newAuthUrl);
            // SDK が要求する UrlSource オブジェクトを作成し、新しい URL を設定します。
            UrlSource resultSource = new UrlSource();
            resultSource.setUri(newAuthUrl);
            sourceRefreshCallback.onSuccess(resultSource);
        } else {
            Log.e(TAG, "Refresh failed: Failed to generate new authorized URL.");
            sourceRefreshCallback.onError("REFRESH_ERROR: Failed to generate new URL.");
        }
    }
});

補足ユーティリティ関数

認証タイプ A を例とします。

// 認証済み URL 生成関数。
private String generateAuthUrl(String uri, String key, long exp) {
    Pattern uriPattern = Pattern.compile("^(https?://)?([^/?]+)(/[^?]*)?(\\?.*)?$");
    Matcher m = uriPattern.matcher(uri);

    if (!m.matches()) {
        return null;
    }

    String scheme = (m.group(1) != null) ? m.group(1) : "http://";
    String host = m.group(2);
    String path = (m.group(3) != null) ? m.group(3) : "/";
    String args = (m.group(4) != null) ? m.group(4) : "";

    String rand = "0";
    String uid = "0";

    String sstring = String.format("%s-%d-%s-%s-%s", path, exp, rand, uid, key);
    String hashvalue = md5sum(sstring);
    String authKey = String.format("%d-%s-%s-%s", exp, rand, uid, hashvalue);

    if (!args.isEmpty()) {
        return String.format("%s%s%s%s&auth_key=%s", scheme, host, path, args, authKey);
    } else {
        return String.format("%s%s%s%s?auth_key=%s", scheme, host, path, args, authKey);
    }
}

// MD5 計算ユーティリティ関数。
private String md5sum(String src) {
    try {
        MessageDigest md = MessageDigest.getInstance("MD5");
        md.update(src.getBytes(StandardCharsets.UTF_8));
        byte[] digest = md.digest();

        StringBuilder hexString = new StringBuilder();
        for (byte b : digest) {
            hexString.append(String.format("%02x", b));
        }
        return hexString.toString();
    } catch (NoSuchAlgorithmException e) {
        throw new RuntimeException("MD5 algorithm not found", e);
    }
}

バインドされた NIC の切り替え

Android プレーヤー SDK は、ネットワークの異常時に NIC を自動的に切り替え、リソースの安定した再生を確保する AliPlayerGlobalSettings.enableSwitchNIC メソッドを提供します。例：

AliPlayerGlobalSettings.enableSwitchNIC(true);

オーディオエンハンスメント

Android プレーヤー SDK は、音声再生体験を向上させるためのオーディオエンハンスメントプラグインを提供しており、音量正規化、音声強調、サラウンドサウンドが特徴です。

機能紹介

• 音量正規化：すべてのオーディオコンテンツを一定の音量レベルに自動調整し、元の音量が極端に低いまたは高い動画の再生体験を大幅に向上させます。

  • 対応チャンネル：モノラル / ステレオ / 5.1 / 7.1。

  • 対応サンプルレート：16 kHz / 44.1 kHz / 48 kHz。

• 音声強調：元の音色を維持しながら対話をインテリジェントに強調し、騒がしいシーンでも音声をよりクリアで明るくします。

  • 対応チャンネル：ステレオ。

  • 対応サンプルレート：44.1 kHz / 48 kHz。

• サラウンドサウンド：マルチチャンネルおよびステレオ動画に仮想サラウンドレンダリングを適用し、ヘッドフォンや標準的なデバイスで没入感のある体験を提供します。3DSurround (ステレオサラウンド) と MegaBass (スーパーベース) モードを備えています。

  • 対応チャンネル：モノラル / ステレオ / 5.1 / 7.1。

  • 対応サンプルレート：44.1 kHz / 48 kHz。

前提条件

1. プレーヤー/統合 SDK のバージョンが V7.13.0 以降であること。

2. Professional Edition License の権限が付与されていること。プレーヤー SDK ライセンスの取得

プラグインの統合

// x.x.x はプレーヤー SDK のバージョン番号と一致します。
implementation 'com.aliyun.sdk.android:AlivcAudioEnhanceFilter:x.x.x'

機能インターフェイス

player.setFilterValid("audioEnhance", true);   // 有効化。
player.setFilterValid("audioEnhance", false);  // 無効化。

FilterConfig filterConfig = new FilterConfig();
FilterConfig.Filter filterItem = new FilterConfig.Filter("audioEnhance");
FilterConfig.FilterOptions opts = new FilterConfig.FilterOptions();
// サラウンドサウンド。
opts.setOption("enable_surround", true);
opts.setOption("surround_effect_type", "3DSurround"); // 初回使用時は、タイプを enable_surround と一緒に設定する必要があります。
// 音声強調。
opts.setOption("enable_dialoguenhance", true);
opts.setOption("dialoguenhance_voice", 1.0f); // 1.0 ~ 10.0。初回使用時は、音声強調の強度を enable_dialoguenhance と一緒に設定する必要があります。
// 音量正規化。
opts.setOption("enable_normalizer", true);

filterItem.setOptions(opts);
filterConfig.addFilter(filterItem);
player.setFilterConfig(filterConfig);

FilterConfig.FilterOptions opts = new FilterConfig.FilterOptions();
opts.setOption("enable_surround", true);
opts.setOption("surround_effect_type", "3DSurround"); // 初回有効時でない場合、初期化が完了しているためこのタイプ設定は無効です。
player.updateFilterConfig("audioEnhance", opts);

Android プレーヤー SDK は、再生開始前に最初のフレームを高速でレンダリングする機能をサポートしており、起動速度を向上させることができます。

aliPlayer.setOption(ALLOW_PRE_RENDER, 1);

ローカルキャッシュは、起動速度、シーク速度を向上させ、繰り返し再生時のカクつきを減らしながら、帯域幅を節約します。

ローカルキャッシュの有効化

// ローカルキャッシュを有効にします (デフォルトパス)。
AliPlayerGlobalSettings.enableLocalCache(true, this);

/**
 * キャッシュ設定には、次のコードを使用することもできます。
 * ローカルキャッシュを有効にします。有効にすると、コンテンツはローカルファイルにキャッシュされます。
 * @param enable：ローカルキャッシュ機能のスイッチ。true：有効、false：無効。デフォルトでは無効です。
 * @param maxBufferMemoryKB：バージョン 5.4.7.1 以降は非推奨であり、現在効果はありません。
 * @param localCacheDir：設定必須。ローカルキャッシュディレクトリの絶対パス。
 * AliPlayerGlobalSettings.enableLocalCache(enable, maxBufferMemoryKB, localCacheDir);
 */

/**
 * ローカルキャッシュファイルのクリーンアップ設定。
 * @param expireMin - バージョン 5.4.7.1 以降は非推奨であり、現在効果はありません。
 * @param maxCapacityMB - 最大キャッシュ容量 (MB 単位)。デフォルトは 20 GB です。クリーンアップ中、合計キャッシュサイズがこの値を超えた場合、サイズが maxCapacityMB 以下になるまで、キャッシュ項目が古いものから順に削除されます。
 * @param freeStorageMB - 最小空きディスク容量 (MB 単位)。デフォルトは 0 です。クリーンアップ中、現在のディスク空き容量がこの値未満の場合、空き容量がこの値以上になるか、すべてのキャッシュがクリアされるまで、キャッシュ項目が古いものから順に削除されます。
 * public static void setCacheFileClearConfig(long expireMin,
 *         long maxCapacityMB,
 *         long freeStorageMB)
 */

 /**
  * URL ハッシュ値を読み込むためのコールバックを設定します。設定されていない場合、SDK は MD5 アルゴリズムを使用します。
  * public static void setCacheUrlHashCallback(AliPlayerGlobalSettings.OnGetUrlHashCallback cb)
  */

単一URLのローカルキャッシュの有効化または無効化

// まず設定を取得します。
PlayerConfig config = aliPlayer.getConfig();
// 再生URLのローカルキャッシュを有効にするかどうか。デフォルトは true です。グローバルなローカルキャッシュが有効な状態でこの値を true に設定すると、このURLに対してローカルキャッシュが有効になります。false に設定すると、このURLのローカルキャッシュは無効になります。
config.mEnableLocalCache = false;
....// その他の設定。

// プレーヤーに設定を適用します。
aliPlayer.setConfig(config);

プリロードは、動画キャッシングのメモリ使用量を設定することで動画の起動速度を向上させる、ローカルキャッシュのアップグレード版です。

AliPlayerGlobalSettings.enableNetworkBalance(false);

1. ローカルキャッシュを有効にします。詳細な手順については、「ローカルキャッシュ」をご参照ください。

2. データソースを設定します。

   VidAuth (推奨)

   VidAuth vidAuth = new VidAuth();
   vidAuth.setVid("Vid info"); // 必須パラメーター： 動画ID。
   vidAuth.setPlayAuth("<yourPlayAuth>"); // 必須パラメーター： 再生認証情報。ApsaraVideo VOD の GetVideoPlayAuth API を呼び出して生成されます。
   vidAuth.setRegion("Access region"); // プレーヤー SDK バージョン 5.5.5.0 以降、このパラメーターは非推奨であり、必須ではありません。プレーヤーが自動的にリージョンを解析します。5.5.5.0 より前のバージョンでは、このパラメーターは必須です。デフォルトの ApsaraVideo VOD アクセスリージョンは cn-shanghai です。
   vidAuth.setQuality("Selected definition"); // "AUTO" はアダプティブビットレートを表します。

   VidSts

   VidSts vidSts = new VidSts();
   vidSts.setVid("Vid info"); // 必須パラメーター： 動画ID。
   vidSts.setAccessKeyId("<yourAccessKeyId>"); // 必須パラメーター： STS 一時 AK ペアのアクセスキー ID。STS の AssumeRole API を呼び出して生成されます。
   vidSts.setAccessKeySecret("<yourAccessKeySecret>"); // 必須パラメーター： STS 一時 AK ペアのアクセスキー。STS の AssumeRole API を呼び出して生成されます。
   vidSts.setSecurityToken("<yourSecurityToken>"); // 必須パラメーター： STS セキュリティトークン。STS の AssumeRole API を呼び出して生成されます。
   vidSts.setRegion("Access region"); // 必須パラメーター： ApsaraVideo VOD アクセスリージョン。デフォルトは cn-shanghai です。
   vidSts.setQuality("Selected definition"); // "AUTO" はアダプティブビットレートを表します。

   UrlSource

   UrlSource urlSource = new UrlSource();
   urlSource.setUri("Playback address"); // 必須パラメーター： 再生アドレス。サードパーティの VOD アドレスまたは Alibaba Cloud ApsaraVideo VOD の再生アドレスが使用できます。

3. タスクパラメーターを設定します。

   説明

   マルチビットレート動画にのみ適用されます。setDefaultBandWidth、setDefaultResolution、または setDefaultQuality のいずれかを選択してください。

   PreloadConfig preloadConfig = new PreloadConfig();
   // マルチビットレートストリームのプリロードビットレートを設定します。
   preloadConfig.setDefaultBandWidth(400000);
   // マルチビットレートストリームのプリロード解像度を設定します。
   preloadConfig.setDefaultResolution(640 * 480);
   // マルチビットレートストリームのプリロード画質を設定します。
   preloadConfig.setDefaultQuality("FD");
   // プリロード時間を設定します。
   preloadConfig.setDuration(1000);

4. タスクリスナーを追加します。

   コードを展開して表示

   /**
    * プリロードリスナーの実装。
    */
   private static class PreloadListenerImpl extends OnPreloadListener {
   
       @Override
       public void onError(@NonNull String taskId, @NonNull String urlOrVid, @NonNull ErrorInfo errorInfo) {
           // プリロードエラー。
       }
   
       @Override
       public void onCompleted(@NonNull String taskId, @NonNull String urlOrVid) {
           // プリロード完了。
       }
   
       @Override
       public void onCanceled(@NonNull String taskId, @NonNull String urlOrVid) {
          // プリロードキャンセル。
       }
   }

5. タスクをビルドし、MediaLoaderV2 インスタンスに追加してプリロードを開始します。

   VidAuth (推奨)

   // プリロードタスクをビルドします。
   PreloadTask mPreloadTask = new PreloadTask(vidAuth, preloadConfig);
   // MediaLoaderV2 インスタンスを取得します。
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // タスクを追加してプリロードを開始します。
   String taskId = mediaLoaderV2.addTask(mPreloadTask, PreloadListenerImpl)

   VidSts

   // プリロードタスクをビルドします。
   PreloadTask mPreloadTask = new PreloadTask(vidSts, preloadConfig);
   // MediaLoaderV2 インスタンスを取得します。
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // タスクを追加してプリロードを開始します。
   String taskId = mediaLoaderV2.addTask(mPreloadTask, PreloadListenerImpl);

   UrlSource

   // プリロードタスクをビルドします。
   PreloadTask mPreloadTask = new PreloadTask(urlSource, preloadConfig);
   // MediaLoaderV2 インスタンスを取得します。
   MediaLoaderV2 mediaLoaderV2 = MediaLoaderV2.getInstance();
   // タスクを追加してプリロードを開始します。
   String taskId = mediaLoaderV2.addTask(mPreloadTask, PreloadListenerImpl)

6. （オプション）：タスクを管理します。

   mediaLoaderV2.cancelTask(taskId); // 指定されたタスクIDのプリロードタスクをキャンセルします。
   mediaLoaderV2.pauseTask(taskId); // 指定されたタスクIDのプリロードタスクを一時停止します。
   mediaLoaderV2.resumeTask(taskId); // 指定されたタスクIDのプリロードタスクを再開します。

7. （オプション）：プリロードされたファイルを削除します。

   容量を節約するために、必要に応じてプリロードされたファイルを削除します。Android プレーヤー SDK は削除インターフェイスを提供していないため、アプリ内のプリロードディレクトリからファイルを削除してください。

動的プリロード戦略により、開発者は現在再生中の動画のキャッシュと、プリロードされたアイテムの数およびキャッシュの両方を制御でき、再生体験とコストオーバーヘッドのバランスを取ることができます。

// 推奨設定と動的プリロードを有効にします。
aliListPlayer.setPreloadScene(IListPlayer.SceneType.SCENE_SHORT);

// ベースラインのプリロード時間を設定します。
// プリロード時間を 1000 ms に設定します。
PreloadConfig config = new PreloadConfig();
config.mPreloadDuration = 1000;
aliListPlayer.updatePreloadConfig(config);

// プリロード数を設定します。双方向のプリロードをサポートします。
// 前方に 1 つ、後方に 3 つプリロードします。
aliListPlayer.setPreloadCount(1, 3);

// 動的プリロードの減少オフセットを設定します。
aliListPlayer.enablePreloadStrategy(IListPlayer.StrategyType.STRATEGY_DYNAMIC_PRELOAD_DURATION, true);
aliListPlayer.setPreloadStrategy(IListPlayer.StrategyType.STRATEGY_DYNAMIC_PRELOAD_DURATION, "{\"algorithm\": \"sub\",\"offset\": \"200\"}");

マルチビットレートHLS動画のプリロード

listPlayer とマルチビットレート HLS 動画の再生シナリオでは、開発者は現在の再生画質に一致するストリームをプリロードし、ビジネスニーズに基づいてプリロードモードを選択できます。

  /**
   * デフォルト設定。デフォルトのビットレートを再生およびプリロードします。
   */
  MultiBitratesMode_Default(0),

  /**
   * 初回フレーム優先設定。初回フレームのコストを削減します。プリロードされた HLS ストリームのビットレートのみを再生します。
   */
  MultiBitratesMode_FCPrio(1),

  /**
   * 初回フレームと再生のスムーズさのバランスを取ります。moveToNext の前後で同じビットレートを再生し、初回フレームのパフォーマンスを優先します。
   */
  MultiBitratesMode_FC_AND_SMOOTH(2),

  /**
   * 再生のスムーズさ優先設定。moveToNext の前後で同じビットレートを再生します。
   */
  MultiBitratesMode_SmoothPrio(3);

// マルチビットレートプリロードモードを選択します。
aliListPlayer.setMultiBitratesMode(preLoadMode);

// (オプション) 起動ビットレートを選択します。
aliListPlayer.setDefaultBandWidth(defaultBandWidth);

// (オプション) onPrepared コールバックで、ABR モードを選択します。
aliListPlayer.setOnPreparedListener(new IPlayer.OnPreparedListener() {
    @Override
    public void onPrepared() {
        // ABR はマルチビットレート m3u8 にのみ影響します。
        aliListPlayer.selectTrack(-1);
    }
});

HTTPDNS

// 強化 HTTPDNS を有効化します。
AliPlayerGlobalSettings.enableEnhancedHttpDns(true);
// オプション: HTTPDNS の事前名前解決ドメインを追加します。
DomainProcessor.getInstance().addPreResolveDomain("player.***alicdn.com");

HTTP/2

AliPlayerGlobalSettings.setUseHttp2(true);

HTTP TCP 事前接続

HTTP ビデオ再生リクエスト (非 HTTPS) の場合、事前に TCP 接続を確立すると、ユーザーエクスペリエンスが大幅に向上し、ネットワーク接続時間が短縮され、即時かつ連続再生が確保され、ネットワークおよびシステムリソースの使用が最適化されます。使用法：

// ドメイン形式は host[:port] です。port は任意です。複数のドメインはセミコロン (;) で区切ります。
// グローバル設定。
// この設定は、呼び出すたびに指定された文字列で完全に更新されます。その結果、以前のリストと比較してドメインが追加または削除されます。空の文字列を指定すると事前接続は停止します。
AliPlayerGlobalSettings.setOption(AliPlayerGlobalSettings.SET_PRE_CONNECT_DOMAIN, "domain1;domain2");

Android プレーヤー SDK は、Video on Demand (VOD) サービス向けの動画ダウンロード機能を提供し、ユーザーは ApsaraVideo Player を使用して動画をローカルにキャッシュできます。ダウンロード方式は、標準ダウンロードとセキュアダウンロードの 2 つです。

• 標準ダウンロード

  ダウンロードした動画データは Alibaba Cloud によって暗号化されず、サードパーティ製プレーヤーで再生できます。

• セキュアダウンロード

  ダウンロードした動画データは Alibaba Cloud によって暗号化されます。サードパーティ製プレーヤーでは再生できません。ApsaraVideo Player のみが再生できます。

使用方法

• 動画ダウンロードをサポートするのは VidSts と VidAuth のみです。

• プレーヤーの動画ダウンロード機能を使用するには、VOD コンソールでダウンロードモードを有効化して設定します。詳細な手順については、「オフラインダウンロード」をご参照ください。

• 動画ダウンロードはレジュームダウンロードに対応しています。

手順

1. 任意: セキュアダウンロード用の暗号化検証ファイルを設定します。この設定は、セキュアダウンロードの場合にのみ必要で、標準ダウンロードでは不要です。

   説明

   設定した暗号化検証ファイルがアプリ情報と一致していることをご確認ください。一致しない場合、動画ダウンロードに失敗します。

   セキュアダウンロードの場合、動画のダウンロードと再生時に復号検証を行うために、VOD コンソールで生成されたキーファイルをプレーヤー SDK に設定します。キーファイルの生成については、「セキュアダウンロードの有効化」をご参照ください。

   Application で 1 回だけ設定することを推奨します。例：

   PrivateService.initService(getApplicationContext(), "Path to encryptedApp.dat file"); // encryptedApp.dat 検証ファイルをスマートフォンに保存し、ここにローカルファイルパスを設定することを推奨します。

2. ダウンローダーを作成して設定する。

   AliDownloaderFactory を使用してダウンローダーを作成します。例：

   AliMediaDownloader mAliDownloader = null;
   ......
   // ダウンローダーを作成します。
   mAliDownloader = AliDownloaderFactory.create(getApplicationContext());
   // ダウンロードの保存パスを設定します。
   mAliDownloader.setSaveDir("Save folder path");

3. イベントリスナーを設定します。

   ダウンローダーは複数のイベントリスナーを提供します。例：

   展開してコードを表示

   mAliDownloader.setOnPreparedListener(new AliMediaDownloader.OnPreparedListener() {
      @Override
      public void onPrepared(MediaInfo mediaInfo) {
          // ダウンロード項目の準備に成功しました。
      }
   });
   mAliDownloader.setOnProgressListener(new AliMediaDownloader.OnProgressListener() {
      @Override
      public void onDownloadingProgress(int percent) {
          // ダウンロード進捗率。
      }
      @Override
      public void onProcessingProgress(int percent) {
          // 処理の進捗率。
      }
   });
   mAliDownloader.setOnErrorListener(new AliMediaDownloader.OnErrorListener() {
      @Override
      public void onError(ErrorInfo errorInfo) {
          // ダウンロードエラー。
      }
   });
   mAliDownloader.setOnCompletionListener(new AliMediaDownloader.OnCompletionListener() {
      @Override
      public void onCompletion() {
          // ダウンロードに成功しました。
      }
   });

4. ダウンロードソースを準備します。

   ダウンロードソースを prepare メソッドを使用して準備します。ダウンロードソースは VidSts および VidAuth メソッドに対応しています。例:

   • VidSts

     // VidSts を作成します。
     VidSts aliyunVidSts = new VidSts();
     aliyunVidSts.setVid("Vid information"); // 動画 ID (VideoId)。
     aliyunVidSts.setAccessKeyId("<yourAccessKeyId>"); // Security Token Service (STS) の AssumeRole API を呼び出して生成された、一時的な STS AccessKey ペアの AccessKey ID。
     aliyunVidSts.setAccessKeySecret("<yourAccessKeySecret>"); // Security Token Service (STS) の AssumeRole API を呼び出して生成された、一時的な STS AccessKey ペアの AccessKey secret。
     aliyunVidSts.setSecurityToken("<yourSecurityToken>"); // Security Token Service (STS) の AssumeRole API を呼び出して生成された、Security Token Service (STS) トークン。
     aliyunVidSts.setRegion("region"); // Video on Demand (VOD) サービスのリージョン。デフォルト値：cn-shanghai。
     // VOD コンソールで HLS 暗号化パラメーターのパススルーを有効にしていて、デフォルトのパラメーター名が MtsHlsUriToken の場合は、次のように config を設定して vid に渡す必要があります。
     // VOD コンソールで HLS 暗号化パラメーターのパススルーを有効にしていない場合は、次のコードをスキップしてください。
     VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
     vidConfig.setMtsHlsUriToken("<yourMtsHlsUriToken>");
     aliyunVidSts.setPlayerConfig(vidConfig);
             
     
     // ダウンロードソースを準備します。
     mAliDownloader.prepare(aliyunVidSts)

   • VidAuth

     // VidAuth を作成します。
     VidAuth vidAuth = new VidAuth();
     vidAuth.setVid("Vid info");// 動画 ID。
     vidAuth.setPlayAuth("<yourPlayAuth>");// VOD の GetVideoPlayAuth API を呼び出して生成された再生認証情報。
     vidAuth.setRegion("Access region");// プレーヤー SDK バージョン 5.5.5.0 以降では、このパラメーターは非推奨であり、指定は不要です。プレーヤーがリージョンを自動的に解析します。5.5.5.0 より前のバージョンでは、このパラメーターは必須です。VOD のアクセスリージョンのデフォルトは cn-shanghai です。
     // VOD コンソールで HLS 標準暗号化パラメーターのパススルーを有効にしていて、デフォルトのパラメーター名が MtsHlsUriToken の場合は、次のように config を設定して vid に渡します。
     VidPlayerConfigGen vidConfig = new VidPlayerConfigGen();
     vidConfig.setMtsHlsUriToken("<yourMtsHlsUriToken>");
     vidAuth.setPlayerConfig(vidConfig);
     // ダウンロードソースを準備します。
     mAliDownloader.prepare(vidAuth);

   説明

   • ソースファイルのフォーマットはダウンロードしたファイルのフォーマットと一致します。変更はできません。

   • VOD コンソールで HLS 標準暗号化パラメーターのパススルーを有効にしていて、デフォルトのパラメーター名が MtsHlsUriToken の場合は、「HLS 標準暗号化パラメーターのパススルー」をご参照のうえ、上記のとおり VOD ソースに MtsHlsUriToken の値を設定してください。

5. 準備が完了したら、ダウンロード項目を選択してダウンロードを開始します。

   準備が正常に完了すると、OnPreparedListener メソッドが呼び出されます。返された TrackInfo には、ビデオストリームの解像度などの情報が含まれています。ダウンロード用に Track を 1 つ選択します。例：

   public void onPrepared(MediaInfo mediaInfo) {
       // ダウンロード項目の準備に成功しました。
       List<TrackInfo> trackInfos = mediaInfo.getTrackInfos();
       // 例：最初の TrackInfo をダウンロードします。
       mAliDownloader.selectItem(trackInfos.get(0).getIndex());
       // ダウンロードを開始します。
       mAliDownloader.start();
   }

6. (任意) ダウンロードソースの更新

   VidSts と VidAuth の有効期限切れを防ぐために、ダウンロードソース情報を更新してダウンロードを開始できます。例：

   // ダウンロードソースを更新します。
   mAliDownloader.updateSource(aliyunVidSts);
   // ダウンロードを開始します。
   mAliDownloader.start();

7. ダウンロードの成否にかかわらず、ダウンローダーを解放します。

   ダウンロードが成功したら、release メソッドを onCompletion または onError コールバックで呼び出してダウンローダーを解放します。例:

   mAliDownloader.release();

8. 任意： ダウンロードしたファイルを削除します。

   ダウンロード中またはダウンロード後に、ダウンロードしたファイルを削除できます。例：

   // オブジェクトを介してファイルを削除します。
   mAliDownloader.deleteFile();
   // 静的メソッドで削除します。成功した場合は 0 を返します。
   AliDownloaderFactory.deleteFile("ダウンロードフォルダーへのパス", "動画 ID", "動画フォーマット", "ダウンロードされた動画のインデックス");

次のステップ

ダウンロードした動画は ApsaraVideo Player を使用して再生できます。手順：

1. ダウンロード完了後、ビデオファイルの絶対パスを取得します。

   String path = mAliDownloader.getFilePath();

2. VOD UrlSource を使用して、再生用の絶対パスを設定します。

    UrlSource urlSource = new UrlSource();
           urlSource.setUri("Playback address");// ダウンロードした動画の絶対パスを設定します。
           aliPlayer.setDataSource(urlSource);