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 Hive Config Editor 설정¶
Unity 환경에서는 Unity Hive Config Editor로 hive_config.xml 파일을 자동으로 생성하고 설정값을 할당할 수 있습니다.
OS와 Authentication Version 설정¶
Hive > Hive Config (Edit Config)를 선택하고 Editor 화면에서 필요한 값들을 설정합니다. 먼저 OS와 Hive App Id을 확인합니다. 그리고, Google 인증을 사용하려면 OS를 선택하고 Auth 메뉴에서 Google SignIn 항목에 값들을 설정합니다.
Google Sign-in Settings¶
일반 Google 인증을 사용하기 위해 Auth 메뉴에서 Google SignIn 항목에 필요한 값을 아래 내용을 따라 입력합니다.
- Google App Id 필드에 발급받은 AppID를 입력하세요.
- Google Server Client ID 필드에 발급받은 웹 애플리케이션의 Client ID값을 입력하세요.
HiveConfig Settings¶
hive_config.xml 파일에서 설정하는 값 중 다음 값을 설정할 수 있습니다.
필드 | 설명 | 값 범위 |
---|---|---|
Hive App Id | 앱 아이디 |
|
Zone | Hive 서버 환경 |
|
Logging | Hive 클라이언트의 내부 동작에 대한 로그 활성화 여부 |
|
Hive Orientation | 앱에서 사용되는 스크린 회전 방향 |
|
Company | 게임 퍼블리싱 업체 (hive_config.xml 파일 내 수동 설정) |
|
Channel | 게임 앱이 사용하는 로그인 서비스 플랫폼 (hive_config.xml 파일 내 수동 설정) | Hive (디폴트) |
Market | 본 앱을 출시할 마켓 (hive_config.xml 파일 내 수동 설정) |
|
hive_config.xml 파일 생성¶
Inspector 설정 완료 후, 아래 방법을 따라 hive_config.xml 파일을 생성합니다.
- Android: Save & Regenerate setting files 버튼을 클릭해 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: Save & Regenerate setting files 버튼을 클릭해 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 설정을 확인하세요.