操作のパラメーター
Understand the operational limits and parameter caps for Economy configurations.
読み終わるまでの所要時間 7 分最終更新 8ヶ月前
Economy を適切に操作するため、ストレージと実行時の使用状況の両方の観点から、サービスを最適に実行し続けられるように、いくつかのパラメーターが用意されています。
パラメーターの上限
通貨
1 プロジェクトに設定できる通貨の最大数は 20 個です。20 個を超える通貨を設定しようとすると、システムによってエラーが返されます。
設定アイテム
1 ゲーム内の設定アイテムの合計数は、プロジェクトあたり 750 個です。これには、保持できる最大 20 個の通貨が含まれます。
購入のコストアイテム
仮想購入の場合、1 つのトランザクションに許可されるコストリソースの最大数は 20 個です。コストリソースとは、トランザクションを進めるために必要な通貨またはインベントリアイテムです。プレイヤーが 20 個を超えるコストアイテムを購入に追加しようとすると、Economy によってダッシュボード UI の Add (追加) ボタンが無効になります。
購入のゲーム内報酬アイテム
すべての購入 (仮想およびリアルマネー) で、1 回の購入トランザクションのゲーム内報酬としてプレイヤーに与えられるアイテムの最大数は 20 個です。プレイヤーが 20 個を超えるアイテムをゲーム内報酬として追加しようとすると、Economy によってダッシュボード UI の Add (追加) ボタンが無効になります。
カスタムデータ
1 アイテムに関連付けられている カスタムデータ が、アイテムあたりまたはアイテムインスタンスあたりに 5 KB を超えると、Economy によってエラーメッセージがダッシュボード UI に表示されます (エラーが設定から発生している場合)。エラーがゲーム自体に由来する場合は、API によってエラーメッセージが返されます。
インベントリインスタンス
インベントリインスタンスにはプレイヤーごとに 1000 の制限があります。エラーは Player API のみにレポートされます。プレイヤーにさらにアイテムを追加しようとすると、API によってエラーが返されます。
制限のサマリー
アイテム | 説明 | 上限 | 実装 |
|---|---|---|---|
| 通貨 | ゲームで使用される通貨の最大数。 | プロジェクトあたり 20 個 (15 個から警告が開始) | Admin API のみ。この上限を超過するとダッシュボード UI にエラーバナーが返されます。 |
| 合計設定アイテム数 | 1 ゲーム内の設定アイテムの合計数 (通貨を含む)。 | プロジェクトあたり 750 個 | Admin API のみ。この上限を超過するとダッシュボード UI にエラーバナーが返されます。 |
| 購入のコストアイテム | 1 回の購入で許可されるコストアイテムの合計数。これは仮想購入のみで有効です。 | 購入あたり 20 個 | Admin API のみ。この上限に到達すると UI の Add an item (アイテムの追加) ボタンが無効になります。 |
| 購入のゲーム内報酬アイテム | 1 回の購入に組み込むことができるさまざまなゲーム内報酬アイテムの合計数。 | 購入あたり 20 個 | Admin API のみ。この上限に到達すると UI の Add an item (アイテムの追加) ボタンが無効になります。 |
| カスタムデータ | 設定アイテムすなわちインスタンスアイテムに関連付けれられている カスタムデータ。 | アイテムまたはアイテムインスタンスあたり 5 KB | Admin API のみ。この上限を超過するとダッシュボード UI にエラーメッセージが返されます。 |
| インベントリインスタンス | プレイヤーに関連付けられるアイテムの数。 | プレイヤーあたり 1000 アイテム | Player API のみ。この上限を超過するとダッシュボード UI にエラーバナーが返されます。 |