> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XAppCaptureMetadataPriority

> XAppCaptureMetadataPriority

# XAppCaptureMetadataPriority

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

## 语法

```cpp theme={null}
enum class XAppCaptureMetadataPriority  : uint8_t  
{  
    Informational = 0,  
    Important,  
}  
```

## 常量

| 常量 | 说明 |
| - | - |
| Informational | 元数据为信息性数据，在存储不足时可能会被优先删除。 |
| Important | 元数据为重要数据，在存储不足时会尽可能避免被删除。 |

## 备注

Important 优先级意味着元数据将被上传到 XBOX Live 服务。该元数据可用于帮助用户搜索片段或为直播添加注释等。Important 和 Informational 两种元数据都会嵌入到生成的 .mp4 文件中，因此不应在元数据中包含任何私人用户信息。

在通过以下函数设置元数据时，可使用此枚举为元数据赋予优先级值：

* [XAppCaptureMetaDataAddDoubleEvent](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md)
* [XAppCaptureMetaDataAddInt32Event](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)
* [XAppCaptureMetaDataAddStringEvent](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)
* [XAppCaptureMetaDataStartDoubleState](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md)
* [XAppCaptureMetaDataStartInt32State](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)
* [XAppCaptureMetadataStartStringState](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)

当需要执行清除操作时，系统会考虑此优先级来决定要删除哪些数据。捕获平台会对应用程序可添加的元数据总量施加限制，达到此限制后仍会记录新事件，但为满足数据约束会删除其他事件。此删除操作将根据分配给某些元数据的优先级来进行。开发者可通过调用 [XAppCaptureMetaDataRemainingStorageBytesAvailable](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable.md) 来检查剩余的数据量。

## 要求

**头文件：** XAppCapture.h

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 另请参阅

[GameDVR 概览](https://docs.xbox.com/zh-CN/build/console-features/game-dvr/gamedvr-broadcast.md)\
[XAppCapture 成员](https://docs.xbox.com/zh-CN/reference/system/xappcapture/xappcapture_members.md)\
[XAppCaptureMetaDataAddDoubleEvent](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md)\
[XAppCaptureMetaDataAddInt32Event](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)\
[XAppCaptureMetaDataAddStringEvent](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)\
[XAppCaptureMetaDataStartDoubleState](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md)\
[XAppCaptureMetaDataStartInt32State](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)\
[XAppCaptureMetadataStartStringState](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)\
[XAppCaptureMetaDataRemainingStorageBytesAvailable](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable.md)


## Related topics

- [XAppCaptureMetadataAddDoubleEvent](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md)
- [XAppCaptureMetadataStartDoubleState](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md)
- [XAppCaptureMetadataAddInt32Event](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)
- [XAppCaptureMetadataStartInt32State](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)
- [XAppCaptureMetadataAddStringEvent](https://docs.xbox.com/zh-CN/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)