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¶

• 微軟 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 網頁視圖通信期間未傳遞增強安全協議的 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¶

• 微软 Visual C++ 可再发行组件 14.42.34438 +
• Windows 10+
• 虚幻引擎 5.5.3

新功能¶

認證¶

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

行銷歸因¶

• 新增支持在發送行銷追蹤事件時向 Airbridge 發送額外屬性。

遠端遊玩¶

null

促銷¶

• 在新聞菜單標籤中新增了內容通知。

附加功能¶

• 新增對於使用遊戲控制器時的控制器鍵位映射支援，允許聚焦和操作某些 Hive UI 元素。
• 現在可以應用自定義游標，而不是標準的滑鼠游標。
• 新增設置以啟用或禁用遊戲控制器操作。
• 提供 Configuration.setUsePrivateBrowsingForAuth 函數，以設置在 Google 登錄期間是否使用私人瀏覽。
  • 設置也提供在 hive_config.xml 文件中。請參考 SDK Common Config。
• 提供 PlatformHelper.openBrowser 函數，以使用 URL 打開瀏覽器。請參考 In-Game Browser。

更改的功能¶

開發環境更新¶

• 更新 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¶

• 微軟 Visual C++ 可再發行套件 14.29.30133 +
• Windows 10+
• 虛幻引擎 5.4.4

新功能¶

• 不適用

更改的功能¶

常見¶

• 移除了在 UI 中未使用的不必要資源。

認證¶

• 在身份提供者選擇界面中，保持我登錄的選項已更改，以便更清晰可見。
• 身份提供者選擇界面中的英文翻譯文本已被修訂。
  • 之前：保持我登錄
  • 之後：保持登錄

不支援的功能¶

認證¶

• Auth 類別的功能不受支援，僅支援authentication v4的一些功能。
• 在 Windows 上，僅支援以下 IdP 登入。
  • Hive 會員
  • Google
  • Facebook
  • Apple 登入
  • Steam
• Hive SDK Unreal Windows 不支援訪客登入。
• Hive SDK Unreal Windows 不支援通過AuthV4 類別的showAdultConfirm() 方法進行成人身份驗證功能。

會員與社交¶

• The 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¶

• 微軟 Visual C++ 可再發行套件 14.29.30133 +
• Windows 10+
• Unreal Engine 5.4.4

新功能¶

計費¶

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

遠端啟動跨平台啟動器¶

• v4.24.4 .0 支援跨平台啟動器的遠端啟動。 有關使用的更多信息，請參閱 Crossplay Launcher Remote Launch 指南。

不支援的功能¶

認證¶

• 身份驗證 該類別的功能不受支持，僅支持身份驗證 v4的某些功能。
• 在 Windows 上，僅支持以下 IdP 登錄。
  • Hive 會員
  • Google
  • Facebook
  • 使用 Apple 登錄
  • Steam
• Hive SDK Unreal Windows 不支持訪客登錄。
• Hive SDK Unreal Windows 不支持AuthV4 類的showAdultConfirm()< /code>不支持通過該方法進行成人身份驗證。