迁移至VLCJ-4.8.2后视频亮度等参数调整失效求助

问题描述 #

将Java应用从vlcj-3.12.1迁移至vlcj-4.8.2后，视频亮度、对比度、饱和度、色调及伽马值调整全部失效。已在修改参数前启用视频调整功能，且在播放开始、视频输出可用后调用相关方法；尝试过先调用setAdjustVideo(false)再重新设为true，仍无效果。

奇怪的是，所有测试的.avi文件均可正常调整参数，起初以为是视频编码问题，但原生VLC播放器对所有视频格式都能正常应用设置，因此问题应出在vlcj或自身代码中。

运行环境：vlcj-4.8.2、VLC 3.0.17.4（最新版）、Windows 10、Java 17.0.5

示例代码 #

float myBrightness = 2.0f;
vlcPlayer.video().setAdjustVideo(true);
vlcPlayer.video().setBrightness(myBrightness);

VLC原生错误日志（翻译后） #

main debug: 寻找匹配"any"的视频转换器模块：48个候选
d3d11_filters warning: 无可用上下文
d3d11_filters debug: D3D11无纹理的不透明模式
d3d11_filters warning: 无可用上下文
d3d11_filters debug: D3D11无纹理的不透明模式
chain error: 递归级别过高(3)
chain error: 递归级别过高(3)
main debug: 无匹配的视频转换器模块
main error: 无法创建视频转换器
main debug: 移除模块"swscale"
main debug: 滤镜000002080bf802a0已从链中移除
chain debug: 尝试使用I422色彩空间作为中间格式

VLCJ 4.x迁移关键注意事项及解决方案 #

• 硬件加速冲突：VLCJ4默认倾向使用D3D11硬件加速输出，而视频调整滤镜在硬件加速模式下可能无法正常加载。可以强制禁用D3D11，改用软件渲染：

  MediaPlayerFactory factory = new MediaPlayerFactory(
      "--no-video-d3d11",
      "--swscale-mode=sw"
  );
  

• 事件监听时机：必须确保在视频输出完全就绪后再执行参数调整，建议监听VideoOutputEvent的videoOutputAvailable回调，而非仅依赖播放开始事件：

  vlcPlayer.events().addMediaPlayerEventListener(new MediaPlayerEventAdapter() {
      @Override
      public void videoOutputAvailable(MediaPlayer mediaPlayer, boolean available) {
          if (available) {
              mediaPlayer.video().setAdjustVideo(true);
              mediaPlayer.video().setBrightness(2.0f);
          }
      }
  });
  

• 滤镜初始化逻辑：VLCJ4对滤镜链的初始化更严格，尝试先设置参数再启用调整，或者启用后重新触发：

  // 先设参数再启用
  vlcPlayer.video().setBrightness(2.0f);
  vlcPlayer.video().setAdjustVideo(true);
  
  // 或启用后重新触发
  vlcPlayer.video().setAdjustVideo(true);
  vlcPlayer.video().setBrightness(2.0f);
  vlcPlayer.video().setAdjustVideo(true);
  

• 色彩空间适配：非AVI文件可能使用特殊色彩空间，导致滤镜链递归错误。可以强制指定色彩空间：

  MediaPlayerFactory factory = new MediaPlayerFactory("--video-chroma=I420");
  

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