GS2-SDK‎ > ‎GS2 SDK for Unity‎ > ‎

GS2-Ranking

ランキングを GS2 SDK for Unity から利用する手順を解説します。

ランキングテーブルを作成する

GS2マネージメントコンソールの GS2-Ranking から新しくランキングテーブルを作成します。
ランキングテーブルは複数のアカウントのスコアをまとめて管理する単位です。



『ランキングテーブルの新規作成』をクリックします。



ランキングテーブルの名前をつけます。
ランキングテーブルは異なるゲームごとにランキングを分けて管理する単位だと思ってください。


ランキングテーブルの詳細ページに遷移します。
新しくゲームモードを作成します。ゲームモードはステージ1のスコアランキング、ステージ2のスコアランキング。というようにランキング処理をする単位ごとに用意します。
『ゲームモードの新規作成』をクリックします。


ゲームモードの設定として、ゲームモードの名前。
スコアのソート方向（スコアランキングであれば降順、クリアタイムランキングであれば昇順）を設定し、
集計間隔 にはランキングを集計する間隔 15分〜24時間 の範囲で指定します。
GS2-Ranking は集計回数×参加人数で費用が発生しますので、ゲームの特性に合わせて集計間隔を調整してください。

これで、GS2マネージメントコンソールでおこなう準備は完了です。

ランキングを実装する

ここからは Unity での実装になります。
まずはログイン処理を実装する必要があります。ログインして Gs2.GameSession を取得するまでの手順は GS2-Auth をご参照ください。
ここからはログインが完了している前提で説明を進めます。

スコアを登録

  1. gs2.Ranking.Put (
  2.     result => {
  3.         if(result.Error != null) throw result.Error;
  4.         // スコアの登録が成功
  5.         Debug.Log("スコアの登録が完了しました");
  6.     },
  7.     session, // GS2 のログインセッション
  8.     RANKING_TABLE_NAME, // GS2-Ranking で作成したランキングテーブル名
  9.     GAME_MODE_NAME, // GS2-Ranking で作成したゲームモード名
  10.     1000, // 登録するスコア
  11.     "meta data"); // スコアに付加するメタデータ（プレイヤー名の格納などに利用できます）

gs2.Ranking.Put() でランキングにスコアを登録することが出来ます。
スコアには最大128バイトのメタデータをもたせることが出来ます。
プレイヤーの名前や、レースゲームであればゴーストデータのIDなどを格納するのに利用できます。

実装サンプル

  1. public class GameLogic : MonoBehaviour {
  2.     
  3.     private const string CLIENT_ID = "your client id";
  4.     private const string CLIENT_SECRET = "your client secret";
  6.     private const string RANKING_TABLE_NAME = "ranking-0001";
  7.     private const string GAME_MODE_NAME = "mode-0001";
  9.     Gs2.Client gs2;
  10.     Gs2.GameSession session;
  12.     void Start () {
  13.         // GS2 Client を初期化
  14.         gs2 = new Gs2.Client (new Gs2.Profile ()
  15.             .WithClientId (CLIENT_ID)
  16.             .WithClientSecret (CLIENT_SECRET));
  17.         
  18.         StartCoroutine (Login ());
  19.     }
  21.     IEnumerator Login() {
  22.         // GS2-Account を利用して認証します
  23.         string GAME_NAME = "game-0001";
  24.         string KEY_NAME = "account";
  25.         string USER_ID = "user";
  26.         string PASSWORD = "password";
  27.         string authenticationToken = null;
  28.         yield return gs2.Account.Authentication (
  29.             result => {
  30.                 if(result.Error != null) throw result.Error;
  31.                 authenticationToken = result.Result;
  32.             },
  33.             GAME_NAME,
  34.             KEY_NAME,
  35.             USER_ID,
  36.             PASSWORD);
  38.         // GS2-Account の認証情報を利用して GS2 にログインします
  39.         yield return gs2.Auth.Login (
  40.             result => {
  41.                 if(result.Error != null) throw result.Error;
  42.                 session = result.Result;
  43.             },
  44.             USER_ID,
  45.             KEY_NAME,
  46.             authenticationToken);
  48.         StartCoroutine (PutScore ());
  49.     }
  51.     IEnumerator PutScore() {
  52.         // スコアを登録します
  53.         yield return gs2.Ranking.Put (
  54.             result => {
  55.                 if(result.Error != null) throw result.Error;
  56.                 // スコアの登録が成功
  57.                 Debug.Log("スコアの登録が完了しました");
  58.             },
  59.             session,                 // GS2 のログインセッション
  60.             RANKING_TABLE_NAME,      // GS2-Ranking で作成したランキングテーブル名
  61.             GAME_MODE_NAME,          // GS2-Ranking で作成したゲームモード名
  62.             1000,                    // 登録するスコア
  63.             "meta data");            // スコアに付加するメタデータ（プレイヤー名の格納などに利用できます）
  64.     }
  66.     void Update () {
  68.     }
  69. }

ランキングを取得

  1. gs2.Ranking.GetRanking (
  2.     result => {
  3.         if(result.Error != null) throw result.Error;
  4.         Debug.Log("--- Ranking ---");
  5.         foreach(Gs2.Ranking.Ranking ranking in result.Result) {
  6.             Debug.Log("[" + ranking.Rank + "] " + ranking.Score + " " + ranking.Meta);
  7.         }
  8.     },
  9.     session, // GS2 のログインセッション
  10.     RANKING_TABLE_NAME, // GS2-Ranking で作成したランキングテーブル名
  11.     GAME_MODE_NAME, // GS2-Ranking で作成したゲームモード名
  12.     0, // ランキングの取得開始オフセット
  13.     10); // ランキングの取得件数

ランキングデータを取得します。
ランキングデータはランダムアクセスが可能で、指定したオフセットから指定した件数のデータを取得できます。
通常、データベースの特性上ランキングの下位となるランキング一覧取得には時間がかかりますが、
GS2-Ranking はアクセス時間が常に一定となるよう設計されています。

実装サンプル

  1. public class GameLogic : MonoBehaviour {
  2.     
  3.     private const string CLIENT_ID = "your client id";
  4.     private const string CLIENT_SECRET = "your client secret";
  6.     private const string RANKING_TABLE_NAME = "ranking-0001";
  7.     private const string GAME_MODE_NAME = "mode-0001";
  9.     Gs2.Client gs2;
  10.     Gs2.GameSession session;
  12.     void Start () {
  13.         // GS2 Client を初期化
  14.         gs2 = new Gs2.Client (new Gs2.Profile ()
  15.             .WithClientId (CLIENT_ID)
  16.             .WithClientSecret (CLIENT_SECRET));
  17.         
  18.         StartCoroutine (Login ());
  19.     }
  21.     IEnumerator Login() {
  22.         // GS2-Account を利用して認証します
  23.         string GAME_NAME = "game-0001";
  24.         string KEY_NAME = "account";
  25.         string USER_ID = "user";
  26.         string PASSWORD = "password";
  27.         string authenticationToken = null;
  28.         yield return gs2.Account.Authentication (
  29.             result => {
  30.                 if(result.Error != null) throw result.Error;
  31.                 authenticationToken = result.Result;
  32.             },
  33.             GAME_NAME,
  34.             KEY_NAME,
  35.             USER_ID,
  36.             PASSWORD);
  38.         // GS2-Account の認証情報を利用して GS2 にログインします
  39.         yield return gs2.Auth.Login (
  40.             result => {
  41.                 if(result.Error != null) throw result.Error;
  42.                 session = result.Result;
  43.             },
  44.             USER_ID,
  45.             KEY_NAME,
  46.             authenticationToken);
  48.         StartCoroutine (GetRanking ());
  49.     }
  51.     IEnumerator GetRanking() {
  52.         // TOP10 のランキングを取得します
  53.         yield return gs2.Ranking.GetRanking (
  54.             result => {
  55.                 if(result.Error != null) throw result.Error;
  56.                 Debug.Log("--- Ranking ---");
  57.                 foreach(Gs2.Ranking.Ranking ranking in result.Result) {
  58.                     Debug.Log("[" + ranking.Rank + "] " + ranking.Score + " " + ranking.Meta);
  59.                 }
  60.             },
  61.             session, // GS2 のログインセッション
  62.             RANKING_TABLE_NAME, // GS2-Ranking で作成したランキングテーブル名
  63.             GAME_MODE_NAME, // GS2-Ranking で作成したゲームモード名
  64.             0,                         // ランキングの取得開始オフセット
  65.             10);                     // ランキングの取得件数
  66.     }
  68.     void Update () {
  70.     }
  71. }

自分の現在の順位を取得

  1. gs2.Ranking.GetMyRank (
  2.     result => {
  3.         if(result.Error != null) throw result.Error;
  4.         // 自分の順位の取得に成功
  5.         Debug.Log("インデックス: " + result.Result.Index);
  6.         Debug.Log("順位: " + result.Result.Rank);
  7.     },
  8.     session, // GS2 のログインセッション
  9.     RANKING_TABLE_NAME, // GS2-Ranking で作成したランキングテーブル名
  10.     GAME_MODE_NAME); // GS2-Ranking で作成したゲームモード名

順位情報には『インデックス』と『ランク』があります。
インデックスは同一スコアを別扱いした先頭からの位置情報。プレイヤーの前後のランキングを取得する際などに利用できます。ランクは同一スコアを同一順位とした順位情報です。
例えば、『ユーザA: 1000点』『ユーザB: 1000点』『ユーザC: 2000点』 というスコアで昇順のランキングだった場合は

 インデックス ランク ユーザ スコア
 1 1 ユーザA 1000点
 2 1 ユーザB 1000点
 3 3 ユーザC 2000点

となります。
同一スコアのユーザのどちらが上位のインデックスが付けられるかは不定です。

実装サンプル

  1. public class GameLogic : MonoBehaviour {
  2.     
  3.     private const string CLIENT_ID = "your client id";
  4.     private const string CLIENT_SECRET = "your client secret";
  6.     private const string RANKING_TABLE_NAME = "ranking-0001";
  7.     private const string GAME_MODE_NAME = "mode-0001";
  9.     Gs2.Client gs2;
  10.     Gs2.GameSession session;
  12.     void Start () {
  13.         // GS2 Client を初期化
  14.         gs2 = new Gs2.Client (new Gs2.Profile ()
  15.             .WithClientId (CLIENT_ID)
  16.             .WithClientSecret (CLIENT_SECRET));
  17.         
  18.         StartCoroutine (Login ());
  19.     }
  21.     IEnumerator Login() {
  22.         // GS2-Account を利用して認証します
  23.         string GAME_NAME = "game-0001";
  24.         string KEY_NAME = "account";
  25.         string USER_ID = "user";
  26.         string PASSWORD = "password";
  27.         string authenticationToken = null;
  28.         yield return gs2.Account.Authentication (
  29.             result => {
  30.                 if(result.Error != null) throw result.Error;
  31.                 authenticationToken = result.Result;
  32.             },
  33.             GAME_NAME,
  34.             KEY_NAME,
  35.             USER_ID,
  36.             PASSWORD);
  38.         // GS2-Account の認証情報を利用して GS2 にログインします
  39.         yield return gs2.Auth.Login (
  40.             result => {
  41.                 if(result.Error != null) throw result.Error;
  42.                 session = result.Result;
  43.             },
  44.             USER_ID,
  45.             KEY_NAME,
  46.             authenticationToken);
  48.         StartCoroutine (GetMyRank ());
  49.     }
  50.         
  51.     IEnumerator GetMyRank() {
  52.         // 自分の順位を取得します
  53.         yield return gs2.Ranking.GetMyRank (
  54.             result => {
  55.                 if(result.Error != null) throw result.Error;
  56.                 // 自分の順位の取得に成功
  57.                 Debug.Log("インデックス: " + result.Result.Index);
  58.                 Debug.Log("順位: " + result.Result.Rank);
  59.             },
  60.             session, // GS2 のログインセッション
  61.             RANKING_TABLE_NAME, // GS2-Ranking で作成したランキングテーブル名
  62.             GAME_MODE_NAME); // GS2-Ranking で作成したゲームモード名
  63.     }
  65.     void Update () {
  67.     }
  68. }

Comments