> ## 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-TW/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md)
* [XAppCaptureMetaDataAddInt32Event](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)
* [XAppCaptureMetaDataAddStringEvent](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent.md)
* [XAppCaptureMetaDataStartDoubleState](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md)
* [XAppCaptureMetaDataStartInt32State](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcapturemetadatastartint32state.md)
* [XAppCaptureMetadataStartStringState](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)

接著，在需要清除時，系統會將優先順序納入考量，以決定要刪除哪些資料。擷取平台會限制應用程式可新增的中繼資料總量；達到此限制時，仍會記錄新事件，但會刪除其他事件以維持在資料限制內。此刪除作業會根據為部分中繼資料指定的優先順序層級進行。開發人員可以呼叫 [XAppCaptureMetaDataRemainingStorageBytesAvailable](https://docs.xbox.com/zh-TW/reference/system/xappcapture/functions/xappcapturemetadataremainingstoragebytesavailable.md) 來檢查剩餘的資料量。

## 需求

**標頭：** XAppCapture.h

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 另請參閱

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


## Related topics

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