Windows

V4.25.2.0¶

下載¶

注意¶

安裝和使用此 Hive SDK 版本時，請務必先檢查以下內容。

認證¶

由於身份驗證安全協議的變更，當使用 Hive SDK v4 Unrel Engine 25.0.0 或更高版本時，您必須從 Hive 控制台 發佈安全金鑰 > 安全金鑰設置，通過 發佈安全金鑰。如果您不發佈安全金鑰，應用程序用戶將無法登錄應用程序。

付款¶

由於PG支付流程的變更，如果您使用的是Hive SDK v4 Unrel Engine 25.1.0或更高版本並應用PG支付，您需要參考PG支付操作流程文檔來修改您的代碼實現。

開發環境¶

虚幻引擎 4¶

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

新功能¶

認證¶

• 支援新的身份驗證方法 (IdP) Line。

配對¶

• 支援 配對系統 作為一項新功能。

配置¶

• 根據帳戶公開條款的功能(agreementDetermineBase) 已經添加。

行銷歸因¶

• AppsFlyer 提供在手動發送追蹤事件時發送自定義參數的能力。請參考 行銷歸因插件。

更改的功能¶

虚幻引擎 4¶

• 將現有的 HIVE_UNREAL_PLUGIN.dll 的虛幻插件更改為 HIVE_PLUGIN_CPP.dll。
• 由於虛幻引擎兼容性的改進，移除了 C API。
  • 由於在使用 STL 調用插件接口時發生崩潰，支持的替代 C API 被移除。

配置¶

• 在條款和條件詳細視圖及重新查看頁面中，以下情況將改為打開新的外部瀏覽器，而不是加載條款頁面（網頁視圖）。
  • 當導航到條款 URL 之外的網頁時
  • 當點擊條款內的超鏈接 HTML 標籤（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 版本時，請務必先檢查以下內容。

認證¶

由於身份驗證安全協議的變更，當使用 Hive SDK v4 Unrel Engine 25.0.0 或更高版本時，您必須 從 Hive 控制台獲取 安全密鑰 > 安全密鑰設置。 如果您未獲取安全密鑰，應用程序用戶將無法登錄應用程序。

付款¶

由於PG支付流程的變更，如果您使用的是Hive SDK v4 Unrel Engine 25.1.0或更高版本並且應用PG支付，您需要參考PG支付操作流程文檔來修改您的代碼實現。

開發環境¶

虛幻引擎 4¶

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

新功能¶

認證¶

• 新的身份驗證方法 (IdP) 支援 Telegram。請參考 為 Telegram 登入設置機器人。
• 新增對 X（前身為 Twitter）作為身份驗證方法的支援 在這裡。
• 提供 應用內瀏覽功能 以分享已驗證的會話。

行銷歸因¶

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

遠端遊玩¶

• 支持從 Hive SDK v4 UE4 Windows 25.1.0 及更高版本的遠端遊玩。

附加功能¶

• 新增對於使用遊戲控制器時的控制器鍵位映射支援，允許某些 Hive UI 元素被聚焦和操作。
• 新增支援應用自訂游標，而非標準滑鼠游標。
• 新增設定以啟用或禁用遊戲控制器操作。
• 提供函數 Configuration.setUsePrivateBrowsingForAuth 以配置在 Google 登入期間是否使用私人模式 這裡。
• 也提供 hive_config.xml 檔案中的設定 這裡。
• 提供函數 PlatformHelper.openBrowser 以使用 URL 開啟瀏覽器。

更改的功能¶

開發環境更新¶

• 更新 Microsoft Visual C++ Redistributable 的最低要求版本至 14.42.34438。

認證¶

• 使用 JWT 令牌應用更強大的安全協議。

促銷¶

• 修改通過 additionalInfo 發送的值，以排除不必要的信息。
• 在新聞菜單選項卡中添加新的內容通知。

付款¶

• 更改PG支付的行為，以與其他市場的計費（IAPv4）功能保持一致。如果您正在應用PG支付，請參考PG支付文檔以進行代碼實現修改。

其他¶

• 更新了Hercules庫的版本。
• Windows: 2024.11.20

修復的錯誤¶

認證¶

• 修正了一个问题，即在用户选择了除 Hive 会员之外的登录方式后取消登录时，Hive SDK 控制器可能会被操控。
• 修复了当处于退款重新支付状态的用户登录 PC 时出现的 CommonUnknown 错误。
• 改进了用户界面，以便在拖动“保持登录”文本时不会出现“隐私警告”消息。

付款¶

• 修正了一個問題，即在嘗試進行 Steam 付款後，使用 ESC 等鍵操作關閉覆蓋層會阻止進一步的付款。

其他¶

• 優化循環重複條件以恢復 CPU 使用率至正常。如果您使用的是受影響的版本（24.1.0 或更高版本），請更新至 25.1.0 並檢查 CPU 使用率是否穩定。

不支援的功能¶

認證¶

• Auth 類別的功能不受支援，僅支援Authentication v4 的某些功能。
• Windows 僅支援以下 IdP 登入：
  • Hive 會員
  • Google
  • Facebook
  • 使用 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 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

v4.24.4.2¶

下載¶

開發環境¶

虛幻引擎 4¶

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

新功能¶

• 不適用

更改的功能¶

常見¶

• 移除了在 UI 中未使用的多餘資源。

認證¶

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

不支援的功能¶

認證¶

• Auth 類別的功能不受支援，僅支援authentication v4的一些功能。
• 在 Windows 上，僅支援以下 IdP 登入。
  • Hive 會員
  • Google
  • Facebook
  • 使用 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 返回以下錯誤日誌。

 ErrorCode : IAPSUCCESS = 90, 
 Code : IAPV4HiveStoreSuccess = -6110000

此错误意味着该项目在购买后立即提供给用户，因此没有需要单独处理的内容。有关更多详细信息，请查看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¶

下載¶

開發環境¶

虛幻引擎 4¶

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

行銷歸因插件¶

• Appsflyer 1.0.1

新功能¶

認證¶

• 更改了設備管理服務，以根據設備訪問區域自動應用國際電話國碼。

付款¶

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

遠端執行¶

• 支援跨平台啟動器的遠端執行。欲了解更多使用資訊，請參考 跨平台啟動器遠端執行 API。

更改的功能¶

認證¶

• 當在成人驗證後註冊設備管理服務時，如果一個手機號碼可以註冊的帳戶數量超過，則會顯示以下錯誤消息。

  已超過可以使用相同手機號碼註冊的帳戶數量。

促銷¶

• 更改為允許以2:3或3:2比例顯示全螢幕橫幅。

配置¶

• 在條款和條件畫面中新增檢查法定代表人是否同意的功能。

不支援的功能¶

認證¶

• Auth 類別的功能不被支持，僅支持Authentication v4的一些功能。
• Windows 僅支持以下 IdP 登入：
  • Hive 會員
  • Google
  • Facebook
  • 使用 Apple 登入
• 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) 突出显示已实现的事件横幅以显示新闻页面。它作为新闻页面显示。