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