Unity
在 Unity 環境中配置 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 內部操作的日誌 | * 開 * 關 |
年齡限制 | 是否適用 COPPA ageGateU13 | * 關 * 開 |
Hive 方向 | 應用程式中使用的螢幕旋轉方向 | * 全部 * 直向 * 橫向 * 未定義 |
通用連結 | iOS 延遲深層連結設置 |
認證 (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 值
Note
有關每個身份驗證 IdP 配置值的更多詳細信息,請參閱身份驗證準備頁面。
市場 (計費)¶
市場 標籤是您配置使用 Hive SDK 收費功能的設置的地方。 Hive SDK 支持 Google Play 商店和 Apple App Store 等應用市場,在此標籤中,您需要設置進行應用內購買所需的值。
例如,如果应用程序支持 Android Lebi 市场和微信支付,您需要在市场标签中输入从微信控制台发出的支付密钥。
欄位 | 描述 | 值範圍 |
---|---|---|
Wechat 付款金鑰 | 在 Android 上使用 Wechat 作為 Lebi 市場付款方式時 設置 Wechat 的付款金鑰 | (範例: 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 * MESSENGER |
httpConnectTimeout | 设置 Hive 协议通信期间的连接超时持续时间(秒)(建议使用默认值) | * 8(默认) |
httpReadTimeout | 设置 Hive 协议通信期间的读取超时持续时间(秒)(建议使用默认值) | * 8(默认) |
maxGameLogSize | Hive SDK 分析功能的配置值 | |
analyticsSendLimit | Hive SDK 分析功能的配置值 | |
analyticsQueueLimit | Hive SDK 分析功能的配置值 | |
analyticsSendCycle | Hive SDK 分析功能的配置值 | |
saveAnalytisLogBeforeCrash | Hive SDK 分析功能的配置值 |
保存設置並創建 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 文件中的某些值也必须手动设置。
欄位 | 描述 | 值範圍 |
---|---|---|
公司 | 應用程式發佈公司 | 例如:如果是 Com2us,C2S |
渠道 | 應用程式使用的登入服務平台 | Hive (預設) |
市場 | 應用程式將要發布的應用市場 | * Android: GO (Google),LE (Lebi)* iOS: AP (App Store) |
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
- Unity 2021 或更高版本:
- 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 -->
Info
The Hive SDK settings can either store values in the configuration file before the app build or change the settings during runtime (app execution). For more details, check the Hive SDK settings.