Economy v2 스토어 - XBOX Game Development Documentation

Economy v2는 이제 정식으로 사용할 수 있습니다(GA). 지원 및 피드백은 PlayFab Forum을 방문하세요.

스토어는 게임 내 Economy를 구축하고 개발하는 훌륭한 방법입니다. 스토어는 아이템 및 가격 목록을 보유하는 특수 아이템 유형이며 아이템의 기본 카탈로그 가격을 재정의할 수 있게 해줍니다. 스토어를 사용하여 게임에서 아이템을 구매할 수 있는 위치를 관리하고, 게임 내 할인 및 프로모션을 제공하는 등 다양한 작업을 수행할 수 있습니다!

스토어 만들기

스토어를 만들려면 먼저 게임에서 접근/구매 가능하도록 하려는 다른 게시된 Catalog Items, Currency 또는 UGC가 있는지 확인해야 합니다. Economy v2 Quickstart의 단계를 따를 수 있습니다.

GameManager

Economy > Catalog (V2) 로 이동합니다.
Stores 탭에서 New Store를 선택합니다.

원하는 메타데이터를 채웁니다. 중요한 설정 중 하나는 이 스토어에서 사용할 수 있게 하려는 아이템과 어떤 가격으로 재정의할지입니다.

API

CreateDraftItem을 사용하여 스토어를 만들 수 있습니다. 스토어를 만드는 CreateDraftItem 요청 예:

{
  "Item": {
   "Type": "store",
    "Title": {
      "NEUTRAL": "My First Store",
    },
    "StartDate": "2022-09-07T00:00:00.00000000Z",
    "ItemReferences":[
      {
        "Id":"LaserSword",
        "Amount": 1,
        "PriceOptions": {
          "Prices": [{
            "Amounts": [{
              "ItemId": "Diamond",
              "Amount": 1
            }]
          }]
        }
      },
      {
      "Id":"WeaponBundle",
      "PriceOptions": {
        "Prices": [{
          "Amounts": [{
            "ItemId": "Gold",
            "Amount": 10
            },
            {
            "ItemId": "Silver",
            "Amount": 10
          }]
        }],
      },
    }]
   },
   "Publish": true
}

위는 LaserSword와 WeaponBundle이라는 두 개의 아이템을 판매하는 스토어입니다. 두 아이템 모두 카탈로그에 정의된 기존 기본 가격이 있는 기존 카탈로그 아이템입니다. 이 스토어는 기존 가격을 재정의하며 이제 LaserSword는 1 Diamond에, WeaponBundle은 10 Gold와 10 Silver에 제공합니다. 이 요청은 스토어가 만들어지고 게시되었다는 응답을 반환합니다.

{
  "code": 202,
  "status": "Accepted",
  "Item": {
    "Type": "store",
    "Id": "{{StoreID}}", 
    "Title": {
      "NEUTRAL": "My First Store",
    },
    ...
}

이제 게시된 스토어와 연결된 Id를 확인하세요.

개념을 간소화하는 데 도움이 되도록 스토어 사용의 예를 더 잘 설명하기 위해 Item ID가 GUID에서 Item 이름으로 바뀌었습니다.

스토어 사용

스토어는 플레이어가 PurchaseInventoryItems API를 호출할 때 사용됩니다. PurchaseInventoryItems를 호출할 때 선택적 속성 중 하나는 StoreId 매개 변수이며, 이 매개 변수를 통해 이 구매 요청에 적용할 스토어를 전달할 수 있습니다. 스토어를 사용하는 PurchaseInventoryItems 요청 예:

{
    "Entity": {
        "Type": "title_player_account",
        "Id": "{{PlayerID}}"
    },
    "Item": {
        "Id": "LaserSword",
    },
    "Amount": 10,
    "PriceAmounts": [
        {
            "ItemId": "Diamond",
            "Amount": 1
        }
    ],
    "StoreId": "{{StoreID}}"
}

구매 요청에 전달된 {{StoreId}}와 예상된 PriceAmount가 이제 스토어에 설정된 1 Diamond 비용과 일치하는 방식에 유의하세요.

스토어 검색

SearchItems API를 사용할 때 전달할 수 있는 속성 중 하나는 Store 매개 변수입니다. 이 매개 변수를 사용하면 스토어의 컨텍스트 내에서 검색할 수 있습니다. 특정 스토어에 아이템이 존재하는지 확인할 수 있을 뿐만 아니라 스토어 아이템/콘텐츠의 재정의된 가격을 표시하는 데도 사용할 수 있습니다. 스토어의 AlternateId를 사용하여 검색할 수도 있습니다.

{
  "Search": "",
  "Filter": "ContentType eq 'weapons'",
  "Store": {
    "Id": "{{StoreID}}"
  },
}

​스토어 만들기

​GameManager

​API

​스토어 사용

​스토어 검색

스토어 만들기

GameManager

API

스토어 사용

스토어 검색