사기 방지 빠른 시작

아티클
07/12/2023

Important

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

이 빠른 시작을 통해 Microsoft Store(Windows 10/11, Xbox, Android)에서 영수증 유효성 검사를 실행할 수 있습니다.

필수 구성 요소

PlayFab Economy v2 빠른 시작은 영수증 유효성 검사를 설정하고 수행할 준비를 시킵니다.

Microsoft Store Marketplace 영수증 유효성 검사

Redeem API를 사용하려면 먼저 사용 중인 Marketplace(Apple Store, Steam, Google Play 등)에서 제품 ID 및 가격을 설정합니다. 초기에 모든 제품은 얼굴이 없습니다. 즉 플레이어가 구매할 수 있는 디지털 항목이나 PlayFab에서는 의미가 없습니다.

이러한 항목에 의미를 부여하려면 PlayFab 카탈로그에 미러링해야 합니다. 미러링하면 얼굴 없는 엔터티가 카탈로그 번들로 바뀝니다. 새 서비스에서 호출 RedeemMicrosoftStoreInventoryItems 하면 엔터티 플레이어의 가상 인벤토리에 부여할 번들이 카탈로그에서 검색됩니다.

각 번들은 AlternateId를 추가하여 하나 이상의 파트너 마켓플레이스 제품에 연결할 수 있습니다. AlternateId는 PlayFab과 외부 IAP 마켓 간의 링크입니다. 타이틀이 지정된 플레이어 엔터티에 대해 Redeem을 호출하면 이 ID를 IAP 마켓으로 전달하여 확인합니다. 일반적인 흐름은 다음과 같습니다.

Microsoft Store에 1개 이상의 실제 제품을 만듭니다.
PlayFab의 추가 기능을 IAP 마켓 통화 권한으로 채우고 만든 제품에 연결되는 해당 번들을 Playfab에 만듭니다.
RedeemMicrosoftStoreInventoryItems 호출

참고 항목

Playfab의 이전 인카네이션과 달리 새 시스템에서는 번들 제품을 하나만 만든 다음 AlternateId 목록에 참조해야 하는 각 마켓 SKU를 추가합니다. 각 IAP 마켓에 대해 새 항목을 만들 필요가 없습니다.

1단계 - 마켓플레이스 통합 설정

PlayFab가 타이틀을 대신하여 마켓을 호출할 수 있도록 추가 기능 섹션 아래 GameManager에서 각 IAP 마켓 통합을 설정해야 합니다.

2단계 - 영수증 유효성 검사를 위한 번들 만들기

GameManager 내에서 또는 CreateDraftItem을(를) 호출하여 번들을 만들 수 있습니다. 번들에는 최소한 제목, 설명 및 항목이 필요합니다. GameManager에서 Marketplace 매핑 섹션을 사용하여 Marketplace 항목을 연결할 수 있습니다.

API를 사용하여 번들을 빌드하는 경우 번들의 alternateIds 섹션 아래에 IAP Marketplace 매핑을 추가해야 합니다. Marketplace Enums는 고유하며 대/소문자를 구분합니다. 다음 추가 기능 중 하나를 사용해야 합니다.

Apple = "AppleAppStore"
Google Play = "GooglePlay"
Nintendo = "NintendoEShop"
Microsoft = "MicrosoftStore"
PlayStation = "PlayStationStore"
Steam = "Steam"

3단계 - 게임에서 Redeem 호출

게임은 엔터티 및 영수증 세부 정보를 사용하여 RedeemMicrosoftStoreInventoryItems API를 호출하여 실제 제품을 '사용'하고 해당 엔터티 인벤토리를 채웁다. 올바르게 작동하려면 호출에서 몇 가지 사항을 제공해야 합니다.

요청 헤더에 필요
- X-EntityToken - PlayFab 엔터티를 고유하게 식별하는 토큰
- 콘텐츠 형식 - 애플리케이션/Json
요청 본문에 필요
- CollectionsIdKey

각 IAP 마켓마다 이러한 호출에 대한 요구 사항이 약간 다릅니다. 예를 들어 Apple 및 GooglePlay 구매의 경우 마켓플레이스 영수증을 첨부해야 합니다.

게임 클라이언트가 시작되면 먼저 마켓플레이스로 PlayFab Redeem 호출을 시작합니다. Redeem 호출은 PlayFab가 오프라인 또는 게임의 의도 밖에 발생한 잠재적 구매와 동기화할 수 있습니다. 게임은 마켓플레이스 제품의 게임 내 구매가 발생할 때마다 이러한 호출을 사용해야 합니다.

Redeem은 Redeem 엔드포인트가 호출된 후 플레이어 엔터티의 인벤토리 통화가 채워지도록 합니다.

개별 플레이어 보기 내에 항목 또는 통화가 있는지 확인할 수 있습니다. GameManager에서 플레이어를 선택하고 개별 플레이어 엔터티로 이동합니다. 인벤토리 탭을 사용하여 Entity Player가 소유한 항목을 보고 업데이트할 수 있습니다.

여기에서 Microsoft 플랫폼에서 수익 창출하기에 대해 자세히 알아볼 수 있습니다.

다음을 통해 공유