콘텐츠로 이동

Unity

Unity 환경에서는 Unity Inspector로 hive_config.xml 파일을 자동으로 생성하고 설정값을 할당할 수 있습니다. Unity Inspector를 사용하면 hive_config.xml 파일과 더불어 Android 앱 개발 시 AndroidManifest.xml을 직접 설정할 필요가 없어 편리하므로 Unity Inspector 사용을 권장합니다.

OS와 Authentication Version 설정

Hive > Edit Config를 선택하고 Inspector 화면에서 필요한 값들을 설정합니다. 먼저 OS와 Authentication Version을 선택합니다. 예를 들어, Google 인증을 사용하려면 OS는 플랫폼에 따라 Android 또는 iOS를 선택, Authentication Version은 Auth v4를 선택합니다.

  • OS: Android, Authentication Version: Auth V4
  • OS: iOS, Authentication Version: Auth V4

IdP 설정

Facebook, Google 등 사용하려는 IdP별로 AppID와 ClientID 등을 입력해야 합니다. 예를 들어, 일반 Google 인증을 사용하려면 Google Sign-in Settings 항목에 필요한 값을 아래 내용을 따라 입력합니다.

  • Google App Id 필드에 발급받은 AppID를 입력하세요.
  • Google Server Client ID 필드에 발급받은 웹 애플리케이션의 Client ID값을 입력하세요.
Info

자세한 내용은 인증 가이드를 참고하세요.

HiveConfig Settings

hive_config.xml 파일을 생성하고 파일에 설정값들을 부여합니다. hive_config.xml 파일은 아래 위치에 생성됩니다.

  • Android
    • Unity 2021 이상: <앱_프로젝트_경로>/Assets/HiveSDK/hive.androidlib/src/main/res/raw/hive_config.xml
    • Unity 2021 미만: <앱_프로젝트_경로>/Assets/Plugins/Android/res/raw/hive_config.xml
  • iOS
    • <앱_프로젝트_경로>/Assets/Plugins/iOS/hive_config.xml
  • Windows
    • <앱_프로젝트_경로>/Assets/Plugins/Windows/res/hive_config.xml

HiveConfig Settings에서는 다음 값들을 설정할 수 있습니다. 예를 들어, Google Play Store 결제를 사용하려면 Market 값을 GO로, Apple AppStore 결제를 사용하려면 AP로 설정합니다.

필드 설명 값 범위
Zone Hive 서버 환경
  • Sandbox (디폴트)
  • Live
Logging Hive 클라이언트의 내부 동작에 대한 로그 활성화 여부
  • On (디폴트)
  • Off
Push Hive 플랫폼이 제공하는 푸시 서비스를 이용할 것인지 여부
  • On (디폴트)
  • Off
Company 게임 퍼블리싱 업체
  • 컴투스:C2S
  • 컴투스홀딩스:GVI
Channel 게임 앱이 사용하는 로그인 서비스 플랫폼. Hive (디폴트)
Market 본 앱을 출시할 마켓
  • Android: GO (Google), LE (Lebi)
  • iOS: AP (App Store)
hivePermissionViewOn Hive SDK 권한 고지 팝업 노출 여부
  • On(기본 설정)
  • Off

기타 설정

WriteExternalStoragePermission: Unity Android에서 필요한 값으로, 외부 저장소 사용 권한을 유저에게 요청할 지 여부를 설정합니다. 체크하면 Hive 클라이언트가 단말기에서 초기화 될 때 유저에게 외부 저장소 권한을 요청합니다.

hive_config.xml 파일 생성

Inspector 설정 완료 후, 아래 방법을 따라 hive_config.xml 파일을 생성합니다.

  • Android: Regenerate Android Manifest & Hive Config 버튼을 클릭해 AndroidManifest.xml 파일과 hive_config.xml 파일을 생성하세요. hive_config.xml 파일은 다음의 디렉토리에 생성됩니다.
    • Unity 2021 이상: <프로젝트_루트>/Assets/HiveSDK/hive.androidlib/src/main/res/raw
    • Unity 2021 미만: <프로젝트_루트>/Assets/Plugins/Android/res/raw/
  • iOS: Regenerate iOS Plist Hive Config 버튼을 클릭해 Info.plist 파일과 hive_config.xml 파일을 생성하세요. hive_config.xml 파일은 다음의 디렉토리에 생성됩니다. <프로젝트_루트>/Assets/Plugins/iOS/
  • Windows: Windows Button 버튼을 클릭해 hive_config.xml 파일을 생성하세요. hive_config.xml 파일은 다음의 디렉토리에 생성됩니다.<프로젝트_루트>Assets/Plugins/Windows/res/