Skip to main content
Microsoft Game Development Kit (GDK) 包含一組 API,可用於廣播通知、顯示 廣播 UI、將中繼資料新增至螢幕擷取畫面、影片短片和 廣播,以及擷取診斷用螢幕擷取畫面和影片。廣播 通知可讓您深入了解廣播管線。廣播 UI 讓使用者能夠控制廣播的開始和停止。新增中繼資料可讓搜尋錄製內容變得更容易,例如新增地圖名稱、遊戲中的關卡,或有關所擷取之特定時刻的任何資訊。結合使用時,這些 API 可讓您更好地 控制及深入了解您的螢幕擷取畫面、影片短片和廣播。

廣播通知與 UI

XAppBroadcastGetStatus 會顯示廣播狀態的狀態更新。使用此方法可判斷廣播是否可以開始。判斷廣播是否可以開始涉及許多因素,例如確保擷取資源可用、遊戲是否允許廣播,或使用者和/或系統是否未停用廣播。如果 XAppBroadcastStatus 結構的所有成員 (canStartBroadcast 除外) 都傳回 false,canStartBroadcast 就會傳回 true。如果廣播可以開始,請呼叫 XAppBroadcastShowUI 為 目前使用者顯示廣播 UI。之後,使用者必須手動起始廣播。XAppBroadcastIsAppBroadcasting 用來判斷 目前的應用程式是否正在廣播。XAppBroadcastUnregisterIsAppBroadcasting 用來取消註冊廣播狀態的變更事件。

將中繼資料新增至螢幕擷取畫面、影片短片和廣播

有數個 API 可用來新增和管理附加至 螢幕擷取畫面、影片短片或廣播的中繼資料。新增中繼資料是選擇性的。不過,它 可讓使用者更容易找到他們想要的錄製內容。中繼資料可以 採用多種形式,例如字串、整數、雙精確度浮點數。系統會為中繼資料項目配置儲存空間。如果配置的空間不足,系統會使用 AppCaptureMetatPriority 來判斷所儲存中繼資料項目的相對 優先順序,以及清除中繼資料以釋放空間的順序。

語音聊天

語音聊天應視為使用者產生的內容,其中可能包含個人識別資訊或其他潛在的敏感資料。因此,使用者在遊戲聊天中轉譯的語音絕不應包含在任何錄製的短片或遊戲擷取中。若要做到這一點,可以將適當的音訊類別 AudioCategory_GameChat 指派給包含使用者語音的轉譯串流。這會據此標記該串流,讓系統知道在擷取 Game DVR 短片時要忽略此音訊串流。

診斷用螢幕擷取畫面和影片短片

使用這些 Microsoft Game Development Kit (GDK) API,您可以擷取螢幕擷取畫面和影片短片 以供診斷之用。請注意,這些診斷 API 僅適用於開發套件。在零售主機上呼叫這些 API 會立即失敗。擷取的螢幕擷取畫面和影片短片會存放到 本機遊戲分割區,而不是一般的使用者儲存體。如果遊戲 以高動態範圍 (HDR) 執行,呼叫者可以指定要擷取標準動態範圍 (SDR) 螢幕擷取畫面、HDR 螢幕擷取畫面,或兩者都擷取。錄製 螢幕擷取畫面後,產生的結構會包含有關螢幕擷取畫面檔案位置的路徑 資訊。對於影片 短片,視使用者的 Game DVR 設定而定,可能會傳回 H264 (進階視訊編碼 (AVC)) 編碼的 影片或 H265 (高效率視訊編碼 (HEVC)) 編碼的影片。產生的結構 也包含開始時間、持續時間以及寬度和高度等資訊。

一般螢幕擷取畫面

Microsoft Game Development Kit (GDK) 新增了擷取一般螢幕擷取畫面的功能。產生的螢幕擷取畫面會儲存在一般使用者儲存體中存放 螢幕擷取畫面的位置。此外,系統通知會指出已擷取 螢幕擷取畫面。由於螢幕擷取畫面儲存在無法 從遊戲分割區直接存取的個別分割區中,您必須使用提供的 開啟/讀取/關閉串流 API 來存取錄製的螢幕擷取畫面。請注意, 如果遊戲以 HDR 執行,則會傳回螢幕擷取畫面的 SDR 版本和 HDR 版本的路徑。

參考 API 文件

另請參閱

XAppCapture
Last modified on October 6, 2026