Windows

v4.25.3.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

新功能¶

认证¶

• 当一个用户的游戏访问权限被暂停时，如果他们尝试登录，应用程序现在会将他们登出，而不是关闭应用程序。

促销¶

• 修改了 Promotion.getBannerInfo 以传递 typeCampaign 值。
• 增加了在 发放邀请码 时使用 安装 作为奖励动作的支持。

其他¶

• 添加了specific UI elements到控制器按键映射支持列表中。
• 添加了用户指导的UI，当关闭按钮可以通过控制器按钮输入时。
• 添加了支持检索启动参数，这些参数附加在通过Crossplay Launcher启动游戏时的启动URI上。

更改的功能¶

其他¶

• 用版本128.45替换了Chromium嵌入式框架库。

错误修复¶

• 修复了一个问题：当在游戏引擎中设置了默认鼠标光标时，关闭 webview 后 Windows 默认光标间歇性出现。
• 修复了在 Hive SDK 中返回 HTML（而不是 JSON）时发生的错误。
• 改进了 Steam 市场链接失败时返回的错误代码的粒度。
• 修复了在离线模式下尝试登录 Steam 时未返回回调的问题。
• 解决了在基于 Direct3D 12 的 Unreal Engine 5 中进行 webview 覆盖时发生的错误。

不支持的功能¶

认证¶

• 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()` 的 UA。不过，您可以使用 `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.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+
• 虚幻引擎 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() 的提供墙功能。
• 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支付流程以更新您的代码实现。

杂项¶

• 更新了Hercules库版本。
• 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 会员
  • 谷歌
  • 脸书
  • 苹果登录
  • Steam
  • 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() 提供的优惠墙功能。
• 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会员
  • 谷歌
  • 脸书
  • Apple登录
  • 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()方法不支持通过该方法进行成人身份验证。