> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# presence_c

> presence_c

# presence\_c

## 函数

| 函数 | 说明 |
| - | - |
| [XblPresenceAddDevicePresenceChangedHandler](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresenceadddevicepresencechangedhandler.md) | 注册设备状态更改通知的事件处理程序。仅对使用 [XblPresenceTrackUsers](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencetrackusers.md) 配置的用户接收通知。 |
| [XblPresenceAddTitlePresenceChangedHandler](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresenceaddtitlepresencechangedhandler.md) | 注册标题状态更改通知的事件处理程序。仅对分别使用 [XblPresenceTrackUsers](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencetrackusers.md) 和 [XblPresenceTrackAdditionalTitles](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencetrackadditionaltitles.md) 配置的用户和标题接收通知。 |
| [XblPresenceDevicePresenceChangedHandler](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencedevicepresencechangedhandler.md) | 设备状态更改通知的事件处理程序。 |
| [XblPresenceGetPresenceAsync](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceasync.md) | 获取特定 XBOX 用户 ID 的状态信息。 |
| [XblPresenceGetPresenceForMultipleUsersAsync](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersasync.md) | 获取多个用户的状态信息。 |
| [XblPresenceGetPresenceForMultipleUsersResult](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersresult.md) | 获取 XblPresenceGetPresenceForMultipleUsers 调用的结果。 |
| [XblPresenceGetPresenceForMultipleUsersResultCount](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceformultipleusersresultcount.md) | 获取 XblPresenceGetPresenceForMultipleUsersAsync 调用的结果计数。 |
| [XblPresenceGetPresenceForSocialGroupAsync](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md) | 获取特定用户组的状态信息。 |
| [XblPresenceGetPresenceForSocialGroupResult](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresult.md) | 获取 XblPresenceGetPresenceForSocialGroup 调用的结果。 |
| [XblPresenceGetPresenceForSocialGroupResultCount](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupresultcount.md) | 获取 XblPresenceGetPresenceForSocialGroupAsync 调用的结果计数。 |
| [XblPresenceGetPresenceResult](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceresult.md) | 获取 XblPresenceGetPresenceAsync 调用的结果。 |
| [XblPresenceRecordCloseHandle](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencerecordclosehandle.md) | 关闭 XblPresenceRecordHandle。 |
| [XblPresenceRecordDuplicateHandle](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencerecordduplicatehandle.md) | 复制 XblPresenceRecordHandle。 |
| [XblPresenceRecordGetDeviceRecords](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencerecordgetdevicerecords.md) | 获取与返回的状态记录关联的设备状态记录。 |
| [XblPresenceRecordGetUserState](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencerecordgetuserstate.md) | 获取状态记录的全局状态。 |
| [XblPresenceRecordGetXuid](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencerecordgetxuid.md) | 获取与状态记录关联的用户的 Xuid。 |
| [XblPresenceRemoveDevicePresenceChangedHandler](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresenceremovedevicepresencechangedhandler.md) | 取消注册设备状态更改通知的事件处理程序。 |
| [XblPresenceRemoveTitlePresenceChangedHandler](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresenceremovetitlepresencechangedhandler.md) | 取消注册标题状态更改通知的事件处理程序。 |
| [XblPresenceSetPresenceAsync](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencesetpresenceasync.md) | 设置当前用户上下文的状态信息。 |
| [XblPresenceStopTrackingAdditionalTitles](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencestoptrackingadditionaltitles.md) | 配置将跟踪实时标题状态的标题列表。将不再接收指定标题的标题状态更新。 |
| [XblPresenceStopTrackingUsers](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencestoptrackingusers.md) | 配置将跟踪其实时设备和标题状态更新的用户列表。将不再接收指定用户的状态更新。 |
| [XblPresenceTitlePresenceChangedHandler](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencetitlepresencechangedhandler.md) | 标题状态更改通知的事件处理程序。 |
| [XblPresenceTrackAdditionalTitles](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencetrackadditionaltitles.md) | 配置将跟踪实时标题状态的标题列表。若要接收当前标题以外的标题的标题状态更新，必须使用此 API 添加这些标题。 |
| [XblPresenceTrackUsers](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencetrackusers.md) | 配置将跟踪其实时设备和标题状态更新的用户列表。 |

## 结构

| 结构 | 说明 |
| - | - |
| [XblPresenceBroadcastRecord](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/structs/xblpresencebroadcastrecord.md) | 用户正在广播内容的广播信息。 |
| [XblPresenceDeviceRecord](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/structs/xblpresencedevicerecord.md) | 定义表示 xbl 状态设备记录的值。 |
| [XblPresenceQueryFilters](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/structs/xblpresencequeryfilters.md) | 传递给状态 API 的结构，用于筛选返回的状态记录。 |
| [XblPresenceRichPresenceIds](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/structs/xblpresencerichpresenceids.md) | 设置丰富状态所需的 ID。 |
| [XblPresenceTitleRecord](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/structs/xblpresencetitlerecord.md) | 定义表示 xbl 状态标题记录的值。 |

## 句柄

| 句柄 | 说明 |
| - | - |
| [XblPresenceRecordHandle](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/handles/xblpresencerecordhandle) | 指向 xbl 状态记录的句柄。 |

## 枚举

| 枚举 | 说明 |
| - | - |
| [XblPresenceBroadcastProvider](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/enums/xblpresencebroadcastprovider.md) | 定义表示流媒体提供商的值。 |
| [XblPresenceDetailLevel](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/enums/xblpresencedetaillevel.md) | 定义用于设置从服务返回的状态详细信息级别的值。选择适当的详细信息级别有助于提高 API 性能。 |
| [XblPresenceDeviceType](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/enums/xblpresencedevicetype.md) | 定义用于指示与 XblSocialManagerPresenceTitleRecord 关联的设备类型的值。 |
| [XblPresenceMediaIdType](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/enums/xblpresencemediaidtype.md) | 定义用于指示媒体状态数据的媒体 ID 类型的值。 |
| [XblPresenceTitleState](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/enums/xblpresencetitlestate.md) | 定义用于指示用户标题状态的值。 |
| [XblPresenceTitleViewState](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/enums/xblpresencetitleviewstate.md) | 定义用于指示状态信息屏幕视图状态的值。 |
| [XblPresenceUserState](https://devdocs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/enums/xblpresenceuserstate.md) | 定义用于指示用户相对于状态服务的状态的值。 |


## Related topics

- [XblPresenceGetPresenceAsync](https://devdocs.xbox.com/fr-CA/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceasync.md)
- [XblPresenceSetPresenceAsync](https://devdocs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencesetpresenceasync.md)
- [XblPresenceGetPresenceResult](https://devdocs.xbox.com/fr-CA/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceresult.md)
- [XblPresenceRichPresenceIds](https://devdocs.xbox.com/reference/live/xsapi-c/presence_c/structs/xblpresencerichpresenceids.md)
