다음을 통해 공유

빠른 시작: 플레이어의 인벤토리에 첫 번째 항목 추가

  • 아티클

Important

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

PlayFab 베타 SDK를 사용하여 항목을 구매하고 플레이어의 인벤토리에 추가되었는지 확인하여 플레이어 인벤토리에 익숙해집니다. API를 통해 타이틀과 상호 작용할 엔터티 토큰을 얻은 후 카탈로그에서 항목을 검색하고 항목을 구매한 다음 플레이어의 인벤토리를 가져와 구매한 항목을 찾습니다.

필수 구성 요소

플레이어로 로그인

이 빠른 시작의 나머지 API 호출에 필요한 보안 토큰을 받으려면 먼저 플레이어에 로그인해야 합니다. 플레이어 인증 페이지에서 자세한 정보를 찾을 수 있습니다.

항목 검색

카탈로그에서 항목을 찾으려면 Search을(를) 호출해야 합니다. 호출 본문에서:

{
  "Search": "[Item Title]",
  "Top": 1
}
  • Search은(는) 카탈로그에 있는 모든 항목의 타이틀, 설명 및 키워드에 대해 퍼지 검색되는 검색 문자열입니다.
  • Top은(는) 반환할 결과 수를 결정하는 정수입니다. 이 경우 하나만 필요합니다.

참고 항목

검색 빠른 시작에서 알아볼 수 있는 추가 필드가 있습니다.

응답에서 다음 필드를 가져옵니다.

  • Items > Id - 항목의 카탈로그 ID
  • Items > PriceOptions > Prices > Amounts > ItemId - 아이템 구매에 사용된 가상 화폐의 ID
  • Items > PriceOptions > Prices > Amounts > Amount - 항목을 구매하는 데 필요한 가상 화폐의 금액

참고 항목

타이틀 엔터티만 항목에 대한 가격을 설정할 수 있습니다.

아이템 구매

아이템을 구매하려면 PurchaseInventoryItems(으)로 전화하세요. 호출 본문에서:

{
  "Item": {
    "Id": "{{ItemID}}",
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{CurrencyId}}",
      "Amount": 15
    }
  ]
}
  • Item.Id은 항목의 ID입니다(이전 단계의 Search 응답에서 가져옴).
  • Amount은(는) 플레이어가 구매하는 항목의 수입니다.
  • ItemId은(는) 항목을 구매하는 데 사용된 가상 통화의 ID입니다(이전 단계의 Search 응답에서 가져옴).
  • Amount은(는) 항목을 구매하는 데 필요한 가상 화폐의 양입니다(이전 단계의 Search 응답에서 가져옴).

플레이어의 인벤토리 항목 가져오기

GetInventoryItems을(를) 통해 플레이어의 새로 구입한 항목을 확인합니다. 호출에서 본문이 비어 있는지 확인합니다. 본문에 엔터티를 지정할 수 있지만 헤더의 엔터티 토큰을 통해 정보가 이미 전달되고 있으므로 필요하지 않습니다.

응답에는 플레이어가 소유한 각 항목의 ID와 각 항목의 양이 포함됩니다. 새로 구입한 아이템은 플레이어의 인벤토리에 있습니다.

참고 항목

플레이어의 인벤토리에 동일한 StackId 항목이 이미 있는 경우 구매 후 다른 항목 인스턴스가 표시되지 않습니다. 대신 Amount 필드가 증가하는 것을 볼 수 있습니다.

문제 해결

  • 잔액 부족
    • PurchaseInventoryItems을(를) 호출하고 422: InsufficientFunds 오류를 수신하면 플레이어에 항목을 구매할 가상 통화가 충분하지 않은 것입니다. AddInventoryItems(타이틀 엔터티 토큰 필요)를 호출하거나 [타이틀]>플레이어>[플레이어]로 이동하여 플레이어에게 가상 통화를 부여할 수 있습니다. 게임 관리자의 >Inventory (V2)
  • 항목을 지정된 가격으로 구매할 수 없습니다.
    • PurchaseInventoryItems을(를) 호출하고 1071 오류 코드를 수신하면 PriceAmounts 필드가 카탈로그에 지정된 가격과 일치하지 않는 것입니다.

다음 단계

이제 플레이어의 첫 번째 아이템을 구매했으므로 아이템을 소비하고 스토어에 아이템을 추가하여 판매할 수 있으며 아이템이 포함된 번들을 생성하고 구매할 수 있습니다.

플레이어 인벤토리 자습서

스토어

번들