> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consommables temporisés dans Economy (hérité)

> Configurez des consommables temporisés PlayFab Economy (hérité) dans le Game Manager afin que les objets soient automatiquement consommés de l'inventaire d'un joueur après une durée définie.

# Consommables temporisés (Economy hérité)

<Info>
  Les API Economy v1 sont en mode maintenance et ne recevront plus de nouvelles fonctionnalités, uniquement des correctifs de bogues. **Les API v1 seront maintenues dans un avenir prévisible.** Consultez la [vue d'ensemble d'Economy v2](/fr/services/playfab/economy-monetization/economy-v2/overview) pour en savoir plus sur la prochaine version de PlayFab Economy !
</Info>

Ce tutoriel vous guide dans la création de consommables temporisés à l'aide du Game Manager de PlayFab. Les consommables temporisés sont des objets configurés pour être consommés automatiquement après un délai donné à compter de leur octroi initial au joueur.

## Prérequis

* Nous supposons que vous connaissez déjà les [catalogues](/fr/services/playfab/economy-monetization/economy/items/catalogs), l'[inventaire](/fr/services/playfab/player-progression/player-data/player-inventory) et le [Game Manager](/fr/services/playfab/live-service-management/gamemanager/quickstart) de PlayFab.
* Vous devez disposer d'un *catalogue principal*.

## Créer un consommable temporisé empilable

Créons une petite potion d'endurance qui augmente l'endurance de votre joueur pendant cinq minutes lorsqu'elle est octroyée, et qui prolonge la durée de cinq minutes. Dans le Game Manager :

1. Accédez à votre **titre**.
2. Sélectionnez **Economy** dans le menu de gauche.
3. Accédez à l'onglet **Catalogs** et choisissez votre catalogue principal. Votre écran doit ressembler à cet exemple :
   <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=07324205042b82707322d0144072dc89" alt="Game Manager - Consommables temporisés - Onglet Items avec un objet" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab.png" />
4. Sélectionnez **New item** dans l'angle supérieur droit.
5. Renseignez les champs suivants :

   | Nom du champ | Exemple de valeur | Description |
   | :-: | :-: | - |
   | Item ID | Small\_Stamina\_Potion | Ce champ *obligatoire* est l'identificateur unique de l'objet dans le catalogue. L'ID d'objet doit être unique au sein du catalogue, mais vous pouvez avoir plusieurs versions de catalogue contenant des objets avec le même ID d'objet. |
   | Display Name | Small Stamina Potion | Ce champ *facultatif* est le nom affiché pour l'objet du catalogue. Il est couramment utilisé lorsque vous souhaitez proposer l'objet dans votre magasin en jeu. Les noms d'affichage n'ont pas besoin d'être uniques. |
   | Consumable | Consumable | Indique si l'objet est **Durable** (permanent) ou **Consumable** (consommable). |
   | By Count | 1 | Ce champ est *obligatoire* lorsque **Consumable** est sélectionné. Il détermine de combien le nombre de cet objet sera décrémenté lors de sa consommation. |
   | By Time | 5 minutes | Ce champ est *facultatif* lorsque **Consumable** est sélectionné. Il détermine la durée qui s'écoulera entre le moment où l'objet est octroyé et le moment où il est consommé. |
   | Time Group Name | Small\_Stamina\_Potion | Ce champ est *facultatif* lorsque **Consumable** est sélectionné. Il vous permet de regrouper les durées de consommation de plusieurs objets portant le même nom de groupe. |
   | Is Stackable | True | Marquer un objet comme **Stackable** (empilable) n'autorise qu'un seul objet de ce type dans l'inventaire et incrémente la quantité de l'objet. |

   <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-stackable.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=84e03786b569afc2859a00d3dddde7ab" alt="Game Manager - Consommables temporisés - Objet empilable" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-stackable.png" />
6. Sélectionnez **Save item**.

Vous pourrez désormais empiler ces potions, et le temps restant s'« empilera » automatiquement lui aussi. Par exemple, si j'octroie une petite potion d'endurance à un joueur à 13 h 00, l'objet sera consommé à 13 h 05. Si j'octroie une autre petite potion d'endurance à 13 h 02, les deux objets seront consommés à 13 h 10.

<Note>
  Si vous ne spécifiez pas de nom de groupe temporel pour un consommable temporisé empilable, la pile entière expirera à l'heure d'expiration initiale définie lors du premier octroi. Par exemple, dans le scénario ci-dessus, si je laisse le nom de groupe temporel vide et que j'octroie une petite potion d'endurance à un joueur à 13 h 00, l'objet sera consommé à 13 h 05. Si j'octroie une autre petite potion d'endurance à 13 h 02, les deux objets seront toujours consommés à 13 h 05. Si j'octroie encore une autre petite potion d'endurance à 13 h 04, les trois objets seront toujours consommés à 13 h 05. Mais une fois la pile consommée, si j'octroie une petite potion d'endurance à 13 h 10, l'objet sera consommé à 13 h 15.
</Note>

## Créer un consommable temporisé non empilable

Créons un exemple similaire au précédent, mais avec un objet non empilable. Créons une potion d'endurance moyenne qui augmentera l'endurance de votre joueur pendant 10 minutes lorsqu'elle est octroyée, et qui prolongera la durée de 10 minutes supplémentaires pour chaque objet supplémentaire. Dans le Game Manager :

1. Accédez à votre **titre**.
2. Sélectionnez **Economy** dans le menu de gauche.
3. Accédez à l'onglet **Catalogs** et choisissez votre catalogue principal. Votre écran doit ressembler à cet exemple :
   <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab-2.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=106ecb5bb2ee7f236a73460377e6c563" alt="Game Manager - Consommables temporisés - Onglet Items avec deux objets" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab-2.png" />
4. Sélectionnez **New item** dans l'angle supérieur droit.
5. Renseignez les champs suivants :

   | Nom du champ | Exemple de valeur | Description |
   | :-: | :-: | - |
   | Item ID | Med\_Stamina\_Potion | Ce champ *obligatoire* est l'identificateur unique de l'objet dans le catalogue. L'ID d'objet doit être unique au sein du catalogue, mais vous pouvez avoir plusieurs versions de catalogue contenant des objets avec le même ID d'objet. |
   | Display Name | Medium Stamina Potion | Ce champ *facultatif* est le nom affiché pour l'objet du catalogue. Il est couramment utilisé lorsque vous souhaitez proposer l'objet dans votre magasin en jeu. Les noms d'affichage n'ont pas besoin d'être uniques. |
   | Consumable | Consumable | Indique si l'objet est **Durable** (permanent) ou **Consumable** (consommable). |
   | By Count | 1 | Ce champ *obligatoire* (lorsque **Consumable** est sélectionné) détermine de combien le nombre de cet objet sera décrémenté lors de sa consommation. |
   | By Time | 10 minutes | Ce champ *facultatif* (lorsque **Consumable** est sélectionné) détermine la durée qui s'écoulera entre le moment où l'objet est octroyé et le moment où il est consommé. |
   | Time Group Name | Med\_Stamina\_Potion | Ce champ *facultatif* (lorsque **Consumable** est sélectionné) vous permet de regrouper les durées de consommation de plusieurs objets portant le même nom de groupe. |
   | Is Stackable | False | Marquer un objet comme **Stackable** (empilable) n'autorise qu'un seul objet de ce type dans l'inventaire et incrémente la quantité de l'objet. |

   <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-non-stackable.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=77e85186bc62bdbd92c87506f6698f13" alt="Game Manager - Consommables temporisés - Objet non empilable" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-non-stackable.png" />
6. Sélectionnez **Save item**.

Désormais, chaque fois que vous octroyez une potion d'endurance moyenne supplémentaire, une instance entièrement nouvelle est créée dans l'inventaire du joueur, car l'objet n'est pas empilable. Vous pourrez toujours « empiler » automatiquement le temps restant pour ces objets. Par exemple, si j'octroie une potion d'endurance moyenne à un joueur à 13 h 00, l'objet sera consommé à 13 h 10. Si j'octroie une autre potion d'endurance moyenne à 13 h 05, les deux objets seront consommés à 13 h 20.

<Note>
  Si vous ne spécifiez pas de nom de groupe temporel pour un consommable temporisé non empilable, chaque instance expirera indépendamment des autres. Par exemple, dans le scénario ci-dessus, si je laisse le nom de groupe temporel vide et que j'octroie une potion d'endurance moyenne à un joueur à 13 h 00, l'objet sera consommé à 13 h 10. Si j'octroie une autre potion d'endurance moyenne à 13 h 05, le premier objet sera toujours consommé à 13 h 10, et le second sera consommé à 13 h 15.
</Note>

## Lier plusieurs consommables temporisés

Maintenant que vous disposez d'une petite potion (empilable) et d'une potion moyenne (non empilable), lions ces deux minuteurs. Modifions quelques champs pour que l'endurance de votre joueur soit augmentée lorsque des potions d'endurance petites ou moyennes sont octroyées, et que la durée soit prolongée de 5 ou 10 minutes supplémentaires pour chaque petite ou moyenne potion d'endurance, respectivement. Dans le Game Manager :

1. Accédez à votre **titre**.
2. Sélectionnez **Economy** dans le menu de gauche.
3. Accédez à l'onglet **Catalogs** et choisissez votre catalogue principal. Votre écran doit ressembler à cet exemple :
   <img src="https://mintcdn.com/microsoft-4404708b/Oa_DP1q6U1lat7c2/images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab-3.png?fit=max&auto=format&n=Oa_DP1q6U1lat7c2&q=85&s=0db8f5c8cba28d73e06ee7fa3cf37748" alt="Game Manager - Consommables temporisés - Onglet Items avec trois objets" width="1280" height="1100" data-path="images/playfab/economy-monetization/economy/tutorials/game-manager-timed-consumables-items-tab-3.png" />
4. Sélectionnez **Med\_Stamina\_Potion** dans la liste des objets.
5. Remplacez le **Time Group Name** `Med_Stamina_Potion` par `Stamina_Potion`.
6. Sélectionnez **Save item**.
7. Sélectionnez **Small\_Stamina\_Potion** dans la liste des objets.
8. Remplacez le **Time Group Name** `Small_Stamina_Potion` par `Stamina_Potion`.
9. Sélectionnez **Save item**.

Désormais, chaque fois que vous octroyez une potion d'endurance petite ou moyenne supplémentaire, le temps restant s'« empile » automatiquement pour tous les objets portant le même nom de groupe temporel. Par exemple, si j'octroie une potion d'endurance moyenne à un joueur à 13 h 00, l'objet sera consommé à 13 h 10. Si j'octroie une petite potion d'endurance à 13 h 05, les deux objets seront consommés à 13 h 15.


## Related topics

- [Tables de butin dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/drop-tables.md)
- [Coupons et promotions dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/coupons-and-promotions.md)
- [Magasins et soldes dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [Gérer les monnaies virtuelles dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/currencies.md)
- [Boutiques personnalisées pour les segments de joueurs dans Economy (hérité)](/fr/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)