跳轉到主要內容

XblAchievement

代表成就,這是一種全系統的機制,可在所有遊戲中一致地引導並獎勵使用者的遊戲內動作。

語法

成員

id
類型:const char*
UTF-8 編碼的成就識別碼。代表 uint。 serviceConfigurationId
類型:const char*
與成就相關聯的服務設定識別碼 (SCID)。SCID 區分大小寫,因此請直接從 Partner Center 貼上 name
類型:const char*
UTF-8 編碼的當地語系化成就名稱。 titleAssociations
類型:XblAchievementTitleAssociation*
與成就相關聯的遊戲/應用程式。 titleAssociationsCount
類型:size_t
titleAssociations 的大小。 progressState
類型:XblAchievementProgressState
使用者達成此成就的進度狀態。 progression
類型:XblAchievementProgression
包含成就進度詳細資料 (包括需求) 的進度物件。 mediaAssets
類型:XblAchievementMediaAsset*
與成就相關聯的媒體資產,例如影像識別碼。 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年10月6日