Skip to main content

XblAchievementUnlockEvent

알림 서비스에서 수신한 도전 과제 잠금 해제 알림을 나타냅니다.

Syntax

Members

achievementName
Type: const char*
전송 대상 DeviceEndpoint의 로캘로 표시된 도전 과제 이름입니다(현재 문자 제한: 44). achievementDescription
Type: const char*
전송 대상 DeviceEndpoint의 로캘로 표시된 도전 과제 설명입니다. achievementIcon
Type: const char*
도전 과제와 연결된 이미지의 URL입니다(최대 길이: 2048). achievementId
Type: const char*
도전 과제가 정의된 타이틀의 10진수 ID입니다. gamerscore
Type: uint64_t
도전 과제 잠금 해제로 획득한 gamerscore의 양입니다(0일 수 있음 - challenges는 gamerscore를 가질 수 없음). titleId
Type: uint32_t
도전 과제가 정의된 타이틀의 10진수 ID입니다. xboxUserId
Type: uint64_t
사용자의 XBOX 사용자 식별자입니다. deepLink
Type: const char*
도전 과제에 설정된 딥 링크입니다. rarityPercentage
Type: float
해당 도전 과제를 잠금 해제한 사용자 수와 해당 타이틀의 전체 고유 사용자 수의 비율로, 0.0 이상 1.0 이하의 소수 값으로 표현되며 소수점 이하 2자리에서 반올림됩니다. rarityCategory
Type: XblAchievementRarityCategory
“Rare” 또는 “Common” - Rare 도전 과제는 rarityPercentage가 9%(또는 0.9) 이하인 것을 의미하고, “Common”은 그 밖의 모든 것을 의미합니다. (이 문자열은 지역화되지 않습니다.) timeUnlocked
Type: time_t
이 사용자에 대해 도전 과제가 처음 잠금 해제된 시간의 타임스탬프입니다.

Requirements

Header: achievements_c.h

See also

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