언리얼 엔진 5 문서가 에픽 디벨로퍼 커뮤니티로 이전되었습니다

Leaderboard (순위표)는 플랫폼별로 플레이어들의 최고 점수를 기록하여 표시해 줍니다. 이를 통해 플레이어들은 자신의 실력을 자랑하고 커뮤니티 형성에 기여할 수 있습니다.

환경설정

각 플랫폼별 순위표 환경설정 관련 자세한 내용은 해당 플랫폼별 페이지를 참고하세요:

순위표에서 읽기

Read Leaderboard Integer 노드는 플랫폼의 게임 서비스(, 현재 iOS Game Center 또는 Google Play Services)에서 요청, 제공된 Player Controller 의 주어진 Stat Name 에 저장된 값을 받습니다.

참고로 이는 latent (잠복성) 노드로, 실행 출력 핀이 여럿 있을 수 있습니다. 가장 위의 것은 "pass through" (통과)로, 다른 실행 출력 핀과 똑같이 작동합니다. 다른 두 가지 핀은 ( On Success 와 On Failure ) 온라인 서비스가 값을 반환( 또는 실패)할 때 실행됩니다. 반환에 성공하기 (또는 서비스가 응답을 받는 데 실패하기) 전 Leaderboard Value 값은 0 이 됩니다.

블루프린트:

아래는 Unreal Match 3 (언리얼 매치 3) 샘플 게임의 Global Game Instance 블루프린트 예제입니다. 이 몇 개의 노드에서는 Stat Name (Leaderboard) "Match3HighScore" 에서 Player Index 0 위치의 Player Controller 에 대한 Read Leaderboard Integer 노드를 호출합니다:

순위표에 쓰기

Write Leaderboard Integer 노드는 주어진 인티저 Stat Value 를 제공된 Player Controller 의 Stat Name 에 지정된 순위표에 전송합니다.

블루프린트:

아래는 언리얼 매치 3 샘플 게임의 VictoryScreen 블루프린트 예제입니다. 승리( 또는 패배) 화면이 표시될 때, 언리얼 매치 3 로드시 최고 점수를 구할 수 있었는지 확인한 다음, 가능했다면 순위표에 최신의 최고 점수를 전송합니다. 그 전에 앱 시작 도중 끌어 온 것보다 높은 최고 점수가 있는지 확인하는 부가 검사가 있지만, 없다 하더라도 iOS 나 Android 순위표 시스템에서는 현재 저장된 값보다 큰 값만을 받습니다.

플랫폼별 순위표 표시

Show Platform Specific Leaderboard Screen 은 디바이스에서 Category Name 으로 지정된 순위표를 표시합니다.

블루프린트:

아래는 언리얼 매치 3 샘플 게임의 GameOverButtons 블루프린트 예제입니다. ShowScores 버튼이 눌리면, 게임에서는 순위표 표시를 시도합니다.