Unity

在Unity環境中，有兩種方法可以配置hive_config.xml。

1. 使用 Unity Hive 配置編輯器自動配置 hive_config.xml 的內容
2. 手動配置 hive_config.xml

1. 使用 Unity hive 配置編輯器的自動配置¶

在 Unity 環境中，您可以自動創建 hive_config.xml 文件並使用 Unity Hive 配置編輯器配置其大部分內容。然而，即使使用 Unity Hive 配置編輯器，hive_config.xml 文件中的某些值必須手動設置。

執行 Unity hive 配置編輯器¶

選擇 Hive > Hive 配置 (編輯配置) 並在 編輯器 畫面上設置必要的值。

選擇執行環境¶

首先，选择应用执行环境（Android、iOS、macOS、Windows）。

常見 (hive sdk 的共同特徵)¶

通用 標籤允許您配置適用於 Hive SDK 所有功能的設置。您可以設置 Hive AppID 並選擇伺服器（生產或沙盒）。您還可以確定應用啟動時顯示的螢幕方向。通用標籤中的所有設置都是必填的。

認證 (authentication)¶

Auth 標籤是您配置使用 Hive SDK 認證功能的設置所在。 Hive SDK 支援 IdP 登入，例如 Facebook、Google 和 QQ。在選擇用於登入的 IdP 之後，您需要從該 IdP 的開發者控制台（例如：Google 控制台）檢索並輸入 AppId、ClientId 等等。

例如，要使用 Google 登入，您需要從 Google 控制台 獲取 Google 登入項目的所需值，並將它們輸入到下面顯示的 Auth 標籤中。

• Google 應用程式 ID: 輸入從 Google 控制台發出的 AppID
• Google 伺服器客戶端 ID: 輸入從 Google 控制台發出的網路應用程式的客戶端 ID 值

市場 (計費)¶

市場標籤是您配置使用Hive SDK計費功能的設置之處。Hive SDK支持應用市場，如Google Play商店和Apple App Store，在此標籤中，您需要設置應用內購買所需的值。

例如，如果应用程序支持 Android Lebi 市场和微信支付，您需要在市场选项卡中输入从微信控制台发出的支付密钥。

分析（行銷歸因）¶

分析 標籤是您配置使用 Hive SDK 行銷歸因功能的設置所在。Hive SDK 通過 Adjust、Firebase 等支持行銷歸因，您需要從相應的服務開發者控制台獲取 key 和 event 值並將其輸入到此標籤中。

例如，要使用 Adjust，请根据以下信息在分析选项卡中输入 Adjust 项目的所需值。

• appToken: 輸入從 Adjust 控制台發出的 AppToken
• Event: 輸入在 Adjust 控制台註冊的事件名稱和值

可選（網絡通信選項、日誌記錄和其他功能）¶

可選 在標籤中，您可以在使用 Hive SDK 時輸入網絡通信選項、日誌和其他設置。

例如，如果您想在调用 Hive SDK 方法时延长网络超时，请增加 httpConnectTimeout 和 httpReadTimeout 的值。作为另一个例子，当 发送远程日志 时，您可以更改传输周期和传输日志数据的大小，这允许您修改 分析日志设置值。 除非绝对必要，建议使用可选标签项的默认值。

保存設定並創建 hive_config.xml 文件¶

在 Unity Hive 配置编辑器中完成所有选项卡设置后，点击 保存并重新生成设置文件 将自动生成 hive_config.xml 文件。

安卓¶

點擊保存和重新生成設置文件將創建AndroidManifest.xml文件和hive_config.xml文件。hive_config.xml文件創建的位置取決於Unity的版本。

• Unity 2021 及以上版本: /Assets/HiveSDK/hive.androidlib/src/main/res/raw/hive_config.xml
• Unity 2021 以下版本: /Assets/Plugins/Android/res/raw/hive_config.xml

iOS¶

點擊保存和重新生成設置文件將創建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

2. 手動配置¶

如果您不使用 Unity Hive 配置编辑器，您将需要创建 hive_config.xml 文件，并手动设置文件中的大部分值。

hive_config.xml 文件创建¶

直接在以下路径创建hive_config.xml文件。

• 安卓
  • Unity 2021 或更高版本: /Assets/HiveSDK/hive.androidlib/src/main/res/raw/hive_config.xml
  • 2021 年之前的 Unity: /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 商店或 Apple AppStore）時的 hive_config.xml 文件示例。請根據您想要使用的 Hive SDK 功能和應用環境修改、添加或刪除值。由於 iOS 僅支持 Apple AppStore 支付，請在 Unity iOS 環境中將市場設置為 AP。

<properties>

    <!-- Hive SDK common settings: START -->
    <!-- Set game build unique identifier -->
    <appId>com.sample.your</appId>

    <!-- Select server for Hive platform. sandbox is for development, real is for commercial
        (sandbox, real) -->
    <zone>real</zone>

    <!-- Set whether to use SDK internal operation logs
        (true, false) -->
    <useLog>false</useLog>

    <!-- Set whether to apply ageGateU13
        (true, false) -->
    <ageGateU13>false</ageGateU13>

    <!-- Hive Orientation setting -->
    <hiveOrientation>landscape</hiveOrientation>

    <!-- Channel setting (login and in-app support service platform)
        (C2S: Hive platform) -->
    <channel>C2S</channel>

    <!-- Payment market setting (GO: Google Play, LE: Com2us Lebi, AP: Apple App Store) -->
    <market>GO</market>

    <!-- Set standard for receiving terms agreement
        (device, account) -->
    <agreementDetermineBase>false</agreementDetermineBase>

    <!-- Terms exposure design setting (Not set for SDK v4)
        (true, false) -->
    <!-- <authV1Agreement>device</authV1Agreement> -->

    <!-- Set sharing apps to not expose when sharing promotion UA (Android Only) -->
    <unsupportedUAShareType>
        <value>SMS</value>
        <value>URL</value>
    </unsupportedUAShareType>

    <!-- Set HTTP Connect Timeout time in seconds used internally by Hive SDK
        (Do not change unless it is a special case) -->
    <httpConnectTimeout>8</httpConnectTimeout>

    <!-- Set HTTP Read Timeout time in seconds used internally by Hive SDK
        (Do not change unless it is a special case) -->
    <httpReadTimeout>8</httpReadTimeout>
    <!-- Hive SDK common settings: END -->

    <!-- Hive SDK analytics settings: START -->
        <!-- Analytics settings, refer to analytics pre-configuration guide -->
    <!-- Hive SDK analytics settings: END -->

    <!-- Hive SDK feature settings: START -->
    <providers>
        <!-- Set authentication product, refer to authentication pre-configuration guide -->
        <!-- Set billing product, refer to billing pre-configuration guide -->
        <!-- Set marketing attribution product, refer to marketing attribution pre-configuration guide -->
    </providers>
    <!-- Hive SDK feature settings: END -->

</properties>