> ## 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.

# XblPresenceRichPresenceIds

> XblPresenceRichPresenceIds

# XblPresenceRichPresenceIds

設定 Rich Presence 所需的識別碼。

## 語法

```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]

包含線上狀態字串之服務設定的識別碼。

*presenceId*\
類型：const char\*

在服務設定中定義的線上狀態字串識別碼。例如，PresenceId = "1" 在服務設定中可能等於 "Playing {0} on {1}"。服務設定可能會將權杖 0 對應至 Maps，並將權杖 1 對應至 MapId。

*presenceTokenIds*\
類型：const char\*\*

用來取代線上狀態字串中所找到之格式字串權杖的字串識別碼。這些字串也定義於服務設定中。集合中的識別碼值會對應至與 PresenceId 中所找到之權杖引數相關聯的字串。例如，假設此向量檢視包含值 "4" 和 "1"，且 PresenceId = "1" 在服務設定中等於 "Playing {0} on {1}"。服務設定可能會對應權杖 0 = Maps，其中 MapId = "4" 等於 "Hometown"。服務設定可能會對應權杖 1 = Difficulty，其中 DifficultyId = "1" 等於 "Casual"。

*presenceTokenIdsCount*\
類型：size\_t

presenceTokenIds 陣列中的識別碼數目。

## 作為下列項目的引數

[XblPresenceSetPresenceAsync](/zh-TW/reference/live/xsapi-c/presence_c/functions/xblpresencesetpresenceasync)

## 需求

**標頭：** presence\_c.h

## 另請參閱

[presence\_c](/zh-TW/reference/live/xsapi-c/presence_c/presence_c_members)


## Related topics

- [XblPresenceSetPresenceAsync](/zh-TW/reference/live/xsapi-c/presence_c/functions/xblpresencesetpresenceasync.md)
- [透過 XSAPI C 更新使用者的線上狀態](/zh-TW/services/xbox-services/community/presence/how-to/live-updating-user-presence.md)
- [XblSocialManagerSetRichPresencePollingStatus](/zh-TW/reference/live/xsapi-c/social_manager_c/functions/xblsocialmanagersetrichpresencepollingstatus.md)
- [Rich Presence](/zh-TW/services/xbox-services/community/presence/live-presence-nav.md)
- [Rich Presence 概念](/zh-TW/services/xbox-services/community/presence/concepts/live-presence-concepts-nav.md)