功能特性详解
这一页把 DiPlay 的每一项能力拆开讲：它能做什么、在什么条件下有效、 以及哪些地方受固件限制还不能保证。把「已支持」和「有条件支持」分清楚， 比把功能列表写满更有用。
DiPlay 是公开预览版，未经 Apple 官方认证。 它使用的实验性配件身份是从公开固件中提取出来的，无法保证未来持续可用。 下面标注为「需固件支持」「需授权 ADB」「仍需真车复测」的条目， 请理解成「不是所有车机都能用」，而不是「一定可用」。
有线与无线 CarPlay
核心能力本身。两条链路都在车机侧完成，App 装在车机上，iPhone 作为发送端。
四种连接通道
| 通道 | 要求 | 特点 |
|---|---|---|
| 车机内置热点 | Android 9+ | 默认推荐。能选 5 GHz 就优先，带宽更高 |
| USB 有线 | Android 9+ | 最稳，带宽与延迟最优；需数据线与数据口 |
| Wi-Fi Direct | Android 10+ | 可指定信道；射频可能拒绝指定值 |
| 同一局域网 | Android 9+ | 复用已有网络；需关闭路由器客户端隔离 |
Apple USB 改进
0.2.12 起，应用匹配默认自动处理，多数情况下不需要手动选 App； USB 权限的自动确认也做成可选开关。第一次连接时的信任与本地 VPN 授权仍需手动确认一次。
Android 10 上的 Wi-Fi 扫描优化
在热点 / P2P 会话期间，DiPlay 会在已授权 ADB 且框架事务可用时 暂停连接扫描，避免扫描把射频拉离 CarPlay 信道。 同一局域网模式除外——那里要保持扫描可用， 否则路由器重连和漫游会受影响。
这套生命周期管理需要停车状态下的真车复测才能确认有效。 另外，强行停止应用可能导致扫描恢复被延后，直到你再次打开应用。 缺少授权或事务支持时，DiPlay 不会去动扫描。
虚拟 / 悬浮地图
没有独立仪表屏的车机可以用这个：DiPlay 会提供一个 16:9 的虚拟地图画面，浮在中控上方，等效一块小仪表屏。
- 授予使用情况访问权限后，地图可以在切换到其他应用时自动隐藏，避免和别的界面打架。
- 支持分屏与桌面卡片两种呈现方式。
- 优化了低矮屏幕上的准备界面——中控条很矮的车机能正常显示。
中控屏上方还有一条细长区域的车机（很多轿车都是这种布局）， 把导航指引放在那里比放中控更顺眼。有独立仪表屏的车机请优先用 转向卡片 或原生仪表地图。
转向卡片
在仪表区域显示一个精简的转向提示卡片。这不是 DiPlay 自己画的导航， 而是配合 仪表原生地图一起工作的显示层。
可自定义项
- 卡片大小可调
- 透明度可调
- 到达信息可自定义
- 仪表原生地图与转向卡片之间实时切换
触发逻辑
转向卡片只在歌曲变化时显示，不喧宾夺主。 封面切换也比以前稳定；缺少封面时显示中性占位图，而不是空白或错位。
DiLink 3 / 4 与 HUD
DiLink 3 / 4 的集成仍需真车复测； 尚未验证的 DiLink 4 HUD 输出依然保持禁用状态。 下面描述的是当前代码里的能力边界，不是已验证的支持承诺。
DiLink 5（默认）
新车机的显示路由不需要外部 ADB 启动器， 默认模式就是 DiLink 5.0。 HUD 与街道名、车机热点已在开发车上确认可用， Wi-Fi Direct 有改善，偶发音频中断仍然存在。
DiLink 4（可选）
- 可选的仪表路由与校准
- 支持原厂地图的暂停与恢复
- 需要已授权的 ADB 与固件侧支持
- HUD 歌曲 / 歌词功能保留现有已验证固件的校验限制——未经验证的 DiLink 4 HUD 输出仍禁用
DiLink 3（可选）
- 支持仪表指引与地图
- 加入了恢复机制，仪表路由失败时不容易卡死
- 依赖固件支持
方向盘与 CarPlay 主屏控制
- 可选的方向盘仪表地图缩放
- 支持 CarPlay 主屏的旋钮式操作（中控旋钮控制 CarPlay 界面）
具体的固件版本适用范围、地图元数据要求、设置项与清理行为，
写在仓库的 docs/BYD_NAVIGATION.md（近 35 KB，内容很全）。
本页只做概览，请以该文档为准。
显示与性能调节
外观：跟随系统或锁定
外观可以跟随系统 / 光线传感器自动切换昼夜， 也可以固定为日间或夜间模式。跟车机的自动大灯逻辑保持一致，观感更统一。
分辨率：30% – 160%
主屏分辨率可以在 30–160% 范围内按 1% 调整。这给了很细的调节空间：
- 车机性能吃紧 → 降到 60% 或 80%
- 想要更清晰 → 逐步往上加，直到帧率崩掉再退一档
- 分辨率越高，系统负载越大，更高分辨率会带来更高负载
解码能力检查
DiPlay 可以检查当前车机的解码能力，用来判断 60 fps 或 HEVC 到底能不能扛得住，而不是让你盲试。
实时画质参数
- 亮度
- 对比度
- 饱和度
- 色温
这四项可以实时调节，不用重启会话——用来匹配车机屏幕本身的色偏，比改全局设置更精准。
编码：H.264 与 HEVC
默认使用 H.264。开启 HEVC（高效视频）能降低码率， 但对车机解码能力要求更高。官方明确建议先关闭 HEVC， 兼容性最好，尤其是老车机。
界面与音频控制
- 会话内设置 —— 不必退回主界面就能调，滑动手势呼出。
- 本地或 USB/CH341 认证选择 —— 按你实际连的硬件选。
- 状态栏与导航栏可独立控制 —— 中控自带的系统栏挡视线时单独关掉。
- 返回投屏界面后自动刷新连接设置 —— 改完设置切回去就能看到新状态。
- 多通道音频映射 —— 语音、导航、音乐多通道输出并映射到 Android 对应通道。
- 全屏模式 —— 隐藏车机系统栏，只留 CarPlay。
- 右侧驾驶布局 —— 把 CarPlay 控件放近驾驶员一侧。
车辆数据模式
位置回传、电池电量、轮速、驻车视频等控制在 设置 → 位置 → 高级车辆数据下。
| 模式 | 说明 |
|---|---|
| DiLink 5.0 | 默认模式。新车机直接用，无需额外授权 |
| 旧版模式 | 可选。采用有界只读检测，需要已授权的网络 ADB， 只暴露已确认存在的字段。替换已保存字段时会弹出提示，务必逐条阅读 |
旧版模式不会开启 ADB、不会写入车辆设置，也不代表所有老车机都支持。 这是读取显示类数据的便利功能，不是解锁车辆能力的工具。
诊断报告
设置 → 诊断 → 保存诊断报告。生成一份 TXT，把问题卡在哪一步写清楚。
保存位置
- Android 10 及以上：通常
Downloads/DiPlay - Android 9：通过文件选择器保存
- 存储不可用：
Android/data/com.shihab.diplay/files/diagnostic-reports/ - 外部存储也不可用：私有保存
后两种备用方式都提供查看与分享。
记录了什么
- 请求频率与实际频率
- 站点关联状态
- 回退失败情况
- 记忆配置相关事件
- 无线、媒体、主题、应用退出记录（用于定位失败阶段）
不包含 Wi-Fi 凭据与协议载荷；报告不会自动上传，你自己看过、删掉隐私信息后再决定是否提交。 提交前永远不要包含热点密码。
想知道 0.2.12 具体改了什么？
完整更新日志、已知限制和仍未解决的问题都在这里