文档开发者中心
我的
|

App开发

HarmonyOS 6

MultimodalAwareness Kit

MetadataBinding(记忆链接)系统层面如何识别

我们在鸿蒙应用中接入了 @kit.MultimodalAwarenessKit 的 metadataBinding 记忆链接能力,目前 App 侧接口调用成功,但系统相册中看不到任何返回应用或相关内容入口,希望确认是否为系统侧能力、开关、灰度或相册展示策略问题。

现象描述

我们按照官方“记忆链接 MetadataBinding”文档接入后,在 App 启动时注册 operationSubmitMetadata 事件。

真机测试时,在 App 页面截图后,App 可以收到系统回调,并且调用 submitMetadata 成功。日志如下:

[MetadataBindingManager] register success, bundleName: xxxxxx

[MetadataBindingManager] submit metadata success: xxxxx://home

同时我们也验证了 App Linking 可以被系统拉起:

hdc shell aa start \

-A ohos.want.action.viewData \

-U "xxxxx://home" \

-e entity.system.browsable

执行后可以正常拉起应用。

但问题是:截图后进入系统相册查看该截图,没有看到任何返回应用、相关内容、继续浏览、打开 App 等入口或提示。

请帮忙确认以下问题:

  1. 当前系统相册是否已经支持展示 MetadataBinding 提交的记忆链接结果?

  2. 是否需要打开某些系统开关,例如智慧识屏、智能识图、小艺建议、图库智能推荐等?

  3. 该能力是否存在 ROM 版本、图库版本、设备型号、灰度或白名单限制?

  4. submitMetadata 返回成功后,相册是否一定会展示入口?如果不是,展示策略是什么?

  5. 相册中的入口具体会展示在哪里?例如图片预览页、详情页、更多菜单、智慧识屏结果页等。

点赞
收藏
回复
1
分享
举报
浏览279 发布于2026-07-17 07:15浙江
全部评论
最多点赞
最新发布
最早发布
|
推荐答复

从现象看,建议先把“能被 Want 拉起”和“已完成 App Linking 验证”分开排查:

1. MetadataBinding 要求提交的是鸿蒙 App Linking 链接,不是任意可拉起应用的 URI。示例中的 `xxxxx://home` 如果实际为自定义 Scheme,只能证明 Deep Linking/Want 路由正常。请改为已在 AGC 开通 App Linking、完成域名关联,并在 `module.json5` 中配置 `https`、对应 `host` 及 `domainVerify: true` 的 HTTPS 链接。

2. 建议用 `UIAbilityContext.openLink(link, { appLinkingOnly: true })` 验证该链接;同时执行 `hdc shell hidumper -s AppDomainVerifyManager`,确认对应域名的 `domain verify status` 为 `success`。仅用 `aa start` 验证不足以证明 App Linking 域名校验已经完成。

3. 记忆链接能力从 API 18 开始支持,提交的 App Linking 链接不能超过 128 字节。测试时还要使用真机和手动签名的应用,避免把自动签名或域名校验未完成的问题混入结果。

4. `submitMetadata()` 的返回类型是 `void`。调用未抛异常,只能说明链接已交给多模态融合感知服务处理,不等于“图库入口已展示成功”。系统会自行决定适当时机把内容交给调用编码接口的系统应用;公开 API 没有查询系统开关、灰度/白名单、展示位置或强制展示的接口。

5. 官方场景描述是:用户之后再次浏览该截图时,系统提示是否返回应用查看对应内容;并未承诺一定在图片预览页、详情页或更多菜单中固定显示按钮。

建议按以下顺序复测:确认 HTTPS App Linking 域名校验成功 -> 确认链接 UTF-8 长度不超过 128 字节 -> 在业务页收到 `operationSubmitMetadata` 回调后提交该链接 -> 退出应用后重新进入图库浏览刚生成的原始截图。若仍无提示,请携带设备型号、HarmonyOS/图库版本、域名校验结果、实际链接字节数和回调/提交日志在线提单;具体 ROM 展示策略不在应用侧 API 的可查询范围内。

1楼回复于2026-07-17 07:22 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

目录 收起
现象描述
了解社区公约,与您携手共创和谐专业的开发者社区。