SuperAPI AI 工具集

shareplay-activities

通用与其它

查看项目

更新于 10-16 05:52

技能介绍

用途:指导在 Apple 平台使用 GroupActivities 与 SharePlay 构建可经 FaceTime、Messages、AirDrop 或 visionOS 附近参与共享的实时体验。

主要能力:SharePlay 负责邀请、激活、会话生命周期、参与者、消息、日志与媒体协调移交。按数据类型选择传输方式:小体积共享状态/动作使用 GroupSessionMessenger 的 .reliable(Codable 消息,小于 256 KB);高频临时采样用 .unreliable,但不可用于权威回合或选择;非时效附件用 GroupSessionJournal(Transferable,支持迟到加入者,最大 100 MB);更大或受保护资源走应用或服务器传输,仅经 SharePlay 共享标识符或清单;AV 播放状态交给 AVPlaybackCoordinator,避免重复发送播放、暂停、跳转消息。

使用方式:仅给应用目标添加 Group Activities 能力(com.apple.developer.group-session),不要加到小组件、扩展或 App Clip。定义小型、Codable 的 GroupActivity,保留标识符、URL 与简短发现状态,并使用匹配的 metadata 类型。在一个长期存活的管理器中持有 Activity.sessions() 监听,session.join() 前配置观察者与传输,然后订阅状态与活跃参与者并加入。在 .invalidated 时取消子任务并释放资源。leave() 仅本地退出,end() 对所有人终止。跟踪参与者差异并向迟到者发送权威当前状态快照。激活时用 GroupStateObserver.isEligibleForGroupSession 判断资格;会话活跃时调用 prepareForActivation() 处理 .activationPreferred、.activationDisabled 与 .cancelled;无会话时用 GroupActivitySharingController 让用户选择参与者。自定义控件使用 shareplay SF Symbol。Journal 需要 iOS/iPadOS/tvOS 17+、macOS 14+ 或 visionOS 1+。

限制与常见错误:会话监听不要放在 SwiftUI 视图体内或导航中会重建的对象里;收到会话却不 join();失效后未清理子任务;只广播增量而不为迟到者引导状态;通过 messenger 发送大附件;对权威状态变更使用 .unreliable;附加 AVPlaybackCoordinator 后仍手动同步传输;只展示 FaceTime 活跃路径而遗漏参与者选择。Game Center 认证与匹配应交给 gamekit,桌面座位与权威棋盘状态交给 tabletopkit,播放 UI 交给 avkit。具体价格与平台版本等资料未提供。