XblAchievement

表示一个成就,即一种系统范围的机制,能够在所有游戏中通过一致的方式引导和奖励用户在游戏内的操作。

语法

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 编码的成就 ID。 代表一个单位。

serviceConfigurationId
类型:const char*

与成就关联的服务配置 ID (SCID)。 SCID 被视为区分大小写,因此可以直接从合作伙伴中心粘贴它

name
类型:const char*

UTF-8 编码的本地化的成就名称。

titleAssociations
类型:XblAchievementTitleAssociation*

与成就关联的游戏/应用游戏。

titleAssociationsCount
类型:size_t

titleAssociations 的大小。

progressState
类型:XblAchievementProgressState

用户在获得成就方面取得的进展的状态。

progression
类型:XblAchievementProgression

包含有关成就的进度详细信息的进度对象,包括要求。

mediaAssets
类型:XblAchievementMediaAsset*

与成就关联的媒体资产,如图像 ID。

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

成就的类型,例如挑战成就。

participationType
类型:XblAchievementParticipationType

成就的参与类型,例如组或个人。

available
类型:XblAchievementTimeWindow

成就可用的时间范围。 适用于挑战。

rewards
类型:XblAchievementReward*

当成就解锁时玩家获得的奖励集合。

rewardsCount
类型:size_t

rewards 的大小。

estimatedUnlockTime
类型:uint64_t

预计获得成就所要花费的时间。

deepLink
类型:const char*

客户端的 UTF-8 编码的深层链接,使游戏能够在期望的成就起点启动。

isRevoked
类型:bool

指示是否强制撤消成就的值。

参数属于

XblAchievementsResultGetAchievements

要求

头文件:achievements_c.h

另请参阅

achievements_c