shareplay-developer

SharePlay 开发

快速入门

1. 确定此体验是仅启动时协同，还是需要共享状态同步。
2. 在构建 SharePlay UI 之前，添加 Group Activities 功能并配置所需的权利。
3. 为每种体验定义一个 GroupActivity，并确保其载荷精简且符合 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 和本地状态准备就绪后加入。

输出要求

提供：

• 活动类型和激活入口
• 选用的会话和同步模型
• 使用了哪些参考资料
• 如果涉及沉浸式空间，则说明协调模型
• 如果阻碍涉及执行、签名或测试，则说明下一步应使用的技能