HTMLMediaElement: seekToNextFrame() 方法
已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。
非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。
HTMLMediaElement.seekToNextFrame() 方法會非同步地將當前播放位置前進到媒體的下一幀。
警告: 此非標準方法是圍繞支援非即時媒體訪問而進行的實驗性過程的一部分,旨在用於過濾、編輯等任務。您不應該在生產程式碼中使用此方法,因為它的實現可能會在未通知的情況下發生更改,甚至被完全移除。不過,我們鼓勵您對其進行實驗。
此方法允許您在媒體不即時播放的情況下訪問影片媒體的幀。它還允許您使用幀作為查詢單位來訪問媒體,而不是使用時間碼(儘管一次只能查詢一幀,直到您找到所需的幀)。此方法可能的用途包括影片內容的過濾和編輯。
此方法會立即返回,並返回一個 Promise,該 Promise 的 fulfilled 處理程式將在查詢操作完成後被呼叫。此外,還會向感興趣的各方傳送一個 seeked 事件,告知它們已發生查詢。如果查詢失敗(因為媒體已到達最後一幀),則會發生一個 seeked 事件,緊接著是一個 ended 事件。
如果媒體元素上沒有影片,或者媒體不可查詢,則什麼也不會發生。