# YX_Voice 架构文档

## 1. 概述

YX_Voice 是车载语音助手服务模块，作为第三方语音助手（同行者TXZ）与车载各功能模块之间的桥梁，负责语音指令的分发、处理以及车辆状态的同步。

| 项目信息 | 说明 |
|----------|------|
| 包名 | `com.yaxon.voice` |
| 应用类型 | Android System Application |
| 进程类型 | 系统持久化进程 (`persistent=true`) |
| 共享UID | `android.uid.system` |

## 2. 整体架构

```
┌─────────────────────────────────────────────────────────────────────┐
│                         YX_Voice 架构图                              │
├─────────────────────────────────────────────────────────────────────┤
│                                                                      │
│  ┌──────────────┐    TXZ协议    ┌──────────────────────────────┐   │
│  │   TXZ语音    │◄────────────►│        VoiceService          │   │
│  │   助手模块   │               │    (服务入口 & TXZ连接管理)    │   │
│  └──────────────┘               └──────────────┬───────────────┘   │
│                                                │                    │
│                     ┌──────────────────────────┼────────────────┐   │
│                     │                          │                │   │
│                     ▼                          ▼                ▼   │
│  ┌──────────────────────┐    ┌──────────────────────┐  ┌──────────┐│
│  │   ProtocolManager    │    │    VoiceManager      │  │  Helpers ││
│  │   (协议分发管理)      │    │    (核心状态管理)     │  │ (辅助类) ││
│  └──────────┬───────────┘    └──────────┬───────────┘  └──────────┘│
│             │                           │                          │
│             ▼                           ▼                          │
│  ┌──────────────────────────────────────────────────────────────┐  │
│  │                    Protocol Implementations                   │  │
│  │  ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌────────┐ │  │
│  │  │ Voice   │ │  Air    │ │ Setting │ │ Media   │ │ Car    │ │  │
│  │  │Protocol │ │Protocol │ │Protocol │ │Protocol │ │Control │ │  │
│  │  └─────────┘ └─────────┘ └─────────┘ └─────────┘ └────────┘ │  │
│  └──────────────────────────────────────────────────────────────┘  │
│                                                                      │
│  ┌──────────────────────────────────────────────────────────────┐  │
│  │                    IPC Communication Layer                    │  │
│  │              YxIPC (跨进程通信框架)                            │  │
│  └──────────────────────────┬───────────────────────────────────┘  │
│                             │                                       │
│     ┌───────────────────────┼───────────────────────┐              │
│     ▼                       ▼                       ▼              │
│ ┌─────────┐           ┌─────────┐            ┌─────────┐          │
│ │  音乐   │           │  设置   │            │  空调   │          │
│ │  模块   │           │  模块   │            │  模块   │          │
│ └─────────┘           └─────────┘            └─────────┘          │
│                                                                      │
└─────────────────────────────────────────────────────────────────────┘
```

## 3. 模块分层

| 层级 | 模块 | 职责 |
|------|------|------|
| 应用层 | VoiceService | 服务入口、生命周期管理 |
| 核心层 | ProtocolManager, VoiceManager | 协议分发、状态管理 |
| 协议层 | BaseProtocol及子类 | 具体协议解析与执行 |
| 辅助层 | Helpers, Receivers, Observers | 状态监听、辅助功能 |
| 通信层 | YxIPC, TxzProtocolManager | 跨进程通信 |

## 4. 核心模块

| 模块 | 职责 | 设计模式 |
|------|------|----------|
| VoiceService | 与TXZ语音助手建立连接、接收并分发语音指令 | - |
| ProtocolManager | 实现IPC消息监听接口、将消息分发给协议处理器 | 单例模式 |
| YxProtocolHandler | 维护包名到协议逻辑类的映射、在后台线程处理协议分发 | - |
| VoiceManager | 管理TXZ绑定状态、AVM/DVR前台状态、注册车辆状态回调 | 单例模式 |
| VoiceEventHelper | 封装所有语音控制操作、与各模块进行IPC通信 | - |

## 5. 通信架构

### 5.1 协议处理流程

```
TXZ语音指令
    │
    ▼
TxzProtocolManager.setDefaultHandler()
    │
    ├── 解析 commandType (协议名称)
    ├── 解析 Bundle 参数
    ├── 转换为JSON格式
    │
    ▼
ProtocolManager.onResponse()
    │
    ▼
YxProtocolHandler.onHandleProtocol()
    │
    ▼
具体Protocol实现类.onProtocolLogic()
```

### 5.2 IPC通信

```
┌─────────────────┐     YxIPC      ┌─────────────────┐
│   YX_Voice      │◄──────────────►│   YX_Music      │
│  (Server)       │                │  (Client)       │
└────────┬────────┘                └─────────────────┘
         │
         │ YxIPC
         ▼
┌─────────────────┐
│   YX_Setting    │
└─────────────────┘
```

### 5.3 TXZ协议通信

```
┌─────────────────┐  TxzProtocolManager   ┌─────────────────┐
│  YX_Voice       │◄─────────────────────►│  TXZ语音助手     │
│  (ConnectionService)                    │  (AIDL Service) │
└─────────────────┘                       └─────────────────┘
```

## 6. 模块依赖

```
YX_Voice
  ├── YX_IPC_SDK (IPC通信)
  ├── YX_Lib_CommonBase (公共基础库)
  ├── YX_AutoMotiveSDK (车载SDK)
  ├── library-release-0127.aar (TXZ协议库)
  ├── tools.jar (工具库)
  ├── framework_classes.jar (系统框架)
  └── serial-0.1.6_classes.jar (串口库)
```

## 7. 包名依赖

| 包名 | 说明 |
|------|------|
| com.txzing.voiceassistant | TXZ语音助手 |
| com.yaxon.music | 音乐模块 |
| com.yaxon.radio | 收音机模块 |
| com.yaxon.hvac | 空调模块 |
| com.yaxon.bluetooth | 蓝牙模块 |
| com.yaxon.setting | 设置模块 |
| com.yaxon.carcontrol | 车辆控制模块 |
| com.yaxon.avm | 360环视模块 |
| com.yaxon.dvr | 行车记录仪模块 |
| com.android.systemui | 系统UI |

---

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