콘텐츠로 이동

Unity

Unity 환경에서 hive_config.xml을 설정하는 방법은 아래 2가지입니다.

  1. Unity Hive Config Editor로 hive_config.xml 내용을 자동으로 설정
  2. hive_config.xml을 수동으로 설정

1. Unity Hive Config Editor로 자동 설정

Unity 환경에서는 Unity Hive Config Editor로 hive_config.xml 파일을 자동으로 생성하고 내용 대부분을 설정할 수 있습니다. 단, Unity Hive Config Editor를 사용하더라도 hive_config.xml 파일 내 일부 값들은 수동으로 설정해야 합니다.

Note

Android 앱 개발 시에는 AndroidManifest.xml을 직접 설정할 필요가 없어 편리하므로 Unity Hive Config Editor 사용을 권장합니다.

Unity Hive Config Editor 실행

Hive > Hive Config (Edit Config)를 선택하고 Editor 화면에서 필요한 값들을 설정합니다.

실행 환경 선택

먼저 앱 실행 환경(Android, iOS, macOS, Windows)을 선택합니다.

Common (Hive SDK 기능 공통)

Common 탭에서 Hive SDK 모든 기능들에 공통으로 해당하는 설정을 진행합니다. Hive AppID를 설정하고, 서버(상용 또는 샌드박스)를 선택할 수 있습니다. 또 앱을 실행할 때 노출할 화면 방향을 정할 수 있습니다. Common 탭에 있는 설정은 모두 필수로 입력해야 합니다.

필드 설명 값 범위
Hive App Id Hive 콘솔 앱센터에 등록한 AppID (예시: com.sample.your)
Zone Hive 서버 - Sandbox (샌드박스)
- Real (상용)
Logging Hive SDK 내부 동작에 대한 로그 활성화 여부 - On
- Off
AgeGate COPPA ageGateU13 적용 여부 - Off
- On
Hive Orientation 앱에서 사용할 스크린 회전 방향 - All
- Portrate
- Landscape
- Undefined
Universal Link iOS 디퍼드 딥링크 설정

Auth (인증)

Auth 탭에서는 Hive SDK 인증 기능을 사용하기 위한 설정을 진행합니다. Hive SDK는 Facebook, Google, QQ 등 IdP 로그인을 지원합니다. 로그인에 사용할 IdP를 선택 후, 이 IdP 개발자 콘솔(예시: Google 콘솔)에 있는 AppId, ClientId 등을 가져와 입력해야 합니다.

예를 들어, Google SignIn을 사용하려면 Google SignIn 항목에 필요한 값을 Google 콘솔에서 가져와 아래와 같이 Auth 탭에 입력해야 합니다.

  • Google App Id: Google 콘솔에서 발급받은 AppID를 입력
  • Google Server Client ID: Google 콘솔에서 발급받은 웹 애플리케이션의 Client ID값을 입력

Note

각 인증 IdP 설정 값에 대한 자세한 내용은 인증 사전 준비 페이지를 참고하세요.

Market (빌링)

Market 탭에서는 Hive SDK 빌링 기능을 사용하기 위한 설정을 진행합니다. Hive SDK는 GooglePlay Store, Apple AppStore와 같은 앱 마켓을 지원하며, 이 탭에서는 인앱 상품 구매에 필요한 값을 설정해야 합니다.

예를 들어, 앱이 Android Lebi 마켓과 Wechat Pay 결제를 지원한다면, Wechat 콘솔에서 발급받은 Payment Key를 마켓 탭에 입력해야 합니다.

필드 설명 값 범위
Wechat Payment Key Android에서 Wechat을 Lebi 마켓 충전 수단으로 사용할 경우
Wechat의 Payment Key를 설정
(예시 : abcDEF1234xYz789)

Analytics (마케팅 어트리뷰션)

Analytics 탭에서는 Hive SDK 마케팅 어트리뷰션 기능을 사용하기 위한 설정을 진행합니다. Hive SDK는 Adjust, Firebase 등을 통한 마케팅 어트리뷰션을 지원하며, 해당 서비스 개발자 콘솔에서 key, event 값을 가져와 이 탭에 입력해야 합니다.

예를 들어, Adjust를 사용하려면 Analytics 탭에서 Adjust 항목에 필요한 값을 아래 내용을 따라 입력합니다.

  • appToken: Adjust 콘솔에서 발급받은 AppToken을 입력
  • Event: Adjust 콘솔에 등록한 이벤트 Name과 Value를 입력

Note

각 마케팅 어트리뷰션 설정에 관한 자세한 내용은 마케팅 어트리뷰션 사전 준비 페이지를 참고하세요.

Optional (네트워크 통신 옵션, 로그 및 기타 기능)

Optional 탭에서는 Hive SDK 사용 시 네트워크 통신 옵션, 로그, 기타 설정을 입력할 수 있습니다.

예를 들어, 어떤 Hive SDK 메서드를 호출할 때, 네트워크 타임아웃 시간을 연장하기 원한다면 httpConnectTimeouthttpReadTimeout 값을 증가시킵니다. 또 다른 예로, 원격 로그 전송 시 전송 주기와 전송 로그 데이터 크기를 변경하면, 애널리틱스 로그 설정 값들을 변경할 수 있습니다. Optional 탭 항목들은 반드시 필요한 경우가 아니라면 기본값 그대로 사용하는 것을 권장합니다.

필드 설명 값 범위
Unsupported UA Share Type Android UA Share 기능 사용 시 Hive 공유하기 UI에 사용할 소셜 미디어 종류 - SMS
- URL
- KAKAO
- LINE
- WHATSAPP
- FACEBOOK
- MESSENGER
- WECHAT
httpConnectTimeout Hive 프로토콜 통신 시 Connect 타임아웃 시간(초) 설정(기본값 사용 권장) - 8 (디폴트)
httpReadTimeout Hive 프로토콜 통신 시 Read 타임아웃 시간(초) 설정(기본값 사용 권장) - 8 (디폴트)
maxGameLogSize Hive SDK 애널리틱스 기능을 위한 설정 값
analyticsSendLimit Hive SDK 애널리틱스 기능을 위한 설정 값
analyticsQueueLimit Hive SDK 애널리틱스 기능을 위한 설정 값
analyticsSendCycle Hive SDK 애널리틱스 기능을 위한 설정 값
saveAnalytisLogBeforeCrash Hive SDK 애널리틱스 기능을 위한 설정 값

설정 저장 및 hive_config.xml 파일 생성

Unity Hive Config Editor에 있는 모든 탭 설정을 완료한 후 Save & Regenerate setting files를 누르면 hive_config.xml 파일을 자동으로 생성합니다.

Android

Save & Regenerate setting files를 누르면 AndroidManifest.xml 파일과 hive_config.xml 파일을 생성합니다. Unity 버전에 따라 hive_config.xml 파일이 생성되는 위치가 다릅니다.

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

iOS

Save & Regenerate setting files를 누르면 Info.plist 파일과 hive_config.xml 파일을 생성합니다. hive_config.xml 파일은 아래 위치에 생성됩니다.

  • <앱_프로젝트_경로>/Assets/Plugins/iOS/hive_config.xml

Windows

Windows 버튼을 누르면 hive_config.xml 파일을 생성합니다. hive_config.xml 파일은 아래 위치에 생성됩니다.

  • <앱_프로젝트_경로>/Assets/Plugins/Windows/res/hive_config.xml

hive_config.xml 수동 설정

Unity Hive Config Editor를 사용하더라도 hive_config.xml 파일 내에 있는 아래 일부 값들은 수동으로 설정해야 합니다.

필드 설명 값 범위
Company 앱 퍼블리싱 업체 예시: 컴투스인 경우 C2S
Channel 앱이 사용하는 로그인 서비스 플랫폼 Hive (기본값)
Market 앱을 출시할 앱 마켓 * Android: GO (Google), LE (Lebi)
* iOS: AP (App Store)

2. 수동 설정

만약 Unity Hive Config Editor를 사용하지 않으면, hive_config.xml 파일을 생성한 후, 파일에 있는 값 대부분을 수동으로 설정해야 합니다.

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

hive_config.xml 수정

다음을 참고해 hive_config.xml 파일을 직접 수정 후 저장합니다. 단, 파일 내 일부 값들은 개발사 필요에 따라 설정합니다.

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 설정을 확인하세요.