HTMLVideoElement：cancelVideoFrameCallback() 方法

有限可用性

此功能不是基线，因为它在一些最广泛使用的浏览器中不起作用。

cancelVideoFrameCallback() 是 HTMLVideoElement 接口的方法，它取消先前注册的视频帧回调。

语法

js
cancelVideoFrameCallback(id)

参数

id

表示要取消的视频帧回调 ID 的数字。这将是对应 HTMLVideoElement.requestVideoFrameCallback 调用返回的值。

返回值

无 (undefined).

示例

取消视频帧回调

此示例演示了如何使用 cancelVideoFrameCallback() 取消先前注册的视频帧回调。

js
const updateCanvas = (now, metadata) => {
  // Do something with the frame

  // ...

  // Re-register the callback to run on the next frame
  // It's important to update the videoCallbackId on each iteration
  // so you can cancel the callback successfully
  videoCallbackId = video.requestVideoFrameCallback(updateCanvas);
};

// Initial registration of the callback to run on the first frame
let videoCallbackId = video.requestVideoFrameCallback(updateCanvas);

// ...

// Cancel video frame callback using the latest videoCallbackId
video.cancelVideoFrameCallback(videoCallbackId);

规范

规范
HTMLVideoElement.requestVideoFrameCallback()
# dom-htmlvideoelement-cancelvideoframecallback

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参见