GS2-Ranking API リファレンス

ランキング機能

スコアやクリアタイムのランキング処理を実現します。

ランキングには全員が同じデータを参照するグローバルランキングと、
フレンド間やギルド内のランキングのようなユーザーによって見えるランキングの内容の異なるスコープドランキングがあります。

グローバルランキングは、15分~24時間の間で指定した間隔でランキングの集計処理がおこなわれ、
ゲームユーザーからのリクエストは事前に集計された結果を応答します。
これによって、大量のゲームプレイヤーが居たとしてもレスポンスタイムは変わらないように設計されています。

スコープドランキングは各ゲームプレイヤーがスコアバケットをもち、購読しているゲームプレイヤーがスコアを登録するとスコアバケットにスコアが追加されます。
各ゲームプレイヤーは自分のスコアバケット内のスコアを使ってランキングを処理します。

グローバルランキング・スコープドランキング ともにユーザーID毎に保持できるスコアを1個にするか、複数保持できるかを設定できます。
ランキングを登録したときに最後に登録したスコアだけをランキング対象としたいか、登録したすべてのスコアをランキング対象としたいかで設定できます。
すべてのスコアをランキング対象とする場合、データ量が膨れ上がりやすくなります。その結果、GS2の利用料金にも影響を与えることとなります。
ゲームシステム上の大きな理由がなければ最後に登録された1つのスコアのみがランキング対象となるように設定することをお勧めします。


GS2-Ranking SDK for Game Engine API リファレンス

ゲームエンジン向け GS2-Ranking SDK の モデルの仕様 と API のリファレンス

GS2-Ranking SDK API リファレンス

各種プログラミング言語向け GS2-Ranking SDK の モデルの仕様 と API のリファレンス

GS2-Ranking Deploy/CDK リファレンス

GS2-Deployのスタックを作成する際に使用するテンプレートのフォーマットと、CDKによる各種言語のテンプレート出力の実装例

GS2-Ranking マスターデータリファレンス

マスターデータのフォーマットと インポートする各種モデルのリファレンス