跳转至

JDO Voice Assistant

从语音唤醒到业务执行，从设备接入到问题定位。

这是极豆车载语音助手的接入与维护文档。语音助手负责唤醒、对话编排和业务事件处理；在默认 Headless 配置下，通过 gRPC 与同设备上的 Omni Launcher 协作展示界面和执行控制。

开始接入 查看 Omni 协议

按你的任务开始

首次运行项目

确认 JDK、Android 构建环境与设备前提，选择 Ali 变体，完成安装并检查启动日志。

环境与安装 →

对接 Omni Launcher

确认客户端与服务端角色，建立状态订阅和 AppCtrl 流，处理回执与重连。

Omni 接入指南 →

理解业务调用

沿着语音、对话、A2A、业务 Handler 与结果推送，定位媒体、导航或订单链路。

语音链路 → · 业务能力 →

排查联调问题

使用文本注入与 Mock 缩小范围，区分录音、后端路由、业务事件和 Launcher 展示问题。

调试与验收 → · 常见问题 →

系统如何协作

flowchart LR
    User[用户语音] --> Voice[语音助手]
    Voice <--> Dialog[多模态对话服务]
    Voice <--> Agent[A2A 与业务服务]
    Voice -->|gRPC 状态与指令| Omni[Omni Launcher]
    Omni -->|控制与回执| Voice
    Voice <--> Device[媒体 / 导航 / 车控适配器]
你需要了解的概念 在项目中的含义
KWS 监听唤醒词或命令词，进入对应交互
ASR / TTS 语音识别与播报；Ali 当前主链路由多模态对话组件承载
A2A 对话结果进入业务路由，再由对应 Handler 处理
Headless 保留语音和状态处理，默认不挂载应用自身悬浮窗
Omni 通过本机 gRPC 消费语音状态、接收控制指令的 Launcher

阅读约定

本版内容按 2026-09-07 工作区源码核对，重点描述 Ali 与 Omni 接入。示例使用匿名数据；环境地址与凭据由接入团队提供。

代码核对与设备验证是两件事

文档说明当前代码的行为，不代表所有硬件、所有 flavor 或第三方服务已经通过端到端测试。涉及 Stub、状态接口和历史设计的边界，会在对应页面单独说明。