Game Server Services(GS2)を使ってUnityでアカウントの引き継ぎ機能を実装してみた

入井啓太

2024.01.22

今回は、GS2-Accountの引き継ぎ機能を利用して、ゲームを実行するデバイスの変更時などにゲームアカウント情報の引き継ぎができる機能をUnityで実装してみたので、その内容をご紹介します。

環境

Unity 2022.3.14f1
UniTask 2.5.0
GS2 C# SDK 2023.12.10
GS2 SDK for Unity 2023.12.14

アカウントの引き継ぎとは

今回紹介する機能はスマートフォン向けのソーシャルゲームなどでよく実装されている機能で、ユーザーが異なるデバイスで同じアカウントを利用したい場合に利用されます。例えば、ユーザーが最初にゲームをインストールしたスマートフォンから機種変更しても同じアカウント情報を利用したかったり、マルチプラットフォームで展開されているゲームで上の画像のようにスマートフォン版でもPC版でも同じアカウントを共有できるようにしたい場合に便利な機能です。

具体的な引き継ぎの方法としては、一時的な引き継ぎ用パスワードを作成しそれを引き継ぎ先のデバイスで入力する方法の他、GoogleやFacebook等のアカウントにゲームアカウントを紐付ける方法などがよく使われています。

こういった機能がソーシャルゲームなどのモバイル環境のゲームでよく実装される理由として、多くのモバイルゲームで匿名アカウントの仕組みが使われている点が挙げられます。匿名アカウントとは、サーバー上で最低限のプレイヤーの識別をすることのみを目的にしたアカウントです。一般的なアカウントとは異なり、IDとパスワードをシステムがランダムに決定します。プレイヤーがどういった人間であるかは識別する必要がないため、匿名アカウントの作成にユーザーは通常関与しません。

一般的なWebサービスでは最初にアカウント登録を行い、その後は作成したアカウントを利用すればどのデバイスでも同じアカウントを利用できますが、ソーシャルゲームなどでは多くの場合ゲームの初回起動時にユーザーからは見えないところで匿名アカウントが自動的に作成され、次回以降の起動時はデバイスに保存された認証パラメータを元にアカウントへ自動的にログインします。ユーザーがアカウントの存在自体を認識しない仕組みになっているため、異なるデバイスでアカウントを共有するためには上記のような引き継ぎ機能の用意が必要になってきます。

なぜ、このような匿名アカウントの仕組みを採用するモバイルゲームが多いかの理由としては、アカウント作成などの煩わしい手間をかけることなく、少しでも気軽にユーザーにゲームを触ってもらうため、という点が大きいと思われます。

GS2における引き継ぎ

匿名アカウントを管理できるGS2-Accountには、標準でアカウントデータの引き継ぎを行うための機能が用意されています。

各ユーザーアカウントには、引き継ぎ情報をリスト形式で登録することが可能です。1つの引き継ぎ情報は、以下のフォーマットで構成されています。

名前	説明
slot	引き継ぎ情報の識別用スロット番号。1つのアカウントにつき0〜1024まで登録可能。0はパスワード引き継ぎ用、1はGoogleアカウントによる引き継ぎ用、などといった形で用途で使い分けることが想定されている。
userIdentifier	引き継ぎ用ユーザーID。ゲームのユーザーIDや、Google等のサービスのIDなどを登録。
password	引き継ぎを実行するための一時パスワードなどを登録

引き継ぎ実行の際は、あらかじめ登録したこれら3つの情報の正しい組み合わせをパラメータにして専用APIへリクエストすることで、引き継ぎ先のアカウントの認証セッション情報が取得できる仕組みになっています。

GS2-Account | Game Server Services | Docs

実装

ここからは、実際にどのように引き継ぎ機能を実装したかを紹介していきます。

今回、Unityで以下のようなUIが表示されるゲームプロジェクトを作成しました。

画面左は新規で引き継ぎ情報を登録するためのフォームで、右は登録済みの情報を入力することで引き継ぎを実行するためのフォームです。また、画面上ではログイン中のGS2ユーザーアカウントのIDが表示されるようになっています。

アカウントの引き継ぎ方法としてGoogle アカウント等の外部サービスと連携する方法もありますが、今回はシンプルな実装にするためにIDとパスワードによる引き継ぎの方式を採用しています。

なお、GS2 APIの呼び出しにはUnity用のSDKを使用しており、UniTaskを使用して非同期処理が簡潔に書けるようにしています。

ゲーム起動時の認証処理

最初に、以下のStart()が実行されるようになっています。

内容としては、PlayerPrefs（Unity標準のセーブ機能）にGS2のログインパラメータ情報が保存されているかを確認し、保存されていない場合は新規で匿名アカウントを作成し、そのIDとパスワードをPlayerPrefsへ保存した上でログイン、保存されている場合はそのパラメータを使ってログイン、という処理の流れになっています。これにより、ソーシャルゲーム等でよくある初回起動時にユーザーの見えないところで匿名アカウントを作成し、次回起動以降はそのアカウントへログインする機能を実現しています。

Gs2Login()は、匿名アカウントにログインする際に使用するメソッドで、ログイン処理の他にセッション情報の保存やユーザーID表示等のUI操作も行っています。セッション情報は、GS2の様々なマイクロサービスのAPIを利用する際に必要となるため、他コンポーネントでも共有できるようScriptableObjectに保存しています。

なお、GS2 Clientの作成には専用のstaticメソッドを外部に作成しそれを呼び出しています。

using System;
using Cysharp.Threading.Tasks;
using Gs2.Unity.Core;
using Gs2.Unity.Util;
using TMPro;
using UnityEngine;

public class Gs2AccountAuth : MonoBehaviour
{
    [SerializeField] GameObject accountMenuPanel;
    [SerializeField] UserData userData;
    [SerializeField] TMP_Text loginStatus;

    private Gs2Domain _gs2;
    private const string AccountNamespaceName = "game-0001";

    async void  Start()
    {
        _gs2 = await MyGs2Client.CreateClient();

        var gs2Account = _gs2.Account.Namespace(AccountNamespaceName);

        var gs2UserId = PlayerPrefs.GetString("Gs2UserId", "");
        var gs2Password = PlayerPrefs.GetString("Gs2Password", "");

        if (gs2UserId == "" || gs2Password == "")
        {
            // アカウントの新規作成
            var account = await (await gs2Account.CreateAsync()).ModelAsync();

            PlayerPrefs.SetString("Gs2UserId", account.UserId);
            PlayerPrefs.SetString("Gs2Password", account.Password);
            PlayerPrefs.Save();

           await Gs2Login(account.UserId, account.Password);
        }
        else
        {
            await Gs2Login(gs2UserId, gs2Password);
        }
    }

     public async UniTask Gs2Login(string userId, string password)
     {
         try
         {
             var gameSession = await _gs2.LoginAsync(
                 new Gs2AccountAuthenticator(new AccountSetting { accountNamespaceName = AccountNamespaceName }),
                 userId,
                 password
             );

             // セッション情報を他コンポーネントで共有するために保存
             userData.GameSession = gameSession;

             // UI操作
             accountMenuPanel.SetActive(true);
             loginStatus.text = $"ログイン中 - {userData.GameSession.UserId}";
         }
         catch (Exception e)
         {
             Debug.LogError(e);
         }
     }
}

引き継ぎデータの登録

画面左側の引き継ぎ登録用ボタンをクリックすると、以下のSubmit()メソッドが実行されるようになっています。

具体的な流れとしては、TakeOver(0).AddTakeOverSettingAsync()によって、フォームで入力したuserIdentifier、passwordの内容でGS2-Account内のログイン中ユーザーのスロット0に引き継ぎ情報が登録されるようリクエストを実行し、その完了後にフォームの内容リセットや処理結果テキストの表示等のUI操作を行っています。

using System;
using Cysharp.Threading.Tasks;
using Gs2.Unity.Core;
using TMPro;
using UnityEngine;
public class Gs2NewTakeOver : MonoBehaviour
{
    [SerializeField] private UserData userData;
    [SerializeField] private TMP_InputField userIdentifierInput;
    [SerializeField] private TMP_InputField passwordInput;
    [SerializeField] private TMP_Text resultText;

    private Gs2Domain _gs2;
    async void Start()
    {
        _gs2 = await MyGs2Client.CreateClient();
    }

    public async void Submit()
    {
        await _gs2.Account.Namespace(namespaceName: "game-0001")
            .Me(userData.GameSession)
            .TakeOver(0)
            .AddTakeOverSettingAsync(userIdentifierInput.text, passwordInput.text);

        // UI操作
        userIdentifierInput.text = "";
        passwordInput.text = "";

        resultText.gameObject.SetActive(true);
        resultText.text = "引き継ぎ情報の登録が完了しました。";
        await UniTask.Delay(TimeSpan.FromSeconds(3));
        resultText.gameObject.SetActive(false);
    }
}

引き継ぎの実行

画面右側の引き継ぎ実行ボタンをクリックすると、以下のSubmit()メソッドが実行されるようになっています。

具体的な処理の流れとしては、DoTakeOverAsync()によってフォームに入力したuserIdentifier、passwordの内容で引き継ぎの実行をリクエストし、正しい内容であれば引き継ぎ先アカウントの情報を使って改めてログイン処理、誤った内容であればその旨をテキストで表示する形になっています。

引き継ぎ成功時のログイン処理には、ゲーム起動時に実行されるのと同じGs2Login()を使用しており、これによって画面上のログインユーザーIDの表示も引き継ぎ先アカウントのものに書き換わるようにしています。

using System;
using Cysharp.Threading.Tasks;
using Gs2.Gs2Account.Exception;
using Gs2.Unity.Core;
using TMPro;
using UnityEngine;

public class Gs2TakeOver : MonoBehaviour
{
    [SerializeField] private TMP_InputField userIdentifierInput;
    [SerializeField] private TMP_InputField passwordInput;
    [SerializeField] private GameObject gs2AccountAuthObject;
    [SerializeField] private TMP_Text resultText;

    private Gs2Domain _gs2;
    async void Start()
    {
        _gs2 = await MyGs2Client.CreateClient();
    }

    public async void Submit()
    {
        try
        {
            var result = await _gs2.Account.Namespace(namespaceName: "game-0001")
                .DoTakeOverAsync(0, userIdentifierInput.text, passwordInput.text);
            var account = await result.ModelAsync();

            var gs2AccountAuth = gs2AccountAuthObject.GetComponent<Gs2AccountAuth>();
            await gs2AccountAuth.Gs2Login(account.UserId, account.Password);

            // UI操作
            resultText.gameObject.SetActive(true);
            resultText.text = "他アカウントへの引き継ぎが完了しました。";
            await UniTask.Delay(TimeSpan.FromSeconds(3));
            resultText.gameObject.SetActive(false);
        }
        catch (PasswordIncorrectException e)
        {
            Debug.LogError(e);

            // UI操作
            resultText.gameObject.SetActive(true);
            resultText.text = "入力内容に誤りがあります。";
            await UniTask.Delay(TimeSpan.FromSeconds(3));
            resultText.gameObject.SetActive(false);
        }
    }
}