Android应用迁移至actions.intent.OPEN_APP_FEATURE BII后,Gemini助手无法触发该功能(ADB深链接可正常工作)
Android应用迁移至actions.intent.OPEN_APP_FEATURE BII后,Gemini助手无法触发该功能(ADB深链接可正常工作)
我完全理解你现在的困扰——ADB测试深链接、桌面静态快捷方式都能完美触发功能,但Gemini/Google Assistant要么直接搜网页,要么只打开APP不带参数,就是不执行指定操作。结合你的配置和测试情况,我来逐个解答你的问题,再补充一些实用的排查方向:
1. actions.intent.OPEN_APP_FEATURE 和Gemini助手的兼容性要求
这个BII动作完全兼容Gemini,但Gemini对App Actions的触发有几个容易忽略的细节:
- 依赖Google Play索引:和本地静态快捷方式不同,Gemini触发BII动作需要Google服务器先索引到你的App Actions配置,本地调试包哪怕配置正确也不会被Gemini识别——这也是你必须部署到Play渠道的核心原因。
- 语言模型匹配精度:Gemini的语言理解更贴近口语,你需要确保同义词数组里的短语是意大利用户实际会说的表达,比如可以补充更口语化的表述(比如
"Inizia la lettura delle notifiche"),覆盖不同的用户说法。 - 配置完整性:你的
capability和shortcut绑定要完全对应,目前看你的XML配置里capability-binding的key和parameter-binding的key都是正确的,但要反复确认没有拼写错误。
2. 无测试工具时,部署到Open Testing/Production是否能触发重新索引?传播时间多久?
部署到Play的测试或正式渠道是可以触发Google重新索引你的App Actions的,但要满足几个前提:
- 设备上安装的必须是从Google Play下载的包(本地编译的调试包不会被索引);
- 你的AAB必须正确打包了
shortcuts.xml,并且Manifest里的meta-data引用无误; - 传播时间通常在2-24小时之间,高峰期可能更久。如果超过24小时还没生效,可以尝试手动触发索引:
- 打开Google Assistant设置,找到你的应用,清除它的相关数据;
- 重启设备后,用明确的语音命令(比如
"Hey Google, Avvia lettura su Notifiche TTS")再尝试几次。
3. 意大利语Inline Inventory的已知问题?
目前没有公开的意大利语Inline Inventory官方已知问题,但有几个细节要注意:
- 口语化匹配:比如你数组里的
"Attiva lettura notifiche"是准确的,但可以补充更简洁的口语表达(比如"Leggi le notifiche"),因为用户可能不会说完整的短语; - 语言一致性:确保设备的系统语言和Google Assistant的语言都设置为意大利语,否则助手可能不会优先匹配意大利语的同义词;
- 参数传递验证:你可以在
MainActivity里添加日志代码,打印getIntent().getExtras()或者getIntent().getData(),确认当从Play渠道打开时,参数是否被正确传递——如果参数能通过静态快捷方式传递,说明配置本身没问题,问题大概率在索引或语言理解上。
额外排查点
- 验证快捷方式是否被助手识别:用意大利语说
"Hey Google, Scorciatoie di Notifiche TTS",如果能列出你的“Start reading”和“Stop reading”快捷方式,说明助手已经索引了,但语音命令的表述可能需要调整;如果列不出来,说明索引还没完成或者配置有问题。 - 检查Play Console配置:进入Google Play Console的「App Actions」板块,确认你的
actions.intent.OPEN_APP_FEATURE配置被正确识别(虽然Inline Inventory不需要手动上传Schema,但Play Console会自动解析你的shortcuts.xml)。 - 避免歧义:确保你的应用名称“Notifiche TTS”在Google Play上是唯一的,或者语音命令里明确提到应用名称,避免助手混淆成其他应用或网页搜索。
最后总结
先耐心等待24小时让Google完成索引,同时扩展同义词数组覆盖更多意大利语口语表达,确保设备语言和助手语言都是意大利语,再用明确的语音命令测试。如果还是不行,可以检查Play Console里的App Actions状态,或者尝试添加更多的参数绑定表述来提升匹配精度。




