Skip to main content

XblPresenceQueryFilters

傳遞給線上狀態 API 以篩選傳回之線上狀態記錄的結構。

語法

成員

deviceTypes
類型:const XblPresenceDeviceType*
裝置類型的陣列。如果此欄位為 null,則預設為所有可能的 deviceTypes。 deviceTypesCount
類型:size_t
deviceTypes 陣列的大小。 titleIds
類型:const uint32_t*
用來篩選結果的 titleIds 清單。如果輸入為空的向量,則預設為所有可能的遊戲。 titleIdsCount
類型:size_t
titleIds 陣列的大小。 detailLevel
類型:XblPresenceDetailLevel
結果的詳細程度。預設為 XblPresenceDetailLevel::Title,會取得基本的遊戲層級資訊。若要取得 Rich Presence 資訊,請設定為 XblPresenceDetailLevel::All onlineOnly
類型:bool
如果為 true,API 會篩選掉離線使用者的記錄。 broadcastingOnly
類型:bool
如果為 true,API 會篩選掉未在廣播之使用者的記錄。

備註

如果未提供篩選條件,將會使用預設值:
- 傳回所有裝置上所有可能遊戲的記錄。
- 預設為 XblPresenceDetailLevel::Default,相當於 XblPresenceDetailLevel::Title (取得基本的遊戲層級資訊)。
- 不會篩選掉離線或正在廣播的使用者。

作為下列項目的引數

XblPresenceGetPresenceForMultipleUsersAsync
XblPresenceGetPresenceForSocialGroupAsync

需求

標頭: presence_c.h

另請參閱

presence_c
Last modified on October 6, 2026