UE4.27 CPP项目Spectator客户端播放视频崩溃问题求助

问题本质 #

崩溃源于视频样本接收队列VideoSampleSinks的大小超过了引擎内置的FMediaPlayerQueueDepths::MaxVideoSinkDepth阈值，核心是视频帧生成速度远快于渲染消费速度，导致队列积压溢出。

可行解决办法 #

1. 调高队列深度阈值 #

• 配置文件修改：在项目DefaultEngine.ini中添加以下配置，直接覆盖默认阈值（默认一般是32，可根据实际情况调到64或128）：

  [/Script/MediaUtils.MediaPlayer]
  MaxVideoSinkDepth=64
  

• C++代码动态设置：在初始化MediaPlayer时直接调整参数：

  if (UMediaPlayer* MediaPlayer = YourSpectatorMediaPlayer)
  {
      MediaPlayer->MaxVideoSinkDepth = 64;
  }
  

2. 优化帧消费速度 #

• 确保Spectator的视频渲染组件（如UMediaTexture、UMediaPlane）每帧都能及时处理视频帧，避免UI阻塞、线程调度延迟拖慢消费节奏。
• 当Spectator不在视野内或非活跃时，暂停视频播放，或者降低视频分辨率/帧率，减少帧生成量。

3. 修复帧同步逻辑 #

• 所有MediaPlayer的控制操作（播放、暂停、跳转）必须在游戏主线程执行，避免跨线程操作导致队列消费不及时。
• 绑定帧就绪回调，按需触发渲染，减少无效缓存：

  // 绑定视频帧就绪回调
  YourMediaPlayer->OnMediaFrameReady.AddDynamic(this, &YourSpectatorClass::OnVideoFrameReady);
  
  void YourSpectatorClass::OnVideoFrameReady(EMediaTrackType TrackType)
  {
      if (TrackType == EMediaTrackType::Video)
      {
          YourMediaTexture->UpdateResource();
      }
  }
  

4. 引擎源码临时调整（应急用） #

如果以上方法都无效，且暂时无法升级引擎，可临时修改引擎代码规避崩溃（不推荐，会影响后续引擎升级）：

• 找到Engine/Source/Runtime/MediaUtils/Private/MediaPlayerFacade.cpp第2629行，将断言改为警告并丢弃溢出帧：

  // 原断言代码
  // checkf(bOk, TEXT("VideoSampleSinks queue overflow"));
  // 修改为
  if (!bOk)
  {
      UE_LOG(LogMediaUtils, Warning, TEXT("VideoSampleSinks queue overflow, dropping frame"));
      return;
  }
  

5. 更换视频编码格式 #

改用硬件加速支持更好的视频格式（如硬件编码的H.264），降低CPU解码负担，提升帧处理效率，从根源减少队列积压。

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