Unity
將您想要作為外部庫使用的 Hive SDK 功能添加進來。 Hive SDK 提供各種功能，例如身份驗證、支付、推送通知和廣告橫幅。開發人員必須僅選擇和安裝他們想要使用的功能。在這裡，我們將指導您如何使用最基本的功能：身份驗證 和 支付。
Hive SDK 與 UnityPackage 版本中包含的 External-Dependency-Manager for Unity (EDM4U) 套件一起分發。它被配置為自動安裝/分發必要的庫以便使用 EDM4U 設置進行構建。如果未準備好 EDM4U 可以運行的構建環境，則必須進行設置。這可以通過 EDM4U 提供的 GUI 或通過 Unix shell、Bash，即命令行界面 (CLI) 來完成。
手動安裝/更新的注意事項¶
從 Hive SDK v4 24.3.0 開始，當通過 Unity package 安裝或更新 Hive SDK Unity，而不是通過 Hive SDK Manager 時，您必須在構建應用程序之前刪除位於以下路徑中的所有 HIVESDK_{library_name}Dependencies.xml 文件。
- 資產/Hive_SDK_v4/依賴項
- 資產/Hive_SDK_v4/編輯器
要刪除的檔案如下：
- HIVESDK_DefaultDependencies.xml
- HIVESDK_HerculesDependencies.xml
- HIVESDK_HiveAnalyticsConsentModeDependencies.xml
- HIVESDK_HiveDataStoreDependencies.xml
- HIVESDK_HiveDeviceManagementDependencies.xml
- HIVESDK_HiveGoogleInAppReviewDependencies.xml
- HIVESDK_HiveGoogleInAppUpdateDependencies.xml
- HIVESDK_HivePromotionDependencies.xml
- HIVESDK_HiveRealNameVerificationDependencies.xml
- HIVESDK_MarketAmazonDependencies.xml
- HIVESDK_MarketAppleDependencies.xml
- HIVESDK_MarketGoogleDependencies.xml
- HIVESDK_MarketHiveStoreDependencies.xml
- HIVESDK_MarketHuaweiDependencies.xml
- HIVESDK_MarketLebiDependencies.xml
- HIVESDK_MarketOneStoreDependencies.xml
- HIVESDK_MarketSamsungDependencies.xml
- HIVESDK_ProviderAdjustDependencies.xml
- HIVESDK_ProviderAppleDependencies.xml
- HIVESDK_ProviderAppleSignInDependencies.xml
- HIVESDK_ProviderAppsFlyerDependencies.xml
- HIVESDK_ProviderFacebookDependencies.xml
- HIVESDK_ProviderFirebaseDependencies.xml
- HIVESDK_ProviderGoogleDependencies.xml
- HIVESDK_ProviderGooglePlayGamesDependencies.xml
- HIVESDK_ProviderHiveMembershipDependencies.xml
- HIVESDK_ProviderHuaweiDependencies.xml
- HIVESDK_ProviderLineDependencies.xml
- HIVESDK_ProviderQQDependencies.xml
- HIVESDK_ProviderRecaptchaDependencies.xml
- HIVESDK_ProviderSingularDependencies.xml
- HIVESDK_ProviderVKDependencies.xml
- HIVESDK_ProviderWechatDependencies.xml
- HIVESDK_ProviderWeverseDependencies.xml
- HIVESDK_PushAmazonAdmDependencies.xml
- HIVESDK_PushGoogleFcmDependencies.xml
安卓¶
這是關於如何在Unity Android中安裝Hive SDK每個產品的指南。
Android 解析器設定¶
運行 Unity 並點擊 資產 > 外部依賴管理器 > Android 解析器 > 設定 菜單。
當 Android 解析器設定窗口出現時，檢查紅色標記的項目作為默認設置。
仅在您使用 Unity 版本 2022.2 或更高版本时，检查从 2022.2 复制和修补设置 Template.gradle 项目。使用 Jetifier 功能由 Hive SDK 自动支持，因此建议取消选择。
如果您在最新版本的 Unity 中選擇 使用 Jetifier，則需要根據 Unity 指南 創建 自定義 Gradle 屬性模板。
Hive 依賴¶
在 Hive 依賴項中，您可以啟用或禁用 Hive SDK 提供的服務。選擇 Hive > Hive 依賴項 (ExternalDependency)。
當設定窗口出現時，選擇您想要使用的 Hive 功能。例如，要使用 Google 認證和 Google Play 商店支付功能，請在 認證設定 中選擇 Google 登入，並在 市場設定 中選擇 Google PlayStore。選擇您想要使用的功能後，點擊 保存 以完成您的選擇。
Hive 模組設定
| 特徵 | 描述 |
|---|---|
| 促銷 | 提供有效曝光遊戲新消息或事件的功能。 |
| Google InAppReview | 提供在 Google Play 上留下評價的能力。 (Android) |
| 設備管理 | 此服務僅允許用戶註冊的設備進入遊戲。 |
| 實名驗證 | 提供中國用戶進行實名驗證的功能。 |
| 赫拉克勒斯 | 提供針對 Hive 平台遊戲的遊戲濫用檢測和追蹤服務。 |
| reCAPTCHA | 提供通過使用 Google reCAPTCHA 確定用戶是否為機器人來控制帳戶創建的功能。 |
| 數據存儲 | 此服務提供一個存儲系統，允許在遊戲中生成的數據以鍵值格式輕鬆保存和讀取。 |
| Google InAppUpdate | 提供在不關閉應用的情況下在背景中更新應用的能力。 (Android) |
| 分析同意模式 | 提供顯示同意橫幅以檢查是否已獲得個人數據收集的同意的功能。 |
| 配對系統 | 提供將遊戲用戶連接在一起玩的配對功能。 |
| 聊天 | 提供用戶的聊天功能，包括實時聊天、群組聊天和一對一聊天。 |
認證設定
| 功能 | 描述 |
|---|---|
| Hive 會員 | 提供「使用 Hive 登入」IdP。 |
| Google 登入 | 提供「使用 Google 登入」IdP。 |
| Google Play 遊戲 | 提供「使用 Google Play 登入」IdP。 (Android) |
| 提供「使用 Facebook 登入」IdP。 | |
| Apple GameCenter | 提供「使用 Game Center 登入」IdP。 (iOS) |
| Apple 登入 | 提供「使用 Apple 登入」IdP。 |
| Line | 提供「使用 LINE 登入」IdP。 |
| VK | 提供「使用 VK 登入」IdP。 |
| 提供「使用 QQ 登入」IdP。 | |
| 提供「使用 Wechat 登入」IdP。 | |
| Weverse | 提供「使用 Weverse 登入」IdP。 |
| Steam | 提供「使用 Steam 登入」IdP。 |
| X | 提供「使用 X 登入」IdP。 |
| Telegram | 提供「使用 Telegram 登入」IdP。 |
| Huawei | 提供「使用 Huawei 登入」IdP。 (Android) |
推送設定
| 功能 | 描述 |
|---|---|
| Google FCM | 提供 Firebase Cloud Messaging 通知功能。 (Android) |
| Apple APNs | 提供 Apple 推送通知服务功能。 (iOS) |
| Amazon ADM | 提供 Amazon 设备消息通知功能。 (Android) |
市場設定
| 功能 | 描述 |
|---|---|
| Google PlayStore | 提供 Google PlayStore 计费功能。 (Android) |
| Apple AppStore | 提供 Apple AppStore 计费功能。 (iOS) |
| OneStore | 提供 OneStore 计费功能。 (Android) |
| Amazon ADM | 提供 Amazon AppStore 计费功能。 (Android) |
| Lebi | 提供 Lebi 计费功能 (中国)。 (Android) |
| Hive Store | 提供 PG 支付功能。 (Android) |
| Samsung GalaxyStore | 提供 Samsung GalaxyStore 计费功能。 (Android) |
| Huawei AppGallery | 提供 Huawei AppGallery 计费功能。 (Android) |
分析設定
| 功能 | 描述 |
|---|---|
| Adjust | 通过 Adjust 提供营销归因功能。 |
| Airbridge | 通过 Airbridge 提供营销归因功能。 |
| AppsFlyer | 通过 AppsFlyer 提供营销归因功能。 |
| Singular | 通过 Singular 提供营销归因功能。 |
| Firebase | 通过 Firebase 提供营销归因功能。 |
iOS¶
本指南解释了如何在 Unity iOS 上安装每个 Hive SDK 产品。
安裝 CocoaPods¶
首先，安装 CocoaPods。运行 Unity 并点击 资产 > 外部依赖管理器 > iOS 解析器 > 安装 CocoaPods 菜单。
您也可以使用 CLI（Bash-shell）进行安装。
如果結果如下所示，則安裝已完成。
iOS 解析器設定¶
接下來，配置 CocoaPods。當使用 CocoaPods 為 iOS 提供外部庫時，現有的 .xcodeproj 檔案擴展名會更改為 .xcworkspace。如果您無法在 .xcworkspace 形式中繼續構建，請嘗試使用 GUI 更改設置。在構建 PC 上的 Unity 中應用 CocoaPods 的方法已經改變，並且可以執行。
-
運行 Unity 並點擊 資產 > 外部依賴管理器 > iOS 解析器 > 設定 菜單。
-
當 iOS 解析器設定窗口出現時，將 Cocoapods Integration 項目設置為 .xcworkspace，並取消勾選 Link framework statically 以避免強制靜態引用該框架。
Hive 依賴¶
在 Hive 依賴項中，您可以啟用或禁用 Hive SDK 提供的服務。選擇 Hive > Hive 依賴項 (ExternalDependency)。
當設定窗口出現時，選擇您想要使用的 Hive 功能。例如，要使用 Google 認證和 Apple AppStore 付款功能，請在 身份驗證設定 中選擇 Google 登入，並在 市場設定 中選擇 Apple AppStore。選擇您想要使用的功能後，點擊 保存 以完成您的選擇。
Hive 模組設定
| 功能 | 描述 |
|---|---|
| 促銷 | 提供有效曝光遊戲新消息或事件的功能。 |
| Google InAppReview | 提供在 Google Play 上留下評論的能力。（Android） |
| 設備管理 | 此服務僅允許用戶註冊的設備進入遊戲。 |
| 實名驗證 | 提供來自中國的用戶進行實名驗證的功能。 |
| Hercules | 提供針對 Hive 平台遊戲的遊戲濫用檢測和追蹤服務。 |
| reCAPTCHA | 提供通過使用 Google reCAPTCHA 確定用戶是否為機器人來控制帳戶創建的功能。 |
| 數據存儲 | 此服務提供一個存儲系統，允許在遊戲中生成的數據以鍵值格式輕鬆保存和讀取。 |
| Google InAppUpdate | 提供在不關閉應用程序的情況下在背景中更新應用的能力。（Android） |
| 分析同意模式 | 提供顯示同意橫幅以檢查是否已獲得個人數據收集的同意的功能。 |
| 配對系統 | 提供將遊戲用戶連接在一起玩的配對功能。 |
| 聊天 | 提供用戶聊天功能，包括實時聊天、群組聊天和一對一聊天。 |
認證設定
| 特徵 | 描述 |
|---|---|
| Hive 會員 | 提供「使用 Hive 登入」身份提供者。 |
| Google 登入 | 提供「使用 Google 登入」身份提供者。 |
| Google Play 遊戲 | 提供「使用 Google Play 登入」身份提供者。（Android） |
| 提供「使用 Facebook 登入」身份提供者。 | |
| Apple GameCenter | 提供「使用 Game Center 登入」身份提供者。（iOS） |
| Apple 登入 | 提供「使用 Apple 登入」身份提供者。 |
| Line | 提供「使用 LINE 登入」身份提供者。 |
| VK | 提供「使用 VK 登入」身份提供者。 |
| 提供「使用 QQ 登入」身份提供者。 | |
| 提供「使用 Wechat 登入」身份提供者。 | |
| Weverse | 提供「使用 Weverse 登入」身份提供者。 |
| Steam | 提供「使用 Steam 登入」身份提供者。 |
| X | 提供「使用 X 登入」身份提供者。 |
| Telegram | 提供「使用 Telegram 登入」身份提供者。 |
| Huawei | 提供「使用 Huawei 登入」身份提供者。（Android） |
推送設定
| 特性 | 描述 |
|---|---|
| Google FCM | 提供 Firebase Cloud Messaging 通知功能。 (Android) |
| Apple APNs | 提供 Apple Push Notification Service 功能。 (iOS) |
| Amazon ADM | 提供 Amazon Device Messaging 通知功能。 (Android) |
市場設定
| 功能 | 描述 |
|---|---|
| Google PlayStore | 提供 Google PlayStore 计费功能。 (Android) |
| Apple AppStore | 提供 Apple AppStore 计费功能。 (iOS) |
| OneStore | 提供 OneStore 计费功能。 (Android) |
| Amazon ADM | 提供 Amazon AppStore 计费功能。 (Android) |
| Lebi | 提供 Lebi 计费功能 (中国)。 (Android) |
| Hive Store | 提供 PG 支付功能。 (Android) |
| Samsung GalaxyStore | 提供 Samsung GalaxyStore 计费功能。 (Android) |
| Huawei AppGallery | 提供 Huawei AppGallery 计费功能。 (Android) |
分析設定
| 功能 | 描述 |
|---|---|
| Adjust | 透過 Adjust 提供行銷歸因功能。 |
| Airbridge | 透過 Airbridge 提供行銷歸因功能。 |
| AppsFlyer | 透過 AppsFlyer 提供行銷歸因功能。 |
| Singular | 透過 Singular 提供行銷歸因功能。 |
| Firebase | 透過 Firebase 提供行銷歸因功能。 |
Windows¶
導入 Windows 套件後，不需要額外的設置。
Info
有關每個 Hive SDK 功能（身份驗證、計費、通知等）的詳細信息，請參閱每個功能指南。