ApsaraVideo VOD:高度な機能

ApsaraVideo Player SDK for Flutter は、H.264 および H.265 のハードウェアデコードをサポートしています。また、デフォルトで有効になっている setEnableHardwareDecoder メソッドも提供します。ハードウェアデコードの初期化に失敗した場合、プレーヤーは自動的にソフトウェアデコードに切り替わり、再生が中断されないようにします。以下にコード例を示します。

// ハードウェアデコードを有効にします。この機能はデフォルトで有効になっています。
fAliplayer.setEnableHardwareDecoder(enable);

ApsaraVideo Player SDK for Flutter は、setOnSnapShot メソッドで実装されるスナップショットキャプチャ機能を提供します。

// スナップショットのキャプチャ成功時のリスナー。
fAliplayer.setOnSnapShot((path,playerId) {

});
// スナップショットをキャプチャします。path は画像が保存されるパスを指定します。
fAliplayer.snapshot(path);

プレビュー機能を設定した後、setVidAuth インターフェイスの previewTime メソッドを呼び出してプレビュー時間を設定します。以下にコード例を示します。

// previewTime はプレビュー時間を秒単位で指定します。
// VidAuth ベースの再生
fAliplayer.setVidAuth(
 vid: "リソースの VID を入力してください",
 region: "リソースのリージョンを入力してください",
 playAuth: "リソースの PlayAuth を入力してください",
 previewTime: "プレビュー時間を秒単位で入力してください");

 // VidSts ベースの再生
 fAliplayer.setVidSts(
 vid: "リソースの VID を入力してください",
 region: "リソースのリージョンを入力してください",
 accessKeyId: "リソースの AccessKey ID を入力してください",
 accessKeySecret: "リソースの AccessKey Secret を入力してください",
 securityToken: "リソースのセキュリティトークンを入力してください",
 previewTime: "プレビュー時間を秒単位で入力してください");

ApsaraVideo Player SDK for Flutter の追加の再生設定を構成できます。これらの設定は、prepare() メソッドを呼び出す前に行います。

var configMap = {
 'mStartBufferDuration':_mStartBufferDurationController.text,// 再生開始前のバッファ期間。単位：ミリ秒。
 'mHighBufferDuration':_mHighBufferDurationController.text,// 高バッファ期間。単位：ミリ秒。
 'mMaxBufferDuration':_mMaxBufferDurationController.text,// 最大バッファ期間。単位：ミリ秒。
 'mMaxDelayTime': _mMaxDelayTimeController.text,// ライブストリーミングの最大レイテンシー。単位：ミリ秒。注意：このパラメーターはライブストリーミングでのみ有効です。
 'mNetworkTimeout': _mNetworkTimeoutController.text,// ネットワークタイムアウト期間。単位：ミリ秒。
 'mNetworkRetryCount':_mNetworkRetryCountController.text,// ネットワークタイムアウト後の再試行回数。
 'mMaxProbeSize': _mMaxProbeSizeController.text,// 最大プローブサイズ。
 'mReferrer': _mReferrerController.text,// リファラー。
 'mHttpProxy': _mHttpProxyController.text,// HTTP プロキシ。
 'mEnableSEI': mEnableSEI,// 補足的な拡張情報 (SEI) を有効にするかどうかを指定します。
 'mClearFrameWhenStop': !mShowFrameWhenStop,// 再生停止時にフレームをクリアするかどうかを指定します。
 'mDisableVideo': mDisableVideo,// ビデオを無効にするかどうかを指定します。
 'mDisableAudio': mDisableAudio,// オーディオを無効にするかどうかを指定します。
 'mUserAgent':mUserAgent,// User-Agent。
};
// 設定を適用します。
fAliplayer.setConfig(configMap);

ApsaraVideo Player SDK for Flutter は、再生中にビデオを保存するローカルキャッシュ機能を提供します。これにより、ユーザーがビデオを再再生する際のトラフィックを削減できます。この機能を使用するには、prepare を呼び出す前に、プレーヤーの enableLocalCache を有効にします。以下にコード例を示します。

/**
 * ローカルキャッシュを有効にします。この機能を有効にすると、ビデオはローカルファイルにキャッシュされます。
 *
 * @param enable - ローカルキャッシュ機能のスイッチ。true: ローカルキャッシュを有効にする。false: ローカルキャッシュを無効にする。デフォルト値：false。
 * @param maxBufferMemoryKB - このパラメーターは非推奨であり、v5.4.7.1 以降では効果がありません。
 * @param localCacheDir - キャッシュファイルのディレクトリ。これは絶対パスである必要があります。
 * @param mDocTypeForIOS - iOS デバイス上のサンドボックスディレクトリのタイプ。
 */
FlutterAliplayer.enableLocalCache(bool enable,String maxBufferMemoryKB,String localCacheDir,DocTypeForIOS mDocTypeForIOS);

/**
  * ローカルキャッシュファイルをクリアするための設定。
  *
  * @param expireMin - このパラメーターは非推奨であり、v5.4.7.1 以降では効果がありません。
  * @param maxCapacityMB - 最大キャッシュサイズ。単位：MB。デフォルト値：20 GB。システムがキャッシュをクリアする際、合計キャッシュサイズがこの制限を超えた場合、システムはキャッシュ項目を最終アクセス時間でソートし、合計キャッシュサイズが制限以下になるまで最も古いキャッシュファイルを 1 つずつ削除します。
  * @param freeStorageMB - 最小空きディスク領域。単位：MB。デフォルト値：0。システムがキャッシュをクリアする際、現在の空きディスク領域がこの値より小さい場合、システムは空きディスク領域がこの値以上になるか、すべてのキャッシュファイルがクリアされるまで、ルールに従ってキャッシュファイルを 1 つずつ削除します。
  */
FlutterAliplayer.setCacheFileClearConfig(String expireMin,String maxCapacityMB,String freeStorageMB);

ApsaraVideo Player SDK for Flutter は、オンデマンドビデオをダウンロードしてオフライン再生することをサポートしています。通常ダウンロードとセキュアダウンロードの 2 つのダウンロードモードが利用可能です。

• 通常ダウンロード

  このモードでダウンロードされたビデオは Alibaba Cloud によって暗号化されておらず、サードパーティ製プレーヤーで再生できます。

• セキュアダウンロード

  このモードでダウンロードされたビデオは Alibaba Cloud によって暗号化されており、ApsaraVideo Player SDK を使用してのみ再生できます。