GS2-Experience トランザクションアクション
VerifyAction
検証アクション
Gs2Experience:VerifyRankByUserId
ユーザーIDを指定してランクを検証
指定されたユーザーの現在のランクが指定された値に対する条件を満たすことを検証します。
6つの比較演算子をサポート:less、lessEqual、greater、greaterEqual、equal、notEqual。
検証条件を満たさない場合はエラー(BadRequest)を返します。
数量指定可能なアクション:いいえ
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||||||||||||||||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||||||||||||||||
| experienceName | string | ✓ | ~ 128文字 | 経験値モデル名 このステータスのランキングルールを定義する経験値モデルの名前です。どのランクアップ閾値テーブルとランクキャップ設定が適用されるかを決定します。 | ||||||||||||||||
| verifyType | 文字列列挙型 enum { “less”, “lessEqual”, “greater”, “greaterEqual”, “equal”, “notEqual” } | ✓ | 検証の種類
| |||||||||||||||||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID ユーザースコープ内でこのステータスを一意に識別する開発者定義の識別子です。経験値を持つ GS2-Inventory のアイテムセット GRN や GS2-Dictionary のエントリー GRN の末尾に経験値モデルのサフィックスを付与した値を使用することを推奨します。 | ||||||||||||||||
| rankValue | long | 0 | 0 ~ 9223372036854775805 | 現在のランク ランクアップ閾値テーブルを使用して累計経験値から算出されるランク(レベル)です。0 から開始し、経験値閾値を超えるごとに増加します。現在のランクキャップ値を超えることはできません。 | ||||||||||||||||
| multiplyValueSpecifyingQuantity | bool | false | 数量指定した際に、検証に使用する値も乗算するか | |||||||||||||||||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Experience:VerifyRankByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"experienceName": "[string]経験値モデル名",
"verifyType": "[string]検証の種類",
"propertyId": "[string]プロパティID",
"rankValue": "[long]現在のランク",
"multiplyValueSpecifyingQuantity": "[bool]数量指定した際に、検証に使用する値も乗算するか",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Experience:VerifyRankByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
experienceName: "[string]経験値モデル名"
verifyType: "[string]検証の種類"
propertyId: "[string]プロパティID"
rankValue: "[long]現在のランク"
multiplyValueSpecifyingQuantity: "[bool]数量指定した際に、検証に使用する値も乗算するか"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("experience").verify.verify_rank_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
experienceName="[string]経験値モデル名",
verifyType="[string]検証の種類",
propertyId="[string]プロパティID",
rankValue="[long]現在のランク",
multiplyValueSpecifyingQuantity="[bool]数量指定した際に、検証に使用する値も乗算するか",
timeOffsetToken="[string]タイムオフセットトークン",
})Gs2Experience:VerifyRankCapByUserId
ユーザーIDを指定してランクキャップを検証
指定されたユーザーの現在のランクキャップ(バフ効果を含む)が指定された値に対する条件を満たすことを検証します。
6つの比較演算子をサポート:less、lessEqual、greater、greaterEqual、equal、notEqual。
検証条件を満たさない場合はエラー(BadRequest)を返します。
数量指定可能なアクション:いいえ
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||||||||||||||||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||||||||||||||||
| experienceName | string | ✓ | ~ 128文字 | 経験値モデル名 このステータスのランキングルールを定義する経験値モデルの名前です。どのランクアップ閾値テーブルとランクキャップ設定が適用されるかを決定します。 | ||||||||||||||||
| verifyType | 文字列列挙型 enum { “less”, “lessEqual”, “greater”, “greaterEqual”, “equal”, “notEqual” } | ✓ | 検証の種類
| |||||||||||||||||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID ユーザースコープ内でこのステータスを一意に識別する開発者定義の識別子です。経験値を持つ GS2-Inventory のアイテムセット GRN や GS2-Dictionary のエントリー GRN の末尾に経験値モデルのサフィックスを付与した値を使用することを推奨します。 | ||||||||||||||||
| rankCapValue | long | ✓ | 0 ~ 9223372036854775805 | 現在のランクキャップ このステータスが現在到達できる最大ランクです。初期値は経験値モデルの defaultRankCap に設定され、限界突破などのランクキャップ増加操作により maxRankCap まで引き上げることができます。 | ||||||||||||||||
| multiplyValueSpecifyingQuantity | bool | false | 数量指定した際に、検証に使用する値も乗算するか | |||||||||||||||||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Experience:VerifyRankCapByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"experienceName": "[string]経験値モデル名",
"verifyType": "[string]検証の種類",
"propertyId": "[string]プロパティID",
"rankCapValue": "[long]現在のランクキャップ",
"multiplyValueSpecifyingQuantity": "[bool]数量指定した際に、検証に使用する値も乗算するか",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Experience:VerifyRankCapByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
experienceName: "[string]経験値モデル名"
verifyType: "[string]検証の種類"
propertyId: "[string]プロパティID"
rankCapValue: "[long]現在のランクキャップ"
multiplyValueSpecifyingQuantity: "[bool]数量指定した際に、検証に使用する値も乗算するか"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("experience").verify.verify_rank_cap_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
experienceName="[string]経験値モデル名",
verifyType="[string]検証の種類",
propertyId="[string]プロパティID",
rankCapValue="[long]現在のランクキャップ",
multiplyValueSpecifyingQuantity="[bool]数量指定した際に、検証に使用する値も乗算するか",
timeOffsetToken="[string]タイムオフセットトークン",
})ConsumeAction
消費アクション
Gs2Experience:SubExperienceByUserId
ユーザーIDを指定して経験値を減算
指定されたユーザーのステータスから経験値を減算します。経験値は0を下回りません。
ランクはランクアップ閾値に基づいて自動的に再計算されます。
数量指定可能なアクション:はい
反転可能なアクション:はい
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||
| experienceName | string | ✓ | ~ 128文字 | 経験値モデル名 このステータスのランキングルールを定義する経験値モデルの名前です。どのランクアップ閾値テーブルとランクキャップ設定が適用されるかを決定します。 | ||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID ユーザースコープ内でこのステータスを一意に識別する開発者定義の識別子です。経験値を持つ GS2-Inventory のアイテムセット GRN や GS2-Dictionary のエントリー GRN の末尾に経験値モデルのサフィックスを付与した値を使用することを推奨します。 | ||
| experienceValue | long | 0 | 0 ~ 9223372036854775805 | 失う経験値 | ||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Experience:SubExperienceByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"experienceName": "[string]経験値モデル名",
"propertyId": "[string]プロパティID",
"experienceValue": "[long]失う経験値",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Experience:SubExperienceByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
experienceName: "[string]経験値モデル名"
propertyId: "[string]プロパティID"
experienceValue: "[long]失う経験値"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("experience").consume.sub_experience_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
experienceName="[string]経験値モデル名",
propertyId="[string]プロパティID",
experienceValue="[long]失う経験値",
timeOffsetToken="[string]タイムオフセットトークン",
})Gs2Experience:SubRankCapByUserId
ユーザーIDを指定してランクキャップを減算
指定されたユーザーのステータスのランクキャップを減算します。ランクキャップは0を下回りません。
数量指定可能なアクション:はい
反転可能なアクション:はい
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||
| experienceName | string | ✓ | ~ 128文字 | 経験値モデル名 このステータスのランキングルールを定義する経験値モデルの名前です。どのランクアップ閾値テーブルとランクキャップ設定が適用されるかを決定します。 | ||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID ユーザースコープ内でこのステータスを一意に識別する開発者定義の識別子です。経験値を持つ GS2-Inventory のアイテムセット GRN や GS2-Dictionary のエントリー GRN の末尾に経験値モデルのサフィックスを付与した値を使用することを推奨します。 | ||
| rankCapValue | long | ✓ | 0 ~ 9223372036854775805 | 現在のランクキャップ このステータスが現在到達できる最大ランクです。初期値は経験値モデルの defaultRankCap に設定され、限界突破などのランクキャップ増加操作により maxRankCap まで引き上げることができます。 | ||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Experience:SubRankCapByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"experienceName": "[string]経験値モデル名",
"propertyId": "[string]プロパティID",
"rankCapValue": "[long]現在のランクキャップ",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Experience:SubRankCapByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
experienceName: "[string]経験値モデル名"
propertyId: "[string]プロパティID"
rankCapValue: "[long]現在のランクキャップ"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("experience").consume.sub_rank_cap_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
experienceName="[string]経験値モデル名",
propertyId="[string]プロパティID",
rankCapValue="[long]現在のランクキャップ",
timeOffsetToken="[string]タイムオフセットトークン",
})AcquireAction
入手アクション
Gs2Experience:AddExperienceByUserId
ユーザーIDを指定して経験値を加算
指定されたユーザーのステータスに経験値を加算します。ランクはランクアップ閾値に基づいて自動的に再計算されます。
truncateExperienceWhenRankUp が true の場合、ランクアップ時に閾値を超えた余剰経験値は切り捨てられます。false(デフォルト)の場合は次のランクに繰り越されます。
数量指定可能なアクション:はい
反転可能なアクション:はい
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||
| experienceName | string | ✓ | ~ 128文字 | 経験値モデル名 このステータスのランキングルールを定義する経験値モデルの名前です。どのランクアップ閾値テーブルとランクキャップ設定が適用されるかを決定します。 | ||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID ユーザースコープ内でこのステータスを一意に識別する開発者定義の識別子です。経験値を持つ GS2-Inventory のアイテムセット GRN や GS2-Dictionary のエントリー GRN の末尾に経験値モデルのサフィックスを付与した値を使用することを推奨します。 | ||
| experienceValue | long | 0 | 0 ~ 9223372036854775805 | 獲得経験値 | ||
| truncateExperienceWhenRankUp | bool? | false | ランクアップ時に残りの経験値を切り捨てるか | |||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Experience:AddExperienceByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"experienceName": "[string]経験値モデル名",
"propertyId": "[string]プロパティID",
"experienceValue": "[long]獲得経験値",
"truncateExperienceWhenRankUp": "[bool]ランクアップ時に残りの経験値を切り捨てるか",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Experience:AddExperienceByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
experienceName: "[string]経験値モデル名"
propertyId: "[string]プロパティID"
experienceValue: "[long]獲得経験値"
truncateExperienceWhenRankUp: "[bool]ランクアップ時に残りの経験値を切り捨てるか"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("experience").acquire.add_experience_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
experienceName="[string]経験値モデル名",
propertyId="[string]プロパティID",
experienceValue="[long]獲得経験値",
truncateExperienceWhenRankUp="[bool]ランクアップ時に残りの経験値を切り捨てるか",
timeOffsetToken="[string]タイムオフセットトークン",
})Gs2Experience:SetExperienceByUserId
ユーザーIDを指定して経験値を設定
指定されたユーザーのステータスの経験値を指定の値に直接設定します。
更新前のステータスを ‘old’ として、更新後のステータスと共に返します。
ランクはランクアップ閾値に基づいて自動的に再計算されます。
数量指定可能なアクション:はい
反転可能なアクション:はい
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||
| experienceName | string | ✓ | ~ 128文字 | 経験値モデル名 このステータスのランキングルールを定義する経験値モデルの名前です。どのランクアップ閾値テーブルとランクキャップ設定が適用されるかを決定します。 | ||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID ユーザースコープ内でこのステータスを一意に識別する開発者定義の識別子です。経験値を持つ GS2-Inventory のアイテムセット GRN や GS2-Dictionary のエントリー GRN の末尾に経験値モデルのサフィックスを付与した値を使用することを推奨します。 | ||
| experienceValue | long | 0 | 0 ~ 9223372036854775805 | 累計獲得経験値 このステータスが蓄積した合計経験値です。現在のランクはこの値からランクアップ閾値テーブルを使用して算出されます。現在のランクキャップに対応する閾値を超えて経験値を獲得することはできません。 | ||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Experience:SetExperienceByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"experienceName": "[string]経験値モデル名",
"propertyId": "[string]プロパティID",
"experienceValue": "[long]累計獲得経験値",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Experience:SetExperienceByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
experienceName: "[string]経験値モデル名"
propertyId: "[string]プロパティID"
experienceValue: "[long]累計獲得経験値"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("experience").acquire.set_experience_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
experienceName="[string]経験値モデル名",
propertyId="[string]プロパティID",
experienceValue="[long]累計獲得経験値",
timeOffsetToken="[string]タイムオフセットトークン",
})Gs2Experience:AddRankCapByUserId
ユーザーIDを指定してランクキャップを加算
指定されたユーザーのステータスのランクキャップを加算します。ランクキャップは経験値モデルで定義された maxRankCap を超えることはできません。
ランクキャップは、指定されたプロパティでユーザーが到達可能な最大ランクを決定します。
数量指定可能なアクション:はい
反転可能なアクション:はい
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||
| experienceName | string | ✓ | ~ 128文字 | 経験値モデル名 このステータスのランキングルールを定義する経験値モデルの名前です。どのランクアップ閾値テーブルとランクキャップ設定が適用されるかを決定します。 | ||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID ユーザースコープ内でこのステータスを一意に識別する開発者定義の識別子です。経験値を持つ GS2-Inventory のアイテムセット GRN や GS2-Dictionary のエントリー GRN の末尾に経験値モデルのサフィックスを付与した値を使用することを推奨します。 | ||
| rankCapValue | long | ✓ | 0 ~ 9223372036854775805 | 現在のランクキャップ このステータスが現在到達できる最大ランクです。初期値は経験値モデルの defaultRankCap に設定され、限界突破などのランクキャップ増加操作により maxRankCap まで引き上げることができます。 | ||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Experience:AddRankCapByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"experienceName": "[string]経験値モデル名",
"propertyId": "[string]プロパティID",
"rankCapValue": "[long]現在のランクキャップ",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Experience:AddRankCapByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
experienceName: "[string]経験値モデル名"
propertyId: "[string]プロパティID"
rankCapValue: "[long]現在のランクキャップ"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("experience").acquire.add_rank_cap_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
experienceName="[string]経験値モデル名",
propertyId="[string]プロパティID",
rankCapValue="[long]現在のランクキャップ",
timeOffsetToken="[string]タイムオフセットトークン",
})Gs2Experience:SetRankCapByUserId
ユーザーIDを指定してランクキャップを設定
指定されたユーザーのステータスのランクキャップ値を指定の値に直接設定します。
更新前のステータスを ‘old’ として、更新後のステータスと共に返します。
ランクキャップは経験値モデルで定義された maxRankCap で上限が制限されます。
数量指定可能なアクション:いいえ
反転可能なアクション:いいえ
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||
| experienceName | string | ✓ | ~ 128文字 | 経験値モデル名 このステータスのランキングルールを定義する経験値モデルの名前です。どのランクアップ閾値テーブルとランクキャップ設定が適用されるかを決定します。 | ||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID ユーザースコープ内でこのステータスを一意に識別する開発者定義の識別子です。経験値を持つ GS2-Inventory のアイテムセット GRN や GS2-Dictionary のエントリー GRN の末尾に経験値モデルのサフィックスを付与した値を使用することを推奨します。 | ||
| rankCapValue | long | ✓ | 0 ~ 9223372036854775805 | 現在のランクキャップ このステータスが現在到達できる最大ランクです。初期値は経験値モデルの defaultRankCap に設定され、限界突破などのランクキャップ増加操作により maxRankCap まで引き上げることができます。 | ||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Experience:SetRankCapByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"experienceName": "[string]経験値モデル名",
"propertyId": "[string]プロパティID",
"rankCapValue": "[long]現在のランクキャップ",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Experience:SetRankCapByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
experienceName: "[string]経験値モデル名"
propertyId: "[string]プロパティID"
rankCapValue: "[long]現在のランクキャップ"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("experience").acquire.set_rank_cap_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
experienceName="[string]経験値モデル名",
propertyId="[string]プロパティID",
rankCapValue="[long]現在のランクキャップ",
timeOffsetToken="[string]タイムオフセットトークン",
})Gs2Experience:MultiplyAcquireActionsByUserId
ユーザーIDを指定して経験値の対象プロパティのランクに応じてリソースを加算
プロパティの現在のランク値に基づいて指定された rateName の入手アクション倍率を参照し、指定された入手アクションをその倍率(baseRate と組み合わせて)で乗算し、結果のアクションを実行するトランザクションを開始します。
ランクに基づく報酬スケーリングに使用され、高ランクほど比例して多くのリソースを獲得できます。
数量指定可能なアクション:はい
反転可能なアクション:いいえ
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128文字 | ネームスペース名 ネームスペース固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 | ||
| userId | string | ✓ | ~ 128文字 | ユーザーID#{userId} と設定することでログイン中のユーザーIDに置換されます。 | ||
| experienceName | string | ✓ | ~ 128文字 | 経験値モデル名 このステータスのランキングルールを定義する経験値モデルの名前です。どのランクアップ閾値テーブルとランクキャップ設定が適用されるかを決定します。 | ||
| propertyId | string | ✓ | ~ 1024文字 | プロパティID ユーザースコープ内でこのステータスを一意に識別する開発者定義の識別子です。経験値を持つ GS2-Inventory のアイテムセット GRN や GS2-Dictionary のエントリー GRN の末尾に経験値モデルのサフィックスを付与した値を使用することを推奨します。 | ||
| rateName | string | ✓ | ~ 128文字 | 報酬加算テーブル名 この報酬加算テーブルの一意な識別子です。特定の入手アクションに適用する倍率テーブルを指定する際に参照されます。 | ||
| acquireActions | List<AcquireAction> | [] | 0 ~ 100 items | 入手アクションリスト | ||
| baseRate | float | 1 | 0 ~ 1000000 | 基礎倍率 | ||
| timeOffsetToken | string | ~ 1024文字 | タイムオフセットトークン |
{
"action": "Gs2Experience:MultiplyAcquireActionsByUserId",
"request": {
"namespaceName": "[string]ネームスペース名",
"userId": "[string]ユーザーID",
"experienceName": "[string]経験値モデル名",
"propertyId": "[string]プロパティID",
"rateName": "[string]報酬加算テーブル名",
"acquireActions": [
{
"action": "[string]入手アクションで実行するアクションの種類",
"request": "[string]アクション実行時に使用されるリクエストのJSON文字列"
}
],
"baseRate": "[float]基礎倍率",
"timeOffsetToken": "[string]タイムオフセットトークン"
}
}action: Gs2Experience:MultiplyAcquireActionsByUserId
request:
namespaceName: "[string]ネームスペース名"
userId: "[string]ユーザーID"
experienceName: "[string]経験値モデル名"
propertyId: "[string]プロパティID"
rateName: "[string]報酬加算テーブル名"
acquireActions:
- action: "[string]入手アクションで実行するアクションの種類"
request: "[string]アクション実行時に使用されるリクエストのJSON文字列"
baseRate: "[float]基礎倍率"
timeOffsetToken: "[string]タイムオフセットトークン"transaction.service("experience").acquire.multiply_acquire_actions_by_user_id({
namespaceName="[string]ネームスペース名",
userId="[string]ユーザーID",
experienceName="[string]経験値モデル名",
propertyId="[string]プロパティID",
rateName="[string]報酬加算テーブル名",
acquireActions={
{
action="[string]入手アクションで実行するアクションの種類",
request="[string]アクション実行時に使用されるリクエストのJSON文字列"
}
},
baseRate="[float]基礎倍率",
timeOffsetToken="[string]タイムオフセットトークン",
})