Moonlight-TV项目HDR流媒体色彩失真问题分析与解决方案

问题背景

在Moonlight-TV项目的使用过程中，部分LG OLED电视用户（如C2/C1型号）通过WebOS客户端进行HDR流媒体传输时，出现了明显的色彩失真现象。主要表现为黄色和绿色饱和度严重不足，肤色呈现不自然的绿色调，红色显示为橙色，整体画面呈现"褪色"效果。值得注意的是，该问题仅出现在WebOS客户端，Android/iOS设备及直接HDMI连接均表现正常。

技术分析

色彩空间处理机制

经过深入排查，发现问题根源在于WebOS系统对HDR信号中色彩空间的自动识别机制存在缺陷。当通过Moonlight进行流媒体传输时：

1. 系统未能正确识别BT.2020色彩空间（HDR标准色彩空间）
2. 错误地应用了BT.709色彩空间（SDR标准色彩空间）处理HDR内容
3. 导致色彩映射关系完全错位

验证过程

技术团队通过以下方式验证了该假设：

1. 对比HDMI直连与流媒体传输的画面差异
2. 利用LG电视的工程菜单（1113111组合键进入）手动切换色彩空间
3. 确认强制使用BT.709时，画面失真与流媒体问题完全一致

解决方案

核心修复

开发团队在NDL_DIRECTVIDEO_HDR_INFO_T数据结构中新增了关键字段，明确指定了以下HDR元数据：

1. 色彩原色坐标（Red/Green/Blue Primary）
2. 白点坐标（White Point）
3. 最大/最小亮度值（Max/Min Luminance）
4. 色彩空间标识（Color Space）

技术实现细节

改进后的实现确保WebOS系统能够：

1. 正确识别输入的HDR信号特性
2. 应用适当的色彩转换矩阵
3. 保持从编码到显示的端到端色彩管理一致性

用户影响

正向反馈

多数用户报告修复后：

• 色彩还原准确度显著提升
• 黄色/绿色饱和度恢复正常
• 肤色呈现自然
• 整体画面动态范围达到预期

注意事项

少数用户升级后出现色彩过饱和现象，可能原因包括：

1. 主机端HDR配置方式差异
2. 电视图像模式设置冲突
3. 不同型号OLED面板的特性差异

建议遇到此类情况的用户：

1. 检查电视的图像模式设置
2. 确认主机端HDR配置标准
3. 必要时创建新的问题报告并提供详细配置信息

技术启示

本案例揭示了流媒体传输中色彩管理的重要性，特别是在跨平台、跨设备场景下：

1. 必须明确传递完整的色彩元数据
2. 不同设备对标准实现的差异需要特别处理
3. 工程菜单等高级工具在问题诊断中的价值
4. 社区协作对解决复杂技术问题的重要性

该解决方案不仅修复了Moonlight-TV的具体问题，也为其他流媒体应用的HDR实现提供了有价值的参考。