GS2-Exchange API リファレンス

ゲーム内リソースの交換機能

アイテムの売却価格や、レアリティが異なる進化素材間の交換レートなど、常設される交換処理を実現します。

GS2-Exchange は、あるマイクロサービスで管理するリソースを、同じサービスまたは別のマイクロサービスで管理するリソースへ交換します。
交換レートには対価を検証・消費するアクションと、報酬を付与するアクションを設定し、一連の交換処理を整合性のある形で実行できます。

交換方式には3種類あります。

  • ダイレクト交換では、即座に報酬を受け取ります。
  • 非同期交換では、交換時に対価を消費し、待機時間の経過後に報酬を受け取ります。追加の対価を支払って待機時間を短縮することもできます。
  • コスト上昇型交換は、購入するたびに価格が上がり、設定した周期で購入回数をリセットするスタミナ回復などの仕様に利用できます。

ゲームから使う

Game Engine

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

SDK

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

設定・連携

Deploy/CDK

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

Master Data

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

Script

拡張スクリプトを呼び出すイベントトリガーのリファレンス

Transaction Action

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

Buff

GS2-Buff でバフを適用する際に指定する、パラメーターの補正が可能なモデル/アクション内のフィールドと、その適用範囲の設定について