Skip to main content

첫 번째 가상 화폐 설정

Economy v2는 이제 정식 출시(GA)되었습니다. 지원 및 피드백은 PlayFab 포럼을 참조하세요.
PlayFab Services SDK를 사용해 PlayFab Economy를 시작하고 첫 번째 가상 화폐를 설정합니다. API를 통해 타이틀과 상호 작용하기 위한 엔터티 토큰을 얻은 후 가상 화폐를 만들고 구성합니다.

필수 구성 요소

타이틀 엔터티 토큰 가져오기

API를 통해 타이틀 구성 데이터를 변경하려면 먼저 타이틀 엔터티 토큰을 얻어야 합니다. 자세한 내용은 Postman 빠른 시작에서 확인할 수 있습니다.

새 가상 화폐 만들기

새 가상 화폐를 만들려면 Currency 유형의 Draft Item을 만들어야 합니다.

Game Manager

  1. Game Manager에서 Economy 탭으로 이동하여 **Catalog (V2)**를 선택합니다.
  2. Currency를 선택하고 New currency를 선택합니다.
  3. Title을 편집하고 Description을 추가합니다. 예를 들어, Diamonds, Our in-game currency of choice.
  4. Save and publish를 선택해 변경 사항을 완료합니다.
  5. Currency 목록에서 화폐를 확인합니다.

REST API

CreateDraftItem을 호출합니다. 다음 본문을 사용합니다.

  • FriendlyId는 통화 코드이며 1~3자리 영숫자 값을 포함할 수 있습니다.
  • Title은 플레이어에게 표시되는 표시 이름입니다.
  • ContentType은 Economy 아이템의 분류입니다. Game Manager의 ⚙️ > Title Settings > Economy > Catalog (V2) Settings에서 Content Type을 먼저 설정해야 합니다.
  • StartDate는 화폐가 플레이어에게 표시되는 시점을 나타내는 날짜/시간 문자열입니다(기본값은 생성 시간).

문제 해결

  • 누락되었거나 만료된 엔터티 토큰
    • CreateDraftItem을 호출하려 할 때 401: Unauthorized 오류가 발생하면 타이틀 엔터티 토큰을 가져오는 것을 잊었거나 만료되었을 수 있습니다.
  • 콘텐츠 유형 ''이(가) 지원되지 않음
    • CreateDraftItem을 호출하려 할 때 위 메시지와 함께 CatalogBadRequest가 발생하면 Game Manager의 타이틀 설정 페이지 아래 카탈로그 설정 탭에서 콘텐츠 유형을 먼저 만들어야 합니다.

다음 단계

이제 첫 번째 가상 화폐를 설정했으므로 다음을 수행할 수 있습니다.
  1. 앱 스토어에서 판매하는 PlayFab 번들에 화폐를 추가합니다.
  2. AddInventoryItems를 사용해 게임 서버가 플레이어에게 화폐를 보상하도록 합니다.
  3. 화폐에 해당하는 카탈로그 아이템에 가격을 할당합니다.
  4. PurchaseInventoryItems를 사용해 플레이어가 화폐로 카탈로그 아이템을 구매할 수 있도록 허용합니다.
마지막 수정일 2026년 8월 13일