> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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](/zh-TW/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent)
* [XAppCaptureMetaDataAddInt32Event](/zh-TW/reference/system/xappcapture/functions/xappcapturemetadataaddint32event)
* [XAppCaptureMetaDataAddStringEvent](/zh-TW/reference/system/xappcapture/functions/xappcapturemetadataaddstringevent)
* [XAppCaptureMetaDataStartDoubleState](/zh-TW/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate)
* [XAppCaptureMetaDataStartInt32State](/zh-TW/reference/system/xappcapture/functions/xappcapturemetadatastartint32state)
* [XAppCaptureMetadataStartStringState](/zh-TW/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate)

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

## 需求

**標頭：** XAppCapture.h

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

## 另請參閱

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


## Related topics

- [XAppCaptureMetadataPriority](/reference/system/xappcapture/enums/xappcapturemetadatapriority.md)
- [AppCaptureMetadataStartStringState](/reference/system/xappcapture/functions/xappcapturemetadatastartstringstate.md)
- [XAppCaptureMetadataAddDoubleEvent](/reference/system/xappcapture/functions/xappcapturemetadataadddoubleevent.md)
- [XAppCaptureMetadataStartDoubleState](/reference/system/xappcapture/functions/xappcapturemetadatastartdoublestate.md)
- [XAppCaptureMetadataAddInt32Event](/reference/system/xappcapture/functions/xappcapturemetadataaddint32event.md)