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

# XblAchievement

> XblAchievement

# XblAchievement

代表成就，這是一種全系統的機制，可在所有遊戲中一致地引導並獎勵使用者的遊戲內動作。

## 語法

```cpp theme={null}
typedef struct XblAchievement {  
    const char* id;  
    const char* serviceConfigurationId;  
    const char* name;  
    XblAchievementTitleAssociation* titleAssociations;  
    size_t titleAssociationsCount;  
    XblAchievementProgressState progressState;  
    XblAchievementProgression progression;  
    XblAchievementMediaAsset* mediaAssets;  
    size_t mediaAssetsCount;  
    const char** platformsAvailableOn;  
    size_t platformsAvailableOnCount;  
    bool isSecret;  
    const char* unlockedDescription;  
    const char* lockedDescription;  
    const char* productId;  
    XblAchievementType type;  
    XblAchievementParticipationType participationType;  
    XblAchievementTimeWindow available;  
    XblAchievementReward* rewards;  
    size_t rewardsCount;  
    uint64_t estimatedUnlockTime;  
    const char* deepLink;  
    bool isRevoked;  
} XblAchievement  
```

### 成員

*id*\
類型：const char\*

UTF-8 編碼的成就識別碼。代表 uint。

*serviceConfigurationId*\
類型：const char\*

與成就相關聯的服務設定識別碼 (SCID)。SCID 區分大小寫，因此請直接從 Partner Center 貼上

*name*\
類型：const char\*

UTF-8 編碼的當地語系化成就名稱。

*titleAssociations*\
類型：[XblAchievementTitleAssociation\*](/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievementtitleassociation)

與成就相關聯的遊戲/應用程式。

*titleAssociationsCount*\
類型：size\_t

**titleAssociations** 的大小。

*progressState*\
類型：[XblAchievementProgressState](/zh-TW/reference/live/xsapi-c/achievements_c/enums/xblachievementprogressstate)

使用者達成此成就的進度狀態。

*progression*\
類型：[XblAchievementProgression](/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievementprogression)

包含成就進度詳細資料 (包括需求) 的進度物件。

*mediaAssets*\
類型：[XblAchievementMediaAsset\*](/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievementmediaasset)

與成就相關聯的媒體資產，例如影像識別碼。

*mediaAssetsCount*\
類型：size\_t

**mediaAssets** 的大小。

*platformsAvailableOn*\
類型：const char\*\*

提供此成就之平台的 UTF-8 編碼集合。

*platformsAvailableOnCount*\
類型：size\_t

**platformsAvailableOn** 的大小。

*isSecret*\
類型：bool

成就是否為祕密成就。

*unlockedDescription*\
類型：const char\*

已解除鎖定成就的 UTF-8 編碼描述。

*lockedDescription*\
類型：const char\*

已鎖定成就的 UTF-8 編碼描述。

*productId*\
類型：const char\*

隨成就一起發行的 UTF-8 編碼 product\_id。這是全域唯一識別碼，可能對應到應用程式、可下載內容等。

*type*\
類型：[XblAchievementType](/zh-TW/reference/live/xsapi-c/achievements_c/enums/xblachievementtype)

成就的類型，例如挑戰成就。

*participationType*\
類型：[XblAchievementParticipationType](/zh-TW/reference/live/xsapi-c/achievements_c/enums/xblachievementparticipationtype)

成就的參與類型，例如群組或個人。

*available*\
類型：[XblAchievementTimeWindow](/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievementtimewindow)

提供成就的時間範圍。適用於挑戰。

*rewards*\
類型：[XblAchievementReward\*](/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievementreward)

成就解除鎖定時玩家所獲得的獎勵集合。

*rewardsCount*\
類型：size\_t

**rewards** 的大小。

*estimatedUnlockTime*\
類型：uint64\_t

獲得成就所需的預估時間。

*deepLink*\
類型：const char\*

供用戶端使用的 UTF-8 編碼深層連結，可讓遊戲在成就所需的起點啟動。

*isRevoked*\
類型：bool

表示成就是否已因強制執行而撤銷的值。

## 作為下列項目的引數

[XblAchievementsResultGetAchievements](/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementsresultgetachievements)

## 需求

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

## 另請參閱

[achievements\_c](/zh-TW/reference/live/xsapi-c/achievements_c/achievements_c_members)


## Related topics

- [XblAchievementsResultGetAchievements](/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementsresultgetachievements.md)
- [XblAchievementProgression](/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievementprogression.md)
- [XblAchievementReward](/zh-TW/reference/live/xsapi-c/achievements_c/structs/xblachievementreward.md)
- [XblAchievementType](/zh-TW/reference/live/xsapi-c/achievements_c/enums/xblachievementtype.md)
- [XblAchievementsManagerResultGetAchievements](/zh-TW/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerresultgetachievements.md)