通过

XAppCaptureMetadataPriority

指定使用 AppCaptureMetadataWriter 存储的应用捕获元数据项的相对重要性。 当为累积的元数据分配的存储空间较低时，系统将使用元数据项的优先级和存在时间，以确定清除元数据来释放存储空间的顺序。

语法

enum class XAppCaptureMetadataPriority  : uint8_t  
{  
    Informational = 0,  
    Important,  
}

常量

常量 说明
信息 元数据仅供参考，在存储空间不足的情况下可能首先被删除。
重要 元数据非常重要，在存储空间不足的情况下，尽可能保存以防被删除。

备注

重要优先级意味着元数据将上传到 Xbox Live 服务。 元数据将用于帮助用户搜索剪辑或对广播加注释等等。 重要和信息元数据两者都嵌入在生成的 .mp4 文件中，因此，您不应在元数据中包含任何私有用户信息。

此时，使用这种可枚举项向元数据提供优先级值（使用以下函数设置）：

如果需要执行清除，则当确定删除哪些数据时应考虑优先级。 捕获平台将对应用程序可以添加的元数据总量施加限制，当达到此限制时，仍将记录新事件，但会删除其他事件以保持在数据约束内。 这种删除操作将根据为一些元数据提供的优先级来发生。 开发者可以通过调用 XAppCaptureMetaDataRemainingStorageBytesAvailable 来检查留下的数据量。

要求

头文件：XAppCapture.h

支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

GameDVR 概述
XAppCapture 成员
XAppCaptureMetaDataAddDoubleEvent
XAppCaptureMetaDataAddInt32Event
XAppCaptureMetaDataAddStringEvent
XAppCaptureMetaDataStartDoubleState
XAppCaptureMetaDataStartInt32State
XAppCaptureMetadataStartStringState
XAppCaptureMetaDataRemainingStorageBytesAvailable