RVFC是浏览器中唯一真正对齐视频帧解码与合成时序的原生接口，提供纳秒级时间戳和帧元数据，用于动作捕捉、唇动同步等精准帧对齐任务。
要实现对视频流数据的精准异步采样与分析，requestVideoFrameCallback（RVFC）是当前浏览器中唯一能真正对齐视频帧解码与合成时序的原生接口。它不依赖播放时间估算，而是由浏览器在帧提交至合成器前一刻触发，提供纳秒级精度的时间戳和帧元数据，是做动作捕捉、唇动同步、帧差检测、AI推理采样等任务的可靠时基。
确保采样时机真正“帧对齐”
RVFC 的触发时刻对应视频帧被送入合成管线的瞬间，比 timeupdate（延迟常达 200–500ms）和 requestAnimationFrame（绑定屏幕刷新率，易滞后 1–3 帧）都更贴近真实显示行为。例如在 30fps 视频中，回调稳定落在约 33ms 间隔，且 metadata.presentationTime 与 performance.timeOrigin 对齐，可用于跨媒体时间同步。
- 不要用
video.currentTime替代采样依据——它是异步更新的，可能滞后或多帧未变 - 以
metadata.presentationTime为绝对时间锚点，记录每帧处理耗时、偏差或用于插值校准 - 若需多源对齐（如麦克风音频），可用
presentationTime与audioContext.currentTime做偏移补偿
避免采样失真与丢帧的关键操作
RVFC 本身不阻塞渲染，但错误使用会直接导致采样中断或内存失控。
- 必须在回调函数末尾立即递归注册：
video.requestVideoFrameCallback(callback)，否则只执行一次 - 加防重入标记（如
isPending = false），防止异常导致重复调用注册 - 检查
video.readyState >= HAVE_CURRENT_DATA再读取帧内容，避免拿到空帧或旧帧 - 对
VideoFrame对象务必调用frame.close()，否则持续持有解码缓冲区引发内存泄漏
高效获取可分析的像素数据
RVFC 回调中拿到的是 VideoFrame 实例，默认为 YUV420 格式，不能直接用于多数图像分析库。需按需转换，但要避开主线程瓶颈：
- 优先走 GPU 路径：用 WebGL 纹理直接绑定
video元素（texImage2D支持 VIDEO 源），省去 CPU 拷贝 - 若必须转 RGBA，用
frame.copyTo(imageData.data, { format: 'rgba' })，它启用硬件加速转换，比 JS 手写 YUV→RGB 快一个数量级 - 复用
ImageData实例，避免每次新建；尺寸严格匹配frame.displayWidth / displayHeight（非video.videoWidth） - 禁止在回调中调用
canvas.getContext('2d').getImageData()或toDataURL()，这些强制同步上传会卡死下帧
兼容性兜底与降级策略
不能仅靠 "requestVideoFrameCallback" in HTMLVideoElement.prototype 判断可用性——iOS 15.4–15.6 存在“伪支持”，API 存在但永不触发。
- 实测触发：注册回调 + 200ms 超时检测，未触发则标记不可用
- 生产环境建议 fallback 组合方案：
requestAnimationFrame+video.currentTime变化速率检测（Δt getVideoPlaybackQuality() 监控丢帧 - 对 Safari 等无支持浏览器，可用
captureStream().getVideoTracks()[0].onended配合requestIdleCallback做低频抽帧分析
