Skip to main content

XblPresenceQueryFilters

传递给状态 API 的结构,用于筛选返回的状态记录。

语法

成员

deviceTypes
类型:const XblPresenceDeviceType*
设备类型数组。如果此字段为 null,则默认为所有可能的 deviceTypes。 deviceTypesCount
类型:size_t
deviceTypes 数组的大小。 titleIds
类型:const uint32_t*
用于筛选结果的 titleId 列表。如果输入为空向量,则默认为所有可能的标题。 titleIdsCount
类型:size_t
titleIds 数组的大小。 detailLevel
类型:XblPresenceDetailLevel
结果的详细信息级别。默认为 XblPresenceDetailLevel::Title,获取基本的标题级别信息。若要获取丰富状态信息,请设置为 XblPresenceDetailLevel::All onlineOnly
类型:bool
如果为 true,API 将筛选掉处于离线状态的用户记录。 broadcastingOnly
类型:bool
如果为 true,API 将筛选掉未在进行广播的用户记录。

备注

如果未提供筛选器,将使用默认值:
- 返回所有设备上所有可能标题的记录。
- 默认为 XblPresenceDetailLevel::Default,等同于 XblPresenceDetailLevel::Title(获取基本的标题级别信息)。
- 不筛选掉处于离线状态或正在广播的用户。

用作参数

XblPresenceGetPresenceForMultipleUsersAsync
XblPresenceGetPresenceForSocialGroupAsync

要求

头文件: presence_c.h

另请参阅

presence_c
最后修改于 2026年8月13日