다음을 통해 공유

Economy v2 스토어

  • 아티클

Important

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

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

스토어 만들기

스토어를 만들려면 먼저 게임에서 액세스/구매할 수 있도록 게시된 다른 카탈로그 항목, 통화 또는 UGC가 있는지 확인해야 합니다. Economy v2 빠른 시작의 단계를 따를 수 있습니다.

  1. Economy>카탈로그(V2)로 이동합니다.

  2. 스토어 탭에서 새 스토어를 선택합니다.

원하는 메타데이터를 입력하세요. 설정해야 할 핵심 항목 중 하나는 이 스토어에서 사용할 수 있는 항목과 이를 재정의하려는 가격입니다.

위는 LaserSword 및 WeaponBundle의 두 항목을 판매하는 스토어입니다. 두 항목 모두 카탈로그에 정의된 일부 기존 기본 가격이 있는 기존 카탈로그 항목입니다. 이 스토어는 기존 가격을 무시하고 이제 1 Diamond에 LaserSword, 10 금 및 10 은에 WeaponBundle을(를) 제공합니다.

이 요청은 스토어가 생성되고 게시되었다는 응답을 반환합니다.

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

이제 게시된 스토어와 연결된 Id에 유의하세요.

참고 항목

개념을 단순화하는 데 도움이 되도록 항목 ID가 GUID에서 항목 이름으로 바뀌어 Store 사용 예를 더 잘 설명합니다.

스토어 이용

스토어는 플레이어가 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 다이아몬드 비용과 어떻게 일치하는지 확인하세요.

스토어 검색

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

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