threejs-xr

WebXR

プロジェクトにインストール済みのバージョンと既存のアーキテクチャを使用してください。これらの指示はユーザーのタスクを補足するものであり、無関係な変更や外部への操作を許可するものではありません。

要求されている VR／AR モード、対象のハードウェア／ブラウザー、セキュアコンテキスト、現在インストールされている XR API を確認してください。セッションのサポートを機能検出し、ユーザーの操作をきっかけにセッションをリクエストしてください。必須のセッション機能と任意のセッション機能を区別し、任意の機能によってセッション開始が不必要に妨げられないようにしてください。

XR 対応のレンダラーループに、セッションのフレームとポーズを管理させてください。XR カメラ／参照空間を使用し、通常のオービットコントロールでそのポーズを上書きしないでください。メートル単位、ワールド原点、床面の前提を明確にし、参照空間のリセットに対応してください。

ターゲットレイ入力とグリップ／コントローラーモデルを分けてください。必要に応じて、セレクト、スクイーズ、利き手、切断、ハンドトラッキングの動作を定義してください。AR のヒットテストでは、ヒットがない場合に対応し、コンテンツを継続的にテレポートするのではなく、意図的な配置確定の操作を選んでください。

開始、終了、非対応、拒否、中断の状態を用意してください。セッション終了時にはデスクトップのコントロールとシーンの状態を復元してください。アセットやシャドウ／エフェクトのコストを、ヘッドセットのフレーム要件の範囲内に抑えてください。快適さ、テキストの読みやすさ、移動方法をテストしてください。

セッション所有のリスナーと一時リソースを解放してください。実際に要求されたハードウェアで、トラッキング、入力、配置、快適さをテストしてください。エミュレーションで操作フローは確認できますが、ヘッドセットでの使いやすさを証明するものではありません。製品に適している場合は、通常のブラウザービューも利用できるようにしてください。

API リファレンス

正確なシグネチャとリビジョンごとの動作については、公式ドキュメントを参照してください。ドキュメントにアクセスできない場合は、インストール済みの型やソースを調べ、残る不確実性を明記してください。