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입니다. Uint을 나타냅니다.
serviceConfigurationId
형식: const char*
도전 과제와 연결된 SCID(서비스 구성 ID)입니다. 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
도전 과제를 사용할 수 있는 기간입니다. 챌린지에 적용됩니다.
보상
형식: XblAchievementReward*
도전 과제가 잠금 해제될 때 플레이어가 획득하는 보상의 컬렉션입니다.
rewardsCount
형식: size_t
rewards의 크기입니다.
estimatedUnlockTime
형식: uint64_t
도전 과제를 획득하는 데 걸리는 예상 시간입니다.
deepLink
형식: const char*
도전 과제에 대해 원하는 시작 지점에서 타이틀이 실행될 수 있게 해주는 클라이언트에 대한 UTF-8로 인코딩된 딥 링크입니다.
isRevoked
형식: bool
규정 집행에 의해 도전 과제가 취소되는지 여부를 나타내는 값입니다.
인수
XblAchievementsResultGetAchievements
요구 사항
헤더: achievements_c.h