SuperAPI AI 工具集

voice-invocations

智能体与模型

查看项目

更新于 11-08 17:06

技能介绍

Voice Invocations(语音调用,Android)用于让 Meta AI 在佩戴者说出“Hey Meta, start {应用名}”时启动应用或将其切换到前台。资料说明它属于 Wearables 级别的流,而不是 DeviceSession 能力,因此不要求存在运行中的设备会话。

主要能力与配置方面,开发者需要在 Wearables Developer Center 注册包名、申请 Voice Invocation 审批,并配置语音用的应用名称;不应在 manifest 中声明调用短语。该功能不要求相机或麦克风权限。

使用方式上,需要在冷启动和热启动两个入口都调用 SDK 提供的校验器,而不是自行检查 intent extras。示例中在 onCreate 与 onNewIntent 中判断 isVoiceInvocationsIntent(intent),若成立则进入应用体验。之后通过 Wearables.startVoiceInvocationsStream(AutoDeviceSelector()) 创建应用级流,工厂会自动启动,没有单独的公开 start 调用;应用应只保存一个应用级流,并在协程中收集 stream.invocations,对 LaunchApp 调用执行界面跳转,并以 invocation.responseHandle.sendSuccess 或 sendFailure 回应。每个送达的调用都必须恰好回应一次,二者均为挂起函数并返回投递是否成功。需要生命周期或失败信息时,可收集 state 与 errors;流会报告 STARTING、STARTED、STOPPED,创建与自动启动不会抛异常,失败通过 errors 和 state 呈现。不再监听时,先取消收集器再 close() 关闭应用级流,close 是终结操作。

测试方面,无硬件时可先检查 glasses.services.voiceInvocation.hasConnectedApps(),再调用 simulateLaunchAppAction() 进行模拟;也可用 simulateIncompleteAction() 验证畸形动作会以错误形式暴露而非产生调用。

适用场景为在 Meta 可穿戴设备上通过语音启动 Android 应用并给出动作确认。限制是该功能目前为实验性:应用可用于开发和 beta 测试,但尚不能发布到生产发布渠道。