使用の準備

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

読み終わるまでの所要時間 7 分

最終更新 8ヶ月前

注意

注意: デジタルサービス法 (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 の

Samples

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

インストール後は、

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 が提供されます。

Cloud Save Player API: プレイヤーのアクション用 (データの保存/ロードなど)
Cloud Save Admin API: 開発者のアクション用 (クエリ/インデックスの設定など)

REST API のチュートリアルには、トークンを作成し、REST API を呼び出す方法の詳細が記載されています。

ドキュメント

Development

User Acquisition

Monetization

産業