Skip to main content

XAppCaptureMetadataPriority

指定使用 AppCaptureMetadataWriter 儲存之應用程式擷取中繼資料項目的相對重要性。當配置給累積中繼資料的儲存空間不足時,系統會使用中繼資料項目的優先順序和存在時間,來決定清除中繼資料以釋放儲存空間的順序。

語法

常數

備註

Important 優先順序表示中繼資料會上傳至 XBOX Live 服務。中繼資料將用於協助使用者搜尋剪輯或為廣播加上註解等用途。Important 和 Informational 中繼資料都會內嵌在產生的 .mp4 檔案中,因此您不應在中繼資料中包含任何私人使用者資訊。 此列舉用於在使用下列函式設定中繼資料時,為其指定優先順序值: 接著,在需要清除時,系統會將優先順序納入考量,以決定要刪除哪些資料。擷取平台會限制應用程式可新增的中繼資料總量;達到此限制時,仍會記錄新事件,但會刪除其他事件以維持在資料限制內。此刪除作業會根據為部分中繼資料指定的優先順序層級進行。開發人員可以呼叫 XAppCaptureMetaDataRemainingStorageBytesAvailable 來檢查剩餘的資料量。

需求

標頭: XAppCapture.h 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

另請參閱

GameDVR 概觀
XAppCapture 成員
XAppCaptureMetaDataAddDoubleEvent
XAppCaptureMetaDataAddInt32Event
XAppCaptureMetaDataAddStringEvent
XAppCaptureMetaDataStartDoubleState
XAppCaptureMetaDataStartInt32State
XAppCaptureMetadataStartStringState
XAppCaptureMetaDataRemainingStorageBytesAvailable
Last modified on October 6, 2026