PlayFab 으로 통합
작동 방식
주의
지원되는 PlayFab API 버전: Economy v1 .
- PlayFab에서 카탈로그 가져오기. 인게임 스토어로 카탈로그를 가져와서 엑솔라 솔루션을 사용할 수 있습니다.
- 아이템 자동 이전. 사용자가 인게임 스토어를 통해 구매한 아이템정보를 PlayFab으로 자동으로 이전합니다.
사용자
- PlayFab을 통합하고 이제 엑솔라 솔루션을 통해 아이템(인게임 재화 및 가상 아이템) 유통 영역을 확대하고자 하는 파트너.
- 엑솔라 솔루션을 통합하고 이제 PlayFab에서 아이템을 현금화(실제 통화로 아이템 판매)하려는 파트너.
규칙 가져오기
PlayFab에서 아이템을 가져올 때 다음 로직이 적용됩니다:
- PlayFab의 내구재는 가상 아이템(인게임 재화나 번들이 아님)으로 가져옵니다.
- 모든 아이템과 인게임 재화 패키지 및 PlayFab 번들 내 아이템은 소모품으로 가져옵니다. (매개 변수
consumable = true
또는 지정되지 않음). - 인게임 재화는 일부 사용 가능한 상태로 그리고 지정된 값(API 플래그:
is_show_in_store = false
,is_enabled = true
,is_free = true
)이 없는 상태로 가져옵니다. - 한 가지 유형의 인게임 재화만 포함된 번들은 인게임 재화 패키지로 가져옵니다.
- 여러 유형의 인게임 재화가 포함된 번들은 별도의 인게임 재화 패키지로 가져옵니다. SKU 및 수량에 대한 개별적인 고유 조합은 일부 사용 가능한 상태(API 플래그:
is_show_in_store = false
,is_enabled = true
,is_free = true
)로 무료 인게임 재화 패키지가 생성됩니다. - 여러 유형의 아이템이 포함된 번들을 번들로 가져옵니다.
- PlayFab에 아이템의 설명 필드가 채워져 있지 않은 경우, 이름 필드가 아이템 설명으로 사용되고, 이름이 없는 경우, SKU를 사용합니다.
가져오기 제한 사항
인게임 스토어 제한 사항
- 컨테이너 및 컨테이너가 포함된 번들은 가져오지 않습니다.
- DropTables 및 DropTables을 포함한 번들을 가져오지 않습니다.
isStackable
,isTradable
,UsageCount
,UsagePeriod
,UsagePeriodGroup
같이 PlayFab에 지정된 매개 변수는 무시합니다.- 소모품 아이템은 수량을 고려하지 않고 생성됩니다(처음 사용한 후 아이템이 인벤토리에서 사라짐).
PlayFab 제한 사항
- PlayFab은 가격을 실제 통화로 저장하지 않습니다. 실제 통화 1센트(100RM = 1USD)에 해당하는 RM(실제 금액)으로 코딩된 사전 구성된 인게임 재화만 사용합니다. 따라서 아이템 가격은 인게임 재화 또는 RM으로만 설정할 수 있습니다.
- 아이템의 SKU는 고유해야 하며 숫자, 라틴 문자, 하이픈 및 밑줄로 구성되어야 합니다.
획득 방법
PlayFab 카탈로그 가져오기
알림
PlayFab에 프로젝트 ID와 비밀 프로젝트 키가 필요합니다. 또한 엑솔라로 가져오려 카탈로그는 PlayFab에서 기본(Base)으로 설정해야 합니다.
아직 PlayFab 설정을 구성하지 않았다면 다음을 수행합니다.
관리자 페이지으로 이동한 후 PlayFab에서 인게임 스토어로 아이템 카탈로그를 가져옵니다.
알림
가상 아이템, 인게임 재화 혹은 인게임 재화 패키지를 가져올 수 있습니다.
- 관리자 페이지를 열고 스토어 > 카탈로그 관리 > 외부 플랫폼과 통합 > PlayFab으로 이동합니다.
- 아이템 가져오기 탭에서 다음을 지정하십시오:
- 타이틀 ID - PlayFab의 프로젝트 ID.
- 비밀 키 - PlayFab의 프로젝트 키.
- 저장을 클릭합니다.
- PlayFab과 사용자 인벤토리 동기화(선택 사항):
- 인벤토리 동기화로 이동하고 다음을 지정하십시오:
- 타이틀 ID - PlayFab의 프로젝트 ID.
- 비밀 키 - PlayFab의 프로젝트 키.
- PlayFab과 사용자 인벤토리 동기화 토글을 On으로 설정합니다.
- 저장을 클릭합니다.
- 인벤토리 동기화로 이동하고 다음을 지정하십시오:
- 아이템 가져오기 탭으로 이동하고 가져오기 시작을 클릭합니다. 카탈로그 가져오기가 자동으로 시작됩니다.
- 사이트 빌더에서 생성한 웹 스토어에서 가상 아이템을 판매하려면 관리자 페이지에서 아이템 그룹을 구성하고 각 아이템에 하나 이상 할당합니다..
- 아이템 이미지를 표시하려면 관리자 페이지에 이미지를 업로드합니다.
가져오기가 성공적으로 완료되었는지 확인하고, 사이드 메뉴의 스토어 섹션으로 이동하여 아이템, 통화 및 번들이 인게임 재화, 가상 아이템, 및 번들 탭에 활성화되어 있는지 확인합니다.
주의
가져오기 결과 확인 시, 가상 통화 패키지가 하나의 통화만 포함하는 번들인지 고려하세요. PlayFab은 실제 통화에 상당하는 가상 통화 RM(실제 금액) - 1 센트(100RM = 1USD)을 사용합니다. 예를 들어, PlayFab에서 400RM을 가져오면, 관리자 페이지에서 4달러가 표시됩니다.
카탈로그 다시 가져오기
카탈로그를 다시 가져올 경우 다음 사항을 고려해야 합니다.- 스토어에서 이미 있는 아이템이 업데이트됩니다.
- 스토어에서 사용할 수 없는 아이템이 추가됩니다.
- 가져오기 소스에서 이미 제거된 아이템이 스토어에 남아 있게 됩니다. 관리자 페이지에서 이를 삭제하거나 API를 통해 이를 삭제할 수 있습니다.
PlayFab 인벤토리에 아이템 추가
다음과 같은 방법으로 엑솔라 인게임 스토어에서 구매한 항목을 PlayFab 인벤토리에 추가하도록 설정할 수 있습니다.- 사용자 인벤토리를 PlayFab과 동기화.
- PlayFab 스토리지를 엑솔라 로그인과 통합. 이 경우 PlayFab ID는 토큰에 지정. 엑솔라 측에서 아이템을 반환하면 토큰에서 PlayFab으로 요청을 전송.
알림
Playfab을 사용하면 제품의 이름이나 설명을 설정할 수 없습니다. 이 경우 API 호출에서 빈 문자열을 반환합니다.
사용자 인벤토리를 PlayFab과 동기화하려면:
- 관리자 페이지를 열고 스토어 > 카탈로그 관리 > 외부 플랫폼과 통합 > PlayFab으로 이동하십시오.
- 인벤토리 동기화로 이동하고 다음을 지정하십시오:
- 타이틀 ID - PlayFab의 고유한 게임 ID.
- 비밀 키 - PlayFab의 프로젝트 키.
- PlayFab과 사용자 인벤토리 동기화 토글을 On으로 설정합니다.
- 저장을 클릭합니다.
이제 인게임 스토어에서 구매한 아이템 정보가 자동으로 PlayFab으로 전송됩니다.
이 기사가 도움이 되었나요?
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.