Important
Economy v1 API はメンテナンス モードであり、新機能は受け取らず、バグ修正のみを受け取ります。 v1 API は、当面維持されます。 次のバージョンの PlayFab エコノミーの詳細については、「エコノミー v2 の概要」を参照してください。
このチュートリアルでは、PlayFab ゲーム マネージャーを使用して期限付き消耗品アイテムを作成する手順について説明します。 時間指定された消耗品アイテムは、プレイヤーへの最初の許可から特定の時間が経過した後に自動消費するように構成されたアイテムです。
要件
- ここでは、カタログ、インベントリ、PlayFab ゲーム マネージャーについて既に理解していることを前提としています。
- プライマリ カタログが必要です。
スタック可能な期限付き消耗品アイテムを作成する
与えられるとプレーヤーのスタミナが 5 分追加され、5 分間時間範囲が増加する小さなスタミナ ポーションを作成しましょう。 ゲーム マネージャー内で次の手順を実行します。
[タイトル]に移動します。
左のメニューから、[Economy (エコノミー)] を選択します。
[カタログ] タブに移動し、プライマリ カタログを選択します - 画面は次の例のようになります。
右上隅の省略記号 [新しいアイテム] を選択します。
次のフィールドに入力します。
フィールド名 値の例 説明 アイテム ID Small_Stamina_Potion この必須フィールドは、カタログ内のアイテムの一意の識別子です。 アイテム ID はカタログ内で一意である必要がありますが、同じアイテム ID のアイテムを含む複数のカタログ バージョンを作成できます。 Display Name 小さなスタミナ ポーション このオプションのフィールドは、カタログ アイテムに対して表示される名前です。 一般的な使用方法の 1 つは、ゲーム内のストアでアイテムを提供する場合です。 表示名は一意とする必要はありません。 消費型アイテム 消費型アイテム このアイテムが非消耗品か消耗品かを示します。 カウント別 1 [消費型アイテム] が選択されている場合、このフィールドは必須です。 消費されたときにそのアイテムの数が減少する量が決まります。 時間別 5 分 [消費型アイテム] が選択されている場合、このフィールドはオプションです。 アイテムが付与された時点から消費された時点までの経過時間が決まります。 時間グループ名 Small_Stamina_Potion [消費型アイテム] が選択されている場合、このフィールドはオプションです。 同じグループ名で複数のアイテム消費時間を結合できます。 Is Stackable True [スタック可能] とすると、インベントリでこのタイプのアイテムを 1 つのみ表示し、アイテムの数量カウントを増加します。 [Save item (アイテムの保存)] を選択します。
これで、これらのポーションをスタックすることができ、残りの時間も自動的に "スタック" されます。 たとえば、午後 1 時にプレイヤーに小さなスタミナ ポーションを 1 つ付与すると、アイテムは午後 1 時 5 分に消費されます。 1 時 2 分に小さなスタミナ ポーションを与えると、2 つのアイテムは 1 時 10 分に消費されます。
注意
スタック可能な期限付きの消費型アイテムのタイム グループ名を指定しない場合、最初の許可から元の有効期限が設定されたきにスタック全体が期限切れになります。 たとえば、上記のシナリオでは、代わりに時間グループ名を空白のままにした場合、午後 1 時に 1 つの小さなスタミナ ポーションをプレイヤーに付与すると、アイテムは午後 1 時 5 分に消費されます。 1 時 2 分に小さなスタミナ ポーションを与えると、2 つのアイテムは 1 時 5 分に消費されます。 1 時 4 分に小さなスタミナ ポーションを与えると、2 つのアイテムは 1 時 5 分に消費されます。 しかし、スタックが消費された後、午後 1 時 10 分に小さなスタミナ ポーションを与えると、アイテムは午後 1 時 15 分に消費されます。
スタック不可能な消耗品アイテムを作成する
前と同様の例を作成しますが、スタック不可能なアイテムにします。 与えられるとプレーヤーのスタミナが 10 分追加される中間のスタミナ ポーションを作ります。追加アイテムを与えられるごとに 10 分間時間範囲が増加します。 ゲーム マネージャー内で次の手順を実行します。
[タイトル]に移動します。
左のメニューから、[Economy (エコノミー)] を選択します。
[カタログ] タブに移動し、プライマリ カタログを選択します - 画面は次の例のようになります。
右上隅の省略記号 [新しいアイテム] を選択します。
次のフィールドに入力します。
フィールド名 値の例 説明 アイテム ID Med_Stamina_Potion この必須フィールドは、カタログ内のアイテムの一意の識別子です。 アイテム ID はカタログ内で一意である必要がありますが、同じアイテム ID のアイテムを含む複数のカタログ バージョンを作成できます。 Display Name 中間のスタミナ ポーション このオプションのフィールドは、カタログ アイテムに対して表示される名前です。 一般的な使用方法の 1 つは、ゲーム内のストアでアイテムを提供する場合です。 表示名は一意とする必要はありません。 消費型アイテム 消費型アイテム このアイテムが非消耗品か消耗品かを示します。 カウント別 1 この必須フィールド ([消費型アイテム]が選択されている場合) によって、消費されたときにそのアイテムの数が減少する量が決まります。 時間別 10 分 このオプションのフィールド ([消費型アイテム] が選択されている場合) により、アイテムが付与された時点から消費された時点までの経過時間が決まります。 時間グループ名 Med_Stamina_Potion このオプションの フィールド ([消費型アイテム] が選択されている場合) を使用すると、同じグループ名で複数のアイテム消費時間を結合できます。 Is Stackable False [スタック可能] とすると、インベントリでこのタイプのアイテムを 1 つのみ表示し、アイテムの数量カウントを増加します。 [Save item (アイテムの保存)] を選択します。
これで、追加の中間のスタミナ ポーションを付与するたびに、アイテムがスタック不可能なため、プレイヤーのインベントリにまったく新しいインスタンスが作成されます。 これらのアイテムの残りの時間は、引き続き自動的に "スタック" できます。 たとえば、午後 1 時にプレイヤーに中間のスタミナ ポーションを 1 つ与えると、アイテムは午後 1 時 10 分に消費されます。 1 時 5 分に中間のスタミナ ポーションをもう 1 つ与えると、2 つのアイテムは 1 時 20 分に消費されます。
注意
スタック不可能な期限付き消費型アイテムにタイム グループ名を指定しない場合、各インスタンスは互いに独立して期限切れになります。 たとえば、上記のシナリオでは、代わりに時間グループ名を空白のままにした場合、午後 1 時に 1 つの中間のスタミナ ポーションをプレイヤーに付与すると、アイテムは午後 1 時 10 分に消費されます。 午後 1 時 05 分に別の中間のスタミナ ポーションを付与した場合、最初のアイテムは午後 1 時 10 分に消費され、2 番目のアイテムは午後 1 時 15 分に消費されます。
複数の期限付きの消耗品アイテムをリンクする
これで、小さなポーション (スタック可能) と中のポーション (非スタック可能) が作成されたので、これら 2 つのタイマーをリンクしましょう。 いくつかのフィールドを変更して、小さなスタミナ・ポーションまたは中間のスタミナ ポーションが付与されたときにプレイヤーのスタミナがブーストされるようにし、小さなスタミナ ポーションまたは中間のスタミナ ポーションごとに時間範囲をさらに 5 分または 10 分増やしましょう。 ゲーム マネージャー内で次の手順を実行します。
- [タイトル]に移動します。
- 左のメニューから、[Economy (エコノミー)] を選択します。
-
[カタログ] タブに移動し、プライマリ カタログを選択します - 画面は次の例のようになります。
- アイテム一覧で Med_Stamina_Potion を選択します。
-
タイム グループ名のを
Med_Stamina_Potion
からStamina_Potion
に変更します。 - [Save item (アイテムの保存)] を選択します。
- アイテム一覧で Small_Stamina_Potion を選択します。
-
タイム グループ名のを
Small_Stamina_Potion
からStamina_Potion
に変更します。 - [Save item (アイテムの保存)] を選択します。
これで、追加の小さなスタミナ ポーション、または中間のスタミナ ポーションを付与するたびに、同じタイム グループ名を持つすべてのアイテムの残り時間が自動的に "スタック" されます。 たとえば、午後 1 時にプレイヤーに中間のスタミナ ポーションを 1 つ与えると、アイテムは午後 1 時 10 分に消費されます。 午後 1 時 5 分に小さなスタミナ ポーションを与えると、2 つのアイテムは午後 1 時 15 分に消費されます。