시작하기#

Cloud Save SDK 설치#

Unity 에디터를 통해 패키지를 설치합니다.

Window > Package Manager로 이동하여 왼쪽 상단에 있는 패키지 드롭다운에서 Unity Registry를 선택합니다. 다음 중 하나를 수행합니다.

• 오른쪽 상단에 있는 검색 바에서 Cloud Save를 검색합니다.
• 이름으로 패키지를 추가합니다. + 기호로 표시된 드롭다운을 열고 **‘Add package by name...’**을 선택합니다. 버전 없이 SDK 패키지 ID **‘com.unity.services.cloudsave’**를 검색합니다.

설치가 완료되면 Unity.Services.CloudSave 네임스페이스의 Unity 스크립트에서 Cloud Save SDK를 사용할 수 있습니다.

using Unity.Services.CloudSave;

Authentication SDK 설치#

Cloud Save 패키지는 Authentication 패키지에 포함되어 있습니다. Unity Authentication 서비스는 플레이어 점수가 유지되는 계정을 생성하여 익명 로그인이나 플랫폼별 인증을 사용하도록 지원합니다.

Cloud Save 패키지를 설치하면 Authentication 패키지가 종속적으로 함께 설치됩니다. 패키지 수동 설치에 대해 자세히 알아보려면 레지스트리에서 패키지 설치를 참고하십시오.

설치가 완료되면 Unity.Services.Authentication 네임스페이스의 Unity 스크립트에서 Authentication SDK를 사용할 수 있습니다.

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 스크립트 수명 주기 콜백 내부에서 Cloud Save SDK와 종속성을 초기화한 후 사용합니다.

Unity.Services.Core 네임스페이스에서 await UnityServices.InitializeAsync()를 호출하여 Core SDK를 통해 설치된 모든 서비스를 초기화함으로써 작업이 완료됩니다.

SDK 초기화가 완료되면 플레이어 인증이 마무리됩니다. 다음은 익명 인증 방식으로 익명 계정을 만들어 플레이어의 점수를 유지하는 예제입니다. 사용 가능한 다른 인증 방법은 Unity Authentication 기술 자료에 명시되어 있습니다.

using UnityEngine;
using Unity.Services.Core;
using Unity.Services.Authentication;

public class CloudSaveSample : MonoBehaviour
{
  private async void Awake()
    {
        await UnityServices.InitializeAsync();
        await AuthenticationService.Instance.SignInAnonymouslyAsync();
    }
}

Cloud Save REST API#

REST API를 사용하여 Cloud Save의 데이터에 액세스할 수 있습니다.

REST API를 사용하면 유연성이 향상되며 원하는 언어와 게임 개발 엔진을 사용해 워크플로를 자동화할 수 있습니다.

Cloud Save 서비스에서 제공되는 REST API는 다음과 같습니다.

• 플레이어 작업용 Cloud Save 플레이어 API(예: 데이터 저장/로딩)
• 관리자 작업용 Cloud Save 관리자 API(예: 쿼리/인덱스 구성)

추가 리소스#

• Unity에서 Cloud Save 사용
• Cloud Code용 Cloud Save SDK
• Unity Dashboard
• 패키지 관리자
• Unity Authentication