> ## 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\*

定义该成就的标题的十进制 ID。

*gamerscore*\
类型：uint64\_t

解锁该成就所获得的玩家积分数量（可以为 0——挑战成就不能有玩家积分）。

*titleId*\
类型：uint32\_t

定义该成就的标题的十进制 ID。

*xboxUserId*\
类型：uint64\_t

用户的 XBOX 用户标识符。

*deepLink*\
类型：const char\*

在该成就上设置的深层链接。

*rarityPercentage*\
类型：float

已解锁该成就的用户数 / 该标题的唯一用户总数的比率，以 >= 0.0 且 \<= 1.0 的分数值表示，四舍五入至 2 位小数。

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

“Rare”（稀有）或 “Common”（常见）——其中稀有成就是指 rarityPercentage \<= 9%（或 0.9）的成就，其余均为“常见”。（此字符串未本地化）。

*timeUnlocked*\
类型：time\_t

此用户首次解锁该成就时的时间戳。

## 要求

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

## 另请参阅

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