HTMLVideoElement: cancelVideoFrameCallback() メソッド
Baseline 2024
Newly 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 |
ブラウザーの互換性
BCD tables only load in the browser
関連情報
<video>
要素HTMLVideoElement.requestVideoFrameCallback()
requestVideoFrameCallback()
を使用した、動画の各フレームに対する効率的な処理 (developer.chrome.com, 2023)(英語)