게임 아이디어와 기능

다음에 추가할 기능

리더보드

매 라운드 후 점수를 저장하고 선두를 보여주세요.

플레이어 세션 필요
Unity
리더보드 일러스트
확인할 수 있는 결과

라운드 후 테스트 점수가 순위표에 나타납니다.

리더보드 순위 보기3:54

이 동영상은 영어로 재생됩니다.

동영상 별도로 열기 ↗

같은 프로젝트 준비

  1. 게임 설정과 같은 프로젝트를 대시보드에서 선택하세요.

    리더보드 →
  2. 대시보드 양식에서 다음 테스트 항목을 만들거나 기존 항목을 사용하세요. 표시된 값은 현재 프로젝트 데이터가 아닌 예시입니다.

    키 (slug)
    weekly
    정렬 순서
    DESC
    검증된 플레이의 점수만 받기
    false
  3. 예제를 실행하기 전에 저장하고 다시 불러와 확인하세요. 관련 없는 정의는 유지하세요.

이 기능 구현하기

가이드는 미리 볼 수 있습니다. 실행하려면 활성 프로젝트 키가 필요합니다. 프로젝트 준비

SDK 설치와 프로젝트 설정 가져오기가 완료되고 플레이어가 로그인해야 합니다.

C# 파일을 저장하고 GameObject에 연결한 뒤 Play를 시작하세요. Console을 확인하세요.

C#
Assets/Scripts/LeaderboardDemo.cs
horizOn 호출준비
1using UnityEngine;
2using PM.horizOn.Cloud.Core;
3using PM.horizOn.Cloud.Manager;
4​
5// 이 스크립트를 첫 씬의 GameObject에 붙이세요.
6public class LeaderboardDemo : MonoBehaviour
7{
8 async void Start()
9 {
10 // 준비: 초기화, 연결, 플레이어 로그인.
11 HorizonApp.Initialize();
12 await new HorizonServer().Connect();
13 if (!UserManager.Instance.IsSignedIn)
14 {
15 bool authenticated = UserManager.Instance.HasCachedAnonymousToken()
16 ? await UserManager.Instance.RestoreAnonymousSession()
17 : await UserManager.Instance.SignUpAnonymous("StatisticsPlayer");
18 if (!authenticated) return;
19 }
20​
21 // horizOn: 점수를 제출하고 순위표와 내 순위를 읽기.
22 var boards = LeaderboardManager.Instance;
23 bool submitted = await boards.SubmitScore(12500, boardKey: "weekly");
24 if (!submitted) { Debug.LogWarning(boards.LastErrorCode); return; }
25 var top = await boards.GetTop(10, useCache: false, boardKey: "weekly");
26 if (top == null) return;
27 foreach (var entry in top) Debug.Log($"#{entry.position} {entry.username}: {entry.score}");
28 var rank = await boards.GetRank(boardKey: "weekly");
29 if (rank != null) Debug.Log($"Your rank: {rank.position}");
30 }
31}
전체 SDK 예제 열기 ↗

새 기능을 테스트하세요.

라운드 후 테스트 점수가 순위표에 나타납니다.

게임 설정과 같은 프로젝트를 대시보드에서 선택하세요.

엔드포인트
  • POST/leaderboard/submit
  • GET/leaderboards/{boardKey}/top
  • GET/leaderboards/{boardKey}/rank
  • GET/leaderboards/{boardKey}/around
API 레퍼런스의 모든 엔드포인트