使用の準備
Cloud Save SDK のインストール
Unity エディターでパッケージをインストールできます。
Window > Package Manager に移動し、左上の Packages (パッケージ) ドロップダウンで Unity Registry を選択します。以下のいずれかを行います。
- 右上の検索バーで Cloud Save を検索します。
- 名前を指定してパッケージを追加します。+ で示されているドロップダウンを開き、Add package by name... (パッケージを名前で追加...) を選択します。SDK パッケージ ID の "com.unity.services.cloudsave" をバージョン番号なしで検索します。
ノート: Samples セクションでは、ゲームから Cloud Save SDK を呼び出すのに役立つサンプルコードをプロジェクトにインポートできます。
インストール後は、Unity スクリプト内で 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 にリンクするよう求めるプロンプトが表示されます。
以下のステップに従って、Unity プロジェクトをプロジェクト ID に手動でリンクします。
- Unity エディターで、Edit (編集) > Project Settings... (プロジェクト設定...) を選択します。
- Services (サービス) を選択し、
- Unity ID がある場合はサインインします。
- ない場合は、Create a Unity ID (Unity ID を作成) を選択します。
- プロジェクトを選択します。
- Link (リンク) を選択します。
SDK の初期化およびプレイヤーの認証
使用する前に、Unity スクリプトのライフサイクルコールバック内から Cloud Save SDK とその依存関係を初期化する必要があります。
これを行うには、Unity.Services.Core 名前空間から await UnityServices.InitializeAsync() を呼び出して、コア SDK を介してインストールしたすべてのサービスを初期化します。
SDK の初期化が完了した後に、プレイヤーが認証されます。以下の例では、プレイヤーがスコアを保持できるように、匿名認証を使用して匿名アカウントを作成しています。Unity Authentication のドキュメントに記載されているように、その他の認証方法も利用できます。
using UnityEngine;
using Unity.Services.Core;
using Unity.Services.Authentication;
public class CloudSaveSample : MonoBehaviour
{
private async void Awake()
{
await UnityServices.InitializeAsync();
await AuthenticationService.Instance.SignInAnonymouslyAsync();
}
}Cloud Save REST API
Cloud Save 内のデータには REST API を使用してアクセスできます。
REST API はより柔軟性があり、開発者は好みの言語やゲーム開発エンジンを使用してワークフローを自動化することができます。
Cloud Save サービスでは、以下の REST API が提供されます。
- Cloud Save Player API: プレイヤーのアクション用 (データの保存/ロードなど)
- Cloud Save Admin API: 開発者のアクション用 (クエリ/インデックスの設定など)