用途:把应用与 iOS 系统视觉智能能力打通,让用户将相机对准实物或用截图后,系统识别内容并在系统界面中展示应用内匹配结果。适用场景包括相机搜索、视觉搜索集成、将应用内容暴露到系统搜索,以及处理视觉智能查询。
主要能力:实现 IntentValueQuery 接收搜索请求(输入为 SemanticContentDescriptor,含分类标签 labels 与可选原始图像 pixelBuffer);用 AppEntity 定义可搜索内容与显示表示;通过 DisplayRepresentation 控制结果卡片标题、副标题和缩略图;用 @UnionValue 支持多种结果类型,每种实体需各自的 OpenIntent;用 appLinkURL 做深度链接;用 VisualIntelligenceSearchIntent 或 .visualIntelligence.semanticContentSearch 的 schema 形式提供“更多结果”入口。
使用方式:导入 VisualIntelligence 与 AppIntents;为内容建立 AppEntity;实现 IntentValueQuery,按 labels 或 pixelBuffer 搜索并返回结果;为每个实体写 DisplayRepresentation;在 perform() 内只做导航,重类型数据等视图出现后再加载。
限制与注意事项:一个应用只能有一个接受 SemanticContentDescriptor 的 IntentValueQuery,所有结果类型须经由该查询;多结果时结果卡片为两列布局,缩略图应使用小图而非全分辨率,单结果则整宽显示;无匹配或缺少 pixelBuffer 时返回空数组,不要用弱匹配填充;结果需快速返回并排序,可设距离阈值与数量上限。Mac 输入的像素缓冲可能明显大于 iPhone,需考虑是否缩放。
其他:Visual Intelligence 可在 iOS、iPadOS、macOS 运行,同一套实体、查询和 OpenIntent 代码通用;iPad/Mac 以数字媒体截图为入口。应用也可通过 EventKit、Contacts、HealthKit 读取系统创建的数据,需观察变更通知。正式资料未提供具体收费与价格信息。