用途:基于 Apple GroupActivities 框架构建共享实时体验,通过 FaceTime、Messages、AirDrop 及 visionOS 临近共享同步媒体播放、应用状态或自定义数据。
主要能力:在 Xcode 为 app target 添加 Group Activities 能力(com.apple.developer.group-session,仅限 app target,不支持小组件、扩展或 App Clip);用 GroupStateObserver.isEligibleForGroupSession 判断是否有活跃 FaceTime 通话或 Messages 会话,并可响应式监听变化;定义符合 GroupActivity 且 Codable 的结构,提供 metadata(title、type、fallbackURL),类型包括 .generic、.watchTogether、.listenTogether、.createTogether、.exploreTogether、.learnTogether、.readTogether、.shopTogether、.workoutTogether;在长生命周期对象中监听 sessions(),收到会话后配置 GroupSessionMessenger 并调用 session.join(),观察 $state 与 $activeParticipants,离开或结束会话。
用法:用 GroupSessionMessenger 发送和接收 Codable 消息,单条不超过 256 KB,支持 .all 与 .only(participant),deliveryMode 可选 .reliable(selections、turns 等状态变更)或 .unreliable(光标、笔迹、表情等高频道临时数据)。音视频用 AVPlaybackCoordinator 的 coordinateWithSession(session) 由 AVFoundation 同步播放、暂停、跳转、速率与时间,不要用消息手动同步播放传输状态。从 App 发起可用 prepareForActivation() 与 activate(),无活跃会话时用 GroupActivitySharingController。较大且非时效性附件用 GroupSessionJournal(需 Transferable,限 100 MB,iOS/iPadOS/tvOS 17+、macOS 14+、visionOS 1+)。
限制与注意:确保调用 join() 与 leave(),避免会话泄漏;处理迟到加入者,向其发送完整状态;不要用 messenger 传输大体积或受保护资源;不要在会被重建的视图中监听 sessions();会话失效时清理 messenger、journal 与任务。技能提供常见错误与审查清单,以及扩展模式参考文件。具体平台与版本要求以资料所述为准。