XblAchievementUnlockEvent

表示从通知服务收到的成就解锁通知。

语法

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 ID。

gamerscore
类型:uint64_t

解锁成就所获得的玩家分数数量(0-挑战不能拥有玩家分数)。

titleId
类型:uint32_t

成就定义的游戏基础 10 ID。

xboxUserId
类型:uint64_t

该人的 Xbox 用户标识符。

deepLink
类型:const char*

成就上设定的深层链接。

rarityPercentage
类型:float

已解锁成就的用户数与该游戏的唯一身份用户总数之比,表示为小数值 > = 0.0和< = 1.0(取舍到小数点后两位)。

rarityCategory
类型: XblAchievementRarityCategory

“罕见”或“ 常见” - 罕见成就时指 rarityPercentage < = 9% (或 0.9) 的成就,而“常见”为其他成就。 (此字符串未本地化)。

timeUnlocked
类型:time_t

第一次为此用户解锁成就的时间戳。

要求

头文件:achievements_c.h

另请参阅

achievements_c