spatial-swiftui-developer

Spatial SwiftUI Developer

クイックスタート

1. タスクが実際には表示面の選択、シーンの所有権、またはファイル構成に関するものであれば、まず spatial-app-architecture に切り替えます。
2. タスクが Chart3D、SurfacePlot、3D チャートのマーク、または Chart3DPose に関するものであれば、$swiftui-chart3d-developer に切り替えます。
3. レンダリングの方式を選びます。シンプルなアセット表示には Model3D、カスタムのエンティティグラフとアタッチメントには RealityView を使います。
4. 該当する参照ファイルだけを読み込みます。
5. 読み込みは非同期にし、RealityKit の変更は所定のエントリーポイント内で行います。
6. ビルド、起動、シミュレーター、テストの問題は build-run-debug に引き継ぎます。

参照ファイルを読み込むタイミング

参照	使用する場面
swiftui-spatial-overview.md	このスキルの一般的な機能一覧、例、振り分けの指針が必要なとき。
model3d.md	非同期のモデル読み込み、アセット、アニメーション、操作に Model3D を使うとき。
realityview.md	RealityView、アタッチメント、RealityKit 統合のパターンを設定するとき。
interaction.md	空間入力のジェスチャや操作のパターンを実装するとき。
buttons-and-controls.md	表示される SwiftUI ボタン、ボタンとしてスタイル設定されたリンク、ツールバー、フォーム、コントロール面を実装するとき。
swiftui-scene-lifecycle.md	Window、WindowGroup、ImmersiveSpace、開く／閉じる、復元、起動に関する正式な仕様を確認するとき。
windowing-immersion.md	ウィンドウ、ボリューム表示面、またはイマーシブ空間への遷移を管理するとき。
spatial-layout.md	SwiftUI の空間レイアウト API、サイズ指定、デバッグツールを使うとき。

ワークフロー

1. アーキテクチャとシーンの所有権がすでに確定していることを確認します。
2. レンダリング面として Model3D、RealityView、ウィンドウ、ボリューム、イマーシブシーンのいずれかを選びます。
3. 該当する参照ファイルだけを読み込みます。
4. 実現可能な最小限のシーンを実装し、変更は適切なレイヤー内で行います。
5. 選択した SwiftUI と RealityKit の統合方法を要約します。

ガードレール

• 表示されるすべてのボタンに、明示的な .buttonBorderShape(...) を指定します（ラベル付きアクションには .capsule、アイコンのみのボタンには .circle、カード型ボタンには背景に合わせた .roundedRectangle(radius:) を使います。visionOS では、これによってボタンのホバー強調表示の形状も決まります）。ボタン以外のホバー面では、.hoverEffect() と、対応する .contentShape(.hoverEffect, ...) を組み合わせます。コントロールのコードを書く前に buttons-and-controls.md を読み込みます。これは、大きなタスクの一部として付随的にボタンを扱う場合にも適用されます。
• RealityKit の読み込みは非同期にし、アセットやエンティティの読み込みでメインアクターをブロックしないでください。
• RealityKit のコンテンツは、SwiftUI の body コードではなく、RealityView の make または update クロージャ内、あるいはシステム内で変更します。
• Model3D はシンプルな表示とレイアウトが必要な場合にのみ使い、カスタム ECS グラフには使わないでください。
• ImmersiveSpace は、独自のライフサイクルと環境アクションを持つ別個のシーンとして扱います。
• defaultSize は初期値の目安としてのみ使います。システムによってジオメトリが制限されたり、復元されたりする場合があります。
• Chart3D と空間データの可視化には $swiftui-chart3d-developer を使います。
• 起動、ビルド、シミュレーター、codesign、またはデバッグのワークフローに関する質問は build-run-debug に切り替えます。
• API の使い方ではなく、シーンの境界、所有権、または機能の分割に関する質問には spatial-app-architecture を使います。
• visionOS 27 の SwiftUI では、新しいシーン、ボリューム、イマーシブ機能の API は追加されていません。ここでのガイダンスは visionOS 27 に対応しています。27 での新機能として、ジェスチャの inputKinds: フィルタリング（interaction.md を参照）と、visionOS にも適用されるクロスプラットフォームのツールバーおよびナビゲーションの改善があります。

出力に含める内容

以下を提示してください。

• 選択したレンダリング方式とシーンのパス
• 使用した参照資料
• 関連する API の範囲（Model3D、RealityView、ウィンドウ管理、インタラクション、レイアウト）
• 主な実装上の制約または落とし穴
• 必要に応じて、アーキテクチャ、Chart3D、またはビルド／デバッグへの案内