Web Player SDK 診断ツールを使用した動画再生問題のトラブルシューティング - ApsaraVideo VOD

Web Player SDK には、動画再生の失敗やコマ落ちのトラブルシューティングに利用できる診断ツールが組み込まれています。このツールは、基本的な環境データ、ネットワークステータス、およびリアルタイムの再生イベントログを収集するため、外部ツールなしで原因を特定できます。

前提条件

開始する前に、動画再生ドメインで次の設定を行います。

Referer のホットリンク保護を有効にし、player.alicdn.com を許可リストに追加します。詳細については、「IP アドレスのブラックリスト/許可リストの設定」をご参照ください。

説明
player.alicdn.com は Aliplayer の静的アドレスのため、許可リストに登録する必要があります。

Referer のホットリンク保護設定で、[ブラウザアドレスバーからの直接アクセスを許可] チェックボックスをオフにして、空の Referer を持つ CDN リクエストをブロックします。
Access-Control-Allow-Origin ヘッダーを動画再生ドメインに追加して、クロスオリジンリソース共有 (CORS) を有効にします。詳細については、「クロスオリジンリソース共有の設定」をご参照ください。

診断ツールを開きます。

次のいずれかの方法を使用します。
- 再生エラー画面から: 「URL の取得に失敗しました」などの再生エラーが発生した場合、エラー画面で[診断]をクリックします。ツールが開き、エラーコード (code)、ビデオ ID (vid)、uuid、requestId、および再生タイムスタンプが自動的に入力されます。
- 直接：診断ツールに移動します。
基本情報を確認します。

[診断情報] タブには、ユーザーのセッションから収集された環境データとネットワークデータが表示されます： - 基本情報：オペレーティングシステム (例：Windows NT 10.0) とブラウザ (例：Chrome 90.0.4430.93) - ネットワーク情報：Image CDN のステータス、Script CDN のステータス、ローカル DNS、ISP、およびローカル IP アドレス

再生テストを実行します。

[動画再生] タブで、[タイプ] メニューから再生モードを選択します：HTML5、Alibaba Cloud HTML5、または Alibaba Cloud Flash。
[Source] パラメーター (直接再生 URL) または [Vid] と [playAuth] パラメーターのいずれかを入力し、[再生] をクリックします。

説明
[Source] と [Vid]/[playAuth] の両方が指定されている場合、[Source] が優先されます。

再生イベントログを確認します。再生中、ツールは動画の左側にライブイベントログをオーバーレイ表示します。各エントリには、イベント名とそのタイムスタンプが表示されます。次のイベントがログに記録されます：

イベント	意味
`play`	再生が開始されました
`waiting`	データ待機中
`loadstart`	データのリクエストを開始しました
`progress`	データをリクエストしています
`loadedmetadata`	ソースメタデータがロードされました
`loadeddata`	現在のフレームデータがロードされました
`canplay`	再生を開始できる十分なデータがあります
`canplaythrough`	バッファリングなしで最後まで再生できる十分なデータがあります
`pause`	再生が一時停止しました
`ended`	再生が終了しました