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 화면에서 필요한 값들을 설정합니다. 먼저 OS와 Authentication 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 서버 환경 |
|
Logging | Hive 클라이언트의 내부 동작에 대한 로그 활성화 여부 |
|
Push | Hive 플랫폼이 제공하는 푸시 서비스를 이용할 것인지 여부 |
|
Company | 게임 퍼블리싱 업체 |
|
Channel | 게임 앱이 사용하는 로그인 서비스 플랫폼. | Hive (디폴트) |
Market | 본 앱을 출시할 마켓 |
|
hivePermissionViewOn | Hive SDK 권한 고지 팝업 노출 여부 |
|
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 설정을 확인하세요.