arkit-visionos-developer

ARKit visionOS 開発者向け

クイックスタート

1. タスクで特定のプロバイダーファミリーが指定されている場合は、以下の対応するプロバイダー特化型スキルに切り替えます。
2. タスクが複数のプロバイダーファミリーにまたがる場合は、まずプロバイダーインデックスと共通のセッションおよびアンカーのリファレンスを読み込みます。
3. 実際に使用するプロバイダーに必要な使用説明文字列、エンタイトルメント、認証のみを追加します。
4. アンカーの状態はモデルレイヤーで管理し、描画先がある場合にのみ RealityKit にブリッジします。
5. 問題がアプリの起動、テストフロー、シミュレーターの動作、または署名に関する場合は、build-run-debug または signing-entitlements に切り替えます。

プロバイダー特化型スキル

スキル	使用する場面
$arkit-spatial-tracking-providers	ワールドトラッキング、平面検出、シーン再構築、ルームトラッキング、または共有座標空間の場合。
$arkit-hand-tracking-provider	ハンドアンカー、関節の変換、カスタムハンドジェスチャー、または手の可視化の場合。
$arkit-reference-tracking-providers	既知の画像のトラッキング、オブジェクトトラッキング、バーコード検出、またはアクセサリのトラッキングの場合。
$arkit-camera-access-providers	カメラフレームストリーム、または領域単位のカメラコンテンツの場合。
$arkit-rendering-context-providers	環境ライティング、ステレオプロパティ、デバイスへの適合、または中心窩視野の調整の場合。

共通リファレンスを読み込む場面

リファレンス	使用する場面
references/provider-index.md	プロバイダーの一覧と選択ガイダンスが必要な場合。
references/session-basics.md	ARKitSession、認証、または共通のライフサイクルルールを設定する場合。
references/anchor-processing.md	anchorUpdates、ID、モデルレイヤーの状態を調整する場合。
references/realitykit-bridge.md	ARKit のデータを RealityKit の可視シーンコンテンツにする場合。

ワークフロー

1. プロバイダーファミリーまたは特化型スキルを選択します。
2. まず共通のセッションとライフサイクルのガイダンスを読み込みます。
3. タスクに合ったプロバイダーのリファレンスのみを追加します。
4. アンカーの調整はモデルレイヤーで行います。
5. モデルレイヤーの状態が安定してから RealityKit にブリッジします。

ガードレール

• エクスペリエンスの全期間にわたって、ARKitSession への強参照を保持します。
• 認証を必要とするプロバイダーを実行する前に、認証を要求します。
• プロバイダーの更新を待つ間、メインアクターをブロックしないでください。
• すべてのプロバイダーで、表示、プライバシー、エンタイトルメント、またはプロビジョニングの要件が同じだと想定しないでください。
• 起動、ビルド、シミュレーター、codesign の問題は、実行スキルに引き継してください。このスキルにランループの詳細を追加しないでください。

出力に含める内容

以下を提示します。

• 選択したプロバイダー特化型スキルまたはプロバイダーのセット
• 使用した共通リファレンスとプロバイダーリファレンス
• セッションとアンカー処理のモデル
• 該当する場合は、RealityKit にブリッジする計画
• 問題が実行、署名、またはシーン作業に関する場合に次に使用するスキル