Unity

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

1. 自動設置 hive_config.xml 的內容，使用 Unity Hive Config Editor
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 SignIn，您需要从 Google 控制台 获取 Google SignIn 项目的所需值，并将其输入到 Auth 选项卡中，如下所示。

• Google App Id: 輸入從 Google 控制台發出的 AppID
• Google Server Client ID: 輸入從 Google 控制台發出的網頁應用程式的 Client 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

hive_config.xml 手動配置¶

即使在使用 Unity Hive 配置编辑器时，以下 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。

``` xml

<!-- Hive SDK common: START -->
<appId>com.sample.your</appId>

<gameLanguage>en</gameLanguage>

<!--* Select Hive platform's server. sandbox for development, real for live
    (sandbox, real) -->
<zone>real</zone>

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

<!--* Company settings
    (C2S: Com2uS, GVI: Com2us Holdings) -->
<company>C2S</company>

<!--* Channel settings
    (C2S: Hive platform) -->
<channel>C2S</channel>

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

<!--* Set HTTP Connect Timeout duration used internally in the Hive SDK in seconds
    (do not change unless in special cases) -->
<httpConnectTimeout>8</httpConnectTimeout>

<!--* Set HTTP Read Timeout duration used internally in the Hive SDK in seconds
    (do not change unless in special cases) -->
<httpReadTimeout>8</httpReadTimeout>

<agreementDetermineBase>device</agreementDetermineBase>
<!-- Hive SDK common settings: END -->

<!-- Hive SDK feature-specific settings: START -->
<!--* Authentication product settings: Use Google authentication -->
<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 feature-specific settings: END -->