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
最后修改于 2026年8月24日