ApsaraVideo Player を使用してビデオを再生するときにエラーが発生した場合、シングルポイントトレーシング機能を使用してエラーの原因を特定します。 この機能を使用すると、セッションレベルおよびユーザーレベルで再生の詳細をクエリでき、すべてのリンクで再生の例外をトレースすることで再生管理の効率が向上します。
前提条件
シングルポイントトレーシング機能を使用する前に、次の条件が満たされていることを確認してください。
Android または iOS V5.4.9.2 以後の ApsaraVideo Player SDK、または Web V2.16.0 以後の ApsaraVideo Player SDK が統合されている。 最新バージョンをダウンロードするには、「ApsaraVideo Player SDK のダウンロード」をご参照ください。
Android、iOS、または Web 用の Player SDK を使用する場合は、有効なライセンスを取得している。 詳細については、「ライセンスの管理」をご参照ください。
ログレポートが有効になっている。 デフォルトでは、この機能は ApsaraVideo Player SDK で有効になっています。
プレーヤーの作成時に traceId パラメーターが渡されている。 traceId パラメーターはユーザー識別に使用されます。 traceId パラメーターを渡さないと、シングルポイントトレーシング機能を使用できません。 パラメーターのパススルー方式の詳細については、「Android 向け ApsaraVideo Player SDK の基本機能」、「iOS 向け ApsaraVideo Player SDK の基本機能」、および「Aliplayer API の説明」をご参照ください。
システムプレーヤー、サードパーティ製プレーヤー、および Android、iOS、または Web クライアント上にない ApsaraVideo Player は、シングルポイントトレーシング機能をサポートしていません。
制限事項
最新の 10,000 セッションのみをクエリできます。 それ以前のセッションは表示されません。
過去 3 日間に生成された再生データのみをクエリできます。
手順
ApsaraVideo VOD コンソール にログインします。
左側のナビゲーションウィンドウで、[データセンター] > [シングルポイントトレーシング] を選択します。
再生セッションをクエリします。
[traceId を入力] フィールドに、プレーヤーの作成時に渡した traceId を入力します。 これにより、特定のユーザーまたはデバイスの再生セッションをクエリできます。
過去 3 日間に作成された再生セッションをクエリし、時間範囲、ファイルタイプ（オンデマンドオーディオおよびビデオファイルまたはライブストリーム）、ステータス（再生完了、再生中、または再生失敗）などの条件を指定して再生セッションをフィルタリングできます。
[詳細の表示] をクリックして、再生セッションの詳細を表示します。
参照資料
ApsaraVideo Player SDK に関するよくある質問とその解決策については、「ApsaraVideo Player SDK についての FAQ」をご参照ください。