用途:Voice Invocations(iOS)用于让 Meta AI 在佩戴者说出“Hey Meta, start {app name}”时启动或前置指定 iOS 应用。资料说明该能力属于 Wearables 级流,而不是 DeviceSession 能力,因此不要求存在正在运行的设备会话。
主要能力:应用可以接收语音调用动作;示例中处理 LaunchApp 类型的调用,并在收到后导航到主界面,再通过 launch.responseHandle.sendSuccess(actionOutput: nil) 发送成功确认。每个投递的调用都必须以 sendSuccess 或 sendFailure 恰好确认一次,返回值表示响应是否成功投递。流还通过 errorPublisher 报告后续通信失败。启动时再次调用 start 可将流切换到新设备。
配置与使用方式:需在 Wearables Developer Center 注册 Bundle Identifier、申请 Voice Invocation 审批并配置语音应用名;资料明确说明不要把调用短语添加到 Info.plist,且该功能不需要相机或麦克风权限。VoiceInvocationsStream 标注为 @MainActor,应用应在需要接收动作期间保留流和两个监听令牌,并在启动流之前注册监听器。初始化可能抛出 invalidWearablesInterface;启动可能抛出 deviceNotFound 或 channelNotConnected;后续通信失败通过 errorPublisher 到达。stop() 在非活动状态下可安全调用,同一流之后可再次启动;拥有该流的应用组件结束时,应停止流并释放监听令牌。
测试方式:无硬件时,可在调用 sendLaunchAppAction() 之前检查 glasses.services.voiceInvocation.hasConnectedClients;也可使用 sendIncompleteAction() 确认格式错误的动作会产生错误而不是调用。
适用场景与限制:适用于开发者和 Beta 测试者在 iOS 应用上验证 Meta 智能眼镜的语音启动与前置体验。资料明确该功能为实验性,可用于开发与 Beta 测试,但尚不能发布到生产发布渠道。未提供关于收费、价格、支持平台范围、效果指标或更多使用步骤的信息。