Alibaba Cloud Player SDK を使用してビデオを再生する際にエラーが発生した場合、シングルポイントトレース機能を使用して、特定のユーザーまたは再生セッションの異常な再生動作をエンドツーエンドでトレースできます。これにより、根本原因を迅速に診断し、再生エクスペリエンスをより効率的に管理できます。
前提条件
シングルポイントトレース機能を使用する前に、次の条件が満たされていることを確認してください。
-
シングルポイントトレース機能は、Android および iOS 向けはバージョン 5.4.9.2 以降、Web 向けはバージョン 2.16.0 以降の Alibaba Cloud Player SDK でのみ利用できます。SDK のダウンロード。
-
Android、iOS、または Web SDK の有効なライセンス。ライセンスの取得。
-
Alibaba Cloud Player SDK のログレポートが有効になっていることを確認してください。デフォルトでは、この機能は有効になっています。
-
プレーヤーを作成する際に `traceId` パラメーターを渡す必要があります。このパラメーターがないと、シングルポイントトレース機能は利用できません。パラメーターの渡し方の詳細については、「Alibaba Cloud Player SDK for Android の基本機能」、「Alibaba Cloud Player SDK for iOS の基本機能」、および「Web プレーヤー API リファレンス」をご参照ください。
シングルポイントトレース機能は、ネイティブシステムプレーヤー、サードパーティ製プレーヤー、または Android、iOS、Web 以外のプラットフォーム上の Alibaba Cloud Player SDK ではサポートされていません。
制限事項
-
クエリできるのは、直近 10,000 セッションのみです。
-
クエリできるのは、過去 3 日間の再生データのみです。
操作手順
-
Alibaba Cloud VOD コンソールにログインします。
-
左側のナビゲーションウィンドウで、データセンター > 単一点トレース を選択します。
-
再生セッションをクエリします。
-
[traceId の入力] フィールドに、プレーヤー作成時に指定した `traceId` を入力して、特定のユーザーまたはデバイスの再生セッションをクエリします。
-
時間 (過去 3 日以内)、再生タイプ (オンデマンドまたはライブストリーミング)、ステータス (再生完了、再生中、または再生失敗) で再生セッションをフィルタリングします。
-
-
詳細情報 をクリックして、再生セッションの詳細情報を表示します。
再生詳細ページには 3 つのセクションがあります。[基本情報] セクションには、[アプリ名]、[再生時間]、[クライアント IP]、[OS]、[ネットワークタイプ]、[デバイスタイプ]、[SessionId]、[SDK バージョン] などのフィールドが表示されます。[再生情報] セクションには、[初回フレーム時間]、[リバッファリング回数]、[リバッファリング時間]、[ステータス]、[コーデック標準]、[ハードウェアデコーディング]、[終了時の再生進捗]、[解像度]、[フレームレート]、[ビデオビットレート] などのメトリックが表示されます。下部のイベントリストには、[トピック]、[イベント]、[持続時間 (ms)]、[時間]、[詳細] などの列があり、再生イベントが時系列で記録されます。
関連ドキュメント
Alibaba Cloud Player SDK の使用に関する一般的な問題と解決策については、「Player SDK よくある質問」をご参照ください。