ApsaraVideo VOD:基本機能

play メソッドを使用してビデオの再生を開始できます。次のコードに例を示します。

 fAliplayer.play();

seek メソッドを使用して、特定の時間にジャンプして再生できます。これは、プログレスバーのドラッグや特定のポイントからの再生再開などのシナリオで役立ちます。以下のコードは一例です。

// position はミリ秒単位の指定時間です。seekMode の有効値: FlutterAvpdef.ACCURATE (正確なシーク) および FlutterAvpdef.INACCURATE (不正確なシーク)。
fAliplayer.seek(position,seekMode);

pause メソッドを使用してビデオの再生を一時停止できます。次のコードに例を示します。

fAliplayer.pause();

play メソッドを使用してビデオの再生を再開できます。次のコードに例を示します。

fAliplayer.play(); // 再生を再開します。

stop メソッドを使用してビデオの再生を停止できます。次のコードに例を示します。

fAliplayer.stop(); // 再生を停止します。

プレーヤーインスタンスを同期的または非同期的に破棄できます。以下のコードは一例です。

// 同期破棄。stop メソッドは内部で自動的に呼び出されます。
fAliplayer.destroy();
// 非同期破棄。stop メソッドは内部で自動的に呼び出されます。
fAliplayer.releaseAsync();

プレーヤーのステータスの変更をリッスンできます。`onStateChanged` コールバックは、プレーヤーの現在のステータスを提供します。以下のコードは一例です。

fAliplayer.setOnStateChanged((newState, playerId) {
  // newState は再生ステータスです。
  switch (newState) {
    case FlutterAvpdef.AVPStatus_AVPStatusIdle: // アイドル
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusInitialzed: // 初期化完了
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusPrepared: // 準備完了
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusStarted: // 再生中
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusPaused: // 一時停止中
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusStopped: // 停止
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusCompletion: // 再生完了
      break;
    case FlutterAvpdef.AVPStatus_AVPStatusError: // エラー発生
      break;
    default:
  }
});

SDK は、アスペクトフィット、アスペクトフィル、スケールトゥフィルの 3 つのフィルモードをサポートしています。setScalingMode メソッドを使用してフィルモードを設定できます。以下のコードは一例です。

// モードをアスペクトフィットに設定します。動画は歪みなくビュー内に収まるように比例的に縮小されます。
fAliplayer.setScalingMode(ScaleMode.SCALE_ASPECT_FIT);
// モードをアスペクトフィルに設定します。動画は歪みなくビューを埋めるように比例的に拡大されます。
fAliplayer.setScalingMode(ScaleMode.SCALE_ASPECT_FILL);
// モードをスケールトゥフィルに設定します。動画のアスペクト比がビューのアスペクト比と一致しない場合、動画が歪むことがあります。
fAliplayer.setScalingMode(ScaleMode.SCALE_TO_FILL);

setRotateMode メソッドを使用して、指定した角度でビデオを回転させることができます。回転を設定した後、回転角度を取得することもできます。以下のコードは一例です。

// 動画を時計回りに 0 度回転させます。
fAliplayer.setRotateMode(RotateMode.ROTATE_0);
// 動画を時計回りに 90 度回転させます。
fAliplayer.setRotateMode(RotateMode.ROTATE_90);
// 動画を時計回りに 180 度回転させます。
fAliplayer.setRotateMode(RotateMode.ROTATE_180);
// 動画を時計回りに 270 度回転させます。
fAliplayer.setRotateMode(RotateMode.ROTATE_270);
// 回転角度を取得します。
fAliplayer.getRotateMode();

SDK は、水平ミラーリング、垂直ミラーリング、およびミラーリングなしをサポートしています。setMirrorMode メソッドを呼び出して、ミラーモードを設定します。以下のコードは一例です。

// ミラーリングなしに設定します。
fAliplayer.setMirrorMode(MirrorMode.MIRROR_MODE_NONE);
// 水平ミラーリングに設定します。
fAliplayer.setMirrorMode(MirrorMode.MIRROR_MODE_HORIZONTAL);
// 垂直ミラーリングに設定します。
fAliplayer.setMirrorMode(MirrorMode.MIRROR_MODE_VERTICAL);

`onInfo` コールバックから現在の再生時間をミリ秒単位で取得できます。以下のコードは一例です。

fAliplayer.setOnInfo((infoCode,extraValue,extraMsg,playerId){
 if(infoCode==FlutterAvpdef.CURRENTPOSITION){
 // extraValue は現在の再生進行状況です。
}
});

`AVPEventPrepareDone` イベントの後など、ビデオがロードされた後にビデオの総時間を取得できます。以下のコードは一例です。

fAliplayer.getMediaInfo().then((value){
 // 合計動画再生時間を取得します。
 _videoDuration=value['duration'];
});

setVolume メソッドを使用して音量を調整できます。サポートされている値の範囲は 0 から 2 です。音量を 1 より大きい値に設定するとノイズが発生する可能性があるため、推奨されません。音量を設定した後、音量情報を取得することもできます。以下のコードは一例です。

// volume の値は 0 から 2 までの実数です。
fAliPlayer.setVolume(1);
// ボリューム情報を取得します。
fAliPlayer.getVolume();

setMute メソッドを使用して、再生中のビデオをミュートできます。以下のコードは一例です。

fAliplayer.setMute(true); // 再生中の動画をミュートにする

ApsaraVideo Player SDK for Flutter では、ビデオの再生速度を変更できます。setSpeed メソッドを使用して、ビデオを通常の 0.5 倍から 5 倍の速度で再生できます。オーディオのピッチは変わりません。以下のコードは一例です。

// 再生速度を設定します。0.5 倍から 5 倍までの速度がサポートされています。速度は通常、0.5 倍、1 倍、1.5 倍など、0.5 の倍数で設定されます。
fAliplayer.setSpeed(1.0);

ビデオがロードされた後、ビデオの解像度を取得できます。

fAliplayer.setOnPrepared((playerId) {
  fAliplayer.getMediaInfo().then((value){
        AVPMediaInfoinfo info=AVPMediaInfo.fromJson(value);
        info.tracks.forEach((element){
          if(element.trackType==3){
            // 解像度
            String definition=element.trackDefinition;
            // ストリームインデックス
            int index=element.trackIndex;
          }
        });
      });    
});

selectTrack メソッドを使用して解像度を切り替えます。対応する TrackInfo のインデックスを渡します。

fAliplayer.selectTrack(trackIdx);

このコールバックは、解像度の切り替えが成功した後にトリガーされます。

fAliplayer.setOnTrackChanged((value,playerId){
 // コールバックは切り替えが成功したことを示します。切り替えが失敗した場合のメソッドはまだ利用できません。
});

ApsaraVideo Player SDK for Flutter は、ループ再生機能を提供します。setLoop を呼び出してループ再生を有効にします。ビデオの再生が終了すると、自動的に最初から再開されます。以下のコードは一例です。

fAliplayer.setLoop(true); // ループ再生を有効にする

ループ開始コールバックは、onInfo を通じても通知を送信します。以下は一例です。

fAliplayer.setOnInfo((infoCode, extraValue, extraMsg, playerId) {
 if(infoCode == FlutterAvpdef.LOOPINGSTART){
 // ループ再生開始通知
 }
});