SDK Unity 发布说明¶
本指南介绍 Hive SDK Unity 各版本的主要更新。
Hive SDK Unity 各目标操作系统的更新通过以下操作系统标签区分。
- Android SDK Unity Android 更新
- iOS SDK Unity iOS 更新
- Windows SDK Unity Windows 更新
- 全部 SDK Unity Android、iOS 和 Windows 更新
必需项¶
使用 Hive SDK 各发布版本之前,我们指导您进行与版本特定限制相关的必需设置。
- 安全密钥设置 适用于 Hive SDK v4 Unity 25.0.0 及更高版本
- 由于身份验证安全协议的变更,在使用 Hive SDK v4 Unity 25.0.0 及更高版本时,您必须在Hive 控制台 > 安全密钥设置中颁发安全密钥。没有安全密钥,您将无法登录应用程序。
- Hive SDK v4 Unity 25.1.3 或更高版本需要对 PG 支付实现进行更改
- 要在 Android 和 iOS 25.1.3 或更高版本,或 Windows 25.1.0 或更高版本上实现 PG 支付,您必须参考 PG 支付流程 修改 PG 支付实现代码。
- Hive SDK v4 Unity Windows 25.8.1 存在一个问题,即点击前端推广横幅广告无法正确跳转到链接。要解决此问题,请按以下步骤替换前端横幅广告的 HTML 文件:
- 下载并解压包含修改后 HTML 文件的 zip 文件(https://hive-fn.qpyou.cn/hivedev/sdk/hive_sdk_v4_with_core/patch/hivesdk_win_respatch_min25_8_1.zip)。
- 将整个文件夹复制到
Plugins/HIVESDK/Source/HiveSDKWindows/assets/additional目录下并覆盖原有文件夹。 - 重新构建应用程序。
- 如果您正在使用 Hive SDK v4 Unity 25.4.0 或更高版本,请将 SDK 管理器更新到 SDK 管理器 v 2.0.0 或更高版本。
v4.26.1.3¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2026-02-06 |
| SDK Unity iOS | 2026-02-06 |
已修复的错误¶
Authentication¶
- iOS 修复了在 iPad 上点击 AgeGate 弹出窗口或日历相关弹出窗口中需要输入出生日期信息的空白区域会导致应用程序冻结(无响应)的问题。
- iOS 修复了在 iOS 设备上运行设备管理服务时,某些弹出窗口会显示不必要的滚动条的问题。
Billing¶
- iOS 修复了调用 getAccountUUID 方法时返回的值会发生变化的错误。
Promotion¶
- Android 修复了当游戏应用在后台运行时,如果发生用户互动 (UE) 直接链接事件,促销弹窗就会消失的问题。
Marketing Attribution¶
- iOS 修复了在分辨率宽度小于 1170px 的 iOS 设备上,《数字市场法案》(DMA) 同意横幅中的某些文本无法显示的问题。
v4.26.1.2¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Interface | 2026-01-23 |
| SDK Unity Android | 2026-01-23 |
| SDK Unity iOS | 2026-01-23 |
更改的功能¶
Authentication¶
- Android iOS 如果您之前在中国登录 Hive Membership 时已验证过手机号码,那么在中国进行的实名验证步骤将直接进行身份验证,而无需验证手机号码。
- 由于现有的 Hive Membership 登录流程仅验证您的会员 ID(电子邮件地址),而不验证您的手机号码,因此您需要在后续的中国实名验证步骤中验证您的手机号码。
已修复的错误¶
- iOS 修复了由于在执行 Apple 提交时包含了错误生成的捆绑文件 Info.plist 而导致分发版本验证失败的错误。
- iOS 修复了退款用户付款界面中 PG 付款被显示为 Hive Store 的错误。
v4.26.1.1¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Interface | 2026-01-15 |
| SDK Unity iOS | - |
注意:此 SDK 版本不提供单独的发行文件,该功能包含在 SDK 的更高版本中。
已修复的错误¶
Plugins¶
- iOS 修复了在面向 iOS 时设置外部库依赖项后 Hive SDK 版本信息未准确反映的问题。
v4.26.1.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Interface | 2026-01-13 |
| SDK Unity Android | 2026-01-13 |
| SDK Unity iOS | 2026-01-13 |
| SDK Unity Windows | 2026-01-13 |
检查此 SDK 版本的开发环境。
新功能¶
Authentication¶
- All 在向用户显示弹出窗口以输入其出生日期后,我们提供了一个
AuthV4.checkAgeGate方法,该方法在用户输入其出生日期时返回该值作为回调。 - All 添加
AuthV4.setAutoLoginEnabled方法(../../dev/authv4/login-helper.md#set-auto-login-enabled),即可将下一个非当前登录会话注册为自动登录会话(ON/OFF)。如果将其设置为ON并使用登录方法登录,则该登录会话将被保存为自动登录会话。您可以在后续登录期间运行AuthV4.Helper.signIn或将ProviderType.AUTO设置为AuthV4.signIn来使用自动登录功能。 - Android 支持 使用 Xiaomi 登录。
Billing¶
- Android 支持使用 小米计费。
Promotion¶
- All 我们支持延迟深度链接,即使用户尚未安装该应用,点击直接链接后,该用户仍可被重定向到链接中指定的应用内页面。
Marketing Attribution¶
- Windows 我们正在发布 Appsflyer for Native PC,它可以在桌面电脑环境中传输必要的信息,而不是在 Steam 环境中传输。
- Windows 从 Airbridge 1.1.4 版本开始,我们提供了在用户登录后延迟向 MMP 服务器发送安装事件日志的功能。通过在用户登录后发送安装事件日志,游戏开发者可以将包括玩家 ID 在内的账户信息传输到 MMP 服务器。
Remote Play¶
- Windows 从远程播放插件 1.01.02 版本及更高版本开始,在远程播放运行时点击外部链接将在远程设备上打开页面。这样就可以在远程播放期间进行 PG 付款。
Add-ons¶
- Android 当使用 PlatformHelper 类的 showInWebView 方法在 作为游戏内 webview 打开 中公开 webview 时,我们提供了使用 Game Activity 而不是 Hive Activity 来公开它的选项。
Others¶
- All 您可以使用
Configuration类中的getGameLanguage方法检查 SDK 中设置的语言设置。 - iOS 随着 CocoaPod 服务的结束,我们现在通过 SPM(Swift Package Manager)提供分发服务。
更改的功能¶
- Windows 我们改进了HTTP通信逻辑,以提高稳定性。
Authentication¶
- Android iOS 成人身份验证方法不仅支持网页版,也支持应用程序版。
- All 移除登录SNS时自动收集个人资料图片和昵称。
- All
AuthV4.setAutoLoginEnabled(默认值:PC 关闭 / 移动设备开启) 根据新增内容,自动登录行为策略已更改如下: - 原有:账户冲突后切换到其他账户时,新账户在移动设备上保持自动登录,但在 PC 上禁用自动登录。
- 更改:账户冲突后切换到其他账户时,如果已通过
AuthV4.setAutoLoginEnabled注册了自动登录会话,则新账户在移动设备和 PC 上均保持自动登录。否则,将禁用自动登录(存在例外情况)。 - Windows 已添加弹出窗口,提示在使用 Steam Deck 的身份验证功能时不支持 Pass。
- Windows 将您的 Google 登录设置更改为同时使用凭据管理器和 Play 服务身份验证。如果凭据管理器出现故障,它将尝试使用 Play 服务身份验证登录。
Billing¶
- Windows PG支付方式已更改为通过外部浏览器进行。
- Android 将用于 Google Play 结算的库更改为 Google Play 结算库 8.0。
Promotion¶
- Windows 修复了通过自定义视图/直接视图导航到外部浏览器时 webview 会闪烁的问题。
- Android iOS 修复了通过自定义视图/直接视图导航到外部浏览器时 webview 会闪烁的问题。
Push¶
- iOS 在收集推送通知的令牌时,根据构建环境更改以收集其他令牌信息。
Marketing Attribution¶
- Android iOS 我们更新了弹出窗口的设计,并改进了DMA 同意横幅的行为。
- 现有同意横幅已获得的任何同意历史记录都将保留,重新显示时,将显示一个文本和用户界面都得到改进的新同意横幅。
- 如果您之前为现有同意横幅使用了自定义文本,则必须根据更改后的数据结构重新配置文本,请参阅设置自定义同意横幅用户界面。
- Android iOS 更改以防止将同一收据的重复销售日志发送到 MMP。
- Android iOS 新增了在发送 Firebase 购买事件时,将销售额发送到 value 键的功能。
- 之前,销售额发送到 revenue 键。
Add-ons¶
- Android iOS 改进了 PlatformHelper 类的 showInAppView 方法在 打开游戏内 webview 中显示的关闭 webview 按钮的可见性。
Plugins¶
- iOS 提升与 SDK 附带的 JSONObject 类的兼容性。
- 确保名称不会与构建环境中的其他 JSONObject 类重叠。
Provisioning¶
- Android iOS 我们提供了一个单独的年龄范围 API,供用户选择是否使用,以遵守《应用商店责任法案》。
- 《应用商店责任法案》将于2026年1月1日在美国德克萨斯州生效,目前尚未实施,可根据开发情况选择性地应用。
- 《应用商店责任法案》将于2026年5月在美国犹他州生效,并于2026年7月在美国路易斯安那州生效,也可选择性地应用。
Library updates¶
- Windows 已将 Microsoft Visual C++ Redistributable 更改为使用 14.44.35211.0 或更高版本。
- Android 亚马逊应用商店 (Android) v3.0.4 → v3.0.8
- 三星 GalaxyStore IAP (Android) v6.1.1 → v6.5.0
- Google 计费库 (Android) v7.0.0 → v8.0.0
- QQ (安卓) v3.5.17 → v3.5.18
- 小米 (Android) v3.2.5_12798 → v3.4.6
- iOS Adjust (iOS) 5.4.3 → 5.4.6
- Airbridge (iOS) 4.7.0 → 4.8.1
- AppsFlyer (iOS) 6.17.2 → 6.17.7
- Firebase (iOS) 11.15.0 → 12.5.0
- Singular (iOS) 12.8.1 → 12.9.0
- Facebook (iOS) 18.0.0 → 18.0.2
- Line (iOS) 5.13.0 → 5.14.0
- QQ (iOS) 3.5.17.5 → 3.5.18
- SDWebImage (iOS) 5.21.1 → 5.21.5
Others¶
- All
Configuration.setZone操作已更改为仅在初始化之前有效。
已修复的错误¶
- Android 将整个公共区域的 UI 背景修改为不透明,使其在镂空区域内可见。
Authentication¶
- iOS 修复了使用聊天机器人时聊天消息输入字段间歇性不显示的问题。
- iOS 修复了在设备管理中注册设备数量超过限制后删除已注册设备时,成人身份验证弹出窗口会再次出现的错误。
- Windows 修复了在 AuthV4 身份验证期间尝试关闭应用程序时应用程序无法关闭的问题。
- Windows 我们修复了一个问题,即当请求身份验证页面的应用关闭后,从另一个应用(或重新启动的应用)请求身份验证时,先前请求的身份验证结果被错误地传输,导致错误(
-1200001, -8)。
Promotion¶
- iOS 修复了当新闻项目数量超过一定数量时,新闻菜单无法正常工作的问题。
- iOS 修复了当正面横幅上显示的图像宽度或高度为“0”或从服务器发送错误信息时,阻止正常运行的错误。
- iOS 修复了在公开带有直接链接的社区时,如果没有 URL 参数,直接链接将无法正常工作的问题。
- Windows 修复了点击促销活动中的“今日不显示”选项会导致该促销活动永久无法显示的问题。
Push¶
- Android 修复了即使受 COPPA 约束,推送通知令牌仍被收集的错误。
- iOS 修复了 ForegroundPush 设置无法更改为 False 的问题。
Marketing Attribution¶
- iOS 修复了 Firebase 中缺少安装或更新事件的错误。
- Windows 修复了营销归因的购买日志被重复收集的问题。
Remote Play¶
- Windows 修复了在远程播放中刷新 JWT 令牌时发生的崩溃问题。
Add-ons¶
- iOS 修复了当游戏应用程序用户的网络状态离线或当应用打开游戏内浏览器中的 PlatformHelper 类的 showInAppBrowser 方法时,游戏应用程序会闪烁并关闭窗口的问题。
Others¶
- Windows 我们已经修复了查询值不是键值格式(例如
?831020)的问题,该问题在内部方案(例如 interwork://)中被错误地传输为831020=,并将传输方式改进为831020。 - Windows 修复了使用 Remote Play 等插件时,通过
Configuration.setZone设置的区域未生效的问题。
v4.26.0.1¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2025-12-18 |
| SDK Unity iOS | 2025-12-18 |
更改的功能¶
- iOS 用于 Hive SDK 开发环境的 Xcode 版本已更改如下:
- 先前版本:Xcode 26.2 Beta2
- 更改版本:Xcode 26.2
Provisioning¶
- Android 为响应《应用商店责任法案》,Hive SDK 支持的 Google Play Age Signals API 版本已更改如下:
- 先前版本:0.0.1-Beta2
- 更改版本:0.0.2
v4.26.0.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Interface | 2025-12-08 |
| SDK Unity Android | 2025-12-08 |
| SDK Unity iOS | 2025-12-08 |
检查此 SDK 版本的开发环境。
新功能¶
- iOS 您可以使用 Xcode 26.2 或更高版本在 iOS 上构建 Hive SDK。
- 最低支持的操作系统版本为 iOS 15。
Provisioning¶
- Android 我们新增了一项合规性功能(../../dev/provisioning/compliance.md)。
- 如果您将游戏应用分发到 Google Play 或 Amazon Appstore,Hive SDK 提供了一个 年龄范围 API,用于检查用户的年龄范围,以符合将于 2026 年 1 月 1 日在美国德克萨斯州生效的《应用商店问责法案》。
- iOS 我们新增了一项合规性功能(../../dev/provisioning/compliance.md)。
- 如果您将游戏应用发布到 Apple App Store,Hive SDK 提供了一个 年龄范围 API,用于检查用户年龄范围,以符合将于 2026 年 1 月 1 日在美国德克萨斯州生效的《App Store 问责法案》。
- 仅支持 iOS 26.2 或更高版本。
已知问题¶
Provisioning¶
- Android 根据《App Store责任法案》,Hive SDK 26.0.0 Beta 支持的 Google Play Age Signals API 版本 0.0.1-beta02 不能用于接收实际年龄信号的用户环境。
※ 要接收实际年龄信号,请更新至 Hive SDK v4.26.0.1,该版本支持 Google Play Age Signals API 版本 0.0.2(非测试版)。
v4.25.8.2¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Windows | 2025-11-25 |
检查此 SDK 版本的开发环境。
已修复的错误¶
Payment¶
- Windows 我们修复了 Google Play Games PC 支付中,当注册产品数量超过 20 个时,无法检索所有产品信息的问题。
v4.25.8.1¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Windows | - |
注意:此 SDK 版本不提供单独的发行文件,该功能包含在 SDK 的更高版本中。
已修复的错误¶
Others¶
- Windows 修复了更改游戏语言后,关闭指南界面仍以初始设置的语言显示的问题。
Chat¶
- Windows 修复了韩语消息无法调用回调函数的问题。
v4.25.9.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Interface | 2025-11-07 |
| SDK Unity Android | 2025-11-07 |
| SDK Unity iOS | 2025-11-07 |
| SDK Unity Windows | 2025-10-31 |
检查此 SDK 版本的开发环境。
新功能¶
Authentication¶
- All 我们提供身份验证服务。
- SteamDeck 不提供身份验证服务(身份验证、成人验证、家长同意)。您必须在手机或电脑上使用身份验证服务,然后通过 SteamDeck 重新访问游戏。
已修复的错误¶
Others¶
- Windows 修复了更改游戏语言后,关闭指南界面仍以初始设置的语言显示的问题。
v4.25.7.1¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Windows | - |
注意:此 SDK 版本不提供单独的发行文件,该功能包含在 SDK 的更高版本中。
已修复的错误¶
Others¶
- Windows 通过应用 DX12 渲染器 GPU 同步,提高了渲染稳定性。
- Windows 修复了促销新闻中的关闭按钮间歇性无法工作的问题。
v4.25.8.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Interface | 2025-10-02 |
| SDK Unity Android | 2025-10-02 |
| SDK Unity iOS | 2025-10-02 |
| SDK Unity Windows | 2025-10-02 |
检查此 SDK 版本的开发环境。
新功能¶
- All 最低支持的 Unity 版本已更改。
- 支持 16KB 页面大小的 Unity 版本列表:
- Unity 6000.1.0f1
- Unity 6000.0.38f1
- Unity 2022.3.56f1
- Unity 2021.3.48f1
- 支持 Android 16 目标平台的 Unity 版本列表:
- Unity 6000.1.0f1
- Unity 2022.3.62f1
- Unity 2021.3.51f1
- Android 支持 Android OS 16(API 级别 36)。
- Android 为 Android OS 15(API 级别 35)或更高版本构建时,支持 16KB 页面大小的构建。
Game Data Store¶
- Windows 添加了数据存储功能。
Chat¶
- Windows 已添加聊天功能。
更改的功能¶
- Android 移除已弃用的
android.permission.FOREGROUND_SERVICE权限。 - Android Android 最低构建目标从
19更改为23。
Authentication¶
- iOS 移除在 Xcode 26 中构建时不可用的库引用。
Billing¶
- Windows 我们已将 Google Play for Native PC (EAP) 集成从 Web API 切换到 Google Play Games PC SDK。
- 您现在必须通过 Google Play Games PC 应用登录您的 Google 帐户,而不是通过 Hive SDK 身份验证。请参阅初始化说明。
- 现有项目和新项目都必须遵循Google 指南来准备清单配置和代码签名。
Library updates¶
- Android Adjust(Android)5.2.0 → 5.4.2
- Airbridge(Android)4.3.0 → 4.7.1
- AppsFlyer(Android)6.16.2 → 6.17.3
- Firebase-analytics(Android)22.1.2 → 23.0.0
- Singular(Android)12.7.0 → 12.10.0
- Facebook(Android)17.0.0 → 18.0.1
- Line(Android)5.10.0 → 5.11.1
- play-services-auth(Android)(Google 登录)20.7.0 → 21.3.0
- play-services-games-v2(Android)(Play 游戏服务)20.1.2 → 21.0.0
- play-services-ads-identifier(Android)18.0.1 → 18.2.0
- play-services-analytic(Android)18.0.4 → 18.1.1
- firebase messaging(Android)24.0.2 → 25.0.0
- onestore(Android)21.01.00 → 21.02.01
- google-core-review(Android)2.0.1 → 2.0.2
- reCAPTCHA(Android)18.6.1 → 18.7.1
- Kotlin(Android)1.9.22 → 2.1.21
- iOS Adjust(iOS)5.2.0 → 5.4.3
- Airbridge(iOS)4.3.0 → 4.7.0
- AppsFlyer(iOS)6.16.1 → 6.17.2
- Firebase(iOS)11.6.0 → 11.15.0
- Singular(iOS)12.7.1 → 12.8.1
- Facebook(iOS)17.4.0 → 18.0.0
- Google 登录(iOS)8.0.0 → 9.0.0
- Line(iOS)5.11.2 → 5.13.0
- QQ(iOS)3.5.17.4 → 3.5.17.5
- SDWebImage(iOS)5.20.0 → 5.21.1
- Recaptcha(iOS)18.6.0 → 18.7.0
Hercules¶
- Windows Hercules 版本已更新至
2025.08.11。
已修复的错误¶
Authentication¶
- iOS 修复了聊天机器人弹出窗口偶尔会以横屏模式而不是竖屏模式显示的问题。
- iOS 修复了空数组引用错误。
- 使用 Authv4 类的
showConflict方法时,如果缺少必需的输入数据,则会发生崩溃。
Remote Play¶
- Windows 修复了即使使用
Application.CancelQuit或Application.wantsToQuit取消连接,远程播放连接仍会断开的问题。现在,连接将在应用程序实际退出时断开。
Others¶
- Windows 提高了方法调用快速连续时的稳定性。
Analytics¶
- Android 当客户端连接传输失败时,会对其进行修改,以避免重传不必要的信息。
v4.25.7.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | - |
| SDK Unity iOS | - |
| SDK Unity Windows | - |
注意:此 SDK 版本不提供单独的发行文件,该功能包含在 SDK 的更高版本中。
新功能¶
Authentication¶
- All 成人验证完成后,即可识别已通过成人验证的用户。获取识别值的方法中提供了相关信息。识别信息是一个经过哈希处理的DI值。
更改的功能¶
Authentication¶
- Android iOS Hive 如果您在控制台中配置了使用成人身份验证的应用,则登录后将自动执行成人身份验证过程。
- 此功能仅在韩国可用。
- Android iOS 用于执行成人验证的
showAdultConfirm方法已被弃用。 showAdultConfirm方法可能会在未来的更新中被移除。
已修复的错误¶
Authentication¶
- Windows 修复了由于 家长同意 失败而导致登录失败时登录信息未重置的问题。
- Windows 我们修复了以下问题:使用自定义登录登录后,在游戏中购买了物品,并通过应用商店获得了退款的用户,在使用同一账号重新登录游戏时将无法登录。
- Windows 修复了在
AuthV4.signOut回调函数中调用AuthV4.showSignIn时发生的崩溃问题。
Others¶
- Windows 修复了以下问题:当游戏以管理员权限运行时,通过 Hive SDK 打开外部网络浏览器时,如果 URL 长度超过 800 个字符,则网络浏览器无法正常打开。
v4.25.6.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | - |
| SDK Unity iOS | - |
注意:此 SDK 版本不提供单独的发行文件,该功能包含在 SDK 的更高版本中。
新功能¶
Chat¶
- Android iOS 增加了“点赞”或标记特定聊天消息的功能。
- Android iOS 提供信息,使您可以对特定的聊天消息进行“回复”或指示回复关系。
- Android iOS 可以提及特定用户或提供有关被提及用户的信息。
更改的功能¶
Chat¶
- Android iOS 将 频道消息查找方法 从基于索引的方法更改为基于消息 ID 的方法。
v4.25.5.2¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity iOS | 2025-07-30 |
检查此 SDK 版本的开发环境。
已修复的错误¶
Authentication¶
- iOS 修复了在横屏模式下显示聊天机器人时会导致崩溃的问题。
v4.25.5.1¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Interface | 2025-07-23 |
| SDK Unity Android | 2025-07-23 |
| SDK Unity iOS | - |
| SDK Unity Windows | - |
注意:此 SDK 版本不提供单独的发行文件,该功能包含在 SDK 的更高版本中。
检查此 SDK 版本的开发环境。
新功能¶
Authentication¶
- Android iOS 我们新增了一项名为“多账号切换”的功能。功能详情如下:
- 将当前登录账号保存到设备
- 查看已保存的账号
- 注销并删除已保存的账号
- 使用其他已保存的账号快速登录
Promotion¶
- Android iOS 新增了直接链接功能。
Notification¶
- Android iOS 我们新增了一个推送操作按钮。
- 收到推送通知时,您可以使用推送选择操作按钮执行预定义的操作。
Chat¶
- Android iOS 消息发送
- 新增自动将聊天消息翻译成用户语言的功能,以及翻译特定消息的功能。
- 新增仅接收特定语言用户的通知消息的功能。
- 为 WebSocket 消息添加了消息 ID 值,以确保回调顺序。
- Android iOS 频道
- 新增进入聊天频道时查看历史对话记录的功能。
- 显示频道内当前人数。
- 提供频道列表排序功能。
- Android iOS 事件管理
- 添加了以二进制形式发送自定义数据事件的功能到聊天中。
- Android iOS 连接管理
- 添加了重新连接功能。
Hercules¶
- All 20241120 -> 20250217
- Android 20241125-2 -> 20250527
- iOS 20241120 -> 20250218
更改的功能¶
- Android 更新构建所需的混淆规则。
- iOS 之前单独提供的
HiveAppTrackingTransparents.framework库现在已集成到Service.framework中。
Authentication¶
- Android iOS 修改了
showMyInquiry方法,使其在未使用 Hive 会员帐户时显示查询页面,之前该方法无法正常工作。 - Android 将 VK 身份验证弹出窗口从 WebView 更改为应用内浏览器。
Marketing Attribution¶
- iOS 启用此功能后,将支持自动收集 Firebase 购买事件。
已修复的错误¶
Promotion¶
- iOS 修复了 iPad 设备上“最新动态”用户界面的边角曲率问题。
Provisioning¶
- iOS 修改网页视图,使其在显示条款和条件时不滚动。
Analytics¶
- iOS 修改逻辑,以便在条款协议完成后立即发送分析日志。
已知问题¶
Others¶
- iOS 在横屏模式下使用聊天机器人时,出现错误导致其崩溃。
- 请更新至 Hive SDK Unity iOS 25.5.2 或更高版本。
v4.25.5.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Windows | 2025-07-14 |
检查此 SDK 版本的开发环境。
新功能¶
Authentication¶
- Windows 添加了家长同意功能。
Analytics¶
- Windows 已将
device.platform添加到 Airbridge 日志。其值为“Steam”或“Desktop”。此值也可在 Airbridge 控制面板上实时查看。
更改的功能¶
Others¶
- Windows 改进了与MMP相关的内部逻辑。
已修复的错误¶
Authentication¶
- Windows 使用在多个帐户之间切换时,自动登录后调用注销会导致会话过期并阻止重新登录的问题已得到解决。
Promotion¶
- Windows 修复了在调用 Promotion.updatePromotionData() 后立即打开新闻页面时发生的间歇性崩溃问题。
Others¶
- Windows 修复了在 Hive SDK 中启动新窗口时发生的 NVIDIA 图形驱动程序 572.16 ↔ DirectX 11(Apple 登录、Facebook 登录、PG 支付)之间的兼容性冲突。
v4.25.4.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Windows | 2025-06-26 |
检查此 SDK 版本的开发环境。
新功能¶
Authentication¶
- Windows 我们新增了一项名为“多账号切换”的功能。功能详情如下:
- 将当前登录账号保存到设备
- 查看已保存的账号
- 注销并删除已保存的账号
- 使用其他已保存的账号快速登录
- Windows 当被游戏封禁的用户尝试登录时,应用程序不会再关闭,而是会将其登出。
- Windows RemotePlay 插件中提供了增强的身份验证协议。
Others¶
- Windows 增加了将 Hive SDK 及其依赖项隔离到单独文件夹中的功能(../../dev/overview/prep-build/unity-windows.md)。
已修复的错误¶
Others¶
- Windows 修复了 Hive 函数操作的漏斗日志无法聚合的问题。
v4.25.3.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Windows | - |
注意:此 SDK 版本不提供单独的发行文件,该功能包含在 SDK 的更高版本中。
新功能¶
Promotion¶
- Windows 修改
Promotion.getBannerInfo调用,传递typeCampaign值。 - Windows 我们收集登录事件,以便奖励输入邀请码并安装应用程序的用户。
Others¶
- Windows 增加了在通过 Crossplay Launcher 启动游戏时,查找附加到启动 URI 的启动参数的功能。
- Windows 将 特定 UI 添加到控制器按键映射支持中。
- Windows 当可以通过控制器按钮关闭时,添加 UI 以显示关闭按钮的指导信息。
更改的功能¶
Library updates¶
- Windows 将 Chromium Embedded Framework 库版本替换为 128.45 版本。
已修复的错误¶
Others¶
- Windows 修复了当游戏引擎设置了默认鼠标光标时,关闭网页视图后默认鼠标光标会在 Windows 默认光标和鼠标光标之间交替出现的问题。
- Windows 修复了在 Hive SDK 中传递 HTML 而不是 JSON 作为结果时会发生错误的问题。
- Windows 我们更改了 Steam 市场连接失败错误代码的显示方式。
- 新增错误代码
IAPV4SteamMarketResponseError(-6101001)。 - 错误代码和消息现在以
[IAPv4] Steam 服务器响应错误:(代码:...,消息:...)的格式显示。 - Windows 修复了在 Steam 离线模式下尝试登录 Steam 时不会返回回调的问题。
v4.25.2.2¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2025-06-23 |
检查此 SDK 版本的开发环境。
更改的功能¶
Authentication¶
- Android 由于与 Google 凭据管理器存在不兼容问题,导致部分用户无法访问该网站,我们将身份验证方法回滚到现有的 Google 登录。
Library updates¶
- Android * Google Play 服务身份验证(Android)v20.7.0(重新启用 Google 登录回滚支持)
- Google 凭据 Play 服务身份验证(Android)v1.3.0(移除 Google 登录回滚功能)
v4.25.2.1¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2025-05-14 |
检查此 SDK 版本的开发环境。
已修复的错误¶
Marketing Attribution¶
- Android 修复了在 与 MMP 服务集成 中使用的 Hive SDK 标识符缺少 did 值的错误。
v4.25.2.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2025-04-29 |
| SDK Unity iOS | 2025-04-29 |
| SDK Unity Windows | 2025-05-12 |
检查此 SDK 版本的开发环境。
新功能¶
- Android iOS 支持 Unity 6.1 (6000.1)。
Authentication¶
- Windows 支持 line 作为新的身份验证方法 (IdP)。
Matchmaking¶
- Windows 新功能支持匹配。
Provisioning¶
- Windows 添加对根据帐户公开条款和条件(
agreementDetermineBase)的支持。
更改的功能¶
Authentication¶
- Android iOS 我们更新了 VK 的身份验证方法。更新后的身份验证方法可在新版 VK 开发者控制台中使用。
- iOS 更新了登录 Apple GameCenter 时使用的已弃用的 GameKit API 的验证协议。
- Android 由于 Google 登录库已弃用,我们将改用 Google Credential Manager 和 AuthorizationClient API 进行身份验证,以实现隐式和显式登录。
Billing¶
- Android 如果您要退还使用 PG 付款购买的商品,请添加
order_id值,以便将其与之前的交易区分开来。 - Android Windows 当 PG 支付交易完成后,会通过营销归因发送购买完成日志。
Promotion¶
- Android 分享用户获取策略时,请将其更改为添加到 Telegram 支持的曝光列表中。
- Android 在公开 webview 时更改缓存策略。
Marketing Attribution¶
- Android iOS 发送额外的 Hive SDK 标识符以支持 与 MMP 服务集成。
- Windows 此外,请发送 Hive SDK 标识符以支持营销归因支持。
- All 手动跟踪事件时,通过添加自定义属性来更改要发送的事件。
- Android 改变了 Airbridge 初始化时市场源信息的传输方式。
- iOS 使用 sendEventWithAttributes API 时,
语义值类型的浮点值的精度范围从float更改为double。
Provisioning¶
- All 在以下情况下,“条款与条件详情”和“回放”页面将改为在新浏览器窗口中打开,而不是加载“条款与条件”页面(网页视图):
- 当跳转到“条款与条件”网址以外的网页时
- 当点击“条款与条件”页面内的超链接 HTML 标签(例如,“a”标签、“tel://”)时
Library updates¶
- Android Airbridge(Android)v4.1.0 → v4.3.0
- Adjust(Android)v5.0.1 → v5.2.0
- Singular(Android)v12.6.1 → v12.7.0
- AppsFlyer(Android)v6.15.2 → v6.16.2
- Google Play 服务授权(Android)v20.7.0(已停止支持)
- Google 凭据 Play 服务授权(Android)v1.3.0(新增支持)
- iOS 空桥 (iOS) v4.1.1 → v4.3.0
- 调整(iOS) v5.0.1 → v5.2.0
- 单数 (iOS) v12.6.1 → v12.7.1
- AppsFlyer (iOS) v6.15.3 → v6.16.1
- QQ (iOS) 3.5.17.3 → 3.5.17.4
Chat¶
- Android iOS 发送或接收消息数据时,额外发送和接收“extraData”。
- Android iOS 连接到聊天服务器时,不再发送
extraData。 - Android iOS 此外,它接收的是整数时间值,而不是字符串时间值。
- Android iOS 当在网络阻塞等通信不可能的情况下,尝试在未正确断开 websocket 连接的情况下重新连接时,问题变为不会因重复连接而失败。
已修复的错误¶
- Android 在需要通过网络重试通信或连接到分布式服务器的情况下,如果在配置的最大超时时间到期之前收到响应,则修改通信重试或连接到分布式服务器的操作,不再等待超时,而是立即重试通信或连接到分布式服务器。
- iOS 修复了当使用 Configuration 类的
setZone方法更改连接到 Hive SDK 的服务器组 Zone 时,hive_config.xml 文件中的gameLanguage值初始化时出现的错误。
Authentication¶
- iOS 修复了在运行 iOS 18 或更高版本的设备上 QQ 网页版登录无法正常工作的问题。
- Windows 修复了使用 Hive SDK webview 进行通信时,用于增强安全协议的 JWT 令牌无法传递的问题。
Billing¶
- Windows 修复了在嵌套多个 Hive SDK 方法回调时调用以下方法之一会导致应用程序冻结的问题:
IAPV4.transactionFinishIAPV4.transactionMultiFinishIAPV4.restore
Marketing Attribution¶
- Android 修复了在使用 Adjust 功能来确定是否已完成安装时,推送通知没有内容的问题。
- Android 当使用 Airbridge 购买多个商品时,销售信息会根据单价和数量进行修改并传输。
Provisioning¶
- Android iOS 在初始化 SDK 之前初始化广告模块 (Adiz) 时,如果需要符合 COPPA 或 GDPR 等法规,则检查年龄的
AgeGate值固定为使用 hive_config.xml 中设置的值。
Chat¶
- Android 修复了聊天连接偶尔会失败的问题。
已知问题¶
Marketing Attribution¶
- Android 在与 MMP 服务集成时,使用的 Hive SDK 标识符存在错误,缺少 did 值。请使用已修复此问题的 SDK v4 Unity Android & iOS 25.2.1。
v4.25.1.3¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2025-04-10 |
| SDK Unity iOS | 2025-04-10 |
检查此 SDK 版本的开发环境。
更改的功能¶
Billing¶
- Android 更改 PG 支付的工作方式,使其与计费 (
IAPv4) 功能中其他市场的行为保持一致。如果您正在使用 PG 支付,则应参考 PG 支付 文档来修改您的代码实现。
Marketing Attribution¶
- iOS 新增对 Airbridge 延迟深度链接跟踪 的支持
已修复的错误¶
Billing¶
- iOS 修复了在显示询问是否同意传输消费信息的弹出式用户界面时背景不透明的错误。
- iOS 修复了关闭询问是否同意传输消费信息的弹出式用户界面时,应用程序屏幕方向会朝非预期方向旋转的问题。
Promotion¶
- iOS 修复了在显示包含图像的审核弹出窗口时,发生旋转事件会导致正在显示的图像消失的问题。
Marketing Attribution¶
- iOS 修复了 Airbridge 在通过 Adiz 发送广告收入信息时,会将广告收入信息发送给 AdMob 而不是 Adiz 的错误。
v4.25.1.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Windows | 2025-04-03 |
检查此 SDK 版本的开发环境。
新功能¶
Authentication¶
- Windows 我们现在支持 Telegram 作为新的身份验证方法(身份提供商)。请参阅设置 Telegram 登录机器人。
- Windows 新增支持 X(以前称为 Twitter)作为身份验证方法。
- Windows 提供共享已验证会话的网页浏览功能。
Others¶
- Windows 我们提供了
Configuration.setUsePrivateBrowsingForAuth函数,允许您设置登录 Google 时是否使用隐身模式。 - 我们还在
hive_config.xml文件中提供了设置。 - Windows 提供
PlatformHelper.openBrowser函数 允许您使用 URL 打开浏览器。
更改的功能¶
Billing¶
- Windows 更改 PG 支付的工作方式,使其与计费 (
IAPv4) 功能中其他市场的行为保持一致。如果您正在使用 PG 支付,则应参考 PG 支付 文档来修改您的代码实现。
Promotion¶
- Windows 修改发送给
additionalInfo的值,使其不包含不必要的信息。
Development Environment¶
- Windows 将所需的最低 Microsoft Visual C++ Redistributable 版本更新至 14.42.34438。
已修复的错误¶
Authentication¶
- Windows 修复了当用户选择 Hive Membership 以外的登录方式并取消登录后,使用 Hive SDK 控制器进行鼠标操作将无法正常工作的问题。
v4.25.0.1¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity iOS | 2025-03-10 |
| SDK Unity Windows | 2025-03-11 |
检查此 SDK 版本的开发环境。
新功能¶
Marketing Attribution¶
- iOS 当使用 Hive SDK v4 25.0.0 或更高版本并应用 Adjust v5 时,修复了 SDK 自动收集和传输的 did 和 vid 值未传输的错误。
更改的功能¶
Development Environment¶
- Windows 将所需的最低 Microsoft Visual C++ Redistributable 版本更新至 14.38.33130。
已修复的错误¶
Billing¶
- Windows 修复了在使用 JWT 令牌的增强型安全协议时,退款用户付款信息未公开的问题。
v4.25.0.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2025-01-24 |
| SDK Unity iOS | 2025-01-24 |
| SDK Unity Windows | 2025-02-20 |
检查此 SDK 版本的开发环境。
新功能¶
Authentication¶
- Android iOS 我们现在支持 Telegram 作为新的身份验证方法(身份提供商)。请参阅设置 Telegram 登录机器人。
Billing¶
- iOS 支持询问用户是否同意将应用内产品消费信息发送至 Apple App Store 的功能。
Promotion¶
- Android iOS 我们收集登录事件,以便奖励输入邀请码并安装应用程序的用户。
Matchmaking¶
- Android iOS 匹配功能已更新,支持新的群组匹配功能。 ※ 此功能与 Hive SDK 接口的旧版本不兼容。要使用更新后的匹配功能,您必须使用 Hive SDK v4 25.0.0 或更高版本。
Marketing Attribution¶
- All 我们在发送营销跟踪事件时,增加了对 向 Airbridge 发送附加属性 的支持。
- Android 新增对 Airbridge 延迟深度链接跟踪 的支持
Others¶
- Windows 支持在带有触摸屏的手持设备上使用触摸手势,例如 ASUS ROG Ally。
- Windows 使用游戏控制器时,新增了对控制器按键映射的支持,允许您集中注意力并操作一些Hive UI元素。
- Windows 新增对应用自定义光标而非标准鼠标光标的支持
- Windows 新增了启用或禁用游戏控制器控制的设置。
Chat¶
- Android iOS 现在支持聊天功能。
更改的功能¶
Authentication¶
- Android iOS 删除未使用的
Auth模块类和接口、方法、委托和监听器。 - All 使用 JWT 令牌实施更强大的安全协议。
- Android iOS 由于我们停止对 TalkPlus 的支持,我们将弃用 TalkPlus 身份验证令牌方法。
- Android Apple 登录网页视图除了提供登录功能外,还允许浏览网页,例如查找密码。
Promotion¶
- Windows 在“最新动态”菜单选项卡中新增了内容通知显示。
Marketing Attribution¶
- Android iOS 已更新以支持 Adjust v5。
- 移除 Adjust Signature 库。
- Android iOS 使用 Adjust 聚合 Adiz 广告收入时,将 Adiz 广告收入聚合来源更改为 AdMob。
- Android 这反映了 Appsflyer 广告收入聚合库已集成到主库中。
- 6.14.2 → 6.15.2
- 移除了 Appsflyer 广告收入库。
Unity¶
- All 改进了 Hive 配置设置界面。
Hercules¶
- All 2024年11月20日
已修复的错误¶
Authentication¶
- Android 解决了在执行
signIn方法期间出现网络响应延迟时 UI 线程间歇性被占用的问题。 - Windows 修复了处于退款用户付款状态的用户登录其电脑时发生的“CommonUnknown”错误。
- Windows 改进了用户界面,防止在拖动“保持登录状态”文本时出现“隐私警告”文本。
Billing¶
- iOS 修复了当使用 UserEngagement 诱导应用内产品购买时,会额外触发
IAP_UPDATE事件的错误。 - Windows 修复了在 Steam 购买过程中使用 ESC 键或其他组合键关闭叠加层会导致购买无法继续的问题。
Others¶
- Windows 优化循环迭代条件,使 CPU 使用率恢复正常。 ※ 如果您使用的是受影响的版本(4.24.1.0 或更高版本),请更新至 SDK v4 Unity Windows 25.0.0,并查看 CPU 使用率是否稳定。
已知问题¶
Marketing Attribution¶
- iOS 如果您正在使用 Adjust 功能,则会出现一个错误,即 SDK 自动收集和传输的 did 和 vid 值未发送。您需要将 Hive SDK 更新到 v4 25.0.1 或更高版本。
v4.24.5.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2024-11-08 |
| SDK Unity iOS | 2024-11-08 |
| SDK Unity Windows | 2024-12-10 |
检查此 SDK 版本的开发环境。
新功能¶
- Android iOS 支持 Unity 6 (Unity 6000)。
- Windows 添加了与 Hive SDK v4 Unity Android & iOS 24.5.0 接口的兼容性更新。
Authentication¶
- Android iOS 新增对 Steam 和 X(原 Twitter)作为身份验证方式的支持。
- Prep: Common
- Prep: Android
- Prep: iOS
- 品牌指南
- Android 提供共享已验证会话的网页浏览功能。
Promotion¶
- Android iOS 您还可以在Spot Banner中展示广告。
- Android 支持 X(原 Twitter)的用户邀请分享功能。
Matchmaking¶
- Android iOS 新功能支持匹配服务。
更改的功能¶
Authentication¶
- Android iOS 修复冲突弹出窗口中显示的提供商名称。
Plugins¶
- Android iOS 请使用提供的最新版本 EDM4U。* 1.2.178 → 1.2.183
- iOS 如果您使用 Game Center 登录,请将其更改为自动将所需的授权设置添加到构建中。
- 以前,即使您使用 Game Center 登录,也必须额外配置功能管理器。
- 如果缺少授权设置,运行 iOS 18 或更高版本的设备将无法正常登录。
已修复的错误¶
Billing¶
- iOS 当某些产品价格无法精确地用浮点数表示时,请修改 JSON 格式,将这些值表示为精确的小数位,而不是循环小数。
- 例如:
4.99$(字符串)→4.9900000000000011(双精度浮点数)→4.99(JSON 数字)
Plugins¶
- All 使用显式命名空间可以避免接口重复,从而防止某些外部插件出现编译错误。
- Android 修复了在使用 Firebase 营销跟踪工具或华为身份验证功能时,Android 目标平台上缺少必需设置的问题(在 SDK v4 24.3.0 及更高版本中出现)。
v4.24.4.2¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Windows | - |
注意:此 SDK 版本不提供单独的发行文件,该功能包含在 SDK 的更高版本中。
更改的功能¶
- Windows 移除了用户界面中未使用的不必要资源。
v4.24.4.1¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Windows | 2024-12-03 |
检查此 SDK 版本的开发环境。
新功能¶
Remote Play¶
- Windows Hive SDK Unity Windows v4.24.4.1 及更高版本支持 远程播放。
更改的功能¶
Authentication¶
- Windows 我们对 IdP 选择界面进行了更改,以便更清楚地显示您是否要选择“保持登录状态”界面。
- Windows 身份提供商 (IdP) 选择界面的英文翻译已更新。
- 更新前:保持登录状态
- 更新后:保持登录状态
v4.24.4.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2024-10-14 |
| SDK Unity iOS | 2024-10-14 |
| SDK Unity Windows | 2024-11-15 |
检查此 SDK 版本的开发环境。
新功能¶
Billing¶
- Android Windows 请求 PG 付款时,我们支持使用
IAPv4.purchase进行多件购买。
Marketing Attribution¶
- Android iOS 支持将 Airbridge 作为 Hive SDK 的一项特定服务。
- 使用 Airbridge 自动跟踪事件
- 使用 Airbridge 手动跟踪事件
Remote Execution¶
- Windows 支持 Crossplay Launcher Remote Launch。
更改的功能¶
Plugins¶
- Android iOS 更改了自动设置 Android 上的 Package Name 或 iOS 上的 Bundle Name 的功能,使其可以通过 Hive AppId 选择性地工作。
已修复的错误¶
Analytics¶
- iOS 修复了仅选择一个选项时,同意横幅选项显示不正确的错误。
v4.24.3.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2024-09-03 |
| SDK Unity iOS | 2024-09-03 |
| SDK Unity Windows | 2024-10-14 |
检查此 SDK 版本的开发环境。
新功能¶
Marketing Attribution¶
- Windows Appsflyer 1.0.1 警告 Appsflyer(仅限 Steam 平台)1.0.1 版本已发布。从 Hive SDK v4 24.0.0 或更高版本开始,仅支持 Appsflyer 1.0.1 或更高版本进行营销归因分析。
Provisioning¶
- All 在“条款和条件”屏幕上增加了检查是否已获得法定代表人同意的功能。
更改的功能¶
Authentication¶
- Android iOS 更改了注销行为。
- 之前:调用
<code>signOut</code>时,Hive SDK 会注销用户帐户。 调用signOutAPI 时,访客会收到来自服务器的失败响应。 - 更改后:调用
<code>signOut</code>时,Hive SDK 会向 Hive 服务器询问是否可以注销用户帐户,然后根据服务器响应注销用户。 - Android iOS 注销访客帐户 不再返回成功响应,而是返回错误代码。访客帐户会话在 Hive SDK 和 Hive 服务器中均有维护。
- Android iOS 被暂停的账户会自动从身份提供商 (IdP) 注销,可以使用同一身份提供商的其他账户重新登录。但前提是无法自动登录。
- Android iOS 使用
AuthV4.connect方法连接到 IdP 时,将其更改为在切换到已暂停的帐户时注销。 - All 更改设备管理服务,使其根据设备接入区域自动应用国际长途国家代码。
- iOS 我们正在进行一些更改,以便即使您拒绝应用跟踪透明度 (ATT) 同意,您仍然可以登录 Facebook。
- Windows 在完成成人验证后注册设备管理服务时,如果一个手机号码可注册的账号数量超过限制,则会显示错误消息:“同一个手机号码可注册的账号数量已超过限制”。
Promotion¶
- Android iOS 修改发送给
additionalInfo的值,避免包含不必要的信息。 - All 更改以允许以 2:3 或 3:2 比例显示全屏横幅。
- Android iOS 将首页横幅上的文字“停止观看 1 天”改为“立即停止观看”。
Marketing Attribution¶
- Android iOS 调整签名 将版本从
v1更改为v3。
Plugins¶
- Android iOS 尽量减少 Hive 外部依赖项管理器管理的 XML 文件数量。
Library updates¶
- Android Google Play结算库 6.1 → 7.0 Google Play服务游戏 20.0.0 → 20.1.2
- iOS Facebook SDK 16.2.1 → 17.0.2
已修复的错误¶
- Android 修复了通过修改资源引用逻辑而阻止内存释放的错误。
- iOS 修复了在 iOS 14 设备上确认应用跟踪透明度 (ATT) 同意时导致间歇性崩溃的问题。
- iOS 修复了在照片库中选择“限制访问”(仅允许访问某些照片)时会导致崩溃的错误。
Notification¶
- Android 修复了当设置 本地推送通知 不支持的
type时推送消息显示不正确的错误。 - iOS 修改以发送应用版本信息。
v4.24.2.1¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Windows | - |
注意:此 SDK 版本不提供单独的发行文件,该功能包含在 SDK 的更高版本中。
新功能¶
Community¶
- Windows 将遵循 Hive 约定的社区更改为使用 自定义域名地址 而不是 withhive.com, com2us.com。
v4.24.1.3¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | - |
| SDK Unity iOS | - |
注意:此 SDK 版本不提供单独的发行文件,该功能包含在 SDK 的更高版本中。
更改的功能¶
Authentication¶
- Android iOS 更改设备管理服务,使其根据设备接入区域自动应用国际长途国家代码。
v4.24.2.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2024-07-05 |
| SDK Unity iOS | 2024-07-05 |
| SDK Unity Windows | 2024-06-26 |
检查此 SDK 版本的开发环境。
新功能¶
- Android iOS 在适用 GDPR 的欧盟和欧洲经济区,我们提供了一个函数,返回 未满 16 周岁的用户是否已同意条款和条件。您可以检查用户是否未满 16 周岁。
- Android 在运行 Android OS 11 或更高版本的设备或安装了支持模块的设备上使用照片库时,默认使用 PhotoPicker。
- iOS 您还可以在 macOS 控制台应用程序中查看 Hive SDK 调试日志,并选择要查看的 Hive SDK 日志中的特定日志类型。
- All 能够控制在 Unity 编辑器中显示 Hive SDK 调试日志。
Authentication¶
- All 当您使用一个手机号码创建的账户数量超过限制时,请求验证码时将显示错误消息:“使用同一个手机号码创建的账户数量已超过限制”。
- Windows 支持Steam IdP隐式登录。使用
AuthV4.Helper.signIn。
Promotion¶
- Android iOS 提供控制交叉推广展示效果的功能。
- Android iOS 今天,我们推出了一项改进的插页式横幅广告功能,名为N 天插页式横幅广告。
更改的功能¶
Authentication¶
- Windows 更改了登录 Google 时不检查 Google Play Games 信息的权限,
games_lite。
Promotion¶
- iOS 我们通过最小化使用游戏邀请(用户代理)功能时剪贴板粘贴权限弹出窗口的显示,提升了用户体验。
- 权限同意弹出窗口的显示时间已从受邀用户启动应用后立即显示,更改为在应用启动后 Hive SDK 初始化完成后显示。
- 现在,仅当邀请者的 URL 数据存在于剪贴板中时,才会显示此弹出窗口。
Notification¶
- Android 支持在新亚马逊 Fire 设备上运行的运行时库(Push Amazon Device Message 1.2.0)。
Library updates¶
- Android 三星 Galaxy 应用商店 IAP 版本 6.1 → 6.1.1 亚马逊设备消息版本 1.0.1 → 1.2.0
Analytics¶
- iOS 将
saveAnalyticsLogBeforeCrash设置的默认值(该设置用于在应用程序崩溃时将未发送的日志保存到文件中)更改为false。
已修复的错误¶
Authentication¶
- Android iOS 对于从中国访问的用户,在进行实名认证过程中,如果发送的短信数量超过限制,则会显示错误消息,而不是重置剩余时间。
- Android 修复了用户在 Google Play 登录过程中按下返回键不登录时,没有正确响应回调的问题。
- Android 修复了在低分辨率设备上无法进行键盘输入的问题。
- Windows 我们修复了在设备管理服务身份验证的手机身份验证屏幕上,点击“返回上一页”后,如果出现错误弹出窗口,则无法返回上一屏幕的问题。
- Windows 我们修复了手机设备管理服务身份验证屏幕上的身份验证号码输入字段被激活,并且使用鼠标滚轮向该字段输入值的问题。
- Windows 修复了在嵌套回调中调用
AuthV4.Helper.switchAccount、AuthV4.Helper.resolveConflict时无法传递 Hive SDK 回调的问题。 - Windows 修复了在
AuthV4.Helper.switchAccount、AuthV4.Helper.resolveConflict中传递PlayerInfoUnity 插件参数时无法正常工作的问题。
Promotion¶
- iOS 修复了在新闻视图中显示新框架视图时导致画面冻结的错误。
- Windows 修复了从“促销自定义直接全屏”切换到“框架”时发生的崩溃问题。
Marketing Attribution¶
- Android 修复了使用自定义条款初始化时 Adjust 事件分发延迟的问题。
Provisioning¶
- Windows 在审核条款和条件时,我们修改了系统,使其使用 Hive 服务器新提供的条款和条件 URL 数据,而不是之前保存的数据。
v4.24.1.2¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2024-06-27 |
检查此 SDK 版本的开发环境。
已修复的错误¶
Authentication¶
- Android 修复了在登录过程中按返回按钮取消 Google 登录时,未收到正确响应回调的问题。此错误仅在 Hive 控制台中的“Google 旧版支持”值设置为“true”时才会出现。
- Android 修复了低分辨率设备上无法进行键盘输入的问题。
v4.24.1.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity iOS | 2024-05-14 |
| SDK Unity Windows | 2024-05-30 |
检查此 SDK 版本的开发环境。
更改的功能¶
- Windows 支持通过 Hive SDK 实现的 UI 中的游戏控制器进行鼠标移动。
Library updates¶
- iOS AppsFlyer(iOS) v6.13.1 → v6.14.3 QQ (iOS) v3.5.14 → v3.5.16 Facebook SDK v17.0.0 → v16.2.1
Analytics¶
- iOS 我们将根据设备是否同意跟踪来决定是否显示同意横幅。
- 如果拒绝跟踪同意,则不会显示同意横幅。
已修复的错误¶
Billing¶
- iOS 修复了从低于 v4 24.0.0 的 Hive SDK 版本(例如 v4 23.4.0)更新到 v4 24.0.0 时产品搜索失败的错误。
v4.24.0.0¶
| 按目标操作系统的 SDK | 发布日期 |
|---|---|
| SDK Unity Android | 2024-04-30 |
| SDK Unity iOS | 2024-04-30 |
| SDK Unity Windows | 2024-05-22 |
检查此 SDK 版本的开发环境。
新功能¶
- Windows 添加了在游戏服务结束后尝试初始化 Hive SDK 时返回 错误代码 的功能。
Authentication¶
- Windows 已添加 通过 Hive Community 登录自动登录 PC 游戏 功能。
Billing¶
- iOS 如果存在首次订阅折扣信息,则会在检索产品信息时一并传递。您可以通过查找在使用
getProductInfo回调函数时收到的IAPV4Product对象列表中的original_price字段和price字段之间的差值来检查折扣信息。
Promotion¶
- Android Chrome 支持自定义标签页,它使用设备的默认浏览器来显示外部页面。您可以使用
PlatformHelper类的showInAppBrowser方法来显示应用内浏览器。 - iOS 支持SafariViewController,它使用浏览器来显示外部页面。您可以使用
PlatformHelper类的showInAppBrowser方法来显示应用内浏览器。
更改的功能¶
- iOS 区分应用版本时,还可以使用
CFBundleShortVersionString。 - Windows HIVE SDK 的 UI 和 webview 已更改为根据 DPI 设置而不是显示器分辨率进行显示。
Authentication¶
- Windows 现在登录 Google 时,您可以使用 Windows 默认浏览器的“隐身模式”。受影响的浏览器包括:
- Google Chrome
- Microsoft Edge
- Mozilla Firefox
- Naver Whale
- Windows 如果您使用除上述浏览器以外的网络浏览器登录,请使用“普通模式”登录。
Billing¶
- Android iOS 退款用户付款界面中显示的 PG 付款类型已从“HiveStore”更改为“PG 付款”。
- Android 将 PG 支付页面的显示方式从应用内浏览器改为应用内 WebView。这样即使在不支持应用内浏览器环境的设备上,也能支持 PG 支付。
Library updates¶
- Android Google Play 服务 - 游戏 v2(Android)v19.0.0 → 20.0.0
- Facebook SDK Android v16.2.0 → 17.0.0
- LINE(Android)v5.9.1 → 5.10.0
- iOS 微信 2.0.2 → 2.0.4
- Hercules 2024.01.23 → 2024.04.11
- Singular 12.3.2 → 12.4.1
- Windows 蒸汽机车 1.55 → 1.59
Analytics¶
- Android 将 Firebase 事件收集功能中广告标识符收集设置的默认值更改为
true。
已修复的错误¶
Authentication¶
- Windows 修复了在中文实名认证过程中,认证时间到期后仍可输入认证号码的错误。
- Windows 修复了某些网页(例如 Apple 登录)仅以英文显示的问题。
- Windows 修复了在嵌套回调函数中调用
IAPv4 getSubscriptionProductInfo时无法传递 SDK 回调的错误。 - Windows 我们修复了如果未收到 Google 发送的个人资料照片则无法登录 Google 的问题。(我们也修复了即使未收到个人资料照片也能登录的问题。)
Billing¶
- Windows 修复了退款用户付款界面中 PG 付款显示为 Hive Store 的错误。
- Windows 修改了退款用户付款界面的阿拉伯语屏幕,使其使用更适合阿拉伯语的界面。
Promotion¶
- Windows 修复了
getBannerInfo和getBannerInfoString函数无法正常工作的错误。 - Windows 修复了推广 API,使其可以独立于 AuthV4 身份验证运行。
Others¶
- Windows 修复了在执行输入事件(例如点击特定大小的窗口)时用户界面会闪烁的问题。
已知问题¶
Authentication¶
- iOS 使用适用于 iOS 17.0.0 的 Facebook SDK 时,如果用户未同意“应用跟踪透明度”,则无法在运行 iOS 17.0 或更高版本的设备上登录。要在此条件下实现 Facebook 登录,请使用 Hive SDK v4 24.1.0。