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