ZEPETO.Multiplay.Currency

6 분

형식	설명
CurrencyError	World 내 재화 관련 요청이 실패한 원인을 나타내는 오류 코드입니다.
Currency	Currency는 ZEPETO World 재화와 관련된 작업을 관리합니다.

CurrencyError

enum

World 내 재화 관련 요청이 실패한 원인을 나타내는 오류 코드입니다.

이름	값	설명
Unknown	-1	오류: 알 수 없는 오류입니다.
NetworkError	0	오류: 연결 끊김이나 불안정한 연결 등 네트워크 문제와 관련된 오류입니다.

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를 발생시킵니다.

매개변수	형식	설명
id	string	가져올 재화의 ID입니다.

반환값: Promise<number> — 작업 완료 시 가져온 잔액과 함께 이행되는 Promise입니다.

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

플레이어가 보유한 각 World 내 재화의 잔액을 가져옵니다. CurrencyError를 발생시킵니다.

반환값: Promise<{ [key: string]: number }> — 작업 완료 시 각 World 내 재화 ID를 키로, 해당 잔액을 값으로 갖는 객체와 함께 이행되는 Promise입니다.