Android 게임 업적

이 가이드에서는 Android 애플리케이션에서 업적 API를 사용하여 게임에서 업적을 달성하고 표시하는 방법을 보여줍니다. API는 com.google.android.gms.gamescom.google.android.gms.games.achievements 패키지에서 찾을 수 있습니다.

시작하기 전에

아직 검토하지 않았다면 업적 게임 개념을 검토하는 것이 좋습니다.

업적 API를 사용하여 코딩을 시작하기 전에 다음을 수행합니다.

업적 클라이언트 가져오기

업적 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 할당량을 초과하지 않도록 관련 권장사항도 따라야 합니다.

업적 표시

플레이어의 업적을 표시하려면 Intent를 가져올 AchievementsClient.getAchievementsIntent()를 호출하여 기본 업적 사용자 인터페이스를 생성합니다. 그러면 게임이 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의 예가 아래에 나와 있습니다.