첫 번째 가상 통화 설정

아티클
08/09/2023

Important

이제 Economy v2가 일반 공급됩니다. 지원 및 피드백을 받으려면 PlayFab 포럼으로 이동하세요.

PlayFab 서비스 SDK를 사용하여 첫 번째 가상 통화를 설정하여 PlayFab Economy를 시작하세요. API를 통해 타이틀과 상호 작용하는 엔터티 토큰을 가져온 다음, 가상 통화를 만들고 구성합니다.

필수 구성 요소

PlayFab 개발자 계정
PlayFab 베타 SDK(Postman 빠른 시작에서 자세한 정보를 찾을 수 있음)

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

API를 통해 타이틀 구성 데이터를 변경하려면 먼저 타이틀 엔터티 토큰을 가져와야 합니다. Postman 빠른 시작에서 자세한 정보를 찾을 수 있습니다.

새 가상 통화 만들기

새 가상 통화를 만들려면 통화 유형의 초안 항목을 만들어야 합니다.

게임 관리자
REST API

게임 관리자에서 경제 탭으로 이동하여 카탈로그(V2)를 선택합니다.
통화를 선택하고 새 통화를 선택합니다.
타이틀을 편집하고 설명을 추가합니다(예: Diamonds, Our in-game currency of choice.).
저장 및 게시를 선택하여 변경을 완료합니다.
통화 목록에서 통화를 관찰합니다.

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

{
  "Item": {
    "CreatorEntity": {
      "Id": "{{TitleID}}",
      "Type": "title"
    },
    "Type": "currency",
    "AlternateIds": [
      {
        "Type": "FriendlyId",
        "Value": "diamonds"
      }
    ],
    "Title": {
      "NEUTRAL": "Diamonds"
    },
    "Description": {
      "NEUTRAL": "Our in-game currency of choice."
    },
    "StartDate": "2023-07-27T00:00:00.000Z",
  },
  "Publish": true,
  "CustomTags": {
    "user": "{{Email}}"
  }
}

FriendlyId는 1~3개의 영숫자 값을 포함할 수 있는 통화 코드입니다.
Title은 플레이어에게 표시되는 표시 이름입니다.
ContentType은(는) 경제 항목의 분류입니다. 먼저 ⚙️ > 타이틀 설정 > 경제 > 카탈로그(V2) 설정에서 콘텐츠 유형을 설정해야 합니다.
StartDate은 통화가 플레이어에게 표시되는 시기를 나타내는 날짜/시간 문자열입니다(기본값은 생성 시간).

문제 해결

엔터티 토큰 누락/만료
- CreateDraftItem 호출을 시도하고 401: Unauthorized 오류를 수신하는 경우 제목 엔터티 토큰을 가져오는 것을 잊었거나 만료되었을 수 있습니다.
콘텐츠 유형 ''은(는) 지원되지 않습니다.
- CreateDraftItem에 전화를 걸고 위의 메시지와 함께 CatalogBadRequest를 수신하려는 경우 먼저 게임 관리자의 타이틀 설정 페이지 아래에 있는 카탈로그 설정 탭에서 콘텐츠 유형을 생성해야 합니다.

다음 단계

이제 첫 번째 가상 통화를 설정했으므로 다음을 수행할 수 있습니다.

앱 스토어에서 판매하는 PlayFab 번들에 통화를 추가합니다.
게임 서버에서 AddInventoryItems를 사용하여 플레이어에게 통화를 보상하도록 합니다.
통화에 해당하는 카탈로그 항목에 가격을 지정합니다.
플레이어가 PurchaseInventoryItems를 사용하여 통화로 카탈로그 항목을 구매할 수 있습니다.

다음을 통해 공유