SDK Unreal Engine 4 发布说明¶

本指南介绍 Hive SDK Unreal Engine 4 各版本的主要更新。

Hive SDK Unreal Engine 4 各目标操作系统的更新通过以下操作系统标签区分。

• Android SDK Unreal Engine 4 Android 更新
• iOS SDK Unreal Engine 4 iOS 更新
• Windows SDK Unreal Engine 4 Windows 更新
• 全部 SDK Unreal Engine 4 Android、iOS 和 Windows 更新

必需项¶

使用 Hive SDK 各发布版本之前，我们指导您进行与版本特定限制相关的必需设置。

• 使用 Hive SDK v4 Unreal Engine 4 25.0.0 或更高版本时，必须获取安全密钥（../../operation/appcenter/securitykey_settings.md）。
  • 由于身份验证安全协议的变更，使用 Hive SDK v4 Unreal Engine 4 25.0.0 或更高版本时，您必须从Hive 控制台 > 安全密钥设置获取安全密钥（../../operation/appcenter/securitykey_settings.md）。如果您未获取安全密钥，则将无法登录应用程序。
• Hive SDK v4 Unreal Engine 4 25.1.3 或更高版本需要对 PG 支付实现进行更改
  • 要在 Android 和 iOS 25.1.3 或更高版本，或 Windows 25.1.0 或更高版本上实现 PG 支付，您必须参考 PG 支付操作流程 修改 PG 支付实现代码。
• 在**Hive SDK v4 Unreal Engine 4 Windows 25.8.1**中，点击推广插页式广告横幅时，链接无法正确跳转。要解决此问题，您必须使用以下方法替换插页式广告横幅的 HTML 文件。
  1. 下载并解压包含修改后 HTML 文件的 zip 文件。
  2. 复制整个文件夹，并覆盖 Plugins/HIVESDK/Source/HiveSDKWindows/assets/additional 目录下的现有文件。
  3. 重新构建应用程序。

v4.26.1.5¶

已修复的错误¶

• iOS 修复了在 iOS 26.4 环境下使用 WebView 的弹出窗口（登录、横幅、客户服务、社区等）无法正常工作的错误。

v4.26.0.2¶

已修复的错误¶

• iOS 修复了在 iOS 26.4 环境下使用 WebView 的弹出窗口（登录、横幅、客户服务、社区等）无法正常工作的错误。

v4.25.9.1¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

已修复的错误¶

• iOS 修复了在 iOS 26.4 环境下使用 WebView 的弹出窗口（登录、横幅、客户服务、社区等）无法正常工作的错误。

v4.25.8.3¶

已修复的错误¶

• iOS 修复了在 iOS 26.4 环境下使用 WebView 的弹出窗口（登录、横幅、客户服务、社区等）无法正常工作的错误。

v4.26.1.4¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

更改的功能¶

Authentication¶

• Android 已将使用凭据管理器登录 Google 的功能更改为“选择加入”。
• 更改原因：在某些支持 16 KB 页面大小的 Android 16（API 级别 36）设备上，通过凭据管理器登录 Google 存在兼容性问题。
• 主要更改：已将 Google 登录方式恢复为现有的 Google 登录方式。
• 未来计划：未来版本的 Hive SDK Android 将提供一个 API，用于将“使用凭据管理器登录”设置为默认登录方式。

v4.26.1.3¶

已修复的错误¶

Authentication¶

• iOS 修复了在 iPad 设备上，触摸 AgeGate 弹出窗口（需要输入出生日期信息）或日历相关弹出窗口中的空白区域时，应用程序会冻结（无响应）的错误。
• iOS 修复了在 iOS 设备上运行设备管理服务时，某些弹出窗口中显示不必要的滚动条的错误。

Billing¶

• iOS 修复了调用 getAccountUUID 方法时返回值发生变化的错误。

Promotion¶

• Android 修复了当游戏应用在后台运行时，如果发生用户互动（UE）直接链接事件，促销弹窗就会消失的错误。

Marketing Attribution¶

• iOS 修复了在分辨率低于 1170px 的 iOS 设备上无法显示《数字市场法》(DMA) 同意横幅的部分文本的错误。

v4.26.1.2¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

更改的功能¶

Authentication¶

• Android iOS 如果您在登录中国区HYIVE会员账户时已验证过手机号码，我们将更改流程，以便您在进行中国实名验证时直接进行身份验证，无需再次验证手机号码。
• 由于现有的HYIVE会员登录流程仅验证您的会员ID（邮箱地址），而不验证您的手机号码，因此您必须在后续的中国实名验证步骤中验证您的手机号码。

已修复的错误¶

• iOS 修复了由于在 Apple 提交过程中包含了错误生成的捆绑文件 Info.plist 而导致分发版本验证失败的错误。
• iOS 修复了退款用户重新付款界面中 PG 付款显示为 Hive Store 的错误。

v4.26.1.0¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

检查此 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 支持使用小米账号登录。

Billing¶

• Android 它支持使用小米计费。

Promotion¶

• All 它支持延迟深度链接，即使应用安装完成，点击直接链接后，尚未安装应用的用户也会被重定向到链接中指定的应用内页面。

Marketing Attribution¶

• Windows 我们正在推出 Appsflyer for Native PC，它可以在 Steam 以外的桌面 PC 环境中传输必要的信息。
• Windows 从 Airbridge 1.1.4 版本开始，新增了一项功能（延迟传输），用于在用户登录后将安装事件日志发送到 MMP 服务器。通过在登录后发送安装事件日志，游戏公司可以将包括玩家 ID 在内的账号信息传输到 MMP 服务器。

Remote Play¶

• Windows 从 Remote Play 插件 1.01.02 或更高版本开始，在 Remote Play 运行时点击外部链接即可在远程设备上打开页面。因此，即使在 Remote Play 期间也可以进行 PG 支付。

Add-ons¶

• Android 在游戏内 WebView 中打开 提供了一个选项，可以在使用 PlatformHelper 类的 showInWebView 方法公开 WebView 时使用游戏 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 在 SteamDeck 中使用身份验证功能时，会添加一个关于 Pass 不支持的通知弹窗。
• Android 更改设置，以便在使用 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¶

• Android iOS 在 HiveConfig 设置菜单中添加保存按钮。

Provisioning¶

• Windows 将服务器维护、更新、通知和阻止弹出窗口中单击按钮时的终止方法更改为终止回调传递方法。
• 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 修复了在某些环境下应用程序无法正常关闭的问题。
• Windows 我们修复了一个问题，即当在内部方案（例如 interwork://）中以非键值格式（例如 ?831020）输入查询值时，查询值会被错误地传递为 831020=，从而将 831020 按原样传递。
• Windows 修复了在使用 Remote Play 等插件时，Configuration.setZone 设置的区域未反映出来的问题。

v4.26.0.1¶

更改的功能¶

• 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 的更高版本中。

新功能¶

• iOS 您可以在 iOS Xcode 26.2 或更高版本上构建 Hive SDK。
• 最低支持的操作系统版本为 iOS 15。

Provisioning¶

• Android 合规性 是一项新功能。
• 当向 Google Play 和 Amazon Appstore 分发游戏应用时，Hive SDK 提供 年龄范围 API 来检查用户年龄范围，以符合将于 2026 年 1 月 1 日在美国德克萨斯州生效的《应用商店责任法案》。
• iOS 新增合规性功能。
• 将游戏应用分发到 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 的更高版本中。

已修复的错误¶

Payment¶

• Windows 修复了当 Google Play Games PC 结算中注册的产品数量超过 20 个时，无法检索所有产品信息的问题。

v4.25.8.1¶

检查此 SDK 版本的开发环境。

已修复的错误¶

Others¶

• Windows 修复了更改游戏语言后，关闭指南界面仍以初始设置的语言显示的问题。

Chat¶

• Windows 修复了韩语消息未调用回调函数的错误。

v4.25.9.0¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

新功能¶

Authentication¶

• All 已提供身份验证服务（../../dev/authv4/verification.md）。
• SteamDeck 不提供身份验证服务（身份验证、年龄验证、家长同意）。您必须在移动设备或电脑上使用身份验证服务，然后通过 SteamDeck 再次访问游戏。

已修复的错误¶

Others¶

• Windows 修复了更改游戏语言后，关闭通知界面仍以初始设置的语言显示的问题。

v4.25.7.1¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

已修复的错误¶

Others¶

• Windows 通过应用 DX12 渲染器 GPU 同步，渲染稳定性得到了提升。
• Windows 修复了促销新闻中关闭按钮间歇性无法工作的问题。

v4.25.8.0¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

检查此 SDK 版本的开发环境。

新功能¶

• 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 方法时，如果缺少必需的输入数据，则会发生崩溃。

Analytics¶

• Android 修改为防止在同时发生客户端传输故障时重新传输不必要的信息。

v4.25.7.0¶

注意：此 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 的更高版本中。

新功能¶

Chat¶

• Android iOS 新增一项功能，允许您表达或标记“喜欢”特定的聊天消息。
• Android iOS 它提供的信息允许您对特定的聊天消息进行“回复”，或指示回复连接关系。
• Android iOS 它提供了提及特定用户或提供有关提及用户的信息的功能。

更改的功能¶

Chat¶

• Android iOS 将 频道消息查找方法 从基于索引的查找更改为基于消息 ID 的查找。

v4.25.5.2¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

已修复的错误¶

Authentication¶

• iOS 修复了在横屏模式下显示聊天机器人时发生的崩溃错误。

v4.25.5.1¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

新功能¶

Authentication¶

• Android iOS 我们新增了【多账号切换】功能。相关功能详情如下：
• 将当前登录账号保存到设备
• 查看已保存的账号
• 注销并删除已保存的账号
• 快速登录其他已保存的账号

Promotion¶

• Android iOS 添加 直接链接功能 作为新功能。

Notification¶

• Android iOS 新增了一个推送操作按钮。
• 当收到推送通知时，您可以通过推送选择操作按钮执行预定义的操作。

Chat¶

• Android iOS 发送消息
• 新增自动将聊天消息翻译成用户语言以及翻译特定消息的功能。
• 新增仅供特定语言用户接收的公告消息功能。
• 为 WebSocket 消息添加消息 ID 值，以确保回调顺序。
• Android iOS 频道
• 新增进入聊天频道时查看历史对话记录的功能。
• 显示当前频道参与人数。
• 提供频道列表排序功能。
• Android iOS 事件管理
• 添加聊天以二进制形式发送自定义数据事件的功能。
• Android iOS 连接管理
• 添加了重新连接功能。

Hercules¶

• 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 版本的开发环境。

新功能¶

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 的更高版本中。

新功能¶

Authentication¶

• Windows 我们新增了【多账号切换】功能。相关功能详情如下：
• 将当前登录账号保存到设备
• 查看已保存的账号
• 注销并删除已保存的账号
• 快速登录其他已保存的账号
• Windows 如果游戏访问权限已被暂停的用户尝试登录，请更改设置，使其仅退出应用程序而不关闭应用程序。
• Windows 远程播放插件中提供了增强的身份验证协议。

已修复的错误¶

Others¶

• Windows 修复了 Hive 函数操作的非聚合漏斗日志问题。

v4.25.3.0¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

新功能¶

Promotion¶

• Windows 修改对 Promotion.getBannerInfo 的调用，传递 typeCampaign 值。
• Windows 收集登录事件，以便在输入邀请码的用户安装应用程序时提供奖励（../../operation/promotion/ua.md/#_7）。

Others¶

• Windows 通过跨平台启动器启动游戏时，向附加到启动 URI 的 查询启动参数 添加一个功能。
• Windows 将 特定 UI 添加到控制器按键映射支持目标。
• Windows 添加用户界面，以便在可以通过控制器按钮关闭时显示关闭按钮的指导信息。

更改的功能¶

Library updates¶

• Windows 将 Chromium Embedded Framework 库版本替换为 128.45 版本。

已修复的错误¶

Others¶

• Windows 修复了在 WebView 关闭后使用鼠标时，如果游戏引擎中设置了默认鼠标光标，则默认 Windows 光标会与默认鼠标光标交替出现的问题。
• Windows 修复了在 Hive SDK 中传递 HTML 而不是 JSON 作为结果时发生的错误问题。
• Windows 修改了 Steam 市场连接失败错误代码的显示方式，使其更加详细。
• 新增错误代码 IAPV4SteamMarketResponseError（-6101001）。
• 错误代码和消息的显示格式为 [IAPv4] Steam 服务器响应错误：(代码：...，消息：...)。
• Windows 修复了在 Steam 离线模式下尝试登录 Steam 时未返回回调的问题。

v4.25.2.2¶

检查此 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 版本的开发环境。

已修复的错误¶

Marketing Attribution¶

• Android 修复了用于 MMP 服务集成 的 Hive SDK 标识符中缺少“did”值的错误。

v4.25.2.0¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

检查此 SDK 版本的开发环境。

新功能¶

Authentication¶

• Windows Line 被支持为一种新的身份验证方法（IdP）。

Matchmaking¶

• Windows 匹配 作为一项新功能得到支持。

Provisioning¶

• Windows 添加对 基于帐户的 agreementDetermineBase 显示功能(agreementDetermineBase) 的支持。

更改的功能¶

Authentication¶

• Android iOS 我们正在提供更新的 VK 身份验证方法。新的身份验证方法可在新版 VK 开发者控制台中找到。
• iOS 更新了已弃用的用于 Apple GameCenter 登录的 GameKit API 的验证协议。
• Android 由于 Google 登录库已停止支持，我们将改用 Google 凭据管理器 和 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”。

Plugins¶

• Windows 将 Unreal 插件从现有的 HIVE_UNREAL_PLUGIN.dll 更改为 HIVE_PLUGIN_CPP.dll。
• Windows 为了提升与虚幻引擎的兼容性，C API 将被移除。
• 由于调用使用 STL 的插件接口时会出现崩溃，之前支持的替代 C API 将被移除。

Provisioning¶

• All 在“条款与条件详情”和“回放”页面上，系统在以下情况下会进行调整，打开一个新的外部浏览器窗口加载内容，而不是使用“条款与条件”页面（WebView）：
• 当导航到“条款与条件”网址之外的网页时
• 当点击“条款与条件”页面内的超链接 HTML 标签（例如 标签、 等）时

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.transactionFinish
• IAPV4.transactionMultiFinish
• IAPV4.restore

Marketing Attribution¶

• Android 修复了使用 Adjust 功能确定安装状态时，推送通知显示为空的问题。
• Android 修改系统，使其在通过 Airbridge 购买多个商品时，根据单价和数量提供销售信息。

Provisioning¶

• Android iOS 修复了在 SDK 初始化之前初始化广告模块 (Adiz) 时，用于年龄检查的 AgeGate 值在 COPPA 或 GDPR 等合规性情况下基于 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 版本的开发环境。

更改的功能¶

Billing¶

• Android 将 PG 支付的行为更改为与其他计费（IAPv4）功能中的市场行为一致。如果您正在使用 PG 支付，则必须参考 PG 支付 文档修改您的代码实现。

Marketing Attribution¶

• iOS 新增对 Airbridge 延迟深度链接跟踪 功能的支持。

已修复的错误¶

Billing¶

• iOS 修复了在显示请求同意传输消费信息的弹出式用户界面时背景变为不透明的错误。
• iOS 修复了在关闭请求同意传输消费信息的弹出式 UI 时，应用程序屏幕方向会向非预期方向旋转的错误。

Promotion¶

• iOS 修复了在显示包含图像的审核弹出窗口时，如果发生旋转事件，则显示的图像会消失的错误。

Marketing Attribution¶

• iOS 修复了 Airbridge 在通过 Adiz 传输时将广告收入信息发送给 AdMob 而不是 Adiz 的错误。

v4.25.1.0¶

检查此 SDK 版本的开发环境。

新功能¶

Authentication¶

• Windows Telegram 已支持作为新的身份提供商 (IdP)。请参阅Telegram 登录的机器人设置。
• Windows [新增支持] X（以前称为 Twitter）作为身份验证方法（../../dev/authv4/hive-sdk-prep/common.md#hive-config）。
• Windows 它提供共享已验证会话的网页浏览功能。

Remote Play¶

• Windows 从 UE4 Windows 25.1.0 或更高版本开始，Hive SDK v4 支持 远程播放。

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 会员登录并取消登录时，Hive SDK 控制器的鼠标操作处于活动状态的错误。

v4.25.0.1¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 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 的更高版本中。

新功能¶

Authentication¶

• Android iOS Telegram 已支持作为新的身份提供商 (IdP)。请参阅Telegram 登录的机器人设置。

Billing¶

• iOS 它支持一项功能，可以询问用户是否同意将应用内产品消费信息发送到 Apple App Store。

Promotion¶

• Android iOS 收集登录事件，以便在输入邀请码的用户安装应用程序时提供奖励（../../operation/promotion/ua.md/#_7）。

Matchmaking¶

• Android iOS 匹配功能已更新，新增支持群组匹配。 ※ 此功能与 Hive SDK 的早期版本接口不兼容。要使用更新后的匹配功能，您必须使用 Hive SDK v4 25.0.0 或更高版本。

Marketing Attribution¶

• All 现在，在发送营销跟踪事件时，可以使用 向 Airbridge 发送其他属性 功能。
• Android 新增对 Airbridge 延迟深度链接跟踪 功能的支持。

Others¶

• Windows 使用游戏控制器时，新增了对控制器按键映射的支持，允许您集中注意力并控制某些Hive UI元素。
• Windows 现在可以使用自定义光标代替标准鼠标光标。
• Windows 新增了启用或禁用游戏控制器操作的设置。

Chat¶

• Android iOS 新增了聊天功能。

更改的功能¶

Authentication¶

• Android iOS 删除不再使用的 Auth 模块类、接口、方法、委托和监听器。
• All 使用 JWT 令牌实施更强大的安全协议。
• Android iOS 由于 TalkPlus 停止支持，TalkPlus 身份验证令牌方法将被移除。
• Android 除了 Apple Login WebView 中的登录功能外，还允许使用密码恢复等浏览功能。

Promotion¶

• Windows 在“新闻”菜单选项卡中添加了新的内容通知。

Marketing Attribution¶

• Android iOS 更新以支持 Adjust v5。
• 移除 Adjust Signature 库。
• Android iOS 更改设置，以便在将 Adiz 广告收入与 Adjust 聚合时，将广告收入来源发送到 AdMob 来源。
• Android 反映了 Appsflyer 广告收入聚合库已集成到主库中。
• 6.14.2 → 6.15.2
• 移除 Appsflyer 广告收入库。

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 的更高版本中。

检查此 SDK 版本的开发环境。

新功能¶

• Android iOS 支持 Unity 6 (Unity 6000)。
• Windows 添加了与 Hive SDK v4 Unity Android & iOS 24.5.0 界面兼容的更新。

Authentication¶

• Android iOS 新增对 Steam 和 X（原 Twitter）的身份验证方式支持。
• 通用准备工作
• Android 准备工作
• iOS 准备工作
• 品牌指南
• Android 它提供共享已验证会话的网页浏览功能。

Promotion¶

• Android iOS 广告也可以在Spot Banner中显示。
• Android 我们支持 X（原 Twitter）的用户邀请分享功能。

Matchmaking¶

• Android iOS 我们支持匹配服务作为一项新功能。

更改的功能¶

Authentication¶

• Android iOS 修改冲突弹出窗口中显示的提供商名称。

Plugins¶

• Android iOS Hive 配置设置菜单的位置已更改，现在可以针对每个目标平台配置设置。

已修复的错误¶

Billing¶

• iOS 当某些产品的价格无法精确地用浮点数表示时，请修改 JSON 格式，将值显示为小数点后的数字，而不是循环小数。
• 例如：4.99$（字符串）→ 4.9900000000000011（双精度浮点数）→ 4.99（JSON 数字）

v4.24.4.2¶

检查此 SDK 版本的开发环境。

更改的功能¶

• Windows 移除了用户界面中未使用的不必要资源。

v4.24.4.1¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

更改的功能¶

Authentication¶

• Windows 我们对 IdP 选择界面进行了更改，以便更清楚地显示是否选择了“保持登录状态”界面。
• Windows 身份提供商 (IdP) 选择界面的英文翻译已修改。
• 修改前：保持登录状态
• 修改后：保持登录状态

v4.24.4.0¶

检查此 SDK 版本的开发环境。

新功能¶

Billing¶

• Android Windows 在进行 PG 付款请求时，支持使用 IAPv4.purchase 进行多件购买。

Marketing Attribution¶

• Android iOS 我们支持 Airbridge 作为 Hive SDK 的专用服务。
• 使用 Airbridge 自动跟踪事件
• 使用 Airbridge 手动跟踪事件

Remote Execution¶

• Windows 它支持跨平台启动器远程执行。

已修复的错误¶

Analytics¶

• iOS 修复了仅选择同意横幅中的一个选项时，未正确反映的错误。

v4.24.3.0¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

检查此 SDK 版本的开发环境。

新功能¶

Marketing Attribution¶

• Windows Appsflyer 1.0.1 ???+ 警告 Appsflyer（仅限 Steam 平台）1.0.1 版本已发布。Hive 从 SDK v4 24.0.0 开始，营销归因功能仅在 Appsflyer 1.0.1 及更高版本中受支持。

Plugins¶

• Android iOS [插件] 提供专用于虚幻引擎的接口。



• 兼容现有的 C++ 接口。

• Android iOS 我们提供支持虚幻引擎专属新接口的示例代码。

Provisioning¶

• All 在条款和条件屏幕上增加了一项功能，用于检查是否已获得法定代表人的同意。

更改的功能¶

Authentication¶

• Android iOS 更改了注销行为。
• 之前：调用 signOut 时，Hive SDK 会注销用户帐户。 访客在调用 signOut API 时会收到服务器返回的失败响应。
• 更改后：调用 signOut 时，Hive SDK 会向 Hive 服务器请求确认注销用户帐户是否安全，然后根据服务器响应注销用户帐户。
• Android iOS 注销访客帐户时，不再返回成功响应，而是返回错误代码。它仍然保持访客帐户与 Hive SDK 和 Hive 服务器之间的会话。
• Android iOS 对于已暂停的帐户，设置将更改为自动从身份提供商 (IdP) 注销，以便您可以使用同一 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。

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 设备上检查 App Tracking Transparency (ATT) 的同意情况时导致间歇性崩溃的错误。
• iOS 修复了在相册中选择访问限制（仅允许访问部分照片）时导致崩溃的错误。

Notification¶

• Android 修复了当设置了不支持的 type 时，本地推送通知 中推送消息显示不正确的错误。
• iOS 修改以发送应用版本信息。

v4.24.2.1¶

检查此 SDK 版本的开发环境。

新功能¶

Community¶

• Windows 更改以允许在遵循 Hive 协议的社区中使用 自定义域名地址，而不是 withhive.com 或 com2us.com。

v4.24.1.3¶

检查此 SDK 版本的开发环境。

更改的功能¶

Authentication¶

• Android iOS 更改设备管理服务，使其根据设备的连接区域自动应用国际电话国家代码。

v4.24.2.0¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 SDK 的更高版本中。

新功能¶

• Android iOS 提供一个函数，用于返回欧盟和欧洲经济区（受 GDPR 约束）内未满 16 周岁的用户是否已同意相关条款。您可以检查用户是否未满 16 周岁。
• Android 在运行 Android OS 11 或更高版本的设备上，或者在安装了受支持模块的设备上使用相册时，默认使用 PhotoPicker。
• iOS 您可以在 macOS 控制台应用程序中查看 Hive SDK 调试日志，并选择要查看的特定日志类型。

Authentication¶

• All 当一个手机号码可注册的账户数量超过限制时，请求发送验证码时会显示一条错误消息，提示“您使用同一个手机号码创建的账户数量已超过限制”。
• Windows 支持Steam IdP 隐式登录。使用AuthV4.Helper.signIn。

Promotion¶

• Android iOS 它提供了一项功能，用于控制交叉推广活动的曝光度。
• Android iOS 今天，我们支持N 天不显示，这是改进后的“不显示”功能。

更改的功能¶

Authentication¶

• Windows 更改设置，使得在使用 Google 登录时，不会授予 games_lite 权限来检查 Google Play Games 信息。

Promotion¶

• iOS 改进了可用性，在使用游戏邀请（UA）功能时，最小化了剪贴板粘贴权限同意弹窗的显示。
  
  1. 更改了权限同意弹窗的显示时间，从受邀用户启动应用后立即显示，改为在应用启动后 Hive SDK 初始化时显示。
  2. 仅当邀请方 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 中无法传递 PlayerInfo Unity 插件参数的问题。

Promotion¶

• iOS 修复了在新闻视图中显示新框架视图时出现冻结的错误。
• Windows 修复了从“促销自定义直接全屏”切换到“框架”时发生的崩溃问题。

Marketing Attribution¶

• Android 修复了使用自定义条款执行初始化时，Adjust 事件发送延迟的错误。

Provisioning¶

• Windows 我们修改了设置，以便在再次查看术语时，使用 Hive 服务器新提供的术语 URL 数据，而不是以前保存的数据。

v4.24.1.2¶

检查此 SDK 版本的开发环境。

已修复的错误¶

Authentication¶

• Android 修复了在 Google 登录过程中，如果按下返回键取消登录，则无法正确响应回调的错误。此错误仅在 Hive 控制台中的“Google 旧版支持”值为 true 时才会出现。
• Android 修复了低分辨率设备上无法进行键盘输入的错误。

v4.24.1.0¶

注意：此 SDK 版本不提供单独的发行文件，该功能包含在 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 的更高版本中。

新功能¶

• Windows 新增了一项功能，即在游戏服务结束后尝试初始化 Hive SDK 时，返回 错误代码。

Authentication¶

• Windows 已添加 通过 Hive 社区登录自动登录 PC 游戏 功能。

Billing¶

• iOS 如果初始订阅折扣信息可用，则会在检索产品信息时一并传递。使用 getProductInfo 时，您可以通过查看回调中接收到的 IAPV4Product 对象列表中 original_price 字段值与 price 字段值之间的差异来检查折扣信息。

Promotion¶

• Android 它支持自定义标签页，该标签页使用设备上设置的默认浏览器来显示外部页面。您可以使用PlatformHelper类的showInAppBrowser方法来公开应用内浏览器。
• iOS 支持SafariViewController，它使用浏览器显示外部页面。您可以使用PlatformHelper类的showInAppBrowser方法公开应用内浏览器。

更改的功能¶

• iOS 区分应用版本时，请同时使用 CFBundleShortVersionString。
• Windows HIVE SDK 的用户界面和 WebView 已更改为根据 DPI 设置而不是显示器分辨率进行显示。

Authentication¶

• Windows 现在您可以使用 Windows 默认浏览器的“隐身模式”登录 Google。支持的浏览器如下：
• Google Chrome
• Microsoft Edge
• Mozilla Firefox
• Naver Whale
• Windows 如果您使用非主流浏览器登录，请使用“普通模式”登录。

Billing¶

• Android iOS 我们已将退款用户付款界面中显示的 PG 付款类型文本从“HiveStore”更改为“PG Payment”。
• 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 的个人资料图片则登录失败的错误。（已修改，即使未收到个人资料图片也能登录。）

Billing¶

• Windows 修复了退款用户重新付款界面中 PG 付款显示为 Hive Store 的错误。
• Windows 我们对退款用户付款界面的阿拉伯语屏幕进行了修改，使其使用适合阿拉伯语特点的界面。

Promotion¶

• Windows 修复了 getBannerInfo 和 getBannerInfoString 函数无法正常工作的错误。
• Windows 修改了推广 API，使其独立于 AuthV4 身份验证运行。

Others¶

• Windows 修复了在特定大小的窗口中执行点击等输入事件时用户界面闪烁的错误。

已知问题¶

Authentication¶

• iOS 使用 Facebook SDK iOS 17.0.0 时，如果用户不同意“应用跟踪透明度”，则无法在 iOS 17.0 或更高版本的设备上登录。要在此条件下实现 Facebook 登录，请使用 Hive SDK v4 24.1.0。