このトピックでは、Aliplayer がサポートするプロパティ、メソッド、イベントについて説明します。
Aliplayer の使用中に問題が発生した場合は、「Web プレーヤー FAQ」または「再生エラーの自己トラブルシューティング」をご参照ください。
プロパティ
Aliplayer を初期化する際に、複数のプロパティを設定できます。これらのプロパティには、ライセンス権限付与、メディアソース情報、プレーヤー UI 設定、再生動作などが含まれます。
名前 | タイプ | 説明 |
id | String | プレーヤーの外部コンテナの DOM 要素 ID です。 |
source | String | URL ベースの再生を使用する場合、このプロパティでビデオ URL を指定します。 説明
|
vid | String | ApsaraVideo Media Processing サービスのメディア ID です。 |
playauth | String | 再生認証情報です。再生認証情報の取得方法については、「再生認証情報の取得」をご参照ください。 |
customVodServer | String | VOD プロキシ用のカスタムドメインです (バージョン 2.32.0 以降の VidAuth 再生モードでサポート)。専用リクエストプロキシサービスをデプロイする必要があります。デフォルトの VOD ドメイン (*.aliyuncs.com) が到達不能な場合、プレーヤーは自動的にプロキシサービスにフォールバックします。これにより、ISP ハイジャックを回避し、再生の安定性と成功率を向上させます。 |
playConfig | JSON | Vid (VidAuth または VidSts) で再生する際に使用するカスタム設定です。これらは VOD API に渡されます。サポートされているフィールドとパラメーターの説明については、「メディア再生のためのカスタム PlayConfig 設定」をご参照ください。値の例: |
authTimeout | Number | Vid (VidAuth または VidSts) を使用して取得したビデオ再生 URL の有効期間です。単位:秒。デフォルト:7200。 再生が終了する前に再生 URL が期限切れにならないように、この値が実際のビデオの長さを超えていることを確認してください。 |
height | String | プレーヤーの高さです。有効値:
|
width | String | プレーヤーの幅です。有効値:
|
autoSize | Boolean | String | ビデオコンテンツに合わせてプレーヤーのサイズを自動的に調整します。有効値:'height' または 'width'。 例えば、width: '500px' と autoSize: 'height' を設定します。プレーヤーは 500px の固定幅を維持し、ビデオのアスペクト比に基づいて高さを調整します。 または、height: '500px' と autoSize: 'width' を設定します。プレーヤーは 500px の固定高を維持し、ビデオのアスペクト比に基づいて幅を調整します。 注:autoSize: true は autoSize: 'height' と同等です。高さの自動サイジングがデフォルトです。 |
videoWidth | String | ビデオの幅です。詳細については、「表示モードの設定」をご参照ください。 |
videoHeight | String | ビデオの高さです。詳細については、「表示モードの設定」をご参照ください。 |
preload | Boolean | プレーヤーが自動的にロードされます。 |
cover | String | プレーヤーのデフォルトのカバー画像です。有効な画像 URL を入力してください。この設定は、autoplay が false に設定されている場合にのみ有効です。 |
isLive | Boolean | コンテンツがライブ配信であるかどうかを示します。有効にすると、ユーザーはプログレスバーをドラッグできません。デフォルト:false。ライブストリームの場合は true に設定します。 |
autoplay | Boolean | プレーヤーの自動再生を有効にします。モバイルデバイスでは自動再生は失敗します。有効値:
説明 ブラウザの制限により、Web プレーヤー SDK では自動再生が失敗する場合があります。詳細については、「高度な機能」をご参照ください。 |
autoplayPolicy | Object | プレーヤーはミュート自動再生のための適応ポリシーをサポートしています。このプロパティは、 説明
|
rePlay | Boolean | 自動ループ再生を有効にします。 |
useH5Prism | Boolean | HTML5 プレーヤーを使用します。 |
playsinline | Boolean | HTML5 のインライン再生を有効にします。一部の Android ブラウザではサポートされていません。 |
skinRes | Url | スキン画像の URL です。このフィールドの変更は推奨されません。スキンをカスタマイズするには、「プレーヤースキンのカスタマイズ」をご参照ください。 |
skinLayout | Array | Boolean | UI コンポーネントのレイアウトを設定します。このプロパティを省略すると、デフォルトのレイアウトが使用されます。false に設定すると、すべての UI コンポーネントが非表示になります。詳細については、「skinLayout プロパティの設定」をご参照ください。 |
skinLayoutIgnore | Array | 非表示にする UI コンポーネントのリストです。コンポーネント名については、「VOD コンポーネントのパラメーターリファレンス」をご参照ください。設定例: 説明 skinLayoutIgnore は skinLayout よりも優先されます。 |
controlBarVisibility | String | コントロールパネルの実装です。有効値は次のとおりです:
|
showBarTime | Number | コントロールバーが自動的に非表示になるまでの時間 (ミリ秒) です。 |
enableSystemMenu | Boolean | システムの右クリックメニューを有効にします。デフォルト:false。 |
format | String | 再生 URL のフォーマットを指定します。有効値:
デフォルト:空。 |
mediaType | String | 音声またはビデオを返すかどうかを指定します。vid ベースの再生を使用する場合にのみサポートされます。デフォルト:video。有効値:
|
qualitySort | String | ソート順を指定します。Vid + PlayAuth 再生を使用する場合にのみサポートされます。有効値:
デフォルト:asc。 |
definition | String | 表示するビデオ解像度を定義します。複数の解像度はカンマ (,) で区切ります。例:'FD,LD'。これは、指定された vid で利用可能な解像度のサブセットです。有効値:
|
defaultDefinition | String | デフォルトのビデオ解像度を設定します。これは、指定された vid で利用可能な解像度のいずれかでなければなりません。有効値:
|
autoPlayDelay | Number | 再生が開始されるまでの遅延時間です。単位:秒。 |
language | String | 国際化のための言語を設定します。デフォルト:zh-cn。省略した場合、ブラウザの言語が使用されます。有効値:
|
languageTexts | JSON | JSON 形式のカスタム国際化テキストです。キーは language プロパティの値と一致する必要があります。例:{jp:{Play:"Play"}}。キーの完全なリストについては、「JSON 構造」をご参照ください。 |
snapshotWatermark | Object | HTML5 プレーヤーのスクリーンショットのウォーターマークを設定します。 |
useHlsPluginForSafari | Boolean | Safari 11 を除く Safari ブラウザで HLS プラグインを有効にします。有効値:
|
enableStashBufferForFlv | Boolean | HTML5 プレーヤーで FLV の再生キャッシュを有効にします。ライブ配信にのみ適用されます。有効値:
|
stashInitialSizeForFlv | Number | HTML5 プレーヤーでの FLV の初期キャッシュサイズです。ライブ配信にのみ適用されます。デフォルト:32 KB。 値を小さくすると起動速度が向上します。ただし、小さすぎると、短時間で再生がカクつく可能性があります。 |
loadDataTimeout | Number | バッファリングにより、より低い解像度への切り替えをユーザーに促すまでの時間 (秒) です。デフォルト:20。 |
waitingTimeout | Number | 最大バッファリングタイムアウトです。この時間を超えるとエラーメッセージが表示されます。単位:秒。デフォルト:60。 |
diagnosisButtonVisible | Boolean | 診断ボタンを表示します。有効値:
|
disableSeek | Boolean | プログレスバーでのシークを無効にします。有効値:
|
encryptType | Number | Alibaba Cloud ビデオ暗号化 (プライベート暗号化) を有効にします。デフォルト:0。有効値:
説明
|
progressMarkers | Array | プログレスマーカーオブジェクトの配列です。 |
vodRetry | Number | VOD 再生失敗時のリトライ回数です。デフォルト:3。 |
liveRetry | Number | ライブ配信再生失敗時のリトライ回数です。デフォルト:5。 |
hlsFrameChasing | Boolean | HLS ライブ配信のフレーム追跡を有効にします。有効値:
説明 このパラメーターの設定は、2.21.0 より前の Web プレーヤー SDK バージョンでのみサポートされています。バージョン 2.21.0 以降で HLS ライブ配信モードでフレーム同期を有効にするには、 |
chasingFirstParagraph | Number | 最初のフレーム追跡セグメントの持続時間です。単位:秒。デフォルト:20。 説明 このパラメーターは、2.21.0 より前の Web プレーヤー SDK バージョンでのみ設定できます。バージョン 2.21.0 以降で HLS ライブ配信モードでフレーム同期を設定するには、 |
chasingSecondParagraph | Number | 2 番目のフレーム追跡セグメントの持続時間です。単位:秒。デフォルト:40。 説明 このパラメーターの設定は、2.21.0 より前の Web プレーヤー SDK バージョンでのみサポートされています。バージョン 2.21.0 以降で HLS ライブ配信モードでフレーム同期を設定するには、 |
chasingFirstSpeed | Number | 最初のフレーム追跡セグメントの再生速度です。デフォルト:1.1倍。 説明 このパラメーターの設定は、2.21.0 より前の Web プレーヤー SDK バージョンでのみサポートされています。バージョン 2.21.0 以降で HLS ライブ配信モードでフレーム同期を設定するには、 |
chasingSecondSpeed | Number | 2 番目のフレーム追跡セグメントの再生速度です。デフォルト:1.2倍。 説明 このパラメーターの設定は、2.21.0 未満の Web プレーヤー SDK バージョンでのみサポートされています。バージョン 2.21.0 以降で HLS ライブ配信モードでフレーム同期を設定するには、 |
hlsOption.maxLiveSyncPlaybackRate | Number | HLS ライブ配信でのフレーム追跡の再生速度を設定します。デフォルト:1 (フレーム追跡なし)。
説明 このパラメーターは、Web プレーヤー SDK バージョン 2.21.0 以降でのみサポートされています。 |
flvFrameChasing | Boolean | FLV ライブ配信のフレーム追跡を有効にします。有効値:
デフォルト:false。 |
keyShortCuts | Boolean | キーボードショートカットを有効にします。有効値:
デフォルト:false。 説明 矢印キー (左/右) は早送りと巻き戻しを制御します。矢印キー (上/下) は音量を制御します。スペースバーは再生/一時停止を切り替えます。 |
keyFastForwardStep | Number | 早送りと巻き戻しの時間間隔です。単位:秒。デフォルト:10。 |
rtsFallback | Boolean | ブラウザが RTS をサポートしていない場合、または RTS ストリームのプルに失敗した場合、プレーヤーは自動的に FLV または HLS にフォールバックします。低遅延のため FLV を優先します。ブラウザが FLV をサポートしていない場合は、HLS にフォールバックします。 この機能はデフォルトで有効になっています。無効にするには、このパラメーターを false に設定します。 |
rtsFallbackType | String | RTS からフォールバックするプロトコルを指定します。有効値:HLS または FLV。デフォルトでは、プレーヤーは自動的に選択し、低遅延のため FLV を優先します。ブラウザが FLV をサポートしていない場合は、HLS にフォールバックします。 |
rtsFallbackSource | String | プレーヤーのデフォルトのフォールバック戦略を使用することをお勧めします。ただし、フォールバック用に固定のストリーム URL を指定したい場合は、このパラメーターを使用します。 |
traceId | String | 一意のユーザー識別子です。この値をパブリックなイベントトラッキングポイントに渡して、ログレポートを追跡します。デフォルトでは、Web プレーヤー SDK はログレポートを有効にします。traceId を渡すことで、ユーザーを識別するのに役立ちます。省略した場合、Web プレーヤー SDK は UUID を生成し、ブラウザキャッシュに保存します。 説明 Web プレーヤー SDK バージョン 2.10.0 以降でサポートされています。 |
textTracks | Array | 外部 WebVTT 字幕を設定します。例: フィールドの説明:
|
ratio | Number | プレーヤーを固定のアスペクト比でスケーリングするように設定します。例えば、ビデオのアスペクト比が 16:9 の場合、プレーヤーのパラメーターを |
extLanguageTexts | Object | Web プレーヤー SDK には、中国語と英語の UI テキストが組み込まれています。このプロパティを使用して、特定の UI 要素のテキストをカスタマイズします。例えば、HD の表示を高解像度から1080pに変更するには、次のようにします: |
speedLevels | Array | 再生速度リストをカスタマイズします。各オブジェクトにはキー (速度の値) とテキスト (UI ラベル) が含まれます。省略した場合、デフォルトのリストが使用されます。例: |
logo | Array | カスタムロゴ画像を設定します。例: フィールドの説明:
|
license | Object | 再生品質モニタリング (レガシー)、シングルポイントトラブルシューティング、H.265/H.266 ビデオ再生などの付加価値機能を使用するには、まずWeb プレーヤー SDK 付加価値サービス申請フォームを提出してライセンスを取得します。その後、次のようにライセンスを統合します: |
mute | Boolean | ミュート再生を有効にします。ブラウザが自動再生をブロックする場合にミュート自動再生を有効にするには、このパラメーターを設定します。詳細については、「高度な機能」をご参照ください。 |
clickPause | Boolean | ビデオエリアをクリックして再生を一時停止または再開します。
デフォルト:デスクトップでは true、モバイルでは false。インタラクションの競合を避けるため、dbClickSkip と一緒に使用しないでください。 |
disablePip | Boolean | ブラウザのネイティブのピクチャーインピクチャー (PiP) ボタンを非表示にします。 説明
|
env | String | デフォルトでは、プレーヤーのテレメトリデータは中国のデータセンターにアップロードされます。中国以外のデータに関するコンプライアンス要件がある場合は、env: 'SEA' を設定してデータをシンガポールのデータセンターにアップロードします。 |
watchStartTime | Number | 単独で使用して、再生の開始時刻を設定します。 watchEndTime と一緒に使用して、時間範囲再生を有効にします。ユーザーは指定された時間範囲内でのみ再生およびシークができます。 単位:秒 |
watchEndTime | Number | watchStartTime と一緒に使用して、時間範囲再生を有効にします。ユーザーは指定された時間範囲内でのみ再生およびシークができます。 この値が watchStartTime より小さい場合、watchStartTime は無視されます。 単位:秒 |
start | Number | end と一緒に使用して、ビデオからセグメントを抽出します。例えば、元のビデオが 60 秒の長さで、start: 10 と end: 30 を設定した場合、プレーヤーは元のビデオの 10 秒目から始まる 20 秒のビデオを表示します。 |
end | Number | start と一緒に使用して、ビデオからセグメントを抽出します。例えば、元のビデオが 60 秒の長さで、start: 10 と end: 30 を設定した場合、プレーヤーは元のビデオの 10 秒目から始まる 20 秒のビデオを表示します。 |
dbClickFullscreen | Boolean | ダブルクリックで全画面表示を有効にします。デスクトップではデフォルトで有効です。 |
longPressFastForward | Boolean | 長押しによる早送りを有効にします (モバイルのみ)。有効値:
|
dbClickSkip | Boolean | 左側をダブルクリックして巻き戻し、右側をダブルクリックして早送りします (モバイルのみ)。有効値:
インタラクションの競合を避けるため、clickPause と一緒に使用しないでください。 |
enableMockFullscreen | Boolean | CSS ベースの疑似フルスクリーンを有効にします。デフォルトでは、プレーヤーはブラウザの fullscreen API を呼び出します。iOS および一部の Android ブラウザでは、システムプレーヤーが全画面表示を引き継ぎ、UI の問題が発生します。このパラメーターを有効にすると、引き継ぎを回避できます。デフォルト:false。 |
watermark | Object | 動的ウォーターマークを設定します。例: フィールドの説明:
|
memoryPlay | Object | 再生再開を有効にするには、プレーヤー設定に フィールドの説明:
|
menuMode | String | 再生速度、解像度、字幕、音声トラックのコントロールを表示する場所を設定します。有効値:
|
メソッド
これらのメソッドは、ready イベントが発生した後、またはプレーヤー作成時の ready コールバックで呼び出すことができます。例:
// 方法 1:
var player = new Aliplayer({}, function (player) {
player.play();
});
// 方法 2:
var player = new Aliplayer({});
function handleReady(player) {
player.play();
};
player.on('ready', handleReady);Aliplayer インスタンスで利用可能なメソッド:
play()
再生を開始します。
関数定義
() => Playerpause()
再生を一時停止します。
(showPlayButton?: boolean) => Playerパラメーター
名前 | タイプ | 必須 | 説明 |
showPlayButton | Boolean | いいえ | 再生ボタンを表示します。 |
replay()
再生を再開します。
関数定義
() => Playerseek()
指定した時間にジャンプします。
関数定義
(time: number) => Player パラメーター
名前 | タイプ | 必須 | 説明 |
time | number | はい | ジャンプする時間。単位:秒。 |
dispose()
プレーヤーを破棄します。
関数定義
() => voidgetCurrentTime()
現在の再生時間を取得します。単位は秒です。
関数定義
() => numbergetDuration()
ビデオの総再生時間を取得します。単位は秒です。このメソッドは、ビデオがロードされた後、または play イベントの後に呼び出すことができます。
関数定義
() => numbergetVolume()
現在の音量を取得します。0 から 1 の間の実数を返します。iOS および一部の Android デバイスではサポートされていません。
関数定義
() => number | undefinedsetVolume()
音量を設定します。
関数定義
(volume: number) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
volume | number | はい | 0 から 1 の間の実数としての音量。iOS および一部の Android デバイスではサポートされていません。 |
mute()
再生をミュートします。
関数定義
(quiet?: boolean) => Playerパラメーター
名前 | タイプ | 必須 | 説明 |
quiet | boolean | いいえ | 左下隅のミュート/ミュート解除ステータステキストを非表示にします。 |
unMute()
再生のミュートを解除します。
関数定義
(quiet?: boolean) => Playerパラメーター
名前 | タイプ | 必須 | 説明 |
quiet | boolean | いいえ | ミュートを解除したときに左下隅のテキストプロンプトを非表示にするかどうか。 |
getPlayTime()
実際の再生時間 (一時停止時間を除く) を取得します。可変速再生の場合、実際に経過した時間を返します。単位は秒です。
関数定義
() => numberloadByUrl()
別のビデオに切り替えます。MP4、HLS、FLV など、同じフォーマットのビデオ間での切り替えのみをサポートします。異なるフォーマット間で切り替えるには、プレーヤーを破棄して新しいインスタンスを作成する必要があります。
関数定義
(url: string, seconds?: number, autoPlay?: boolean) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
url | string | はい | 切り替えるビデオの URL です。 |
seconds | number | いいえ | 切り替え後の再生開始時刻です。 |
autoPlay | boolean | いいえ | 切り替え後に自動的に再生を開始します。 |
replayByVidAndPlayAuth()
別の VOD ビデオに切り替えます。同じフォーマットのビデオ間での切り替えのみをサポートします。
関数定義
(vid: string, playauth: string) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
vid | string | はい | ビデオ ID です。 |
playauth | string | はい | 再生認証情報です。 |
replayByVidAndAuthInfo()
別の MPS ビデオに切り替えます。同じフォーマットのビデオ間での切り替えのみをサポートします。
関数定義
(vid: string, accId: string, accSecret: string, stsToken: string, authInfo: string, domainRegion: string) => voidパラメーターの詳細については、「MPS 再生」をご参照ください。
replayByMediaAuth()
別のユニバーサルメディアサービスビデオに切り替えます。同じフォーマットのビデオ間での切り替えのみをサポートします。
関数定義
(mediaAuth: string) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
mediaAuth | string | はい | 再生認証情報です。 |
getBuildInComponent()
組み込みの UI コンポーネント (全画面表示ボタンやプログレスバーなど) を取得します。
関数定義
(name: string) => BuildInComponent;パラメーター
名前 | タイプ | 必須 | 説明 |
name | string | はい | 組み込みコンポーネント名 (例:fullScreenButton)。コンポーネント名のリストについては、「skinLayout プロパティの設定」をご参照ください。各コンポーネントは hide および show メソッドをサポートしています。 |
setPlayerSize()
プレーヤーのサイズを設定します。
関数定義
(width: string, height: string) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
width | string | はい | プレーヤーのサイズを設定します。有効値:
|
height | string | はい |
setSpeed()
再生速度を手動で設定します。モバイルデバイス (Android の WeChat など) では機能しない場合があります。速度コントロールはデフォルトで有効になっています。
関数定義
(speed: number) => voidパラメーター
名前 | パラメータータイプ | 必須 | 説明 |
speed | number | はい | 0.5倍から2倍までの再生速度をサポートします。 |
速度コントロールを無効にするには:
速度コントロールを個別に無効にしたりカスタマイズしたりすることはできません。グローバルに無効にする必要があります。
CSS オーバーライドで速度コントロールを無効にするには:
.prism-setting-speed { display: none !important; }
setTraceId()
ログをトラックするための共通のインストルメンテーションを渡します。
関数定義
(traceId: string) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
traceId | string | はい | 一意の識別子です。 |
Web プレーヤー SDK バージョン 2.10.0 以降でサポートされています。
setSanpshotProperties()
スクリーンショットの設定を構成します。
関数定義
(width: number, height: number, rate: number) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
width | number | はい | 幅と高さの単位:ピクセル。スクリーンショットの品質範囲:0–1 (デフォルト:1)。詳細については、「ビデオスクリーンショット」をご参照ください。 |
height | number | はい | |
rate | number | はい |
fullscreenService.requestFullScreen()
全画面表示にします。
関数定義
() => PlayerfullscreenService.cancelFullScreen()
全画面表示を終了します。iOS ではサポートされていません。
関数定義
() => PlayerfullscreenService.getIsFullScreen()
全画面状態を取得します。
関数定義
() => booleangetStatus()
プレーヤーの状態を取得します。文字列を返します。例:
init:初期化中。
ready:準備完了。
loading:ロード中。
play:再生中。
pause:一時停止中。
playing:再生中。
waiting:バッファリング中。
error:エラー。
ended:終了。
関数定義
() => stringliveShiftSerivce.setLiveTimeRange()
ライブ配信の開始時刻と終了時刻を設定します。これを使用してタイムシフトを有効にします。
関数定義
(start: string, end: string) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
start | string | はい | ライブ配信の開始時刻です。 |
end | string | はい | ライブ配信の終了時刻です。 |
例
player.liveShiftSerivce.setLiveTimeRange('2025/03/21 12:43:00', '2025/03/21 23:31:00')setRotate()
プレーヤーの回転角度を設定します。
関数定義
(rotate: number) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
rotate | number | はい | 正の値は時計回りに回転します。負の値は反時計回りに回転します。例:setRotate(90)。詳細については、「表示モードの設定」をご参照ください。 |
getRotate()
プレーヤーの回転角度を取得します。
関数定義
() => number詳細については、「表示モードの設定」をご参照ください。
setImage()
ミラーリングを適用します。
関数定義
(type: string) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
type | string | はい | 有効値:
例:setImage('horizon')。詳細については、「表示モードの設定」をご参照ください。 |
setCover()
カバー画像を設定します。
関数定義
(coverUrl: string) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
coverUrl | string | はい | サムネイル URL です。 |
setProgressMarkers()
プログレスマーカーを設定します。
関数定義
(markers: Array<{ time: number, text: string }>) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
markers | Array<markers> | はい | markers:マーカーオブジェクトの配列 (必須)。 marker.time:マーカーの時間 (必須)。 marker.text:マーカーのテキストラベル (必須)。 詳細については、パラメーター progressMarkers をご参照ください。 |
setPreviewTime()
プレビュー時間を設定します。
関数定義
(time: number) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
time | number | はい | 単位:秒。詳細については、「プレビュー」をご参照ください。 |
getPreviewTime()
プレビュー時間を取得します。
関数定義
() => numberisPreview()
プレビューモードがアクティブかどうかを確認します。
関数定義
() => booleangetCurrentPDT()
HLS ビデオストリームの現在の ProgramDateTime を取得します。
関数定義
() => number | undefinedsetTextTracks()
WebVTT 字幕の配列を設定します。
関数定義
(textTracks: Array<{ kind: string, label: string, src: string, srclang: string }>) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
textTracks | Array<object> | はい | 例: 説明 Web プレーヤー SDK バージョン 2.12.0 以降でサポートされています。 |
setLogo()
カスタムロゴ画像を設定します。
関数定義
(logoList: Array<{ width: number, position: string, origin: string, src: string }>) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
logoList | Array<object> | はい | 例: フィールドの説明については、プロパティ:logo をご参照ください。 |
setWatchTime()
現在のビデオの watchStartTime/watchEndTime を動的に更新します。
関数定義
(start: number, end: number) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
start | string | はい | 開始時刻です。 |
end | string | はい | 終了時刻です。 |
setNextWatchTime()
次のビデオの watchStartTime/watchEndTime を設定します。loadByUrl または replayByVidAndPlayAuth を使用してビデオを切り替える場合で、次のビデオが現在のビデオと異なる時間範囲を持つ場合は、最初に setNextWatchTime を呼び出す必要があります。
関数定義
(start: number, end: number) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
start | string | はい | 開始時刻です。 |
end | string | はい | 終了時刻です。 |
setStartEnd()
現在のビデオの start/end を動的に更新します。
関数定義
(start: number, end: number) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
start | string | はい | 開始時刻です。 |
end | string | はい | 終了時刻です。 |
setNextStartEnd()
次のビデオの start/end を設定します。loadByUrl または replayByVidAndPlayAuth を使用してビデオを切り替える場合で、次のビデオが現在のビデオと異なるセグメント範囲を持つ場合は、最初に setNextStartEnd を呼び出す必要があります。
関数定義
(start: number, end: number) => voidパラメーター
名前 | タイプ | 必須 | 説明 |
start | string | はい | 開始時刻です。 |
end | string | はい | 終了時刻です。 |
takeSnapshot()
スクリーンショットをキャプチャします。返される base64 文字列は、img.src 値として直接使用できます。setSnapshotProperties を使用してスクリーンショットの品質を設定し、snapshotWatermark を使用してウォーターマークを追加できます。
注:スクリーンショット機能は、ビデオタグがハイジャックされる一部のモバイルブラウザ (UC ブラウザや QQ ブラウザなど) では機能しない場合があります。
関数定義
() => { time: number, base64: string, binary: string, error: Error | null }戻り値
名前 | タイプ | 説明 |
time | string | スクリーンショットの時間。 |
base64 | string | Base64 エンコードされたスクリーンショットのコンテンツ。 |
binary | string | スクリーンショットコンテンツのバイナリ文字列表現。 |
error | Error | スクリーンショットエラーの詳細。 |
showControlBar()
コントロールバーを表示します。
関数定義
() => voidhideControlBar()
コントロールバーを非表示にします。
関数定義
() => voidイベント
プレーヤーイベント
名前 | 説明 |
ready | プレーヤー UI のレンダリングが完了したときに発生します。デフォルトの初期化によって上書きされるのを避けるため、このイベントの後に UI 初期化ロジックをトリガーします。 説明 プレーヤーメソッドは、このイベントが発生した後にのみ呼び出すことができます。 |
play | 一時停止から再生が再開されると発生します。 |
pause | 再生が一時停止されると発生します。 |
canplay | 音声またはビデオの再生が開始できるときに発生します。このイベントは複数回発生する可能性があります。HTML5 プレーヤーのみ。 |
playing | 再生中に繰り返し発生します。 |
ended | 現在のビデオの再生が終了すると発生します。 |
liveStreamStop | ライブストリームが停止すると発生します。HLS ライブストリームの場合、5 回のリトライ失敗後に発生します。ストリームが停止したか、再読み込みが必要であることをアプリケーション層に通知します。 説明 HLS ライブストリームが失敗または切断された場合、プレーヤーは自動的に 5 回リトライします。アプリケーション層で追加のリトライロジックを実装しないでください。 |
onM3u8Retry | HLS ライブストリームが中断された後、プレーヤーがリトライするたびに一度発生します。 |
hideBar | コントロールバーが自動的に非表示になると発生します。 |
showBar | コントロールバーは自動的にイベントを表示します。 |
waiting | データをバッファリングしているときに発生します。 |
timeupdate | 再生位置が変更されると発生します。getCurrentTime() を呼び出して現在の再生時間を取得します。 |
snapshoted | スクリーンショットが完了すると発生します。 |
requestFullScreen | 全画面表示になると発生します。 |
cancelFullScreen | 全画面表示を終了すると発生します。iOS では発生しません。 |
error | エラーが発生すると発生します。 |
startSeek | ドラッグ操作の開始時に、ドラッグポイントの作成時間をパラメーターとして返します。 |
completeSeek | ドラッグ操作を完了すると、パラメーターはドラッグポイントのタイムスタンプを示します。 |
resolutionChange | ライブストリームソースの解像度が変更されると発生します。 |
seiFrame | HLS または FLV を介して SEI メッセージを受信すると発生します。 |
rtsFallback | RTS がフォールバックすると発生します。 |
settingSelected | 設定 (再生速度、解像度、字幕など) が選択されると発生します。 説明 オープンソースの速度プラグインはプレーヤーと同期しないため、使用するにはカスタムコードと再コンパイルが必要です。独自のイベントリスナーを定義してください。プレーヤーの |
rtsTraceId | このイベントは、RTS ストリームのプルが成功したときにトリガーされ、サブスクライブして RTS TraceId を取得できます。ログ出力では、 |
autoplay | 自動再生が成功または失敗したときに発生します。コールバックパラメーター |
mutedAutoplay | ミュート自動再生が成功し、 |
videoUnavailable | サポートされていないエンコーディングが原因でビデオ再生が失敗し、ブラックスクリーンが発生した場合に発生します。例えば、H.265 をサポートしていないブラウザで H.265 ビデオを再生すると、音声のみでブラックスクリーンになります。 |
イベントサブスクリプション
プレーヤーインスタンスの on メソッドを使用してイベントをサブスクライブできます。例:
function handleReady() {}; player.on('ready', handleReady); // 一部のイベントは頻繁に発生します。player.one を使用して一度だけリッスンします。 player.one('canplay', () => {});プレーヤーインスタンスの off メソッドを使用してイベントのサブスクライブを解除できます。例:
player.off('ready',handleReady);