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

# XblAchievementUnlockEvent

> XblAchievementUnlockEvent

# XblAchievementUnlockEvent

代表從通知服務收到的成就解除鎖定通知。

## 語法

```cpp theme={null}
typedef struct XblAchievementUnlockEvent {  
    const char* achievementName;  
    const char* achievementDescription;  
    const char* achievementIcon;  
    const char* achievementId;  
    uint64_t gamerscore;  
    uint32_t titleId;  
    uint64_t xboxUserId;  
    const char* deepLink;  
    float rarityPercentage;  
    XblAchievementRarityCategory rarityCategory;  
    time_t timeUnlocked;  
} XblAchievementUnlockEvent  
```

### 成員

*achievementName*\
類型：const char\*

以接收端 DeviceEndpoint 地區設定表示的成就名稱 (目前字元限制：44)。

*achievementDescription*\
類型：const char\*

以接收端 DeviceEndpoint 地區設定表示的成就描述。

*achievementIcon*\
類型：const char\*

與成就相關聯之影像的 URL (長度上限：2048)。

*achievementId*\
類型：const char\*

定義此成就之遊戲的 10 進位識別碼。

*gamerscore*\
類型：uint64\_t

解除鎖定成就所獲得的玩家分數 (可以是 0，挑戰不能有玩家分數)。

*titleId*\
類型：uint32\_t

定義此成就之遊戲的 10 進位識別碼。

*xboxUserId*\
類型：uint64\_t

此人的 XBOX 使用者識別碼。

*deepLink*\
類型：const char\*

在成就上設定的深層連結。

*rarityPercentage*\
類型：float

已解除鎖定此成就的使用者人數 / 該遊戲的唯一使用者總數之比率，以 >= 0.0 且 \<= 1.0 的小數值表示，並四捨五入至小數點後 2 位。

*rarityCategory*\
類型：[XblAchievementRarityCategory](/zh-TW/reference/live/xsapi-c/achievements_c/enums/xblachievementraritycategory)

"Rare" 或 "Common"：Rare 成就是 rarityPercentage \<= 9% (或 0.9) 的成就，其他所有成就則為 "Common"。(此字串不會當地語系化)。

*timeUnlocked*\
類型：time\_t

此使用者首次解除鎖定成就時的時間戳記。

## 需求

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

## 另請參閱

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


## Related topics

- [XblAchievementUnlockHandler](/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementunlockhandler.md)
- [XblAchievementUnlockRemoveNotificationHandler](/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementunlockremovenotificationhandler.md)
- [XblAchievementUnlockAddNotificationHandler](/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementunlockaddnotificationhandler.md)
- [XblAchievementsManagerEvent](/zh-TW/reference/live/xsapi-c/achievements_manager_c/structs/xblachievementsmanagerevent.md)
- [XblAchievementsManagerEventType](/zh-TW/reference/live/xsapi-c/achievements_manager_c/enums/xblachievementsmanagereventtype.md)