​

PlayFab 아이템 및 인벤토리 개요

​

주요 개념

• Catalog - Catalog는 게임에서 사용할 수 있는 모든 아이템의 컬렉션입니다. Catalog는 게임의 가상 아이템을 관리하는 쉬운 방법을 제공합니다. 자세한 내용은 Catalog 개요를 참조하세요.
• Catalog Items – 카탈로그에 정의된 개별 아이템입니다. 무기, 의상, 파워업, 전리품 상자 등과 같은 모든 종류의 가상 상품을 나타낼 수 있습니다. 게임 디자인에 맞게 속성과 동작을 사용자 지정할 수 있습니다.
• Catalog Stores - 스토어를 사용하면 시즌 이벤트, 프로모션, 테스트 등 다양한 목적을 위해 여러 아이템 목록을 만들 수 있습니다. 스토어를 참조하세요.
• 번들 - 번들은 다른 아이템에 대한 참조를 포함하는 카탈로그 아이템입니다. 플레이어가 번들을 구매하면 참조된 아이템이 언패킹되어 인벤토리에 추가됩니다.
• 구독 - 구독은 지속형 상품에 대한 시간 기반 액세스를 부여합니다. 구독 내 아이템은 구독 기간 동안 플레이어의 인벤토리에서 사용할 수 있습니다. 구독을 참조하세요.
• Player Inventory Collections - 인벤토리는 플레이어가 게임에서 소유하고 있는 아이템의 기록입니다. 여기에는 아이템 수량, 가상 화폐 잔액 및 사용자 지정 속성에 대한 정보가 포함됩니다. 모든 플레이어 계정은 Collections라고 하는 하나 이상의 인벤토리를 가질 수 있습니다.
• Stacks - Stacks를 사용하면 동일한 아이템의 여러 별개 인스턴스가 각각의 수량과 사용자 지정 속성과 함께 단일 인벤토리에 존재할 수 있습니다. Stacks를 참조하세요.
• Virtual Currency - 가상 화폐는 게임에서 교환 수단으로 사용되는 아이템 유형입니다. 가상 화폐를 사용하여 카탈로그나 스토어에서 아이템을 구매하거나, 인앱 구매의 소프트 통화를 구현하거나, 게임 플레이 메커니즘을 이끌 수 있습니다.

​

주요 API

​

인벤토리 관리

• GetInventoryItems - 엔터티의 현재 인벤토리를 검색합니다. ContinuationToken으로 페이지 매김을 지원하고 TurboLoading을 통해 대량 로드를 지원합니다.
• AddInventoryItems - 아이템을 플레이어의 인벤토리에 직접 추가합니다.
• SubtractInventoryItems - 플레이어의 인벤토리에서 아이템 수량을 줄입니다.
• UpdateInventoryItems - 인벤토리 아이템의 수량을 설정하거나 Display Properties를 수정합니다.
• DeleteInventoryItems - 플레이어의 인벤토리에서 아이템 스택 전체를 제거합니다.

​

구매 및 거래

• PurchaseInventoryItems - 가상 화폐를 사용하여 카탈로그 아이템이나 번들을 구매합니다. 플레이어의 인벤토리에서 통화를 차감하고 구매한 아이템을 부여합니다.
• TransferInventoryItems - 플레이어 간, 플레이어의 인벤토리 컬렉션 간 또는 동일한 인벤토리 내 스택 간에 아이템을 이전합니다.

​

일괄 작업

• ExecuteInventoryOperations - 단일 원자적 요청에서 최대 10개의 인벤토리 작업(Add, Subtract, Update, Purchase, Transfer, Delete)을 일괄 처리합니다. 어떤 작업이든 실패하면 전체 일괄 작업이 롤백됩니다.

​

이력 및 진단

• GetTransactionHistory - 플레이어의 인벤토리에서 트랜잭션 이벤트를 검색합니다. 전체 작업 이력을 검토하기 위해 타임스탬프별 필터링과 페이지 매김을 지원합니다. 트랜잭션 이력을 참조하세요.

​

안정성

• 멱등성 - 모든 인벤토리 API는 중복 부작용 없이 요청을 안전하게 재시도하기 위해 IdempotencyId 매개 변수를 지원합니다. ID는 14일 동안 적용됩니다. 멱등성을 참조하세요.