엔진 공통
개발 엔진(Unity, Unreal, ...)과 플랫폼(Android, iOS, ...)에 상관 없이, 앱을 빌드하기 전 시점에 Hive SDK 설정은 공통적으로 hive_config.xml 파일에 정의합니다. 따라서, Hive SDK를 사용하려면 hive_config.xml 파일을 새로 만들고 내용을 입력한 후 여러분의 앱 프로젝트에 반드시 포함해야 합니다. 이 파일에 있는 설정은 Hive SDK를 초기화하는 시점에 적용됩니다. 런타임에 변경하지 않는 정적 항목은 모두 이 파일에서 미리 정의하는 것을 권장합니다. 파일은 아래 위치에 있어야 합니다.
- Unity
- 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
- Android
- Unreal Engine
- Android
- <앱_프로젝트_경로>/HIVESDK/Source/HIVESDK/ThirdParty/android/resource/res/raw/hive_config.xml
- iOS
- <앱_프로젝트_경로>/HIVESDK/Source/HIVESDK/ThirdParty/iOS/resource/hive_config.xml
- Windows
- <앱_프로젝트_경로>/HIVESDK/Source/HIVESDK/ThirdParty/Windows/config/hive_config.xml
- Android
- Android Native
- <앱_프로젝트_경로>/app/res/raw/hive_config.xml
- iOS Native
- 원하는 위치에 hive_config.xml 파일을 만들고 직접 Xcode 프로젝트에 연결
Hive SDK 공통 설정¶
어떤 Hive SDK 기능을 사용하던지 기본적으로 hive_config.xml에 입력해야 하는 항목입니다. 필수 항목은 반드시 입력해야 하며, 선택 항목은 필요에 따라 입력합니다. 선택 항목을 입력하지 않으면 Hive SDK 기본값으로 동작합니다.
항목 | OS | 설명 | 필수 여부 | SDK 기본값 |
---|---|---|---|---|
appId | Android, iOS, Windows | 게임 빌드 식별자입니다. | X |
|
zone | Android, iOS, Windows | Hive 클라이언트가 접속할 서버입니다.
| X | `real` |
useLog | Android, iOS, Windows | Hive 클라이언트의 내부 동작에 대한 로그 활성화 여부입니다. 로그를 활성화하면 개발 도구 화면에 로그를 출력합니다.
| X | `false` |
ageGateU13 | Android, iOS, Windows | COPPA ageGateU13 적용 여부입니다. Hive SDK에 COPPA ageGateU13을 적용하려면, Hive 콘솔에 COPPA 약관을 등록한 후 Hive SDK를 초기화하기 전에 이 값을 true 로 설정해야 합니다. COPPA ageGateU13을 적용하지 않으려면, Hive 콘솔에 COPPA 약관이 아닌 다른 약관을 등록한 상태에서 Hive SDK를 초기화하기 전에 이 값을 false 로 설정해야 합니다.
| X | `false` |
hiveOrientation | Android, iOS, Windows | 설정에 따라 기기 방향에 맞추어 Hive SDK의 UI가 노출됩니다.
| X | 'undefined' |
channel | Android, iOS, Windows | 게임 앱에서 사용하는 로그인 및 인앱 지원 서비스 플랫폼입니다. Hive SDK를 통해 외부 소셜에 로그인하거나 인앱 구매를 사용하는 경우 C2S에 해당합니다. Hive SDK 애널리틱스 데이터 수집 용도로 사용됩니다.
| O | `C2S` |
market | Android, iOS, Windows | 인앱 구매를 결제할 마켓입니다. Hive SDK 애널리틱스 수집 용도로 사용됩니다.
| O | 공백값 |
agreementDetermineBase | Android, iOS | 약관 동의를 받는 기준을 결정합니다. `device` 또는 `account`를 선택할 수 있으며 기본값은 `device`입니다.
| X | `device` |
authV1Agreement | Android, iOS | Hive SDK v1 또는 Hive SDK C2S 개별모듈 전용 설정으로, 노출할 약관의 UI를 인증 v1 또는 v4로 선택합니다. Hive SDK v4 적용 게임 앱은 설정하지 않으며 기본값에 영향을 받지 않습니다.
| X | `true` |
unsupportedUAShareType | Android | Android 전용 설정으로, 프로모션 유저 애퀴지션(UA) 공유하기 기능 사용 시 아이콘으로 노출하지 않을 공유앱을 설정합니다. 설정한 대상들은 UI에서 아이콘이 노출되지 않습니다.
| X | 공백값 |
httpConnectTimeout | Android, iOS, Windows | Hive 클라이언트 내부에서 사용하는 HTTP Connect의 타임아웃 시간(초)입니다.
| X | `8`(단위: 초) |
httpReadTimeout | Android, iOS, Windows | Hive 클라이언트 내부에서 사용하는 HTTP Read 타임아웃 시간(초)입니다.
| X | `8`(단위: 초) |
usePrivateBrowsingForAuth | Windows | 구글 로그인 인증 시 시크릿 모드 사용 여부를 결정합니다.
| X | true |
Note
COPPA ageGateU13 적용 시, 기기(device
) 기반 약관 동의 팝업만 노출할 수 있습니다.
COPPA ageGateU13 적용 시, 약관 동의 과정에서 어떤 유저가 13세 이상이라고 응답하면 Hive SDK는 해당 유저에게 COPPA ageGateU13을 적용하지 않습니다. 단, hive_config.xml에 설정한 값(true
) 자체는 변하지 않습니다.
Hive SDK 기능별 설정¶
인증, 빌링, 마케팅 어트리뷰션 등 사용하려는 Hive SDK 기능별 설정입니다. hive_config.xml 사용할 Hive SDK 기능에 해당하는 항목만 입력합니다. 자세한 내용은 아래와 같이 각 Hive SDK 기능 개발자 가이드 사전 준비 페이지를 참고하세요.
지원하지 않는 설정¶
hive_config.xml 파일 항목들 중 더는 지원하지 않는 항목들은 다음과 같습니다.
항목 | 설명 | 비고 |
---|---|---|
usePush | 노티피케이션 사용 여부를 설정합니다. | v4.16.2 부터 derpecated |
permissions | Android Android 전용 설정으로, HiveSDK에서 제어하는 Android 권한 사용 여부를 설정합니다. permissions 이하 설정으로 sdwrite 설정을 통해 외부 저장소 접근 권한을 제어할 수 있습니다. | v4.16.2 부터 derpecated |
useCrashReport | iOS iOS 전용 기능으로 앱이 에러로 인하여 강제 종료(크래시) 발생하기 직전의 상황을 감지하여 서버 미전송 대기중인 애널리틱스 로그를 파일로 저장합니다. 비슷한 기능을 하는 외부 서드 파티 크래시 리포터를 이용할 경우 충돌 방지를 위해 false로 설정하여 비활성화 해야 합니다.(+v4.16.0) | v4.16.3 부터 derpecated |
exitEventEnabled | Android iOS exitEvent란 Hive SDK가 아니라 게임에서 앱을 직접 종료해야 하는 상황임을 알리는 이벤트입니다. 이 값이 True이면 이 이벤트룰 수신하며 이 때 Hive SDK는 게임 앱을 직접 종료하지 않습니다. 이 값이 False이면 Hive SDK가 게임 앱을 직접 종료할 수 있습니다.(+v4.9.0). | v4.16.4부터 deprecated |
company | Android iOS Windows 게임 퍼블리싱 업체 이름을 설정합니다. | v4.23.0 부터 derpecated |
gameLanguage | Android iOS Hive SDK에 설정하는 게임 언어입니다. | v4 25.2.0 부터 derpecated |
hive_config.xml 예시¶
아래는 인증(Google 인증), 결제(Google Play Store)를 사용할 때 hive_config.xml 파일 예시입니다. 사용하려는 Hive SDK 기능과 앱 환경에 맞게 값을 변경, 추가, 삭제 후 사용하세요. iOS 플랫폼은 Apple AppStore 결제만 지원하므로, Unity iOS 환경에서는 마켓을 AP
로 설정합니다.
<properties>
<!-- Hive SDK 공통 설정: START -->
<!-- 게임 빌드 고유 식별자 설정 -->
<appId>com.sample.your</appId>
<!-- Hive 플랫폼의 서버 선택. sandbox는 개발용, real은 상용
(sandbox, real) -->
<zone>real</zone>
<!-- SDK 내부 동작 로그 사용 여부 설정
(true, false) -->
<useLog>false</useLog>
<!-- ageGateU13 적용 여부 설정
(true, false) -->
<ageGateU13>false</ageGateU13>
<!-- Hive Orientation 설정 -->
<hiveOrientation>landscape</hiveOrientation>
<!-- 채널 설정(로그인 및 인앱 지원 서비스 플랫폼)
(C2S: Hive 플랫폼) -->
<channel>C2S</channel>
<!-- 결제 마켓 설정 (GO: Google Play, LE: Com2us Lebi, AP: Apple App Store) -->
<market>GO</market>
<!-- 약관 동의 수신 기준 설정
(device, account) -->
<agreementDetermineBase>false</agreementDetermineBase>
<!-- 약관 노출 디자인 설정 (SDK v4는 설정하지 않음)
(true, false) -->
<!-- <authV1Agreement>device</authV1Agreement> -->
<!-- 프로모션 UA 공유하기 시 미노출할 공유앱 설정 (Android Only) -->
<unsupportedUAShareType>
<value>SMS</value>
<value>URL</value>
</unsupportedUAShareType>
<!-- Hive SDK 내부에서 사용되는 HTTP Connect Timeout 시간을 초단위로 설정
(특별한 경우가 아니면 변경 금지) -->
<httpConnectTimeout>8</httpConnectTimeout>
<!-- Hive SDK 내부에서 사용되는 HTTP Read Timeout 시간을 초단위로 설정
(특별한 경우가 아니면 변경 금지) -->
<httpReadTimeout>8</httpReadTimeout>
<!-- Hive SDK 공통 설정: END -->
<!-- Hive SDK 애널리틱스 설정: START -->
<!-- 애널리틱스 설정, 애널리틸스 사전 설정하기 가이드 참고 -->
<!-- Hive SDK 애널리틱스 설정: END -->
<!-- Hive SDK 기능별 설정: START -->
<providers>
<!-- 인증 제품을 설정, 인증 사전 설정하기 가이드 참고 -->
<!-- 빌링 제품을 설정, 빌링 사전 설정하기 가이드 참고 -->
<!-- 마케팅 어트리뷰션 제품을 설정, 마케팅 어트리뷰션 사전 설정하기 가이드 참고 -->
</providers>
<!-- Hive SDK 기능별 설정: END -->
</properties>