Epic Online Services achievements sample

에픽 온라인 서비스 업적 샘플에 대한 레퍼런스 페이지입니다.

3 분 소요
업적 샘플 메인

업적 샘플(Achievements Sample)EOS SDK 에서 에픽 온라인 서비스 업적 과 관련된 다음과 같은 작업을 보여줍니다.

  • 에픽 온라인 서비스 업적 정의 쿼리하기
  • 플레이어 에픽 온라인 서비스 업적 진행상황 쿼리하기
  • 에픽 온라인 서비스 업적의 진행상황을 업데이트하기 위한 통계 수집하기
  • 수동으로 에픽 온라인 서비스 업적 잠금해제하기

샘플에서는 이 작업을 제어하고 데이터를 사용자에게 표시할 수 있는 사용자 인터페이스를 통해 위 기능을 시연합니다.

업적과 통계에 대한 더 자세한 정보는 업적 인터페이스통계 인터페이스 문서를 참조하세요.

시작하기 전에

샘플 애플리케이션은 시연을 위해 에픽 계정 서비스 를 사용하여 로컬 사용자를 인증합니다. 이를 위해서는 SDK 초기화에 사용된 클라이언트 크리덴셜이 에픽 계정 서비스 에 사용된 애플리케이션 에 할당되어 있어야 합니다.

시연된 SDK 함수 기능은 지원되는 모든 ID 제공자와 함께 사용자 인증을 위해 사용할 수 있습니다.

에픽 온라인 서비스 업적 정의

샘플이 시작되면 개발자 포털(Developer Portal) 을 통해 생성된 에픽 온라인 서비스 업적 정의 를 가져와서 목록으로 표시합니다. 정의 이름은 아래와 같이 왼쪽 정의(Definitions) 열에 나타납니다.

에픽 온라인 서비스 업적 정의

사용자가 로그인되어 있으면 에픽 온라인 서비스 업적 정의에서 사용자의 언어로 현지화된 텍스트를 반환합니다. 사용자가 로케일 오버라이드를 설정했다면 설정한 언어로 된 텍스트를 반환합니다. 사용자가 로그인하지 않았다면 기본 텍스트를 가져옵니다.

에픽 온라인 서비스 업적 선택

에픽 온라인 서비스 업적 정의를 왼쪽 클릭하여 선택합니다. 선택한 업적 정보(Selected Definition Info) 섹션에 선택한 에픽 온라인 서비스 업적의 추가 정보가 아래와 같이 표시됩니다.

정의 정보

플레이어 업적 데이터

사용자가 로그인하면 창 상단의 잠금해제(Unlock)업데이트(Update) 버튼이 활성화됩니다.

플레이어 업적 데이터

이 두 버튼의 기능은 다음과 같습니다.

버튼 이름설명
잠금해제(Unlock)선택한 에픽 온라인 서비스 업적의 진행률(Progress)1.0 으로 설정하여 업적을 잠금해제합니다.
업데이트(Update)플레이어 업적 데이터를 가져오도록 요청하여 플레이어의 현재 진행상황과 상태에 대한 최신 정보를 제공합니다.

알림

에픽 온라인 서비스 업적이 잠금해제되면, 오른쪽 위에 알림이 다음과 같이 표시됩니다.

업적 알림

통계

통계(Stats) 는 개발자 포털에 생성되며 에픽 온라인 서비스 업적과 연결하여 에픽 온라인 서비스 업적 진행상황을 자동으로 업데이트할 수 있습니다. 통계를 수집 하려면 통계의 이름 과 해당 통계로 수집할 을 아래와 같이 설정한 다음 통계 수집(Ingest Stat) 버튼을 클릭합니다.

통계 수집

통계를 수집한 후에는 업데이트(Update) 버튼을 클릭하여 현재 플레이어에 대한 통계를 요청해야 합니다. 그러면 해당 통계와 연결된 에픽 온라인 서비스 업적의 진행률(Progress) 이 바뀌는 것을 볼 수 있습니다.

콘솔 명령

이 샘플에서는 일반적인 콘솔 명령 외에도 다음과 같은 추가 콘솔 명령을 게임 내에서 입력할 수 있습니다.

콘솔 명령사용설명
GETDEFSGETDEFS이 애플리케이션에 대한 에픽 온라인 서비스 업적 정의를 가져오도록 요청합니다. 사용자가 로그인하면 사용자가 지정한 언어 또는 로케일 오버라이드와 일치하는 현지화된 텍스트가 표시됩니다.
GETPLAYERGETPLAYER현재 사용자의 에픽 온라인 서비스 업적 데이터를 가져오도록 요청합니다.
UNLOCKUNLOCK <ACHIEVEMENT_NAME>이름이 <ACHIEVEMENT_NAME> 인 에픽 온라인 서비스 업적을 잠금해제합니다.
INGESTINGEST <STAT_NAME> <INGEST_AMOUNT>이름이 <STAT_NAME> 인 통계를 <INGEST_AMOUNT> 만큼 수집합니다.
QUERYSTATSQUERYSTATS현재 플레이어에 대한 통계를 요청합니다.