FFmpeg转码VP9编码WebM视频调整分辨率时如何保留Alpha透明通道

• streamio-ffmpeg 默认转码 WebM 时不会自动保留 VP9 编码的 Alpha 通道，会默认选用不带透明平面的 yuv420p 像素格式，编码过程中直接丢弃透明信息，透明区域被填充为黑色。此时文件元数据里的 ALPHA_MODE=1 属于编码器写入的无效标记，不代表实际保留了透明通道。
• 你当前生成的命令用旧版 -s 参数设置分辨率，该参数不会触发透明通道的适配逻辑，哪怕输出分辨率和源文件完全一致，只要没显式指定透明通道相关编码参数，就会出现黑底问题。

核心参数要求 #

转码带 Alpha 通道的 VP9 WebM 文件，必须显式指定三个核心配置：

• 像素格式设为 yuva420p（带Alpha透明平面的YUV编码格式）
• 给libvpx-vp9编码器传入-alpha_quality 100参数，保证透明通道编码质量
• 分辨率缩放改用scale滤镜实现，替代旧的-s参数，避免缩放环节丢失Alpha信息

可直接运行的FFmpeg命令参考 #

以1080p输入转720p输出为例，正确命令如下：

/usr/local/bin/ffmpeg -y -i part1.webm -vf "scale=1280:720:flags=lanczos" -c:v libvpx-vp9 -pix_fmt yuva420p -alpha_quality 100 -aspect 16:9 videos/movie_transparent_1280x720.webm

对应修改后的Ruby代码 #

把原代码中webm格式分支的转码参数替换为如下配置即可，注意要禁用默认的resolution选项，避免自动生成的-s参数覆盖自定义配置：

def process_alpha_transparency(output)
    render_res = []
    case @height
    when 1080..2160
        render_res.append("1920x1080", "1280x720", "852x480")
    when 720..1079
        render_res.append("1280x720", "852x480")
    when 480..719
        render_res.append("852x480")
    when 0..479
        render_res.append(@resolution)
    end

    formats = ["webm", "mov"]
    combined_time_start = Time.now

    render_res.each do |res|
        formats.each do |format|
            puts "Rendering a #{res} resolution version."
            if format == "webm"
                width, height = res.split("x")
                options = {
                    video_codec: "libvpx-vp9",
                    custom: [
                        "-vf", "scale=#{width}:#{height}:flags=lanczos",
                        "-pix_fmt", "yuva420p",
                        "-alpha_quality", "100",
                        "-aspect", "16:9"
                    ],
                    resolution: nil # 禁用默认的-s参数，改用scale滤镜控制分辨率
                }

                time_start = Time.now
                @movie.transcode("videos/#{output}_transparent_#{res}.#{format}", options)
                time_elapsed = Time.now - time_start

                puts "The resolution rendering completed in #{time_elapsed.to_i} seconds."
            end
        end
    end

    combined_elapsed_time = Time.now - combined_time_start
    puts "The process completed in #{combined_elapsed_time.to_i} seconds."
end

转码完成后不要只看ALPHA_MODE元数据，执行以下命令检查像素格式，返回yuva420p才代表透明通道真实保留：

ffprobe -v error -select_streams v:0 -show_entries stream=pix_fmt -of default=noprint_wrappers=1:nokey=1 你的输出文件路径.webm

内容的提问来源于stack exchange，提问作者Patrick Vellia