Skip to main content

XblAchievement

도전 과제를 나타냅니다. 도전 과제는 모든 게임에서 일관되게 사용자의 게임 내 동작을 이끌고 보상하기 위한 시스템 전반의 메커니즘입니다.

Syntax

Members

id
Type: const char*
UTF-8 인코딩된 도전 과제 ID입니다. uint를 나타냅니다. serviceConfigurationId
Type: const char*
도전 과제와 연결된 Service Configuration ID(SCID)입니다. SCID는 대/소문자를 구분하는 것으로 간주되므로 Partner Center에서 직접 붙여넣습니다. name
Type: const char*
UTF-8 인코딩된 지역화된 도전 과제 이름입니다. titleAssociations
Type: XblAchievementTitleAssociation*
도전 과제와 연결된 게임/앱 타이틀입니다. titleAssociationsCount
Type: size_t
titleAssociations의 크기입니다. progressState
Type: XblAchievementProgressState
도전 과제 획득을 향한 사용자의 진행 상태입니다. progression
Type: XblAchievementProgression
요구 사항을 포함하여 도전 과제에 대한 진행 세부 정보를 포함하는 progression 개체입니다. mediaAssets
Type: XblAchievementMediaAsset*
도전 과제와 연결된 미디어 자산입니다(예: 이미지 ID). mediaAssetsCount
Type: size_t
mediaAssets의 크기입니다. platformsAvailableOn
Type: const char**
도전 과제를 사용할 수 있는 플랫폼의 UTF-8 인코딩된 컬렉션입니다. platformsAvailableOnCount
Type: size_t
platformsAvailableOn의 크기입니다. isSecret
Type: bool
도전 과제가 비밀인지 여부입니다. unlockedDescription
Type: const char*
잠금 해제된 도전 과제의 UTF-8 인코딩된 설명입니다. lockedDescription
Type: const char*
잠긴 도전 과제의 UTF-8 인코딩된 설명입니다. productId
Type: const char*
도전 과제가 함께 릴리스된 UTF-8 인코딩된 product_id입니다. 이는 애플리케이션, 다운로드 가능 콘텐츠 등에 해당할 수 있는 전역적으로 고유한 식별자입니다. type
Type: XblAchievementType
도전 과제의 형식입니다(예: 챌린지 도전 과제). participationType
Type: XblAchievementParticipationType
도전 과제의 참여 형식입니다(예: 그룹 또는 개별). available
Type: XblAchievementTimeWindow
도전 과제를 사용할 수 있는 시간 창입니다. Challenges에 적용됩니다. rewards
Type: XblAchievementReward*
도전 과제가 잠금 해제될 때 플레이어가 획득하는 보상의 컬렉션입니다. rewardsCount
Type: size_t
rewards의 크기입니다. estimatedUnlockTime
Type: uint64_t
도전 과제를 획득하는 데 걸리는 예상 시간입니다. deepLink
Type: const char*
도전 과제에 대해 원하는 시작점에서 타이틀을 시작할 수 있도록 하는 클라이언트용 UTF-8 인코딩된 딥 링크입니다. isRevoked
Type: bool
도전 과제가 시행에 의해 취소되었는지 여부를 나타내는 값입니다.

Argument of

XblAchievementsResultGetAchievements

Requirements

Header: achievements_c.h

See also

achievements_c
마지막 수정일 2026년 8월 13일