한국어

Unity에서 ALC SDK V2 사용하기

개요

원스토어 앱 라이선스 검증 플러그인은 Unity 환경에서 에셋을 확장하여 유료 앱 구매 체크를 간편하게 적용할 수 있도록 지원되는 플러그인입니다.

아래 가이드에서는 프로젝트에 플러그인 설정 및 사용하는 방법과 원스토어 앱 라이선스 검증 라이브러리 기능을 구현하는 방법을 설명합니다.

원스토어 앱 라이선스 검증 플러그인 설정

플러그인 다운로드 및 가져오기

  1. 원스토어 SDK 샘플 GitHub의 Release 페이지에서 Unity 용 원스토어 인앱결제 플러그인 최신 버전을 다운로드합니다.

  2. Unity 메뉴 바에서 Assets > Import Package > Custom Package 를 클릭합니다.

  3. 원스토어 SDK 플러그인을 다운로드한 파일 위치를 찾아 .unitypackage 파일을 선택합니다.

  4. Import Package 대화상자에서 모든 에셋을 선택한 상태로 두고 Import를 클릭합니다.

패키지를 가져오면 폴더가 추가됩니다. 해당 폴더에는 앱 라이선스 검증 라이브러리가 포함되어 있습니다.

  • Assets > OneStoreCorpPlugins 폴더

빌드 설정하기

아래의 두 가지의 경우 원스토어 공지사항을 참조하여 설정 바랍니다.

Unity에서 Player 설정을 통해 아래 항목을 추가합니다.

  • Custom Main Manifest

  • Custom Main Gradle Template

  • Custom Launcher Gradle Template

Assets > Plugins > Android 폴더에 파일이 생성됩니다.

게임에서 원스토어 ALC(Application License Checker) 라이브러리 적용하기

원스토어 라이선스 키 복사하기

원스토어 앱 상품 현황에서 라이선스 관리 메뉴에 진입합니다. ALC를 사용하기 위해서는 라이선스 키가 필요합니다.

원스토어 개발자 센터에서 제공하는 앱의 라이선스키를 복사하여 ALC 객체를 생성합니다.

Initialize() 함수를 호출하여 기본적인 셋팅을 하고 ILicenseCheckCallback 인터페이스를 통해 검증 결과 이벤트를 전달받습니다.

아래 작업은 원스토어 서비스 연결과 앱 라이선스 검증 요청을 위한 선행 작업입니다.


  using OneStore.Alc;

  class YourCallback: ILicenseCheckCallback
  {
      // ILicenseCheckCallback implementations.
      public void OnGranted(string license, string signature) { }
      public void OnDenied() {}
      public void OnError(int code, string message)
  }
  
  OneStoreAppLicenseCheckerImpl _appLicenseCheckerImpl = new OneStoreAppLicenseCheckerImpl("your license key");   
  _appLicenseCheckerImpl.Initialize(new YourCallback());

라이센스 검증 요청하기

라이센스 체크 호출 시 원스토어 서버와의 통신을 통해 라이센스를 전달받게 됩니다. 네트워크 장애 상황이나 비행기 모드 등으로 인해 사용자가 정상적으로 원스토어 서버에 접근하지 못하는 경우에는 일반적으로 캐시 정책을 사용하여 캐시 된 라이센스의 유효 기간 동안 앱의 실행을 보장합니다. 만약 캐시 정책을 사용하지 않고 싶은 경우 strictQueryLicense API를 통해 캐시 된 라이센스를 이용하지 않고 사용 가능합니다.

QueryLicense API (Cached API) 호출

캐시 정책을 동반하여 동작합니다. 일반적으로 원스토어 서버를 통해 사용자의 구매 이력 라이센스를 전달받지만, 네트워크 장애나 비행기 모드 등 원스토어 서버에 접근이 불가할 때, 로컬에 캐시 된 라이센스를 이용하여 유효기간까지 실행을 보장해 주는 방식입니다.


  using OneStore.Alc;

  class YourCallback: ILicenseCheckCallback
  {
      // ILicenseCheckCallback implementations.
      public void OnGranted(string license, string signature) { }
      public void OnDenied() {}
      public void OnError(int code, string message)
  }

  _appLicenseCheckerImpl.QueryLicense();

StrictQueryLicense API (Non-Cached API) 호출

캐시 된 라이센스를 사용하지 않습니다. 네트워크 장애 상황이나 비행기 모드 등에서 해당 API를 사용하였을 경우, 원스토어 서버에 접근이 불가능한 상태이기 때문에 사용자가 앱을 이용할 수 없습니다.


  using OneStore.Alc;

  class YourCallback: ILicenseCheckCallback
  {
      // ILicenseCheckCallback implementations.
      public void OnGranted(string license, string signature) { }
      public void OnDenied() {}
      public void OnError(int code, string message)
  }

  _appLicenseCheckerImpl.StrictQueryLicense();

연결 해제

AppLicenseChecker의 destroy 함수를 호출하여 원스토어 서비스와의 연결을 해제합니다. 


  using OneStore.Alc;

  _appLicenseCheckerImpl.Destroy();

Last updated