> ## 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 (Legacy)

> Configurez des consommables temporisés PlayFab Economy Legacy dans Game Manager afin que les articles soient consommés automatiquement dans l'inventaire d'un joueur après une durée définie.

# Consommables temporisés (Economy Legacy)

<Info>
  Les API Economy v1 sont en mode maintenance et ne recevront aucune nouvelle fonctionnalité, seulement des correctifs de bogues. **Les API v1 seront maintenues dans un avenir prévisible.** Consultez la [vue d'ensemble d'Economy v2](/fr-CA/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 articles configurés pour être consommés automatiquement après un délai précis à compter de leur octroi initial au joueur.

## Exigences

* Nous supposons que vous connaissez déjà les [catalogues](/fr-CA/services/playfab/economy-monetization/economy/items/catalogs), l'[inventaire](/fr-CA/services/playfab/player-progression/player-data/player-inventory) et le [Game Manager](/fr-CA/services/playfab/live-service-management/gamemanager/quickstart) de PlayFab.
* Vous devez avoir 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 Game Manager :

1. Accédez à votre **titre**.
2. Sélectionnez **Economy** dans le menu de gauche.
3. Allez dans l'onglet **Catalogs** et choisissez votre catalogue principal - votre écran devrait 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 article" 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 le coin supérieur droit.
5. Remplissez les champs suivants :

   | Nom du champ | Exemple de valeur | Description |
   | :-: | :-: | - |
   | Item ID | Small\_Stamina\_Potion | Ce champ *obligatoire* est l'identifiant unique de l'article dans le catalogue. L'ID d'article doit être unique dans le catalogue, mais vous pouvez avoir plusieurs versions de catalogue contenant des articles ayant le même ID d'article. |
   | Display Name | Small Stamina Potion | Ce champ *facultatif* est le nom affiché pour l'article du catalogue. Un usage courant consiste à offrir l'article dans votre magasin en jeu. Les noms d'affichage n'ont pas besoin d'être uniques. |
   | Consumable | Consumable | Indique si l'article est **durable** ou **consommable**. |
   | By Count | 1 | Ce champ est *obligatoire* lorsque **Consumable** est sélectionné. Il détermine de combien le nombre de cet article sera décrémenté lors de sa consommation. |
   | By Time | 5 Minutes | Ce champ est *facultatif* lorsque **Consumable** est sélectionné. Il détermine le temps qui s'écoulera entre le moment où l'article 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 articles portant le même nom de groupe. |
   | Is Stackable | True | Marquer un article comme **empilable** ne permet qu'un seul article de ce type dans l'inventaire et incrémente la quantité de cet article. |

   <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 - Article 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, l'article sera consommé à 13 h 05. Si j'octroie une autre petite potion d'endurance à 13 h 02, les deux articles seront consommés à 13 h 10.

<Note>
  Si vous ne spécifiez pas de nom de groupe de temps pour un consommable temporisé empilable, la pile complète expirera au moment de l'expiration initiale définie lors du premier octroi. Par exemple, dans le scénario ci-dessus, si je laissais plutôt le nom de groupe de temps vide et que j'octroyais une petite potion d'endurance à un joueur à 13 h, l'article serait consommé à 13 h 05. Si j'octroie une autre petite potion d'endurance à 13 h 02, les deux articles seront tout de même consommés à 13 h 05. Si j'octroie encore une autre petite potion d'endurance à 13 h 04, les trois articles seront tout de même consommés à 13 h 05. Mais une fois la pile consommée, si j'octroie une petite potion d'endurance à 13 h 10, l'article sera consommé à 13 h 15.
</Note>

## Créer un consommable temporisé non empilable

Créons un exemple semblable au précédent, mais avec un article 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 article additionnel. Dans Game Manager :

1. Accédez à votre **titre**.
2. Sélectionnez **Economy** dans le menu de gauche.
3. Allez dans l'onglet **Catalogs** et choisissez votre catalogue principal - votre écran devrait 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 articles" 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 le coin supérieur droit.
5. Remplissez les champs suivants :

   | Nom du champ | Exemple de valeur | Description |
   | :-: | :-: | - |
   | Item ID | Med\_Stamina\_Potion | Ce champ *obligatoire* est l'identifiant unique de l'article dans le catalogue. L'ID d'article doit être unique dans le catalogue, mais vous pouvez avoir plusieurs versions de catalogue contenant des articles ayant le même ID d'article. |
   | Display Name | Medium Stamina Potion | Ce champ *facultatif* est le nom affiché pour l'article du catalogue. Un usage courant consiste à offrir l'article dans votre magasin en jeu. Les noms d'affichage n'ont pas besoin d'être uniques. |
   | Consumable | Consumable | Indique si l'article est **durable** ou **consommable**. |
   | By Count | 1 | Ce champ *obligatoire* (lorsque **Consumable** est sélectionné) détermine de combien le nombre de cet article sera décrémenté lors de sa consommation. |
   | By Time | 10 Minutes | Ce champ *facultatif* (lorsque **Consumable** est sélectionné) détermine le temps qui s'écoulera entre le moment où l'article 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 articles portant le même nom de groupe. |
   | Is Stackable | False | Marquer un article comme **empilable** ne permet qu'un seul article de ce type dans l'inventaire et incrémente la quantité de cet article. |

   <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 - Article 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, puisque l'article n'est pas empilable. Vous pourrez tout de même « empiler » automatiquement le temps restant de ces articles. Par exemple, si j'octroie une potion d'endurance moyenne à un joueur à 13 h, l'article sera consommé à 13 h 10. Si j'octroie une autre potion d'endurance moyenne à 13 h 05, les deux articles seront consommés à 13 h 20.

<Note>
  Si vous ne spécifiez pas de nom de groupe de temps pour un consommable temporisé non empilable, chaque instance expirera indépendamment des autres. Par exemple, dans le scénario ci-dessus, si je laissais plutôt le nom de groupe de temps vide et que j'octroyais une potion d'endurance moyenne à un joueur à 13 h, l'article serait consommé à 13 h 10. Si j'octroie une autre potion d'endurance moyenne à 13 h 05, le premier article sera tout de même consommé à 13 h 10, et le deuxième article sera consommé à 13 h 15.
</Note>

## Lier plusieurs consommables temporisés

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

1. Accédez à votre **titre**.
2. Sélectionnez **Economy** dans le menu de gauche.
3. Allez dans l'onglet **Catalogs** et choisissez votre catalogue principal - votre écran devrait 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 articles" 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 articles.
5. Remplacez la valeur de **Time Group Name** `Med_Stamina_Potion` par `Stamina_Potion`.
6. Sélectionnez **Save item**.
7. Sélectionnez **Small\_Stamina\_Potion** dans la liste des articles.
8. Remplacez la valeur de **Time Group Name** `Small_Stamina_Potion` par `Stamina_Potion`.
9. Sélectionnez **Save item**.

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


## Related topics

- [Magasins et soldes dans Economy (Legacy)](/fr-CA/services/playfab/economy-monetization/economy/tutorials/stores-and-sales.md)
- [Tables de butin dans Economy (hérité)](/fr-CA/services/playfab/economy-monetization/economy/tutorials/drop-tables.md)
- [Extensions consommables](/fr-CA/publishing/game-publishing/concepts/add-ons/consumable-add-ons.md)
- [Catalogues (Economy hérité)](/fr-CA/services/playfab/economy-monetization/economy/items/catalogs.md)
- [Échange avec la place de marché Microsoft Store](/fr-CA/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-redemption/microsoft.md)