presence_c

枚举

枚举 说明
XblPresenceBroadcastProvider 定义表示流提供程序的值。
XblPresenceDetailLevel 定义用于设置从服务返回的状态详细信息的级别的值。 选择适当的详细级别可以帮助提高 API 的性能。
XblPresenceDeviceType 定义用于指示与 XblSocialManagerPresenceTitleRecord 关联的设备类型的值。
XblPresenceMediaIdType 定义用于指示媒体状态数据的媒体 ID 类型的值。
XblPresenceTitleState 定义用于指示用户的游戏状态的值。
XblPresenceTitleViewState 定义用于指示状态信息的屏幕视图状态的值。
XblPresenceUserState 定义用于指示与状态服务有关的用户的状态的值。

函数

函数 说明
XblPresenceAddDevicePresenceChangedHandler 注册用于设备状态更改通知的事件处理程序。 仅有配置 XblPresenceTrackUsers 的用户才会收到通知。
XblPresenceAddTitlePresenceChangedHandler 注册用于游戏状态更改通知的事件处理程序。 仅有分别配置为 XblPresenceTrackUsersXblPresenceTrackAdditionalTitles 的用户和游戏会收到通知。
XblPresenceDevicePresenceChangedHandler 用于设备状态更改通知的事件处理程序。
XblPresenceGetPresenceAsync 获取特定 Xbox 用户 ID 的状态信息。
XblPresenceGetPresenceForMultipleUsersAsync 获取多个用户的状态信息。
XblPresenceGetPresenceForMultipleUsersResult 获取 XblPresenceGetPresenceForMultipleUsers 调用的结果。
XblPresenceGetPresenceForMultipleUsersResultCount 获取 XblPresenceGetPresenceForMultipleUsersAsync 调用的计数。
XblPresenceGetPresenceForSocialGroupAsync 获取特定用户组的状态信息。
XblPresenceGetPresenceForSocialGroupResult 获取 XblPresenceGetPresenceForSocialGroup 调用的结果。
XblPresenceGetPresenceForSocialGroupResultCount 获取 XblPresenceGetPresenceForSocialGroupAsync 调用的结果计数。
XblPresenceGetPresenceResult 获取 XblPresenceGetPresenceAsync 调用的结果。
XblPresenceRecordCloseHandle 关闭 XblPresenceRecordHandle。
XblPresenceRecordDuplicateHandle 复制 XblPresenceRecordHandle。
XblPresenceRecordGetDeviceRecords 获取与返回的状态记录关联的设备状态记录。
XblPresenceRecordGetUserState 获取状态记录的全局状态。
XblPresenceRecordGetXuid 获取状态记录关联的用户的 Xuid。
XblPresenceRemoveDevicePresenceChangedHandler 取消注册用于设备状态更改通知的事件处理程序。
XblPresenceRemoveTitlePresenceChangedHandler 取消注册用于游戏状态更改通知的事件处理程序。
XblPresenceSetPresenceAsync 设置当前用户上下文的状态信息。
XblPresenceStopTrackingAdditionalTitles 配置要跟踪实施游戏状态的游戏列表。 不再接收指定游戏的游戏状态更新。
XblPresenceStopTrackingUsers 配置要跟踪实时设备和游戏状态更新的用户的列表。 将不再接收指定用户的状态更新。
XblPresenceSubscribeToDevicePresenceChange 订阅设备状态更改通知。 已弃用。 此 API 将继续有效,但在未来的版本中会将其删除。 单个 RTA 订阅将由 XSAPI 通过 XblPresenceTrackUsers 跟踪用户而自动管理。
XblPresenceSubscribeToTitlePresenceChange 订阅游戏状态更改通知。 已弃用。 此 API 会未来的版本中删除。 单个 RTA 订阅将由 XSAPI 自动管理,因为可以使用 XblPresenceTrackAdditionalTitles 跟踪游戏。
XblPresenceTitlePresenceChangedHandler 用于游戏状态更改通知的事件处理程序。
XblPresenceTrackAdditionalTitles 配置要跟踪实施游戏状态的游戏列表。 若要接收非当前游戏的游戏状态更新,必须使用此 API 添加这些游戏。
XblPresenceTrackUsers 配置要跟踪实时设备和游戏状态更新的用户的列表。
XblPresenceUnsubscribeFromDevicePresenceChange 取消订阅以前创建的设备状态更改订阅。 已弃用。 此 API 将继续有效,但在未来的版本中会将其删除。 单个 RTA 订阅将由 XSAPI 自动管理,因为没有使用 XblPresenceStopTrackingUsers 跟踪玩家。
XblPresenceUnsubscribeFromTitlePresenceChange 取消订阅以前创建的游戏状态更改订阅。 已弃用。 此 API 会未来的版本中删除。 单个 RTA 订阅将由 XSAPI 自动管理,因为没有使用 XblPresenceStopTrackingAdditionalTitles 跟踪游戏。

句柄

句柄 说明
XblPresenceRecordHandle xbl 状态记录的句柄。

结构

结构 说明
XblPresenceBroadcastRecord 用户所广播内容的广播信息。
XblPresenceDeviceRecord 定义表示 xbl 状态设备记录的值。
XblPresenceQueryFilters 传递给状态 API 用于筛选返回的状态记录的结构。
XblPresenceRichPresenceIds 需要设置丰富状态的 ID。
XblPresenceTitleRecord 定义表示 xbl 状态游戏记录的值。