SuperAPI AI 工具集

shareplay-developer

智能体与模型

查看项目

更新于 10-16 02:16

技能介绍

SharePlay Developer 是一个面向 visionOS 27 的 SharePlay GroupActivities 开发技能,用于构建、集成和排查 SharePlay 的群组活动功能。

用途 该技能围绕 SharePlay 的 GroupActivities 框架展开,帮助开发者处理群组活动的定义、激活、会话管理与同步等开发任务。它适用于需要判断某个体验是仅启动时的共处(launch-only co-location)还是需要共享状态同步的场景。

主要能力 技能覆盖以下方面:GroupActivity 的定义与载荷设计、激活 UI 与入口流程、GroupSession 的加入/离开/观察/呈现、GroupSessionMessenger 与 GroupSessionJournal 的消息与日志同步、迟到加入者的同步、SystemCoordinator 与空间模板配置、群组沉浸式空间行为,以及 visionOS 沉浸式空间的仅启动型 SharePlay 实现。

使用方式 技能采用按需加载参考文档的方式。开发者应先明确工作流,再加载对应参考:

  • 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. 清晰总结会话生命周期、同步模型与启动界面。

适用场景 适用于 visionOS 27 上 SharePlay 群组活动的开发、集成与排查,包括空间角色与沉浸式空间、共享状态同步、迟到加入者同步等场景。

限制与护栏

  • GroupActivity 数据应保持小巧且可 Codable。
  • 仅在 UI 与本地状态就绪后才加入。
  • 当阻塞点在于应用启动、模拟器状态或运行时调试而非 SharePlay 行为时,应切换到 build-run-debug。
  • 当问题涉及能力、权限或隐私门控时,应切换到 signing-entitlements。
  • 当需要证明事件顺序或会话状态变化而非 API 设计时,应切换到 telemetry。

输出预期 应提供:活动类型与激活界面、所选会话与同步模型、所使用的参考文档、涉及沉浸式空间时的协调模型,以及当阻塞点在于执行、签名或测试时应使用的下一个技能。

其他事实(如收费、价格、平台支持范围等)暂未提供。