太阳娘陪你排查编码、画质与 HDR
先让 SDR 桌面串流稳定，再调整编码、HDR 和增强处理。客户端的选项代表请求，最终使用的格式还需要服务端和硬件支持；以实际性能统计和日志为准。
选择视频编码
| 格式 | 适合什么时候尝试 | 前提 |
|---|---|---|
| H.264 | 首次连接、电视盒子或兼容问题排查 | 两端普遍支持，先验证硬件解码 |
| HEVC / H.265 | 稳定连接后比较画质与带宽，或准备 HDR | 主机能编码，客户端能及时硬件解码 |
| AV1 | 两端具备相应硬件能力时做对比 | 显卡和终端支持相应编码／解码路径 |
连接后检查实际使用的编码器和解码器，确认已使用预期的硬件路径；如果格式切换后开始卡顿或黑屏，退回已验证的格式，再检查硬件能力。
客户端控制分辨率、帧率和码率；服务端负责捕获与编码。首次保留自动选择，只有确认选错 GPU 或编码器时再指定。
捕获方式
正常使用先保持默认设置。需要更改时，按目标选择并查看日志确认实际路径：
| 路径 | 适用场景 |
|---|---|
| Zako Direct | 当前版本支持时，直接捕获基地虚拟显示器 |
| Desktop Duplication | Windows 桌面捕获与兼容性回退 |
| Windows Graphics Capture（WGC） | 按版本支持捕获桌面或指定窗口 |
WGC 的窗口捕获需要用户模式，不能在 SYSTEM 服务模式下直接使用。请在桌面 GUI 中确认运行模式，再验证目标窗口能否正常捕获。AMD Display Capture 不适用于基地虚拟屏。
捕获失败时，先恢复默认／自动路径；选定窗口被关闭、最小化或权限不匹配时，也要回到 Desktop 对照测试。
开启 HDR
- 确认主机目标屏幕可以输出 HDR；使用虚拟屏时，先完成驱动和显示设置。
- 确认客户端系统、屏幕、解码器和所选应用支持对应 HDR 格式。
- 在客户端启用 HDR，服务端选择合适的 HDR 与显示策略，然后重新连接。
- 用已知支持 HDR 的内容测试，查看客户端的实际视频格式、显示状态和回退提示。
- 画面稳定后，再调整目标亮度或进行校准。
服务端显示已协商或已注入元数据，不等于终端屏幕已经按相同格式原生显示。 HDR10、HDR10+、HDR Vivid 和 Dolby Vision 的条件不同，不能因为手机支持其中一种就推断其他格式也支持。
Foundation 的配对设备设置可按当前版本使用客户端上报亮度或手动配置；需要校准时，结合目标屏幕与 Windows HDR Calibration 配置处理。先使用默认值，需要调整时采用目标屏幕自己的亮度、ICC 和黑位参数。
格式选择、场景自适应、每个配对设备的具体入口和 ICC 恢复检查见HDR、动态格式与亮度校准。
出现发灰、过曝、偏色或黑屏时，先关闭 HDR 验证 SDR，再按显示异常排查逐段定位。Dolby Vision 的开发背景可阅读技术手记。
逐项尝试增强功能
RTX HDR、DLSS NR、客户端超分和帧生成会引入额外处理与兼容条件。只启用当前安装版本明确提供、组件状态正常的选项，先用同一场景比较画面和延迟。
- Zako Direct、RTX HDR 与 DLSS NR：主机捕获、组件安装、应用默认与当前会话控制。
- PyroWave 与客户端帧生成：能力检测、实验路径、引擎导入与回退。
RTX HDR 用于将 SDR 内容转换为 HDR，不用于重复处理已有原生 HDR / HLG 输入。出现异常时先关掉新增处理，回到普通路径。实验性编码路径也应在普通串流正常后再尝试。
**Android V+ 12.13.0 的 PyroWave 限制：**该版提供 Vulkan 解码与 HDR 呈现，暂不支持 HDR10+／Dolby Vision 等动态 HDR 元数据，也不支持帧生成。需要这些功能时，选择当前客户端明确支持它们的普通路径，并确认实际输出格式。升级后可查看目标版本的发行说明了解兼容范围。
调优方法见画质设置与性能统计。