시작하기
Install the Cloud Save Software Development Kit and Authentication Software Development Kit in your Unity project to start using Cloud Save.
읽는 시간 1분최근 업데이트: 6달 전
경고
주의: DSA(디지털서비스법)는 유니티가 DSA에 따라 고객의 최종 사용자에게 영향을 미치는 조치를 취할 경우 최종 사용자에게 알릴 것을 요구합니다. 이 요구 사항을 준수하기 위해, Unity Authentication 서비스를 이용하는 UGS(Unity Gaming Services) 제품을 사용할 경우, 알림 API를 연동해야 합니다.DSA에 대한 자세한 내용은 디지털서비스법 - 규정 준수 업데이트를 참조하십시오.게임이 DSA를 준수하도록 하려면 DSA 알림을 참조하십시오.
Cloud Save SDK 설치
Unity 에디터를 통해 패키지를 설치합니다. Window > Package Manager로 이동하여 왼쪽 상단에 있는 패키지 드롭다운에서 Unity Registry를 선택합니다. 다음 중 하나를 수행합니다.- 오른쪽 상단에 있는 검색 바에서 Cloud Save를 검색합니다.
- 이름으로 패키지를 추가합니다.
- + 로 표시된 드롭다운을 엽니다.
- Add package by name... 을 선택합니다.
- 패키지 이름 ‘com.unity.services.cloudsave’ 를 입력합니다(버전은 선택 사항).
참고
참고: SDK에는 Cloud Save를 사용하여 데이터와 파일을 읽고 쓰는 방법을 보여 주는 코드가 에 포함되어 있습니다.
SamplesUnity.Services.CloudSaveusing Unity.Services.CloudSave;
Authentication SDK 설치
Cloud Save 패키지는 Authentication 패키지에 포함되어 있습니다. Unity Authentication 서비스는 플레이어 점수가 유지되는 계정을 생성하여 익명 로그인이나 플랫폼별 인증을 사용하도록 지원합니다. Cloud Save 패키지를 설치하면 Authentication 패키지가 종속적으로 함께 설치됩니다. 패키지 수동 설치에 대해 자세히 알아보려면 레지스트리에서 패키지 설치를 참고하십시오. 설치가 완료되면Unity.Services.Authenticationusing 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.Coreawait UnityServices.InitializeAsync()Unity에서 Cloud Save SDK를 사용하는 방법에 대한 추가 예제는 Unity SDK 튜토리얼을 참고하십시오.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)}"); }}
Cloud Save REST API
REST API를 사용하여 Cloud Save의 데이터에 액세스할 수 있습니다. REST API를 사용하면 유연성이 향상되며 원하는 언어와 게임 개발 엔진 또는 게임 서버를 사용해 워크플로를 자동화할 수 있습니다. Cloud Save 서비스에서 제공되는 REST API는 다음과 같습니다.- 플레이어 작업용 Cloud Save 플레이어 API(예: 데이터 저장/로딩)
- 관리자 작업용 Cloud Save 관리자 API(예: 쿼리/인덱스 구성)