# 시작하기

> Install the Cloud Save Software Development Kit and Authentication Software Development Kit in your Unity project to start using Cloud Save.

> **Warning:**
>
> **주의**: DSA(디지털서비스법)는 유니티가 DSA에 따라 고객의 최종 사용자에게 영향을 미치는 조치를 취할 경우 최종 사용자에게 알릴 것을 요구합니다. 이 요구 사항을 준수하기 위해, Unity Authentication 서비스를 이용하는 UGS(Unity Gaming Services) 제품을 사용할 경우, 알림 API를 연동해야 합니다.
>
> DSA에 대한 자세한 내용은 [디지털서비스법 - 규정 준수 업데이트](https://unity.com/legal/digital-services-act)를 참조하십시오.
>
> 게임이 DSA를 준수하도록 하려면 [DSA 알림](/authentication/dsa-notifications.md.md)을 참조하십시오.

## Cloud Save SDK 설치##install-cloud-save-sdk

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

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

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

> **Note:**
>
> **참고**: SDK에는 Cloud Save를 사용하여 데이터와 파일을 읽고 쓰는 방법을 보여 주는 코드가 `Samples`에 포함되어 있습니다.

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

```cs
using Unity.Services.CloudSave;
```

## Authentication SDK 설치##install-authentication-sdk

Cloud Save 패키지는 Authentication 패키지에 포함되어 있습니다. [Unity Authentication](/authentication/.md) 서비스는 플레이어 점수가 유지되는 계정을 생성하여 [익명 로그인](/authentication/use-anon-sign-in.md)이나 [플랫폼별 인증](/authentication/approaches-to-authentication.md)을 사용하도록 지원합니다.

Cloud Save 패키지를 설치하면 Authentication 패키지가 종속적으로 함께 설치됩니다. 패키지 수동 설치에 대해 자세히 알아보려면 [레지스트리에서 패키지 설치](https://docs.unity3d.com/Manual/upm-ui-install.html)를 참고하십시오.

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

```cs
using Unity.Services.Authentication;
```

## Unity 프로젝트 연결##link-your-unity-project

설치가 완료되면 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 호출##call-the-cloud-save-sdk

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

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

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

```cs
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/tutorials/unity-sdk.md)을 참고하십시오.

## Cloud Save REST API##cloud-save-rest-api

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

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

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

* 플레이어 작업용 [Cloud Save 플레이어 API](https://services.docs.unity.com/cloud-save/)*(예: 데이터 저장/로딩)*
* 관리자 작업용 [Cloud Save 관리자 API](https://services.docs.unity.com/cloud-save-admin/)*(예: 쿼리/인덱스 구성)*

[REST API 튜토리얼](/cloud-save/tutorials/rest-api.md)에는 토큰 생성과 REST API 호출 방법에 대한 정보가 포함되어 있습니다.

## 추가 리소스##additional-resources

* [Cloud Save Unity SDK 튜토리얼](/cloud-save/tutorials/unity-sdk.md)
* [Cloud Code용 Cloud Save 튜토리얼](https://cloud-code-sdk-documentation.cloud.unity3d.com/cloud-save)
* [Cloud Save REST API 튜토리얼](./tutorials/rest-api.md)
* [Cloud Save CLI 모듈](https://services.docs.unity.com/guides/ugs-cli/latest/cloud-save/Cloud%20Save%20Command%20Line/overview/)