# 徐工语音模块开发文档

## 概述

本文档记录徐工项目语音模块的开发调试相关内容，包括常用命令、协议定义、问题排查等。

---

## 常用调试命令

### 测试账号
- 新账号：`T9999911`
- 旧账号：`xgtest010002`

### 问题汇总文档
[腾讯文档 - 徐工语音问题汇总](https://docs.qq.com/sheet/DRmh6ZXRVbGR4cFpk?tab=BB08J2)

### 电源模式设置
```bash
adb shell
content insert --uri content://com.yaxon.data.provider/state/ --bind POWER_MODE:i:1
```

### 缓存清理
```bash
# 清理同行者缓存
adb shell pm clear com.txzing.voiceassistant

# 清理语音模块缓存
adb shell pm clear com.yaxon.voice
```

### 语音唤醒与调用
```bash

# 直接调用语音指令
adb shell am broadcast -a com.txznet.txz.invoke -d txznet://com.txznet.txz/comm.asr.startWithRawText?指令


# 方控唤醒
adb shell am broadcast -a android.intent.action.start_txzvoice

# 拉起语音界面
adb shell am start com.txzing.voiceassistant/com.txzing.assistant.core.console.ui.ConsoleActivity



# 查询天气示例
adb shell am broadcast -a com.txznet.txz.invoke -d "txznet://com.txznet.txz/comm.asr.startWithRawText?今天的天气"
```

### 驾驶行为弹框 TTS 测试命令

| 测试命令                                                      | 对应常量                       | 弹框标题   | 弹框内容                                         |
| --------------------------------------------------------- | -------------------------- | ------ | -------------------------------------------- |
| adb shell am broadcast -a com.voice.test.tts.drowsy       | `DROWSY_DRIVING`           | `疲劳监测` | `您看起来有点累了，请注意休息！\n您可以说“稍后提醒”关闭弹窗`            |
| `adb shell am broadcast -a com.voice.test.tts.distracted` | `DISTRACTED_DRIVING`       | `分心驾驶` | `为了您的骂驶安全，请集中注意力！\n您可以说“稍后提醒”关闭弹窗`           |
| `adb shell am broadcast -a com.voice.test.tts.smoking`    | `SMOKING_RECKLESS_DRIVING` | `危险驾驶` | `主人，开车抽烟危险，请不要在开车时吸烟。\n您可以说“稍后提醒”关闭弹腐`       |
| `adb shell am broadcast -a com.voice.test.tts.calling`    | `CALLING_RECKLESS_DRIVING` | `危险驾驶` | `开快车打电话很危险，下次可以对我说"给小明打电话"。\n您可以说“稍后提醒”关闭弹腐` |

### 工厂模式
```bash
adb shell am start com.yaxon.factory/.test.view.FactoryMainActivity
```

### 日志过滤
```bash
# 过滤中间件报文日志
processBodyControl

# 过滤语音模块日志
package:com.yaxon.voice tag:sendCommandTxz tag:VoiceEventHelper

# 语音协议日志
package:com.yaxon.voice VoiceProtocol

# 同行者状态同步日志
package:com.txzing.voiceassistant tag:defaultRegisterHandler

# 过滤激活成功日志
onActivationSuccess

# 过滤初始化日志
initialize: versions
```

---

## 资源提交路径

### 同行者资源路径
```
Z:\znzc\034_xcmg\x9hp_xcmg\androd10_x9hp_ptg4.3p3\android10\vendor\yaxon\txz
```

### 编译输出路径
```
Z:\znzc\034_xcmg\x9hp_xcmg\androd10_x9hp_ptg4.3p3\android10\out\target\product\x9hp_ms\obj\PACKAGING\target_files_intermediates\x9hp_ms-target_files-userdebug.znzc\SYSTEM\txz
```

---

## 协议定义

### 车辆控制协议

| 功能 | 协议Key | CAN ID | 说明 |
|------|---------|--------|------|
| 自适应巡航控制模式 | FCS_AdpvCrsSetDstMod | 0x10FE6F2A | - |
| 预警灵敏度 | FCS_FCWSnvtyFb | 0x18FFD02A | - |
| 自动紧急制动 | FCS_AEBSt | 0xCF02FA0 | - |
| 车道偏离预警 | FCS_LaneDepartureIndcnEnaSts | 0x18FE5B2A | - |
| 车道偏离灵敏度 | FCS_LdwSnvtyFb | 0x18FFD02A | - |
| 主驾车窗 | DDCM_DrvrWinPosn | 0x18F668EC | - |
| 副驾车窗 | BDM_PassWinPosn | 0x18A12721 | - |

### 媒体控制协议

| 功能 | 协议Key | 参数 |
|------|---------|------|
| 上一首 | playPrev | `{"type":"music"}` |
| 同步媒体焦点 | notifySyncMediaFocus | - |
| 同步播放状态 | notifySyncFocusPlayStatus | - |

---

## 问题排查

### 录音唤醒问题
1. 开启录音保存：
   ```bash
   setprop persist.pcm.dump 9
   ```

2. 讲话唤醒同行者，可以多讲几句

3. 关闭录音保存：
   ```bash
   setprop persist.pcm.dump 0
   ```
   
4. 录音文件路径：
   ```
   /data/misc/audioserver/dump_audio_9.pcm
   ```

> 注意：不及时关闭会导致录音文件持续增大

### 常见错误日志
```
tiplogRequestHandlerUtil: Request unsupported!, method = syncAcDefrostStatus
```

---

## 相关截图

### 语音界面
![[语音图片/语音截图_1.png]]

![[语音图片/语音截图_2.png]]

![[语音图片/语音截图_3.png]]

![[语音图片/语音截图_4.png]]

### 资源路径
![[语音图片/语音截图_5.png]]

![[语音图片/语音截图_6.png]]

![[语音图片/语音截图_7.png]]

### 协议相关
![[语音图片/语音截图_8.png]]

![[语音图片/语音截图_9.png]]

![[语音图片/语音截图_10.png]]

![[语音图片/语音截图_11.png]]

### 状态同步
![[语音图片/语音截图_12.png]]

![[语音图片/语音截图_13.png]]

![[语音图片/语音截图_14.png]]

![[语音图片/语音截图_15.png]]

![[语音图片/语音截图_16.png]]

![[语音图片/语音截图_17.png]]

![[语音图片/语音截图_18.png]]

![[语音图片/语音截图_19.png]]

![[语音图片/语音截图_20.png]]

![[语音图片/语音截图_21.png]]

---

*文档整理日期: 2026-05-27*









你好，徐工，  车窗开一点   主驾有问题，副驾正常


车窗全打开，  车窗关一点点      副驾是对的。主驾有问题