跳轉至

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 文件中的某些值必須手動設置。

Note

在開發 Android 應用程式時，不必直接配置 AndroidManifest.xml 是很方便的，因此建議使用 Unity Hive 配置編輯器。

執行 Unity hive 配置編輯器

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

選擇執行環境

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

常見 (hive sdk 的共同特徵)

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

字段 描述 值范围
Hive 应用 ID 在 Hive 控制台应用中心注册的 AppID (例如，com.sample.your)
区域 Hive 服务器 * 沙盒
* 真实
日志记录 是否启用 Hive SDK 的内部操作日志记录 * 开
* 关
AgeGateU13 是否适用 COPPA ageGateU13 * 关
* 开
Hive 方向 Hive SDK 的 UI 根据设备方向设置显示 * 全部
* 纵向
* 横向
* 未定义
渠道 游戏应用中使用的登录和应用内支持服务平台 * C2S (Hive 平台)
* KAK (Kakao)
* LIN (Line)
* STE (Steam)
* EPI (Epic Store)
* FAS (FastSprint)
市场 应用内购买支付的市场（用于分析收集） * GO (Google PlayStore)
* AP (Apple AppStore)
* ON (OneStore)
* AM (Amazon AppStore)
* LE (Com2us Lebi)
* HS (Hive Store)
* GA (Samsung GalaxyStore)
* HU (Huawei AppGallery)
通用链接 通用链接 用于 iOS 延迟深度链接设置 应用开发者指定的域名
(例如，https://yourdomain.com)

認證 (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 值

Note

有關每個身份驗證 IdP 配置值的詳細信息，請參閱身份驗證準備頁面。

市場 (計費)

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

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

欄位 描述 值範圍
微信支付密鑰 當在 Android 上使用微信作為 Lebi 市場的收費方式時
設置微信的支付密鑰		 (示例: abcDEF1234xYz789)

分析（行銷歸因）

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

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

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

Note

有關每個行銷歸因設定的更多詳細資訊，請參閱行銷歸因準備頁面。

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

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

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

字段 描述 值范围
不支持的 UA 分享类型 在使用 Android UA 分享功能 时，在 Hive 分享 UI 中使用的社交媒体类型 * 短信
* URL
* KAKAO
* LINE
* WHATSAPP
* FACEBOOK
* MESSENGER
* WECHAT
agreementDetermineBase 确定 同意条款 的标准 * 设备
* 账户
httpConnectTimeout 设置 Hive 协议通信期间的连接超时持续时间（以秒为单位）（推荐默认值） * 8（默认）
httpReadTimeout 设置 Hive 协议通信期间的读取超时持续时间（以秒为单位）（推荐默认值） * 8（默认）
maxGameLogSize 作为非结构化数据文件存储的最大游戏日志数量
analyticsSendLimit 每次日志传输周期发送的最大日志数量
analyticsQueueLimit 可以排队的最大日志数量
analyticsSendCycle 日志传输周期
saveAnalytisLogBeforeCrash iOS 特定设置，用于确定在应用程序即将因 NSException 类型错误或 Unix 信号类型错误崩溃时，是否将待处理的分析日志保存到文件中，而不是发送到服务器

保存設定並創建 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>
Info

Hive SDK 配置可以在应用构建之前将值保存到配置文件中，或在运行时（应用执行）更改设置。有关更多详细信息，请查看 Hive SDK 配置。