SuperAPI AI 工具集

relevancekit

通用与其它

查看项目

更新于 10-16 09:57

技能介绍

用途:RelevanceKit 用于向系统提供设备端情境线索,让 Apple Watch 智能叠放在合适时机展示合适的小组件。目标为 Swift 6.3 / watchOS 26+,属测试敏感内容,涉及 API 可用性时应重新核对 Apple 文档。

两种机制:其一,在 AppIntentTimelineProvider 上实现 relevance(),把 RelevantContext 线索附加到时间线条目,跨平台可用但仅 watchOS 生效;其二,用 RelevanceConfiguration 配合 RelevanceEntriesProvider 构建完全由线索驱动的小组件,系统按每个相关条目生成独立智能叠放卡片,仅 watchOS 26+。小组件始终有数据、线索只作补充时选时间线提供器;仅条件匹配才出现或多卡片同时出现时选相关小组件。

线索类型:时间(单日期、带 DateKind 的日期、日期范围)、位置(推断的 home/work/school/commute、CLCircularRegion 区域、按兴趣点类别)、健身(活动圆环未完成、锻炼进行中)、睡眠(就寝、起床)、硬件(耳机已连接)。可在 WidgetRelevance 数组中返回多个属性以组合信号,顺序即优先级,系统可能只取子集。

权限:位置、健身、睡眠线索需在主 App 与小组件扩展两个目标中都授予权限,仅在 App 授权会被静默忽略;硬件与日期无需权限。可在主 App 与扩展中请求。location(category:) 返回可选值,类别不支持时为 nil。

集成与限制:RelevanceConfiguration 可配 associatedKind(_:),避免与时间线小组件重复卡片;WidgetRelevanceGroup 控制分组(ungrouped、named、automatic)。时间线提供器路径应调用 RelevantIntentManager.updateRelevantIntents,在数据变化时更新,而非只在时间线刷新时。RelevanceEntriesProvider 必须实现 relevance、entry、placeholder,并在 context.isPreview 时返回预览数据。测试可开启手表开发者模式中的 WidgetKit 开发者模式。缺失信息:安装命令、收费与平台支持情况暂未提供。