시작하기

Cloud Save SDK 설치#

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

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

• 오른쪽 상단에 있는 검색 바에서 Cloud Save를 검색합니다.
• 이름으로 패키지를 추가합니다.
  • **+**로 표시된 드롭다운을 엽니다.
  • **Add package by name...**을 선택합니다.
  • 패키지 이름 **‘com.unity.services.cloudsave’**를 입력합니다(버전은 선택 사항).

설치가 완료되면 Unity.Services.CloudSave 네임스페이스의 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 프로젝트를 연결하라는 메시지가 표시됩니다.

프로젝트가 UGS 프로젝트 ID에 연결되지 않았거나, 연결된 UGS 프로젝트 ID를 확인하려는 경우, 다음 단계를 따라 Unity 프로젝트를 UGS 프로젝트 ID에 수동으로 연결할 수 있습니다.

• Unity 에디터에서 Edit > **Project Settings...**를 선택합니다.
• Services를 선택합니다.
  • 보유하고 있는 Unity ID로 로그인합니다.
  • ID가 없으면 Create a Unity ID를 선택합니다.
• 프로젝트를 선택합니다.
• Link를 선택합니다.

Cloud Save SDK 호출#

Cloud Save SDK와 종속성을 수명 주기 콜백에서 초기화한 후 사용해야 합니다.

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

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

using System.Collections.Generic;
using Unity.Services.Authentication;
using Unity.Services.CloudSave;
using Unity.Services.CloudSave.Models;
using Unity.Services.Core;
using UnityEngine;

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

    public async void SaveData()
    {
        var playerData = new Dictionary<string, object>{
          {"firstKeyName", "a text value"},
          {"secondKeyName", 123}
        };
        var result = await CloudSaveService.Instance.Data.Player.SaveAsync(playerData);
        Debug.Log($"Saved data {string.Join(',', playerData)}");
    }
}

Unity에서 Cloud Save SDK를 사용하는 방법에 대한 추가 예제는 Unity SDK 튜토리얼을 참고하십시오.

Cloud Save REST API#

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

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

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

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

REST API 튜토리얼에는 토큰 생성과 REST API 호출 방법에 대한 정보가 포함되어 있습니다.

추가 리소스#

• Cloud Save Unity SDK 튜토리얼
• Cloud Code용 Cloud Save 튜토리얼
• Cloud Save REST API 튜토리얼
• Cloud Save CLI 모듈