按故障阶段选择入口
| 症状 | 从这里开始 |
|---|---|
| 始终进不了 CarPlay | 无法连接:权限、当前方式与蓝牙配对 |
| 短暂可用后重新连接 | 反复断连:时间规律、链路交接及覆盖窗口 |
| 声音留在手机/没有导航语音 | 没有声音:区分媒体与导航路由 |
| 音乐断断续续或短暂中断 | 音频卡顿:画面负载、不同链路对照与诊断 |
| 手机充电但没有会话 | USB 失败:数据链路、权限及 iOS 组合 |
| 创建无线组时失败 | Wi-Fi Direct:Android 版本、API 错误及固件无线能力 |
保存有用的诊断信息
签名与 0.2.21 一致,覆盖 com.shihab.diplay 保留设置和配对。在 0.2.22 重现后打开设置 → 诊断 → 保存诊断报告,或在手机获取报告。Android 7.0–9 申请存储权限,Android 10+ 通常保存到 Downloads/DiPlay;分享前检查,不自动上传。保存失败时仍可查看报告或分享。
记录应用版本、车型/年款、车机/固件、Android、iPhone/iOS、有线/无线及热点/P2P 方式,以及多久发生故障。公开发布前检查日志中的标识信息。
Issue 关闭、提出 PR 或要求复测新版本,都不等于你的车辆已修复。
0.2.22 — 改善桌面悬浮球边界、汉音乐律动、设置备份/搜索及诊断;新增韩语和土耳其语,App 共十一种语言。报告记录连接原因、麦克风来源与丢弃日志,分享前检查完整保存文件。
常见问题快速处理
0.2.22 — 改善桌面悬浮球边界、汉音乐律动、设置备份/搜索及诊断;新增韩语和土耳其语,App 共十一种语言。报告记录连接原因、麦克风来源与丢弃日志,分享前检查完整保存文件。
设置 → 诊断 → 在手机获取报告可扫码或输入地址及六位码,在手机点击下载报告。输错五次后暂停手动输入,重新打开页面恢复;二维码仍可用。分享前检查报告,不自动上传。
| 问题 | 先做什么 |
|---|---|
| 解析 APK 失败怎么办? | 先比对实际 Android/API、APK 最低版本与 CPU ABI。32 位 ARM 系统不能装仅 arm64 的包。条件符合仍失败,再查实际 APK、完整报错和安装入口;多个包同错就停止盲目换包,不要求新手先验签。 |
| 一直准备 CarPlay,按哪种方式排查? | 先开 iPhone 蓝牙、Wi-Fi 和 Siri,确认 CarPlay 未被限制,选对已配对手机。车载热点要开真实热点并保存相同名称/密码;Wi-Fi Direct 要车机 P2P 支持及相关权限,不要求外部同网;现有 Wi-Fi 才要求同一局域网且可互通。无效再重配、正常重启或对照 USB。热点不能自动开时先手动开;中文名卡住可改英文并同步凭据。 |
| 拖动不跟手,可以试 60 fps 吗? | DiPlay 视频帧率为 30 fps、拖动感觉卡卡的时,可先改为 60 fps,应用并重新连接,再拖动地图或列表对照。用户亲测从 30 改到 60 后明显更跟手,具体车型/固件未知。这里调整的是 DiPlay 视频帧率,不需要改车机屏幕刷新率。若 60 fps 下画面掉帧或负载过高,再回到 30 fps、关闭 HEVC,按需降低分辨率;音乐断续另按连接与音频排查。 |
| 换车标后卡连接,或画面底部留白? | 刚换自定义车标后连不上,先恢复默认图标;0.2.18 会缩小大图。该版也提供 Square corners, no safe area 对照边缘留白,Physical length 影响 iOS 图标布局,保存后重连。黑屏先关闭 HEVC/已开的视频实验;特定设备再按对应 Issue 对照,不一律归因。 |
| 音乐周期断续怎么处理? | Wi-Fi Direct 下先对照车载热点,再 USB;支持稳定 5 GHz 时优先。缓冲增加延迟且不能补回丢包。0.2.18 修复另一类 AAC 短掉音,可按对应症状复测,不能保证解决车机 Wi-Fi 固件问题。 |
| USB 反复断开,或没有授权提示? | 先用数据口和短数据线,解锁 iPhone,接受实际 USB/CarPlay/本地 VPN 提示。重现充电或重新授权时,已有充电选项可试降低/低并重连。普通空闲读超时不等于故障;0.2.18 针对 USBMUX 取消失败等特定错误有修复。 |
| 音乐、Siri 或挂断后没有声音? | 分别测音乐、导航、Siri、通话与挂断恢复,检查实际输出、车机音源/音量和麦克风权限。声道建议按固件,不通用于所有车。Wi-Fi Direct 麦克风断续可试热点;挂断后不恢复记录通话时间,检查音频焦点。 |
| 方向盘服务一直正在启动? | 回 DiPlay 前台观察服务状态。0.2.18 增加开机及前台重试,也改进部分车机的前台上下曲;ADB 正常不等于服务已绑定。#606 在该版仍报告未修复,不承诺更新必好。前台按键与后台服务分开测试。 |
| HUD 有箭头,仪表为什么没地图? | HUD 元数据和仪表地图是不同功能,按准确 DiLink/控制器/固件核对。地图挡住车速或触发重启时先关仪表地图。0.2.18 车速叠层、FCE 导航等实验仍有验收边界,不把它们当作所有车可用。 |
| 开机不启动,回桌面后要重连? | 先手动打开验证连接,再分开检查开机打开、打开后连接、USB 唤起及后台白名单。自动开热点受固件限制。当前已开极速模式时可关闭做对照;不要默认卸载、恢复出厂或承诺绕过系统杀后台。 |
本指南相关的版本说明
完整更新、历史版本细节和验证范围已集中到版本页。点击下方对应版本可查看全部说明。