GS2-Grade Script トリガー リファレンス

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

トリガー

changeGrade

グレード変化

同期実行スクリプト

グレード変化処理の前に、スクリプトが同期実行されます。

Request
説明
namespace Namespace ネームスペース
gradeModel GradeModel グレードモデル
status Status 変化前ステータス
afterStatus Status 変化後ステータス
Result
必須 デフォルト 値の制限 説明
permit bool
グレード変化 を許可するか
overrideGradeValue long
0 ~ 2147483645 上書きするグレード値
実装例
-- Request
local namespace = args.namespace
local gradeModel = args.gradeModel
local status = args.status
local afterStatus = args.afterStatus

-- Business logic:
local permit = true
local overrideGradeValue = 0

-- Result
result = {
  permit=permit,
  overrideGradeValue=overrideGradeValue
}

非同期実行スクリプト

グレード変化処理の後に、スクリプトが非同期実行されます。

Request
説明
namespace Namespace ネームスペース
gradeModel GradeModel グレードモデル
status Status ステータス
afterStatus Status 変化後ステータス
実装例
-- Request
local namespace = args.namespace
local gradeModel = args.gradeModel
local status = args.status
local afterStatus = args.afterStatus

-- 非同期スクリプトは通常、API のレスポンスには影響を与えません。
-- ログ出力や分析、外部通知などに使用します。

result = {
}