HTMLVideoElement: cancelVideoFrameCallback() メソッド
Baseline 2024Newly available
Since October 2024, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
cancelVideoFrameCallback()
は HTMLVideoElement
インターフェイスのメソッドで、以前登録された映像フレームコールバックを取り消します。
構文
js
cancelVideoFrameCallback(id)
引数
id
-
数値で、取り消そうとしている映像フレームコールバックの ID を表します。これは、対応する
HTMLVideoElement.requestVideoFrameCallback
呼び出しによって返される値です。
返値
なし (undefined
)。
例
映像フレームコールバックの取り消し
この例では、以前に登録した映像フレームコールバックを取り消すために、cancelVideoFrameCallback()
を使用する方法を示しています。
js
const updateCanvas = (now, metadata) => {
// フレームで何かを行う
// ...
// 次のフレームで動作するようにコールバックを再登録する
// 動画コールバック ID を反復処理するごとに更新することが重要
// そうすることで、コールバックを正常に取り消すことができる
videoCallbackId = video.requestVideoFrameCallback(updateCanvas);
};
// 最初のフレームで実行するコールバックの初期登録
let videoCallbackId = video.requestVideoFrameCallback(updateCanvas);
// ...
// 最新の videoCallbackId を使用して映像フレームコールバックをキャンセルする
video.cancelVideoFrameCallback(videoCallbackId);
仕様書
Specification |
---|
HTMLVideoElement.requestVideoFrameCallback() # dom-htmlvideoelement-cancelvideoframecallback |
ブラウザーの互換性
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
cancelVideoFrameCallback |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- See implementation notes.
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
関連情報
<video>
要素HTMLVideoElement.requestVideoFrameCallback()
requestVideoFrameCallback()
を使用した、動画の各フレームに対する効率的な処理 (developer.chrome.com, 2023)(英語)