threejs-debug-profiler

Three.js デバッグプロファイラー

プレイ可能な状態を損なわずに、根本原因を特定し、測定されたボトルネックを最適化します。

変更された挙動の範囲に沿って対応してください。リード担当者がすでに用意した再現手順と証拠を再利用し、修正後に影響を受けた経路を検証してください。対象を絞ったチェックに合格していれば、共有される挙動が変更された場合や、未解決のリスクにより必要となる場合を除き、より広範なテストは不要です。統合検証のため、測定結果と不具合をリード担当者に共有してください。

リファレンス

references/debug-playbook.md — 真っ白なキャンバス、アセットと音声の読み込み、ループ／アニメーション／物理演算、入力とモバイル、プロファイリングの手順、__THREE_GAME_DIAGNOSTICS__ の形式に関する、順序立てたトリアージ手順です。すぐに原因がわからない問題のデバッグやプロファイリングを行うときは、これを読んでください。

デバッグ

まず、ユーザーが使っていたものと同じコマンドと URL で再現し、コンソール、ページ、ネットワークのエラーを確認してください。障害の原因となっているモジュール（レンダラー、ループ、カメラ、シーン、アセット、音声、入力、物理演算、UI、またはベースパス）を特定し、その箇所で根本原因を修正して、問題が発生した経路を正確に再テストしてください。プレイブックのトリアージ順序では、アクティブなループが複数ある、キャンバスの表示サイズと描画バッファのサイズが一致しない、delta の単位が誤っているなど、よくある原因を扱っています。

プロファイリング

ユーザーに見えるパフォーマンスが重要な場合は、本番プレビューをプロファイリングしてください。固定したシナリオでベースラインを測定し、ボトルネック（CPU、GPU 描画、フラグメント、頂点、メモリ、またはネットワーク）を分類します。変更は一度に1つだけ行い、同じシナリオを再測定して、見た目とプレイ可能性が保たれていることを確認してください。プレイブックには、ベースラインとして測定すべき指標と、効果の高い順に並べた最適化が記載されています。

レポート

根本原因または測定されたボトルネックを最初に報告してください。続いて、変更したファイル、変更前後の指標、コマンド、スクリーンショット、再テストした障害経路、残るリスクを記載してください。