이 가이드에서는 Android 애플리케이션에서 업적 API를 사용하여 게임에서 업적을 달성하고 표시하는 방법을 보여줍니다. API는 com.google.android.gms.games
및 com.google.android.gms.games.achievements
패키지에서 찾을 수 있습니다.
시작하기 전에
아직 검토하지 않았다면 업적 게임 개념을 검토하는 것이 좋습니다.
업적 API를 사용하여 코딩을 시작하기 전에 다음을 수행합니다.
- 사용할 앱 설치 및 설정에 관한 안내를 따르세요. Google Play 게임즈 서비스를 Google Play 서비스 SDK 설정 가이드를 참조하세요.
- Google Play Console 가이드의 안내에 따라 게임에서 달성하거나 표시할 업적을 정의합니다.
- Android 샘플 페이지에서 업적 코드 샘플을 다운로드하여 검토합니다.
- 품질 체크리스트에 설명된 권장사항을 숙지합니다.
업적 클라이언트 가져오기
업적 API를 사용하려면 게임에서 먼저
AchievementsClient
객체 이렇게 하려면
Games.getAchievementClient()
메서드를 호출하고 활동을 전달합니다.
업적 달성
업적을 달성하려면 AchievementsClient.unlock()
메서드를 호출하고
업적 ID를 전달합니다.
다음 코드 스니펫은 앱에서 업적이 달성되는 방법을 보여줍니다.
PlayGames.getAchievementsClient(this).unlock(getString(R.string.my_achievement_id));
업적이 증분 유형인 경우 (즉, 업적 달성을 위해 여러 단계가 필요함)
대신 AchievementsClient.increment()
를 호출하세요.
다음 코드 스니펫은 앱에서 플레이어의 업적을 늘리는 방법을 보여줍니다.
PlayGames.getAchievementsClient(this).increment(getString(R.string.my_achievement_id), 1);
업적을 달성하기 위해 추가 코드를 작성할 필요는 없습니다. Google Play 게임즈 서비스 필요한 단계 수에 도달하면 업적이 자동으로 달성됩니다.
게임에 리소스 ID별로 업적이 참조될 수 있도록 strings.xml
파일에서 업적 ID를 정의하는 것이 좋습니다. 업데이트 및 로드를 호출할 때
또한 권장사항을 따라
API 할당량을 초과할 수 있습니다
업적 표시
플레이어의 업적을 표시하려면 AchievementsClient.getAchievementsIntent()
를 호출합니다.
만들 Intent
을(를) 받을 수 있습니다.
사용자 인터페이스를
사용해야 합니다. 그러면 게임이 startActivityForResult
를 호출하여 UI를 불러올 수 있게 됩니다.
다음 코드 스니펫은 앱이 기본 업적 사용자 인터페이스를 표시하는 방법을 보여줍니다.
스니펫에서 RC_ACHIEVEMENT_UI
는 게임에서 요청 코드로 사용하는 임의의 정수입니다.
private static final int RC_ACHIEVEMENT_UI = 9003; private void showAchievements() { PlayGames.getAchievementsClient(this) .getAchievementsIntent() .addOnSuccessListener(new OnSuccessListener<Intent>() { @Override public void onSuccess(Intent intent) { startActivityForResult(intent, RC_ACHIEVEMENT_UI); } }); }
기본 업적 UI의 예가 아래에 나와 있습니다.