# 使用の準備

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

> **Warning:**
>
> **注意**: デジタルサービス法 (DSA) は、Unity が DSA に基づいて Unity のお客様のエンドユーザーに影響を及ぼす行動を取っているかについて、エンドユーザーに通知することを Unity に求めます。この要件に準拠するために、Unity Authentication Service を利用する Unity Gaming Services (UGS) 製品を使用している場合は、通知 API を組み込む必要があります。
>
> 詳細については、[Digital Services Act - compliance update](https://unity.com/legal/digital-services-act) を参照してください。
>
> ゲームを準拠させる方法については、[DSA notifications](/authentication/dsa-notifications.md.md) を参照してください。

## Cloud Save SDK のインストール##install-cloud-save-sdk

Unity エディターでパッケージをインストールできます。

**Window > Package Manager** (ウィンドウ > パッケージマネージャー) に移動し、左上の Packages (パッケージ) ドロップダウンで **Unity Registry** を選択します。以下のいずれかを行います。

* 右上の検索バーで **Cloud Save** を検索します。
* 名前を指定してパッケージを追加します。
  * **+** で示されているドロップダウンを開きます。
  * **Add package by name...** (パッケージを名前で追加...) を選択します。
  * パッケージ名 **"com.unity.services.cloudsave"** を入力します (バージョン番号は任意)。

> **Note:**
>
> **ノート**: SDK の `Samples` には、Cloud Save を使用してデータやファイルの読み書きを行う方法を示すコードが含まれています。

インストール後は、`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) を使用できます。

Authentication パッケージは、Cloud Save パッケージのインストール時に依存関係としてインストールされます。パッケージの手動インストールの詳細については、[レジストリからのインストール](https://docs.unity3d.com/Manual/upm-ui-install.html) を参照してください。

インストール後は、Unity スクリプト内で `Unity.Services.Authentication` 名前空間から以下のように Authentication SDK を使用できます。

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

## Unity プロジェクトのリンク##link-your-unity-project

Authentication パッケージをインストールすると、Unity プロジェクトを Unity Game Services プロジェクト ID にリンクするよう求めるプロンプトが表示されます。

プロジェクトが UGS プロジェクト ID にリンクされていない場合や、リンクする UGS プロジェクト ID を確認したい場合は、以下のステップに従って、Unity プロジェクトを UGS プロジェクト ID に手動でリンクします。

* Unity エディターで、**Edit** (編集) > **Project Settings...** (プロジェクト設定...) を選択します。
* **Services** (サービス) を選択し、
  * Unity ID がある場合はサインインします。
  * ない場合は、**Create a Unity ID** (Unity ID を作成) を選択します。
* プロジェクトを選択します。
* **Link** (リンク) を選択します。

## Cloud Save SDK の呼び出し##call-the-cloud-save-sdk

使用する前に、ライフサイクルコールバックで Cloud Save SDK とその依存関係を初期化する必要があります。

これを行うには、`Unity.Services.Core` 名前空間から `await UnityServices.InitializeAsync()` を呼び出して、コア 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

Cloud Save 内のデータには REST API を使用してアクセスできます。

REST API はより柔軟性があり、開発者は好みの言語やゲーム開発エンジンを使用して、またはゲームサーバーから、ワークフローを自動化することができます。

Cloud Save サービスでは、以下の REST API が提供されます。

* [Cloud Save Player API](https://services.docs.unity.com/cloud-save/): プレイヤーのアクション用 *(データの保存/ロードなど)*
* [Cloud Save Admin 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/)