Skip to main content

Economy v2, Unity, Android 시작하기

Economy v2는 이제 정식 출시(GA)되었습니다. 지원 및 피드백은 PlayFab 포럼을 참조하세요.
이 튜토리얼에서는 PlayFab, Unity + IAP 서비스, Android Billing API를 사용해 인앱 구매(IAP)를 설정하는 방법을 보여줍니다.

시작하기 전

Android Billing API와 PlayFab은 함께 작동하여 클라이언트에 IAP 경험을 제공합니다. PlayMarket에서 제품 ID가격을 설정하는 것으로 시작합니다. 처음에는 모든 제품이 이름 없는 것입니다. 즉, 플레이어가 구매할 수 있는 디지털 엔터티이지만 PlayFab 플레이어에게는 아무런 의미가 없습니다. 이러한 엔터티를 유용하게 만들려면 PlayFab 아이템 카탈로그에 미러링해야 합니다. PlayFab은 이름 없는 엔터티를 번들, 컨테이너, 개별 아이템으로 변환합니다. 각각은 다음과 같은 고유한 얼굴을 가집니다.
  • 제목
  • 설명
  • 태그
  • 유형
  • 이미지
  • 동작
모든 아이템은 ID를 공유하여 마켓 제품에 연결됩니다. 구매 가능한 실제 돈 아이템에 액세스하는 가장 좋은 방법은 GetItems를 사용하는 것입니다. 아이템의 ID는 PlayFab과 외부 IAP 시스템 간의 연결입니다. 따라서 IAP 서비스에 아이템 ID를 전달합니다. 이 시점에서 구매 프로세스가 시작됩니다. 플레이어는 IAP 인터페이스와 상호 작용하며, 구매가 성공하면 영수증을 받습니다. PlayFab은 영수증을 검증하고 구매를 등록하여 PlayFab 플레이어에게 방금 구매한 아이템을 부여합니다.

클라이언트 애플리케이션 설정

이 섹션에서는 PlayFab, UnityIAP, Android Billing API를 사용해 IAP를 테스트하기 위한 애플리케이션을 구성하는 방법을 보여줍니다. 필수 구성 요소:
  • Unity 프로젝트.
  • 타이틀에서 작동하도록 가져오고 구성된 PlayFab Unity SDK.
  • Unity 프로젝트에서 작동하도록 설치되고 구성된 Visual Studio와 같은 편집기.
첫 번째 단계는 UnityIAP를 설정하는 것입니다.
  1. Services로 이동합니다.
  2. Services 탭이 선택되어 있는지 확인합니다.
  3. Unity Services 프로필 또는 조직을 선택합니다.
  4. Create 버튼을 선택합니다.
  1. 다음으로 In-App Purchasing (IAP) 서비스로 이동합니다.
  1. Simplify cross-platform IAP 토글을 설정하여 서비스를 활성화해야 합니다.
  2. 그런 다음 Continue 버튼을 선택합니다.
플러그인 목록이 있는 페이지가 나타납니다.
  1. Import 버튼을 선택합니다.
Unity 설치를 계속 진행하고 모든 플러그인을 가져올 때까지 가져오기 절차를 진행합니다.
  1. 플러그인이 제자리에 있는지 확인합니다.
  2. 그런 다음 AndroidIAPExample.cs라는 새 스크립트를 만듭니다.
AndroidIAPExample.cs에는 다음 코드가 포함됩니다(자세한 내용은 코드 주석을 참조).
  1. Code라는 새 GameObject를 만듭니다.
  2. AndroidIAPExample 컴포넌트를 여기에 추가합니다(끌어다 놓기).
  3. 씬을 반드시 저장합니다.
마지막으로 Build Settings로 이동합니다.
  1. 씬이 Scenes In Build 영역에 추가되었는지 확인합니다.
  2. Android 플랫폼이 선택되었는지 확인합니다.
  3. Player Settings 영역으로 이동합니다.
  4. Package Name을 지정합니다.
PlayMarket 충돌을 피하기 위해 반드시 자체 패키지 이름을 만들어야 합니다.
마지막으로 애플리케이션을 평소대로 빌드하고 APK가 있는지 확인합니다. 테스트하려면 PlayMarket과 PlayFab을 구성해야 합니다.

IAP용 PlayMarket 애플리케이션 설정

이 섹션에서는 PlayMarket 애플리케이션에 대해 IAP를 활성화하는 방법의 세부 사항을 설명합니다.
애플리케이션 자체를 설정하는 것은 이 튜토리얼의 범위를 벗어납니다. 이미 애플리케이션이 있고 최소한 Alpha 릴리스를 게시하도록 구성되어 있다고 가정합니다.
유용한 참고 사항:
  • 해당 지점에 도달하려면 APK가 업로드되어 있어야 합니다. 이전 섹션에서 만든 APK를 사용하세요.
  • IAP 샌드박스를 활성화하려면 APK를 Alpha 또는 Beta 애플리케이션으로 업로드하세요.
  • Content Rating을 구성하는 것은 애플리케이션에서 IAP가 어떻게 활성화되는지에 대한 질문을 포함합니다.
  • PlayMarket은 게시자가 IAP를 사용하거나 테스트하는 것을 허용하지 않습니다. 테스트 목적으로 다른 Google 계정을 선택하고 Alpha/Beta 빌드의 테스터로 추가하세요.
  1. 애플리케이션 빌드를 게시합니다.
  2. 메뉴에서 In-app products를 선택합니다.
    • Merchant Account를 요청받으면 연결하거나 만듭니다.
  3. Add New Product 버튼을 선택합니다. PlayMarket 새 제품 추가
  4. 새 제품 화면에서 Managed Product를 선택합니다.
  5. 100diamonds와 같은 설명적인 _Product ID_를 지정합니다.
  6. Continue를 선택합니다. PlayMarket 제품 ID 추가
  7. PlayMarket은 예를 들어 100 DiamondsA pack of 100 diamonds to spend in-game과 같은 **Title (1)**과 **Description (2)**을 입력하도록 요구합니다. Data Item 데이터는 오로지 PlayFab 서비스에서만 제공되며, ID만 일치하면 됩니다. PlayMarket 제품 제목 설명 추가
  8. 아래로 스크롤하고 Add a price 버튼을 선택합니다. PlayMarket 제품 가격 추가
  9. “$0.99”와 같은 유효한 가격을 입력합니다(가격이 각 국가/지역별로 독립적으로 변환되는 방식에 유의).
  10. Apply 버튼을 선택합니다. PlayMarket 제품 로컬 가격 적용
  11. 마지막으로 화면 상단으로 다시 스크롤하고 아이템 상태를 Active로 변경합니다. PlayMarket 제품 활성화
  12. PlayFab을 PlayMarket과 연결하기 위해 Licensing Key를 저장합니다.
  13. 메뉴에서 Services & APIs로 이동합니다.
  14. 그런 다음 KeyBase64 버전을 찾아 저장합니다.
다음 단계는 IAP 테스트를 활성화하는 것입니다. 샌드박스는 Alpha 및 Beta 빌드에 대해 자동으로 활성화되지만, 앱을 테스트할 권한이 있는 계정을 설정해야 합니다.
  1. Home으로 이동합니다.
  2. 왼쪽 메뉴에서 Account details를 찾아 선택합니다.
  3. License Testing 영역을 찾습니다.
  4. Test Accounts가 목록에 있는지 확인합니다.
  5. License Test ResponseRESPOND_NORMALLY로 설정되어 있는지 확인합니다.
설정을 적용하는 것을 잊지 마세요! 이 시점에서 통합의 Play Market 측 설정이 완료되어야 합니다.

PlayFab 타이틀 설정

마지막 단계는 제품을 반영하고 Google Billing API와 통합하도록 PlayFab 타이틀을 구성하는 것입니다.
  1. Add-ons를 선택합니다.
  2. 그런 다음 Google 애드온을 선택합니다.
  1. Package ID를 입력합니다.
  2. 이전 섹션에서 얻은 Google App License Key를 입력합니다.
  3. Install Google 버튼을 선택하여 변경 사항을 커밋합니다.
다음 단계는 PlayFab에서 100 Diamonds 번들을 반영하는 것입니다.

Game Manager

  1. 새 Economy Catalog (V2) Currency를 만듭니다.
  2. Title을 편집하고 Description을 추가합니다. 예를 들어, Diamonds, Our in-game currency of choice.
  3. 화폐를 더 쉽게 찾기 위해 Friendly ID diamonds를 추가합니다.
  4. Save and publish를 선택하여 변경 사항을 완료합니다.
  5. Currency 목록에서 화폐를 확인합니다.
  6. 다음으로, 새 Economy Catalog (V2) Bundle을 만듭니다.
  7. Title을 편집하고 Description을 추가합니다. 예를 들어, 100 Diamonds Bundle, A pack of 100 diamonds to spend in-game.
이 데이터는 Play Market Item TitleDescription과 _아무런 관련이 없다_는 점을 명심하세요. 독립적입니다.
  1. Content type을 사용해 번들을 정리할 수 있습니다. 예를 들어, appstorebundles. Content type은 ⚙️ > Title Settings > Economy (V2)에서 관리됩니다.
  2. 표시 속성에 지역화된 가격을 추가하여 실제 가격을 추적합니다.
  3. 번들에 새 아이템을 추가합니다. 필터에서 Currencies를 선택하고 이전 세트에서 만든 화폐를 선택합니다. 이 번들에서 판매하고자 하는 화폐 양과 일치하도록 수량을 설정합니다.
  4. “GooglePlay” 마켓플레이스에 대한 새 플랫폼을 추가합니다. GooglePlay 마켓플레이스가 아직 없다면 Economy Settings 페이지에서 만들 수 있습니다. Marketplace ID를 이전 섹션에서 만든 Google Play Console Product ID와 일치하도록 설정합니다.
  5. Save and publish를 선택하여 변경 사항을 완료합니다.
  6. Bundles 목록에서 번들을 확인합니다.

REST API


다음으로, 게임 내 NPC 상인을 나타내는 PlayFab 스토어를 통해 플레이어가 화폐를 소비할 수 있는 게임 내 구매를 설정할 수 있습니다.

Game Manager

  1. 새 Economy Catalog (V2) Item을 만듭니다.
  2. Title을 편집하고 Description을 추가합니다. 예를 들어, “Golden Sword”, “A sword made of gold.”
  3. 스토어에서 플레이어가 아이템을 찾도록 돕기 위해 지역화된 키워드를 추가할 수 있습니다. 나중에 API를 통한 검색을 위해 아이템을 정리하기 위해 Tag와 Content type을 추가합니다. Display Properties를 사용해 방어구 값, 아트 리소스의 상대 경로 또는 게임에서 저장해야 하는 기타 데이터를 저장합니다.
  4. 새 가격을 추가하고 이전 단계에서 만든 화폐를 선택합니다. Amount를 기본적으로 설정하고 싶은 가격으로 설정합니다. 나중에 만드는 모든 스토어에서 가격을 재정의할 수 있습니다.
  5. Save and publish를 선택하여 변경 사항을 완료합니다.
  6. Items 목록에서 아이템을 확인합니다.
  7. 마지막으로, 새 Economy Catalog (V2) Store를 만듭니다.
  8. Title을 편집하고 Description을 추가합니다. 예를 들어, Villager Store, A humble store run by a humble villager.
  9. 검색이 쉽도록 Friendly ID를 지정합니다. 예를 들어, villagerstore.
  10. 이전 단계에서 만든 아이템을 스토어에 추가합니다. 여러 아이템을 스토어에 추가할 수 있으며 필요한 경우 기본 가격을 재정의할 수 있습니다.
  11. Save and publish를 선택하여 변경 사항을 완료합니다.
  12. Stores 목록에서 스토어를 확인합니다.

REST API


PlayFab 타이틀의 설정이 완료되었습니다.

테스트

테스트 목적으로 Alpha/Beta 릴리스를 사용해 앱을 다운로드합니다.
  • 테스트 계정과 실제 Android 기기를 사용해야 합니다.
  • 앱을 시작하면 IAP가 초기화되고 아이템을 나타내는 _버튼 하나_가 표시됩니다.
  • 해당 버튼을 선택합니다.
IAP 구매가 시작됩니다. 구매가 성공할 때까지 Google Play 지시를 따르세요. 마지막으로 PlayFab Game Manager 대시보드에서 타이틀로 이동하여 New Events를 찾습니다. 구매가 제공되고 검증되어 PlayFab 생태계로 전달되었는지 확인합니다. UnityIAP와 Android Billing API를 PlayFab 애플리케이션에 성공적으로 통합했습니다!

다음 단계

  1. 데모 IMGUI 표시를 대체할 구매용 Unity UI Toolkit 인터페이스를 구축합니다.
  2. PlayFab 오류를 처리하고 사용자에게 표시하기 위한 사용자 지정 Unity Logger를 만듭니다.
  3. Unity UI에 표시할 아이콘 이미지를 PlayFab Items Images 필드에 추가합니다.
마지막 수정일 2026년 8월 13일