다음을 통해 공유


카탈로그 v2 빠른 시작

Important

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

게임 관리자에 익숙해지면 다음을 수행할 수 있습니다.

  1. v2 카탈로그의 권한, 설정 및 항목을 설정합니다.
  2. 영수증 검증 설정
  3. 아이템 구매 안내

Unity의 자세한 연습은 Unity 관련 자습서를 참조하세요.

파트 1: 카탈로그 개요

1단계 – 권한 얻기

첫 번째 단계는 ⚙️ 타이틀 설정>Economy(V2) 아래의 게임 관리자 UI에 있는 설정 페이지에서 카탈로그를 활성화하는 것입니다. UpdateCatalogConfig API를 사용하고 IsCatalogEnabled 플래그를 true로 설정할 수 있습니다.

카탈로그와 상호 작용하려면 GameManger에 로그인하고 사이트 도구를 사용하거나 API를 사용하기 위한 엔터티 토큰을 가져와야 합니다. 엔티티 토큰을 얻는 가장 쉬운 방법은 GetEntityToken API를 사용하는 것입니다.

참고 항목

API를 관리자 또는 권한 있는 서비스로 호출하려면 첫 번째 카탈로그 항목을 만들기 전에 수행해야 하며 타이틀 비밀 키와 함께 X-SecretKey 헤더를 포함해야 합니다. 게임 관리자 UI의 ⚙️ 타이틀 설정>비밀 키에서 타이틀 비밀 키를 만들 수 있습니다.

curl \
  -H "X-SecretKey: {{SecretKey}}" \
  -H "Content-Type: application/json" \
  -X POST https://{{titleId}}.playfabapi.com/Authentication/GetEntityToken \
  -d "{\"CustomTags\": {\"user\": \"{{email}}\"}}"

제목의 관리자로 호출할 때 일명 사용자 로그인의 SessionTicket 없이 전화를 건 사람(귀하, 서버 또는 자동 스크립트)을 기록하는 CustomTags 항목 로깅을 포함하는 것이 가장 좋습니다. 이렇게 하면 PlayFab 로그를 쿼리할 때 변경 내용을 추적하고 문제를 식별하기가 더 쉬워집니다.

2단계 - 카탈로그 설정 구성

카탈로그 설정에는 콘텐츠 유형에서 사용자 생성 콘텐츠에 이르기까지 다양한 구성이 포함됩니다. API를 통해 모두 업데이트 및 검색할 수 있으며 게임 관리자에서 많은 항목을 쉽게 시각화할 수 있습니다.

  1. 게임 관리자에서 ⚙️ 타이틀 설정>Economy로 이동합니다.
  2. 카탈로그(V2) 탭에서 카탈로그 설정으로 이동합니다.
  3. 기본 콘텐츠 유형을 만듭니다("게임 항목" 유형을 만드는 것이 좋은 출발점입니다).

3단계 - 카탈로그에 항목 게시

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

항목 탭에서 새 항목을 선택합니다.

필수 메타데이터를 입력합니다. 필수 속성은 4개뿐입니다(크리에이터 유형, 타이틀, 시작일콘텐츠 유형). 게시를 선택합니다.

제작자 유형은 기본적으로 "타이틀"으로 설정됩니다. 하지만 플레이어가 게임용 항목을 만드는 경우가 있을 수 있습니다. 이 경우 "title_player_account"를 선택합니다. JSON 편집 옵션이 있는 필드는 기본적으로 '중립'으로 설정되는 지역화 언어와 같은 메타데이터로 키가 지정됩니다. 모든 날짜는 UTC입니다.

{
  "NEUTRAL": "My Game Item",
  "en-US": "My Game Item"
}

참고 항목

항목을 초안 상태로 전환할 필요는 없습니다. 초안은 일정 기간 동안 메타데이터를 반복할 것으로 예상되는 경우를 위한 것입니다. 매개 변수 "publish"를 지원하며 "true"로 설정하면 항목을 즉시 게시합니다. 이렇게 하면 패턴에 따라 일부 통화량을 절약할 수 있습니다.

항목이 초안에 있으면 PublishDraftItem 엔드포인트를 사용하여 '게시됨' 상태로 푸시할 수 있습니다(이 단계는 GameManager에서 보이지 않게 처리됨). 항목이 게시되면 검색이 가능하고 공개적으로 사용할 수 있습니다. 게시하려면 CreateDraftItem 응답에서 반환된 ItemId를 사용해야 합니다.

Publish 호출이 성공하면 이전에 게시된 ItemId 및 SearchItems 엔드포인트를 사용하여 항목을 검색할 수 있습니다. Catalog/Search API는 API에 제공된 매개 변수 집합을 사용하여 게시된 카탈로그에 대한 검색을 실행하고 페이지가 매겨진 결과 집합을 반환합니다.

게임 관리자 검색은 자명하며 각 Catalog v2 페이지에 있습니다. 게시됨초안 필터는 맨 위에 있습니다. 필터 목록을 보려면 검색 버튼 옆에 있는 필터(깔대기형) 아이콘을 선택합니다. OData 필터를 추가하려면 Enter ODATA filter을 선택합니다.

참고 항목

카탈로그/검색 필터, orderBy 및 선택 필드는 OData를 검색어 표준으로 사용합니다.

파트 2: 인벤토리 및 가상 통화 개요

인벤토리 항목 및 가상 통화는 PlayFab이 플레이어 엔터티에 대해 지원하는 가상 상품의 두 가지 게임 내 '버킷'입니다. 프로세스는 다음과 같습니다.

  1. 초기 가상 화폐 설정
  2. 가상 통화 비용으로 항목 만들기
  3. 플레이어 인벤토리에 아이템 추가

1단계: 통화 생성

가상 통화는 게임내 경제성의 토대입니다. 플레이어와 캐릭터들에게 이러한 통화를 부여할 수 있으며, 그러면 아이템을 구매하거나 교환하는 데 사용할 수 있습니다.

아이템은 가상 통화 또는 실제 돈의 가격을 가질 수 있습니다. 각 타이틀은 여러 자의적 가상 통화를 지원할 수 있습니다. 통화는 원하는 교환 매체(예: 금, 보석, 하트 또는 성간 크레딧)를 구현할 수 있는 유연성을 게임에 제공합니다.

  1. 게임 관리자를 열고 Economy>카탈로그(V2)로 이동합니다.
  2. 통화 탭을 선택합니다.
  3. 새 통화를 선택하고 시작 날짜, 사람이 읽을 수 있는 '중립' 키의 제목식별 ID를 설정합니다. 필드에 이 통화에 대한 고유 통화 코드를 입력합니다.
  4. 초안으로 저장을 선택합니다. 항목 ID는 초안 통화 코드로 사용됩니다.
  5. 통화 목록에서 초안 필터를 클릭하여 새 통화를 봅니다.
  6. 통화를 다시 수정하고 저장 및 게시를 선택합니다. Friendly ID는 게시된 통화 코드로 사용됩니다.

'통화' 유형에 대한 카탈로그/검색은 정의한 모든 통화를 반환합니다.

2단계 - 통화 부여

엔티티 플레이어는 구매를 위해 가상 화폐가 필요합니다.

  1. GameManager를 열고 플레이어로 이동한 다음 검색을 선택하여 플레이어 목록을 검색합니다.
  2. 통화를 부여할 플레이어 ID를 선택합니다.
  3. 인벤토리(V2) 탭을 선택합니다.
  4. 전체 통화 목록을 보려면 '통화' 유형으로 필터링하고 여러 항목 선택을 선택하세요.
  5. 생성한 Currency를 선택하고 엔티티 Player에 대한 새 금액을 입력합니다.
  6. 저장을 선택합니다.

Warning

플레이어 통화 보조금을 노출하는 페이지는 현재 GameManager에 없습니다. 로드맵을 참조하세요.

참고 항목

AddInventoryItems는 Title 관리자 호출로 간주되며 일반적으로 게임 클라이언트에서 직접 호출하는 것이 아닙니다.

3단계 - 카탈로그 항목 업데이트

항목을 가상 통화로 구매할 수 있으려면 항목에 통화 가치가 있어야 합니다.

  1. 게임 관리자를 열고 Economy로 이동합니다.
  2. 카탈로그(V2) 탭을 선택하고 게시됨 항목으로 필터링되었는지 확인합니다.
  3. 이전에 만든 항목의 타이틀을 선택합니다.
  4. 초안 항목 수정을 선택합니다.
  5. ➕ 새 가격 추가를 선택하고 생성한 통화 항목을 선택하여 금액을 설정합니다. 완료하려면 추가를 선택합니다.
  6. 저장 및 게시를 선택합니다.