Skip to main content

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
“Rare”(稀有)或 “Common”(常见)——其中稀有成就是指 rarityPercentage <= 9%(或 0.9)的成就,其余均为“常见”。(此字符串未本地化)。 timeUnlocked
类型:time_t
此用户首次解锁该成就时的时间戳。

要求

头文件: achievements_c.h

另请参阅

achievements_c
最后修改于 2026年8月24日