iOS Swift中如何通过ReplayKit仅获取视频流及缓冲问题排查

看起来你遇到的核心问题是ReplayKit的回调持续触发，但大部分rpSampleType不是你想要的视频类型，我来帮你一步步排查和解决：

1. 最可能的原因：iOS版本适配问题 #

从iOS 14开始，Apple把原来的RPSampleBufferType.video拆分成了两个更细分的枚举值：

• RPSampleBufferType.videoApp：捕获当前应用内的视频内容
• RPSampleBufferType.videoScreen：捕获整个屏幕的视频内容（比如多任务场景下的其他应用）

你的代码只判断了旧的.video类型，在iOS 14+的设备上会直接走到default分支，导致你误以为返回的是非预期类型。

2. 修改后的代码（兼容全版本） #

我们需要针对iOS版本做适配，同时可以禁用音频捕获来减少无关回调：

import ReplayKit

// 先检查录制可用性
if RPScreenRecorder.shared().isAvailable {
    RPScreenRecorder.shared().startCapture(
        audioEnabled: false, // 禁用音频，只捕获视频
        handler: { (cmSampleBuffer, rpSampleType, error) in
            // 优先处理捕获错误
            if let error = error {
                print("Capture error: \(error.localizedDescription)")
                return
            }
            
            guard CMSampleBufferDataIsReady(cmSampleBuffer) else {
                print("Sample buffer not ready")
                return
            }
            
            // 适配iOS版本的视频类型判断
            let isVideoSample: Bool
            if #available(iOS 14.0, *) {
                isVideoSample = rpSampleType == .videoApp || rpSampleType == .videoScreen
            } else {
                isVideoSample = rpSampleType == .video
            }
            
            if isVideoSample {
                guard let pixelBuffer = CMSampleBufferGetImageBuffer(cmSampleBuffer) else {
                    print("Failed to get pixel buffer from sample")
                    return
                }
                let rtcpixelBuffer = RTCCVPixelBuffer(pixelBuffer: pixelBuffer)
                // 注意：回调在后台线程执行，若涉及UI操作必须切换到主线程
                DispatchQueue.main.async {
                    // 这里添加你的后续处理逻辑，比如传递给WebRTC或更新预览
                }
            }
            // 非视频类型直接忽略，无需打印日志干扰调试
        },
        completionHandler: { (error) in
            if let error = error {
                print("Start capture failed: \(error.localizedDescription)")
            } else {
                print("Capture started successfully")
            }
        }
    )
} else {
    print("Screen recording is not available on this device")
}

3. 额外注意事项 #

• 线程安全：ReplayKit的回调默认在后台串行队列触发，如果你后续要处理UI操作（比如显示视频预览），一定要用DispatchQueue.main.async切换到主线程。
• 权限配置：确保你已经在Info.plist中添加了NSMicrophoneUsageDescription（即使禁用音频，部分iOS版本仍需该描述避免权限异常）。
• 资源清理：记得在不需要录制时调用RPScreenRecorder.shared().stopCapture()，避免内存泄漏或不必要的系统资源占用。

内容的提问来源于stack exchange，提问作者Sai Kumar Jonnadula