iOS
所需信息
- Hive SDK v4 Native 25.0.0 或更高版本:需要 安全密钥发放
- 由于身份验证安全协议的更改,使用 25.0.0 或更高版本时,您必须从 Hive 控制台发放安全密钥。没有它,将无法登录。
- Hive SDK v4 Native 25.1.3 或更高版本:需要 PG 支付实现更改
- 使用 Android 25.1.3 或更高版本的 PG 支付时,您必须根据 PG 支付流程 修改实现。
v4.26.1.0
下载
新功能
账单
认证
促销
- 支持延迟深度链接,当尚未安装应用的用户点击直接链接时,可以将用户引导至指定的应用内页面,即使在应用安装后。
附加组件
- 在游戏内网页视图中打开 提供了一个选项,可以使用游戏活动而不是 Hive 活动来显示网页视图,当使用 PlatformHelper 类的 showInWebView 方法暴露网页视图时。
其他
- 您可以使用
Configuration 类中的 getGameLanguage 方法检查 SDK 中配置的语言设置。 - 由于 CocoaPod 服务的终止,我们通过 SPM(Swift 包管理器)提供分发服务。
更改的功能
库更新
- 亚马逊应用商店 (Android) v3.0.4 → v3.0.8
- 三星 GalaxyStore IAP (Android) v6.1.1 → v6.5.0
- 谷歌计费库 (Android) v7.0.0 → v8.0.0
- QQ (Android) v3.5.17 → v3.5.18
- 小米 (Android) v3.2.5_12798 → v3.4.6
- 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
营销归因
- 更改以防止对发送到 MMP 的相同收据重复发送收入日志。
- 在发送 Firebase 购买事件时,将收入值添加到值键中。
账单
- 将用于 Google Play 结算的库更改为 Google Play Billing Library 8.0。
分析
- 更改了弹出窗口设计并改善了曝光DMA同意横幅的行为。
- 先前同意横幅的现有同意历史将被保留,并且在重新曝光时将显示改进的文本和新的同意横幅的用户界面。
- 如果您之前使用了自定义文本的同意横幅,则必须根据更改的数据结构重新配置,具体请参考自定义同意横幅用户界面设置。
认证
- 通过网页和应用程序方法支持成人验证。
- 移除 SNS 登录期间自动收集个人资料图片和昵称的功能。
- 由于添加了
AuthV4.setAutoLoginEnabled(默认:PC 关闭 / 移动设备开启),更改了自动登录行为政策如下: - 之前:在账户冲突后切换到另一个账户时,已更改的账户在移动设备上保持自动登录,而在 PC 上禁用自动登录
- 更改后:在账户冲突后切换到另一个账户时,如果使用
AuthV4.setAutoLoginEnabled 注册了自动登录会话,则已更改的账户在移动设备和 PC 上都保持自动登录,否则将禁用(存在例外)
推送
- 根据构建环境收集额外的令牌信息,以便在收集推送通知的令牌时使用。
促销
- 解决了在通过自定义视图/直接视图切换到外部浏览器时,webview闪烁的问题。
配置
- 提供年龄范围API作为响应应用商店问责法的可选功能。
- 原定于2026年1月1日在美国德克萨斯州生效的应用商店问责法目前已被推迟,因此您可以根据开发状态选择是否应用。
- 您可以选择在2026年5月响应在美国犹他州生效的应用商店问责法,以及在7月响应路易斯安那州的法案。
附加组件
- 在 使用游戏内网页视图 中,我们改善了通过 PlatformHelper 类的 showInAppView 方法暴露的网页视图的关闭按钮的可见性。
其他
Configuration.setZone 的行为已更改为仅在初始化之前有效。
修复的错误
营销归因
- 修复了Firebase中缺少安装或更新事件的问题。
认证
- 修复了在使用聊天机器人时聊天消息输入框间歇性不出现的问题。
- 修复了在设备管理中注册设备数量超过限制后,删除注册设备后成人验证弹窗再次出现的问题。
通知
- 修复了即使针对 Android COPPA 目标也会收集推送通知令牌的问题。
- 修复了 iOS ForegroundPush 设置未更改为 False 的问题。
促销
- 修复了当项目数量超过某个限制时,新闻菜单无法正常工作的问题。
- 修复了当全屏横幅上显示的图像的宽度或高度为 '0' 或服务器发送错误信息时,无法正常工作的问题。
- 修复了在没有 URL 参数的情况下通过直接链接暴露社区时,直接链接无法正常工作的问题。
附加组件
- 修复了在用户的网络状态为离线或在使用PlatformHelper类的showInAppBrowser方法时网络状态更改为离线时,游戏应用闪烁并关闭窗口的问题,详见使用游戏内浏览器打开。
v4.26.0.1
下载
更改的功能
常见
- Hive SDK开发环境的Xcode版本已更改如下:
- 之前:Xcode 26.2 Beta2
- 更改为:Xcode 26.2
v4.26.0.0 Beta
下载
新功能
配置
- 新增了合规性功能。
- 如果您将游戏应用分发到Apple App Store,Hive SDK提供**年龄范围API**以验证用户年龄范围,以响应2026年1月1日在美国德克萨斯州生效的App Store问责法。
- 仅支持iOS 26.2或更高版本。
常见
- Hive SDK 现在可以使用 iOS Xcode 26.2 或更高版本构建。
- 最低支持的操作系统版本是 iOS 15。
v4.25.9.0
下载
新功能
认证
v4.25.8.0
下载
开发环境
iOS
必需组件
- SDWebImage (iOS) v5.20.0 → 5.21.1
可选组件
身份提供者
- Facebook SDK (iOS) v17.4.0 → 18.0.0
- Google Sign-In SDK (iOS) v8.0.0 → 9.0.0
- QQ (iOS) v3.5.17.4 (自定义/重新分发) → 3.5.17.5 (自定义/重新分发)
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2 → 5.13.0
营销跟踪分析
- Airbridge (iOS) v4.3.0 → 4.7.0
- Adjust (iOS) v5.2.0 → 5.4.3
- Singular (iOS) v12.7.1 → 12.8.1
- AppsFlyer (iOS) v6.16.1 → 6.17.2
- FirebaseAnalytics (iOS) v11.6.0 → 11.15.0
其他
- Google reCaptcha (iOS) v18.6.0 → 18.7.0
重要说明
新功能
更改的功能
认证
- 移除在使用 Xcode 26 构建时无法使用的库的引用。
其他
- 更新外部库:
- 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
错误修复
认证
- 修复了聊天机器人弹出窗口在横屏模式下间歇性出现而不是竖屏模式的问题。
- 修复了防止空数组引用错误。
- 当使用Authv4类的
showConflict方法时,缺少必需的输入数据会导致崩溃。
v4.25.7.0
下载
注意:此 SDK 版本不提供单独的分发文件,功能包含在更高版本的 SDK 中。
新功能
认证
- 提供一个API以获取个性化的身份识别信息。
- 身份识别信息是一个哈希的DI值。在调用API并完成成人验证后,您可以使用此信息来识别已完成成人验证的用户。
更改的功能
认证
v4.25.6.0
下载
重要说明
- 由于身份验证安全协议的更改,当使用 Hive SDK v4 Native iOS 25.0.0 或更高版本时,您必须从 Hive 控制台 > 安全密钥设置 中发放安全密钥。没有安全密钥,应用程序将无法登录。
开发环境
iOS
必需组件
可选组件
IDP
- Facebook SDK (iOS) v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.17.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
营销跟踪分析
- Airbridge (iOS) v4.3.0
- Adjust (iOS) v5.2.0
- Singular (iOS) v12.7.1
- AppsFlyer (iOS) v6.16.1
- FirebaseAnalytics (iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
新功能
聊天
- 增加了在特定聊天消息上表达或显示“喜欢”的功能。
- 增加了对特定聊天消息进行回复并显示回复关系的功能。
- 增加了提及特定用户并显示提及信息的功能。
更改的功能
聊天
开发者指南变更
v4.25.5.2
下载
重要说明
- 由于身份验证安全协议的变化,当使用 Hive SDK v4 Native iOS 25.0.0 或更高版本时,您必须从 Hive 控制台 > 安全密钥设置 中 发放安全密钥。没有安全密钥,应用程序将无法登录。
开发环境
iOS
必需组件
可选组件
IDP
- Facebook SDK (iOS) v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.17.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
营销跟踪分析
- Airbridge (iOS) v4.3.0
- Adjust (iOS) v5.2.0
- Singular (iOS) v12.7.1
- AppsFlyer (iOS) v6.16.1
- FirebaseAnalytics (iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
错误修复
认证
v4.25.5.1
下载
重要说明
- 由于身份验证安全协议的更改,当使用 Hive SDK v4 Native iOS 25.0.0 或更高版本时,您必须从 Hive 控制台 > 安全密钥设置 中 发放安全密钥。没有安全密钥,无法在应用中登录。
开发环境
iOS
必需组件
可选组件
IDP
- Facebook SDK (iOS) v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.17.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
营销跟踪分析
- Airbridge (iOS) v4.3.0
- Adjust (iOS) v5.2.0
- Singular (iOS) v12.7.1
- AppsFlyer (iOS) v6.16.1
- FirebaseAnalytics (iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
新功能
认证
- 添加了 多账户切换 功能:
- 将当前登录的账户保存到设备
- 查看已保存的账户
- 登出并删除已保存的账户
- 快速使用另一个已保存的账户登录
促销
通知
- 添加了 推送操作按钮 功能:
- 在接收到推送通知时,您可以通过可选择的推送操作按钮执行预定义的操作。
聊天
- 消息发送
- 添加了将聊天消息自动翻译为用户语言的功能,以及翻译特定消息的能力。
- 添加了仅能发送给特定语言用户的公告消息功能。
- 添加了消息 ID 到 WebSocket 消息中,以保证回调顺序。
- 频道
- 添加了在进入频道时查看以前聊天记录的能力。
- 提供当前频道参与者的数量。
- 添加了检索频道列表时的排序选项。
- 事件管理
- 添加了以二进制格式传输自定义数据事件的功能。
- 连接管理
- 添加了重连功能。
更改的功能
常见
- 之前单独的
HiveAppTrackingTransparents.framework 库现在已集成到 Service.framework 中。
认证
showMyInquiry 方法现在即使在不使用 Hive 会员账户的情况下也会显示查询页面。
营销归因
- 现在支持启用时自动收集的 Firebase 购买事件。
海克力士
- 更新的海克力士库:
- 20241120 → 20250218
错误修复
配置
促销
分析
已知问题
- 在横屏模式下使用聊天机器人时会崩溃。
- 请更新到 Hive SDK iOS 25.5.2 或更高版本。
开发者指南变更
v4.25.2.2
下载
重要说明
- 由于身份验证安全协议的更改,当使用 Hive SDK v4 Native iOS 25.0.0 或更高版本时,您必须从 Hive 控制台 > 安全密钥设置 中 发放安全密钥。没有安全密钥,将无法在应用程序中登录。
开发环境
iOS
必需组件
可选组件
IDP
- Facebook SDK (iOS) v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.17.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
营销跟踪分析
- Airbridge (iOS) v4.3.0
- Adjust (iOS) v5.2.0
- Singular (iOS) v12.7.1
- AppsFlyer (iOS) v6.16.1
- FirebaseAnalytics (iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
v4.25.2.1
下载
重要说明
- 由于身份验证安全协议的变化,当使用 Hive SDK v4 Native iOS 25.0.0 或更高版本时,您必须从 Hive 控制台 > 安全密钥设置 发放安全密钥。没有安全密钥,应用程序将无法登录。
开发环境
iOS
必需组件
可选组件
IDP
- Facebook SDK (iOS) v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.17.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
营销跟踪分析
- Airbridge (iOS) v4.3.0
- Adjust (iOS) v5.2.0
- Singular (iOS) v12.7.1
- AppsFlyer (iOS) v6.16.1
- FirebaseAnalytics (iOS) v11.6.0
其他
- 谷歌 reCaptcha (iOS) v18.6.0
v4.25.2.0
下载
重要说明
- 由于身份验证安全协议的更改,当使用 Hive SDK v4 Native iOS 25.0.0 或更高版本时,您必须从 Hive 控制台 > 安全密钥设置 中 发放安全密钥。没有安全密钥,将无法在应用中登录。
开发环境
iOS
必需组件
可选组件
IDP
- Facebook SDK (iOS) v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.16
VK (iOS) v1.6.4 - WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
营销跟踪分析
- 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
- FirebaseAnalytics (iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
新功能
更改的功能
配置
- 更改了行为,以便如果条款页面链接是一个网址(而不是条款 URL)或包含超链接标签,它现在将在外部浏览器中打开。
认证
营销归因
- 添加了 Hive SDK 标识符以支持 MMP 服务集成。
- 在手动事件跟踪期间更改为 包含自定义属性。
- 将
sendEventWithAttributes API 中 semantic value 的精度从 float 更改为 double。
聊天
- 现在在发送或接收消息数据时发送和接收
extraData。 - 连接到聊天服务器时不再发送
extraData。 - 现在还接收整数类型的时间值,除了字符串类型。
- 改进了处理,以避免在因网络问题导致断开连接失败后尝试重新连接时出现重复的WebSocket连接。
其他
- 更新的外部库:
- 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) v3.5.17.3 → v3.5.17.4
错误修复
常见
- 修复了一个问题,即在 Configuration 类中使用
setZone 方法更改服务器组区域时,hive_config.xml 中的 gameLanguage 值会重置。
配置
- 修复了在COPPA/GDPR合规性中,当在SDK之前初始化Adiz广告模块时,_hive_config.xml_中的
AgeGate值被错误使用的问题。
认证
- 修复了在运行 iOS 18 或更高版本的设备上 QQ 网页登录无法正常工作的 issue。
开发者指南变更
开发环境更新
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) v3.5.17.3 → v3.5.17.4
v4.25.1.3
下载
注意事项
- 由于身份验证安全协议的更改,当使用 Hive SDK v4 Native iOS 25.0.0 或更高版本时,您必须通过 发放安全密钥 在 Hive 控制台 > 安全密钥设置中发放安全密钥。如果未发放安全密钥,应用用户将无法登录应用。
- 由于身份验证安全协议的更改,当使用 Hive SDK v4 Native iOS 25.0.0 或更高版本时,您必须通过 发放安全密钥 在 Hive 控制台 > 安全密钥设置中发放安全密钥。如果未发放安全密钥,应用用户将无法登录应用。
开发环境
iOS
必需
可选
IDP
- Facebook SDK iOS v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.16
- VK (iOS) v1.6.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
营销跟踪分析
- Airbridge(iOS) v4.1.1
- Adjust(iOS) v5.0.1
- Singular(iOS) v12.6.1
- AppsFlyer(iOS) v6.15.3
- FirebaseAnalytics(iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
新功能
更改的功能
营销归因
修复的错误
营销归因
- 在通过 Adiz 发送广告收入信息时,修复 Airbridge 发送到 AdMob 而不是 Adiz 的错误。
账单
促销
- 修复了在显示包含图像的评论弹出窗口时发生旋转事件导致显示的图像消失的错误。
v4.25.0.1
下载
注意事项
由于身份验证安全协议的变化,当使用 Hive SDK v4 Native iOS 25.0.0 或更高版本时,您必须从 Hive 控制台 > 安全密钥设置 获取 安全密钥。没有安全密钥,应用用户将无法登录应用。
开发环境
iOS
必需品
可选项
身份提供者
- Facebook SDK iOS v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.16
- VK (iOS) v1.6.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
营销跟踪分析
- Airbridge(iOS) v4.1.1
- Adjust(iOS) v5.0.1
- Singular(iOS) v12.6.1
- AppsFlyer(iOS) v6.15.3
- FirebaseAnalytics(iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
新功能
更改的功能
修复的错误
营销归因
- 修复了在使用 Hive SDK v4 25.0.0 或更高版本与 Adjust v5 时,自动收集并发送的 did 和 vid 值未被发送的问题。
v4.25.0.0
下载
注意事项
由于身份验证安全协议的更改,在使用 Hive SDK v4 Native iOS 25.0.0 时,您必须从 Hive 控制台 > 安全密钥设置发放安全密钥 在这里。如果您未获得安全密钥,应用用户将无法登录应用。
开发环境
iOS
必填项
可选项
IDP
- Facebook SDK iOS v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.16
- VK (iOS) v1.6.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
营销跟踪分析
- Airbridge(iOS) v4.1.1
- Adjust(iOS) v5.0.1
- Singular(iOS) v12.6.1
- AppsFlyer(iOS) v6.15.3
- FirebaseAnalytics(iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
新功能
认证
账单
营销归因
聊天
配对
※ 这与之前版本的 Hive SDK 接口不兼容。要使用更新的匹配功能,您必须使用 Hive SDK v4 25.0.0 或更高版本。
更改的功能
认证
- 移除了已弃用的
Auth模块类、接口、方法、委托和监听器。 - 使用JWT令牌应用了更强的安全协议。
- 由于停止支持TalkPlus,移除了TalkPlus身份验证令牌方法。
促销
- 收集登录事件,以便在输入邀请码的用户安装应用程序时可以授予奖励。
营销归因
- 更新以支持 Adjust v5。
- 更改为在与 Adjust 聚合 Adiz 广告收入时将广告收入来源发送为 AdMob。
- 6.14.2 → 6.15.2
- 移除了 Appsflyer 广告收入库。
其他
修复的错误
账单
开发者指南变更
- 由于在营销归因中移除了 Adjust Signature 库,集成 SDK 签名的方法已发生变化。
开发环境更新
iOS
- Xcode 15.3 → 16.1
- 更新到 Xcode 版本将最低 iOS 目标提高到 13。
- SDWebImage v5.19.7 → v5.20.0
- Facebook v17.1.0 → v17.4.0
- Google Sign-In v7.1.0 → v8.0.0
- LINE v5.10.0 → v5.11.2
- AirBridge v4.1.0 → v4.1.1
- AppsFlyer v6.14.3 → v6.15.3
- Adjust v4.38.4 → v5.0.1
- Singular v12.5.0 → v12.6.1
- Firebase v10.29.0 → v11.6.0
v4.24.5.0
下载
开发环境
iOS
必需的库
可选库
身份提供者
- Facebook SDK iOS v17.1.0
- Google Sign-In SDK (iOS) v7.1.0
- QQ (iOS) v3.5.16
- VK (iOS) v1.6.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.0
营销跟踪分析
- Adjust(iOS) v4.38.4
- AdjustSigSdk 3.20.1
- Singular(iOS) v12.5.0
- AppsFlyer(iOS) v6.15.3
- FirebaseAnalytics(iOS) v10.29.0
其他
- Google reCaptcha (iOS) v18.6.0
有什么新鲜事
认证
- Steam 和 X(前身为 Twitter)现在支持作为身份提供者(IdP)进行身份验证。
- 应用内浏览 现在支持提供带有身份验证会话的网页视图。
配对
促销
更改的功能
认证
修复的错误