SDK Unity 发布说明
本页介绍 Hive SDK Unity 各版本的主要更新内容。
Hive SDK Unity 按目标 OS 的更新内容通过以下 OS 标签区分。
- Android 适用于 SDK Unity Android 的更新内容
- iOS 适用于 SDK Unity iOS 的更新内容
- Windows 适用于 SDK Unity Windows 的更新内容
- All 同时适用于 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 文件文件夹的压缩包。
- 将整个文件夹复制到
Plugins/HIVESDK/Source/HiveSDKWindows/assets/additional 目录下并覆盖原文件。 - 重新构建应用。
- 在 Hive SDK v4 Unity 25.4.0 及以上版本中使用 SDK Manager 时，请升级到 SDK Manager v2.0.0 及以上版本。
v4.26.7.0
新功能
- Android 改善 Android 游戏控制器的操作性和 UI 焦点。
- 改善控制器操作，使用户可以移动鼠标指针来选择和控制 UI。
- 改善控制器操作，使用户可以更轻松地识别当前获得焦点的 UI 对象。
其他
- Android 作为 Google Level Up 计划的一部分，提供
GameStat 集成功能。
变更功能
合规
- Android 将 Google Age-Signal 更新至 0.0.4 版本。
Hercules
- Android iOS 将
Configuration 类的 SetUseHercules 方法标记为 Deprecated。 - 将 Hercules 库更新至
2026.08.31 版本。
v4.26.6.0
新增功能
身份验证
- Android 支持在日本本地市场 AGO（AnimateGo）中使用用户身份验证（登录）和应用内购买功能的集成流程。
- All 支持日本 DMM 平台的身份验证方式 DMM 登录。
计费
- Windows 支持在日本商店 DMM 购买商品。
其他
- Android 支持 Google Level Up 计划提供的 Sidekick 游戏内叠加层集成功能。
变更功能
计费
- Windows 当
marketConnect 方法执行期间 Google Play Games PC SDK 初始化失败且需要终止应用进程时，Hive SDK 将不再终止应用进程，而是返回以下错误代码。 - 新增错误代码
IAPV4PlayStoreActionRequiredShutdown（-6100706）。
- All 改进 UI，在无法完成购买时引导用户前往可用的支付路径（商店 + 平台）。这解决了退款用户在不同于原购买路径的平台上重新购买时，支付按钮仅被禁用而没有引导的问题。
- 市场匹配时：如果存在商品 PID，则可支付并正常显示支付按钮；如果没有商品 PID，则显示商品不可购买标题和禁用的支付按钮。
- 市场不匹配时：如果当前市场无法支付，UI 会以 Web Store PG(Windows) 2 项、Google Play(Android) 1 项等格式引导可用支付路径。
- iOS 在支持多个商店的环境中调用
marketConnect 方法时，更改逻辑，使部分商店连接失败不会被视为整个商店集成失败。
促销
- Windows 在窗口模式运行应用时，改进促销插页横幅，使整张横幅图片根据应用窗口大小缩放并完整显示。
- Windows 将促销插页横幅的“今天不再显示”功能变更为“N 天内不显示”功能。
营销归因
- Android iOS 支持自动向主要营销分析解决方案（MMP）发送登录事件。
- 与 Firebase、AppsFlyer、Singular 和 Adjust 集成时，会自动发送登录事件。
- Android iOS 支持为 Adjust 的跨营销跟踪在设备之间集成相同标识符。
库更新
- Windows Google Play Games PC SDK 25.5.818.0 → 26.3.312.0
Hercules
- Android Windows 将 Hercules 库更新至
2026.06.15。 - iOS 将 Hercules 库更新至 2026.07.06。
问题修复
促销
- iOS 修正版面，使屏幕加载期间显示的进度指示器 UI 位于屏幕中央。
- iOS 修复显示大型横幅时，宽高比超过 3:1 或小于 1:3 时 UI 布局无法正确显示的问题。
营销归因
- iOS 修复发送 Adjust 收益数据时自定义附加参数（
pub_param_revenue）缺失的问题。 - 现在发生收益事件时会与标准收益数据（
revenue_original）一起正确发送。
开发者指南变更事项
v4.26.5.0
新功能
认证
- Android iOS 支持越南 Funtap 商店，并应用增强的身份验证弹窗。新增一个需要以下详细字段作为参数的方法。
- serverId (服务器 ID)
- serverName (服务器名称)
- characterId (角色 ID)
- characterName (角色名称)
v4.26.4.0
请确认此 SDK 版本的 开发环境。
新功能
认证
- All 登录成功时，在返回的
PlayerInfo 对象中新增 isNewUser 字段，用于标识是否为新用户，支持手动追踪 NU(New User) 事件。
插件
- Windows 支持 Unity 6 的 New Input 系统。
变更功能
- Android 移除 OneStore 已弃用的 Maven 仓库 URL。
- iOS 在 iPad 设备环境中显示 SDK UI 时，新增控制屏幕底部 Home Indicator 可见性的选项。
- iOS 修复在网络监视模块完全激活前初始化其他模块导致 Hive SDK 初始化失败的问题。
认证
- All 本人认证请求时可传递用于识别用户的信息。
- Android Google 登录支持选择使用 Google Sign-In 或 Google Credential Manager（两者不可同时使用，否则构建失败）。
- iOS 支持越南 Funtap 市场发布所需的身份验证 WebView 弹窗（Android 自 26.2.0 版本起已支持）。
- Windows 统一设备管理服务中删除最后注册设备时的行为（与移动端一致，显示确认弹窗）。
聊天
- All （即将终止支持） soon 终止对
Chat.reconnect 的支持，手动重连功能改用 Chat.connect。详见 聊天升级指南。
营销归因
- iOS 设置自定义购买事件时，仅按各 MMP 提供的“专用标准购买事件”格式发送数据，不再使用自定义事件名发送。
库更新
- Android Adjust 5.4.2 → 5.6.1
- Appsflyer 6.17.3 → 6.17.6
- Singular 12.10.0 → 12.11.0
- Airbridge 4.7.1 → 4.9.4
- Facebook 18.0.1 → 18.2.3
- Line 5.11.1 → 5.12.0
- iOS Adjust 5.4.6 → 5.6.2
- Airbridge 4.8.1 → 4.9.3
- Appsflyer 6.17.2 → 6.17.9
- Firebase Analytics 12.5.0 → 12.12.0
- Singular 12.9.0 → 12.10.0
- Line 5.14.0 → 5.15.0
- QQ 3.5.18 → 3.6.20
- SDWebImage 5.21.1 → 5.21.7
- hercules 2025.02.18 → 2026.04.29
- Facebook 18.0.2 → 18.0.3
已修复问题
- Windows 修复接收到无法解析的 JSON 以外数据时发生崩溃的问题。
插件
- iOS 修复未使用
PushAction 模块时构建设置仍显示为激活状态的问题。 - iOS 修正 Swift Package Manager（SPM）打包规范，修复开发者使用 SPM 集成构建时 App Store Connect 验证失败的问题。
其他
- Windows 修复 Steam 环境中未集成 Hive SDK 的其他应用 Steam 登录回调导致应用崩溃的问题。
- Windows 修复同时运行两个以上集成 Hive SDK 的应用时，一侧应用反复打开/关闭 Hive 登录 WebView 导致客户端崩溃的问题。
v4.26.3.4
更改的功能
Compliance
- iOS Age Range 模块库根据
PermissionKit 依赖项分离为 HiveAgeRangeApple 和 HiveAgeRangePermissionApple。 - 实现巴西 ECA 合规时，仅使用不带
PermissionKit 依赖项的 HiveAgeRangeApple。 - 实现美国 App Store 责任法合规时，除 HiveAgeRangeApple 外，还需使用带
PermissionKit 依赖项的 HiveAgeRangePermissionApple。
v4.26.3.2
新功能
Billing
Compliance
- Android 为响应未成年人保护年龄验证法，Hive SDK 提供的 Age Range 模块新增支持巴西 ECA 法合规。
变更的功能
说明：此 SDK 版本仅更新版本号，不包含新功能或变更。
v4.26.3.0
v4.26.2.0
请确认此 SDK 版本的 开发环境。
新功能
- Windows 提供使用 OSR(Off-Screen Rendering)，通过游戏引擎 UI 系统在游戏画面上显示 Hive SDK 提供的 UI Overlay 功能。
认证
推广
- Android iOS 支持移动设备中全屏(Full-screen) WebView 和应用内浏览器的屏幕方向设置。
- 应用内浏览器的屏幕方向遵循 Hive 控制台中设置的显示方向(横屏/竖屏/双方向)。但在部分 Android 目标设备的应用内浏览器中，会遵循设备本身设置的方向。
分析
- All 除 Analytics 外，还额外提供 ThinkingData(TD) 服务。您可以在两种服务中选择其一，并设置数据采集与登录联动。
聊天
合规
- Android 扩展支持面向 Galaxy Store 发布应用的 Age Range 模块。
- 与 应对应用商店责任法 相关，现在也支持在通过 Galaxy Store 发布的游戏应用中使用 Age Range 模块来确认用户年龄信息。
变更功能
- Windows 进行了改进，即便 URI 中包含空域名，也能正常提取 URL 元素(协议、域名)。
认证
- All 利用 PASS 本人认证结果简化认证流程。
- 如果已通过 PASS(网页/应用) 完成本人认证，可利用认证结果中的用户信息跳过以下认证步骤。
- 跳过通过 PASS(网页/应用) 进行的成人认证步骤
- 跳过设备管理服务注册所需的 OTP 认证步骤
- 在本人确认服务执行过程中，只会执行 1 次本人认证，不会重复执行 PASS(网页/应用) 认证。
- All 当因同一手机号反复尝试认证导致 OTP 发送次数超限时，新增错误弹窗。
- 在设备管理服务中，如果同一手机号因反复尝试认证而超出 OTP 发送次数限制，将新增向用户说明认证失败原因的错误弹窗。
- Windows 调整为在 Windows 中也显示个人资料里的 Hive 账号设置 按钮。
推广
- Windows 现在可以 按照游戏指定的画面方向(横向或纵向)显示公告页面 UI。画面方向分为将标签从上到下排列(以屏幕左上角为基准)的横向型，以及从左到右排列的纵向型。
- Android iOS iOS 移除 YouTube 视频广告播放功能。
- 变更点: 移除原本在不统计播放量的情况下播放 YouTube 内容的视频广告功能
- 变更原因: 由于播放功能异常导致稳定性下降，且缺少实际使用案例，因此利用率较低
插件
- iOS 将 Hive SDK Unity iOS 中包含的 External-Dependency-Manager for Unity(EDM4U) 包升级到最新版本。
库更新
- Android OneStore Billing Library (Android): v21.02.00 → v21.04.00
已修复的问题
- Android 修复 Android 15(API Level 35) 显示屏挖孔区域 UI 重叠问题。
- 修复了在搭载 Android 15(API Level 35) 的设备中，SDK UI 渲染侵入显示屏挖孔区域(刘海/摄像头开孔)的问题。现在会考虑挖孔区域，并在安全区域(Safe Area)内正常显示所有 UI 元素。
v4.26.1.5
已修复的问题
- iOS 修复了在 iOS 26.4 环境中，使用 WebView 的弹窗(登录、横幅、客服中心、社区等)无法正常工作的错误。
v4.26.0.2
已修复的问题
- iOS 修复了在 iOS 26.4 环境中，使用 WebView 的弹窗(登录、横幅、客服中心、社区等)无法正常工作的错误。
v4.25.9.1
已修复的问题
- iOS 修复了在 iOS 26.4 环境中，使用 WebView 的弹窗(登录、横幅、客服中心、社区等)无法正常工作的错误。
v4.25.8.3
已修复的问题
- iOS 修复了在 iOS 26.4 环境中，使用 WebView 的弹窗(登录、横幅、客服中心、社区等)无法正常工作的错误。
v4.26.1.4
变更功能
认证
- Android 将使用 Credential Manager 的 Google 登录功能改为“选项启用(Opt-In)”方式。
- 变更原因: 在部分支持 16 KB 页面大小(pageSize) 的 Android 16(API Level 36) 设备中，使用 Credential Manager 的 Google 登录存在兼容性问题。
- 主要变更点: 将 Google 登录方式回退为原有的 Google Sign-In。
- 后续计划: 在后续发布的 Hive SDK Android 版本中，提供将“使用 Credential Manager 登录”作为默认登录方式启用的 API。
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
变更功能
认证
- Android iOS iOS 在中国地区进行 Hive 会员登录时，如果已完成手机号认证，则在中国实名认证阶段不再执行手机号认证，而是直接进入身份证认证。
- 现有 Hive 会员登录中执行的是会员 ID(邮箱地址)认证而非手机号认证，因此在后续中国实名认证阶段仍需进行手机号认证。
已修复的问题
- iOS 修复了执行 Apple Submission 时，错误生成的 bundle 文件 Info.plist 被包含在内，导致发行版本校验失败的问题。
- iOS 修复了在退款用户重新支付 UI 中，PG 支付显示为 Hive Store 的问题。
v4.26.1.1
说明: 此 SDK 版本不单独提供发布文件，对应功能包含在更高版本 SDK 中。
已修复的问题
插件
- iOS 修复了在 iOS 目标环境中设置外部库依赖之后，Hive SDK 版本信息无法被准确反映的问题。
v4.26.1.0
请确认此 SDK 版本的 开发环境。
新功能
认证
计费
推广
- All 支持 Deferred Deep Link。即使用户在未安装应用的状态下点击直达链接，也可在安装完成后跳转到链接中指定的应用内页面。
营销归因
远程游玩
- 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 成人认证方式不仅支持网页方式，也支持应用方式。
- 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 键传输营收值。
附加功能
- Android iOS 改进 通过游戏内 WebView 打开 时，通过 PlatformHelper 类的 showInAppView 方法显示的 WebView 关闭按钮可视性。
插件
- iOS 改进随 SDK 一并发布的 JSONObject 类兼容性。
- 避免与构建环境中的其他 JSONObject 类发生名称冲突。
配置
- Windows 在服务器维护、更新、公告和封禁弹窗中，调整为点击按钮时通过结束回调的方式处理退出。
- Android iOS 将可应对应用商店责任法的 Age Range API 以可选方式拆分提供。
- 2026 年 1 月 1 日起在美国得克萨斯州施行的应用商店责任法目前处于暂缓实施状态，可根据开发情况选择性应用。
- 可为应对 2026 年 5 月美国犹他州、7 月路易斯安那州施行的应用商店责任法而选择性应用。
库更新
- Windows 调整为使用 14.44.35211.0 及以上版本的 Microsoft Visual C++ Redistributable。
- 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 的背景不透明时，内容显示到挖孔区域内的问题。
认证
- 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 修复了在 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
配置
v4.26.0.0
请确认此 SDK 版本的 开发环境。
新功能
- iOS 现在可以在 iOS Xcode 26.2 及以上版本中构建 Hive SDK。
配置
- 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 及以上版本。
已知问题
配置
v4.25.8.2
请确认此 SDK 版本的 开发环境。
已修复的问题
支付
- Windows 修复了在 Google Play Games PC 支付中，当注册商品超过 20 个时无法获取全部商品信息的问题。
v4.25.8.1
说明: 此 SDK 版本不单独提供发布文件，对应功能包含在更高版本 SDK 中。
已修复的问题
其他
- Windows 修复了更改游戏语言后，关闭提示 UI 仍以初始设置语言显示的问题。
聊天
- Windows 修复了韩文消息不会触发回调的问题。
v4.25.9.0
请确认此 SDK 版本的 开发环境。
新功能
认证
- All 提供 本人确认服务。
- SteamDeck 不提供本人确认服务(本人确认、成人认证、监护人同意)。请先在移动端或 PC 上使用本人确认服务后，再在 SteamDeck 上重新接入游戏。
已修复的问题
其他
- Windows 修复了更改游戏语言后，关闭提示 UI 仍以初始设置语言显示的问题。
v4.25.7.1
说明: 此 SDK 版本不单独提供发布文件，对应功能包含在更高版本 SDK 中。
已修复的问题
其他
- Windows 通过应用 DX12 渲染器 GPU 同步增强了渲染稳定性。
- Windows 修复了推广公告中关闭按钮偶尔无法正常工作的已知问题。
v4.25.8.0
请确认此 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 Level 36)。
- Android 在以 Android OS 15(API Level 35) 及以上版本进行构建时，支持 16KB Page Size 构建。
游戏数据存储
聊天
变更功能
- 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 方法时，如果缺少必填输入数据，会导致崩溃。
远程游玩
- Windows 修复了即使通过
Application.CancelQuit 或 Application.wantsToQuit 取消远程游玩连接结束，连接仍会被关闭的问题。现在仅在应用真正退出时才会结束连接。
其他
- Windows 提升了对快速连续方法调用的稳定性。
分析
- 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 版本的 开发环境。
已修复的问题
认证
- iOS 修复了在横屏模式下显示聊天机器人时会发生崩溃的错误。
v4.25.5.1
说明: 此 SDK 版本不单独提供发布文件，对应功能包含在更高版本 SDK 中。
请确认此 SDK 版本的 开发环境。
新功能
认证
- Android iOS 新增 多账号切换 功能。相关详细功能如下。
- 将当前登录账号保存到设备
- 查询已保存账号
- 登出并删除已保存账号
- 使用其他已保存账号快速登录
推广
通知
- Android iOS 新增 推送动作按钮。
- 在收到推送通知时，可通过推送选择动作按钮执行预定义动作。
聊天
- 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 中。
认证
- Android iOS 调整为在不使用 Hive 会员账号的情况下调用原本无法工作的
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 在 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 版本的 开发环境。
新功能
认证
- Windows 新增 多账号切换 功能。相关详细功能如下。
- 将当前登录账号保存到设备
- 查询已保存账号
- 登出并删除已保存账号
- 使用其他已保存账号快速登录
- Windows 当已被停止游戏使用的用户尝试登录时，调整为仅在应用内登出而不关闭应用。
- Windows 可在 远程游玩插件 中使用增强认证协议。
其他
- Windows 新增可将 Hive SDK 及相关依赖 隔离到单独文件夹 的功能。
已修复的问题
其他
- Windows 解决了 Hive 功能行为的漏斗日志未统计问题。
v4.25.3.0
说明: 此 SDK 版本不单独提供发布文件，对应功能包含在更高版本 SDK 中。
新功能
推广
- Windows 调整为在调用
Promotion.getBannerInfo 时传递 typeCampaign 值。 - Windows 收集登录事件，以便在 输入邀请码的用户安装应用 时发放奖励。
其他
- Windows 新增在通过跨平台启动器启动游戏时，查询附加在启动 URI 上的 启动参数 功能。
- Windows 在控制器按键映射支持对象中新增 特定 UI。
- Windows 新增在可通过控制器按钮关闭时显示关闭按钮说明的 UI。
变更功能
库更新
- Windows 将 Chromium Embedded Framework 库版本更换为 128.45。
已修复的问题
其他
- Windows 修复了当游戏引擎设置默认鼠标光标时，WebView 关闭后进行鼠标操作会交替显示 Windows 默认光标的问题。
- Windows 修复了 Hive SDK 内部将非 JSON 而是 HTML 作为结果传递时发生错误的问题。
- 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 版本的 开发环境。
新功能
- Android iOS 支持 Unity 6.1 (6000.1)。
认证
- Windows 新增支持将 LINE 作为认证方式(IdP)。
匹配
配置
- Windows 新增对 按账号显示条款功能(
agreementDetermineBase) 的支持。
变更功能
认证
计费
- 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。
配置
- 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.transactionFinishIAPV4.transactionMultiFinishIAPV4.restore
营销归因
- Android 修复了在使用 Adjust 判断安装状态的功能时，会显示空白推送通知的问题。
- Android 修复了在使用 Airbridge 时，如果发生购买多个商品的事件，会根据单价和数量传递营收信息的问题。
配置
- Android iOS 修复了在 SDK 初始化之前执行广告模块(Adiz) 初始化时，即使需要遵守 COPPA 或 GDPR 等合规要求，用于年龄确认的
AgeGate 值仍按 hive_config.xml 中设置的值运行的问题。
聊天
已知问题
营销归因
v4.25.1.3
请确认此 SDK 版本的 开发环境。
变更功能
计费
- Android 将 PG 支付的行为方式更改为与其他计费(
IAPv4) 功能中的市场一致。如果正在应用 PG 支付，则必须参考 PG 支付 文档修改代码实现。
营销归因
已修复的问题
计费
- iOS 修复了显示询问是否同意传输消费信息的弹窗 UI 时，背景画面不透明的问题。
- iOS 修复了关闭询问是否同意传输消费信息的弹窗 UI 时，应用画面方向会朝非预期方向旋转的问题。
推广
- iOS 修复了显示包含图片的评论弹窗时，如果发生旋转事件，正在显示的图片会消失的问题。
营销归因
- iOS 修复了通过 Adiz 传输广告收益信息时，Airbridge 会将其识别为 AdMob 而非 Adiz 的问题。
v4.25.1.0
请确认此 SDK 版本的 开发环境。
新功能
认证
其他
变更功能
计费
- Windows 将 PG 支付的行为方式更改为与其他计费(
IAPv4) 功能中的市场一致。如果正在应用 PG 支付，则必须参考 PG 支付 文档修改代码实现。
推广
- Windows 调整通过
additionalInfo 传递的值，使其不再包含不必要的信息。
开发环境
- Windows 将所需的最低 Microsoft Visual C++ Redistributable 版本更新为 14.42.34438。
已修复的问题
认证
- Windows 修复了当用户选择 Hive 会员以外的登录方式后取消登录时，Hive SDK 控制器的鼠标操作功能仍会生效的问题。
v4.25.0.1
请确认此 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 版本的 开发环境。
新功能
认证
计费
推广
匹配
- Android iOS 更新匹配功能，新增支持 组匹配 功能。 ※ 与旧版本 Hive SDK Interface 不兼容。要使用更新后的匹配功能，必须使用 Hive SDK v4 25.0.0 及以上版本。
营销归因
其他
- Windows 在 ASUS ROG Ally 等搭载触摸屏的掌机设备中支持 触控手势。
- Windows 在使用游戏控制器时，新增支持 控制器按键映射，并可聚焦和操作部分 Hive UI 元素。
- Windows 新增支持应用 自定义光标，以替代普通鼠标光标。
- Windows 新增可启用或禁用游戏控制器操作的设置。
聊天
变更功能
认证
- Android iOS 删除不再使用的
Auth 模块类、接口、方法、代理和监听器。 - All 使用 JWT token 应用更强的安全协议。
- Android iOS 随着 TalkPlus 支持终止，删除 TalkPlus 认证 token 方法。
- Android 允许在 Apple 登录 WebView 中，除登录功能外还可进行找回密码等浏览操作。
推广
- Windows 在公告菜单标签中新增新内容提醒显示。
营销归因
- Android iOS 更新以支持 Adjust v5。
- Android iOS 调整为在通过 Adjust 统计 Adiz 广告营收时，将广告营收来源作为 AdMob 来源传输。
- Android 反映 Appsflyer 广告营收统计库已集成到主库中的变更。
- 6.14.2 → 6.15.2
- 移除 Appsflyer ad-revenue 库。
Unity
- All 改进 Hive Config Setting UI。
Hercules
已修复的问题
认证
- Android 解决了在执行
signIn 方法过程中，如果网络响应延迟发生，偶尔会占用 UI 线程的问题。 - Windows 修复了退款用户重新支付状态的用户在 PC 上登录时发生
CommonUnknown 错误的问题。 - Windows 改进 UI，使拖动“保持登录状态”文本时不会出现“隐私保护警告”文案。
计费
- iOS 修复了在使用 UserEngagement 引导用户购买应用内商品时，会额外触发
IAP_UPDATE 事件的问题。 - Windows 修复了在 Steam 支付过程中，如果通过 ESC 键或其他按键操作关闭 Overlay，就无法继续支付的问题。
其他
- 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 版本的 开发环境。
新功能
- Android iOS 支持 Unity 6(Unity 6000)。
- Windows 新增用于兼容 Hive SDK v4 Unity Android & iOS 24.5.0 Interface 的更新。
认证
- Android iOS 新增支持 Steam、X(原 Twitter) 作为认证方式。
- Android 提供可共享已认证会话的 应用内浏览功能。
推广
- Android iOS 在 Spot Banner 中也可展示广告。
- Android 在用户邀请分享功能中支持 X(原 Twitter)。
匹配
变更功能
认证
- Android iOS 调整冲突弹窗中显示的 Provider 名称。
插件
- Android iOS 应用提供的 EDM4U 最新版本。
- iOS 调整为在使用 GameCenter 登录时，自动 添加构建所需的 Entitlement 配置值。
- 现有即使使用 GameCenter 登录，也需要额外进行 Capability Manger 设置。
- 如果缺少 Entitlement 配置值，在 iOS 18 及以上设备中将无法正常登录。
已修复的问题
计费
- iOS 修复了当部分商品价格属于浮点数无法精确表示的类型时，在 JSON 格式中不会以循环小数而会以正确小数形式表示的问题。
- 例如>
4.99$ (string) → 4.9900000000000011 (double) → 4.99 (JSON number)
插件
- All 使用显式命名空间，以避免与部分外部插件产生导致编译错误的接口重复问题。
- Android 修复了在使用 Firebase 营销追踪工具或 Huawei 认证功能时，Android 目标平台所需设置缺失的问题(发生于 SDK v4 24.3.0 及以上版本)。
v4.24.4.2
说明: 此 SDK 版本不单独提供发布文件，对应功能包含在更高版本 SDK 中。
变更功能
- Windows 移除了 UI 中未使用的不必要资源。
v4.24.4.1
请确认此 SDK 版本的 开发环境。
新功能
远程游玩
- Windows 从 Hive SDK Unity Windows v4.24.4.1 及以上版本开始，支持 远程游玩。
变更功能
认证
- 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 服务。
远程执行
变更功能
插件
- Android iOS 调整为 Android 的 Package Name 或 iOS 的 Bundle Name 自动设置功能，可根据 Hive AppId 选择性生效。
已修复的问题
分析
- iOS 修复了在同意横幅中只选择一个选项时无法正确反映的问题。
v4.24.3.0
请确认此 SDK 版本的 开发环境。
新功能
营销归因
- Windows Appsflyer 1.0.1 ???+ warning 已发布 Appsflyer(Steam 专用) 1.0.1。从 Hive SDK v4 24.0.0 及以上版本开始，营销归因功能仅支持 Appsflyer 1.0.1 及以上版本。
配置
- 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 最小化 Hive External Dependency Manager 所管理的 XML 文件数量。
库更新
- 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 版本不单独提供发布文件，对应功能包含在更高版本 SDK 中。
新功能
社区
- Windows 调整为在遵循 Hive 规范的社区中，也可使用非 withhive.com、com2us.com 的 自定义域名地址。
v4.24.1.3
说明: 此 SDK 版本不单独提供发布文件，对应功能包含在更高版本 SDK 中。
变更功能
认证
- Android iOS 调整为在设备管理服务中根据设备接入地区自动应用国际电话国家区号。
v4.24.2.0
请确认此 SDK 版本的 开发环境。
新功能
- Android iOS 在适用 GDPR 的欧盟和欧洲经济区地区，提供返回 16 岁以下用户是否同意条款的功能。可借此确认用户是否未满 16 岁。
- Android 在 Android OS 11 及以上设备，或安装了支持模块的设备中使用相册时，默认使用 PhotoPicker。
- iOS 在 MacOS Console 应用中也可以查看 Hive SDK 调试日志，并可选择查看 Hive SDK 日志中的特定日志类型。
- All 提供在 Unity Editor 中控制 Hive SDK 调试日志 显示的功能。
认证
- All 当一个手机号可注册的账号数量超限时，如果请求发送认证码，将显示“已超出使用同一手机号可创建的账号数量。”错误信息。
- Windows 支持 Steam IdP 隐式登录。请使用
AuthV4.Helper.signIn。
推广
变更功能
认证
- Windows 调整为在 Google 登录时不再请求用于查看 Google Play Games 信息的
games_lite 权限。
推广
- iOS 在使用游戏邀请(UA) 功能时，通过最小化剪贴板粘贴权限同意弹窗的显示来改善使用性。
- 将显示权限同意弹窗的时点，从受邀用户启动应用后立即显示，变更为应用启动后初始化 Hive SDK 时显示。
- 调整为仅在剪贴板中存在邀请者 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 View 时发生卡顿的问题。
- Windows 修复了 Promotion Custom Direct Fullscreen 跳转到 Frame 时发生崩溃的问题。
营销归因
- Android 修复了使用自定义条款执行初始化时，Adjust 事件发送延迟的问题。
配置
- Windows 修复了在重新查看条款时，不再使用过去保存的数据，而是使用 Hive 服务器新下发的条款 URL 数据的问题。
v4.24.1.2
请确认此 SDK 版本的 开发环境。
已修复的问题
认证
- Android 修复了在 Google 登录过程中按下返回按钮取消登录时，没有适当响应回调的问题。该问题仅在 Hive 控制台中 Google Legacy Support 值为 true 时发生。
- Android 修复了低分辨率设备中无法进行键盘输入的问题。
v4.24.1.0
请确认此 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 版本的 开发环境。
新功能
- Windows 新增了当游戏服务终止后尝试初始化 Hive SDK 时，会返回 错误码 的功能。
认证
计费
- iOS 当存在首次订阅折扣信息时，会在查询商品信息时一并返回。使用
getProductInfo 时，可在回调接收的 IAPV4Product 对象列表中，通过 original_price 字段值与 price 字段值的差异确认折扣信息。
推广
变更功能
- iOS 在区分应用版本时，追加使用
CFBundleShortVersionString。 - Windows 调整为 HIVE SDK 的 UI 及 WebView 不再按显示器分辨率，而是按 DPI 设置输出。
认证
- Windows 调整为在 Google 登录时，可使用 Windows 默认 Web 浏览器的“隐身模式”进行登录。对应浏览器如下。
- Google Chrome
- Microsoft Edge
- Mozilla Firefox
- Naver whale
- Windows 如果使用上述浏览器之外的其他 Web 浏览器登录，则使用“普通模式”进行登录。
计费
- Android iOS 将退款用户重新支付 UI 中显示的 PG 支付类型文案从 "HiveStore" 更改为 "PG 支付"。
- Android 调整为 PG 支付页面使用应用内 WebView 而不是应用内浏览器显示。即使设备不支持应用内浏览器环境，也能支持 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。