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 包 安装或更新 Hive SDK Unity 而不是通过 Hive SDK 管理器时，您必须在构建应用程序之前删除位于以下路径中的所有 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 复制和修补 settingsTemplate.gradle 项目。使用 Jetifier 功能由 Hive SDK 自动支持，因此建议取消选择。
如果您在最新版本的Unity中选择使用Jetifier，则需要根据Unity指南创建自定义Gradle属性模板。
Hive 依赖关系¶
在 Hive 依赖项中，您可以启用或禁用 Hive SDK 提供的服务。选择 Hive > Hive 依赖项 (ExternalDependency)。
当设置窗口出现时，选择您想要使用的 Hive 功能。例如，要使用 Google 认证和 Google Play 商店支付功能，请在 身份验证设置 中选择 Google 登录，在 市场设置 中选择 Google Play 商店。选择您想要使用的功能后，点击 保存 完成您的选择。
蜂巢模块设置
| 功能 | 描述 |
|---|---|
| 推广 | 提供有效曝光游戏新消息或事件的功能。 |
| Google InAppReview | 提供在 Google Play 上留下评论的能力。(Android) |
| 设备管理 | 此服务仅允许用户注册的设备进入游戏。 |
| 实名认证 | 提供中国用户进行实名认证的功能。 |
| Hercules | 提供针对 Hive 平台游戏的游戏滥用检测和追踪服务。 |
| reCAPTCHA | 提供通过 Google reCAPTCHA 确定用户是否为机器人来控制账户创建的功能。 |
| DataStore | 此服务提供一个存储系统，允许在游戏中生成的数据以键值格式轻松保存和读取。 |
| 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 登录”身份提供者。 | |
| 微信 | 提供“使用微信登录”身份提供者。 |
| Weverse | 提供“使用 Weverse 登录”身份提供者。 |
| Steam | 提供“使用 Steam 登录”身份提供者。 |
| X | 提供“使用 X 登录”身份提供者。 |
| Telegram | 提供“使用 Telegram 登录”身份提供者。 |
| 华为 | 提供“使用华为登录”身份提供者。（Android） |
推送设置
| 特性 | 描述 |
|---|---|
| Google FCM | 提供Firebase云消息通知功能。(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) |
| 设备管理 | 此服务仅允许用户注册的设备进入游戏。 |
| 实名认证 | 为来自中国的用户提供实名认证功能。 |
| 赫拉克勒斯 | 提供针对 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 登录”身份提供者。 | |
| 微信 | 提供“使用微信登录”身份提供者。 |
| Weverse | 提供“使用 Weverse 登录”身份提供者。 |
| Steam | 提供“使用 Steam 登录”身份提供者。 |
| X | 提供“使用 X 登录”身份提供者。 |
| Telegram | 提供“使用 Telegram 登录”身份提供者。 |
| 华为 | 提供“使用华为登录”身份提供者。（Android） |
推送设置
| 特性 | 描述 |
|---|---|
| Google FCM | 提供Firebase云消息通知功能。(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 提供营销归因功能。 |
Windows¶
导入 Windows 包后无需额外设置。
Info
有关每个 Hive SDK 功能（身份验证、计费、通知等）的详细信息，请参阅每个功能指南。