ZEPETO.Multiplay.Currency

enum

表示 World 内货币相关请求失败原因的错误代码。

interface

Currency 用于管理与 ZEPETO World 货币相关的操作。

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

从玩家的 World 内货币余额中扣除指定数量。会抛出 CurrencyError。

返回值： Promise<boolean> — 处理完成时兑现的 Promise，表示成功（true）或失败（false）。

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

向玩家的 World 内货币余额增加指定数量。会抛出 CurrencyError。

返回值： Promise<boolean> — 处理完成时兑现的 Promise，表示成功（true）或失败（false）。

getBalance(id: string) → Promise<number>

获取玩家的 World 内货币余额。会抛出 CurrencyError。

返回值： Promise<number> — 处理完成时兑现的 Promise，携带获取到的余额数值。

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

获取玩家持有的各 World 内货币的余额。会抛出 CurrencyError。

返回值： Promise<{ [key: string]: number }> — 处理完成时兑现的 Promise，携带以各 World 内货币 ID 为键、对应余额为值的对象。