Yamby 4K 硬解与 HDR 播放优化

4K 播放的挑战

在手机和平板上播放 4K 视频有两个核心挑战：

• 解码压力：4K 分辨率是 1080P 的 4 倍，硬解必须到位
• 传输带宽：局域网 Gigabit 网络可以直连，公网则需要 Emby 服务端转码

Yamby 的 MPV 内核在 4K 场景下的表现明显优于系统播放器。

硬解自动检测

MPV 会在首次播放时自动检测设备硬件能力：

1. 扫描 Android MediaCodec 支持的硬解码器列表
2. 匹配视频编码格式（H.264 / H.265 HEVC / AV1 / VP9）
3. 能硬解则直接上硬解，硬解能力不足的格式自动回退软解

大部分中高端 Android 设备（骁龙 865+、天玑 1000+）都能完整硬解 H.265 编码的 4K 视频。骁龙 8 Gen 2 / 天玑 9300 及以上还支持 AV1 硬解。

HDR 片源处理

HDR（High Dynamic Range）片源（HDR10 / Dolby Vision / HDR10+）在 MPV 内核下的处理流程：

1. 读取视频流的 HDR 元数据（HDR10 的静态元数据，或 Dolby Vision 的动态元数据）
2. 自动匹配设备屏幕的 HDR 显示能力
3. 如果设备支持 HDR 显示，直接输出 HDR 画面；如果不支持，执行色调映射（Tonemapping）将 HDR 转换为 SDR

MPV 内置了多种色调映射算法（BT.2390、Hable、Reinhard），可以在设置中选择。默认的 BT.2390 适合大多数场景。

缓存与预缓冲

4K 片源数据量大，缓冲设置影响流畅度：

• 缓存大小：Yamby 设置 → 播放器 → 缓存大小，建议 256MB 或更高（默认 128MB）
• 预缓冲秒数：建议 10-15 秒，在网络不稳定时多缓冲几秒钟防止卡顿
• 网络缓冲策略：「自适应」模式下播放器会根据当前网络状况动态调整缓冲深度

播放卡顿排查

如果 4K 播放频繁卡顿，按以下顺序排查：

1. 硬解是否生效

在播放器中长按屏幕 → 播放信息 → 查看「解码方式」字段。如果显示「软件解码」而不是「硬件解码」，说明该编码格式设备不支持硬解。

2. 网络带宽是否够用

4K HEVC 片源码率通常 20-60 Mbps。局域网 Wi-Fi 5（802.11ac）千兆带宽足够，但公网访问或 5GHz 信号弱的位置可能带宽不足。可以在 Emby 服务器 Web 面板查看实时转码日志，如果服务器在转码说明带宽不够。

3. 软解 CPU 占用

如果硬解不可用、被迫软解 4K，CPU 占用会很高。可以关闭视频锐化等滤镜降低 CPU 负载。

4. 播放器内核

确认已启用 MPV 内核（而非系统播放器）。系统播放器在某些设备上 4K 软解性能很差。