Android Auto 手机端应用的开源实现。此应用运行在你的手机上,并通过 USB 投屏到汽车的车机主机,替代 Google 专有的 com.google.android.projection.gearhead APK。
本项目处于早期开发阶段。协议握手、视频投屏、触摸输入和车辆数据解码均已在真实车机主机上验证可用。连接稳定性已大幅改善(已记录到 15–72 分钟的连续运行),但尚未得到充分验证——已观察到车机主机在会话中途切断 USB 供电(VBUS)。详见下方文档。
| 文档 | 内容 |
|---|---|
docs/protocol.md | 本实现的 AAP 参考。 帧格式、TLS、通道模型、各通道消息目录、传感器发布-订阅模型及其关联风险、视频/焦点/流控规则,以及已知歧义与陷阱的总结。请从这里开始。 |
docs/connection-stability.md | 连接可靠性。 车机主机强制执行的协议要求;两种不同的断开特征(车机主机切断 VBUS 与线缆拔出)及如何区分它们;证据日志;已排除的原因;重连/重启行为;插桩与日志参考;传感器与遥测;外部研究;以及按优先级排列的 TODO。 |
docs/research.md | 生态调研。 Android Auto 逆向工程的历史、现有开源项目对比(headunit-revived、aasdk、openauto、AACS……)、车机主机端与手机端、TLS/认证分析,以及 APK 逆向工程笔记。 |
AGENT.md | 面向在本仓库中工作的 AI 代理/贡献者的指南。 |
请保持这些文档为最新——参见 AGENT.md。
“车机接受/拒绝” = 此车机在 2026-10-24 一次干净运行中验证的
SENSOR_START_RESPONSE(27 个请求 / 27 个响应,零未匹配)。更早的 2026-10-23 表格无效——响应关联错误并偏移了 三位。参见docs/connection-stability.md§5。
使用风险自负。 本软件按“原样”提供,不附带任何形式的保证。
USB Plug-in → MainActivity → ProjectionService
↓
UsbAoaTransport (USB AOA accessory mode)
↓
MessageFramer (16KB frame fragmentation)
↓
InBandTls (TLSv1.2 via SSLEngine)
↓
ProtocolEngine (AAP state machine)
↓
┌───────────┼───────────┐
Video Input Audio
(H.264) (touch/keys) (PCM)
av_channel 分配为视频,第二个分配为音频。这在车机主机上可行(通道 1 = 视频),但在 openauto 上失败(通道 4 = 音频,而非视频)。修复方法:解析 av_channel 内的 stream_type 字段,以区分 VIDEO(3) 和 AUDIO(1)。docs/connection-stability.md。VIDEO_FOCUS_NOTIFICATION UNFOCUSED,因此在主机显示倒车影像时仍持续向显示屏推送 H.264 流,导致画面损坏。现在当主机持有焦点时会抑制帧发送。见文档 §1.8。02:00:00:00:00:00)所致。变通方法:通过 adb shell "echo $(adb shell settings get secure bluetooth_address) > /sdcard/Android/data/org.openandroidauto/files/bt_address.txt" 将真实地址写入配置文件。需要一个 UI 设置界面,让用户手动输入其蓝牙 MAC。已废弃。 此处原有的表格得出的结论是“车机 USB 接收 缓冲区在持续高吞吐量下溢出”。该结论已被推翻:5 KB/s 会失败,而 170 KB/s 反而持续更久; 已证明主机物理切断了 VBUS(内核
vbus:0),且官方应用在同一线缆上可无限期运行。
当前最佳结果(事件驱动视频,2026-10-19):
| 构建 | 时长 | 结束方式 |
|---|---|---|
| 恒定约 15 fps(旧) | 9 秒 - 5 分钟 | 主机切断 USB 供电 |
| 恒定约 15 fps(旧最佳) | 9 分 32 秒 | 主机断开 |
| 事件驱动约 0.9 fps | 15.3 分钟 | 手动拔线(主机正常) |
| 事件驱动约 0.9 fps | 12.7 分钟 | 手动拔线(主机正常) |
事件驱动视频将吞吐量削减了约 10 倍(14.8 → 0.9 fps,5.8 → 0.5 KB/s),此后未再出现 由主机发起的断开。尚未证实 — 目前每次运行都是手动结束的;一次无人值守的 30 分钟以上运行 是尚待完成的测试。
完整分析、A 与 B 的断开检测方法、已排除原因和
TODO 列表见 docs/connection-stability.md。
./gradlew assembleDebug
需要带有平台 35 的 Android SDK。
./gradlew testDebugUnitTest
113 个单元测试和集成测试,覆盖协议、分帧、TLS、通道逻辑、视频状态机、传感器处理和触摸输入。
openauto 是一个第三方车机模拟器,支持完整的 Android Auto 协议。我们使用它来验证我们的协议实现,而无需真实汽车。
./gradlew assembleDebug && adb install -r app/build/outputs/apk/debug/app-debug.apkcd thirdparty/openauto
docker build -f Dockerfile.headless -t openauto-headless .
这会在 Debian 容器中构建 openauto 及其所有依赖项(Qt5、boost、protobuf、OpenSSL)。首次构建大约需要 5 分钟。
docker run --rm -p 5100:5000 -e QT_QPA_PLATFORM=offscreen \
openauto-headless timeout 60 /src/build/bin/autoapp
openauto 在容器内监听端口 5000,并映射到宿主机的端口 5100。它以无头模式运行(无需显示器)。
adb reverse tcp:5000 tcp:5100
这样就把手机的 localhost:5000 隧道连接到电脑的 localhost:5100(openauto)。当未找到 USB 配件时,我们的应用会作为 TCP 客户端连接到 localhost:5000。
adb shell am start -n org.openandroidauto/.MainActivity
应用将会:
localhost:5000(通过 adb reverse 的 openauto)