Agora SDK中VideoCanvas在UICollectionViewCell间异常复用问题求助

核心问题出在UICollectionView频繁reload时，Agora视频画布的视图绑定未同步更新：你用enabledVideoUIds避免重复初始化画布，但reload会生成新的单元格实例，同一个UID对应的videoView已更换，却因UID在列表中被跳过重新绑定，导致旧的videoView仍在渲染该UID的视频，新单元格的videoView无绑定，最终出现串流现象。

具体修复步骤 #

1. 移除enabledVideoUIds限制，同步更新画布视图绑定 #

每次setupVideoView时，先清空旧视图的绑定，再绑定新的videoView，确保Agora画布始终关联当前单元格的视图：

extension RealTimeAudioAgoraService: NewVoiceRoomCellsDelegate {
  func localVideoSetupWasRequested(videoView: UIView) {
    // 清空旧的本地视图绑定
    agoraKit?.setupLocalVideo(nil)
    let videoCanvas = setUpVideoView(uid: currentUserRTCServiceId, videoView: videoView)
    agoraKit?.setupLocalVideo(videoCanvas)
  }
   
  func remoteVideoSetupWasRequested(uid: UInt, videoView: UIView) {
    // 清空该UID对应的旧视图绑定
    let oldCanvas = AgoraRtcVideoCanvas()
    oldCanvas.uid = uid
    oldCanvas.view = nil
    agoraKit?.setupRemoteVideo(oldCanvas)
    
    let videoCanvas = setUpVideoView(uid: uid, videoView: videoView)
    agoraKit?.setupRemoteVideo(videoCanvas)
  }
   
  private func setUpVideoView(uid: UInt, videoView: UIView) -> AgoraRtcVideoCanvas {
    let videoCanvas = AgoraRtcVideoCanvas()
    videoCanvas.uid = uid
    videoCanvas.view = videoView
    videoCanvas.renderMode = .hidden
    return videoCanvas
  }
}

2. 维护UID与视图的映射关系（可选但推荐） #

用字典替代enabledVideoUIds，跟踪每个UID对应的当前videoView，方便后续清理和状态管理：

// 在RealTimeAudioAgoraService中添加
private var uidToVideoView: [UInt: UIView] = [:]

// 修改setUpVideoView方法
private func setUpVideoView(uid: UInt, videoView: UIView) -> AgoraRtcVideoCanvas {
  let videoCanvas = AgoraRtcVideoCanvas()
  videoCanvas.uid = uid
  videoCanvas.view = videoView
  videoCanvas.renderMode = .hidden
  
  uidToVideoView[uid] = videoView
  return videoCanvas
}

3. 处理视频静音状态的视图显示 #

静音视频时，不仅要关闭流，还要清空画布绑定或隐藏视频视图：

// 本地视频静音
func muteLocalVideo(_ isMuted: Bool) {
  agoraKit?.muteLocalVideoStream(isMuted)
  if isMuted {
    agoraKit?.setupLocalVideo(nil)
    // 同时隐藏单元格的videoView，显示头像
  }
}

// 远程视频静音
func muteRemoteVideo(uid: UInt, isMuted: Bool) {
  agoraKit?.muteRemoteVideoStream(uid, mute: isMuted)
  if isMuted {
    let oldCanvas = AgoraRtcVideoCanvas()
    oldCanvas.uid = uid
    oldCanvas.view = nil
    agoraKit?.setupRemoteVideo(oldCanvas)
    // 隐藏对应单元格的videoView
  }
}

4. 优化UICollectionView reload逻辑 #

避免全局reload，改为只更新状态变化的单元格（比如用户开启/关闭视频时，仅reload该用户的cell），减少不必要的视图重建和画布操作：

// 示例：仅刷新指定UID的单元格
func refreshCell(for uid: UInt) {
  guard let index = userList.firstIndex(where: { $0.uid == uid }) else { return }
  let indexPath = IndexPath(item: index, section: 0)
  collectionView.reloadItems(at: [indexPath])
}

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