ApsaraVideo VOD:基本機能

Web プレーヤーの基本機能は、プロパティまたは API を通じて実装されます。

API の呼び出しルールは以下のとおりです。

var player = new Aliplayer({},function(player) {
    player.setSpeed(2);
 });

この機能は、指定した時刻にジャンプして再生を開始します。seek API によって実装されます。以下のコードはその例です。

// time は秒単位で指定する時刻です。
player.seek(time)

この機能は、動画の再生を一時停止します。pause API によって実装されます。以下のコードはその例です。

player.pause()

この機能は、プレーヤーインスタンスを破棄します。dispose API によって実装されます。以下のコードはその例です。

player.dispose()

この機能は、動画を指定された角度で回転させます。setRotate API によって実装されます。回転角度を設定した後、現在の回転角度を取得することもできます。以下のコードはその例です。

// 回転角度を設定します。<angle> の値が正の場合は時計回り、負の場合は反時計回りに回転します。例： player.setRotate(180) は動画を時計回りに 180 度回転させます。
player.setRotate(<angle>)
// 回転角度を取得します。
player.getRotate()

この機能は、水平方向および垂直方向のミラー表示をサポートします。setImage API によって実装されます。以下のコードはその例です。

// 水平ミラー
player.setImage('horizon')
// 垂直ミラー
player.setImage('vertical')

また、Web プレーヤーでは、動画の高さと幅を設定するための videoHeight および videoWidth プロパティも提供されています。回転やミラー表示時に動画が親コンテナーからはみ出さないようにするため、通常、これらの値はコンテナーサイズよりも小さく設定します。以下のコードはその例です。

 width: '100%', // コンテナーサイズ
 height: '100%', // コンテナーサイズ
 videoHeight:"200px", // 動画の高さ

この機能は、現在の再生時刻を取得します。getCurrentTime API によって実装されます。以下のコードはその例です。

// この API は秒単位で時刻を返します。
player.getCurrentTime()

この機能は、動画の合計再生時間を取得します。再生時間は、再生イベント後に動画が読み込まれた後でのみ取得可能です。getDuration API によって実装されます。以下のコードはその例です。

player.getDuration()

この機能は、プレーヤーのステータスを監視します。getStatus API によって実装されます。戻り値は以下のとおりです。

• init：初期化済み

• ready：準備完了

• loading：読み込み中

• play：再生

• pause：一時停止

• playing：再生中

• waiting：バッファー待ち

• error：エラー

• ended：終了

以下のコードはその例です。

player.getStatus()

音量の設定には、音量調整とミュートが含まれます。

この機能は、音量レベルを調整します。setVolume API によって実装されます。音量を設定した後、現在の音量情報を取得することもできます。以下のコードはその例です。

// volume の値は 0 ～ 1 の実数です。
player.setVolume(0)
// 音量情報を取得します。
player.getVolume()

この機能は、再生中の動画をミュートします。mute API によって実装されます。以下のコードはその例です。

// 動画をミュート
player.mute();
// ミュートを解除
player.unMute();

Web プレーヤー SDK のデフォルト UI には、再生速度制御機能が含まれています。視聴者はインターフェイスから再生速度を選択できます。カスタム UI を使用する場合は、setSpeed API を使用して再生速度制御機能を実装できます。

例：

// 以下の例では、再生速度を現在の 2 倍に設定します。
player.setSpeed(2)

この機能は、複数の解像度ストリームのアドレスを設定することで、マルチ解像度再生を実現します。

• VID+PlayAuth 方式で再生する場合、追加の設定は不要です。Web プレーヤー SDK が ApsaraVideo VOD サービスから解像度リストを取得します。視聴者は再生インターフェイスのコントロールバーにある [設定] ボタンをクリックして、解像度リストを表示できます。

  説明

  VID+PlayAuth 方式を使用する場合、H5 再生モードでは format プロパティを設定して MP4 または MP3 フォーマットを選択できます。デフォルトのフォーマットは MP4 です。

• source プロパティを設定して URL 再生方式を使用する場合、source プロパティの JSON 構造内に複数の解像度ストリームのアドレスをキーと値のペアとして指定する必要があります。設定後、視聴者は再生インターフェイスのコントロールバーにある [設定] ボタンをクリックして、解像度リストを表示できます。

URL 再生方式を使用する場合、source プロパティの JSON 構造内のキーと値のペアは以下のとおりです。

   "OD": "<オリジナル品質の URL>"
   "FD": "<低解像度の URL>"
   "LD": "<標準解像度の URL>"
   "SD": "<高解像度の URL>"
   "HD": "<超高解像度の URL>"
   "2K": "<2K の URL>"
   "4K": "<4K の URL>"

次のコードは、URL 再生メソッドの定義を設定する方法の例です。

// この例では、超高解像度および高解像度のアドレスを設定しています。
source:'{"HD":"http://******/player/hdexample.mp4","SD":"http://******/player/sdexample.mp4"}'

Web プレーヤーでは、qualitySort プロパティを使用して解像度を昇順または降順に並べ替えることもサポートされています。

• desc: 降順 (大きいものから小さいものへ) にソートします。

• asc: 昇順に並べ替えます（小さい順から大きい順へ）。