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:trueended イベントをリッスンする場合のサンプルコード
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 リファレンス」をご参照ください。