ZEPETO.Multiplay.Currency

7 min

Type	Description
CurrencyError	Code d'erreur indiquant la raison de l'échec des requêtes liées aux devises in-World.
Currency	Currency gère les opérations liées aux devises du ZEPETO World.

CurrencyError

enum

Code d'erreur indiquant la raison de l'échec des requêtes liées aux devises in-World.

Nom	Valeur	Description
Unknown	-1	Erreur : erreur inconnue.
NetworkError	0	Erreur : erreurs liées au réseau, notamment les déconnexions ou les connexions instables.

Currency

interface

Currency gère les opérations liées aux devises du ZEPETO World.

Méthodes

debit

debit(id: string, quantity?: number, reason?: string) → Promise<boolean>

Déduit le montant spécifié du solde de devise in-World du joueur. Lève CurrencyError.

Paramètre	Type	Description
id	string	ID de la devise à déduire.
quantity (facultatif)	number	Quantité de devise à déduire. La valeur par défaut est 1.
reason (facultatif)	string	Décrit éventuellement la raison de la déduction.

Renvoie : Promise<boolean> — Promise résolue à la fin de l'opération, indiquant la réussite (true) ou l'échec (false).

credit

credit(id: string, quantity?: number, reason?: string) → Promise<boolean>

Augmente le solde de devise in-World du joueur du montant spécifié. Lève CurrencyError.

Paramètre	Type	Description
id	string	ID de la devise à augmenter.
quantity (facultatif)	number	Quantité de devise à augmenter. La valeur par défaut est 1.
reason (facultatif)	string	Décrit éventuellement la raison de l'augmentation.

Renvoie : Promise<boolean> — Promise résolue à la fin de l'opération, indiquant la réussite (true) ou l'échec (false).

getBalance

getBalance(id: string) → Promise<number>

Récupère le solde de la devise in-World du joueur. Lève CurrencyError.

Paramètre	Type	Description
id	string	ID de la devise à récupérer.

Renvoie : Promise<number> — Promise résolue à la fin de l'opération, avec le montant du solde récupéré.

getBalances

getBalances() → Promise<{ [key: string]: number }>

Récupère le solde de chaque devise in-World que possède le joueur. Lève CurrencyError.

Renvoie : Promise<{ [key: string]: number }> — Promise résolue à la fin de l'opération, avec un objet dont chaque clé est un ID de devise in-World et dont la valeur associée est le solde correspondant.