GS2-Idle トランザクションアクション

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

ConsumeAction

消費アクション

Gs2Idle:DecreaseMaximumIdleMinutesByUserId

ユーザーIDを指定して最大待機時間を減算

指定されたカテゴリーにおけるユーザーの最大待機時間から指定された分数を減算します。
最大待機時間はゼロを下回ることはできません。
ステータスがまだ存在しない場合、減算を適用する前に自動的に作成されます。

数量指定可能なアクション：はい

反転可能なアクション：はい

型有効化条件必須デフォルト値の制限説明
namespaceNamestring
✓
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
✓
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
categoryNamestring
✓
~ 128文字カテゴリーモデル名
このステータスが属するカテゴリーモデルの名前です。放置報酬計算に使用される報酬間隔、最大放置時間、入手アクション、スケジュール設定を含むカテゴリーモデル定義を参照します。
decreaseMinutesint1 ~ 2147483646最大待機時間を減らす分数
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Idle:DecreaseMaximumIdleMinutesByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "categoryName": "[string]カテゴリーモデル名",
        "decreaseMinutes": "[int]最大待機時間を減らす分数",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Idle:DecreaseMaximumIdleMinutesByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  categoryName: "[string]カテゴリーモデル名"
  decreaseMinutes: "[int]最大待機時間を減らす分数"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("idle").consume.decrease_maximum_idle_minutes_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    categoryName="[string]カテゴリーモデル名",
    decreaseMinutes="[int]最大待機時間を減らす分数",
    timeOffsetToken="[string]タイムオフセットトークン",
})

AcquireAction

入手アクション

Gs2Idle:IncreaseMaximumIdleMinutesByUserId

ユーザーIDを指定して最大待機時間を加算

指定されたカテゴリーにおけるユーザーの最大待機時間に指定された分数を加算します。
最大待機時間は、放置報酬が蓄積される時間の上限を決定します。
ステータスがまだ存在しない場合、加算を適用する前に自動的に作成されます。

数量指定可能なアクション：はい

反転可能なアクション：はい

型有効化条件必須デフォルト値の制限説明
namespaceNamestring
✓
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
✓
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
categoryNamestring
✓
~ 128文字カテゴリーモデル名
このステータスが属するカテゴリーモデルの名前です。放置報酬計算に使用される報酬間隔、最大放置時間、入手アクション、スケジュール設定を含むカテゴリーモデル定義を参照します。
increaseMinutesint1 ~ 2147483646最大待機時間を増やす分数
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Idle:IncreaseMaximumIdleMinutesByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "categoryName": "[string]カテゴリーモデル名",
        "increaseMinutes": "[int]最大待機時間を増やす分数",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Idle:IncreaseMaximumIdleMinutesByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  categoryName: "[string]カテゴリーモデル名"
  increaseMinutes: "[int]最大待機時間を増やす分数"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("idle").acquire.increase_maximum_idle_minutes_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    categoryName="[string]カテゴリーモデル名",
    increaseMinutes="[int]最大待機時間を増やす分数",
    timeOffsetToken="[string]タイムオフセットトークン",
})

Gs2Idle:SetMaximumIdleMinutesByUserId

ユーザーIDを指定して最大待機時間を設定

指定されたカテゴリーにおけるユーザーの最大待機時間を指定された絶対値に設定します。
加算/減算操作とは異なり、現在の最大待機時間を直接置き換えます。
更新後のステータスと更新前のステータスの両方を返すため、呼び出し元は変更内容を確認できます。
ステータスがまだ存在しない場合、値を適用する前に自動的に作成されます。

数量指定可能なアクション：いいえ

反転可能なアクション：いいえ

型有効化条件必須デフォルト値の制限説明
namespaceNamestring
✓
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
✓
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
categoryNamestring
✓
~ 128文字カテゴリーモデル名
このステータスが属するカテゴリーモデルの名前です。放置報酬計算に使用される報酬間隔、最大放置時間、入手アクション、スケジュール設定を含むカテゴリーモデル定義を参照します。
maximumIdleMinutesint1 ~ 2147483646設定する最大待機時間
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Idle:SetMaximumIdleMinutesByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "categoryName": "[string]カテゴリーモデル名",
        "maximumIdleMinutes": "[int]設定する最大待機時間",
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Idle:SetMaximumIdleMinutesByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  categoryName: "[string]カテゴリーモデル名"
  maximumIdleMinutes: "[int]設定する最大待機時間"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("idle").acquire.set_maximum_idle_minutes_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    categoryName="[string]カテゴリーモデル名",
    maximumIdleMinutes="[int]設定する最大待機時間",
    timeOffsetToken="[string]タイムオフセットトークン",
})

Gs2Idle:ReceiveByUserId

ユーザーIDを指定して報酬を受け取る

指定されたユーザーとカテゴリーの蓄積された待機時間に基づいて放置報酬を受け取ります。
報酬量は、経過した待機時間を rewardIntervalMinutes で割った値から計算され、maximumIdleMinutes で上限が設定されます。
receiveScript が設定されている場合、報酬付与前に実行され、受け取り操作を変更または拒否できます。
overrideAcquireActionsScriptId によって入手アクション（レート修正の適用など）を変更することも可能です。
受け取り後、待機タイマーは現在時刻にリセットされます。
計算された報酬の入手アクションを含むトランザクションを返します。

数量指定可能なアクション：いいえ

反転可能なアクション：いいえ

型有効化条件必須デフォルト値の制限説明
namespaceNamestring
✓
~ 128文字ネームスペース名
ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
userIdstring
✓
~ 128文字ユーザーID
#{userId} と設定することでログイン中のユーザーIDに置換されます。
categoryNamestring
✓
~ 128文字カテゴリーモデル名
このステータスが属するカテゴリーモデルの名前です。放置報酬計算に使用される報酬間隔、最大放置時間、入手アクション、スケジュール設定を含むカテゴリーモデル定義を参照します。
configList<Config>[]0 ~ 32 itemsトランザクションの変数に適用する設定値
timeOffsetTokenstring~ 1024文字タイムオフセットトークン
{
    "action": "Gs2Idle:ReceiveByUserId",
    "request": {
        "namespaceName": "[string]ネームスペース名",
        "userId": "[string]ユーザーID",
        "categoryName": "[string]カテゴリーモデル名",
        "config": [
            {
                "key": "[string]名前",
                "value": "[string]値"
            }
        ],
        "timeOffsetToken": "[string]タイムオフセットトークン"
    }
}
action: Gs2Idle:ReceiveByUserId
request:
  namespaceName: "[string]ネームスペース名"
  userId: "[string]ユーザーID"
  categoryName: "[string]カテゴリーモデル名"
  config: 
    - key: "[string]名前"
      value: "[string]値"
  timeOffsetToken: "[string]タイムオフセットトークン"
transaction.service("idle").acquire.receive_by_user_id({
    namespaceName="[string]ネームスペース名",
    userId="[string]ユーザーID",
    categoryName="[string]カテゴリーモデル名",
    config={
        {
            key="[string]名前",
            value="[string]値"
        }
    },
    timeOffsetToken="[string]タイムオフセットトークン",
})