# 徐工语音模块清单

## 模块总览

| 模块 | 文件/类 | 职责 | 关联文档 |
|---|---|---|---|
| 应用入口 | `YxApplication` | 初始化车载 SDK、IPC、崩溃处理和语音服务 | [[YX_Voice_模块详细文档]] |
| 语音服务 | `VoiceService` | TXZ 连接、指令接收、状态初始化、Receiver 注册 | [[YX_Voice_模块详细文档]] |
| 协议管理 | `ProtocolManager` | 接收 IPC 消息并分发到协议处理器 | [[YX_Voice_模块详细文档]] |
| 协议处理 | `YxProtocolHandler` | 维护包名到协议逻辑类映射，后台线程分发协议 | [[YX_Voice_模块详细文档]] |
| 状态管理 | `VoiceManager` | 管理 TXZ 绑定、AVM/DVR 状态、车辆状态回调 | [[YX_Voice_模块详细文档]] |
| 事件封装 | `VoiceEventHelper` | 封装语音控制操作，通过 IPC 调业务模块 | [[YX_Voice_模块详细文档]] |
| 协议实现 | `BaseProtocol` 及子类 | 实现车辆、空调、设置、媒体等协议逻辑 | [[YX_Voice_协议设计文档]] |
| TXZ 通信 | `TxzProtocolManager` | 与同行者语音助手建立协议通信 | [[YX_Voice_架构文档]] |
| IPC 通信 | `YxIPC` | 跨进程调用音乐、设置、空调等模块 | [[YX_Voice_架构文档]] |
| 可见即可说 | 无障碍扫描 / AIDL / 广播 | 控件语音热词注册和命中回调 | [[同行者可见即可说自动注册框架对接方案_快速阅读]] |

## 关键依赖

| 依赖 | 用途 |
|---|---|
| `YX_IPC_SDK` | 跨进程通信 |
| `YX_Lib_CommonBase` | 公共基础能力 |
| `YX_AutoMotiveSDK` | 车载 SDK |
| `library-release-0127.aar` | TXZ 协议库 |
| `tools.jar` | 工具库 |
| `framework_classes.jar` | 系统框架编译依赖 |
| `serial-0.1.6_classes.jar` | 串口相关依赖 |

## 协议类别

| 类别 | 示例 | 验证重点 |
|---|---|---|
| 车辆控制 | 巡航、车道偏离、车窗等 | 指令是否映射到正确 CAN/业务接口 |
| 空调控制 | 开关、温度、风速、模式 | 状态反馈是否同步到 TXZ |
| 系统设置 | 语言、单位、亮度、熄屏 | 设置值是否落库并广播 |
| 媒体控制 | 上一首、播放状态、媒体焦点 | 媒体焦点和播放状态是否一致 |
| 蓝牙相关 | 蓝牙状态、电话、连接 | 蓝牙状态同步和权限边界 |

## 模块变更记录模板

| 日期 | 模块 | 变更类型 | 变更内容 | 影响范围 | 验证方式 | 结论 |
|---|---|---|---|---|---|---|
| 待填写 | 待填写 | 新增/修改/删除 | 待填写 | 待填写 | 待填写 | 待验证 |

## 模块验收标准

- 每个语音指令都有明确协议入口、参数格式和目标业务模块。
- 每个状态同步都有触发时机、数据来源和 TXZ 通知路径。
- 每个跨模块调用都有失败处理和日志。
- 每次模块变更都在本文件记录影响范围和验证方式。