시작하기 전에
- 제품에서 전체 XBOX services 기능 집합을 사용합니다. 새 제품은 제한된 XBOX services로 시작하며, 제품이 온보딩될 때까지 업적과 게이머스코어를 사용할 수 없습니다. 자세한 내용은 전체 XBOX services를 사용하도록 제품 온보딩 요청을 참조하세요.
- Partner Center에서 업적을 구성하고 XBOX services 구성을 개발 샌드박스에 게시했습니다. 자세한 내용은 Partner Center에서 타이틀 관리 업적 구성을 참조하세요.
- 개발 키트 또는 Windows PC가 같은 개발 샌드박스를 사용하며, 해당 샌드박스에 액세스할 수 있는 테스트 계정으로 로그인합니다. 자세한 내용은 XBOX services 샌드박스 개요를 참조하세요.
- 게임에서 Gaming Runtime을 초기화한 다음
scid멤버에 서비스 구성 ID(SCID)가 포함된 XblInitArgs 구조체를 사용하여 XblInitialize를 호출했습니다. SCID는 대/소문자를 구분합니다. 자세한 내용은 XBOX services API 사용 방법을 참조하세요. - 사용자를 로그인시키고 XblContextCreateHandle을 호출하여 해당 사용자에 대한
XblContextHandle을 만들었습니다.
업적 목록 가져오기
실행 중인 타이틀에 대한 업적을 가져오려면 다음과 같이 XblAchievementsGetAchievementsForTitleIdAsync를 호출합니다.XblAchievementsGetAchievementsForTitleIdAsync 호출
C++- XAsyncBlock
- XblAchievement
- XblAchievementProgressState
- XblAchievementsGetAchievementsForTitleIdAsync
- XblAchievementsGetAchievementsForTitleIdResult
- XblAchievementsResultCloseHandle
- XblAchievementsResultDuplicateHandle
- XblAchievementsResultGetAchievements
다음 페이지의 업적 결과 가져오기
업적 페이지가 더 있을 수 있습니다. 확인하려면 XblAchievementsResultHasNext를 호출합니다. 다음 페이지를 가져오려면 현재 결과 핸들을 사용하여 XblAchievementsResultGetNextAsync를 호출한 다음, 콜백에서 XblAchievementsResultGetNextResult를 호출합니다.XblAchievementsResultGetNextResult는 새 결과 핸들을 반환합니다. 각 결과 핸들은 별도로 닫아야 합니다. maxItems에 0을 전달하면 모든 항목을 검색하려고 시도하지만, 서비스는 기본 페이지 크기를 적용할 수 있으며 페이지가 더 남아 있더라도 요청한 것보다 적은 항목을 반환할 수 있습니다. 한 번의 호출로 모든 업적이 반환된다고 가정하지 말고 항상 XblAchievementsResultHasNext를 확인하세요.
모든 결과 페이지 처리
다음 예제에서는XblAchievementsGetAchievementsForTitleIdResult의 결과 핸들을 닫는 대신 ProcessAchievementsPage에 전달합니다. 이 함수는 전달된 핸들의 소유권을 가져와 해당 핸들을 정확히 한 번 닫습니다. 현재 핸들은 다음 페이지에 대한 요청이 완료될 때까지 열린 상태로 유지됩니다.
C++
- XAsyncBlock
- XblAchievement
- XblAchievementProgressState
- XblAchievementsResultCloseHandle
- XblAchievementsResultGetAchievements
- XblAchievementsResultGetNextAsync
- XblAchievementsResultGetNextResult
- XblAchievementsResultHasNext
단일 업적 가져오기
단일 업적을 가져오려면 다음과 같이 XblAchievementsGetAchievementAsync를 호출합니다. Flat C API- XAsyncBlock
- XblAchievement
- XblAchievementsGetAchievementAsync
- XblAchievementsGetAchievementResult
- XblAchievementsResultCloseHandle
- XblAchievementsResultGetAchievements
