iOS

v4.25.2.1¶

下载¶

重要说明¶

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

开发环境¶

iOS¶

• Xcode 16.1 或更高版本
• 请根据 Apple App Store 要求 更新您的 Xcode 版本。

必需组件¶

• SDWebImage (iOS) v5.20.0

可选组件¶

身份提供者¶

• 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.0¶

下载¶

重要说明¶

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

开发环境¶

iOS¶

• Xcode 16.1 或更高版本
• 请根据 Apple App Store 要求 更新您的 Xcode 版本。

必需组件¶

• SDWebImage (iOS) v5.20.0

可选组件¶

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）或包含超链接标签，它现在将在外部浏览器中打开。

认证¶

• 更改了 VK 认证方法。新方法可在 VK 开发者控制台 上使用。

• 更新了用于 Apple GameCenter 登录的过时 GameKit API 验证协议。

营销归因¶

• 添加了 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合规性期间，当Adiz广告模块在SDK之前初始化时，_hive_config.xml_中的AgeGate值被错误使用的问题。

认证¶

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

开发者指南变更¶

• 更新了基本设置 > 配置文件 > Unity，以反映HiveConfig编辑器的更改。
• 在身份验证 > 准备 > 常见中添加了LINE IdP集成设置。
• 在身份验证 > 准备 > IdP密钥输入中更新了VK登录方法。
• 添加了使用Singular、AppsFlyer、Firebase Analytics进行MMP集成的手动事件跟踪和添加自定义属性。
• 从营销归因 > 参考中删除了遗留的Adjust Signature V1设置。
• 添加了Airbridge应用市场标识符设置。
• 更新了聊天 > 连接管理，以反映重新连接和示例代码中的更改。

开发环境更新¶

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¶

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

必需¶

• SDWebImage (iOS) v5.20.0

可选¶

身份提供者¶

• 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

新功能¶

• 不适用

更改的功能¶

营销归因¶

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

修复的错误¶

营销归因¶

• 在通过 Adiz 发送广告收入信息时，修复 Airbridge 发送到 AdMob 而不是 Adiz 的错误。

账单¶

• 修复了在显示询问是否同意发送消费信息的弹出 UI 时背景不透明的错误。

• 修复了在关闭查询是否同意发送消费信息的弹出 UI 时，应用程序的屏幕方向意外旋转的错误。

促销¶

• 修复了在显示包含图像的评论弹出窗口时发生旋转事件导致显示的图像消失的错误。

v4.25.0.1¶

下载¶

注意事项¶

由于身份验证安全协议的更改，当使用 Hive SDK v4 Native iOS 25.0.0 或更高版本时，您必须从 Hive 控制台 > 安全密钥设置 获取一个 安全密钥。没有安全密钥，应用用户将无法登录应用。

开发环境¶

iOS¶

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

必需品¶

• SDWebImage (iOS) v5.20.0

可选项¶

身份提供者¶

• 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

其他¶

• 谷歌 reCaptcha (iOS) v18.6.0

新功能¶

• 无

更改的功能¶

• 无

修复的错误¶

营销归因¶

• 修复了在使用 Hive SDK v4 25.0.0 或更高版本与 Adjust v5 时，SDK 自动收集并发送的 did 和 vid 值未被发送的问题。

v4.25.0.0¶

下载¶

注意事项¶

由于身份验证安全协议的变化，在使用 Hive SDK v4 Native iOS 25.0.0 时，您必须从 Hive 控制台 > 安全密钥设置中发放安全密钥 在这里。如果您未获得安全密钥，应用用户将无法登录应用。

开发环境¶

iOS¶

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

必填项¶

• SDWebImage (iOS) v5.20.0

可选项目¶

身份提供者¶

• 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

新功能¶

认证¶

• 现在支持Telegram作为新的身份验证方法（IdP）。请参考Telegram登录的机器人设置。

账单¶

• 支持查询用户是否同意将in-app产品消费信息发送到Apple App Store。

营销归因¶

• 新增支持在发送营销跟踪事件时向 Airbridge 发送附加属性。

聊天¶

• 新增对聊天功能的支持。

配对¶

• 更新了匹配功能，现支持组匹配。

  ※ 此版本与之前的 Hive SDK 接口不兼容。要使用更新的匹配功能，您必须使用 Hive SDK v4 25.0.0 或更高版本。

更改的功能¶

认证¶

• 移除了弃用的Auth模块类、接口、方法、委托和监听器。
• 使用JWT令牌应用了更强的安全协议。
• 由于TalkPlus支持的终止，移除了TalkPlus身份验证令牌方法。

促销¶

• 收集登录事件以提高邀请码的准确性。

营销归因¶

• 更新以支持 Adjust v5。
  • 移除了 Adjust Signature 库。
• 更改为在与 Adjust 聚合 Adiz 广告收入时将广告收入来源发送为 AdMob。
  • 6.14.2 → 6.15.2
  • 移除了 Appsflyer 广告收入库。

其他¶

• 更新了赫拉克勒斯库的版本。
  • iOS: 20241120

修复的错误¶

账单¶

• 修复了一个错误，即在使用 UserEngagement 提示应用内购买时会额外发生 IAP_UPDATE 事件。

开发者指南变更¶

• 由于在营销归因中移除了 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¶

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

必需的库¶

• SDWebImage (iOS) v5.19.7

可选库¶

身份提供者¶

• 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）进行身份验证。
  • 前提条件：所有引擎
  • 前提条件：Android
  • 前提条件：iOS
  • 品牌指南
• 应用内浏览 现在支持提供带有身份验证会话的网页视图。

配对¶

• 匹配系统 已添加以帮助玩家找到其他人一起游戏。

促销¶

• 现在，您可以在 Spot Banner 上展示广告。

更改的功能¶

认证¶

• 更改了冲突弹出窗口中提供者的名称。

修复的错误¶

账单¶

• 修复了一个问题，即某些无法准确表示为浮点数的产品价格现在在 JSON 格式中正确显示为十进制，而不是重复的小数。
  • 示例： 4.99$ (字符串) → 4.9900000000000011 (双精度) → 4.99 (JSON)

开发者指南变更¶

• 更新了用于在交叉推广插页式横幅曝光中显示广告横幅的showCustomContents方法的note。
• 添加了关于在iOS上使用Steam登录的note。

开发环境更新¶

iOS¶

• SDWebImage 5.18.7 → 5.19.7
• reCaptcha 18.4.0 → 18.6.0
• Facebook 17.0.2 → 17.1.0
• QQ 3.5.16 → 3.5.17 (自定义)
• AppsFlyer 6.14.3 → 6.15.3
• Singular 12.4.1 → 12.5.0
• Firebase 10.22.0 → 10.29.0

v4.24.4.0¶

下载¶

开发环境¶

• Xcode 15.3+
  • Xcode 版本应根据 苹果 App Store 政策 更新。

可选¶

IDP¶

• Facebook SDK iOS v17.0.2
• 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.4.1
• AppsFlyer(iOS) v6.14.3
• FirebaseAnalytics(iOS) v10.22.0

Else¶

• Google reCaptcha (iOS) v18.3.0

有什么新鲜事¶

营销归因¶

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

更改的功能¶

• 不适用

修复的错误¶

分析¶

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

开发环境更新¶

iOS¶

• Xcode 15 -> 15.3

v4.24.3.0¶

下载¶

开发环境¶

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

必填¶

• Kotlin (Android) v1.8.0
• Kotlin Coroutine (Android) 1.4.3
• AndroidX (Android) v1.0.0+
• Constraint Layout (Android) v2.1.4
• Glide (Android) v4.13.0
• SDWebImage (iOS) v5.18.7

OPTIONAL¶

IDP¶

• Facebook SDK Android v17.0.0
• Facebook SDK iOS v17.0.2
• GooglePlay 服务-身份验证 (Android) v20.7.0
• GooglePlay 服务-游戏 v2 (Android) v20.0.0
• Google 登录 SDK (iOS) v7.1.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.16
• VK (Android) v3.5.1
• VK (iOS) v1.6.4
• 微信 (Android) v6.8.0
• 微信 (iOS) v2.0.4
• LINE (Android) v5.10.0
• LINE (iOS) v5.11.0
• 华为 (Android) v6.12.0.300

IAP¶

• 谷歌计费库 (Android) v7.0.0
• 三星GalaxyStore IAP (Android) v6.1.1
• OneStore (Android) v21.01.00
• 微信 (Android) v6.8.0
• 亚马逊 (Android) v3.0.4
• 华为 (Android) v6.13.0.300

推送¶

• 亚马逊 (Android) v1.2.0
• FCM（FirebaseCloudMessaging） (Android) v23.2.1

营销跟踪分析¶

• Adjust(Android) v4.38.5
• adjust-android-signature-3.20.1.aar
• Adjust(iOS) v4.38.4
• AdjustSigSdk 3.20.1
• Singular(Android) v12.5.4
• Singular(iOS) v12.4.1
• AppsFlyer(Android) v6.13.0
• AppsFlyer(iOS) v6.14.3
• FirebaseAnalytics(Android) v21.5.0
• FirebaseAnalytics(iOS) v10.22.0

其他¶

• GooglePlay 服务-审核 (Android) v2.1.0
• GooglePlay 服务-应用更新 (Android) v2.1.0
• Google reCaptcha (Android) v18.4.0
• Google reCaptcha (iOS) v18.3.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

新内容¶

配置¶

• 已添加一个功能，以检查是否在条款和条件屏幕上获得了法定代表人的同意。

更改的功能¶

认证¶

• 修改了注销行为。
  • 之前：当调用signOut时，用户账户会从Hive SDK注销。
  客户在调用signOut API时会收到来自服务器的失败响应。
  • 更改：当调用signOut时，Hive SDK将请求Hive服务器确认注销用户账户，并根据响应进行注销。
• 访客账户注销将不再返回成功响应，而是返回错误代码。访客账户会话将由Hive SDK和Hive服务器维护。
• 被暂停的账户将自动从IdP注销，以允许使用不同账户登录同一IdP。仅在无法自动登录的情况下适用。
• 使用AuthV4.connect方法与IdP集成时，切换到被暂停的账户将触发注销。
• 更改设备管理服务以根据设备访问区域自动应用国际电话国家代码。
• 更改为即使拒绝应用追踪透明度（ATT）同意也允许Facebook登录。

促销¶

• 修改以确保通过additionalInfo发送的值中不包含不必要的信息。
• 更改以允许以2:3或3:2比例显示完整横幅。
• 将完整横幅上的文本从“1天内不显示”更改为“今天不显示”。

营销归因¶

• 将Adjust Signature版本从v1更改为v3。

修复的错误¶

Hive SDK 通用¶

• 修复了在 iOS 14 设备上检查应用追踪透明度 (ATT) 同意时偶尔发生的崩溃。
• 修复了在照片库中选择限制访问（仅允许访问某些照片）时发生的崩溃。

通知¶

• 修改以发送应用版本信息。

开发环境更新¶

• Facebook SDK 16.2.1 → 17.0.2

开发者指南变更¶

• 术语“large banner”已更改为“full banner.”
• 对自定义本地推送通知中type字段的指导已更新。
• 现在表明可以使用Configuration.getLegalGuardianConsentAgree来检查法定监护人同意。
• 为有使用限制的帐户添加了IdP集成指导。
• 在手动更新或安装Hive SDK Unity时，您必须在构建应用之前删除XML文件。

v4.24.2.0 (2024-07-05)¶

有什么新鲜事¶

Hive SDK 通用¶

• 提供一个功能，用于返回在适用GDPR的欧盟和欧洲经济区中，16岁以下用户是否同意服务条款，并检查他们是否在16岁以下。在这里查看此功能。
• 允许在MacOS控制台应用程序中查看Hive SDK调试日志，并选择特定的日志类型进行查看。

认证¶

• 当使用单个手机号码可以注册的账户数量超过时，请求发送验证码将显示错误信息：“您已超过可以使用相同手机号码创建的账户数量。”
• 当使用单个手机号码可以注册的账户数量超过时，请求发送验证码将显示错误信息：“您已超过可以使用相同手机号码创建的账户数量。”

促销¶

• 提供控制交叉推广曝光的功能。
• 支持“N天内不再显示”功能，改进了之前的“今天不再显示”。

更改的功能¶

促销¶

• 通过最小化使用游戏邀请（UA）功能时的剪贴板粘贴权限同意弹窗来提高可用性。
  1. 将同意弹窗的出现时机从应用启动后立即改为应用启动后初始化 Hive SDK 时。
  2. 仅在剪贴板中有邀请者 URL 数据时显示弹窗。

分析¶

• 将saveAnalyticsLogBeforeCrash的默认值更改为false，该选项在发生崩溃时将未传输的日志保存到文件中。

错误修复¶

认证¶

• 在中国访问的用户进行实名认证时，如果超出了消息发送限制且剩余时间未重置，将显示错误信息。

促销¶

• 修复了在为新闻视图暴露新框架视图时发生冻结的问题。

开发环境更新¶

iOS¶

• 不适用

开发者指南变更¶

• 由于从 Hive SDK v4 24.2.0 开始停止支持 Facebook Cloud Games，以下页面已相应更新：
  • 设置 Unity
  • 设置 Unity > 配置 Facebook Cloud Games
  • 设置 Android
  • 计费
  • 通知
• 增强了对 Lebi 的 市场选择屏幕 的解释。

v4.24.1.3¶

下载¶

更改的功能¶

认证¶

• 在使用设备管理服务时注册移动设备时，国际拨号代码将根据设备的连接区域自动应用，而不是使用+82。

v4.24.1.2 (2024-06-27)¶

新内容¶

不适用

更改的功能¶

不适用

修复的错误¶

不适用

开发者指南更新¶

不适用

v4.24.1.0 (2024-05-14)¶

有什么新鲜事¶

不适用

更改的功能¶

Analytics

• 更改以确定是否根据设备是否同意跟踪来显示同意横幅。
  • 如果您拒绝同意跟踪，则不会显示同意横幅。

开发环境更新¶

iOS¶

• 根据苹果隐私清单政策更新外部库。
  • AppsFlyer(iOS) v6.13.1 → v6.14.3
  • QQ (iOS) v3.5.14 → v3.5.16
• 降级Facebook SDK。
  • Facebook SDK v17.0.0 → v16.2.1

修复的错误¶

Billing

• 修复了在将Hive SDK从低于v4 24.0.0（例如，v4 23.4.0）更新到v4 24.0.0时产品查询失败的问题。

开发者指南的更改¶

不适用

v4.24.0.0 (2024-04-30)¶

有什么新鲜事¶

Promotion¶

• 支持 SafariViewController 使用浏览器来暴露外部页面。您可以使用 PlatformHelper 类的 showInAppBrowser 方法暴露 应用内浏览器。

更改的功能¶

Hive SDK 常见¶

• 额外使用 CFBundleShortVersionString 来区分应用版本

Billing

• 退款用户还款界面中显示的PG支付类型短语已从“HiveStore”更改为“PG支付”。

开发环境更新¶

iOS¶

• 微信 2.0.2 → 2.0.4
• 赫拉克勒斯 2024.01.23 → 2024.04.11
• Singular 12.3.2 → 12.4.1

开发者指南的更改¶

• 对`displayOriginalPrice`的描述已更改。
• 对`displayPrice`底部的说明已更改。
• 第三方框架依赖项，设置iOS中的Podfile写作示例已更改。已从Hive SDK默认操作所需的强制框架中删除HiveAppTrackingTransparency和HiveResource。