すべてのプロダクト
Search
ドキュメントセンター

ApsaraVideo VOD:基本機能

最終更新日:Aug 27, 2026

Web 向け ApsaraVideo Player SDK を使用する場合、主な機能の設定は、プレーヤー、再生方法、またはブラウザー環境によって異なる場合があります。このトピックでは、Web 向け ApsaraVideo Player SDK の基本機能の設定方法について説明します。

Web 向け ApsaraVideo Player SDK を使用する場合、主な機能の設定は、プレーヤー、再生方法、またはブラウザー環境によって異なる場合があります。このトピックでは、Web 向け ApsaraVideo Player SDK の基本機能の設定方法について説明します。

一般的な設定

Web プレーヤーを使用して Flash Video (FLV) 形式の動画や HTTP ライブストリーミング (HLS) 形式の動画を再生する場合、クロスオリジンリソース共有 (CORS) を設定する必要があります。詳細については、「クロスオリジンアクセスの設定」をご参照ください。

  • Web プレーヤーの使用時に CORS を設定しない場合、再生中に次のエラーメッセージが返されます:

    No 'Access-Control-Allow-Origin' header is present on the requested resource.

説明

フルスクリーン再生の開始後に、input を設定して絶対配置を指定し、ソフトキーボードを有効にできます。

メソッドの呼び出し

Web 向け ApsaraVideo Player SDK の基本機能は、属性またはメソッドを使用して有効にします。

説明

詳細については、「Aliplayer API リファレンス」をご参照ください。

次に、メソッドを呼び出すサンプルコードを示します。

プレーヤーを作成する関数のコールバックで、次のメソッドを呼び出します:

var player = new Aliplayer({}, function(player) {
    // player.setSpeed(2) のようにメソッドを呼び出します。
    player.setSpeed(2);
 });

メディア再生の管理

Web 向け ApsaraVideo Player SDK では、指定した時点から動画を再生したり、再生を一時停止したりできます。

指定した時点からの動画再生

seek メソッドを呼び出して、指定した時点からビデオを再生することができます。 サンプルコード:

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

再生の一時停止

pause メソッドを呼び出して再生を一時停止できます。サンプルコード:

player.pause()
説明

大きな再生ボタンを表示するには、このパラメーターを true に設定する必要があります。例: player.pause(true)

プレーヤーの破棄

dispose メソッドを呼び出してプレーヤーを破棄できます。サンプルコード:

player.dispose()

表示モードの指定

説明
  • PC および iOS のブラウザーは表示設定をサポートしています。

  • Android 向けの Chrome と Firefox は表示設定をサポートしています。

  • WeChat やその他ほとんどのブラウザーは、再生に内蔵プレーヤーを使用するため、表示設定はサポートされていません。

回転角度の指定

setRotate 操作を呼び出して、指定した角度で画像を回転させます。また、回転角度を照会することもできます。サンプルコード:

// 回転角度を指定します。Angle に正の値を指定すると時計回り、負の値を指定すると反時計回りに回転します。たとえば、player.setRotate(180) は時計回りに 180 度回転することを意味します。
player.setRotate(<Angle>)
// 回転角度を取得します。
player.getRotate()

ミラーリングモードの指定

setImage を呼び出して、ミラーリングモードを設定します。サポートされているモードは、水平ミラーリングと垂直ミラーリングです。サンプルコード:

// 水平ミラーリング。
player.setImage('horizontal')
// 垂直ミラーリング。
player.setImage('vertical')

ApsaraVideo Player SDK for Web では、videoHeight および videoWidth 属性を使用して、ビデオの高さと幅を指定できます。ほとんどの場合、ビデオの高さと幅はコンテナより小さくなります。これにより、回転およびミラーリング中にビデオが親コンテナからはみ出すのを防ぎます。サンプルコード:

 width: '100%', // コンテナの幅。
 height: '100%', // コンテナの高さ。
 videoHeight: "200px", // 動画の高さ。

再生情報の取得

Web 向け ApsaraVideo Player SDK を使用すると、現在の再生位置と再生時間を取得できます。

再生位置の取得

現在の再生進捗を取得するには、getCurrentTime を呼び出します。サンプルコード:

// 返される時間は秒単位です。
player.getCurrentTime()

総再生時間の取得

ビデオの総再生時間を取得できます。ビデオの再生時間は、ビデオの読み込みが完了した後にのみ取得できます。たとえば、play イベントが発生した後にビデオの再生時間を取得できます。getDuration を呼び出して、ビデオの総再生時間を取得します。再生時間は、ビデオの読み込みが完了した後、または play イベントが発生した後にのみ取得できます。サンプルコード:

player.getDuration()

再生ステータスの取得

getStatusを呼び出して、再生ステータスを取得します。 戻り値:

  • init:初期化中。

  • ready:準備完了。

  • loading:読み込み中。

  • play:再生中。

  • pause:一時停止中。

  • playing:再生中。

  • waiting:バッファリング中。

  • error:エラー発生。

  • 終了:終了。

サンプルコード:

player.getStatus()

音量の指定

音量を調整したり、動画をミュートしたりできます。

説明

iOS および一部の Android システムでは video.volume プロパティが読み取り専用であるため、Web 用 ApsaraVideo Player SDK が提供する getVolume および setVolume メソッドは iOS および一部の Android システムでは機能しません。

音量の調整

setVolume 操作を呼び出して音量を調整します。現在の音量を取得することもできます。サンプルコード:

// 音量を 0 から 1 までの実数に設定します。
player.setVolume(0)
// 現在の音量を取得します。
player.getVolume()

ミュートモードの設定

再生中にビデオをミュートにするには、mute メソッドを呼び出します。サンプルコード:

// 動画をミュートします。
player.mute();
// 動画のミュートを解除します。
player.unMute();

再生速度の指定

ApsaraVideo Player SDK for Web のデフォルトのユーザーインターフェイス (UI) を使用する場合、組み込みの再生速度機能を使用して、ビデオの視聴時に再生速度を調整できます。カスタム UI を使用する場合、setSpeed 操作を呼び出して再生速度を調整できます。

説明

再生速度設定を無効にする方法の詳細については、Aliplayer API リファレンス トピックの setSpeed セクションをご参照ください。

サンプルコード:

// 再生速度を指定します。次のサンプルコードは、再生速度を現在の 2 倍に設定する例です。
player.setSpeed(2)

マルチ解像度再生

マルチ解像度で再生するには、複数の解像度のストリームURL を設定できます。

  • VID と PlayAuth を使用して再生する場合、追加の設定は必要ありません。Web 向け ApsaraVideo Player SDK は、ApsaraVideo VOD から解像度リストを取得します。再生ページの [設定] をクリックして、解像度リストを表示できます。

    説明

    VID と PlayAuth を使用して再生する場合、format 属性を指定して、HTML5 プレーヤーで MP4 または MP3 形式のメディアファイルを再生するかどうかを決定できます。デフォルトでは、MP4 形式のメディアファイルが再生されます。

  • URL ベースの再生を使用する場合、source 属性でキーと値のペアを設定し、複数の解像度のストリームURL を指定する必要があります。キーと値のペアは JSON 形式です。設定後、再生ページの [設定] をクリックして解像度リストを表示できます。

説明

解像度リストの表示方法を変更したい場合は、解像度コンポーネントを使用できます。サンプルコードの詳細については、「機能」をご参照ください。

URL ベースの再生モードでは、source 属性で次のキーと値のペアがサポートされています:

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

次のサンプルコードは、URL ベースの再生モードで解像度を設定する例です:

// 高解像度と超高解像度のURLを設定する例です。
source:'{"HD":"http://******/player/hdexample.mp4","SD":"http://******/player/sdexample.mp4"}'

Web 向け ApsaraVideo Player SDK では、qualitySort 属性を指定して、解像度を昇順または降順で一覧表示することもできます。

  • desc は、最高解像度から最低解像度への降順を指定します。

  • asc は、最低解像度から最高解像度への昇順を指定します。

説明
  • プレーヤーは指定した解像度を保持します。次回動画を再生するときは、前回指定した解像度が使用されます。前回動画を再生したときに解像度を指定しなかった場合は、低解像度で再生されます。

  • 指定された解像度での動画再生に失敗した場合、プレーヤーは自動的に次に低い解像度に切り替えてメッセージを表示します。HTML5 プレーヤーのみが解像度の切り替えをサポートしています。

ループ再生の有効化

ApsaraVideo Player SDK for Web では、ループ再生のために rePlay 属性を指定するか、ended イベントをリッスンできます。

rePlay 属性を指定する場合のサンプルコード

rePlay:true

ended イベントをリッスンする場合のサンプルコード

player.on('ended', function(){
   player.replay()
})

モバイルデバイスでのジェスチャー操作

Web 向け ApsaraVideo Player SDK は、モバイルデバイスの小さな画面に最適化されています。プログレスバーはドラッグしやすくなっています。また、「長押しで倍速再生」と「ダブルクリックで早送り/早戻し」の2つの専用機能が提供されています。

長押しで倍速再生

デフォルトでは、モバイルデバイスで「長押しで倍速再生」機能が有効になっています。プログレスバー以外のプレーヤー領域を 0.5 秒以上長押しすると、動画は速い速度で再生されます。長押しを解除すると、動画の再生速度は元に戻ります。

longPressFastForward: false パラメーターを設定して、この機能を無効にすることもできます。詳細については、「Aliplayer API リファレンス」をご参照ください。

ダブルクリックでの早送り/早戻し

デフォルトでは、モバイルデバイスで「ダブルクリックで早送り/早戻し」機能が有効になっています。プレーヤーの左側 1/3 の領域をダブルクリックすると、動画が 10 秒早戻しされます。プレーヤーの右側 1/3 の領域をダブルクリックすると、動画が 10 秒早送りされます。

dbClickSkip: false パラメーターを設定して、この機能を無効にすることもできます。詳細については、「Aliplayer API リファレンス」をご参照ください。

関連ドキュメント