DiPlay 连接不上？首次连接与升级后 检查

症状

CarPlay 始终没有出现，或 DiPlay 在连接中回到首页。

可能原因

权限缺失、保存的热点信息错误、P2P API 问题和其他投屏应用冲突属于不同路径，要按失败阶段核对日志。

快速检查

1. 确认 APK 为 Android 9+，Wi-Fi Direct 为 Android 10+，关闭其他投屏应用。
2. 选择车机自带热点，打开真实车机热点并保存准确名称／密码，保持手机蓝牙与 Wi-Fi 开启。
3. 在车机蓝牙中配对，选择正确 iPhone，接受 CarPlay 提示，核对 Wi-Fi／定位／附近设备权限。
4. 用明确的数据链路尝试 USB。如果一种方式可用，记录该组合，不要把整车写成不兼容。

已有反馈与临时解决方法

0.2.0→0.2.6 循环连接先核对迁移后的热点选项及保存信息。#26 称清除应用数据可恢复，但会删除设置／配对，须先导出诊断，不能作为首选步骤。

#98 报告者转述厂商确认：该 auto_rk_t21／RK3326 固件缺少 RFCOMM 支持，安全及非安全 connect() 均超时。这是特定固件的转述证据，不能推导全部 RK3326 不兼容或全部 RK3326S 可用。该报告仅适用于所述固件，其他配置需分别测试。

版本状态

Android 10 的 getNetworkName 故障，#79 中维护者称 0.2.8 已处理；目前仅有自编译版本的复测结果，不保证全部车机在最新版本可用。

0.2.13 的变化与验证范围

0.2.13 新增依赖固件的 Android 9 Wi-Fi Direct，读取实际组凭据。Android 9 请求的信道仍未经频率验证，Android 10+ 可核对频率；清理保留系统持久配置（PR #282）。

无线优先使用可用 IPv4，以限定接口的 IPv6 回退；自动信道不保证频段或消除卡顿。接口 mDNS 不再依赖未使用的 NSD 服务；握手回退必须已有视频帧。实验性热点加入修复要求 Android 13+、用户配置的纯 5 GHz 热点、受支持 API、已授权本机 ADB，并在断开会话后明确确认（PR #251/#258/#283/#309/#313）。

插入 USB 后在同一 Activity 内切换连接，并逐项检查权限。USBMUX 对带数据回复采用限定尾部处理。缺少 Android USB 服务时无线仍可启动，有线／CH341 则需要该服务；独立的黑屏／解码器问题未解决（PR #268/#298/#300）。

APK 签名证书与 0.2.12 一致。覆盖相同包以保留设置和配对，在 0.2.13 重现问题并保存新诊断报告：Android 10+ 使用 Downloads/DiPlay，Android 9 使用文件选择器；仍可查看／分享，或回退到应用／私有目录，不自动上传。

0.2.12 的变化与待验证项

现有 Wi-Fi／同一局域网模式让车机和 iPhone 连接同一个外部网络。先在系统设置中加入网络，保存其凭据，保持蓝牙开启并关闭客户端隔离。DiPlay 不代为加入 Wi-Fi，也不改变默认路由（PR #223）。

热点启动检查实际 AP 接口，并在 AirPlay 未连接时有限重试。可选热点自动启动仍默认关闭；回退需固件支持的命令、已授权本地 ADB 和实际就绪状态，不能仅以命令执行成功判断（PR #229／#235）。

修正 Apple 设备的 USB 接入匹配。可选无障碍辅助仅确认 DiPlay 自身的系统 USB 授权弹窗，排除其他应用和弹窗；仍需正常 USB 授权（PR #170／#224）。

文件选择器或下载提供程序失败时，诊断可回退到“查看报告／分享”。确认窗口显示 Android/data/com.shihab.diplay/files/diagnostic-reports/ 或私有存储位置，不自动上传；导出改进不代表启动故障已修复（PR #185／#219）。

0.2.11 的变化与待验证项

重连采用稳定后的显示尺寸及正常就绪检查。有线 VPN 必须仅作用于 DiPlay，否则中止启动；严格匹配的 Android 10 P2P Builder 错误可在自动模式下进行一次受控恢复（PR #173／#168）。

Android 10 仅在建组前的框架 Builder 严格匹配缺失 WifiP2pConfig.getNetworkName() 签名时，允许自动模式尝试一次系统默认配置。权限失败、超时和手动信道不适用；旧报告 #15 仍需当前设备复测。

0.2.10 的变化与复查

USB 可处理有界的 USBMUX 控制回复填充；有线连接不再要求完成手动热点设置（PR #114／#130）。

无线启动可选择空闲 AirPlay 端口；Wi-Fi Direct 处理未知安全类型、繁忙信道，并在有限重试后从 5 GHz 回退到 2.4 GHz（PR #121／#143）。

无线超时（#98／#134／#137／#142）、旋转／重连（#119／#141）、音频卡顿（#131）和通话／Siri（#103／#115／#117／#138）需要 0.2.10 新日志。

相关配置反馈

以下是原始反馈配置，不是普遍受影响车型清单，未知字段仍为未知。

相关 GitHub 问题

关闭不一定代表已修复，后续进展以原始来源为准。