Skip to main content

XblAchievement

表示一项成就,即一种系统级机制,用于跨所有游戏一致地引导和奖励用户的游戏内行为。

语法

成员

id
类型:const char*
UTF-8 编码的成就 ID。表示一个 uint。 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
最后修改于 2026年8月13日