Android & iOS

v4.25.6.0¶

下载¶

开发环境¶

Cocos2d-x¶

• Cocos2d-x 3.17.2

安卓¶

iOS¶

• Xcode 16.1 或更高版本
• Xcode 版本必须根据 Apple App Store 政策 进行更新。

注释¶

• 由于身份验证安全协议的变化，当使用 Hive SDK v4 Cocos 25.0.0 或更高版本时，您必须在 Hive 控制台 > 安全密钥设置 中发放一个 安全密钥。没有安全密钥，应用程序将无法登录。

• 由于PG支付流程的变化，要使用Hive SDK v4 Cocos 25.1.3或更高版本的PG支付，请参考PG支付流程并更新您的代码实现。

新功能¶

聊天¶

• 全部 添加了在特定聊天消息上表达或显示“喜欢”的功能。
• 全部 添加了对特定聊天消息写“回复”的功能，并提供有关回复关系的信息。
• 全部 添加了提及特定用户的功能，并提供有关用户提及的信息。

更改的功能¶

聊天¶

• 所有 将 频道消息查询方法 从基于索引更改为基于消息 ID。

v4.25.5.1¶

新功能¶

认证¶

• 所有 提供了一个新的 多账户登录 功能。详细信息包括： * 将当前登录的账户保存到设备 * 查看保存的账户 * 登出并删除保存的账户 * 快速使用另一个保存的账户登录

促销¶

• 全部 添加了一个新的 直接链接功能。

通知¶

• 全部 添加了新的 推送操作按钮 功能。 * 接收到推送通知时，您可以通过推送操作按钮执行预定义的操作。

聊天¶

• 所有 消息发送 * 增加了将聊天消息自动翻译为用户语言的功能，以及翻译特定消息的能力。 * 增加了发送公告消息的能力，只有特定语言的用户可以接收。 * 在 websocket 消息中添加了消息 ID，以确保回调顺序。
• 所有 频道 * 增加了在进入聊天频道时查看以前聊天记录的能力。 * 提供当前频道的参与者数量。 * 在检索频道列表时增加了排序选项。
• 所有 事件管理 * 增加了 以二进制发送自定义数据事件的能力。
• 所有 连接管理 * 增加了重连功能。

更改的功能¶

常见问题¶

• Android 更新构建所需的混淆规则。
• iOS 之前单独的 HiveAppTrackingTransparents.framework 库现在已集成到 Service.framework 中。

认证¶

• 所有 当不使用 Hive 会员账户时，showMyInquiry 方法现在显示查询页面。
• 安卓 将 VK 认证弹窗从网页视图更改为应用内浏览器。

营销归因¶

• iOS 现在支持自动收集 Firebase 购买事件。

海克力士¶

• 所有 更新了海克力士库。 * 安卓 20250527 * iOS 20250218

修复的错误¶

配置¶

• iOS 修复了在显示条款时网页视图不滚动的问题。

促销¶

• iOS 修复了iPad设备上新闻UI的角半径。

分析¶

• iOS 修复了逻辑，以便在同意条款后可以立即发送分析日志。

v4.25.2.0¶

更改的功能¶

配置¶

• 全部 在条款详情和审查页面上，如果链接不是条款 URL 或包含超链接标签，它现在会在外部浏览器中打开。

认证¶

• 所有 更改了 VK 认证方法。新方法可以在 新的 VK 开发者控制台 中使用。

• iOS 更新了用于 Apple GameCenter 登录的已弃用 GameKit API 的验证协议。

• Android 由于对 Google Sign-In 库的支持结束，身份验证现在使用 Google Credential Manager 和 AuthorizationClient API 进行隐式和显式登录。

账单¶

• Android 当通过PG支付购买的产品被退款时，会添加一个order_id值以区分之前的交易。
• Android 在PG支付交易完成后，购买完成日志现在从客户端发送。

促销¶

• Android 将 Telegram 添加到 UserAcquisition 共享的曝光列表中。
• Android 更改了 webview 曝光的缓存策略。

营销归因¶

• 所有 添加了 Hive SDK 标识符以便于 与 MMP 服务集成。
• 所有 在手动跟踪事件时，现在可以添加 自定义属性。
• 安卓 在初始化 Airbridge 时，现在会发送市场来源信息。
• iOS 在使用 sendEventWithAttributes API 时，semantic value 类型浮点值的精度范围从 float 更改为 double。

聊天¶

• 所有 发送或接收消息数据时，现在会发送和接收extraData。
• 所有 连接到聊天服务器时，不再发送extraData。
• 所有 现在除了字符串时间值外，还接收整数时间值。
• 所有 当网络被阻塞且 websocket 无法正确断开时，已更改以便重连尝试不会因重复连接而失败。

其他¶

• 更新了外部库。 * Airbridge(Android) v4.1.0 → v4.3.0 * Airbridge(iOS) v4.1.1 → v4.3.0 * Adjust(Android) v5.0.1 → v5.2.0 * Adjust(iOS) v5.0.1 → v5.2.0 * Singular(Android) v12.6.1 → v12.7.0 * Singular(iOS) v12.6.1 → v12.7.1 * AppsFlyer(Android) v6.15.2 → v6.16.2 * AppsFlyer(iOS) v6.15.3 → v6.16.1 * QQ(iOS) 3.5.17.3 → 3.5.17.4

修复的错误¶

常见¶

• Android 当需要重试通信或连接到分布式服务器时，如果在最大超时之前收到响应，则立即重试或连接，而无需等待超时。

• iOS 修复了一个错误，即在使用 Configuration 类的 setZone 方法更改服务器组区域时，hive_config.xml 中的 gameLanguage 值会被重置。

供应¶

• 所有 在SDK初始化之前初始化广告模块（Adiz）并遵守COPPA或GDPR时，修复了一个错误，该错误导致AgeGate值根据hive_config.xml中设置的值进行操作。

认证¶

• iOS 修复了在 iOS 18 或更高版本的设备上 QQ 网页登录无法正常工作的错误。

营销归因¶

• Android 修复了使用 Adjust 确定安装状态时显示空推送通知的问题。

• Android 使用 Airbridge 时，修复了在购买多个商品时根据单价和数量发送销售信息的问题。

聊天¶

• Android 修复了连接到聊天时偶发的连接失败问题。

v4.25.1.3¶

更改的功能¶

营销归因¶

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

账单¶

• Android 更改了 PG 支付行为，以匹配其他计费 (IAPv4) 市场。如果使用 PG 支付，请参考 PG 支付流程 并更新您的代码。

v4.25.1.0¶

修复的错误¶

营销归因¶

• iOS 修复了一个错误，即通过 Adiz 发送的广告收入信息在 Airbridge 中被错误地标记为 AdMob，而不是 Adiz。

账单¶

• iOS 修复了一个错误，即同意发送消费信息的弹出 UI 显示为不透明背景。

• iOS 修复了一个错误，即在关闭同意发送消费信息的弹出 UI 时，应用屏幕意外旋转。

促销¶

• iOS 修复了在图像审查弹出窗口中发生旋转事件时图像消失的错误。

v4.25.0.0¶

新功能¶

认证¶

• 全部 添加了 Telegram 作为新的身份验证方法 (IdP)。请参见 Telegram 机器人设置以进行登录。

账单¶

• iOS 支持 请求用户同意发送应用内产品消费信息到 Apple App Store。

营销归因¶

• 所有 新增支持 向 Airbridge 发送附加属性以进行营销跟踪事件.
• 安卓 新增支持 Airbridge 延迟深度链接跟踪.

聊天¶

• 所有 新增支持 chat 功能。

匹配¶

• 全部 更新了匹配功能，以新支持 组匹配。

   <span style='color:#FF0000;'>※ 不兼容以前的 Hive SDK 接口。要使用更新的匹配功能，请使用 Hive SDK v4 25.0.0 或更高版本。</span>
  

更改的功能¶

认证¶

• 所有 移除了未使用的 Auth 模块类、接口、方法、委托和监听器。
• 所有 使用 JWT 令牌应用了更强的安全协议。
• 所有 由于 TalkPlus 支持结束，移除了 TalkPlus 身份验证令牌方法。
• 安卓 允许在 Apple 登录网页视图中浏览，例如密码恢复，而不仅仅是登录。

促销¶

• 所有 收集登录事件，以便在输入邀请码的用户安装应用时可以给予奖励。请参见这里。

营销归因¶

• 全部 更新以支持 Adjust v5。 * 移除了 Adjust Signature 库。
• 全部 在与 Adjust 聚合广告收入时，将 AdMob 作为广告收入来源。
• 安卓 将 Appsflyer 广告收入聚合库的集成反映到主库中。 * 6.14.2 → 6.15.2 * 移除了 Appsflyer 广告收入库。

其他¶

• 所有 更新的赫拉克勒斯库版本。 * 安卓: 20241120 * iOS: 20241120

修复的错误¶

认证¶

• Android 修复了在 signIn 方法执行期间，如果网络响应延迟，UI 线程间歇性占用的问题。

账单¶

• iOS 修复了一个错误，即在使用 UserEngagement 诱导应用内产品购买时，会发生额外的 IAP_UPDATE 事件。

v4.24.5.0¶

新功能¶

认证¶

• 所有 新增支持 Steam 和 X（前身为 Twitter）作为身份验证方法。 * 准备：通用 * 准备：Android * 准备：iOS * 品牌指南
• 所有 提供 应用内网页浏览功能，共享经过身份验证的会话。

配对¶

• 所有 新增支持 匹配服务。

促销¶

• 全部 Spot banners 现在支持广告曝光。
• 安卓 在用户邀请分享中添加了对 X（前身为 Twitter）的支持。

更改的功能¶

认证¶

• 所有 修改后的提供者名称显示在冲突弹出窗口中。

修复的错误¶

账单¶

• iOS 修复了无法精确表示为浮点数的价格，现在以准确的小数形式显示在 JSON 格式中。 * 示例： 4.99$ (字符串) → 4.9900000000000011 (双精度) → 4.99 (JSON 数字)

v4.24.4.0¶

新功能¶

营销归因¶

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

账单¶

• Android 支持通过PG支付购买所需数量的单一产品。

修复的错误¶

分析¶

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

v4.24.3.0¶

新功能¶

配置¶

• 所有 添加了在条款屏幕上检查是否已获得法定监护人同意的功能。

更改的功能¶

认证¶

• 所有 更改了注销行为。 * 之前：当调用signOut时，Hive SDK会注销用户帐户。来宾帐户在调用signOut API时会收到来自服务器的失败响应。 * 之后：当调用signOut时，Hive SDK请求Hive服务器确认用户帐户是否可以注销，并根据响应进行注销。
• 所有 在注销来宾帐户时，不再返回成功响应，而是返回错误代码。Hive SDK和Hive服务器保持来宾帐户会话。
• 所有 对于暂停的帐户，自动注销IdP，以便可以使用相同的IdP登录另一个帐户。仅在无法自动登录时适用。
• 所有 当使用AuthV4.connect链接IdP时，切换到暂停帐户现在会触发注销。
• 所有 设备管理服务现在会根据设备区域自动应用国际电话国家代码。
• iOS 即使拒绝了应用追踪透明度（ATT）同意，Facebook登录现在也是可能的。

促销¶

• 所有 修改以便在通过 additionalInfo 发送的值中不包含不必要的信息。
• 所有 更改为允许以 2:3 或 3:2 比例显示全屏横幅。
• 所有 将全屏横幅中的“1天内不显示”文本更改为“今天不显示”。

营销归因¶

• 全部 更改 调整签名 版本从 v1 到 v3.

修复的错误¶

Hive SDK 通用¶

• Android 修复了由于资源引用逻辑导致内存未释放的错误。
• iOS 修复了在 iOS 14 设备上检查 ATT 同意状态时的间歇性崩溃。
• iOS 修复了在相册中选择有限照片访问时的崩溃。

通知¶

• Android 修复了一个错误，该错误导致不支持的 type 设置在 本地推送通知 中导致推送消息无法显示。
• iOS 修改为发送应用版本信息。

v4.24.2.0¶

新功能¶

Hive SDK 通用¶

• 所有 提供一个功能以返回16岁以下用户是否同意条款在适用GDPR的欧盟和欧洲经济区地区。
• 安卓 在Android OS 11+或受支持的模块上，默认使用PhotoPicker进行相册访问。
• iOS 现在可以在MacOS控制台应用程序中检查Hive SDK调试日志，并且可以过滤特定的日志类型。

认证¶

• 所有 在超过每个电话号码的最大账户数量后请求认证代码时，显示错误信息：“超过可以使用相同电话号码创建的账户数量。”

促销¶

• 全部 提供对交叉推广曝光的控制。
• 全部 改进了“今天不显示”功能，以支持不显示N天。

更改的功能¶

通知¶

• Android 支持新亚马逊Fire设备的运行时库（推送亚马逊设备消息 1.2.0）。

促销¶

• iOS 通过最小化使用游戏邀请（UA）功能时的剪贴板权限弹出窗口，改善了可用性。 * 将弹出窗口的时机从应用启动更改为Hive SDK初始化。 * 仅在剪贴板中存在邀请者URL数据时，弹出窗口才会出现。

分析¶

• iOS saveAnalyticsLogBeforeCrash 选项的默认值现在是 false，该选项在崩溃时将未发送的日志保存到文件中。

修复的错误¶

认证¶

• 全部 在中国用户的实名验证中，修复了剩余时间未重置且在超过短信发送限制时显示错误消息的问题。
• 安卓 修复了在Google Play登录时按返回键未提供回调的错误。
• 安卓 修复了在低分辨率设备上无法输入键盘的错误。

促销¶

• iOS 修复了在新闻视图中显示新框架视图时的冻结问题。

营销归因¶

• Android 在使用自定义条款初始化时，调整事件发送的固定延迟。

v4.24.1.2¶

修复的错误¶

认证¶

• Android 修复了在 Google 登录期间按下返回按钮时未提供回调的错误。此错误仅在 Hive 控制台中启用 Google 旧版支持时发生。
• Android 修复了在低分辨率设备上无法输入键盘的错误。

v4.24.1.0¶

更改的功能¶

分析¶

• iOS 更改为根据设备跟踪同意来确定同意横幅的显示。 * 如果拒绝跟踪同意，则不显示同意横幅。

v4.24.0.0¶

新功能¶

促销¶

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

账单¶

• iOS 当产品首次订阅折扣时，产品信息查询返回 original_price 和 price 字段在 IAPV4Product 对象中以获取折扣信息。

更改的功能¶

Hive SDK 通用¶

• iOS 现在也使用 CFBundleShortVersionString 来区分应用版本。

账单¶

• 全部 在退款用户界面中将PG支付类型的措辞从“HiveStore”更改为“PG支付”。
• 安卓 将PG支付页面更改为在应用内网页视图中显示，而不是在应用内浏览器中显示。现在支持在不支持应用内浏览器的设备上进行PG支付。

分析¶

• Android 在Firebase事件收集中收集广告标识符的默认值现在是 true.

v4.23.0.0¶

下载¶

开发环境¶

Cocos2d-x¶

• 3.17.2

Android¶

iOS

• Xcode 15.0+
• Xcode 版本应根据Apple App Store 政策进行更新。

更改的功能¶

Hive SDK 通用¶

• Android 对Java Enum 接口ResultAPI类的访问方式已更改。请参见下面的示例。
  • 以前：仅支持ResultAPI.Companion.getSUCCESS()。
  • 更改：同时支持ResultAPI.Companion.getSUCCESS()和ResultAPI.SUCCESS。
• Android 在Java中同时支持实例方法风格和类方法风格。请参见下面的示例。
  • 以前：仅支持IAPV4.INSTANCE.getProductInfo。
  • 更改：同时支持IAPV4.INSTANCE.getProductInfo和IAPV4.getProductInfo。
• Android 已进行调整，以确保查询窗口、聊天机器人和成人认证窗口不会超出Z-Flip 5前显示屏的范围。
• iOS 支持的开发环境已更改为Xcode 15或更高版本。可以在macOS Ventura13.5或更高版本上使用。支持的操作系统如下：
  • iOS 12或更高版本
  • iPadOS 13或更高版本

认证¶

• 全部 对于设备管理、中国的实名认证等，如果用户在短信验证的时间限制内未输入短信，则发送按钮将被禁用。
• Android 每个IDP被分为可选应用的库。以下库可以额外应用：
  • Apple 登录
  • Weverse
  • 会员资格
• Android 仅信任在Google Play Games 登录期间由Hive 服务器直接验证的登录信息，解决了一些AuthV4ServerResponseError的情况。
• iOS Hive SDK使用的reCAPTCHA库已更新为官方版本。
• iOS 每个IDP被分为可选应用的库。以下库可以额外应用：
  • Apple 登录
  • GameCenter
  • 会员资格

促销¶

• 所有 更改已完成，以便屏幕上只显示新闻或插页横幅中的一个。只有第一个调用的窗口会出现，后续调用的窗口将不会出现。
• 所有 在UA 活动信息中包含campaignId。
• iOS 更新SDWebImage库，并应用与图像缓存和下载相关的LRU缓存策略。

Billing¶

• 全部 不再支持 IAPv2 接口和功能。
• Android 进行了更改，以便在有待处理的购买时，延迟的购买结果不会影响当前正在进行的支付。

配置¶

• 全部 添加了根据账户公开服务条款的功能

Hercules

• 所有 更新Hercules库版本。
  • Android: 20231122
  • iOS: 20231116

<

修复的错误¶

认证¶

• Android 修复了在显示葡萄牙语的使用限制弹出窗口时按钮显示不正确的问题。
• iOS 修复了在快速点击编辑个人资料图片时相机捕捉按钮导致应用崩溃的问题。

促销¶

• Android 修复了一个错误，即在游戏退出弹出窗口显示时，将应用从前台 > 背景 > 再次前台切换时，换行符无法正常工作。
• iOS 修复了通过推广横幅显示社区网页视图等时，顶部刘海区域被裁剪的问题。

配置¶

• iOS 修改为不显示暂停用户解除暂停的剩余时间。

数据存储¶

• iOS 如果您将空值作为参数传递给set方法，它现在会删除之前设置的值，以确保正常操作。

通知¶

• Android 修复了一个问题，该问题导致由于在重新启动应用程序时检索推送消息以进行显示的过程中出现问题，推送消息内容未显示。

Analytics

• 全部 在并发用户日志传输中，将未知国家发送的国家代码从 Unknown 更改为两个空格字符。

<

已知问题¶

此版本的 Hive SDK 没有已知问题。
<

开发者指南变更¶

常见

• 将COPPA ageGateU13更改为可以直接设置的值。
• 更新了hive_config.xml示例。
• 从这里删除了与不支持的IdP WEIBO相关的内容。
• 修订了in-app updates的描述。

Android

• 为Gradle、Android Gradle Plugin、Kotlin Gradle Plugin添加了最低版本。
• 由于Hive SDK功能被内部分离到单独的库中，已更改Android Gradle文件的内容。
• 已从AndroidManifest.xml设置中删除相关内容，因为WeChat Auth是由Hive SDK自动添加的。同时删除了内容，因为Hive SDK不直接使用FOREGROUND SERVICE。
• 已更改与在build.gradle中设置所需库相关的内容，以支持Facebook Cloud Game构建。
• 已更改模块级build.gradle文件的内容，以添加Firebase Analytics。
• 更新了添加Huawei构建设置。
• 已更改与在build.gradle中设置所需库相关的内容，以支持Google Play Games在PC构建中的内容。
• 已更改模块级build.gradle文件的内容，以支持Google登录。
• 已修订描述，因为ONE Store版本已更新为21.01.00。

iOS

• 在IdP集成指南中添加了Apple Game Center。
• 由于Hive SDK功能被内部划分为单独的库，因此更改了iOS Podfile的内容。