Windows

v4.25.2.0¶

下载¶

注意事项¶

在安装或使用此版本的 Hive SDK 之前，请务必查看以下内容。

认证¶

由于身份验证安全协议的变化，当使用 Hive SDK v4 Unreal Engine 5 25.0.0 或更高版本时，您必须从 Hive 控制台 > 安全密钥设置 发放一个 安全密钥。如果不发放安全密钥，应用用户将无法登录。

账单¶

由于PG支付流程的变化，如果您使用的是Hive SDK v4 Unreal Engine 5 25.1.0或更高版本的PG支付，请参考PG支付流程文档并相应地更新您的实现。

开发环境¶

虚幻引擎5¶

• Microsoft Visual C++ 可再发行组件 14.42.34438+
• Windows 10+
• Unreal Engine 5.5.3

新功能¶

认证¶

• 添加对LINE作为新的身份提供者（IdP）的支持。

匹配¶

• 添加对新 匹配 功能的支持。

配置¶

• 添加了支持显示基于账户的条款 (agreementDetermineBase).

营销归因¶

• 添加了通过手动 AppsFlyer 跟踪事件发送自定义参数的能力。请参阅 营销归因插件。

更改¶

虚幻引擎5¶

• 将虚幻插件从 HIVE_UNREAL_PLUGIN.dll 更改为 HIVE_PLUGIN_CPP.dll。
• 删除了用于虚幻引擎兼容性改进的 C API。
  • 由于在调用应用 STL 的插件接口时发生崩溃，删除了替代的 C API。

配置¶

• 更新了服务条款的详细信息和重新显示页面的行为，以便在以下情况下在外部浏览器中加载，而不是在网页视图中：
  • 导航到服务条款 URL 之外的网页
  • 点击服务条款内容中的超链接（例如，<a> 标签，tel:// 链接）

营销归因¶

• 添加了Hive SDK标识符的传输，以支持营销归因。
• 更新为通过营销归因发送PG计费数据。

错误修复¶

• 修复了在 Hive SDK WebView 通信期间未传递增强安全协议的 JWT 令牌的问题。
• 修复了在堆叠多个 Hive SDK 方法回调后调用以下任何方法时应用程序会冻结的问题：
  • IAPV4.transactionFinish
  • IAPV4.transactionMultiFinish
  • IAPV4.restore

不支持的功能¶

认证¶

• 不支持Auth类的功能，仅支持Authentication v4的一些功能。
• 在Windows上，仅支持以下IdP登录方法：
  • Hive 会员
  • Facebook
  • Google
  • Line
  • SignIn-with-apple
  • Steam
  • Telegram
  • X
• Hive SDK Unreal Windows不支持访客登录。
• Hive SDK Unreal Windows不支持AuthV4类的showAdultConfirm()方法进行成人认证。

会员与社交¶

• Hive SDK Unreal Windows 仅支持会员和社交功能中的 联系我们 功能。

促销¶

• Hive SDK Unreal Windows 不支持审查或退出弹出窗口，因为没有可用的市场。
• Hive SDK Unreal Windows 不支持使用 getOfferwallState() 和 showOfferwall() 的 offerwall 功能。
• Hive SDK Unreal Windows 不支持通过 showUAShare() 进行用户获取。然而，可以通过 getAppInvitationData() 配置邀请屏幕。
• Hive SDK Unreal Windows 不支持 showNews 方法或在新闻页面上使用事件编号 (pid) 显示成就横幅。它仅显示新闻页面。

账单¶

• Hive SDK Unreal Windows 不支持促销 IAP 功能。
• Hive SDK Unreal Windows 不提供订阅计费系统。

通知¶

• Hive SDK Unreal Windows 不支持通知功能。

数据存储¶

• Hive SDK Unreal Windows 不支持数据存储功能。

其他不支持的功能¶

• 权限通知弹窗
• 权限通知屏幕的自定义
• Configuration 类中的 getPermissionViewData() 方法
• Configuration 类中的 getChannel() 方法
• Configuration 类中的 setChannel (...) 方法
• IAPV4 类中的 getAccountUuid() 方法
• Configuration 类中的 setConfigurations() 方法
• 远程日志
• Configuration 类中的 getHiveCertificationKey
• Configuration 类中的 setHiveCertificationKey
• Configuration 类中的 getUseLog（请使用 hive_config.xml）
• Configuration 类中的 setUseLog（请使用 hive_config.xml）
• Configuration 类中的 getHiveTimeZone
• Configuration 类中的 getAgeGateU16Agree
• Configuration 类中的 getHiveTheme
• Configuration 类中的 setHiveTheme
• Configuration 类中的 setHivePermissionViewOn
• Configuration 类中的 setHiveCommunityUrl
• Configuration 类中的 getCrossPromotionBannerShowing

v4.25.1.0¶

下载¶

注意¶

认证¶

由于身份验证安全协议的变化，当使用 Hive SDK v4 Unreal Engine 25.0.0 或更高版本时，您必须在 Hive 控制台的 安全密钥设置 中 发放安全密钥，通过 发放安全密钥。如果未发放安全密钥，应用用户将无法登录应用。

付款¶

由于PG支付流程的变化，如果您使用的是Hive SDK v4 Unreal Engine 25.1.0或更高版本与PG支付，您需要通过参考PG支付流程来修改您的代码实现。

开发环境¶

虚幻引擎5¶

• Microsoft Visual C++ 重新分发包 14.42.34438 +
• Windows 10+
• 虚幻引擎 5.5.3

新功能¶

认证¶

• 支持 Telegram 作为新的身份验证方法 (IdP)。请参考 为 Telegram 登录设置机器人。
• 新增支持 X（前身为 Twitter）作为身份验证方法。请参考 Hive 配置。
• 提供 网页内浏览功能 以共享经过身份验证的会话。

营销归因¶

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

远程游戏¶

• 支持从 Hive SDK v4 UE5 Windows 25.1.0 及以上版本的 远程游戏。

促销¶

• 在新闻菜单标签中添加了新内容通知。

额外功能¶

• 新增对游戏控制器的控制键映射支持，允许聚焦和操作某些 Hive UI 元素。
• 现在可以应用自定义光标，而不是标准鼠标光标。
• 添加了启用或禁用游戏控制器操作的设置。
• 提供了Configuration.setUsePrivateBrowsingForAuth函数，以设置在 Google 登录期间是否使用私人浏览。
  • 设置也提供在hive_config.xml文件中。请参阅SDK 通用配置。
• 提供了PlatformHelper.openBrowser函数，以使用 URL 打开浏览器。请参阅游戏内浏览器。

更改的功能¶

开发环境更新¶

• 更新 Microsoft Visual C++ 可再发行组件的最低要求版本至 14.42.34438。

认证¶

• 使用JWT令牌应用更强大的安全协议。

促销¶

• 修复了在作为 additionalInfo 发送的值中包含不必要信息的问题。
• 在新闻菜单标签中添加了新的内容通知。

账单¶

• 将PG支付的操作更改为与其他计费（IAPv4）功能一致。如果应用PG支付，请参考PG支付流程以更新您的代码实现。

杂项¶

• 更新了赫拉克勒斯库的版本。
• Windows: 2024.11.20

已解决的错误¶

认证¶

• 修复了在用户选择了除 Hive 会员之外的登录方式后取消登录时，Hive SDK 控制器仍然允许鼠标操作的问题。
• 修复了在退款重新支付状态下用户登录 PC 时出现的 CommonUnknown 错误。
• 改进了 UI，使得在拖动“保持我登录”文本时不会出现“隐私警告”文本。

付款¶

• 修复了用户在尝试进行Steam支付后，使用ESC等键操作关闭覆盖层后无法继续支付的问题。

杂项¶

• 优化了循环重复条件，以恢复 CPU 使用率到正常。如果您正在使用受影响的版本（24.1.0 或更高版本），请检查在更新到 25.1.0 后 CPU 使用率是否稳定。

不支持的功能¶

认证¶

• 不支持Auth类的功能，仅支持Authentication v4的某些功能。
• 在Windows上，仅支持以下IdP登录：
  • Hive 会员
  • 谷歌
  • 脸书
  • Apple登录
  • Steam
  • X
  • Telegram
• Hive SDK Unreal Windows不支持游客登录。
• Hive SDK Unreal Windows不支持通过AuthV4类的showAdultConfirm()方法进行成人验证。

会员与社交¶

• Hive SDK Unreal Windows 不支持除 联系我们 以外的任何会员和社交功能。

促销¶

• Hive SDK Unreal Windows 不支持审查或终止弹出窗口，因为当前没有市场。
• Hive SDK Unreal Windows 不支持通过 getOfferwallState() 和 showOfferwall() 提供墙功能。
• Hive SDK Unreal Windows 不支持通过 showUAShare() 进行用户获取。然而，可以通过 getAppInvitationData() 配置邀请屏幕。
• Hive SDK Unreal Windows 不支持通过使用 showNews 方法和事件编号 (pid) 强调已实现事件的横幅。它实际上作为新闻页面显示。

账单¶

• Hive SDK Unreal Windows 不支持促销 IAP 功能。
• Hive SDK Unreal Windows 不提供基于订阅的支付系统。
• Hive SDK Unreal Windows 不支持 Hive Ruby。

通知¶

• Hive SDK Unreal Windows 不支持通知功能。

数据存储¶

• Hive SDK Unreal Windows 不支持数据存储功能。

其他不支持的功能¶

• 权限通知弹出窗口
• 权限通知屏幕的自定义
• 配置类的 getPermissionViewData() 方法
• 配置类的 getChannel() 方法
• 配置类的 setChannel (...) 方法
• IAPV4 类的 getAccountUuid() 方法
• 配置类的 setConfigurations() 方法
• 远程日志记录
• 配置类的 getHiveCertificationKey
• 配置类的 setHiveCertificationKey
• 配置类的 getUseLog（被 hive_config.xml 替代）
• 配置类的 setUseLog（被 hive_config.xml 替代）
• 配置类的 getHiveTimeZone
• 配置类的 getAgeGateU16Agree
• 配置类的 getHiveTheme
• 配置类的 setHiveTheme
• 配置类的 setHivePermissionViewOn
• 配置类的 setHiveCommunityUrl
• 配置类的 getCrossPromotionBannerShowing

开发者指南更新¶

• 更新了 Hive X IdP 集成所需的预定义格式。

v4.24.4.2¶

下载¶

开发环境¶

虚幻引擎 5¶

• Microsoft Visual C++ 可再发行组件 14.29.30133 +
• Windows 10+
• 虚幻引擎 5.4.4

新功能¶

• 不适用

更改的功能¶

常见¶

• 移除了在用户界面中未使用的不必要资源。

认证¶

• 在身份提供者选择用户界面中，保持我登录的选项已更改，以便更清晰可见。
• 身份提供者选择用户界面中的英文翻译文本已修订。
  • 之前：保持我登录
  • 之后：保持登录状态

不支持的功能¶

认证¶

• Auth 类的功能不受支持，仅支持authentication v4的一些功能。
• 在Windows上，仅支持以下IdP登录。
  • Hive会员
  • 谷歌
  • 脸书
  • 苹果登录
  • Steam
• Hive SDK Unreal Windows不支持访客登录。
• Hive SDK Unreal Windows不支持通过AuthV4类的showAdultConfirm()方法进行成人身份验证功能。

会员与社交¶

• Hive SDK Unreal Windows不支持除联系我们以外的会员和社交功能。

促销¶

• Hive SDK Unreal Windows 不支持审核或终止弹出窗口，因为目前没有市场。
• Hive SDK Unreal Windows 不支持通过 getOfferwallState() 和 showOfferwall() 提供的优惠墙功能。
• Hive SDK Unreal Windows 不支持通过 showUAShare() 进行用户获取。然而，可以通过 getAppInvitationData() 配置邀请屏幕。
• Hive SDK Unreal Windows 不支持使用 showNews 方法和事件编号 (pid) 通过突出显示已实现事件横幅来显示新闻页面。它的操作方式是显示新闻页面。

账单¶

• PG支付不会发出收据，物品在支付时直接通过游戏服务器从Hive服务器交付给用户。
• PG支付的购买在调用purchase()方法后，会通过结果API立即返回以下错误日志。

 <strong>ErrorCode : IAPSUCCESS = 90</strong>, 
 <strong>Code : IAPV4HiveStoreSuccess = -6110000</strong>

此错误意味着该项目在购买后立即交给用户，因此没有需要单独处理的内容。有关更多详细信息，请查看Hive PG支付介绍。
• PG支付不提供基于客户端的收据。有关更多详细信息，请查看Hive PG支付介绍。
• Hive SDK Unreal Windows不支持促销IAP功能。
• Hive SDK Unreal Windows不提供基于订阅的支付系统。
• Hive SDK Unreal Windows不支持Hive大厅。

通知¶

• Hive SDK Unreal Windows 不支持通知功能。

数据存储¶

• Hive SDK Unreal Windows 不支持数据存储功能。

其他不支持的功能¶

• 权限通知弹窗
• 自定义权限通知屏幕
• Configuration类的getPermissionViewData()方法
• Configuration类的getChannel()方法
• Configuration类的setChannel (...)方法
• IAPV4类的getAccountUuid()方法
• Configuration类的setConfigurations()方法
• 远程日志记录
• Configuration类的getHiveCertificationKey
• Configuration类的setHiveCertificationKey
• Configuration类的getUseLog (被hive_config.xml替代)
• Configuration类的setUseLog (被hive_config.xml替代)
• Configuration类的getHiveTimeZone
• Configuration类的getAgeGateU16Agree
• Configuration类的getHiveTheme
• Configuration类的setHiveTheme
• Configuration类的setHivePermissionViewOn
• Configuration类的setHiveCommunityUrl
• Configuration类的getCrossPromotionBannerShowing

v4.24.4.0¶

下载¶

开发环境¶

虚幻引擎5¶

• Microsoft Visual C++ 可再发行组件 14.29.30133 +
• Windows 10+
• 虚幻引擎 5.4.4

新功能¶

账单¶

• 添加了在请求 PG 付款时使用 IAPv4.purchase API 请求多数量购买的能力。

跨平台启动器的远程启动¶

• v4.24.4 .0 支持跨平台启动器的远程启动。有关使用的更多信息，请参阅 跨平台启动器远程启动 指南。

不支持的功能¶

认证¶

• 身份验证 该类的功能不受支持，仅支持身份验证 v4的一些功能。
• 在 Windows 上，仅支持以下 IdP 登录。
  • Hive 会员
  • 谷歌
  • 脸书
  • Apple 登录
  • Steam
• Hive SDK Unreal Windows 不支持游客登录。
• Hive SDK Unreal Windows 不支持AuthV4类的showAdultConfirm()方法不支持通过该方法进行成人身份验证。