> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Player Inventory 빠른 시작

> PlayFab Beta SDK를 사용하여 플레이어를 인증하고, 카탈로그를 검색하고, 아이템을 구매하고, 플레이어의 Economy v2 인벤토리에 표시되는지 확인합니다.

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

<Info>
  Economy v2는 이제 정식으로 사용할 수 있습니다(GA). 지원 및 피드백은 [PlayFab Forum](https://community.playfab.com)을 방문하세요.
</Info>

PlayFab Beta SDK를 사용하여 아이템을 구매하고 플레이어의 인벤토리에 추가되었는지 확인함으로써 Player Inventories에 익숙해지세요. API를 통해 타이틀과 상호 작용하기 위한 엔터티 토큰을 얻은 후 카탈로그에서 아이템을 검색하고, 아이템을 구매한 다음, 플레이어의 인벤토리를 가져와 구매한 아이템을 찾습니다.

## 필수 구성 요소

* [PlayFab 개발자 계정](https://developer.playfab.com)
* PlayFab Beta SDK ([Postman Quickstart](/services/playfab/sdks/postman/postman-quickstart#adding-playfab-collections)에서 자세한 정보를 찾을 수 있습니다.)
* 카탈로그에 최소 하나의 아이템 ([Economy v2 Quickstart](/services/playfab/economy-monetization/economy-v2/quickstart)에서 자세한 정보를 찾을 수 있습니다.)
* 아이템을 구매하기에 충분한 가상 화폐가 있는 최소 한 명의 플레이어

## 플레이어로 로그인

이 빠른 시작에서 나머지 API 호출에 필요한 보안 토큰을 받으려면 먼저 플레이어를 로그인해야 합니다. [Player Authentication](/services/playfab/identity/player-identity/login) 페이지에서 자세한 정보를 찾을 수 있습니다.

## 아이템 검색

카탈로그에서 아이템을 찾으려면 `Search`를 호출합니다. 호출 본문에서:

```json theme={null}
{
  "Search": "[Item Title]",
  "Top": 1
}
```

* `Search`는 카탈로그의 모든 아이템의 Title, Description, Keywords에 대해 퍼지 검색되는 검색 문자열입니다.
* `Top`은 반환할 결과 수를 결정하는 정수입니다 - 이 경우 하나만 필요합니다.

<Note>
  [Search quickstart](/services/playfab/economy-monetization/economy-v2/catalog/search)에서 학습할 수 있는 더 많은 필드가 있습니다.
</Note>

응답에서 다음 필드를 가져오세요.

* `Items` > `Id` - 아이템의 Catalog ID
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `ItemId` - 아이템을 구매하는 데 사용되는 가상 화폐 ID
* `Items` > `PriceOptions` > `Prices` > `Amounts` > `Amount` - 아이템을 구매하는 데 필요한 가상 화폐 금액

<Note>
  Title Entities만 아이템의 가격을 설정할 수 있습니다.
</Note>

## 아이템 구매

아이템을 구매하려면 `PurchaseInventoryItems`를 호출합니다. 호출 본문에서:

```json theme={null}
{
  "Item": {
    "Id": "{{ItemID}}",
  },
  "Amount": 1,
  "PriceAmounts": [
    {
      "ItemId": "{{CurrencyId}}",
      "Amount": 15
    }
  ]
}
```

* `Item.Id`는 아이템의 ID입니다(이전 단계의 `Search` 응답에서 가져옴).
* `Amount`는 플레이어가 구매하는 아이템 수입니다.
* `ItemId`는 아이템을 구매하는 데 사용되는 가상 화폐의 ID입니다(이전 단계의 `Search` 응답에서 가져옴).
* `Amount`는 아이템을 구매하는 데 필요한 가상 화폐의 금액입니다(이전 단계의 `Search` 응답에서 가져옴).

## 플레이어의 인벤토리 아이템 가져오기

`GetInventoryItems`를 통해 플레이어가 새로 구매한 아이템을 확인합니다. 호출에서 본문이 비어 있는지 확인하세요 - 본문에 엔터티를 지정할 수 있지만, 정보가 이미 헤더의 엔터티 토큰을 통해 전달되기 때문에 필요하지는 않습니다.

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

<Note>
  플레이어가 이미 동일한 `StackId`로 해당 아이템을 인벤토리에 가지고 있는 경우 구매 후 다른 아이템 인스턴스가 표시되지 않고 대신 `Amount` 필드가 증가하는 것을 볼 수 있습니다.
</Note>

## 문제 해결

* 자금 부족
  * `PurchaseInventoryItems`를 호출하고 `422: InsufficientFunds` 오류를 받는 경우 플레이어에게 아이템을 구매할 충분한 가상 화폐가 없습니다. `AddInventoryItems`(타이틀 엔터티 토큰 필요)를 호출하거나 Game Manager에서 **\[Title]** > **Players** > **\[Player]** > **`Inventory (V2)`** 로 이동하여 플레이어에게 가상 화폐를 부여할 수 있습니다.
* 지정된 가격으로 아이템을 구매할 수 없음.
  * `PurchaseInventoryItems`를 호출하고 `1071` 오류 코드를 받는 경우 `PriceAmounts` 필드가 카탈로그에 지정된 가격과 일치하지 않습니다.

## 다음 단계

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

<Note>
  \[!div class="nextstepaction"] [Player inventory tutorial](/services/playfab/economy-monetization/economy-v2/tutorials/getting-started-with-unity-and-android)
</Note>

<Note>
  \[!div class="nextstepaction"] [스토어](/services/playfab/economy-monetization/economy-v2/catalog/stores)
</Note>

<Note>
  \[!div class="nextstepaction"] [번들](/services/playfab/economy-monetization/economy-v2/catalog/bundles)
</Note>


## Related topics

- [빠른 시작](/ko/services/playfab/economy-monetization/economy-v2/quickstart.md)
- [Fraud prevention 빠른 시작](/ko/services/playfab/economy-monetization/economy-v2/fraud-prevention/quickstart.md)
- [아이템(레거시 Economy) 빠른 시작](/ko/services/playfab/economy-monetization/economy/items/quickstart.md)
- [Economy(레거시) 빠른 시작](/ko/services/playfab/economy-monetization/economy/quickstart.md)
- [통계 빠른 시작](/ko/services/playfab/player-progression/statistics/quickstart-statistics.md)