Web向けApsaraVideo Player SDKを使用する場合、よく使用される機能の設定は、プレーヤー、再生方法、またはブラウザ環境によって異なる場合があります。このトピックでは、Web向けApsaraVideo Player SDKの基本機能の設定方法について説明します。
共通設定
Webプレーヤーを使用してFlash Video(FLV)ビデオとHTTPライブストリーミングプロトコル(HLS)ビデオを再生する場合、オリジン間リソース共有 (CORS) を設定する必要があります。詳細については、「CORS を設定する」をご参照ください。
Webプレーヤーを使用するときにCORSを設定しないと、再生中に次のエラーメッセージが返されます。
No 'Access-Control-Allow-Origin' header is present on the requested resource.
全画面再生が開始された後、入力を設定して絶対配置を設定し、ソフトウェアキーボードを有効にすることができます。
メソッドの呼び出し
Web向けApsaraVideo Player SDKの基本機能は、属性またはメソッドを使用して有効になります。
詳細については、「API操作」をご参照ください。
次のサンプルコードは、メソッドの呼び出し方法の例を示しています。
プレーヤーを作成するために使用される関数のコールバックで、次のメソッドを呼び出します。サンプルコード:
var player = new Aliplayer({},function(player) {
// 再生速度を 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 の正の値は時計回りの回転を指定します。Angle の負の値は反時計回りの回転を指定します。たとえば、player.setRotate(180) は時計回りに 180 度の回転を指定します。
player.setRotate(<Angle>)
// 回転角度を取得します。
player.getRotate()ミラーリングモードを指定する
setImage を呼び出して、ミラーリングモードを設定します。サポートされているモード:水平ミラーリングと垂直ミラーリング。サンプルコード:
// 水平ミラーリング。
player.setImage('horizon')
// 垂直ミラーリング。
player.setImage('vertical')Web向けApsaraVideo Player SDKは、ビデオの高さと幅を指定するための videoHeight 属性と videoWidth 属性を提供します。ほとんどの場合、ビデオの高さと幅はコンテナの高さおよび幅よりも小さくなります。これにより、回転およびミラーリング中にビデオが親コンテナからオーバーフローするのを防ぎます。サンプルコード:
width: '100', // コンテナの幅。
height: '100%', // コンテナの高さ。
videoHeight:"200px", // ビデオの高さ。再生情報を取得する
Web向けApsaraVideo Player SDKでは、現在の再生進捗状況と再生時間を取得できます。
再生進捗状況を取得する
getCurrentTime を呼び出して、現在の再生進捗状況を取得します。サンプルコード:
// 返される時間は秒単位です。
player.getCurrentTime()再生時間を取得する
ビデオの合計時間を照会できます。ビデオの時間が読み込まれた後にのみ、ビデオの時間を照会できます。たとえば、再生イベントが発生した後に、ビデオの時間を照会できます。getDuration を呼び出して、ビデオの合計時間を取得します。ビデオが読み込まれた後、または再生イベントが発生した後にのみ、時間を取得できます。サンプルコード:
player.getDuration()再生ステータスを取得する
getStatus を呼び出して、再生ステータスを取得します。戻り値:
初期化
準備完了
読み込み中
再生
一時停止
再生中
待機中
エラー
終了
サンプルコード:
player.getStatus()音量を指定する
音量を調整したり、ビデオをミュートしたりできます。
iOS および特定の Android システムでは、video.volume プロパティは読み取り専用です。そのため、Web向けPlayer SDKによって提供される getVolume メソッドと setVolume メソッドは、iOS および特定の Android システムでは無効です。
音量を調整する
setVolume 操作を呼び出して、音量を調整します。現在の音量を取得することもできます。サンプルコード:
// 音量を 0 から 1 までの実数に設定します。
player.setVolume(0)
// 現在の音量を取得します。
player.getVolume()ミュートモードを設定する
mute メソッドを呼び出して、再生中にビデオをミュートします。サンプルコード:
// ビデオをミュートします。
player.mute();
// ビデオのミュートを解除します。
player.unMute();再生速度を指定する
Web向けApsaraVideo Player SDKのデフォルト ユーザーインターフェース (UI) を使用している場合、組み込みの再生速度機能を使用して、ビデオの視聴中に再生速度を調整できます。カスタムUIを使用している場合は、setSpeed 操作を呼び出して再生速度を調整できます。
再生速度設定を無効にする方法の詳細については、「API 操作」トピックの setSpeed セクションをご参照ください。API 操作
サンプルコード:
// 再生速度を指定します。次のサンプルコードは、再生速度を現在の速度の 2 倍に設定する方法の例を示しています。
player.setSpeed(2)複数解像度再生
複数解像度再生のために、複数の解像度のストリームの URL を設定できます。
VID と PlayAuth を使用して再生する場合、追加の設定は必要ありません。Web向けApsaraVideo Player SDKは、ApsaraVideo VODから解像度リストを取得します。再生ページで [設定] をクリックして、解像度リストを表示できます。
説明VID と PlayAuth を使用して再生する場合、format 属性を指定して、HTML5 プレーヤーで MP4 形式または MP3 形式のメディアファイルを再生するかどうかを決定できます。デフォルトでは、MP4 形式のメディアファイルが再生されます。
URL ベースの再生を使用する場合は、source 属性でキーと値のペアを設定して、複数の解像度のストリームの URL を指定する必要があります。キーと値のペアは JSON 形式です。設定が有効になったら、再生ページで [設定] をクリックして、解像度リストを表示できます。
解像度リストの表示方法を変更する場合は、解像度コンポーネントを使用できます。サンプルコードの詳細については、Functions をご参照ください。
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 プレーヤーのみがサポートしています。
ループ再生を有効にする
Web向けApsaraVideo Player SDKでは、rePlay 属性を指定するか、ended イベントをリッスンしてループ再生を行うことができます。
rePlay 属性を指定するために使用されるサンプルコード
rePlay:trueended イベントをリッスンするために使用されるサンプルコード
player.on('ended',function(){
player.replay()
})モバイルデバイスでのジェスチャー操作
Web向けPlayer SDKは、モバイルデバイスの小さな画面向けに最適化されています。プログレスバーはドラッグしやすくなっています。2つの専用機能が提供されています。長押しで早送り、ダブルクリックで早送りまたは早戻しです。
長押しで早送り
デフォルトでは、モバイルデバイスでは長押しで早送り機能が有効になっています。プログレスバー以外のプレーヤーの任意の領域を0.5秒以上タップアンドホールドすると、ビデオはより速い速度で再生されます。ホールドを解除すると、ビデオは元の速度で再生されます。
longPressFastForward: false パラメーターを設定することで、この機能を無効にすることもできます。詳細については、「API 操作」をご参照ください。
ダブルクリックで早送りまたは早戻し
デフォルトでは、モバイルデバイスではダブルクリックで早送りまたは早戻し機能が有効になっています。プレーヤーの左側の3分の1の領域をダブルクリックすると、ビデオは10秒巻き戻されます。プレーヤーの右側の3分の1の領域をダブルクリックすると、ビデオは10秒早送りされます。
dbClickSkip: false パラメーターを設定することで、この機能を無効にすることもできます。詳細については、「API 操作」をご参照ください。