Unity IAP 사용 가이드

Unity 인앱 구매(IAP) 패키지는 여러 플랫폼에서 게임 내 구매를 쉽게 관리할 수 있도록 도와줍니다. 이 문서에서는 Unity IAP의 주요 기능 및 설치 방법, 그리고 업그레이드 참고 사항에 대해 설명합니다.

주요 기능

• 통합 API: 모든 스토어에서 인게임 경제를 이해하고 최적화할 수 있도록 공통 API에 무료로 접근할 수 있습니다.
• 분석 도구: Unity 애널리틱스와 자동 연동으로 매출 및 구매 데이터 트렌드를 모니터링하고 의사 결정을 지원합니다.
• 여러 플랫폼 지원: iOS, Mac, tvOS, Google Play, Windows, Amazon 앱 스토어를 지원합니다.
• 유니티 퍼블리싱 포털: 다른 앱 스토어에 대한 카탈로그와 거래를 동기화할 수 있습니다.
• 클라이언트 측 영수증 확인: 패키지를 설치한 후 서비스 창을 열어 인앱 구매 기능을 활성화합니다.

설치 및 설정 가이드

업그레이드 참고 사항

Unity IAP(v2.x에서 v3.x)로 업데이트할 때, 컴파일 오류를 방지하기 위한 몇 가지 작업이 필요합니다.

1. 파일 이동:
   • IAPProductCatalog.json 및 BillingMode.json 파일을 기존 위치에서 새로운 위치로 이동합니다.
     • 기존 위치: Assets/Plugins/UnityPurchasing/Resources/
     • 새로운 위치: Assets/Resources/
2. Tangle 파일 이동:
   • AppleTangle.cs 및 GooglePlayTangle.cs 파일을 기존 위치에서 새로운 위치로 이동합니다.
     • 기존 위치: Assets/Plugins/UnityPurchasing/generated
     • 새로운 위치: Assets/Scripts/UnityPurchasing/generated
3. 불필요한 파일 제거:
   • 프로젝트의 Assets/Plugins/UnityPurchasing 폴더에 남아 있는 모든 에셋 스토어 플러그인 폴더와 파일을 제거합니다.

기본 사용 예제

다음은 Unity IAP를 활용한 간단한 인앱 구매 스크립트의 예시입니다.

using UnityEngine;
using UnityEngine.Purchasing;

public class IAPManager : MonoBehaviour, IStoreListener
{
    private static IStoreController storeController;
    private static IExtensionProvider storeExtensionProvider;

    public void InitializePurchasing()
    {
        if (IsInitialized()) return;

        var builder = ConfigurationBuilder.Instance(StandardPurchasingModule.Instance());
        builder.AddProduct("your_product_id", ProductType.Consumable); // 제품 추가
        UnityPurchasing.Initialize(this, builder);
    }

    private bool IsInitialized()
    {
        return storeController != null && storeExtensionProvider != null;
    }

    public void OnInitialized(IStoreController controller, IExtensionProvider extensions)
    {
        storeController = controller;
        storeExtensionProvider = extensions;
    }

    public void OnInitializeFailed(InitializationFailureReason error)
    {
        Debug.Log("구매 초기화 실패: " + error);
    }
}

이 스크립트 예시는 기본적인 인앱 구매 초기화 및 제품 추가 방법을 보여줍니다.

문서 위치 및 버전 정보

• 문서 위치: Unity IAP 관련 문서는 Unity 공식 가이드 내에 위치합니다.
• 사용 가능 버전: com.unity.purchasing@4.9

추가 참고 자료

• Unity 공식 문서
• Unity 포럼
• Unity 애셋 스토어

Unity IAP를 활용하여 게임 내 구매 시스템을 효율적으로 관리하시기 바랍니다!