Qt 5.15 Windows平台MediaPlayer播放视频色彩褪色失真求助

问题描述 #

在Windows系统上使用Qt 5.15，通过QML的MediaPlayer和VideoOutput播放视频时，画面色彩苍白、褪色，不符合原视频效果。

视频参数：

Video: MPEG4 Video (H264) 9300x606 30fps 51614kbps [V: Mainconcept Video Media Handler [eng] (h264 main L5.1, yuv420p, 9300x606, 51614 kb/s)]

原视频（右侧）与播放效果（左侧）对比：

测试视频为Pexels平台的实验室设备特写视频，使用的QML代码如下：

import QtQuick 2.9
import QtMultimedia 5.15

Item {
    id: idRoot
    width: 4096
    height: 2160

    MediaPlayer {
        id: idMediaPlayer
        playbackRate: 0
        source: "../assets/test2.mp4"
        videoOutput: idVideoOutput
        autoPlay: true
        loops: MediaPlayer.Infinite
    }


    VideoOutput {
        id: idVideoOutput
        width: idRoot.width
        height: idRoot.height
        fillMode: VideoOutput.PreserveAspectCrop
        source: idMediaPlayer
        autoOrientation: false
        flushMode: VideoOutput.FirstFrame
    }
}

疑问点：

• 是否需要添加shader转换为RGB？为何需要这么做？
• 是否需要转换视频编码？

问题原因与解决方案 #

核心原因：色彩空间转换缺失 #

这确实是色彩空间不匹配导致的问题。你的视频是yuv420p格式，属于YUV色彩空间（亮度与色度分离存储），而Qt 5.15在Windows平台的VideoOutput组件默认没有正确处理YUV到RGB的色彩空间转换——尤其是缺少了BT.709（高清视频标准色域）的色彩校正步骤，直接把YUV数据转成RGB后，色彩饱和度被压低，就会显得苍白褪色。

解决方案1：自定义Shader补全色彩转换 #

不需要转视频编码，直接给VideoOutput加个自定义GLSL shader，补全YUV到RGB的正确转换逻辑就行。Qt 5.15支持在VideoOutput中嵌入ShaderEffect，以下是修改后的代码：

import QtQuick 2.9
import QtMultimedia 5.15

Item {
    id: idRoot
    width: 4096
    height: 2160

    MediaPlayer {
        id: idMediaPlayer
        playbackRate: 0
        source: "../assets/test2.mp4"
        videoOutput: idVideoOutput
        autoPlay: true
        loops: MediaPlayer.Infinite
    }

    VideoOutput {
        id: idVideoOutput
        width: idRoot.width
        height: idRoot.height
        fillMode: VideoOutput.PreserveAspectCrop
        source: idMediaPlayer
        autoOrientation: false
        flushMode: VideoOutput.FirstFrame

        shaderEffect: ShaderEffect {
            fragmentShader: "
                uniform sampler2D source;
                varying vec2 qt_TexCoord0;

                void main() {
                    vec4 yuv = texture2D(source, qt_TexCoord0);
                    // 针对BT.709色域的YUV420转RGB公式（适配你的高清H264视频）
                    float r = 1.164383 * (yuv.y - 0.0625) + 1.792741 * (yuv.w - 0.5);
                    float g = 1.164383 * (yuv.y - 0.0625) - 0.213249 * (yuv.z - 0.5) - 0.532909 * (yuv.w - 0.5);
                    float b = 1.164383 * (yuv.y - 0.0625) + 2.112402 * (yuv.z - 0.5);
                    gl_FragColor = vec4(r, g, b, yuv.x);
                }
            "
        }
    }
}

• 这个shader会按照BT.709高清标准把YUV数据转换成正确的RGB色彩，补上Qt默认缺失的校正环节，色彩就能恢复正常。
• 如果是标清视频，把公式换成BT.601的转换参数即可。

解决方案2：升级Qt版本（可选） #

Qt 5.15之后的Qt 6.x版本对Windows多媒体模块做了大幅优化，修复了很多色彩空间相关的bug。如果你的项目允许升级到Qt 6.2及以上版本，大概率不用写额外代码就能正常显示视频色彩。

无需转换视频编码 #

转换视频编码既费时间又会损失画质，完全没必要。只要解决色彩空间转换的问题，就能让视频色彩恢复正常。

内容的提问来源于stack exchange，提问作者Alia Khalifa