安装与连接教程

你需要准备什么

把 APK 装到车机

APK 的安装方式由车机固件决定，没有一种方法能通吃。按成功率从高到低试：

1. 车机自带浏览器直接下载安装。在车机上打开浏览器访问发布页下载 APK， 下载完成后系统通常会弹出安装确认。这是最干净的办法。
2. 下载后用文件管理器打开。把 APK 拷到车机 U 盘或内部存储， 在文件管理器里点它，按提示允许「安装未知来源应用」。
3. 车机应用商店。部分车机的应用商店收录了 DiPlay，可以直接搜到。
4. 已授权 ADB 时用命令行。ADB 是可选方案，不是运行前提：

   adb install -r DiPlay-0.2.12.apk

   只用你自己信任的电脑。手机连上这台电脑后，车机上仍需先确认授权。

授予权限

打开 DiPlay 后，系统会逐项索要权限。各权限的用途如下，拒绝某一项会直接影响对应功能：

另外：连接前请关掉其他投屏类应用，冲突会互相干扰。

无线连接：车机内置热点

这是 DiPlay 的默认推荐通道，也是多数车主日常会用得最多的方式。

关于热点自动启动（可选）

「开机自动打开热点」默认关闭。在受支持的比亚迪固件上，你可以手动开启它—— 这会通过已授权的本地 ADB验证 DiPlay 自身包名的权限。 它会保留车机已保存的热点名称和密码，「开机打开」和「打开后自动连接」是两个独立开关。

USB 有线连接

最稳的一种方式，长途高速建议用它。

1. 用 USB 数据线把 iPhone 接到车机的数据口。
2. 在 DiPlay 主界面点击 Connect with USB。
3. 手机上弹出的提示全部点确认：

• USB 访问授权
• 信任此电脑
• CarPlay 连接确认
• 本地 VPN 权限

纯充电口、纯充电线无法传输数据，因此无法工作。USB 还要求车机端口具备正确的 Host/Device 角色行为——部分车机的部分端口不支持。

Wi-Fi Direct

当车机内置热点开不出来或不稳定时，Wi-Fi Direct 是替代方案。 需要 Android 10 及以上（Android 9 上 Wi-Fi P2P 的 5 GHz 模式不可用）。

在 设置 → 连接设置 → Wi-Fi Direct → 首选信道 里可以指定下一次连接使用的 2.4 / 5 GHz 信道：

• 自动：由系统自动选择，日常就用这个。
• 指定信道：提前锁定某个受支持的信道，能避开车机上已有的站点连接占用的信道。设置只对下一次连接生效，当前会话不会被打断。

同一局域网

如果车机和 iPhone 已经连在同一个 Wi-Fi 网络下（家里的路由器、车机自己开的热点等），可以直接复用这个网络。

1. 确认车机和 iPhone 连的是同一个路由器或热点。
2. 关闭路由器的客户端隔离（也叫 AP 隔离、访客网络隔离）。开着的话两台设备互相看不见，必然连不上。
3. 在 设置 → 连接设置 里选中并保存这个网络。
4. 保持蓝牙开启，回到主界面点击连接。

设置项怎么调

怎么打开设置

在 CarPlay 界面用配置的手指数量向下滑动，或者退回 DiPlay 主界面。 手指数量在 设置 → CarPlay 控制 里选，二指、三指、四指都行，默认三指。

什么时候生效

• 会话进行中修改图标大小、分辨率、帧率：必须点 应用并重连，光选中不生效；点「取消」保留原设置。
• 未连接状态下修改：点 保存，对下一次连接生效。
• 其他设置：默认在下一次连接时生效，除非另有说明。

新手推荐配置

• 帧率 30 fps —— 降低负载，最重要的一条。
• 关闭高效视频（HEVC） —— 兼容性最好的编码，老车机尤其别开。
• 图标与文字大小：默认 —— 尺寸越小处理压力越小。
• 车机性能不足时，分辨率降到 80% 或 60%。

车辆数据模式

电池、轮速、驻车视频等控制在 设置 → 位置 → 高级车辆数据 下。 新的车机默认使用 DiLink 5.0 模式。旧版模式是可选项，采用有界只读检测， 需要已授权的网络 ADB，且只暴露已确认的字段。任何替换已保存字段的提示都要仔细阅读。 它不会开启 ADB、不写车辆设置，也不代表所有老车机都支持。

连接恢复

重装或换机后残留了旧的配对组，导致连不上时：

1. 先关掉其他投屏类应用，避免抢占。
2. 进入 设置 → 无线连接帮助 → 重置 CarPlay Wi-Fi。
3. 移除未识别的 Wi-Fi Direct 组时，DiPlay 会先向你确认。

原地更新通常比卸载重装好得多——卸载会丢掉全部设置和配对记录。

问题排查清单

APK 装不上

• 确认装的是车机，不是 iPhone。
• 确认车机系统 ≥ Android 9。
• 确认固件允许安装未知来源应用，或改用浏览器直接安装。
• 提示「签名冲突」说明已装过签名不同的版本——别急着卸载，先想想是不是装过测试版。

连上了但没画面 / 一直转圈

• 先关掉其他投屏应用。
• 执行上面的「连接恢复」。
• 帧率降到 30、关 HEVC、分辨率降一档。
• 无线改 USB 有线，排除链路问题。

卡顿、掉帧、偶尔断音

• 按上面三档降设置，再观察。
• 无线卡顿：确认热点在 5 GHz，且没有已建立的站点连接在抢信道。
• 注意「2.4 GHz 链路本身就慢」这个结论不能直接成立——干扰、固件、解码器停顿都可能是原因。
• 2023 汉 + GCC DiLink 3 曾出现 Wi-Fi 扫描抢走信道的周期性卡顿：Android 10 上 DiPlay 会在热点/P2P 会话期间暂停扫描（同一局域网模式除外）。这个改动仍需真车复测。

iPhone 离开热点后起不来

• 确认该热点已开启自动加入。
• 如果手动选中热点不弹密码就能直接起 CarPlay，请把这个区别写进诊断报告——这指向 AP 广播信息元素的问题，而非密码错误。

图标大小调了没反应

已知限制。部分 iPhone 与车机组合不会真正应用缩放后的布局。重连逻辑已经实现， 但不能保证 iPhone 采纳你请求的尺寸。

出问题时该附什么信息

在应用内导出诊断报告：

1. 更新到 v0.2.12，复现问题，并记录故障发生的时间。
2. 打开 设置 → 诊断 → 保存诊断报告。
3. Android 10+ 通常保存到 Downloads/DiPlay；Android 9 走文件选择器。
4. 如果存储或选择器都不可用，备用路径是 Android/data/com.shihab.diplay/files/diagnostic-reports/，确认弹窗会显示准确路径。外部存储也不可用时报告会私有保存。这两种备用方式都提供查看和分享。
5. 打开 TXT 检查内容，删掉密码和隐私信息。报告不会自动上传。
6. 附到对应的 issue，或 新建问题 ↗。