ApsaraVideo Player ソフトウェア開発キット (SDK) の使用中に再生エラーが発生した場合、シングルポイントトレーシング機能を利用できます。この機能は、特定のユーザーまたはセッションからの異常な再生に対してエンドツーエンドのトレーシングを提供します。これにより、問題を迅速に診断し、再生エクスペリエンスをより効率的に管理できます。
前提条件
シングルポイントトレーシング機能を使用する前に、次の条件が満たされていることを確認してください。
シングルポイントトレーシング機能は、ApsaraVideo Player SDK for Android または iOS V5.4.9.2 以降、および ApsaraVideo Player SDK for Web V2.16.0 以降でのみ利用可能です。ApsaraVideo Player SDK のダウンロード。
ApsaraVideo Player SDK for Android、iOS、および Web には、有効なライセンスが必要です。詳細については、「ライセンスの取得」をご参照ください。
ApsaraVideo Player SDK のイベントトラッキングログのレポート機能が有効になっている必要があります。この機能はデフォルトで有効になっています。
プレーヤーを作成する際に、ユーザー識別のための `traceId` パラメーターを渡す必要があります。渡さない場合、シングルポイントトレーシング機能は利用できません。パラメーターの渡し方の詳細については、「ApsaraVideo Player SDK for Android の基本機能」、「ApsaraVideo Player SDK for iOS の基本機能」、および「Web プレーヤー API リファレンス」をご参照ください。
シングルポイントトレーシング機能は、システムプレーヤー、サードパーティ製 (Alibaba Cloud 以外) のプレーヤー、または Android、iOS、Web 以外の ApsaraVideo Player クライアントではサポートされていません。
制限事項
直近 10,000 セッションのみクエリできます。それより前のセッションはコンソールに表示されません。
過去 3 日間の再生データのみクエリできます。
操作手順
ApsaraVideo VOD コンソールにログインします。
左側のナビゲーションウィンドウで、データセンター を選択し、単一点トレース をクリックします。
再生セッションレコードをクエリします。
[顧客追跡番号を入力] ボックスに、プレーヤー作成時に渡した `traceId` を入力します。これにより、特定のユーザーまたはデバイスの再生セッションを完全一致クエリで検索できます。
時間 (過去 3 日以内)、再生タイプ (ビデオオンデマンドまたはライブストリーミング)、およびステータス (完了、再生中、または異常) で再生セッションをフィルタリングします。
詳細情報 をクリックして、再生セッションの詳細を表示します。
参考
ApsaraVideo Player SDK の一般的な問題とその解決方法の詳細については、「ApsaraVideo Player SDK のよくある質問」をご参照ください。