엔진 공통

개발 엔진(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
• 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 Native
  • <앱_프로젝트_경로>/app/res/raw/hive_config.xml
• iOS Native
  • 원하는 위치에 hive_config.xml 파일을 만들고 직접 Xcode 프로젝트에 연결

Hive SDK 공통 설정¶

어떤 Hive SDK 기능을 사용하던지 기본적으로 hive_config.xml에 입력해야 하는 항목입니다. 필수 항목은 반드시 입력해야 하며, 선택 항목은 필요에 따라 입력합니다. 선택 항목을 입력하지 않으면 Hive SDK 기본값으로 동작합니다.

Hive SDK 기능별 설정¶

사용할 Hive SDK 기능별로 hive_config.xml에 입력해야 하는 항목입니다. 사용할 Hive SDK 기능에 해당하는 항목만 입력합니다. 여기에서는 예시로 인증 제품(Google 로그인)을 사용하는 경우에 설정해야 하는 항목을 안내합니다. Hive SDK 기능별로 필요한 항목은 Hive SDK 기능별 개발 가이드 시작하기 페이지를 참고하세요.

지원하지 않는 설정¶

hive_config.xml 파일 항목들 중 더는 지원하지 않는 항목들은 다음과 같습니다.

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>

    <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>