企业官网建设流程全解析

Open Headunit VideoDecoder重启策略源码解读：SYNC_STALL看门狗设计

【免费下载链接】open-headunitHeadunit App for displaying Android Auto项目地址: https://gitcode.com/GitHub_Trending/he/open-headunit

Open Headunit 是一款开源车载中控（Head Unit）应用，可以把闲置的安卓平板或手机变成 Android Auto 车机屏幕，实时解码并渲染手机投来的 H.264 / H.265 视频流。由于车机多为低端硬件，视频解码器随时可能卡死导致黑屏、卡帧，Open Headunit 的 VideoDecoder 因此内置了一套 SYNC_STALL 看门狗与多级重启策略。本文带你读懂这套"2 秒发现真卡死、只在该重启时重启、永不无限循环"的完整设计。

为什么车机投屏容易"假卡死"？

车机 SoC 性能有限，MediaCodec 解码时会出现三种"长时间不出画面"的场景，而它们里只有一种真正需要重启：

1. 手机侧空闲：Android Auto 屏幕静止时停止发送视频数据——不是故障；
2. 关键帧饥饿：解码器中途重建后，从 P 帧恢复渲染，必须等到下一个 IDR 关键帧才能出画面，而 Android Auto 的关键帧周期约 69 秒——此时重建反而重置等待，越重启越黑屏；
3. 真实卡死：输入字节持续流入、却没有任何画面输出——这才是需要强制重启的解码器故障。

实测数据（源码注释中记录）：在 UNISOC MT50 上，旧逻辑曾 33 秒内盲目重建 4 次，耗尽重启预算，之后 10~60 秒持续rendered=0，黑屏直到会话结束。SYNC_STALL 看门狗正是为终结这种恶性循环而设计的。

看门狗四大参数：2秒 / 8秒 / 60秒 / 4次

四个常量集中定义在 VideoDecoder.kt：

为什么需要独立的冷却与上限？解码器还有另一条"无帧重启"阶梯（连续 3 次重启未渲染出任何画面即触发编解码器类型回退），但它只统计"一帧都没出"的重启。一台边缘性能设备——能出画面、只是偶尔慢——会轻松绕过这条阶梯，如果看门狗不单独设限，就会在临界硬件上无限重建 MediaCodec，形成和重启预算无关的死循环。

一个被实测喂出来的细节：中途重建的解码器"暖机"可能很慢（MT50 上从重建到首帧最长约 8 秒），而正常出画面后的会话重建会享受 10 秒宽限期WARM_RECONFIGURE_FIRST_FRAME_GRACE_MS（见 VideoDecoder.kt）。冷启动则保持 2 秒短窗口，保证真正死亡的组件快速失败。

三分类裁决：不该重启的绝不重启

检测到"2 秒无输出"后，DecoderStallCausePolicy.kt 的classify()会先做一次三向归因（纯函数，无时钟无日志，便于单测）：

• PHONE_IDLE（手机空闲）：2 秒内没有收到任何输入字节 → 手机只是停了流。此时刷新时间戳、保持沉默——这条分支曾误报"重启被抑制"，让一整轮硬件排查被"0/4 used"的日志误导；
• STARVED_OF_KEYFRAME（关键帧饥饿）：输入在流、但该解码器实例从未"解码出"一个关键帧 → 不重建，改为通过释放/重获焦点这一协议唯一杠杆请求关键帧（请求节奏由 VideoRecoveryPolicy.kt 节流），最多等待 15 秒KEYFRAME_STARVATION_PATIENCE_MS才升级回普通重建路径；
• STALLED（真卡死）：输入持续到达、关键帧也解出过、却无输出 → 进入看门狗重启流程。

一个容易踩坑的判定：关键帧必须以"解码器输出端真的解出了"为准，而非"喂进去了"。中途丢包的关键帧头部仍带参数集，扫描时会伪装成关键帧，却解不出任何画面——若按"喂入"计数，饥饿路径会被打回重建循环（配套追踪器见 KeyframeRepairTracker.kt）。

重启阶梯：从"重建"到"换编解码器"再到"认输"

裁决为 STALLED 后（检测主循环见 VideoDecoder.kt）：

1. 冷却期未满或已用满 4 次→ 不重启，但每 10 秒节流打一条"重启被抑制"日志——否则耗尽重启预算后仍在卡死的解码器，日志会和完全健康的解码器一模一样，无从分辨；
2. 冷却期已过且未超限→syncStallRestartCount++，调用scheduleRestart("sync_stall")（见 VideoDecoder.kt）：只置一个标志位，由下一次decode()入口统一停掉旧 MediaCodec 并重建，避免跨线程销毁；
3. 无帧重启阶梯：若某次重建连一帧都没渲染出，restartsSinceLastFrame+1（统计规则由 DecoderRestartPolicy.kt 裁决），连续 3 次即触发 H.264 ↔ H.265 的一次性编解码器类型回退；两种编码都失败则decoderPermanentlyFailed = true，彻底停止重启，避免无限循环。

仓库还内置了 1920×1080 的彩色屏幕测试图，重启后肉眼核对车机出画面是否正常：

核心源码地图

小结

SYNC_STALL 看门狗的设计哲学可以浓缩为三句话：用输入字节流区分"手机停了"与"解码器死了"；用冷却 + 上限 + 复位窗口给每次重启装上限，让边缘硬件不会拖垮整个会话；用节流日志保证"不行动"本身也留下证据。这套"先归因、再设限、最后兜底"的阶梯式恢复思路，对任何要做播放器自愈的开发者都是很好的参考。

【免费下载链接】open-headunitHeadunit App for displaying Android Auto项目地址: https://gitcode.com/GitHub_Trending/he/open-headunit