# DiPlay 常见问题与故障处理汇总

核对日期：2026-10-29。默认手机为 iPhone；先按故障阶段找对应问题。本文汇总官方安装、连接、兼容性文档、公开 Issue 和维护者回复；车辆设置随固件变化，只有确实存在的选项才操作。用户已提供的信息和已试过的动作不用重复询问。

2026-10-11 的检索覆盖 380 条公开 Issue（排除 PR），重点阅读 48 个相关讨论及 v0.2.18 文档；此前另核对 v0.2.19、v0.2.20 和 v0.2.21。本次核对 v0.2.22 发布、安装、连接、兼容性与验证说明，不扩大旧 Issue 检索范围。当前官方 0.2.22 发布于 2026-10-28T08:51:23Z，仍为公开预览版。官方 APK 为 19,042,758 字节；同版本网盘备用已独立验收，准确文件名、精确字节数与回读 SHA-256 均与官方 APK 一致，不代表实车兼容验收。历史个案保留对应版本与原始入口。

## 0.2.22 当前更新与操作边界

- 修复 0.2.21 在 DiLink 3.0／4.0 上误选车机热点接口，以及 Wi-Fi 音乐变快／卡顿；不再需要时可清除旧的“热点接口”变通设置。测试车机的音乐时钟结果不验收所有固件。
- USB 微信语音、语音备忘录及听写改用更小的麦克风数据包，仍待实车确认。USB 网络就绪后再次请求连接；较晚启动时最多等待 45 秒，这是恢复期限，不保证连接成功。
- CarPlay 与首页明确显示配对、热点、Wi-Fi Direct 或 USB 失败原因；Android 8／9 恢复检测 Wi-Fi 断开，改善蓝牙与旧 P2P 组恢复。同一局域网可指定网卡，已有一辆 2022 海豹 EV 的 USB 网卡测试。
- 改善多指触控、慢连接拖动及已保存尺寸／帧率显示。“将 CarPlay 保留在桌面卡片”是默认关闭的实验功能；贡献者测试不能证明所有桌面或固件可用。
- “按通话原采样率通话”和“导航提示请求音频焦点”默认关闭，前者有吉利 Monjaro 的 WhatsApp 报告。方控学习也接受传入 DiPlay 窗口的按键；通话、Siri 与语音录音仍须分开检查。
- 新增 DiLink 3.0 仪表全屏地图、2025 领克 03／geely_fx11／Android 11 特定仪表支持，修复宋 Pro 封面，并在 Monjaro 测试 ECARX 车速／挡位输入。2025 腾势 N9／OTA V1.8 布局由照片推定，仍待实车验收。
- 改善桌面悬浮球边界、汉音乐律动、设置备份／搜索及诊断；新增韩语和土耳其语，App 共十一种语言。报告记录连接原因、麦克风来源与丢弃日志，分享前检查完整保存文件。
- 限制网络／USB 输入大小，数据连接只接受控制会话对端。公网远程 MFI 必须使用 HTTPS，HTTP 仅限私有网络；更新仅接受 GitHub HTTPS APK 且超过 64 MiB 停止。签名与 0.2.21 一致，默认源码构建仍不带运行身份。
- 0.2.22：Android 7.0+（API 24），目标 API 37，versionCode 41，包名 com.shihab.diplay；App 十一种语言，新增韩语和土耳其语。Android 7.0–8.1 仅确认一辆 2020 比亚迪汉 EV／DiLink 2.0 / Android 7.1.2 的有线 CarPlay，无线仍待实车验证。桌面地图嵌入需要 Android 11+。新增一项签名级 USB 权限及一个不导出的桌面卡片 Activity。
- 签名与 0.2.21 一致，覆盖 com.shihab.diplay 保留设置和配对。在 0.2.22 重现后打开设置 → 诊断 → 保存诊断报告，或在手机获取报告。Android 7.0–9 申请存储权限，Android 10+ 通常保存到 Downloads/DiPlay；分享前检查，不自动上传。保存失败时仍可查看报告或分享。
- 上游报告 3,537 项测试通过，一项预期 macOS 跳过，无失败；lint、调试／生产构建及归档检查通过。贡献者／车主检查仅覆盖具体热点、音乐、仪表、桌面卡片和 Monjaro 路径。新连接对端校验测试了 Wi-Fi Direct 与 USB，未测试车机热点；未宣称完整 0.2.22 有新增维护者实车或模拟器测试。
- 停稳后用准确的 0.2.22 APK 与固件检查热点、音乐速度／恢复、USB 重连和录音、通话／Siri、桌面卡片与仪表；Android 7.0–8.1 仅有单车有线报告，无线仍未验证，可选功能逐项测试。

来源：[0.2.22 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.22)、[安装](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/INSTALL.md)、[验证范围](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/VALIDATION.md)。

## 0.2.21 历史更新与操作边界

- APK 最低要求降至 Android 7.0/API 24，原生库同步以 android-24 构建。新增意大利语，App 共九种语言；Android 7.0–8.1 仍待实车验证，BYD DiLink 1.0 设置页兼容处理仍仅限 Android 7.1。
- 修复 0.2.20 引入的音乐延迟，将等待解码的音乐计入时钟判断；超过 1.5 秒的积压再持续 1.5 秒后才跳过过期音频。通话或短暂打断后重新申请音频焦点，导航音量改为直接降低提示音本身；相关改动仍待实车验收。
- iPhone 接受请求却不进入 CarPlay 时，有线最多等待 30 秒后重新尝试；忽略模式切换时 10 秒后重新检查。不再用旧重试中断已恢复的会话，未配置热点的 USB 用户也可保存并重连。30 秒是触发恢复的上限，不保证此时连接成功。
- 无线失败明确提示缺少的权限或热点问题；Android 13+ 取消热点／Wi-Fi Direct 提问后，直到手动重试才再次询问。识别 eth0.3 等 VLAN 热点接口，蓝牙开启最多等 3 秒；找不到热点时清除误报覆盖选择，仍需准确固件验收。
- Android 9 及更早版本的软件 Opus 内部失败改为丢弃一帧 20 毫秒音频，避免关闭 DiPlay。隐藏 BYD 通话弹窗实验扩展至 Android 10+。新增闲置按键播放／暂停和双击 Siri，默认延迟 300 毫秒、双击间隔 600 毫秒，两项默认关闭。
- CarPlay 仪表地图停止 15 秒后将 BYD 仪表归还原车，快速重连则保留；DiLink 5.1 原车图层不变。DiYou 桌面卡片启动避免任务闪退，DiLink 7.0 提供 70% 宽侧分屏；完整版本仍待实车验收。
- 新增默认关闭的临时系统栏（5 秒）和 12／24／36／48 dp 黑色圆角。实验性 iPhone 圆角遮罩下次连接生效，无遮罩时回退 24 dp，尚无真实 iPhone 验收。默认关闭的桌面悬浮球使用已有悬浮窗权限。
- 默认关闭的热点信息导入支持 Android 7.1，或 Android 11+ 已授权网络 ADB；Android 8–10 不显示该选项，WPA3 保持不变，写入替代信息须确认。默认关闭的 BYD 原车音乐律动沿用原车设置，旧车机可经已授权 ADB 发送 16 频段；唐实测及汉合成频段检查保留原范围。诊断增加更深的崩溃堆栈及 USB 设备／网络计数。

- 0.2.21：Android 7.0+（API 24），目标 API 37，versionCode 40，包名 com.shihab.diplay，App 九种语言，新增意大利语。Android 7.0–8.1 仍待实车验证，桌面嵌入需要 Android 11+。无新增权限或组件；增加 BYD DiLink 7.0 分屏元数据。
- 签名与 0.2.20 一致，覆盖 com.shihab.diplay 保留设置和配对。在 0.2.21 重现后打开设置 → 诊断 → 保存诊断报告，或在手机获取报告。Android 7.0–9 申请存储权限，Android 10+ 通常保存到 Downloads/DiPlay；分享前检查，不自动上传。保存失败时仍可查看报告或分享。
- 上游报告 3,092 项测试通过，一项预期 macOS 跳过，无失败；lint、源码／生产构建及归档检查通过。贡献者检查包括 DiLink 7.0 分屏、2024 唐原车音乐律动和 2023 汉合成频段律动。Android 7.0 仅有有限模拟器／平板证据；未宣称完整 0.2.21 有新增维护者实车或模拟器测试。

来源：[0.2.21 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.21)、[安装](https://github.com/shihabal3amri/DiPlay/blob/v0.2.21/docs/INSTALL.md)、[验证范围](https://github.com/shihabal3amri/DiPlay/blob/v0.2.21/docs/VALIDATION.md)。

## 0.2.20 历史更新与操作边界

- 音乐约每分钟短停且符合时钟漂移症状时，可用本版复测；最多补偿 1.5% 播放速率，不影响通话、Siri、导航。设置 → 音频分开保存无线／USB 音乐缓冲；USB 可选 50–200 毫秒，原保存值不会自动改成最短。导航提示可在音频路由中单独降低 −20 至 0 dB。
- 通话误走听筒时回退扬声器。手机／平板的“扬声器通话”默认关闭，下次通话生效。消息语音的麦克风启动／无输入恢复、原车通话麦克风来源与 BYD Siri 按键分别有改动；“仅长按唤醒 Siri”适用于 BYD，不外推其他品牌。
- USB 驱动占用、保存并重连、USBMUX VERSION 帧尾和 Android 17 本地网络权限各有修复；设置 → 连接可切换本地离线／USB/CH341 认证。Android 17 Pi 显示／USB 仍待本版复测。
- 自动热点可用已授权 ADB 经 shell 启动；非 BYD Android 8–10 可只授予修改系统设置，BYD 保留 ADB，Android 7.1 不提供该无 ADB 选项。热点误报关闭时点“连接”继续。Wi-Fi Direct 的暂停 Wi-Fi 搜索默认开启，若要车机继续自动加入已存网络可关闭并对照卡顿。无 5 GHz 能力时 Auto 先用 2.4 GHz，但不保证固件调用成功。
- 仪表地图扩展控制器 13／17 与豹 5 Ultra；DiLink 3 排除不兼容的 DiLink 4 路径。无硬件 HEVC 时回退 H.264；Android 10+ 的软件 HEVC 另行选择。修复 Android 7.1–9 搜索设置崩溃，调整 CarPlay 分页菜单与氛围灯。
- 诊断报告增加上次崩溃、方向盘／媒体键、蓝牙暂停步骤、音乐再缓冲和 CH341 设备。仍在设置 → 诊断保存／在手机获取；分享前检查，不自动上传。
- 最低 Android 7.1/API 25、目标 API 37、versionCode 39，App 八种语言。无新增权限，新增不对外开放的崩溃记录 provider。签名与 0.2.19 相同，覆盖安装保留设置和配对。
- 上游报告 2,865 项测试通过、一项预期 macOS 跳过，无失败；lint、源码／生产构建及归档检查通过。BOS Mini A1 无 ADB 热点和 2023 汉麦克风测量来自贡献者，保留原范围；未新增完整 0.2.20 维护者实车或模拟器验收。音乐、通话扬声器、USB、热点、仪表及 Android 7.1–8.1 仍需实车反馈。

来源：[0.2.20 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.20)、[安装](https://github.com/shihabal3amri/DiPlay/blob/v0.2.20/docs/INSTALL.md)、[连接](https://github.com/shihabal3amri/DiPlay/blob/v0.2.20/docs/CONNECTION_SETUP.md)、[验证范围](https://github.com/shihabal3amri/DiPlay/blob/v0.2.20/docs/VALIDATION.md)。

## 0.2.19 历史更新与操作边界

- 有线启动慢或 iOS 26 卡在打开 CarPlay 时，0.2.19 可作为复测候选；缩短初始 USB 等待并优先请求 CarPlay 模式。自动确认可识别系统 USB 对话框；Android 7.1–9 缺少授权页且网络 ADB 已授权时，才有 ADB 授予 USB 的对应路径，不要求所有用户先配 ADB。
- 通话、Siri 或导航语音难听清时，本版修正 16 kHz 播放时钟；通话麦克风首读失败最多重启三次。后台音乐周期断续的解码等待改为 0.1 秒，不能据此保证 Wi-Fi 丢包也已修复。
- DiLink 4 开仪表地图后首次触摸重连、倒车返回后画面缩小分别有对应修正。平滑视频／直接视频输出返回时恢复最后画面；实验仍默认关闭，不为了修复一个问题全部开启。
- 手机报告入口为“设置 → 诊断 → 在手机获取报告”；扫码或输入车机显示的地址及六位码，在手机点下载报告。输错五次暂停手动输入，重新打开页面恢复，二维码仍可用。发布前检查报告，不自动上传。
- 首次向导对 DiLink 3／4 采用导航声道 14、DiLink 5 采用 15；保留原有选择，不能把这些值当作所有品牌声道。新增日语，App 共八种语言，繁体中文和阿语补齐；本站语言数与 App 分开。
- 无线增加 MIUI 13 蓝牙权限、蓝牙关闭提示和对应失败建议；仅在热点确实广播第二个 _5G 名称时填写真实名称。方向盘服务重启前增加等待；#606 在 0.2.18 仍失败的反馈是历史结果，0.2.19 仍需复测。
- 上游报告 2,636 项测试通过及一项预期 macOS 跳过，源码／生产构建与归档检查通过。DiLink 3 本地音频构建、较早的 Ford RFCOMM 修复与贡献者 2024 唐画面测试不能当作完整 0.2.19 新实车测试。Android 7.1–8.1、USB／通话／显示／手机页面仍需准确固件验收。
- 签名与 0.2.18 一致，优先覆盖 com.shihab.diplay 保留设置和配对；旧说明中的 0.2.18 新功能属于历史引入时间，并非要求用户降级。

来源：[0.2.19 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.19)、[安装](https://github.com/shihabal3amri/DiPlay/blob/v0.2.19/docs/INSTALL.md)、[验证范围](https://github.com/shihabal3amri/DiPlay/blob/v0.2.19/docs/VALIDATION.md)。

## 安装与版本

### 1. 我的车型应该怎么给车机装软件？

提供完整车型，如“比亚迪 宋 Plus DM-i，2023 冠军版，5G 款”，以及已经知道的车机 Android/固件。助手先查资料选包，说明怎样传到车机和安装；用户不用另行指挥搜索或选版本。APK 装在 Android 车机上，不是装到 iPhone。仅凭车型、DiLink 或 OTA 名称不能断定 Android 小版本；有必要且搜索无法确认时才补问车机实际信息。

来源：[安装指南](https://diplay.org/zh/install/)、[官方兼容性](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/COMPATIBILITY.md)。

### 2. 提示“解析软件包时出现问题”怎么办？

先把车机实际 Android/API、CPU 架构与这个 APK 的要求对上。当前官方 0.2.22 最低 Android 7.0/API 24；旧版本和第三方包各有门槛，Android 7.0 不等于 7.1。32 位 ARM 系统不能安装只有 arm64-v8a 的包；64 位芯片也不保证系统为 64 位。确定不匹配时换匹配包。

条件符合仍报错，再确认拿到的是完整 APK，而非源码 ZIP、网页或下载中的文件；按完整报错检查安装入口。U 盘打开失败且未试过时，可复制到车机本机存储再用支持安装的入口打开。多个包都同样失败就停止盲目换包。文件大小相同不能证明完整，也不能凭一句“解析失败”确认根因；哈希、签名不作为新手必做步骤。

来源：[Android 最低 API](https://developer.android.com/guide/topics/manifest/uses-sdk-element)、[CPU ABI](https://developer.android.com/ndk/guides/abis)、[安装失败分类](https://developer.android.com/reference/android/content/pm/PackageInstaller)、[0.2.22 系统门槛](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.22)。#113 的历史 Android 9 门槛不用于当前版。

### 3. 有文件管理器，为什么还是不能安装？

文件管理器能查看文件，不一定能调用安装器。看实际固件是否提供 APK 安装、是否允许当前入口安装未知应用，以及完整提示。不要猜密码、USB 口或隐藏菜单。0.2.18 改进了更新安装器选择，避开部分车机“不支持”的未知应用设置页面；这不等于绕过车厂安装限制。

来源：[安装器改进 PR #593](https://github.com/shihabal3amri/DiPlay/pull/593)。

### 4. 更新要先卸载吗？

官方同签名版本优先覆盖安装，保留设置与配对。不同分支若出现明确签名冲突，才解释覆盖限制；卸载可能丢设置，不默认让用户卸载。0.2.18 提供手机备份设置入口，但不导出配对密钥、认证材料及热点名称/密码，恢复设置不等于恢复配对。

来源：[0.2.18 更新说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.18)、[手机备份 PR #598](https://github.com/shihabal3amri/DiPlay/pull/598)。

### 5. Android 手机也能用吗？非 Android 车机呢？

DiPlay 是 iPhone CarPlay 的接收端，不等同于 Android Auto。明确使用 Android 手机时，按车型选择原车支持的互联方案。非 Android 车机停止 APK 安装流程；Tesla 浏览器、HarmonyOS 原生包等方案另查平台和实车条件。

来源：[手机互联方案](https://diplay.org/zh/phone-to-car/)、[官方兼容性](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/COMPATIBILITY.md)。

### 6. 找不到新版下载，或者源码编译后无法连接？

当前官方 0.2.22 原包为 `DiPlay-0.2.22.apk`，从原作者发布页获取；原夸克分享“全部文件 → DiPlay”内的 `DiPlay-0.2.22.apk` 已完成上传，公开文件名／精确字节数及回读 SHA-256 已验收，不能用旧版或同名第三方包代替。助手按实际渠道提供准确文件名与位置。源码 ZIP 不是 APK；默认源码构建不包含运行认证资产，能安装、能启动也不代表可连接。第三方包逐项看作者说明。

来源：[0.2.22 原始发布入口](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.22)、[源码构建说明](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/BUILD.md)。

## 无线连接

### 7. 一直“正在准备 CarPlay”，先做什么？

0.2.22 在 CarPlay 与首页记录配对、热点、Wi-Fi Direct 或 USB 的具体失败原因及时间，先按提示处理再重试；DiLink 3.0／4.0 旧“热点接口”变通设置不再需要时可清除。 来源：[0.2.22 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.22)。

先看当前连接模式及具体阶段：打开 iPhone 蓝牙/Wi-Fi，确认 Siri 可用且屏幕使用时间没有禁用 CarPlay；选中正确的已配对 iPhone，接受手机 CarPlay 提示，暂停其他投屏应用。然后只按所选模式排查。0.2.18 改进了各语言的真实阶段/错误显示；旧版同一句等待文字可能掩盖不同失败原因。

![旧版“正在准备 CarPlay”界面示例](https://github.com/user-attachments/assets/8efa2eb1-6d37-4e90-bd39-f1934a3454bc)

图源：[Issue #580 的用户截图](https://github.com/shihabal3amri/DiPlay/issues/580)。这是故障示例，不能凭相同文字断定所有车的原因一致。

来源：[Apple 连接检查](https://support.apple.com/en-us/105109)、[连接设置](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/CONNECTION_SETUP.md)、[阶段显示 PR #624](https://github.com/shihabal3amri/DiPlay/pull/624)。

### 8. 手机和车机一定要连同一个 Wi-Fi 吗？

只有“现有 Wi-Fi/同一局域网”模式要求两端预先加入同一个外部网络，并能互通。车载热点模式让 iPhone 加入车机热点；Wi-Fi Direct 由车机建 P2P 网络，按 CarPlay 流程加入，不要求另接同一台路由器。三种模式不能混用排查条件。

来源：[连接模式](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/CONNECTION_SETUP.md)、[现有 Wi-Fi](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/EXISTING_WIFI.md)。

### 9. 车载热点模式连不上怎么办？

先在车机设置里开启实际热点；DiPlay 保存与它完全一致的名称、密码及加密方式。看 iPhone 是否加入该热点，未加入时手动连接并开“自动加入”。无需开通车机流量套餐，也无需为了基础连接先开 ADB。支持 5 GHz 时优先使用，但仅有 2.4 GHz 并不代表不能用。

来源：[连接设置](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/CONNECTION_SETUP.md)。

### 10. 开热点提示“不支持自动启动”，是不是必须开 ADB？

先手动打开车机热点再连接。0.2.20 对已授权 ADB 增加 shell 启动路径；非 BYD Android 8–10 可只授予修改系统设置，Android 7.1 不提供这条无 ADB 路径，BYD 仍用已授权 ADB。开关默认关闭，仍取决于实际固件。#616 的元 PLUS/DiLink 3/Android 10 反馈手动热点可连接，后续用户升级车机固件后自动开启恢复；不能扩大成全部相同车型均修复。

来源：[Issue #616](https://github.com/shihabal3amri/DiPlay/issues/616)。

### 11. 热点名有中文，或者双频热点有两个名字怎么办？

如果热点模式卡住且名称含中文，可把车机热点改为简单英文/数字，再同步更新 DiPlay 中的名称与密码。0.2.18 增加了相关提醒；来自宋 PLUS/宋 L 的反馈，不是所有中文名必然失败。双频热点以 iPhone 实际看到的 2.4/5 GHz 网络名为准，不自行拼 `_5G`；先用能连接的频段，再单独对照另一个。

来源：[Issue #303](https://github.com/shihabal3amri/DiPlay/issues/303)、[Issue #617](https://github.com/shihabal3amri/DiPlay/issues/617)、[热点提示 PR #622](https://github.com/shihabal3amri/DiPlay/pull/622)。

### 12. 普通 Wi-Fi 能用，为什么 Wi-Fi Direct 不行？

普通 Wi-Fi、5 GHz 与 Wi-Fi Direct 建组是不同能力。车机必须提供可用 P2P 实现，按实际 Android 授予附近设备/Wi-Fi 或旧系统定位权限，并保持 Wi-Fi 开启。iPhone 没有需要单独打开的“Wi-Fi Direct”开关。建组失败或加入后反复连接失败时对照车载热点；不盲改驱动、国家代码或刷机。

来源：[Android Wi-Fi Direct](https://developer.android.com/develop/connectivity/wifi/wifi-direct)、[Issue #553](https://github.com/shihabal3amri/DiPlay/issues/553)、[官方连接可靠性](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/CONNECTION_RELIABILITY.md)。

### 13. Wi-Fi Direct 导致整台车机重启怎么办？

先停用这一模式，改车载热点或 USB。五菱缤果 2025/Ling OS/Android 9/MT8666 的 #535 反馈两种频段下均整机重启，热点正常，维护者怀疑车机 Wi-Fi 驱动/固件；还需要重启记录确认。不要把该结论扩大到其他车型，也不要为了验证反复触发整机重启。

来源：[Issue #535](https://github.com/shihabal3amri/DiPlay/issues/535)。

### 14. 同一局域网模式找不到，密码明明正确？

确认两端加入同一个外部路由器/随身 Wi-Fi，保留蓝牙；路由器客户端隔离会阻止互通，组播发现也需允许。官方支持 WPA2 或 WPA2/WPA3 混合，不支持纯 WPA3、企业认证及需网页登录的网络。加入网络成功不等于 CarPlay 服务已发现。

来源：[现有 Wi-Fi 条件](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/EXISTING_WIFI.md)。

### 15. 能蓝牙播放音乐，为什么无线 CarPlay 不通？

部分车机的电话/音乐蓝牙由厂商独立模块处理，Android 的蓝牙数据链路并不通。#581 的 2025 传祺 GS8/Android 9 用户反馈有线可用，无线受此限制；0.2.18 增加检测和 USB 提示。若报告已确认这类限制，停止反复配对，使用 USB；不是所有 Android 9 车机都这样。

来源：[Issue #581](https://github.com/shihabal3amri/DiPlay/issues/581)、[Issue #354](https://github.com/shihabal3amri/DiPlay/issues/354)、[蓝牙链路检查 PR #590](https://github.com/shihabal3amri/DiPlay/pull/590)。

### 16. 其他投屏应用抢连接，或者连到了家人手机？

先暂停其他投屏应用的自动连接（如车机现有 ZLink/HiCar），只测试一个接收端，并在 DiPlay 选择当前 iPhone。不要默认卸载原车应用。0.2.18 改进多部已配对 iPhone 的发现，但不保证每台 OEM 蓝牙都支持。#630 的 ZLink 抢连接仍未确认解决。

来源：[Issue #630](https://github.com/shihabal3amri/DiPlay/issues/630)、[多手机选择 PR #585](https://github.com/shihabal3amri/DiPlay/pull/585)。

### 17. 这些检查都做过了，还有什么简便办法？

蓝牙配对异常时忘记这对设备再配；旧 CarPlay 记录异常时在 iPhone“设置 → 通用 → CarPlay”忘记对应车辆再设置。仍失败可停稳后按正常方式重启手机和车机。最后用数据 USB 口和数据线对照有线连接；有线成功只证明这条路径本次可用，不能单凭它确认无线根因。已试过的动作直接跳过。

来源：[Apple CarPlay 排查](https://support.apple.com/en-us/105109)、[官方安装](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/INSTALL.md)。

## USB 连接与掉线

### 18. USB 只充电，或者没弹出授权？

换用车上真实数据口和支持数据的短线，去掉转接头/延长线/集线器，解锁 iPhone，再按提示接受车机 USB、iPhone 信任/CarPlay 权限。普通充电口或充电线不能传 CarPlay 数据。不要给所有车型猜一个固定 USB 口。

来源：[官方安装](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/INSTALL.md)、[Apple USB 检查](https://support.apple.com/en-us/105109)。

### 19. 为什么有线需要 VPN 权限？不出现授权界面怎么办？

按 DiPlay 有线连接提示允许本地 VPN。#604 的银河 E8/Android 12 没有系统 VPN 授权界面；0.2.18 可借助已经授权的网络 ADB 处理这条缺失路径，不在连接中申请新 ADB 授权。它不是所有 USB 连接必须先配置 ADB 的要求。无对应入口时先走可用无线方式，再按具体日志判断。

来源：[Issue #604](https://github.com/shihabal3amri/DiPlay/issues/604)、[VPN 授权修复 PR #618](https://github.com/shihabal3amri/DiPlay/pull/618)。

### 20. 有线每几秒就断，又出现充电或 USB 授权？

先换短数据线和数据口，避开转接器；如果当前版有“iPhone 充电”选项，可由标准试“降低”，仍断再试“低”，重新连接生效，充电会变慢。#514/#612 的日志显示 iPhone 从 USB 消失，供电是待确认方向；不能把普通读超时当作断线根因，也不能仅凭这一现象确认供电不足。

来源：[Issue #514](https://github.com/shihabal3amri/DiPlay/issues/514)、[Issue #612](https://github.com/shihabal3amri/DiPlay/issues/612)、[充电设置 PR #583](https://github.com/shihabal3amri/DiPlay/pull/583)。

### 21. 几分钟后断开，日志出现 USBMUX 超时怎么办？

空闲 USB 读取的短超时可以正常出现；关键是会话终止时的具体错误。明确出现 `Android could not cancel timed out USBMUX read request` 时，0.2.18 加入对应读取竞态修复，可升级原作者版本后复测；仍需目标车机验收。不要把所有带 timeout 的日志都归为同一个故障。

来源：[Issue #610](https://github.com/shihabal3amri/DiPlay/issues/610)、[USB 读取修复 PR #625](https://github.com/shihabal3amri/DiPlay/pull/625)。

### 22. 旧 Android/iOS 有线卡住，新版有没有帮助？

0.2.18 处理了 Android 7.1 的特定 IPv6 bind 错误，以及部分 iPhone NCM 接口被车机 USB 音频驱动占用的路径；对旧 iOS 的模式切换补充诊断。只在对应错误时作为复测候选，不写“旧系统有线都已修好”。保留完整 Android 小版本和 iOS 信息。

来源：[Issue #557](https://github.com/shihabal3amri/DiPlay/issues/557)、[Issue #518](https://github.com/shihabal3amri/DiPlay/issues/518)、[0.2.18 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.18)。

## 画面、拖动与性能

### 23. 拖动不跟手，可以试 60 fps 吗？

DiPlay 视频帧率为 30 fps、拖动感觉卡卡的时，可先改为 60 fps，应用并重新连接，再拖动地图或列表对照。用户亲测从 30 改到 60 后明显更跟手，具体车型/固件未知。这里调整的是 DiPlay 视频帧率，不需要改车机屏幕刷新率。若 60 fps 下画面掉帧或负载过高，再回到 30 fps、关闭 HEVC，按需降低分辨率；音乐断续另按连接与音频排查。

来源：[用户实测记录](https://diplay.org/evidence/60fps-touch-feedback.md)。

### 24. 画面掉帧、延迟大，怎么调？

先用 DiPlay 的 30 fps、默认图标/文字，关闭 HEVC/Efficient video；仍慢再逐项试 80%、必要时 60% 分辨率。连接中“应用并重新连接”，未连接时保存后下次连接生效。这里指实际画面掉帧或解码负载；如果是 30 fps 下拖动不跟手，先按上一项对照 60 fps。MTK 低延迟等实验功能关闭为基础对照，不一开始全开。

来源：[流畅无线指南](https://github.com/shihabal3amri/DiPlay/blob/v0.2.18/docs/SMOOTH_WIRELESS.md)、[安装设置](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/INSTALL.md)、[MTK 实验 PR #608](https://github.com/shihabal3amri/DiPlay/pull/608)。

### 25. 有声音却黑屏怎么办？

先关 HEVC 和已经开启的实验视频选项，使用 30 fps、较低分辨率重连。仍黑屏要区分收到视频、解码、物理显示各阶段。长安 CS75 PLUS/全志 T7 的特定窗口硬件加速问题在 0.2.14 加入 SurfaceView 自动回退且有用户确认；不能推广到所有黑屏。#609 的 Surface Pro/Bliss OS 个案维护者建议对照 Direct video output 开/关，只有匹配该设备时再试这一分支。

来源：[Issue #278](https://github.com/shihabal3amri/DiPlay/issues/278)、[Issue #609](https://github.com/shihabal3amri/DiPlay/issues/609)。

### 26. 刚换自定义车标后就无法连接？

先恢复默认车按钮图标再重连。#567 的 Ford 用户更换大尺寸图片后卡连接，0.2.18 会把自定义图片缩小到 192 像素再发送。只有刚换图标且对应症状时才走这个分支。

来源：[Issue #567](https://github.com/shihabal3amri/DiPlay/issues/567)、[图标缩放 PR #622](https://github.com/shihabal3amri/DiPlay/pull/622)。

### 27. 图标太大、屏幕底部留白怎么办？

CarPlay 的图标/布局由上报给 iPhone 的物理屏幕长度影响，不等于 DiPlay 自身字号。调大 Physical length 可让布局更紧凑，但 iOS 只在部分阈值切换，不是每一点都变化；保存后重连。0.2.18 改成 25 mm 步进。边缘条带/圆角露背景可对照该版车内菜单 Safe area 的“Square corners, no safe area”，保留原设置以便恢复，不承诺所有屏幕有效。

![CarPlay 底部留白的原始反馈截图](https://github.com/user-attachments/assets/591c154e-b27a-435f-b977-09e3bad8547f)

图源：[Issue #578](https://github.com/shihabal3amri/DiPlay/issues/578)，红圈为报告者标注；这是调整前的故障示例。

来源：[Issue #591](https://github.com/shihabal3amri/DiPlay/issues/591)、[安全区 PR #596](https://github.com/shihabal3amri/DiPlay/pull/596)。

### 28. 欧拉哈曼时钟侧栏占位置，或 CPU 很高怎么办？

0.2.18 的 Harman full screen 实验针对特定哈曼车机，已有较早构建在欧拉好猫/Android 8.1/32 位 x86 的用户确认，整版仍需验收；不要把所有车的侧栏都归为这个功能。CPU 占用高先降画面负载，关闭当前启用的仪表地图等实验输出做对照；#555 的宋 Pro DM-i/DiLink 4 高 CPU 问题仍待确认，不盲目推荐任意旧版。

来源：[Issue #603](https://github.com/shihabal3amri/DiPlay/issues/603)、[哈曼全屏 PR #613](https://github.com/shihabal3amri/DiPlay/pull/613)、[Issue #555](https://github.com/shihabal3amri/DiPlay/issues/555)。

## 音乐、导航、Siri 与通话

### 29. 音乐断断续续，调缓冲还是换连接模式？

0.2.22 修复 0.2.21 的 Wi-Fi 音乐加速／卡顿，按时间平均与每次启动后的实际缓冲水平调整音乐时钟。测试车机速度测量不验收所有固件；实际丢包仍需对照车机热点与 USB。 来源：[0.2.22 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.22)。

Wi-Fi Direct 下周期断续先对照车载热点，再对照 USB。0.2.20 的暂停 Wi-Fi 搜索默认开启；车机需要自动加入已存网络时可关闭并对照卡顿。0.2.20 曾引入时钟补偿，但同时产生本次修复的延迟；不能修复实际丢包，USB／无线音乐缓冲分别设置。支持稳定 5 GHz 时优先；无线丢包、网络抖动和解码丢帧是不同原因。缓冲可吸收抖动却不能补回丢包，还会增加延迟。已授权网络 ADB 的扫描暂停不是普通热点连接的必做步骤。0.2.18 修复另一类 AAC 解码短掉音，可升级复测，不承诺覆盖 Wi-Fi 固件丢包。

来源：[Issue #131](https://github.com/shihabal3amri/DiPlay/issues/131)、[Issue #381](https://github.com/shihabal3amri/DiPlay/issues/381)、[解码修复 PR #618](https://github.com/shihabal3amri/DiPlay/pull/618)。

### 30. 音乐有播放进度，但车上没声音？

检查 iPhone 当前输出、车机音源/媒体音量与 DiPlay 音频路由。先分别测试音乐、导航、Siri 和通话，不把某一声道正常当作全部正常。某些吉利/领克固件原车蓝牙媒体与 CarPlay 抢声音，先选定一种实际输出路径。#601 的哈曼声道 1/7 建议只针对那份路由日志，不用于所有车。

来源：[Issue #207](https://github.com/shihabal3amri/DiPlay/issues/207)、[Issue #554](https://github.com/shihabal3amri/DiPlay/issues/554)、[Issue #601](https://github.com/shihabal3amri/DiPlay/issues/601)。

### 31. 导航音量不对，或 USB 导航语音含糊？

0.2.21 将导航衰减直接作用于提示音本身，避免部分 DiLink 3.0 忽略 Android 音轨音量；按准确车机复测。 来源：[0.2.21 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.21)。

导航/提示音可能与媒体音量独立，播报时调整对应音量，再检查当前车机声道。0.2.20 可在设置 → 音频 → 音频路由以 −20 至 0 dB 单独降低导航提示，不必重连。0.2.18 的“Clearer navigation voice over USB”为关闭默认的实验选项，改变向 iPhone 提供的导航采样率，通话不变，尚无该功能实车验证；仅作为 USB 导航清晰度问题的可恢复对照。

来源：[BYD 导航/声音说明](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/BYD_NAVIGATION.md)、[清晰导航语音 PR #622](https://github.com/shihabal3amri/DiPlay/pull/622)。

### 32. Siri 唤不醒、听不清或选错歌？

Android 9 及更早车机使用软件 Opus 时，0.2.21 将内部失败改为丢一帧 20 毫秒音频，避免应用关闭；Siri 与消息录音仍分别验证。 来源：[0.2.21 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.21)。

先确认手机 Siri 正常。能唤醒但听不到声音再检查车机麦克风权限/输入与连接模式；Wi-Fi Direct 麦克风断续可对照热点。按键唤醒选错歌而“Hey Siri”正常是另一种问题，不能等同没开 Siri。#117 后续用户确认含 PR #295 的自编译构建解决了自己的问题；不是全部设备保证。语音消息、Siri 与通话修复不能混称。

来源：[Issue #117](https://github.com/shihabal3amri/DiPlay/issues/117)、[Siri 修复 PR #295](https://github.com/shihabal3amri/DiPlay/pull/295)、[Issue #536](https://github.com/shihabal3amri/DiPlay/issues/536)。

### 33. 通话没声音、回声大，或挂断后音乐不恢复？

0.2.22 在结束通话后只撤回 DiPlay 自己的音频模式请求。“按通话原采样率通话”默认关闭，有 Monjaro WhatsApp 报告；USB 录音小包修复仍待实车确认，通话、Siri、录音分别测试。 来源：[0.2.22 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.22)。

分别确认接听端声音、对方听到的麦克风、挂断后的媒体恢复。0.2.20 对误走听筒的通话尝试扬声器回退；手机／平板“扬声器通话”默认关闭，下次通话生效。原车通话音频启用时的麦克风来源改变不等于所有车型通话已验收。检查实际音源和权限，记下通话时间；挂断不恢复需要看音频焦点，而非直接重装。0.2.18 的 Car phone audio 两个实验选项尝试利用车机通话路径的回声消除，尚未用真实 CarPlay 通话完成验收，可能改变音量，不默认开启。

来源：[Issue #542](https://github.com/shihabal3amri/DiPlay/issues/542)、[Issue #18](https://github.com/shihabal3amri/DiPlay/issues/18)、[通话实验 PR #595](https://github.com/shihabal3amri/DiPlay/pull/595)。

### 34. 音量物理键或方向盘键不工作？

0.2.21 可选闲置按键播放／暂停和双击 Siri，默认均关闭；保留键不能分配，无 CarPlay 或通话中保留原动作。Siri 双击默认间隔 600 毫秒、释放后延迟 300 毫秒，按需调整。 来源：[0.2.21 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.21)。

先确认 CarPlay 在前台，从 iPhone CarPlay App 播音乐，再检查原车音源是否占用按键。0.2.20 报告会列出收到的方向盘／媒体键，先确认按键是否到达；BYD 的重复 Siri 请求有修正，可按需要启用仅长按唤醒，不外推其他品牌。0.2.18 对 DiLink 2 的前台上下曲和特定吉利 `geely_fx11` 原生输入服务有改进，不能外推全部车型。该版 Disable media-key audio focus 针对焦点占用导致物理音量键失效的个案，开启可能影响其他媒体键，仅有匹配症状时对照。

来源：[前台按键 PR #600](https://github.com/shihabal3amri/DiPlay/pull/600)、[吉利输入 PR #626](https://github.com/shihabal3amri/DiPlay/pull/626)、[音量焦点 PR #615](https://github.com/shihabal3amri/DiPlay/pull/615)。

## 自动启动、方向盘、仪表与其他功能

### 35. 开机不启动、后台退出或回桌面后要重连？

先手动打开确认基本连接。分清车机开机后打开 App、USB 插入后打开、App 打开后连接与自动开热点，再看本车自启动/后台白名单。固件可能限制或杀进程；不要承诺应用设置能绕过系统限制。#560 有用户关闭“极速模式”后恢复，只适用于确实开启该实验功能的对照。

来源：[Issue #118](https://github.com/shihabal3amri/DiPlay/issues/118)、[Issue #571](https://github.com/shihabal3amri/DiPlay/issues/571)、[Issue #560](https://github.com/shihabal3amri/DiPlay/issues/560)。

### 36. 按键服务一直“已允许，正在启动”，ADB 明明正常？

ADB 能连不等于按键服务已绑定。0.2.18 增加开机等待及回前台重试，可先回 DiPlay 前台观察，再按故障时间保存报告。#606 的腾势 N7 用户在 0.2.18 仍报告未修复，不能告诉用户更新必好，也不要无限重复授权。前台上下曲可与后台按键服务分别测试。

![0.2.18 按键服务仍停在启动中的反馈](https://github.com/user-attachments/assets/70fa27d7-f393-4732-9d40-5a5fdc44aabd)

图源：[Issue #606 的复测](https://github.com/shihabal3amri/DiPlay/issues/606)，截图是未解决状态。

来源：[Issue #619](https://github.com/shihabal3amri/DiPlay/issues/619)、[重试 PR #625](https://github.com/shihabal3amri/DiPlay/pull/625)。

### 37. HUD 有箭头，为什么仪表没有 CarPlay 地图？

0.2.22 新增 DiLink 3.0 全屏仪表地图及特定 2025 领克 03／geely_fx11／Android 11 支持，贡献者结果仅限对应配置。2025 腾势 N9／OTA V1.8 布局由照片推定，仍待实车验收。 来源：[0.2.22 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.22)。

HUD 转向元数据与仪表视频地图是不同功能；前者成功不证明后者支持。按准确 DiLink、控制器和固件核对。DiLink 5.1/控制器 34 的仪表地图问题仍有反馈；不能因 Android 13 或“最新系统”就保证地图可用。原车菜单、ADB 及投影显示条件按对应车机说明。

来源：[Issue #301](https://github.com/shihabal3amri/DiPlay/issues/301)、[Issue #544](https://github.com/shihabal3amri/DiPlay/issues/544)、[官方导航说明](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/BYD_NAVIGATION.md)。

### 38. 仪表地图挡住速度，或一开地图车机重启？

挡住车速时先关闭仪表地图，确保原车速度可见；0.2.18 的 Cluster speedometer 实验针对部分支持的固件，依赖已授权网络 ADB，不默认让用户用未验证叠层替代原车车速。开地图触发重启时关当前启用的仪表地图再对照；#536 的 DiLink 4 讨论仍在确认这个关联。

来源：[Issue #423](https://github.com/shihabal3amri/DiPlay/issues/423)、[车速叠层 PR #607](https://github.com/shihabal3amri/DiPlay/pull/607)、[Issue #536](https://github.com/shihabal3amri/DiPlay/issues/536)。

### 39. 氛围灯不律动、仪表不显示歌曲，或 FCE 仪表不出箭头？

0.2.21 新增默认关闭的 BYD 原车音乐律动，需开启原车律动；旧车机的发送 16 频段选项需已授权网络 ADB。2024 唐测试与 2023 汉合成频段检查不能证明所有固件可用。 来源：[0.2.21 发布说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.21)。

原车蓝牙音乐的氛围灯/歌名与 DiPlay 的输出不是同一条路径。使用 CarPlay 音频时，支持的车机需分别启用 DiPlay 的相关功能及已有网络 ADB 权限；#538 有用户据此确认区别。FCE/Coagent T7 箭头功能在 0.2.18 是关闭默认的实验，原车属性链路有 Android Auto 确认，但新 CarPlay 集成尚未实车验收，不等同 BYD HUD 或视频地图。

来源：[Issue #538](https://github.com/shihabal3amri/DiPlay/issues/538)、[FCE 集成 PR #599](https://github.com/shihabal3amri/DiPlay/pull/599)。

## 仍没解决时

### 40. 给什么信息最能让问题一次处理清楚？

在失败后保存“设置 → 诊断 → 保存诊断报告”，注明大概时间、完整报错、连接模式、已试动作。复用已有车型、Android/DiLink/完整固件、iPhone/iOS 与准确 APK 信息；用户已经说过的不再问。Android 10+ 通常保存到 Downloads/DiPlay，旧系统按实际授权和保存提示操作，找不到时用“查看报告/分享”。完整 `.txt` 作为附件，比把日志整段粘到评论更可靠，长评论可能截断。报告不自动上传，公开前由用户查看。

先交付能做的 1–3 步，基本对照无效后才要报告；不把 ADB、验签或日志收集放在每个新手问题开头。Issue 关闭可能是重复、整理或单车确认，不自动写为普遍修复。

来源：[0.2.22 报告说明](https://github.com/shihabal3amri/DiPlay/releases/tag/v0.2.22)、[完整报告附件要求 #536](https://github.com/shihabal3amri/DiPlay/issues/536)、[版本验证边界](https://github.com/shihabal3amri/DiPlay/blob/v0.2.22/docs/VALIDATION.md)。
