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¶

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

新功能¶

認證¶

• 當一個被暫停遊戲訪問權限的用戶嘗試登錄時，應用程序現在會將他們登出，而不是關閉應用程序。

促銷¶

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

其他¶

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

更改的功能¶

其他¶

• 將 Chromium 嵌入式框架庫替換為版本 128.45。

錯誤修正¶

• 修正了一个问题：当在游戏引擎中设置了默认鼠标光标时，关闭 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¶

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

新功能¶

認證¶

• 新增對LINE作為新的身份提供者（IdP）的支持。

配對¶

• 增加對新 配對 功能的支持。

配置¶

• 增加了支持顯示基於帳戶的條款 (agreementDetermineBase)。

行銷歸因¶

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

變更¶

虛幻引擎 5¶

• 將 Unreal 插件從 HIVE_UNREAL_PLUGIN.dll 更改為 HIVE_PLUGIN_CPP.dll。
• 移除了 C API 以改善 Unreal Engine 的相容性。
  • 由於在調用應用 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+
• Unreal Engine 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 Common Config。
• 提供 PlatformHelper.openBrowser 函數以使用 URL 開啟瀏覽器。請參考 In-Game Browser。

更改的功能¶

開發環境更新¶

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

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

新功能¶

• 不適用

更改的功能¶

常見¶

• 移除了在 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立即返回下面的錯誤日誌。

 <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+
• 虚幻引擎 5.4.4

新功能¶

計費¶

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

遠端啟動 Crossplay Launcher¶

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

不支援的功能¶

認證¶

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