跳轉到主要內容

初始化 Gaming Runtime Services

XSAPI 相依於 Gaming Runtime Services (GRTS)。在呼叫任何 XSAPI 之前,請先初始化 GRTS,如下所示。

建立 XTaskQueue (選擇性)

大多數 XSAPI 都是非同步 API,需要使用工作佇列。它是用於將工作和完成工作回呼排入佇列的 API。若要深入了解 XTaskQueue 和不同的分派模式,請參閱非同步工作佇列設計。 例如,下列程式碼會使用系統執行緒集區建立工作佇列。
請確保在不再需要時,將您取得的工作佇列控制代碼釋放回系統。
如果您選擇不建立自己的工作佇列,請確保在需要佇列控制代碼時傳入 nullptr。使用 nullptr 時,工作系統預設會使用 ThreadPool。您可以呼叫 XTaskQueueSetCurrentProcessTaskQueue 來覆寫此設定。

設定 HttpClient 追蹤 (選擇性)

若要檢視其他執行階段偵錯資訊,請確保設定 HttpClient 的追蹤功能。 下列程式碼會設定 HttpClient 追蹤層級,並啟用偵錯工具資訊的輸出。

初始化 XSAPI

在呼叫任何 XSAPI 之前,請先初始化 XSAPI。

將使用者登入 XBOX 網路

大多數 XSAPI 都要求使用者先登入 XBOX 網路。 若要將使用者登入 XBOX 網路,請參閱 XUserAddAsync API 的程式碼範例。

建立 XboxLiveContext 物件

XboxLiveContext 物件代表與特定使用者相關聯的服務內容。 大多數 XSAPI 都要求您傳入代表呼叫使用者內容的 XboxLiveContextHandle。 若要建立 XBOX Live (網路) 內容,請使用 XblContextCreateHandle API,並傳入從上一個步驟取得的 XUserHandle 物件。

對 XBOX 服務進行服務呼叫

現在您已擁有與已登入使用者之 XUserHandle 物件相關聯的 XboxLiveContext 物件,就可以對 XBOX 服務進行服務呼叫。 例如,若要擷取使用者的好友清單,您可以執行下列動作:

清除 XSAPI

在任何案例中都不需要呼叫 XblCleanupAsync()。 在應用程式終止的案例中,目前沒有可以呼叫的同步 XblCleanup() API。基於其生命週期的本質,應用程式終止需要同步且立即處理。因此,會依賴應用程式處理序終止時發生的一般作業系統層級清除,這對此情況而言已足夠。 在應用程式暫停的案例中,XSAPI 會處理釋放並還原運作所需的系統資源,以在繼續後維持功能。 在您的遊戲選擇刻意釋放配置給 XSAPI 之資源的情況下,仍可使用 XblCleanupAsync()。
最後修改於 2026年10月20日