DiPlay 0.2.17 · PSA 车机版(beta 测试渠道)
这是 PSA 线的 beta 渠道,从
psa-beta分支发布,包名com.shihab.diplay.psabeta
(可与正式包com.shihab.diplay共存安装),发版 tag 走v0.2.17-beta-<run>,
与正式渠道的v0.2.12-<run>互不可见(在线更新各自只看自己的命名空间)。
每次发版同时创建v0.2.15-beta-/v0.2.12-beta-别名 release,旧版本也能自动更新。
正式渠道的包请到v0.2.12-的 release 下载。本版基于上游 0.2.17 合并(在 0.2.15 基础上新增:USB 充电电流选择、FPS 计数器、
麦克风 Opus 软件编码、音乐预缓冲欠载恢复、视频低延迟解码、仪表盘卡片 1% 滑块、
设置页内联搜索、BYD 氛围灯/通话弹窗/方控音量/平台21 等实验性功能)。
但有线与无线连接全部保留本线自己实车验证过的实现,未采用上游版本——
上游的连接实现在 Android 7 上有已知问题。
Android 7.1.2(API 25)/ Qualcomm msm8953 车机上的 CarPlay 接收端。
本页是当前整体状态页,每次发布前更新。
✅ 可用
连接
- 有线 CarPlay(VPN/NCM 通路):设备发现、重枚举、配对、NCM 数据通路、MFi 认证、
0x4300/0x4301、出画面(Video: first frame rendered)、音频(audioType=media)全部正常。 - 无线 CarPlay —— 三种模式都可用,按车机条件任选:
- Wi-Fi Direct:✅ 可用。车机自建 P2P 组,iPhone 直连,不依赖车机热点。
API 25 上信道由系统选择(见「已知限制」)。 - 车载自建热点:✅ 可用。走车机自己的热点,需要车机 Wi-Fi 开关打开。
- 外置 Wi-Fi / 同一局域网:✅ 可用。车机与 iPhone 连同一个网络。
- Wi-Fi Direct:✅ 可用。车机自建 P2P 组,iPhone 直连,不依赖车机热点。
功能
- 方向盘方控:
- S01:通道 A(
car.meter.music.BROADCAST的 JSON)—— 实测正确。 - T03:通道 B(
com.leapmotor.customkey.music.pauseplay的整数 extras)—— 可用。
- S01:通道 A(
- 方控音频归属:焦点与 MediaSession 已拿到,原厂播放器会让出方控。
- 媒体信息投送:曲名 / 艺术家 / 封面经 MediaSession 提供给车机仪表等读取方。
- 氛围灯(零跑) 🆕:设置 →「氛围灯」。开关灯、随音乐流光(频谱 → RGB 多色)、
颜色(31 色 / 专辑取色)、速度、亮度、分区。走车机自己的
leapmotor.carapp.CARCANCONTROL广播(appCAN=Atmos_ctrl),与VehicleSetting.apk同协议;
本渠道(beta)由构建时写死为零跑通路,不启用 BYD 的 ADB 通路。 - USB 权限弹窗:
MANAGE_USB+ 无障碍按内容判定自动确认。 - 界面汉化、零跑档位识别、倒车暂停、iOS 27 视频车内播放(N 挡门控)。
- 在线更新(首页快捷设置下方 → 在线更新):检查 GitHub 上的新构建 → 下载 → 安装。
- CarPlay 应用列表里那个「回到原车」的图标按钮,名称与图标都是零跑。
- 中控屏上的仪表盘地图(悬浮卡片):窗口类型按 SDK 分支,API < 26 降级
TYPE_PHONE;
画面取自 stream 111(仪表盘流)。 - 设置页:分类 + 侧栏 + 搜索(上游 0.2.14 结构);本线自有的「与嘟嘟桌面共享实时界面」
在高级组、紧跟仪表盘地图;「方控学习」在车辆组、紧跟方向盘按键;「在线更新」在首页。
⚠️ 已知限制
- Wi-Fi Direct 在 API 25 上无法指定信道:
WifiP2pGroup.getFrequency()与带 config 的
createGroup都是 API 29 才有的,所以信道由系统选择。升到 Android 10 以上才能手动指定。 - CI 不再跑 lint 与单元测试,只出 release 包。改运行时代码时请手动跑一次
python D:\Launcher\kotlin_static_check.py <改动的 .kt 文件>。 - APK 必须带
arm64-v8a:为某个 native 库钉 ABI 会把整个进程变成 32 位,
而 32 位会打挂车载热点。CI 里已加断言。 - 开无线 CarPlay 时车机自身没有网络(msm8953 单射频,不支持 STA+GO 并发)。
- 无线握手完成后会尝试把 iAP2 从蓝牙引导通道切到隧道通道;若隧道未就绪会
wireless handoff fallback ... preserving AirPlay,AirPlay 与画面不受影响。 - 本版升级会更换发版 tag 命名空间(
v0.2.15-beta-→v0.2.17-beta-):
CI 会同时为v0.2.15-beta-/v0.2.12-beta-创建别名 release,故旧 beta 包仍能自动发现本版。 - 大版本升级建议卸载后重装(残留状态可能影响首次连接)。
复测判据
方向盘方控(S01 / T03 都适用):
- 起会话时应看到
media keys listening on 9 car actions(通道 A 侧)
与car bus listening on 2 extra wheel channels(通道 B 侧)。 - 按一次「下一首」,应出现恰好一行
media key source=<通道> action=nextOne -> CarPlay 4 sent=true。 - 若某台车无反应:看
media key extra-channel unmatched action=... extras=[...]
—— 这行会把该车机真正发的 extras 全量列出来。
氛围灯(零跑,需车辆通电):
- 设置 →「氛围灯」→ 打开「启用」,点「保存」应直接通过(零跑通路不做 ADB 支持性探测)。
- 报告里应出现
DiPlay-Ambient: leapmotor applied=<n> sw=0 auto=1 deg=<d> r=<r> g=<g> b=<b>
(sw=0/auto=1即自动档;随音乐时deg/r/g/b随频谱变化)。 - 关掉「启用」后应出现
leapmotor restored to auto,车机回到自身自动氛围灯。
无线连接成功时报告里应出现:
- Wi-Fi Direct:
wireless hotspot backend=Wi-Fi P2P iface=p2p0→
wireless Bonjour services started mode=interface iface=p2p0→AirPlay session active - 车载热点:
wireless hotspot backend=Manual hotspot→AirPlay session active - 出画面:
Video: first frame rendered - 悬浮卡片:
Centre map: card shown streamActive=true(流应为 111 / dashboard stream)
装包说明
- 包名
com.shihab.diplay.psabeta(beta 渠道),平台签名。 - 诊断报告第一行带真实版本名(
DiPlay 0.2.17(NN-sha)-beta),贴日志前先核对这一行。
本次改动
修复 shared/build.gradle 的 Groovy 语法
上一提交误把 Kotlin 写法(val + if 表达式)写进了 Groovy 构建脚本,
导致 CI 在解析 shared/build.gradle 时就失败(Unexpected input: '{' @ line 4)。
改为 Groovy 三元表达式:
def lampChannel = System.getenv('DIPLAY_CHANNEL') == 'beta' ? 'LEAPMOTOR_BROADCAST' : 'BYD_ADB'
buildConfigField 'String', 'AMBIENT_LAMP_CHANNEL', "${lampChannel}"
行为不变:仍按构建渠道写死氛围灯通路。