一、前置思考

1.1 车机是"最特殊"的鸿蒙终端

车机应用和手机应用完全不是一回事：使用环境是高速行驶的车辆，用户的目光必须在道路上，手指不能离开方向盘太久。一个手机 App 里"右下角那个 40vp 的小按钮"，在车机上就是安全隐患。

车机应用的硬约束：

🚗 安全第一: 驾驶员视线离开路面 > 2s 即为高危操作
🎙️ 语音优先: 能用嘴不用手，能用耳朵不用眼
⚡ 低延迟: 导航/通话/投屏延迟超过 100ms 用户立即感知
📶 环境恶劣: 隧道/地库断网，弱网是常态而非异常

1.2 手机 App 直接上车的三个灾难

❌ 灾难1: 微信式列表界面
   → 驾驶员手指在 60km/h 的车里点 30vp 的头像，必然点错

❌ 灾难2: 键盘输入验证码
   → 行驶中输入验证码 = 闭眼开车 5 秒

❌ 灾难3: 全屏视频 + 复杂菜单
   → 分散注意力，触发交规判定

1.3 鸿蒙车机的答案

HarmonyOS 提供车载专属权限模型（可驾驶性分级）、行车安全交互规范（HMI 约束）、投屏流转（手机↔车机无缝切换）、语音优先（系统级语音交互框架）四大能力，让开发者能构建"合规且好用"的车机应用。

二、核心原理

2.1 车机应用双形态架构

┌─────────────────────────────────────────────┐
│            车机应用 (Car App)                 │
├──────────────────────┬──────────────────────┤
│  驻车形态 (Parked)    │  行驶形态 (Driving)   │
│  全功能: 视频/游戏/   │  受限功能: 导航/音乐/  │
│  键盘输入/复杂列表    │  通话/语音 (安全优先)  │
├──────────────────────┴──────────────────────┤
│         可驾驶性状态 (DrivingSafety)          │
│  PARKED / MOVING / 车速 / 挡位 / 驾驶模式     │
├─────────────────────────────────────────────┤
│  语音框架 (语音优先)  │  投屏流转 (手机↔车机)   │
└─────────────────────────────────────────────┘

核心思想：同一个应用根据车辆状态切换形态。车停着 → 全功能；车动了 → 自动收缩到安全功能集。

2.2 车载权限模型

车机权限不是"要不要给"，而是"什么时候能用"：

能力	驻车	行驶	说明
视频播放	✅	❌	行驶中禁止全屏视频
键盘输入	✅	❌	行驶中禁止文本输入
语音交互	✅	✅	行驶中唯一推荐的输入方式
导航	✅	✅	核心安全功能
通话	✅	✅	免提模式
复杂列表	✅	⚠️	行驶中只展示大目标列表

系统通过 DrivingSafety 能力提供车速/挡位/驾驶状态，应用据此自动隐藏/禁用不安全的 UI。

2.3 行车安全交互规范（HMI 约束）

触控目标: 行驶中最小 96vp × 96vp
文字字号: 正文 ≥ 20fp，关键信息 ≥ 24fp
对比度: 文字与背景对比度 ≥ 4.5:1
动效: 禁止高频闪烁（防光敏癫痫），动画时长 ≤ 200ms
布局: 核心操作集中在方向盘可达区域
反馈: 每次操作必须有视觉+触觉/听觉反馈

三、源码/API 深度解析

3.1 可驾驶性状态获取

import { drivingSafety } from '@kit.CarKit';

// 监听驾驶状态变化
const listener = {
  onDrivingSafetyChanged: (state: drivingSafety.DrivingSafetyState) => {
    // state: PARKED / MOVING
    if (state === drivingSafety.DrivingSafetyState.MOVING) {
      // 行驶中: 切换到安全界面
      this.enterDrivingMode();
    } else {
      this.enterParkedMode();
    }
  }
};
drivingSafety.on('drivingSafety', listener);

3.2 语音优先交互

import { voiceRecognition } from '@kit.CoreSpeechKit';

// 注册语音指令（车机全局可唤醒）
const directives = [
  { phrase: '导航到公司', action: 'NAV_HOME' },
  { phrase: '播放周杰伦', action: 'PLAY_MUSIC' },
  { phrase: '打电话给老婆', action: 'CALL_WIFE' }
];

// 语音识别结果分发到应用
function onVoiceCommand(text: string): void {
  const cmd = directives.find((d) => text.includes(d.phrase));
  if (cmd) {
    executeAction(cmd.action);
  }
}

3.3 手机→车机投屏流转

import { continuationManager } from '@kit.AbilityKit';

// 手机端发起流转（导航/音乐接续）
const continueCallback = {
  onContinueDone: (result: continuationManager.ContinuationResult) => {
    if (result.status === 'success') {
      // 车机端接管当前任务
    }
  }
};
// 流转时携带当前导航目的地、播放进度等状态
const params = {
  continueMode: continuationManager.ContinueMode.APP_CONTINUE,
  want: { bundleName: 'com.example.navi', abilityName: 'MainAbility' },
  extraInfo: JSON.stringify({ dest: '杭州西湖', progress: 42 })
};

3.4 低延迟渲染

车机投屏/导航对延迟敏感，核心手段：

1. 投屏链路: 软总线直连，不经过云端中转
2. 渲染: 减少重绘区域，脏矩形局部刷新
3. 数据: 预加载下一路口/下一首歌，本地缓存优先
4. 线程: 渲染主线程不做 IO，日志异步落盘

四、企业级实战落地

4.1 车机应用开发清单

阶段	动作	验收
交互设计	按 HMI 规范出图（96vp 触控目标）	设计评审通过
权限适配	接入 DrivingSafety 状态切换	行驶中禁用视频
语音接入	覆盖核心操作语音指令	95% 操作可语音完成
流转适配	手机↔车机导航/音乐接续	5s 内完成切换
弱网测试	隧道/地库场景专项测试	无崩溃、可降级

4.2 完整实现示例

@Entry
@ComponentV2
struct CarAppDemo {
  @Local driving: boolean = false;       // 是否行驶中
  @Local currentMode: string = '驻车模式';
  @Local voiceCmd: string = '';

  // 行驶/驻车模式切换
  private setDrivingState(isMoving: boolean): void {
    this.driving = isMoving;
    this.currentMode = isMoving ? '行驶模式' : '驻车模式';
    LoggerUtil.info(TAG, '驾驶状态: ' + this.currentMode);
  }

  @Builder
  renderNavCard() {
    Column() {
      Text('🧭 导航').fontSize(22).fontWeight(FontWeight.Bold)
      Text('目的地: 杭州西湖 · 12.4km').fontSize(14)
      Button('语音导航').fontSize(18).height(64)
        .onClick(() => this.startVoiceNav())
    }
    .padding(16).borderRadius(16).width('100%')
    .backgroundColor('rgba(79,195,247,0.15)')
  }

  build() {
    Column({ space: 12 }) {
      Text('🚗 车机应用演示').fontSize(20).fontWeight(FontWeight.Bold)

      // 驾驶状态指示
      Text(this.currentMode)
        .fontSize(16).fontWeight(FontWeight.Bold)
        .fontColor(this.driving ? '#FFD54F' : '#69F0AE')

      // 行驶模式: 只显示安全功能
      if (this.driving) {
        this.renderNavCard()
        Text('🎙️ 语音: "播放音乐" / "导航回家"').fontSize(14)
      } else {
        // 驻车模式: 全功能
        this.renderNavCard()
        Text('🎬 视频播放（驻车可用）').fontSize(14)
        Text('⌨️ 键盘输入（驻车可用）').fontSize(14)
      }
    }
    .width('100%').height('100%').padding(20)
    .backgroundColor('#0A1A2B')
  }
}

4.3 车机导航流转时序

手机: 用户在手机输入目的地 → 发起流转
  ↓ (携带目的地 + 路线)
车机: 接收流转 → 自动进入导航 → 语音播报
  ↓ (行驶中)
手机: 变为车机导航的"遥控器" → 副驾可操作

五、问题排查与性能优化

问题	原因	解决
行驶中视频还在播	未监听 DrivingSafety	接入驾驶状态切换
按钮太小被判不合规	触控目标 < 96vp	车机专属布局放大
语音指令不识别	指令未注册	使用系统语音框架注册
流转失败	未带状态数据	extraInfo 携带完整状态
隧道断网导航卡死	依赖在线地图	本地预缓存 + 离线兜底
投屏延迟高	渲染重绘面积大	脏矩形局部刷新

5.1 性能优化要点

1. 触控目标 96vp 起步: 行驶中列表项直接整行可点
2. 语音响应 < 300ms: 语音框架常驻，指令本地匹配优先
3. 弱网兜底: 地图瓦片预下载 50km 范围，音乐缓存整张专辑
4. 流转预判: 手机连上车机 WiFi 即预流转（延迟降至 1s 内）

六、高阶总结与最佳实践

1. 安全是底线：任何功能与行车安全冲突时，安全优先——这是车机应用的第一原则。
2. 语音优先：核心操作必须语音可达，语音不可达的操作就是"行驶中不可用"的操作。
3. 双形态设计：从设计稿阶段就区分驻车/行驶两套界面，而不是运行时临时隐藏。
4. 流转即体验：手机↔车机的无缝流转是车机生态的杀手锏，务必带上完整状态。
5. 弱网即常态：车机网络环境比手机恶劣得多，所有在线能力都要有离线兜底。

一句话记住：车机应用不是手机 App 的放大版，而是"安全约束下的语音优先体验"——驾驶状态决定功能边界，语音是主交互，流转是加分项，弱网兜底是及格线。