Skip to content

모듈: iap

목차

기능

기능

consumePurchaseAsync

▸ consumePurchaseAsync(token): Promise<void>

현재 플레이어가 과금을 통해 구매한 특정 콘텐츠를 소비합니다. 구매한 콘텐츠를 플레이어에게 제공하기 전에 게임은 해당 콘텐츠의 소비를 요구해야 한다. 소비가 성공적으로 이루어지면, 플레이어에게 구매 효과를 즉시 제공해야 합니다. 그러면 플레이어의 구매 내역에 구매 완료로 업데이트되고, 구매 가능한 콘텐츠 목록에도 구매 완료로 표시됩니다.

예

Wortal.iap.consumePurchaseAsync('abc123');

매개변수

이름 유형 설명
token string 소비 목적의 구매 토큰.

Returns

Promise<void>

구매가 성공할 경우 해결되는 Promise, 그렇지 않은 경우 거절됩니다.

Throws

  • NOT_SUPPORTED
  • CLIENT_UNSUPPORTED_OPERATION
  • PAYMENTS_NOT_INITIALIZED
  • INVALID_PARAM
  • NETWORK_FAILURE

getCatalogAsync

▸ getCatalogAsync(): Promise<Product[]>

구매 가능한 콘텐츠 목록을 가져옵니다.

예

Wortal.iap.getCatalogAsync()
 .then(products => console.log(products));

Returns

Promise<Product[]>

플레이어가 구매할 수 있는 콘텐츠의 배열로 해결하는 Promise, 플레이어의 국가/지역에서 구매가 허용되지 않는 경우 빈 목록을 반환합니다.

Throws

  • NOT_SUPPORTED
  • CLIENT_UNSUPPORTED_OPERATION
  • PAYMENTS_NOT_INITIALIZED
  • NETWORK_FAILURE

getPurchasesAsync

▸ getPurchasesAsync(): Promise<Purchase[]>

플레이어가 구매한 콘텐츠 중 아직 소비되지 않은 콘텐츠를 가져옵니다. 클라이언트가 결제 관련 작업을 수행할 준비가 되었음을 확인했을 때, 즉 게임 시작 시점에 현재 플레이어의 구매 내역을 가져와야 한다. 그리고 아직 소비되지 않은 구매된 콘텐츠를 처리하고 소비할 수 있습니다.

예

Wortal.iap.getPurchasesAsync()
 .then(purchases => console.log(purchases));

Returns

Promise<Purchase[]>

플레이어가 구매한 콘텐츠의 배열로 해결하는 Promise.

Throws

  • NOT_SUPPORTED
  • CLIENT_UNSUPPORTED_OPERATION
  • PAYMENTS_NOT_INITIALIZED
  • NETWORK_FAILURE

isEnabled

▸ isEnabled(): boolean

이 세션에서 인앱 결제가 활성화되어 있는지 확인합니다.

예

const canShowShop = Wortal.iap.isEnabled();
shopButton.visible = canShowShop;

Returns

boolean

인앱 결제가 가능한 경우 true, 현재 플랫폼이나 플레이어의 기기에서 지원되지 않거나 구매 화면이 제대로 로딩되지 않는 경우 false가 됩니다.

makePurchaseAsync

▸ makePurchaseAsync(purchase): Promise<Purchase>

특정 콘텐츠 구매 플로우를 시작합니다.

예

Wortal.iap.makePurchaseAsync({
    productID: 'my_product_123',
}).then(purchase => console.log(purchase));

매개변수

이름 유형 설명
purchase PurchaseConfig 제품 ID와 구매 정보를 정의하는 객체.

Returns

Promise<Purchase>

플레이어가 제품 구매에 성공하면 해결되는 Promise, 그렇지 않으면 거부됩니다.

Throws

  • NOT_SUPPORTED
  • CLIENT_UNSUPPORTED_OPERATION
  • PAYMENTS_NOT_INITIALIZED
  • INVALID_PARAM
  • NETWORK_FAILURE
  • INVALID_OPERATION
  • USER_INPUT