Unity
Unity 환경에서 hive_config.xml을 설정하는 방법은 아래 2가지입니다.
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 메서드를 호출할 때, 네트워크 타임아웃 시간을 연장하기 원한다면 httpConnectTimeout
및 httpReadTimeout
값을 증가시킵니다. 또 다른 예로, 원격 로그 전송 시 전송 주기와 전송 로그 데이터 크기를 변경하면, 애널리틱스 로그 설정 값들을 변경할 수 있습니다. Optional 탭 항목들은 반드시 필요한 경우가 아니라면 기본값 그대로 사용하는 것을 권장합니다.
필드 | 설명 | 값 범위 |
---|---|---|
Unsupported UA Share Type | Android UA Share 기능 사용 시 Hive 공유하기 UI에 사용할 소셜 미디어 종류 | - SMS - URL - KAKAO - LINE - MESSENGER |
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 설정을 확인하세요.