shareplay-developer

SharePlay 開発者向け

クイックスタート

1. この体験が、起動時のみの同席機能なのか、共有状態の同期なのかを判断します。
2. SharePlay の UI を構築する前に、Group Activities 機能と必要なエンタイトルメントを追加します。
3. 体験ごとに GroupActivity を 1 つ定義し、ペイロードは最小限かつ Codable にします。
4. ワークフローがわかってから、適切なリファレンスを読み込みます。
5. 空間ペルソナやイマーシブスペースを使用する場合は、参加前に spatial-coordination.md を読み込みます。

次の場合にリファレンスを読み込みます

リファレンス	使用するタイミング
activation-ui.md	SharePlay のエントリポイントや開始ボタンのフローを組み込む場合。
activity-definition.md	GroupActivity のペイロード、メタデータ、転送表現を定義する場合。
group-session-lifecycle.md	GroupSession への参加、退出、監視、表示を行う場合。
messaging-journal.md	GroupSessionMessenger、GroupSessionJournal、途中参加者との同期を使用する場合。
shareplay-spatial-api.md	アクティベーション、関連付け、セッションの所有権、空間調整に関する公式の GroupActivities API を確認する場合。
spatial-coordination.md	SystemCoordinator、空間テンプレート、グループのイマーシブスペースの動作を設定する場合。
visionos-immersive-space.md	visionOS のイマーシブスペースで、起動時のみの SharePlay を実装する場合。
groupactivities-patterns.md	GroupActivities の幅広いパターンや、サンプルに基づく例が必要な場合。

ワークフロー

1. アクティビティを定義し、アクティベーションの起点を選択します。
2. 参加する前に、セッションを監視して設定します。
3. 共有状態が必要な場合にのみ、メッセージングまたはジャーナル同期を追加します。
4. 体験でイマーシブスペースを共有する場合は、空間調整を設定します。
5. セッションのライフサイクル、同期モデル、起動時の起点を明確にまとめます。

スキルを切り替えるタイミング

• 問題が SharePlay の動作ではなく、アプリの起動、シミュレーターの状態、ランタイムのデバッグに関する場合は、build-run-debug に切り替えます。
• 問題が機能、エンタイトルメント、プライバシーの制御に関する場合は、signing-entitlements に切り替えます。
• API の設計よりもイベント順序やセッション状態の変化を証明することが重要な場合は、telemetry に切り替えます。

ガードレール

• GroupActivity のデータは小さく、Codable に保ちます。
• UI とローカル状態の準備が整ってから参加します。

出力要件

以下を提示します。

• アクティビティの型とアクティベーションの起点
• 選択したセッションモデルと同期モデル
• 使用したリファレンス
• イマーシブスペースを含む場合は調整モデル
• 問題が実行、署名、テストに関する場合に次に使用するスキル