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

# XblPresenceRichPresenceIds

> XblPresenceRichPresenceIds

# XblPresenceRichPresenceIds

设置丰富状态所需的 ID。

## 语法

```cpp theme={null}
typedef struct XblPresenceRichPresenceIds {  
    char scid[XBL_SCID_LENGTH];  
    const char* presenceId;  
    const char** presenceTokenIds;  
    size_t presenceTokenIdsCount;  
} XblPresenceRichPresenceIds  
```

### 成员

*scid*\
类型：char\[XBL\_SCID\_LENGTH]

包含状态字符串的服务配置的 ID。

*presenceId*\
类型：const char\*

在服务配置中定义的状态字符串的 ID。例如，PresenceId = “1” 可能等同于服务配置中的 “Playing 0 on 1”。服务配置可能将令牌 0 映射到 Maps，将令牌 1 映射到 MapId。

*presenceTokenIds*\
类型：const char\*\*

用于替换在状态字符串中找到的格式字符串令牌的字符串的 ID。这些字符串也在服务配置中定义。集合中的 ID 值映射到与 PresenceId 中找到的令牌参数相关联的字符串。例如，假设此向量视图包含值 “4” 和 “1”，且 PresenceId = “1” 在服务配置中等同于 “Playing 0 on 1”。服务配置可能将令牌 0 映射为 Maps，其中 MapId = “4” 等同于 “Hometown”。服务配置可能将令牌 1 映射为 Difficulty，其中 DifficultyId = “1” 等同于 “Casual”。

*presenceTokenIdsCount*\
类型：size\_t

presenceTokenIds 数组中的 ID 数量。

## 用作参数

[XblPresenceSetPresenceAsync](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencesetpresenceasync.md)

## 要求

**头文件：** presence\_c.h

## 另请参阅

[presence\_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/presence_c_members.md)


## Related topics

- [presence_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/presence_c_members.md)
- [XblPresenceSetPresenceAsync](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/presence_c/functions/xblpresencesetpresenceasync.md)
- [通过 XSAPI C 更新用户的在线状态](https://docs.xbox.com/zh-CN/services/xbox-services/community/presence/how-to/live-updating-user-presence.md)
- [XblSocialManagerSetRichPresencePollingStatus](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagersetrichpresencepollingstatus.md)
- [Presence](https://docs.xbox.com/zh-CN/services/xbox-services/community/presence/index.md)