andreknieriem / headunit-revived

查看原文 / View Original 编辑 / Edit

andreknieriem / headunit-revived

Headunit Revived is an Android app that allows you to turn your Android tablet or phone into an Android Auto receiver. This project is a revived version of the original headunit project by the great Michael Reid. The original project can be found here: https://github.com/mikereidis/headunit

Headunit Revived 是一款安卓应用，可让你将安卓平板电脑或手机变成 Android Auto 接收器。本项目是基于伟大的 Michael Reid 原版 headunit 项目的复刻版本。原项目地址请见：https://github.com/mikereidis/headunit

Screenshots

截图

How to use

如何使用

Check out the Wiki for detailed documentation, setup guides and troubleshooting! 请查看 Wiki 获取详细文档、设置指南和故障排除说明！

Wired USB Connection

有线 USB 连接

  • Connect your Android device (phone) to the tablet running Headunit Revived via USB cable.

  • Make sure that Android Auto is installed on your phone.

  • Set your phone to Host-Mode if necessary and select Android Auto.

  • Click the USB Button in Headunit Revived, find your phone and click the right button to allow connection.

  • Click on your phone in the list and wait for Android Auto to start.

  • 通过 USB 数据线将你的安卓设备（手机）连接到运行 Headunit Revived 的平板电脑上。

  • 确保手机上已安装 Android Auto。

  • 如有必要，将手机设置为“主机模式”（Host-Mode）并选择 Android Auto。

  • 点击 Headunit Revived 中的 USB 按钮，找到你的手机，然后点击右侧按钮以允许连接。

  • 在列表中点击你的手机，等待 Android Auto 启动。

无线助手（推荐）

This is the most reliable way to connect wirelessly. It uses our companion app on your phone to trigger the connection. Download: Wireless Helper on Google Play Store

这是最可靠的无线连接方式。它使用我们手机端的配套应用来触发连接。 下载：Google Play 商店中的 Wireless Helper

Features: Minimal configuration, supports NSD, Wi-Fi Direct Auto-Connect, and Bluetooth Auto-Start. 功能： 配置极简，支持 NSD、Wi-Fi Direct 自动连接以及蓝牙自动启动。

Setup:

  1. In Headunit Revived Settings: Set Wireless Mode to Helper Mode.
  2. Ensure both devices are in the same network (Hotspot or WiFi).
  3. Open the Wireless Helper app on your phone and start the service.
  4. The helper will find your headunit and initiate the connection automatically.

设置：

  1. 在 Headunit Revived 设置中：将无线模式（Wireless Mode）设置为“助手模式”（Helper Mode）。
  2. 确保两台设备处于同一网络（热点或 WiFi）。
  3. 在手机上打开 Wireless Helper 应用并启动服务。
  4. 助手会自动找到你的车机并启动连接。

Legacy Wireless Options

传统无线选项

  • Wireless Launcher: You can still use the original Wireless Launcher by Emil Borconi.

  • Manual / Native: Uses the native “Headunit Server” built into Android Auto developer settings (may fail on 10.x.x.x networks).

  • Wireless Launcher： 你仍然可以使用 Emil Borconi 开发的原版 Wireless Launcher。

  • 手动/原生： 使用 Android Auto 开发者设置中内置的原生“Headunit Server”（在 10.x.x.x 网络上可能会失败）。

Connect Wirelessly via Intent (Power Users)

通过 Intent 进行无线连接（高级用户）

You can trigger a wireless connection attempt using an Android Intent. This is useful for automation tools like Tasker, MacroDroid, or via ADB. URI Scheme: headunit://connect?ip=<PHONE_IP> Example ADB Command: adb shell am start -a android.intent.action.VIEW -d "headunit://connect?ip=192.168.1.25"

你可以使用 Android Intent 触发无线连接尝试。这对于 Tasker、MacroDroid 等自动化工具或通过 ADB 操作非常有用。 URI 方案：headunit://connect?ip=<手机IP> ADB 命令示例：adb shell am start -a android.intent.action.VIEW -d "headunit://connect?ip=192.168.1.25"

Known Issues

已知问题

  • Google Maps in Portrait Mode: Touch interactions (searching, scrolling) within Google Maps may not work as expected when using Portrait Mode on some devices.

    • Fix: Try reducing the Pixel density (DPI) setting to below 200 (e.g., 190) in the app settings. This often restores full functionality.

  • Wireless Connection Drops: If the connection drops frequently, disable “WiFi Assistant” or “Switch between networks” in your phone’s WiFi settings to prevent it from killing the connection due to “no internet.” Check battery saving options.

  • Self-mode on Android 10 (Q) and below: Google has disabled the automatic wireless projection startup for Android 10 and below in Android Auto versions 16.4 and higher.

    • Workaround: You can still use Self-mode on these devices by starting the built-in Android Auto Headunit Server and connecting via Wi-Fi mode (loopback). See the Troubleshooting Guide for step-by-step instructions.

  • 纵向模式下的 Google 地图： 在某些设备上使用纵向模式时，Google 地图内的触摸交互（搜索、滚动）可能无法正常工作。

    • 修复： 尝试在应用设置中将像素密度 (DPI) 设置降低到 200 以下（例如 190）。这通常可以恢复全部功能。

  • 无线连接断开： 如果连接频繁断开，请在手机 WiFi 设置中禁用“WiFi 助手”或“自动切换网络”，以防止系统因“无互联网连接”而切断连接。同时检查电池优化选项。

  • Android 10 (Q) 及以下版本的自模式（Self-mode）： 在 Android Auto 16.4 及更高版本中，Google 已禁用了 Android 10 及以下版本的自动无线投屏启动功能。

    • 变通方法： 你仍然可以通过启动内置的 Android Auto Headunit Server 并通过 Wi-Fi 模式（回环）连接，在这些设备上使用自模式。请参阅故障排除指南获取详细步骤。

Planned

计划功能

  • Add libusb as alternative to the native usb stack for better compatibility with some devices.

  • More customization options for the UI and the app itself.

  • 添加 libusb 作为原生 USB 栈的替代方案，以提高与某些设备的兼容性。

  • 为 UI 和应用本身提供更多自定义选项。

Changelog

更新日志

(Due to length, the changelog section has been summarized/translated for clarity) (由于篇幅原因，更新日志部分已进行精简翻译)

v.3.0.1

  • 修复：断开连接时应用退出的问题。
  • 增强：USB 工作流，有望消除部分随机 USB 断开问题。
  • 修复：Android < 6 设备上的键盘输入问题。
  • 增强：WiFi Direct 模式及部分设备的文件选择器。
  • 修复：部分导致崩溃的错误。

v.3.0.0

  • 添加：自定义加载屏幕（图片/GIF/视频）。
  • 添加：设置重置按钮。
  • 移除：旧的、已弃用的 C 语言 SSL 库，以提高维护性、稳定性和减小体积。
  • 添加：无需 logcat 的直接文件日志记录功能。
  • 优化：连接丢失处理、USB 断开保持 8 秒（用于 USB 加密狗重启）。
  • 添加：车灯信号模式 (ILL+) 用于夜间主题管理。
  • 添加：设置导出/导入功能及备份选项。
  • 添加：USB 连接白名单，防止干扰 iPhone 等其他 USB 设备。
  • 添加：用于无线助手连接的二维码。
  • 修复：蓝牙自动连接干扰 USB 会话的问题。
  • 添加：双指从右侧滑动切换全屏模式与普通模式。
  • 改进：USB 按钮自动连接。
  • 修复：Android 10+ 上的音频卡顿、USB 设备列表重复及 Android Auto 投屏启动问题。
  • 增强：Google Nearby 功能。
  • 修复：导航按钮映射。

v.2.3.1

  • 修复：连接丢失问题（如跨越网络边界）。
  • 绑定 Socket 到 WiFi 网络以防止断开。
  • 添加：静态音频焦点切换开关。
  • 修复：三星设备 Routine 和模式兼容性。
  • 修复：启动时方向错误问题。
  • 修复：AAwireless 加密狗的 USB 错误。
  • 添加：音频混音器。
  • 添加：多设备蓝牙自动启动。
  • 修复：麦克风输入源映射错误。
  • 添加：越南语翻译 🇻🇳。
  • 合并 PR #549：实现返回键路由及映射。

v.2.3.0

  • 添加：新的按键映射按钮。
  • 修复：3 个致命错误。
  • 修复：Allwinner 设备的视频解码器设置。
  • 添加：新的导航 Intent。
  • 添加：新的“WiFi 自动启动”设置。
  • 修复：原生 AA 中 BSSID 为空的问题。
← 返回新闻列表 / Back to news list