使用の準備
Install the Cloud Save Software Development Kit and Authentication Software Development Kit in your Unity project to start using Cloud Save.
読み終わるまでの所要時間 2 分最終更新 1日前
注意
注意: デジタルサービス法 (DSA) は、Unity が DSA に基づいて Unity のお客様のエンドユーザーに影響を及ぼす行動を取っているかについて、エンドユーザーに通知することを Unity に求めます。この要件に準拠するために、Unity Authentication Service を利用する Unity Gaming Services (UGS) 製品を使用している場合は、通知 API を組み込む必要があります。詳細については、Digital Services Act - compliance update を参照してください。ゲームを準拠させる方法については、DSA notifications を参照してください。
Cloud Save SDK のインストール
Unity エディターでパッケージをインストールできます。 Window > Package Manager (ウィンドウ > パッケージマネージャー) に移動し、左上の Packages (パッケージ) ドロップダウンで 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 サービスによってプレイヤースコアを保持するアカウントが作成され、そのアカウントで 匿名ログイン や プラットフォーム固有の認証 を使用できます。 Authentication パッケージは、Cloud Save パッケージのインストール時に依存関係としてインストールされます。パッケージの手動インストールの詳細については、レジストリからのインストール を参照してください。 インストール後は、Unity スクリプト内でUnity.Services.Authenticationusing 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.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
Cloud Save 内のデータには REST API を使用してアクセスできます。 REST API はより柔軟性があり、開発者は好みの言語やゲーム開発エンジンを使用して、またはゲームサーバーから、ワークフローを自動化することができます。 Cloud Save サービスでは、以下の REST API が提供されます。- Cloud Save Player API: プレイヤーのアクション用 (データの保存/ロードなど)
- Cloud Save Admin API: 開発者のアクション用 (クエリ/インデックスの設定など)