GPUCommandEncoder：writeTimestamp() 方法

安全上下文： 此功能僅在安全上下文（HTTPS）中可用，且支援此功能的瀏覽器數量有限。

已棄用：此特性不再推薦。雖然某些瀏覽器可能仍然支援它，但它可能已經從相關的網路標準中刪除，可能正在刪除過程中，或者可能僅為相容性目的而保留。請避免使用它，如果可能，請更新現有程式碼；請參閱本頁底部的相容性表格以指導您的決策。請注意，此特性可能隨時停止工作。

非標準：此特性未標準化。我們不建議在生產環境中使用非標準特性，因為它們瀏覽器支援有限，並且可能會更改或被移除。但是，在沒有標準選項的特定情況下，它們可以是合適的替代方案。

注意：此功能在 Web Workers 中可用。

GPUCommandEncoder 介面的 writeTimestamp() 方法會編碼一條命令，該命令會在由 GPU 執行完同一佇列中的 GPUCommandBuffer 中已記錄的先前命令後，將一個時間戳寫入 GPUQuerySet。

注意： 要使用時間戳查詢，必須在 GPUDevice 中啟用 timestamp-query 功能。

語法

writeTimestamp(querySet, queryIndex)

呼叫 writeTimestamp() 時必須滿足以下條件，否則將生成 GPUValidationError，並且 GPUCommandEncoder 將失效。

// …

const querySet = device.createQuerySet({
  type: "timestamp",
  count: 32,
});

// …

commandEncoder.writeTimestamp(querySet, 0);

// …

此頁面最後修改於 2025年4月28日，由 MDN 貢獻者修改。