콘텐츠로 이동

Unity

아래 안내를 따라 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

Unity Inspector로 설정

Unity 환경에서는 Unity Inspector로 hive_config.xml 파일을 자동으로 생성하고 설정값을 할당할 수 있습니다.

OS와 Authentication Version 설정

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

Google Sign-in Settings

일반 Google 인증을 사용하기 위해 Google Sign-in Settings 항목에 필요한 값을 아래 내용을 따라 입력합니다.

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

HiveConfig Settings

hive_config.xml 파일에서 설정하는 값 중 다음 값을 설정할 수 있습니다. 예를 들어, Unity Android 환경에서 Google Play Store 결제를 사용하려면 Market 값을 GO로, Unity iOS 환경에서 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

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/

hive_config.xml 예시

아래는 인증(Google 인증), 결제(Google Play Store 또는 Apple AppStore)를 사용할 때 hive_config.xml 파일 예시입니다. 사용하려는 Hive SDK 기능과 앱 환경에 맞게 값을 변경, 추가, 삭제 후 사용하세요. iOS는 Apple AppStore 결제만 지원하므로, Unity iOS 환경에서는 마켓을 AP로 설정합니다.

<properties>

    <!-- Hive SDK 공통 설정: START -->
    <appId>com.sample.your</appId>

    <gameLanguage>en</gameLanguage>

    <!-- Hive 플랫폼의 서버 선택. sandbox는 개발용, real은 상용
        (sandbox, real) -->
    <zone>real</zone>

    <!-- SDK 내부 동작 로그 사용 여부 설정
        (true, false) -->
    <useLog>false</useLog>

    <!-- 회사 설정
        (C2S: 컴투스, GVI: 컴투스홀딩스) -->
    <company>C2S</company>

    <!-- 채널 설정
        (C2S: Hive 플랫폼) -->
    <channel>C2S</channel>

    <!-- 결제 마켓 설정
        (GO: Google Play, LE: Com2us Lebi, AP: Apple App Store) -->
    <market>GO</market>

    <!-- Hive SDK 내부에서 사용되는 HTTP Connect Timeout 시간을 초단위로 설정
        (특별한 경우가 아니면 변경 금지) -->
    <httpConnectTimeout>8</httpConnectTimeout>

    <!-- Hive SDK 내부에서 사용되는 HTTP Read Timeout 시간을 초단위로 설정
        (특별한 경우가 아니면 변경 금지) -->
    <httpReadTimeout>8</httpReadTimeout>

    <agreementDetermineBase>device</agreementDetermineBase>
    <!-- Hive SDK 공통 설정: END -->

    <!-- Hive SDK 기능별 설정: START -->
    <!-- 인증 제품 설정: Google 인증 사용 -->
    <providers>             
        <google playAppId="123456789012"  clientId="123456789012-abc.apps.googleusercontent.com"  serverClientId="123456789012-abc.apps.googleusercontent.com"  reversedClientId="com.googleusercontent.apps.123456789012-abc"  deviceFlowClientId="331526026701-gn1abq1ev23nqj7rdvvlaamf7ii4f3u9.apps.googleusercontent.com" />
    </providers>
    <!-- Hive SDK 기능별 설정: END -->

</properties>
Info

Hive SDK 설정은 앱 빌드 전에 설정 파일에 값을 저장하거나, 런타임(앱 실행) 중에 설정값을 변경할 수 있습니다. 자세한 내용은 Hive SDK 설정을 확인하세요.