기술 자료

지원

Leaderboards

Unity SDK tutorial

Open Unity Dashboard

Leaderboards

Leaderboards 시작하기

Set up and integrate Leaderboards into your project using the Unity Dashboard, Software Development Kit, CLI, or REST API.
읽는 시간 1분최근 업데이트: 5일 전
Leaderboards를 사용하는 첫 단계로 기능을 구현하는 방법을 알아봅니다. 본 섹션에는 프로젝트에서 Leaderboards를 설정하는 방법이 나와 있습니다.

주제

설명

Unity Dashboard의 LeaderboardsUnity Dashboard에서 Leaderboards를 찾을 수 있는 위치를 알아봅니다.
SDK 설치 및 설정사용자 프로젝트와 Unity Gaming Services 프로젝트를 연결하고, SDK를 설치하여 설정하는 방법을 알아봅니다.
UGS CLI의 LeaderboardsUnity CLI를 사용하여 Leaderboards와 상호 작용하는 방법을 알아봅니다.
Leaderboards REST API 사용Unity SDK를 사용하지 않고 Leaderboards에 액세스하기 위해 사용할 수 있는 REST API에 대해 알아봅니다.
Cloud Code로 Leaderboards 사용Cloud Code 서비스를 사용하여 Leaderboards에 액세스하는 방법을 알아봅니다.

Unity Dashboard

Unity Dashboard에서 Leaderboards에 액세스할 수 있습니다. 메인 메뉴에서 LiveOps를 선택하여 Leaderboards를 찾습니다. Dashboard를 사용하여 리더보드를 생성 및 관리하고 엔트리를 검토할 수 있습니다.

Unity SDK 설치 및 설정

Leaderboards SDK를 사용하려면 Unity 2020.3.0 이상이 설치되어 있어야 합니다.

Leaderboards SDK 설치

Unity 에디터를 통해 패키지를 설치합니다. Window > Package Manager로 이동하여 왼쪽 상단에 있는 패키지 드롭다운에서 Unity Registry를 선택합니다. 그리고 다음 내용을 수행합니다.
  • 오른쪽 상단에 있는 검색 바에서 Leaderboards를 검색합니다.
  • 이름으로 패키지를 추가합니다. + 기호로 표시된 드롭다운을 열고 ‘Add package by name...’ 을 선택합니다. 버전과 상관없이 SDK 패키지 ID ‘com.unity.services.leaderboards’ 를 검색합니다.
설치가 완료되면 
Unity.Services.Leaderboards
네임스페이스의 Unity 스크립트에서 Leaderboards SDK를 사용할 수 있습니다. C#: 
using Unity.Services.Leaderboards;

Authentication SDK 설치

Leaderboards 패키지는 Authentication 패키지에 포함되어 있습니다. Unity Authentication 서비스는 플레이어 점수가 유지되는 계정을 생성하여 익명 로그인 또는 플랫폼별 인증을 사용하도록 지원합니다. Leaderboards 패키지를 설치하면 Authentication 패키지가 종속적으로 함께 설치됩니다. 패키지 수동 설치에 대해 자세히 알아보려면 레지스트리에서 패키지 설치를 참고하십시오. 설치가 완료되면 
Unity.Services.Authentication
네임스페이스의 Unity 스크립트에서 Authentication SDK를 사용할 수 있습니다. C#: 
using Unity.Services.Authentication;

Unity 프로젝트 연결

설치가 완료되면 Authentication 패키지에는 아래와 같이 Unity Game Services Project ID에 Unity 프로젝트를 연결하라는 메시지가 표시됩니다. 화면에 표시되는 프롬프트의 지침에 따라 프로젝트를 연결합니다.
이 프롬프트가 화면에 표시되지 않으면 다음 단계대로 Project ID에 Unity 프로젝트를 연결합니다.
  • Unity 에디터에서 Edit > Project Settings를 선택합니다.
  • Services를 선택합니다.
    • 보유하고 있는 Unity ID로 로그인합니다.
    • ID가 없으면 Create a Unity ID를 선택합니다.
  • 프로젝트를 선택합니다.
  • Link를 선택합니다.

SDK 초기화 및 플레이어 인증

Unity 스크립트 수명 주기 콜백 내부에서 Leaderboards SDK와 종속성을 초기화한 다음에 사용합니다. 다음 예제에서는 
Awake
콜백을 사용합니다. 
Unity.Services.Core
네임스페이스에서 사용할 수 있는 
await UnityServices.InitializeAsync();
를 호출하여 Core SDK를 통해 설치된 모든 서비스를 초기화함으로써 작업이 완료됩니다. SDK 초기화가 완료되면 플레이어 인증이 마무리됩니다. 다음은 익명 인증 방식으로 익명 계정을 만들어 플레이어의 점수를 유지하는 예제입니다. 사용 가능한 다른 인증 방법은 Unity Authentication 기술 자료에 명시되어 있습니다. C#: 
using UnityEngine;using Unity.Services.Core;using Unity.Services.Authentication;public class LeaderboardsSample : MonoBehaviour{  private async void Awake()    {        await UnityServices.InitializeAsync();        await AuthenticationService.Instance.SignInAnonymouslyAsync();    }}

다음 단계

위의 단계가 완료되면 이제 
Unity.Services.Leaderboards
네임스페이스에서 Leaderboards SDK가 사용됩니다. 기능과 SDK 기술 문서, SDK 샘플을 검토하여 Leaderboards 기능 세트와 사용 방법을 확인하십시오.

UGS CLI의 Leaderboards

UGS(Unity Gaming Services) 커맨드 라인 인터페이스는 Unity Dashboard에 확장 가능하고 자동화할 수 있는 대안을 제공하여 팀의 워크플로와 생산성 개선에 기여할 수 있습니다. CLI를 사용하여 Leaderboards 구성을 관리 및 테스트하고 배포합니다. CLI를 설치하고 사용하는 방법에 관한 기술 자료를 참고하십시오.

Leaderboards REST API

Unity를 사용하지 않는 개발자는 웹 엔드포인트 또는 REST API를 통해 API에 액세스할 수 있습니다. REST API를 사용하면 유연성이 향상되며 원하는 언어와 게임 개발 엔진을 사용해 워크플로를 자동화할 수 있습니다. Leaderboards 서비스에서 제공되는 REST API는 다음과 같습니다.
  • Leaderboards Player API는 플레이어 행동을 수행하는 데 사용됩니다. 예: 점수 제출 또는 점수 가져오기
  • Leaderboards 관리자 API는 관리자 행동 수행뿐 아니라 플레이어 대신 플레이어 행동을 수행하는 데도 사용됩니다. 예: 리더보드의 생성 또는 업데이트, 점수 삭제 또는 재설정

추가 리소스