ドキュメント

サポート

Cloud Save

Unity SDK tutorial

Cloud Save for Cloud Code

Open Unity Dashboard

Cloud Save

使用の準備

Install the Cloud Save Software Development Kit and Authentication Software Development Kit in your Unity project to start using Cloud Save.
読み終わるまでの所要時間 2 分最終更新 8日前

Cloud Save SDK のインストール

Unity エディターでパッケージをインストールできます。 Window > Package Manager (ウィンドウ > パッケージマネージャー) に移動し、左上の Packages (パッケージ) ドロップダウンで 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 サービスによってプレイヤースコアを保持するアカウントが作成され、そのアカウントで 匿名ログイン や プラットフォーム固有の認証 を使用できます。 Authentication パッケージは、Cloud Save パッケージのインストール時に依存関係としてインストールされます。パッケージの手動インストールの詳細については、レジストリからのインストール を参照してください。 インストール後は、Unity スクリプト内で 
Unity.Services.Authentication
名前空間から以下のように Authentication SDK を使用できます。 
using Unity.Services.Authentication;

Unity プロジェクトのリンク

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 の呼び出し

使用する前に、ライフサイクルコールバックで Cloud Save SDK とその依存関係を初期化する必要があります。 これを行うには、
Unity.Services.Core
名前空間から 
await UnityServices.InitializeAsync()
を呼び出して、コア 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

Cloud Save 内のデータには REST API を使用してアクセスできます。 REST API はより柔軟性があり、開発者は好みの言語やゲーム開発エンジンを使用して、またはゲームサーバーから、ワークフローを自動化することができます。 Cloud Save サービスでは、以下の REST API が提供されます。 REST API のチュートリアル には、トークンを作成し、REST API を呼び出す方法の詳細が記載されています。

追加リソース