SDK Unreal Engine 4 发布说明¶

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

Hive SDK Unreal Engine 4 按目标 OS 划分的更新内容使用以下 OS 标签进行区分。

• Android 适用于 SDK Unreal Engine 4 Android 的更新内容
• iOS 适用于 SDK Unreal Engine 4 iOS 的更新内容
• Windows 适用于 SDK Unreal Engine 4 Windows 的更新内容
• All 同时适用于 SDK Unreal Engine 4 Android、iOS、Windows 的更新内容

必读事项¶

在使用各个 Hive SDK 发布版本之前，下面说明与各版本限制事项相关、必须事先了解的设置项。

• Hive SDK v4 Unreal Engine 4 25.0.0 及以上版本必须签发安全密钥
  • 由于认证安全协议发生变更，使用 Hive SDK v4 Unreal Engine 4 25.0.0 及以上版本时，必须在 Hive 控制台 > 安全密钥设置 中签发安全密钥。如果未签发安全密钥，则无法在应用中登录。
• 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 文件的文件夹压缩包。
  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 中。

变更功能¶

认证¶

• Android 将使用 Credential Manager 的 Google 登录功能改为“选择启用（Opt-In）”。
  • 变更原因：在部分搭载 Android 16(API Level 36) 且支持 16 KB 页面大小(pageSize)的设备上，通过 Credential Manager 进行 Google 登录存在兼容性问题。
  • 主要变更点：Google 登录方式回退为原有的 Google Sign-in。
  • 后续计划：用于将“使用 Credential Manager 登录”启用为默认登录方式的 API，将在后续发布的 Hive SDK Android 版本中提供。

v4.26.1.3¶

已修复的错误¶

认证¶

• iOS 修复在 iPad 设备上，于需要输入出生日期信息的年龄限制(AgeGate)弹窗或与日历相关的弹窗中点击空白区域时，应用会冻结（无响应）的错误。
• iOS 修复当设备管理服务在 iOS 设备上运行时，部分弹窗会显示不必要滚动条的错误。

计费¶

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

推广¶

• Android 修复当游戏应用在后台模式下运行时显示推广弹窗时，如果发生用户参与(User Engagement, UE)直达链接事件，推广弹窗会消失的错误。

营销归因¶

• iOS 修复在分辨率宽度小于 1170px 的 iOS 设备上，Digital Markets Act(DMA) 同意横幅的部分文本不显示的错误。

v4.26.1.2¶

说明: 此 SDK 版本不单独提供发布文件，相关功能包含在更高版本 SDK 中。

变更功能¶

认证¶

• Android iOS iOS 在中国地区使用 Hive Membership 登录时，如果已完成手机号码验证，则在中国实名认证阶段将不再进行手机号码验证，而是直接进行身份证验证。
• 原先在 Hive Membership 登录时，仅进行会员 ID（电子邮箱地址）验证，而不进行手机号码验证，因此在之后的中国实名认证阶段需要进行手机号码验证。

已修复的错误¶

• iOS 修复执行 Apple Submission 时，由于包含错误生成的 bundle 文件 Info.plist，导致发布版本验证失败的错误。
• iOS 修复在退款用户重新支付 UI 中，PG 支付显示为 Hive Store 的错误。

v4.26.1.0¶

说明: 此 SDK 版本不单独提供发布文件，相关功能包含在更高版本 SDK 中。

请查看此 SDK 版本的开发环境。

新功能¶

认证¶

• All 提供 AuthV4.checkAgeGate 方法：显示输入出生日期的弹窗后，当用户输入出生日期时，会通过回调返回该值。
• All 新增 AuthV4.setAutoLoginEnabled 方法，用于将下一次登录会话注册为自动登录会话（ON/OFF）。设置为 ON 后，通过登录方法执行登录时，该登录会话会保存为自动登录会话。之后登录时，执行 AuthV4.Helper.signIn 或将 AuthV4.signIn 以 ProviderType.AUTO 运行，即可使用自动登录。
• Android 支持使用 Xiaomi 登录。

计费¶

• Android 支持使用 Xiaomi 计费。

推广¶

• All 支持延迟深度链接，当未安装应用的用户点击直达链接后，即使在应用安装完成后，也会跳转到链接指定的应用内页面。

营销归因¶

• Windows 推出用于在非 Steam 的桌面 PC 环境中发送所需信息的 AppsFlyer for Native PC。
• Windows 从 Airbridge 1.1.4 版本开始，提供可延迟发送时点的功能，使 Install 事件日志在用户登录后再发送到 MMP 服务器。游戏公司可在登录后发送 Install 事件日志，将 PlayerID 在内的账号信息发送到 MMP 服务器。

远程游玩¶

• Windows 从远程游玩插件 1.01.02 及以上版本开始，在远程游玩运行中点击外部链接时，可在远程设备上打开页面。因此，即使在远程游玩过程中也可以进行 PG 支付。

附加功能¶

• Android 在通过游戏内 WebView 打开时，若使用 PlatformHelper 类的 showInWebView 方法显示 WebView，则提供使用 Game Activity 而非 Hive Activity 进行显示的选项。

其他¶

• All 可在 Configuration 类中通过 getGameLanguage 方法查看 SDK 中设置的语言值。
• iOS 随着 CocoaPod 服务终止，提供通过 SPM(Swift Package Manager) 进行分发的服务。

变更功能¶

• Windows 改进 HTTP 通信逻辑，增强稳定性。

认证¶

• Android iOS 除 Web 方式外，也支持通过应用方式进行成人认证。
• All 移除 SNS 登录时自动收集个人资料图片和昵称的功能。
• All 随着新增 AuthV4.setAutoLoginEnabled(默认值：PC OFF / Mobile ON)，自动登录运行策略变更如下。
  • 变更前：发生账号冲突后切换到其他账号时，切换后的账号在移动端保持自动登录，在 PC 端解除自动登录
  • 变更后：发生账号冲突后切换到其他账号时，切换后的账号在移动端和 PC 端中，如果已通过 AuthV4.setAutoLoginEnabled 注册为自动登录会话，则保持自动登录；否则解除自动登录（存在例外情况）
• Windows 在 SteamDeck 上使用本人验证功能时，新增关于不支持 Pass 的提示弹窗。
• Android Google 登录时改为同时使用 Credential Manager 和 PlayService Auth。在 Credential Manager 中发生 FailOver 时，会尝试通过 PlayService Auth 登录。

计费¶

• Windows PG 支付改为通过外部浏览器进行。
• Android 将 Google Play 支付所使用的库更改为 Google Play Billing Library 8.0。

推广¶

• Windows 修复通过自定义视图/直达视图跳转到外部浏览器时 WebView 闪烁的错误。
• Android iOS 修复通过自定义视图/直达视图跳转到外部浏览器时 WebView 闪烁的错误。

推送¶

• iOS 在收集用于推送发送的 token 时，改为根据构建环境收集 token 附加信息。

营销归因¶

• Android iOS 变更 显示 DMA 同意横幅 的弹窗设计并改进其运行方式。
  • 原有同意横幅中已经同意的记录会保持不变，再次显示时将显示改进后的文案和 UI 的新同意横幅。
  • 如果此前对原有同意横幅的文案进行了自定义并正在使用，则必须根据变更后的数据结构，参考 自定义同意横幅 UI 设置 重新进行设置。
• Android iOS 修改为不重复发送向 MMP 传输的同一收据的销售日志。
• Android iOS 新增在发送 Firebase 购买事件时，也向 value 键传输销售额值。
  • 之前是向 revenue 键传输销售额值。

附加功能¶

• Android iOS 改进通过游戏内 WebView 打开中，由 PlatformHelper 类的 showInAppView 方法显示的 WebView 关闭按钮的可视性。

插件¶

• Android iOS 在 HiveConfig 设置菜单中新增保存按钮。

Provisioning¶

• Windows 在服务器维护、更新、公告及封禁弹窗中，点击按钮时的结束方式改为通过结束回调进行传递。
• Android iOS 将可响应应用商店责任法的 Age Range API 拆分提供，以便可选择性适用。
  • 计划于 2026 年 1 月 1 日在美国得克萨斯州施行的应用商店责任法目前处于暂缓施行状态，可根据开发情况选择适用。
  • 可选择适用以响应计划于 2026 年 5 月在美国犹他州、7 月在路易斯安那州施行的应用商店责任法。

库更新¶

• Windows Microsoft Visual C++ Redistributable 改为使用 14.44.35211.0 及以上版本。
• Android Amazon AppStore (Android) v3.0.4 → v3.0.8
  • Samsung GalaxyStore IAP (Android) v6.1.1 → v6.5.0
  • Google Billing Library (Android) v7.0.0 → v8.0.0
  • QQ (Android) v3.5.17 → v3.5.18
  • Xiaomi (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

其他¶

• All Configuration.setZone 的运行改为仅在初始化之前有效。

已修复的错误¶

• Android 当整个通用区域 UI 的背景不透明时，修复为可在 cutout 区域内显示。

认证¶

• iOS 修复使用聊天机器人时，聊天消息输入字段偶发不显示的错误。
• iOS 修复在超过设备管理注册数量上限的状态下，完成成人认证后删除已注册设备时，会再次显示成人认证弹窗的错误。
• Windows 修复在 AuthV4 认证进行过程中尝试退出应用时无法退出的问题。
• Windows 修复请求本人验证页面的应用在退出后，若其他应用（或重新启动的应用）请求认证，会错误传递此前请求的认证结果，从而导致错误(-1200001, -8)的问题。

推广¶

• iOS 修复当最新消息菜单数量超过一定值时无法正常运行的错误。
• iOS 修复当全屏横幅中显示的图片宽度或高度为 0，或服务器传输了错误信息时无法正常运行的错误。
• iOS 修复通过直达链接显示社区时，如果没有 URL 参数则直达链接无法运行的错误。
• Windows 修复在推广中点击“今天不再显示”后，该推广会被永久隐藏的问题。

推送¶

• Android 修复即使属于 COPPA 对象，仍会收集用于推送通知的 token 的错误。
• iOS 修复 ForegroundPush 设置无法变更为 False 的错误。

营销归因¶

• iOS 修复 Firebase 中遗漏 Install 或 Update 事件的错误。
• Windows 修复营销归因中的购买日志被重复收集的问题。

远程游玩¶

• Windows 修复远程游玩中刷新 JWT token 时发生崩溃的问题。

附加功能¶

• iOS 修复在打开游戏内浏览器中应用 PlatformHelper 类的 showInAppBrowser 方法时，如果游戏应用用户的网络处于离线状态或变为离线状态，游戏应用会闪烁并关闭窗口的现象。

其他¶

• Windows 解决在部分环境中应用无法正常退出的问题。
• Windows 修复在 interwork:// 等内部 scheme 中，当输入如 ?831020 这样并非 key-value 形式的 query 值时，会被错误传递为 831020= 的问题，并改进为按 831020 原样传递。
• Windows 修复在使用远程游玩等插件时，通过 Configuration.setZone 设置的 Zone 无法生效的问题。

v4.26.0.1¶

• iOS Hive SDK 的开发环境中使用的 Xcode 版本将按如下方式变更。
  • 变更前: Xcode 26.2 Beta2
  • 变更后: Xcode 26.2

配置¶

• Android 为应对应用商店责任法，Hive SDK 中支持的 Google Play Age Signals API 版本将按如下方式变更。
  • 变更前: 0.0.1-Beta2
  • 变更后: 0.0.2

v4.26.0.0¶

注意事项: 本 SDK 版本不单独提供发布文件，相关功能已包含在更高版本 SDK 中。

新功能¶

• iOS 可在 Xcode 26.2 及以上版本中构建 Hive SDK。
  • 最低支持的 OS 版本为 iOS 15。

配置¶

• Android 新增 合规性 功能。
  • 在通过 Google Play 和 Amazon Appstore 发布游戏应用时，Hive SDK 提供用于确认用户年龄范围的 Age Range API，以应对将于 2026 年 1 月 1 日在美国得克萨斯州施行的应用商店责任法。
• iOS 新增 合规性 功能。
  • 在通过 Apple App Store 发布游戏应用时，Hive SDK 提供用于确认用户年龄范围的 Age Range API，以应对将于 2026 年 1 月 1 日在美国得克萨斯州施行的应用商店责任法。
  • 仅支持 iOS 26.2 及以上版本。

已知问题¶

配置¶

• Android 为应对应用商店责任法，Hive SDK 26.0.0 Beta 中支持的 Google Play Age Signals API 0.0.1-beta02 版本 在接收实际年龄信号的用户环境中无法使用。
  ※ 如需接收实际年龄信号，请更新到支持 Google Play Age Signals API 0.0.2 版本（非 Beta 版本）的 Hive SDK v4.26.0.1。

v4.25.8.2¶

注意事项: 本 SDK 版本不单独提供发布文件，相关功能已包含在更高版本 SDK 中。

已修复的错误¶

支付¶

• Windows 修复了在 Google Play Games PC 支付中，当已注册商品超过 20 个时无法获取全部商品信息的问题。

v4.25.8.1¶

请确认本 SDK 版本的 开发环境。

已修复的错误¶

其他¶

• Windows 解决了更改游戏语言后，关闭提示 UI 仍以初始设置语言显示的问题。

聊天¶

• Windows 修复了韩语消息未触发回调的错误。

v4.25.9.0¶

注意事项: 本 SDK 版本不单独提供发布文件，相关功能已包含在更高版本 SDK 中。

新功能¶

认证¶

• All 提供 身份验证服务。
  • SteamDeck 不提供身份验证服务（本人验证、成人验证、监护人同意）。请先在移动设备或 PC 上使用身份验证服务后，再在 SteamDeck 上登录游戏。

已修复的错误¶

其他¶

• Windows 解决了更改游戏语言后，关闭提示 UI 仍以初始设置语言显示的问题。

v4.25.7.1¶

注意事项: 本 SDK 版本不单独提供发布文件，相关功能已包含在更高版本 SDK 中。

已修复的错误¶

其他¶

• Windows 通过对 DX12 渲染器应用 GPU 同步，增强了渲染稳定性。
• Windows 解决了推广最新消息中关闭按钮偶尔不起作用的问题。

v4.25.8.0¶

注意事项: 本 SDK 版本不单独提供发布文件，相关功能已包含在更高版本 SDK 中。

请确认本 SDK 版本的 开发环境。

新功能¶

• Android 支持 Android OS 16(API Level 36)。
• Android 在使用 Android OS 15(API Level 35) 及以上版本构建时，支持 16KB Page Size 构建。

游戏数据存储¶

• Windows 新增 数据存储 功能。

聊天¶

• Windows 新增 聊天 功能。

变更事项¶

• Android 移除不再使用的 android.permission.FOREGROUND_SERVICE 权限。
• Android Android 最低构建目标由 19 变更为 23。

认证¶

• iOS 移除在 Xcode 26 构建时无法使用的库引用。

计费¶

• Windows 将 Google Play for Native PC (EAP) 集成从 Web API 方式切换为基于 Google Play Games PC SDK 的方式。
  • 现在不再通过 Hive SDK 认证，而需要通过 Google Play Games PC 应用使用 Google 账号登录。请确认 初始化时的注意事项。
  • 现有项目和新项目都必须按照 Google 指南 准备 manifest 配置和代码签名。

库更新¶

• 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 Sign-In) 20.7.0 → 21.3.0
  • play-services-games-v2(Android) (Play Games Services) 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 Sign-In(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。

已修复的错误¶

认证¶

• iOS 修复了显示聊天机器人弹窗时，偶尔显示为横屏而非竖屏模式的错误。
• iOS 修复了可能发生空数组引用错误的问题。
  • 使用 Authv4 类的 showConflict 方法时，如果缺少必填输入数据，会发生崩溃。

分析¶

• Android 修复了在客户端同时在线人数传输失败时，不再附带不必要的信息进行重传。

v4.25.7.0¶

注意事项: 本 SDK 版本不单独提供发布文件，相关功能已包含在更高版本 SDK 中。

新功能¶

认证¶

• All 完成成人验证后，可以识别已通过成人验证的用户。提供 用于获取识别值的方法。识别信息为经过哈希处理的 DI 值。

变更事项¶

认证¶

• Android iOS 如果在 Hive 控制台中将应用设置为使用成人验证，则登录后会自动执行成人验证流程。
  • 仅在韩国支持。
• Android iOS 将执行成人验证的 showAdultConfirm 方法标记为 deprecated。
  • showAdultConfirm 方法可能会在后续更新中移除。

已修复的错误¶

认证¶

• Windows 修复了因 监护人同意 失败而导致登录失败时，登录信息不会被重置的问题。
• Windows 解决了通过 自定义登录 登录的用户在游戏内购买道具后，又在应用商店 再次获得退款 的情况下，使用同一账号重新连接游戏会登录失败的问题。
• Windows 修复了在 AuthV4.signOut 回调内部调用 AuthV4.showSignIn 时会发生崩溃的问题。

其他¶

• Windows 修复了当游戏以管理员权限运行时，通过 Hive SDK 打开外部 Web 浏览器时，若 URL 长度超过 800 个字符，浏览器无法正常打开的问题。

v4.25.6.0¶

注意事项: 本 SDK 版本不单独提供发布文件，相关功能已包含在更高版本 SDK 中。

新功能¶

聊天¶

• Android iOS 新增可对特定聊天消息表达或显示“赞”的功能。
• Android iOS 提供可对特定聊天消息编写“回复”，或显示回复关联关系的信息。
• Android iOS 提供可提及特定用户，或提供提及用户信息的功能。

变更事项¶

聊天¶

• Android iOS 将 频道消息查询方式 从基于索引改为基于消息 ID 进行查询。

v4.25.5.2¶

注意事项: 本 SDK 版本不单独提供发布文件，相关功能已包含在更高版本 SDK 中。

已修复的错误¶

认证¶

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

v4.25.5.1¶

注意事项: 本 SDK 版本不单独提供发布文件，相关功能已包含在更高版本 SDK 中。

新增功能¶

认证¶

• Android iOS 新增 多账号切换 功能。相关详细功能如下。
  • 将当前登录的账号保存到设备
  • 查询已保存的账号
  • 登出并删除已保存的账号
  • 使用已保存的其他账号快速登录

推广¶

• Android iOS 新增 Direct Link 功能。

通知¶

• Android iOS 新增提供 推送操作按钮。
  • 接收推送通知时，可以通过推送选择操作按钮执行预先定义的操作。

聊天¶

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

Hercules¶

• Android 20241125-2 -> 20250527
• iOS 20241120 -> 20250218

变更功能¶

• Android 更新构建所需的混淆规则。
• iOS 原本单独提供的 HiveAppTrackingTransparents.framework 库已整合到 Service.framework 中。

认证¶

• Android iOS 修改为在不使用 Hive Membership 账号时使用 showMyInquiry 方法也会显示咨询页面。
• Android 将 VK 认证弹窗从 WebView 更改为应用内浏览器。

营销归因¶

• iOS 改为在启用自动收集的 Firebase 购买事件时也提供支持。

已修复的问题¶

推广¶

• iOS 修正 iPad 设备上最新消息 UI 的圆角曲率。

配置¶

• iOS 修正为显示条款时 WebView 不会滚动。

分析¶

• iOS 调整逻辑，以便在完成条款同意后可立即发送 Analytics 日志。

已知问题¶

其他¶

• iOS 在横屏模式下使用聊天机器人时会发生崩溃。
  • 请更新到 Hive SDK Unity iOS 25.5.2 或更高版本。

v4.25.5.0¶

请查看本 SDK 版本的 开发环境。

新增功能¶

认证¶

• Windows 新增 监护人同意功能。

分析¶

• Windows 在 Airbridge 日志 中新增 device.platform。其值为 "Steam" 或 "Desktop"。该值也可以在 Airbridge 仪表板中实时查看。

变更功能¶

其他¶

• Windows 改进了 MMP 相关内部逻辑。

已修复的问题¶

认证¶

• Windows 解决了使用 多账号切换 时，自动登录后调用登出会使会话失效，从而无法再次登录的问题。

推广¶

• Windows 修复了在调用 Promotion.updatePromotionData() 后立即打开最新消息页面时偶发的崩溃问题。

其他¶

• Windows 解决了 Hive SDK 打开新窗口时发生的 NVIDIA 图形驱动 572.16 ↔ DirectX 11 之间的兼容性冲突（Apple 登录、Facebook 登录、PG 支付）。

v4.25.4.0¶

说明: 本 SDK 版本不单独提供发布文件，相应功能包含在更高版本的 SDK 中。

新增功能¶

认证¶

• Windows 新增 多账号切换 功能。相关详细功能如下。
  • 将当前登录的账号保存到设备
  • 查询已保存的账号
  • 登出并删除已保存的账号
  • 使用已保存的其他账号快速登录
• Windows 变更为当游戏使用被暂停的用户尝试登录时，不关闭应用，只在应用内执行登出。
• Windows 可在 Remote Play 插件 中使用增强认证协议。

已修复的问题¶

其他¶

• Windows 解决了 Hive 功能行为的漏斗日志未统计问题。

v4.25.3.0¶

说明: 本 SDK 版本不单独提供发布文件，相应功能包含在更高版本的 SDK 中。

新增功能¶

推广¶

• Windows 调整为在调用 Promotion.getBannerInfo 时传递 typeCampaign 值。
• Windows 收集登录事件，以便在 输入邀请码的用户安装应用 时可以发放奖励。

其他¶

• Windows 新增在通过 Crossplay Launcher 启动游戏时，可查询附加在启动 URI 上的 启动参数 的功能。
• Windows 将 特定 UI 添加到控制器键位映射支持对象中。
• Windows 新增 UI，在可通过控制器按钮关闭时显示关闭按钮提示。

变更功能¶

库更新¶

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

已修复的问题¶

其他¶

• Windows 修复了在游戏引擎中设置默认鼠标光标时，关闭 WebView 后进行鼠标操作会交替显示 Windows 默认光标的现象。
• Windows 修复了 Hive SDK 内部将 HTML 而非 JSON 作为结果传递时发生错误的现象。
• Windows 改为细分并传递 Steam 市场连接失败的错误码。
  • 新增错误码 IAPV4SteamMarketResponseError(-6101001)。
  • 以 [IAPv4] Steam server response error : (code: ... , message: ...) 格式传递错误码和消息。
• Windows 修复了在 Steam 离线模式下尝试 Steam 登录时无法返回回调的问题。

v4.25.2.2¶

请查看本 SDK 版本的 开发环境。

变更功能¶

认证¶

• Android 由于 Google Credential Manager 兼容性较低，导致部分用户无法登录，因此将认证方式回滚为原有的 Google Sign-In。

库更新¶

• Android * GooglePlay Services-Auth(Android) v20.7.0 (重新支持回滚到 Google Sign-In)
  • Google Credential Play Services Auth(Android) v1.3.0 (移除回滚到 Google Sign-In)

v4.25.2.1¶

请查看本 SDK 版本的 开发环境。

已修复的问题¶

营销归因¶

• Android 修复了在 与 MMP 服务集成 时使用的 Hive SDK 标识符中 did 值缺失的错误。

v4.25.2.0¶

说明: 本 SDK 版本不单独提供发布文件，相应功能包含在更高版本的 SDK 中。

请查看本 SDK 版本的 开发环境。

新增功能¶

认证¶

• Windows 新增支持 LINE 作为认证方式 (IdP)。

匹配¶

• Windows 新增支持 匹配 功能。

配置¶

• Windows 新增对 按账号显示条款的功能(agreementDetermineBase) 的支持。

变更功能¶

认证¶

• Android iOS 变更提供 VK 认证方式。变更后的认证方式可在 新的 VK 开发者控制台 中使用。
• iOS 更新在 Apple GameCenter 登录时使用的已弃用 GameKit API 的验证协议。
• Android 由于 Google Sign-In 库停止支持，隐式和显式登录时将改为通过 Google Credential Manager 和 AuthorizationClient API 进行认证。

计费¶

• Android 当通过 PG 支付购买的商品发生退款时，为了与之前的交易区分，新增 order_id 值。
• Android Windows 变更为在 PG 支付交易完成时，通过营销归因传送购买完成日志。

推广¶

• Android 在分享 User Acquisition 时，改为将 Telegram 添加到支持的分享列表中。
• Android 在显示 WebView 时，调整缓存策略。

营销归因¶

• Android iOS 为支持 与 MMP 服务集成，额外传送 Hive SDK 标识符。
• Windows 为支持 营销归因支持，额外传送 Hive SDK 标识符。
• All 变更为在手动跟踪事件时 添加自定义属性 后发送。
• Android 初始化 Airbridge 时，改为传送商店来源信息。
• iOS 使用 sendEventWithAttributes API 时，将 semantic value 类型浮点值的精度范围从 float 更改为 double。

插件¶

• Windows 将 Unreal Plugin 从原有的 HIVE_UNREAL_PLUGIN.dll 更改为 HIVE_PLUGIN_CPP.dll。
• Windows 为改进 Unreal Engine 兼容性，移除 C API。
  • 由于在调用应用 STL 的插件接口时会发生崩溃，因此移除此前支持的替代 C API。

配置¶

• All 在条款详情查看和重新查看页面中，遇到以下情况时，改为不加载条款页面（WebView），而是新打开外部浏览器进行加载。
  • 跳转到超出条款 URL 的网页时
  • 点击条款中的超链接 HTML 标签（a 标签、tel:// 等）时

库更新¶

• 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
  • GooglePlay Services-Auth(Android) v20.7.0 (停止支持)
  • Google Credential Play Services Auth(Android) v1.3.0 (新增支持)
• iOS Airbridge(iOS) v4.1.1 → v4.3.0
  • Adjust(iOS) v5.0.1 → v5.2.0
  • Singular(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

聊天¶

• Android iOS 在发送或接收消息数据时，额外发送和接收 extraData。
• Android iOS 连接聊天服务器时，不再发送 extraData。
• Android iOS 额外接收整数类型的时间值，而不是字符串时间值。

• Android iOS 在网络阻断等无法通信的情况下，如果未能正常释放 WebSocket 就尝试重新连接，现已改为避免因重复连接状态而失败。### 修复的问题

• Android 在需要重试网络通信或连接分布式服务器的情况下，如果在达到设定的最大超时时间之前收到响应，则不再等待超时，而是立即重试通信或连接分布式服务器。

• iOS 修复了当使用 Configuration 类的 setZone 方法更改 Hive SDK 连接的服务器组 Zone 时，hive_config.xml 文件中的 gameLanguage 值会被重置的问题。

认证¶

• iOS 修复了在 iOS 18 及以上设备上 QQ Web 登录无法正常进行的问题。
• Windows 修复了用于增强安全协议的 JWT token 未传递到使用 Hive SDK WebView 的通信中的问题。

计费¶

• Windows 修复了在多层嵌套 Hive SDK 方法回调的状态下调用以下任一方法时应用会卡死的问题。
  • IAPV4.transactionFinish
  • IAPV4.transactionMultiFinish
  • IAPV4.restore

营销归因¶

• Android 如果使用通过 Adjust 判断安装状态的功能，修复了会显示空白推送通知的现象。
• Android 使用 Airbridge 时，如果发生购买多个数量的事件，修改为传递根据单价和数量计算的营收信息。

预配¶

• Android iOS 修复了在 SDK 初始化之前初始化广告模块（Adiz）时，如果遵循 COPPA 或 GDPR 等合规要求，检查年龄的 AgeGate 值会按 hive_config.xml 中设置的值运行的问题。

聊天¶

• Android 修复了连接聊天时偶发连接失败的现象。

已知问题¶

营销归因¶

• Android 在用于与 MMP 服务集成的 Hive SDK 标识符中，存在 did 值缺失的问题。请使用已修复此问题的 SDK v4 Unity Android & iOS 25.2.1 版本。

v4.25.1.3¶

请确认本 SDK 版本的开发环境。

变更功能¶

计费¶

• Android 将 PG 支付的工作方式调整为与其他计费(IAPv4)功能中的市场一致。如果正在使用 PG 支付，请参考 PG 支付 文档修改代码实现。

营销归因¶

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

修复的问题¶

计费¶

• iOS 修复了显示询问是否同意传输消费信息的弹窗 UI 时背景不透明的问题。
• iOS 修复了关闭询问是否同意传输消费信息的弹窗 UI 时，应用屏幕方向意外旋转的问题。

推广¶

• iOS 修复了在显示含图片的评论弹窗期间发生旋转事件时，已显示图片会消失的问题。

营销归因¶

• iOS 修复了通过 Adiz 发送广告收益信息时，在 Airbridge 中被作为 AdMob 而不是 Adiz 发送的问题。

v4.25.1.0¶

请确认本 SDK 版本的开发环境。

新功能¶

认证¶

• Windows 支持 Telegram 作为新的认证方式(IdP)。请参考 Telegram 登录所需的机器人设置。
• Windows 认证方式新增支持 X(原 Twitter)。
• Windows 提供共享已认证会话的应用内浏览功能。

远程游玩¶

• Windows 从 Hive SDK v4 UE4 Windows 25.1.0 起支持远程游玩。

其他¶

• Windows 提供可设置 Google 登录时是否使用隐私模式的 Configuration.setUsePrivateBrowsingForAuth 函数。
  • 在 hive_config.xml 文件中也提供该设置。
• Windows 提供可使用 URL 打开浏览器的 PlatformHelper.openBrowser 函数。

变更功能¶

计费¶

• Windows 将 PG 支付的工作方式调整为与其他计费(IAPv4)功能中的市场一致。如果正在使用 PG 支付，请参考 PG 支付 文档修改代码实现。

推广¶

• Windows 修改为通过 additionalInfo 传输的值中不包含不必要的信息。

开发环境¶

• Windows 将所需的 Microsoft Visual C++ Redistributable 最低版本更新为 14.42.34438。

修复的问题¶

认证¶

• Windows 修复了当用户选择 Hive 会员以外的登录方式后取消登录时，使用鼠标操作 Hive SDK 控制器的功能仍会生效的问题。

v4.25.0.1¶

注意事项: 本 SDK 版本不单独提供发布文件，相关功能包含在更高版本的 SDK 中。

新功能¶

营销归因¶

• iOS 使用应用了 Adjust v5 的 Hive SDK v4 25.0.0 及以上版本时，修复了 SDK 自动收集并发送的 did、vid 值未发送的问题。

变更功能¶

开发环境¶

• Windows 将所需的 Microsoft Visual C++ Redistributable 最低版本更新为 14.38.33130。

修复的问题¶

计费¶

• Windows 修复了在使用 JWT token 应用增强安全协议时，未显示退款用户重新购买的问题。

v4.25.0.0¶

注意事项: 本 SDK 版本不单独提供发布文件，相关功能包含在更高版本的 SDK 中。

新功能¶

认证¶

• Android iOS 支持 Telegram 作为新的认证方式(IdP)。请参考 Telegram 登录所需的机器人设置。

计费¶

• iOS 支持向用户询问是否同意将应用内商品消费信息发送到 Apple App Store的功能。

推广¶

• Android iOS 收集登录事件，以便在输入邀请代码的用户安装应用时发放奖励。

匹配¶

• Android iOS 更新匹配功能，新增支持组队匹配功能。 ※ 与旧版本的 Hive SDK 接口不兼容。要使用更新后的匹配功能，必须使用 Hive SDK v4 25.0.0 及以上版本。

营销归因¶

• All 新增支持在发送营销跟踪事件时向 Airbridge 传递附加属性功能。
• Android 新增支持 Airbridge 延迟深链接跟踪 功能。

其他¶

• Windows 使用游戏控制器时，新增支持控制器键映射，并可聚焦和操作部分 Hive UI 元素。
• Windows 新增支持使用自定义光标替代普通鼠标光标。
• Windows 新增可启用或禁用游戏控制器操作的设置。

聊天¶

• Android iOS 新增支持聊天功能。

变更功能¶

认证¶

• Android iOS 删除不再使用的 Auth 模块类、接口、方法、委托和监听器。
• All 应用更强的安全协议，使用 JWT token。
• Android iOS 随着 TalkPlus 停止支持，删除 TalkPlus 认证 token 方法。
• Android 允许在 Apple 登录 WebView 中进行登录功能以外的浏览，例如查找密码等。

推广¶

• Windows 在最新消息的菜单标签中新增了新内容通知标记。

营销归因¶

• Android iOS 更新以支持 Adjust v5。
  • 移除 Adjust Signature 库。
• Android iOS 修改为在使用 Adjust 统计 Adiz 广告收入时，将广告收入来源作为 AdMob 来源发送。
• Android 反映 Appsflyer 广告收入统计库已整合进主库的变更。
  • 6.14.2 → 6.15.2
  • 移除 Appsflyer ad-revenue 库。

Hercules¶

• All 2024.11.20

修复的问题¶

认证¶

• Android 修复了在执行 signIn 方法期间发生网络响应延迟时，偶发占用 UI 线程的问题。
• Windows 修复了处于退款用户重新购买状态的用户登录 PC 时出现的 CommonUnknown 错误。
• Windows 改进了 UI，使拖动“保持登录状态”文本时不显示“隐私保护警告”文案。

计费¶

• iOS 修复了使用 UserEngagement 引导购买应用内商品时，IAP_UPDATE 事件会额外发生的问题。
• Windows 修复了在 Steam 支付过程中使用 ESC 键或其他按键操作关闭覆盖层时，无法继续支付的问题。

其他¶

• Windows 通过优化循环条件，修复了 CPU 使用量恢复正常的问题。 ※ 如果正在使用受影响的版本（4.24.1.0 及以上），请更新到 SDK v4 Unity Windows 25.0.0 后确认 CPU 使用量是否稳定。

已知问题¶

营销归因¶

• 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 接口的更新。

认证¶

• Android iOS 新增支持将 Steam、X(原 Twitter) 作为认证方式。
  • 准备工作：通用
  • 准备工作：Android
  • 准备工作：iOS
  • 品牌指南
• Android 提供共享已认证会话的应用内浏览功能。

推广¶

• Android iOS Spot Banner 也支持广告展示。
• Android 在用户邀请分享功能中新增支持 X(原 Twitter)。

匹配¶

• Android iOS 新增支持匹配服务。

变更功能¶

认证¶

• Android iOS 修改冲突弹窗中显示的 Provider 名称。

插件¶

• Android iOS 已调整 Hive Config Settings 菜单的位置，并修改为可按目标平台进行设置。### 修复的问题

计费¶

• iOS 当部分商品价格是无法用浮点数精确表示的价格时，已修改为在 JSON 格式中不将该值表示为循环小数，而是表示为精确小数。
  • 例> 4.99$ (string) → 4.9900000000000011 (double) → 4.99 (JSON number)

v4.24.4.2¶

请查看本 SDK 版本的开发环境。

变更功能¶

• Windows 已移除 UI 中未使用的不必要资源。

v4.24.4.1¶

说明: 本 SDK 版本不提供单独的发布文件，对应功能已包含在更高版本 SDK 中。

变更功能¶

认证¶

• Windows 在 IdP 选择 UI 中，已调整 保持登录状态 UI 的选中状态显示，使其更容易明确识别。
• Windows 已修正 IdP 选择 UI 的英文翻译文案。
  • 变更前: Keep me logged in
  • 变更后: Stay signed in

v4.24.4.0¶

请查看本 SDK 版本的开发环境。

新功能¶

计费¶

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

营销归因¶

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

远程执行¶

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

修复的问题¶

分析¶

• iOS 修复同意横幅中仅选择一个选项时无法正确反映的问题。

v4.24.3.0¶

说明: 本 SDK 版本不提供单独的发布文件，对应功能已包含在更高版本 SDK 中。

请查看本 SDK 版本的开发环境。

新功能¶

营销归因¶

• Windows Appsflyer 1.0.1 ???+ warning Appsflyer（仅限 Steam）1.0.1 已发布。从 Hive SDK v4 24.0.0 版本开始，营销归因功能仅支持 Appsflyer 1.0.1 及以上版本。

插件¶

• Android iOS 提供 [插件] Unreal Engine 专用接口。



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

• Android iOS 提供支持新 Unreal Engine 专用接口的示例代码。

Provisioning¶

• All 新增在条款页面确认是否已获得法定代理人同意的功能。

变更功能¶

认证¶

• 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 即使拒绝了 App Tracking Transparency (ATT) 同意，也可以进行 Facebook 登录。
• Windows 在完成成人认证后加入设备管理服务时，如果超出一个手机号可注册的账号数量，将显示“已超过可使用同一手机号码注册的账号数量”错误消息。

推广¶

• Android iOS 已修改为通过 additionalInfo 发送的值不再包含不必要的信息。
• All 已调整为可按 2:3 或 3:2 比例显示全屏横幅。
• Android iOS 已将全屏横幅中的“1 天内不再显示”文本更改为“今天不再显示”。

营销归因¶

• Android iOS 已将 Adjust Signature 版本从 v1 变更为 v3。

库更新¶

• Android Google Play Billing Library 6.1 → 7.0 Google Play Service Games 20.0.0 → 20.1.2
• iOS Facebook SDK 16.2.1 → 17.0.2

修复的问题¶

• Android 通过修正资源引用逻辑，修复了无法获取内存的问题。
• iOS 修复在 iOS 14 设备上检查 App Tracking Transparency (ATT) 同意状态时偶发崩溃的问题。
• iOS 修复在相册中选择受限访问（仅允许访问部分照片）时发生崩溃的问题。

通知¶

• Android 修复在本地推送通知中设置不受支持的 type 时，推送消息无法正常显示的问题。
• iOS 已修改为会发送应用版本信息。

v4.24.2.1¶

请查看本 SDK 版本的开发环境。

新功能¶

社区¶

• Windows 已调整为遵循 Hive 规范的社区可使用非 withhive.com、com2us.com 的自定义域名地址。

v4.24.1.3¶

请查看本 SDK 版本的开发环境。

变更功能¶

认证¶

• Android iOS 已调整为设备管理服务会根据设备接入地区自动应用国际电话国家区号。

v4.24.2.0¶

说明: 本 SDK 版本不提供单独的发布文件，对应功能已包含在更高版本 SDK 中。

新功能¶

• Android iOS 在适用 GDPR 的 EU 和 EEA 地区，提供返回 16 岁以下用户是否同意条款的功能。可以确认是否未满 16 周岁。
• Android Android OS 11 以上设备或已安装支持模块的设备在使用相册时，默认使用 PhotoPicker。
• iOS 在 MacOS 控制台应用中也可以查看 Hive SDK 调试日志，并可从 Hive SDK 日志中选择特定日志类型查看。

认证¶

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

推广¶

• Android iOS 提供可控制交叉推广显示的功能。
• Android iOS 支持改进“今天不再显示”功能的N 天内不再显示。

变更功能¶

认证¶

• Windows 已调整为在 Google 登录时不再请求用于确认 Google Play Games 信息的 games_lite 权限。

推广¶

• iOS 在使用游戏邀请 (UA) 功能时，通过尽量减少剪贴板粘贴权限同意弹窗的显示来改善易用性。
  1. 将显示权限同意弹窗的时机从受邀用户刚启动应用时，变更为应用启动后初始化 Hive SDK 时。
  2. 调整为仅当剪贴板中存在邀请者 URL 数据时才显示弹窗。

通知¶

• Android 适配在 Amazon 新 Fire 设备上运行的运行时库 (Push Amazon Device Message 1.2.0)。

库更新¶

• Android Samsung GalaxyStore IAP 6.1 → 6.1.1 Amazon Device Message 1.0.1 → 1.2.0

分析¶

• iOS 将应用发生崩溃时把未发送日志保存到文件的选项 saveAnalyticsLogBeforeCrash 的默认值变更为 false。

修复的问题¶

认证¶

• 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 Plugin 参数的问题。

推广¶

• iOS 修复在新消息视图中执行显示新 Frame 视图操作时发生卡顿的问题。
• Windows 修复在 Promotion Custom Direct Fullscreen 中切换到 Frame 时发生崩溃的问题。

营销归因¶

• Android 修复以自定义条款执行初始化时，Adjust 事件发送延迟的问题。

Provisioning¶

• Windows 已修改为在重新查看条款时，不使用过去保存的数据，而是使用 Hive 服务器新下发的条款 URL 数据。

v4.24.1.2¶

请查看本 SDK 版本的开发环境。

修复的问题¶

认证¶

• Android 修复在 Google 登录过程中按下返回按钮取消登录时，没有适当响应回调的问题。该 bug 仅在 Hive 控制台中 Google Legacy Support 值为 true 时发生。
• Android 修复在低分辨率设备上无法进行键盘输入的问题。

v4.24.1.0¶

说明: 本 SDK 版本不提供单独的发布文件，对应功能已包含在更高版本 SDK 中。### 变更功能

• Windows 支持在 Hive SDK 实现的 UI 中通过游戏控制器移动鼠标。

库更新¶

• 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

分析¶

• iOS 调整为根据设备是否同意跟踪来决定是否显示同意横幅。
  • 如果拒绝跟踪同意，则不显示同意横幅。

修复的问题¶

计费¶

• iOS 修复了从 Hive SDK v4 24.0.0 以下版本（例如 v4 23.4.0）更新到 v4 24.0.0 时无法查询商品的问题。

v4.24.0.0¶

注意事项：本 SDK 版本不单独提供发布文件，对应功能已包含在更高版本 SDK 中。

新功能¶

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

认证¶

• Windows 新增了通过 Hive 社区登录实现 PC 游戏自动登录功能。

计费¶

• iOS 如果有首个订阅优惠信息，在查询商品信息时会一并传递。使用 getProductInfo 时，可在回调收到的 IAPV4Product 对象列表中通过 original_price 字段值与 price 字段值的差异确认优惠信息。

推广¶

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

变更功能¶

• iOS 在区分应用版本时，额外使用 CFBundleShortVersionString。
• Windows HIVE SDK 的 UI 及 WebView 已调整为根据 DPI 设置而非显示器分辨率进行显示。

认证¶

• Windows 已调整为在 Google 登录时可使用 Windows 中设置的默认 Web 浏览器的“隐身模式”进行登录。适用的 Web 浏览器如下。
  • Google Chrome
  • Microsoft Edge
  • Mozilla Firefox
  • Naver whale
• Windows 如果通过除上述 Web 浏览器之外的其他 Web 浏览器登录，则使用“普通模式”进行登录。

计费¶

• Android iOS 已将退款用户重新支付 UI 中显示的 PG 支付类型文案从 "HiveStore" 变更为 "PG 결제"。
• Android 已调整为在应用内 WebView 中而非应用内浏览器中显示 PG 支付页面。即使在不支持应用内浏览器环境的设备上，也支持 PG 支付。

库更新¶

• Android GooglePlay Services-Games 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 WeChat 2.0.2 → 2.0.4
• Hercules 2024.01.23 → 2024.04.11
• Singular 12.3.2 → 12.4.1
• Windows Steamworks 1.55 → 1.59

分析¶

• Android 将 Firebase 事件收集功能中广告标识符收集设置的默认值更改为 true。

修复的问题¶

认证¶

• Windows 修复了在中国实名认证时，认证时间过期后仍可输入认证码的问题。
• Windows 修复了特定网页（Apple 登录等）的语言仅显示为英文的问题。
• Windows 修复了在嵌套回调函数内部调用 IAPv4 getSubscriptionProductInfo 时，无法传递 SDK callback 的问题。
• Windows 修复了 Google 登录时，如果无法从 Google 获取头像就会登录失败的问题。 （已修改为即使无法获取头像也可以登录。）

计费¶

• Windows 修复了退款用户重新支付 UI 中 PG 支付显示为 Hive Store 的问题。
• Windows 修复了退款用户重新支付 UI 的阿拉伯语页面未使用符合阿拉伯语特性的 UI 的问题。

推广¶

• Windows 修复了 getBannerInfo、getBannerInfoString 函数无法运行的问题。
• Windows 已调整为使 Promotion API 在不依赖 AuthV4 认证的情况下也可运行。

其他¶

• Windows 修复了在特定尺寸的窗口中执行点击等输入事件时 UI 闪烁的问题。

已知问题¶

认证¶

• iOS 使用 Facebook SDK iOS 17.0.0 时，在 iOS 17.0 及以上设备上，如果用户不同意"应用跟踪透明度(App Tracking Transparency)"，则无法登录。若要在该条件下实现 Facebook 登录，请使用 Hive SDK v4 24.1.0。