GS2-Ranking2 API リファレンス

ランキング機能

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

GS2-Ranking2 は、グローバルランキング・クラスターランキング・購読ランキングの3種類を提供します。

  • グローバルランキングはスコアを即時に反映し、上位1,000人だけをランキングとして保持します。それより下位のプレイヤーは圏外として扱われます。
  • クラスターランキングは、ギルドIDなどのクラスターIDごとに個別のランキングを作成します。スコア登録時に、プレイヤーが対象のクラスターへ所属していることを検証することもできます。
  • 購読ランキングは、プレイヤーが購読した他プレイヤーのスコアから個別のランキングを構成し、フレンド内ランキングのような非対称な関係に利用できます。スコアは非同期で反映され、通常は1秒以内に更新されます。

ランキングには GS2-Schedule のイベントをシーズンとして関連づけられます。
イベントの繰り返しごとに新しいシーズンを開始して過去の結果を保持し、順位の閾値に応じた報酬を設定できます。


ゲームから使う

Game Engine

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

SDK

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

設定・連携

Deploy/CDK

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

Master Data

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

Transaction Action

検証/消費/入手の各トランザクションアクションの仕様