build-app

Engine アプリケーションの構築

package.json とエントリーポイントを読み、ライフサイクルを管理するサーフェスを維持し、そのリファレンスだけを読んでください：direct Engine、React、または Web Components。依存関係ではなく、インポートとマークアップに基づいて選択してください。

初期化

• 入力はオプトインです。new Application(canvas, { ... }) に渡さない限り、app.keyboard、mouse、touch、gamepads、elementInput は null のままです。UI ボタンには new ElementInput(canvas) が必要です。
• Engine はウィンドウのリサイズリスナーを追加しません。独自のハンドラーから app.resizeCanvas() を呼び出してください。
• graphicsDevice.maxPixelRatio のデフォルト値は 1 です。ターゲットがフレーム予算内に収まる場合に限り、最大でも window.devicePixelRatio まで引き上げて、app.resizeCanvas() を呼び出し、canvas.width / canvas.clientWidth で確認してください。
• Ammo が WasmModule 経由で読み込まれるまで、剛体は動作しません。find-examples で physics/falling-shapes の例からローダーをコピーしてください。
• devtools のデフォルトは true なので、デバッグツールからアプリを検出できます（inspect-runtime）。本番ビルドで非表示にする場合に限り、false に設定してください。

更新ループ

• dt はすでに app.maxDeltaTime（0.1 s）でクランプされています。手動でクランプするのではなく、値を調整してください。 app.timeScale でスケーリングでき、0 にするとスケーリングされた時間が一時停止します。
• アプリの状態を明示し、一か所で管理してください。時間に依存するロジックは dt に基づいて進め、開始時と同じセットアップを使ってリセットしてください。

UI

• UI はアプリの状態から描画し、真の情報源を DOM や UI 要素に保持しないでください。
• DOM または React のオーバーレイを使用するか、user-interface の例を応用した Engine の screen および element コンポーネントを使用してください。
• 使用しない要素は enabled = false で非表示にしてください。opacity が 0 の要素も描画されます。

所有権

• アプリの作成、アセット、エンティティ、更新コールバック、ティアダウンは、一つの所有者で管理してください。
• サーフェスの宣言的プリミティブを優先してください。エンティティ単位およびフレーム単位の動作は Engine の Script に記述してください。
• 外部イベントとリソースは、それらを作成したライフサイクル内で削除してください。