빠른 시작: 플레이어의 인벤토리에 첫 번째 아이템 추가
Economy v2는 이제 정식으로 사용할 수 있습니다(GA). 지원 및 피드백은 PlayFab Forum을 방문하세요.
필수 구성 요소
- PlayFab 개발자 계정
- PlayFab Beta SDK (Postman Quickstart에서 자세한 정보를 찾을 수 있습니다.)
- 카탈로그에 최소 하나의 아이템 (Economy v2 Quickstart에서 자세한 정보를 찾을 수 있습니다.)
- 아이템을 구매하기에 충분한 가상 화폐가 있는 최소 한 명의 플레이어
플레이어로 로그인
이 빠른 시작에서 나머지 API 호출에 필요한 보안 토큰을 받으려면 먼저 플레이어를 로그인해야 합니다. Player Authentication 페이지에서 자세한 정보를 찾을 수 있습니다.아이템 검색
카탈로그에서 아이템을 찾으려면Search를 호출합니다. 호출 본문에서:
Search는 카탈로그의 모든 아이템의 Title, Description, Keywords에 대해 퍼지 검색되는 검색 문자열입니다.Top은 반환할 결과 수를 결정하는 정수입니다 - 이 경우 하나만 필요합니다.
Search quickstart에서 학습할 수 있는 더 많은 필드가 있습니다.
Items>Id- 아이템의 Catalog IDItems>PriceOptions>Prices>Amounts>ItemId- 아이템을 구매하는 데 사용되는 가상 화폐 IDItems>PriceOptions>Prices>Amounts>Amount- 아이템을 구매하는 데 필요한 가상 화폐 금액
Title Entities만 아이템의 가격을 설정할 수 있습니다.
아이템 구매
아이템을 구매하려면PurchaseInventoryItems를 호출합니다. 호출 본문에서:
Item.Id는 아이템의 ID입니다(이전 단계의Search응답에서 가져옴).Amount는 플레이어가 구매하는 아이템 수입니다.ItemId는 아이템을 구매하는 데 사용되는 가상 화폐의 ID입니다(이전 단계의Search응답에서 가져옴).Amount는 아이템을 구매하는 데 필요한 가상 화폐의 금액입니다(이전 단계의Search응답에서 가져옴).
플레이어의 인벤토리 아이템 가져오기
GetInventoryItems를 통해 플레이어가 새로 구매한 아이템을 확인합니다. 호출에서 본문이 비어 있는지 확인하세요 - 본문에 엔터티를 지정할 수 있지만, 정보가 이미 헤더의 엔터티 토큰을 통해 전달되기 때문에 필요하지는 않습니다.
응답에는 플레이어가 소유한 각 아이템의 ID와 각 아이템의 수량이 포함됩니다. 새로 구매한 아이템이 플레이어의 인벤토리에 있습니다.
플레이어가 이미 동일한
StackId로 해당 아이템을 인벤토리에 가지고 있는 경우 구매 후 다른 아이템 인스턴스가 표시되지 않고 대신 Amount 필드가 증가하는 것을 볼 수 있습니다.문제 해결
- 자금 부족
PurchaseInventoryItems를 호출하고422: InsufficientFunds오류를 받는 경우 플레이어에게 아이템을 구매할 충분한 가상 화폐가 없습니다.AddInventoryItems(타이틀 엔터티 토큰 필요)를 호출하거나 Game Manager에서 [Title] > Players > [Player] >Inventory (V2)로 이동하여 플레이어에게 가상 화폐를 부여할 수 있습니다.
- 지정된 가격으로 아이템을 구매할 수 없음.
PurchaseInventoryItems를 호출하고1071오류 코드를 받는 경우PriceAmounts필드가 카탈로그에 지정된 가격과 일치하지 않습니다.
다음 단계
이제 플레이어의 첫 번째 아이템을 구매했으므로 아이템을 소모하거나, 아이템을 스토어에 추가하여 판매하거나, 아이템이 포함된 번들을 만들고 구매할 수 있습니다.[!div class=“nextstepaction”] Player inventory tutorial
[!div class=“nextstepaction”] 스토어
[!div class=“nextstepaction”] 번들
