跳到主要内容

离线语音助手概览

离线语音助手在可穿戴设备上执行受支持的唤醒和命令处理。App 可通过 OnDeviceVoiceAssistantAPI 读取设备能力、检查当前模式并请求兼容模式。

功能概览​

使用 AI 辅助实现

使用 AI 开发

让 AI 帮助实现此工作流

使用官方“管理 AIBuds 设备端语音助手”技能，根据你的 App 完成实现。

请阅读并遵循 https://docs-aibuds.github.io/zh-Hans/skills/manage-aibuds-on-device-voice-assistant，使用该技能在当前 iOS 项目中完成“管理 AIBuds 设备端语音助手”，并验证结果。
查看官方技能

能力与模式​

OnDeviceVoiceAssistantCapability 描述设备支持的能力：

能力支持的行为
.none不支持设备端语音命令。
.keywordWakeup仅支持关键词唤醒，例如“Hi Buds”。
.common支持播放、曲目和音量控制等常用命令。

OnDeviceVoiceAssistantMode 描述当前启用的行为：

模式行为
.unknown当前模式不可用，请勿设置此值。
.disabled离线语音助手已禁用。
.basic唤醒和基础语音命令。
.advanced基础行为加通话状态语音控制。

能力决定应提供哪些模式。当前 Demo 对 .keywordWakeup 提供 disabled 和 basic，对 .common 提供 disabled、basic 和 advanced。

集成流程​

Animated workflow

离线语音助手集成路径

准备 SDK 集成，确认鉴权和设备能力，然后仅提供兼容的助手模式。

宿主 App

初始化 SDK

为宿主 App 安装并初始化基础 AIBuds SDK。

宿主 App

安装集成组件

需要服务鉴权时添加 AIBudsVoiceAssistant。

服务

完成鉴权

完成所需的语音助手服务鉴权流程。

设备

连接设备

验证当前设备是否遵循 OnDeviceVoiceAssistantAPI。

设备 → App

读取能力与模式

检查支持的行为和当前启用的助手模式。

宿主 App → 设备

应用兼容模式

仅提供有效模式，应用选择，并根据完成或变化回调更新 UI。

能力决定 App 应提供的模式；切勿应用 .unknown。

前提条件​

  • 设备已连接并就绪。
  • 所需的服务鉴权已完成。
  • 设备提供 OnDeviceVoiceAssistantAPI，且能力不为 .none。