SDK Unreal Engine 5 版本說明¶

本指南按版本介紹 Hive SDK Unreal Engine 5 的主要更新。

Hive SDK Unreal Engine 5 各目標作業系統的更新用以下作業系統標籤區分。

• Android SDK Unreal Engine 5 Android 更新
• iOS SDK Unreal Engine 5 iOS 更新
• Windows SDK Unreal Engine 5 Windows 更新
• All SDK Unreal Engine 5 Android、iOS 和 Windows 更新

必要項目¶

在使用 Hive SDK 各發佈版本之前，我們將指導您進行與版本特定限制相關的必要設定。

• **使用 Hive SDK v4 Unreal Engine 5 25.0.0 或更高版本時，必須取得安全金鑰（請參閱 ../../operation/appcenter/securitykey_settings.md）。 **
  • 由於身分驗證安全協定的變更，使用 Hive SDK v4 Unreal Engine 5 25.0.0 或更高版本時，您必須從 Hive 控制台 > 安全金鑰設定 取得安全金鑰（請參閱 ../../operation/appcenter/security_pkeycenter/xkey.如果您未取得安全性金鑰，則無法登入應用程式。
• Hive SDK v4 Unreal Engine 5 25.1.3 或更高版本需要對 PG 支付實作進行更改
  • 若要在 Android 和 iOS 25.1.3 或更高版本，或 Windows 25.1.0 或更高版本上實現 PG 支付，您必須參考 PG 支付操作流程 修改 PG 支付實現代碼。
• 在 Hive SDK v4 Unreal Engine 5 Windows 25.8.1 中，點擊推廣插頁式廣告橫幅時，連結無法正確跳轉。要解決此問題，您必須使用以下方法替換插頁式廣告橫幅的 HTML 檔案。
  1. 下載並解壓縮包含修改後 HTML 檔案的 zip 檔案。
  2. 複製整個資料夾，並覆蓋 Plugins/HIVESDK/Source/HiveSDKWindows/assets/additional 目錄下的現有檔案。
  3. 重新建構應用程式。

v4.26.1.5¶

修復的錯誤¶

• iOS 修正了在 iOS 26.4 環境下使用 WebView 的彈出視窗（登入、橫幅、客戶服務、社群等）無法正常運作的錯誤。

v4.26.0.2¶

修復的錯誤¶

• iOS 修正了在 iOS 26.4 環境下使用 WebView 的彈出視窗（登入、橫幅、客戶服務、社群等）無法正常運作的錯誤。

v4.25.9.1¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

修復的錯誤¶

• iOS 修正了在 iOS 26.4 環境下使用 WebView 的彈出視窗（登入、橫幅、客戶服務、社群等）無法正常運作的錯誤。

v4.25.8.3¶

修復的錯誤¶

• iOS 修正了在 iOS 26.4 環境下使用 WebView 的彈出視窗（登入、橫幅、客戶服務、社群等）無法正常運作的錯誤。

v4.26.1.4¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

變更功能¶

Authentication¶

• Android 已將使用憑證管理員登入 Google 的功能變更為「選擇加入」。
• 變更原因：在某些支援 16 KB 頁面大小的 Android 16（API 等級 36）裝置上，透過憑證管理員登入 Google 有相容性問題。
• 主要變更：已將 Google 登入方式還原為現有的 Google 登入方式。
• 未來計畫：未來版本的 Hive SDK Android 將提供一個 API，用於將「使用憑證管理員登入」設定為預設登入方式。

v4.26.1.3¶

修復的錯誤¶

Authentication¶

• iOS 修正了在 iPad 裝置上，觸碰 AgeGate 彈出視窗（需要輸入出生日期資訊）或行事曆相關彈出視窗中的空白區域時，應用程式會凍結（無回應）的錯誤。
• iOS 修正了在 iOS 裝置上執行裝置管理服務時，某些彈出視窗中顯示不必要的捲軸的錯誤。

Billing¶

• iOS 修正了呼叫 getAccountUUID 方法時傳回值變更的錯誤。

Promotion¶

• Android 修正了當遊戲應用程式在背景運行時，如果發生用戶互動（UE）直接連結事件，促銷彈窗就會消失的錯誤。

Marketing Attribution¶

• iOS 修正了在解析度低於 1170px 的 iOS 裝置上無法顯示《數位市場法》(DMA) 同意橫幅的部分文字的錯誤。

v4.26.1.2¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

變更功能¶

Authentication¶

• Android iOS 如果您在登入中國區HYIVE會員帳號時已驗證過手機號碼，我們將變更流程，以便您在進行中國實名驗證時直接進行身分驗證，無需再次驗證手機號碼。
• 由於現有的HYIVE會員登入流程僅驗證您的會員ID（信箱地址），而不驗證您的手機號碼，因此您必須在後續的中國實名驗證步驟中驗證您的手機號碼。

修復的錯誤¶

• iOS 修正了由於在 Apple 提交過程中包含了錯誤產生的捆綁檔案 Info.plist 而導致分發版本驗證失敗的錯誤。
• iOS 修正了退款用戶重新付款介面中 PG 付款顯示為 Hive Store 的錯誤。

v4.26.1.0¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

檢查此 SDK 版本的開發環境。

新功能¶

Authentication¶

• All 我們提供了 AuthV4.checkAgeGate 方法，該方法會顯示一個彈出視窗供使用者輸入出生日期，並在使用者輸入日期後以回呼函數的形式傳回該值。
• All 新增了 AuthV4.setAutoLoginEnabled 方法（../../dev/authv4/login-helper.md#set-auto-login-enabled），該方法會將下一個登入會話（而非目前會話）註冊為自動登入會話（ON/OFF）。當設定為 ON 時，如果透過登入方法執行登入操作，則該登入工作階段將會儲存為自動登入工作階段。之後，可以透過執行 AuthV4.Helper.signIn 或在登入期間執行帶有 ProviderType.AUTO 的 AuthV4.signIn 來使用自動登入功能。
• Android 支援使用小米帳號登入。

Billing¶

• Android 它支援使用小米計費。

Promotion¶

• All 它支援延遲深度鏈接，即使應用安裝完成，點擊直接鏈接後，尚未安裝應用的用戶也會被重定向到鏈接中指定的應用內頁面。

Marketing Attribution¶

• Windows 我們正在推出 Appsflyer for Native PC，它可以在 Steam 以外的桌面 PC 環境中傳輸必要的資訊。
• Windows 從 Airbridge 1.1.4 版本開始，新增了一項功能（延遲傳輸），用於在使用者登入後將安裝事件日誌傳送到 MMP 伺服器。透過在登入後發送安裝事件日誌，遊戲公司可以將包括玩家 ID 在內的帳號資訊傳輸到 MMP 伺服器。

Remote Play¶

• Windows 從 Remote Play 外掛程式 1.01.02 或更高版本開始，在 Remote Play 運行時點擊外部連結即可在遠端裝置上開啟頁面。因此，即使在 Remote Play 期間也可以進行 PG 付款。

Add-ons¶

• Android 在遊戲內 WebView 中開啟 提供了一個選項，可以在使用 PlatformHelper 類別的 showInWebView 方法公開 WebView 時使用遊戲 Activity 而不是 Hive Activity。

Others¶

• All 您可以使用 Configuration 類別中的 getGameLanguage 方法檢查 SDK 中已設定的語言設定。
• iOS CocoaPod 服務終止後，我們透過 SPM（Swift Package Manager）提供分發服務。

變更功能¶

• Windows 透過改進HTTP通訊邏輯，提高了穩定性。

Authentication¶

• Android iOS 我們支援透過網頁和應用程式進行年齡驗證。
• All 移除 透過 SNS 登入時自動收集個人資料圖片和暱稱。
• All 透過新增 AuthV4.setAutoLoginEnabled(預設值：PC 關閉/行動裝置開啟)，自動登入行為策略變更如下：
• 之前：在帳戶衝突後切換到其他帳戶時，新帳戶在行動裝置上保持自動登錄，但在 PC 上停用自動登入。
• 變更後：在帳戶衝突後切換到其他帳戶時，如果已使用 AuthV4.setAutoLoginEnabled 註冊了自動登入會話，則新帳戶在行動裝置和 PC 上均保持自動登入；否則，停用自動登入（存在例外情況）。
• Windows 在 SteamDeck 中使用身份驗證功能時，會新增一個關於 Pass 不支援的通知彈出視窗。
• Android 變更設置，使用戶在使用 Google 登入時同時使用憑證管理員和 Play 服務驗證。在憑證管理員故障轉移期間，請嘗試使用 Play 服務驗證登入。

Billing¶

• Windows PG付款方式已變更為透過外部瀏覽器進行。
• Android 將用於 Google Play 結算的庫變更為 Google Play 結算庫 8.0。

Promotion¶

• Windows 修正了透過自訂視圖/直接視圖導覽至外部瀏覽器時 WebView 閃爍的錯誤。
• Android iOS 修正了透過自訂視圖/直接視圖導覽至外部瀏覽器時 WebView 閃爍的錯誤。

Push¶

• iOS 在收集推播通知的令牌時，根據建置環境變更收集其他令牌資訊的方法。

Marketing Attribution¶

• Android iOS 顯示 DMA 同意橫幅 的彈出視窗設計已更改，其行為也已改進。
• 現有同意橫幅的先前同意歷史記錄將被保留，重新顯示時，將顯示一個文字和使用者介面均已改進的新同意橫幅。
• 如果您先前為現有同意橫幅使用了自訂文本，則必須參考自訂同意橫幅使用者介面設定 重新配置文本，以符合變更後的資料結構。
• Android iOS 做出更改是為了防止將相同收據的重複銷售記錄發送到 MMP。
• Android iOS 新增了在傳送 Firebase 購買事件時，將銷售額也傳送到「value」鍵的功能。
• 先前，銷售額被傳送到「revenue」鍵。

Add-ons¶

• Android iOS 改進了 PlatformHelper 類別的 showInAppView 方法在 開啟遊戲內 WebView 中顯示的 WebView 關閉按鈕的可見性。

Plugins¶

• Android iOS 在 HiveConfig 設定選單中新增儲存按鈕。

Provisioning¶

• Windows 將伺服器維護、更新、通知和阻止彈出視窗中按一下按鈕時的終止方法變更為終止回呼傳遞方法。
• Android iOS 我們單獨提供年齡範圍 API，以便根據《應用商店責任法案》的要求進行應用。
• 《應用商店責任法案》將於2026年1月1日在美國德州生效，目前暫緩實施，可依開發情況選擇性地應用。
• 也可選擇性地應用，以符合將於2026年5月在美國猶他州和2026年7月在美國路易斯安那州生效的《應用商店責任法案》。

Library updates¶

• Windows Microsoft Visual C++ Redistributable 已變更為使用 14.44.35211.0 或更高版本。
• Android 亞馬遜應用商店 (Android) v3.0.4 → v3.0.8
  • 三星 GalaxyStore IAP (Android) v6.1.1 → v6.5.0
  • Google 計費庫 (Android) v7.0.0 → v8.0.0
  • QQ (安卓) v3.5.17 → v3.5.18
  • 小米 (Android) v3.2.5_12798 → v3.4.6
• iOS Adjust (iOS) 5.4.3 → 5.4.6
• Airbridge (iOS) 4.7.0 → 4.8.1
• AppsFlyer (iOS) 6.17.2 → 6.17.7
• Firebase (iOS) 11.15.0 → 12.5.0
• Singular (iOS) 12.8.1 → 12.9.0
• Facebook (iOS) 18.0.0 → 18.0.2
• Line (iOS) 5.13.0 → 5.14.0
• QQ (iOS) 3.5.17.5 → 3.5.18
• SDWebImage (iOS) 5.21.1 → 5.21.5

Others¶

• All Configuration.setZone 的行為已更改為僅在初始化之前有效。

修復的錯誤¶

• Android 如果整個公共區域的 UI 背景是不透明的，請對其進行修改，使其在鏤空區域內可見。

Authentication¶

• iOS 修正了使用聊天機器人時聊天訊息輸入欄位間歇性不顯示的錯誤。
• iOS 修正了以下錯誤：當裝置管理中已註冊的裝置數量超過限制時，如果已註冊的裝置在通過成人驗證後被刪除，則成人驗證彈出視窗會重新出現。
• Windows 修正了在 AuthV4 身份驗證期間嘗試退出時應用程式無法關閉的問題。
• Windows 修正了當另一個應用程式（或重新啟動的應用程式）在請求身份驗證頁面的應用程式關閉後請求身份驗證時，由於先前請求的身份驗證結果傳輸錯誤，導致出現錯誤（-1200001, -8）的問題。

Promotion¶

• iOS 修正了當新聞項目數量超過某個限制時，新聞選單無法正常運作的錯誤。
• iOS 修正了當正面橫幅上顯示的影像寬度或高度為「0」或伺服器傳輸錯誤訊息時，系統無法正常運作的錯誤。
• iOS 修正了透過直接連結公開社群時，如果缺少 URL 參數則直接連結無法正常運作的錯誤。
• Windows 修正了點擊促銷活動中的「今天不顯示」選項會導致促銷活動永久停止顯示的問題。

Push¶

• Android 修正了在 Android 環境中透過推送執行深度連結時 scheme 遺失的錯誤。
• Android 修正了即使針對 COPPA 目標也會收集推播通知令牌的錯誤。
• iOS 修正了 ForegroundPush 設定未更改為 False 的錯誤。

Marketing Attribution¶

• iOS 修復了 Firebase 中缺少安裝或更新事件的錯誤。
• Windows 修正了行銷歸因的購買日誌被重複收集的問題。

Remote Play¶

• Windows 修正了在遠端播放中更新 JWT 令牌時發生的崩潰問題。

Add-ons¶

• iOS 修正了當遊戲應用程式使用者的網路狀態離線或當應用 PlatformHelper 類別的 showInAppBrowser 方法時，遊戲應用程式會閃爍且視窗關閉的問題。 開啟遊戲內瀏覽器。

Others¶

• Windows 修正了在某些環境下應用程式無法正常關閉的問題。
• Windows 我們修正了一個問題，在內部方案（例如 interwork://）中輸入非鍵值格式（例如 ?831020）時，查詢值被錯誤地傳遞為 831020=，因此 831020 會原樣傳遞。
• Windows 修正了使用 Remote Play 等外掛程式時，Configuration.setZone 設定的區域未生效的問題。

v4.26.0.1¶

變更功能¶

• iOS Hive SDK 開發環境的 Xcode 版本將進行下列變更。
• 原版本：Xcode 26.2 Beta2
• 更改版本：Xcode 26.2

Provisioning¶

• Android 為遵守《應用商店責任法》，Hive SDK 支援的 Google Play Age Signals API 版本將進行以下更改。
• 原版本：0.0.1-Beta2
• 更改版本：0.0.2

v4.26.0.0¶

檢查此 SDK 版本的開發環境。

新功能¶

• iOS 您可以在 iOS Xcode 26.2 或更高版本上建置 Hive SDK。
• 最低支援的作業系統版本為 iOS 15。

Provisioning¶

• Android 合規性 是一項新功能。
• 當向 Google Play 和 Amazon Appstore 分發遊戲應用程式時，Hive SDK 提供 年齡範圍 API 來檢查使用者年齡範圍，以符合將於 2026 年 1 月 1 日在美國德克薩斯州生效的《應用商店責任法案》。
• iOS 新增合規性功能。
• 將遊戲應用程式分發到 Apple App Store 時，Hive SDK 提供*年齡範圍 API*，用於檢查使用者年齡範圍，以符合將於 2026 年 1 月 1 日在美國德克薩斯州生效的《App Store 責任法案》。
• 僅支援 iOS 26.2 或更高版本。

已知問題¶

Provisioning¶

• Android 根據《App Store 責任法》，Hive SDK 26.0.0 Beta 支援的 Google Play Age Signals API 版本 0.0.1-beta02 無法用於接收實際年齡訊號的使用者環境。 ※ 如需接收實際年齡訊號，請更新至 Hive SDK v4.26.0.1，此版本支援 Google Play Age Signals API 版本 0.0.2（非測試版）。

v4.25.8.2¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

修復的錯誤¶

Payment¶

• Windows 修正了當 Google Play Games PC 結算中註冊的產品數量超過 20 個時，無法檢索所有產品資訊的問題。

v4.25.8.1¶

檢查此 SDK 版本的開發環境。

修復的錯誤¶

Others¶

• Windows 修復了更改遊戲語言後，關閉指南介面仍以初始設定的語言顯示的問題。

Chat¶

• Windows 修正了韓文訊息未呼叫回呼函數的錯誤。

v4.25.9.0¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

新功能¶

Authentication¶

• All 已提供身分驗證服務（../../dev/authv4/verification.md）。
• SteamDeck 不提供身分驗證服務（身分驗證、年齡驗證、家長同意）。您必須在行動裝置或電腦上使用身分驗證服務，然後透過 SteamDeck 再次存取遊戲。

修復的錯誤¶

Others¶

• Windows 修復了更改遊戲語言後，關閉指南介面仍以初始設定的語言顯示的問題。

v4.25.7.1¶

檢查此 SDK 版本的開發環境。

修復的錯誤¶

Others¶

• Windows 透過應用 DX12 渲染器 GPU 同步，渲染穩定性得到了提升。
• Windows 修正了促銷新聞中關閉按鈕間歇性無法運作的問題。

v4.25.8.0¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

檢查此 SDK 版本的開發環境。

新功能¶

• All 支援虛幻引擎 5.6。
• Android 支援 Android OS 16（API 等級 36）。
• Android 在 Android OS 15（API 等級 35）或更高版本上建置時，支援 16KB 頁面大小的建置。

Game Data Store¶

• Windows 新增了資料儲存功能。

Chat¶

• Windows 已新增聊天功能。

變更功能¶

• Android 移除不再使用的 android.permission.FOREGROUND_SERVICE 權限。
• Android Android 最低建置目標從 19 改為 23。

Authentication¶

• iOS 在 Xcode 26 中建置時移除不可用的庫引用。

Billing¶

• Windows 我們已將 Google Play for Native PC (EAP) 整合從 Web API 方法遷移到 Google Play Games PC SDK。
• 您現在必須透過 Google Play Games PC 應用程式登入您的 Google 帳戶，而不能再使用 Hive SDK 驗證。請參閱初始化說明。
• 現有專案和新專案都必須按照Google 指南準備清單配置和程式碼簽章。

Library updates¶

• Android Adjust（Android）5.2.0 → 5.4.2
• Airbridge（Android）4.3.0 → 4.7.1
• AppsFlyer（Android）6.16.2 → 6.17.3
• Firebase-analytics（Android）22.1.2 → 23.0.0
• Singular（Android）12.7.0 → 12.10.0
• Facebook（Android）17.0.0 → 18.0.1
• Line（Android）5.10.0 → 5.11.1
• play-services-auth（Android）（Google 登入）20.7.0 → 21.3.0
• play-services-games-v2（Android）（Play 遊戲服務）20.1.2 → 21.0.0
• play-services-ads-identifier（Android）18.0.1 → 18.2.0
• play-services-analytic（Android）18.0.4 → 18.1.1
• firebase messaging（Android）24.0.2 → 25.0.0
• onestore（Android）21.01.00 → 21.02.01
• google-core-review（Android）2.0.1 → 2.0.2
• reCAPTCHA（Android）18.6.1 → 18.7.1
• Kotlin（Android）1.9.22 → 2.1.21
• iOS Adjust（iOS）5.2.0 → 5.4.3
• Airbridge（iOS）4.3.0 → 4.7.0
• AppsFlyer（iOS）6.16.1 → 6.17.2
• Firebase（iOS）11.6.0 → 11.15.0
• Singular（iOS）12.7.1 → 12.8.1
• Facebook（iOS）17.4.0 → 18.0.0
• Google 登入（iOS）8.0.0 → 9.0.0
• Line（iOS）5.11.2 → 5.13.0
• QQ（iOS）3.5.17.4 → 3.5.17.5
• SDWebImage（iOS）5.20.0 → 5.21.1
• Recaptcha（iOS）18.6.0 → 18.7.0

Hercules¶

• Windows Hercules 版本已更新至 2025.08.11。

修復的錯誤¶

Authentication¶

• iOS 修正了聊天機器人彈出視窗顯示時，偶爾會顯示橫屏模式而不是垂直螢幕模式的錯誤。
• iOS 修改程式碼以防止空數組引用錯誤。
• 使用 Authv4 類別的 showConflict 方法時，如果缺少必要的輸入數據，則會發生當機。

Analytics¶

• Android 修改為防止在並發客戶端傳輸失敗的情況下重新傳輸包含不必要資訊的內容。

v4.25.7.0¶

檢查此 SDK 版本的開發環境。

新功能¶

Authentication¶

• All 年齡驗證完成後，即可識別已驗證使用者。 提供了一種取得識別值的方法。識別資訊是經過哈希處理的 DI 值。

變更功能¶

Authentication¶

• Android iOS 如果您在 Hive 控制台中設定應用程式啟用年齡驗證，則登入後將自動執行年齡驗證流程。
• 此功能僅在韓國支援。
• Android iOS 用於執行年齡驗證的 showAdultConfirm 方法已被棄用。
• showAdultConfirm 方法可能會在未來的更新中移除。

修復的錯誤¶

Authentication¶

• Windows 修正了因 家長同意 失敗而導致登入失敗時登入資訊未重設的問題。
• Windows 修正了使用者透過自訂登入登入後，在透過應用程式商店購買遊戲物品後收到退款，使用相同帳號重新登入遊戲時無法登入的問題。
• Windows 修正了在 AuthV4.signOut 回呼函數中呼叫 AuthV4.showSignIn 時發生的當機問題。

Others¶

• Windows 修正了當遊戲以管理員權限運行時，透過 Hive SDK 開啟外部網頁瀏覽器時，如果 URL 長度為 800 個字元或更長，則網頁瀏覽器無法正常開啟的問題。

v4.25.6.0¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

新功能¶

Chat¶

• Android iOS 新增一項功能，可讓您表達或標記「喜歡」特定的聊天訊息。
• Android iOS 它提供的資訊允許您對特定的聊天訊息進行“回應”，或指示回覆連接關係。
• Android iOS 它提供了提及特定用戶或提供有關提及用戶的資訊的功能。

變更功能¶

Chat¶

• Android iOS 將 頻道訊息查找方法 從基於索引的查找變更為基於訊息 ID 的查找。

v4.25.5.2¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

修復的錯誤¶

Authentication¶

• iOS 修正了在橫屏模式下顯示聊天機器人時發生的崩潰錯誤。

v4.25.5.1¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

新功能¶

Authentication¶

• Android iOS 我們新增了【多帳號切換】功能。相關功能詳情如下：
• 將目前登入帳號儲存到設備
• 查看已儲存的帳號
• 登出並刪除已儲存的帳號
• 快速登入其他已儲存的帳號

Promotion¶

• Android iOS 新增的直接連結功能。

Notification¶

• Android iOS 新增了一個推送操作按鈕。
• 當收到推播通知時，您可以透過推播選擇動作按鈕執行預先定義的操作。

Chat¶

• Android iOS 發送訊息
• 新增自動將聊天訊息翻譯成使用者語言以及翻譯特定訊息的功能。
• 新增僅供特定語言使用者接收的公告訊息功能。
• 為 WebSocket 訊息新增訊息 ID 值，以確保回呼順序。
• Android iOS 頻道
• 新增進入聊天頻道時查看歷史對話記錄的功能。
• 顯示目前頻道參與人數。
• 提供頻道清單排序功能。
• Android iOS 事件管理
• 新增聊天以二進位形式發送自訂資料事件的功能。
• Android iOS 連線管理
• 新增了重新連接功能。

Hercules¶

• Android 20241125-2 -> 20250527
• iOS 20241120 -> 20250218

變更功能¶

• Android 更新建置所需的混淆規則。
• iOS 先前單獨提供的 HiveAppTrackingTransparents.framework 庫已整合到 Service.framework 中。

Authentication¶

• Android iOS 我們修改了 showMyInquiry 方法，以便在使用時顯示查詢頁面，而此前在未使用 Hive 會員帳戶時，該方法不起作用。
• Android 將 VK 驗證彈出視窗從 WebView 變更為應用程式內瀏覽器。

Marketing Attribution¶

• iOS 為支援啟用後自動收集 Firebase 購買事件而進行的變更。

修復的錯誤¶

Promotion¶

• iOS 修改 iPad 裝置上新聞介面的角落曲率。

Provisioning¶

• iOS 修改網頁視圖，使其在顯示條款和條件時不捲動。

Analytics¶

• iOS 修改邏輯，以便在條款協議完成後立即傳輸分析日誌。

已知問題¶

Others¶

• iOS 在橫屏模式下使用聊天機器人時，會出現崩潰錯誤。
• 請將 Hive SDK 更新至 Unity iOS 25.5.2 或以上版本。

v4.25.5.0¶

檢查此 SDK 版本的開發環境。

新功能¶

Authentication¶

• Windows 新增了家長同意功能。

Analytics¶

• Windows 已將 device.platform 新增至 Airbridge 日誌。其值為“Steam”或“Desktop”。此值也可在 Airbridge 控制面板上即時查看。

變更功能¶

Others¶

• Windows 我們改進了有關 MMP 的內部邏輯。

修復的錯誤¶

Authentication¶

• Windows 修正了在自動登入後呼叫登出會導致會話過期，從而阻止在使用在多個帳戶之間切換時重新登入的問題。

Promotion¶

• Windows 修正了在呼叫 Promotion.updatePromotionData() 後立即開啟新聞頁面時發生的間歇性崩潰問題。

Others¶

• Windows 解決了在 Hive SDK 中開啟新視窗時，NVIDIA 圖形驅動程式 572.16 與 DirectX 11（Apple 登入、Facebook 登入、PG 付款）之間發生的兼容性衝突。

v4.25.4.0¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

新功能¶

Authentication¶

• Windows 我們新增了【多帳號切換】功能。相關功能詳情如下：
• 將目前登入帳號儲存到設備
• 查看已儲存的帳號
• 登出並刪除已儲存的帳號
• 快速登入其他已儲存的帳號
• Windows 如果遊戲存取權限已被暫停的用戶嘗試登錄，請更改設置，使其僅退出應用程式而不關閉應用程式。
• Windows 遠端播放外掛程式中提供了增強的身份驗證協定。

修復的錯誤¶

Others¶

• Windows 修正了 Hive 函數操作的非聚合漏斗日誌問題。

v4.25.3.0¶

檢查此 SDK 版本的開發環境。

新功能¶

Promotion¶

• Windows 修改 Promotion.getBannerInfo 的調用，傳遞 typeCampaign 值。
• Windows 收集登入事件，以便在輸入邀請碼的使用者安裝應用程式時提供獎勵（../../operation/promotion/ua.md/#_7）。

Others¶

• Windows 透過跨平台啟動器啟動遊戲時，向附加到啟動 URI 的 查詢啟動參數 新增一個功能。
• Windows 將 特定 UI 新增至控制器按鍵映射支援目標。
• Windows 新增使用者介面，以便在可以透過控制器按鈕關閉時顯示關閉按鈕的指導資訊。

變更功能¶

Library updates¶

• Windows 將 Chromium Embedded Framework 函式庫版本替換為 128.45 版本。

修復的錯誤¶

Others¶

• Windows 修正了在 WebView 關閉後使用滑鼠時，如果遊戲引擎中設定了預設滑鼠遊標，則預設 Windows 遊標會與預設滑鼠遊標交替出現的問題。
• Windows 修正了在 Hive SDK 中傳遞 HTML 而不是 JSON 作為結果時發生的錯誤問題。
• Windows 修改了 Steam 市場連接失敗錯誤代碼的顯示方式，使其更加詳細。
• 新增錯誤代碼 IAPV4SteamMarketResponseError（-6101001）。
• 錯誤代碼和訊息的顯示格式為 [IAPv4] Steam 伺服器回應錯誤：(代碼：...，訊息：...)。
• Windows 修正了在 Steam 離線模式下嘗試登入 Steam 時未返回回呼的問題。
• Windows 修正了在基於 Direct3D 12 的虛幻引擎 5 中疊加 WebView 時發生的錯誤。

v4.25.2.2¶

檢查此 SDK 版本的開發環境。

變更功能¶

Authentication¶

• Android 由於部分使用者因相容性問題無法存取 Google 憑證管理器，我們將驗證方法回滾到現有的 Google 登入。

Library updates¶

• Android * Google Play 服務驗證（Android）v20.7.0（重新引入 Google 登入回溯支援）
• Google 憑證 Play 服務驗證（Android）v1.3.0（移除 Google 登入回溯支援）

v4.25.2.1¶

檢查此 SDK 版本的開發環境。

修復的錯誤¶

Marketing Attribution¶

• Android 修正了 MMP 服務整合 中使用的 Hive SDK 識別碼中缺少「did」值的錯誤。

v4.25.2.0¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

檢查此 SDK 版本的開發環境。

新功能¶

Authentication¶

• Windows Line 被支援為一種新的身份驗證方法（IdP）。

Matchmaking¶

• Windows 匹配 作為一項新功能得到支援。

Provisioning¶

• Windows 新增根據帳號顯示條款的功能(agreementDetermineBase)的支援。

變更功能¶

Authentication¶

• Android iOS 我們正在提供更新的 VK 身份驗證方法。新的身份驗證方法可在新版 VK 開發者控制台中找到。
• iOS 更新了已棄用的用於 Apple GameCenter 登入的 GameKit API 的驗證協定。
• Android 由於 Google 登入庫已停止支持，我們將改用 Google 憑證管理器 和 AuthorizationClient API 進行隱含和明確登入驗證。

Billing¶

• Android 如果透過 PG 付款購買的產品退款，則會新增 order_id 值以將其與先前的交易區分開來。
• Android Windows 當 PG 付款交易完成後，更改購買完成日誌以透過行銷歸因發送。

Promotion¶

• Android 更改後，在分享用戶獲取內容時，會將其新增至 Telegram 支援的曝光清單。
• Android 顯示 WebView 時變更快取策略。

Marketing Attribution¶

• Android iOS 此外，也要傳送 Hive SDK 識別碼以支援 MMP 服務整合。
• Windows 此外，請發送 行銷歸因支援 的 Hive SDK 識別碼。
• All 手動追蹤事件時，可透過新增自訂屬性變更為傳送。
• Android 啟動 Airbridge 時，市場來源資訊傳輸方式的變更。
• iOS 使用 sendEventWithAttributes API 時，將類型為「語意值」的浮點值的精確度範圍從「float」變更為「double」。

Plugins¶

• Windows 將 Unreal 外掛程式從現有的 HIVE_UNREAL_PLUGIN.dll 變更為 HIVE_PLUGIN_CPP.dll。
• Windows 為了提升與虛幻引擎的兼容性，C API 將會被移除。
• 由於呼叫使用 STL 的插件介面時會出現崩潰，先前支援的替代 C API 將會被移除。

Provisioning¶

• All 在「條款與條件詳情」和「回放」頁面上，系統在以下情況下會進行調整，開啟一個新的外部瀏覽器視窗載入內容，而不是使用「條款與條件」頁面（WebView）：
• 當導覽至「條款與條件」網址以外的網頁時
• 點擊「條款與條件」頁面內的超連結 HTML 標籤（例如 標籤、 等）時

Library updates¶

• Android Airbridge（Android）v4.1.0 → v4.3.0
• Adjust（Android）v5.0.1 → v5.2.0
• Singular（Android）v12.6.1 → v12.7.0
• AppsFlyer（Android）v6.15.2 → v6.16.2
• Google Play 服務授權（Android）v20.7.0（已停止支援）
• Google 憑證 Play 服務授權（Android）v1.3.0（新增支援）
• iOS 空橋 (iOS) v4.1.1 → v4.3.0
  • 調整(iOS) v5.0.1 → v5.2.0
  • 單數 (iOS) v12.6.1 → v12.7.1
  • AppsFlyer (iOS) v6.15.3 → v6.16.1
  • QQ (iOS) 3.5.17.3 → 3.5.17.4

Chat¶

• Android iOS 發送或接收訊息資料時，會傳送和接收額外的「extraData」。
• Android iOS 連接到聊天伺服器時，不再傳輸extraData。
• Android iOS 此外，接收整數時間值而不是字串時間值。
• Android iOS 修改為防止在通訊不可能的情況下（例如網路阻塞），由於未能正確釋放 WebSocket 而嘗試重新連線時出現重複連線狀態導致失敗。

修復的錯誤¶

• Android 修改程式碼，以便在需要透過網路進行通訊重試或存取分散式伺服器的情況下，如果在設定的最大逾時時間之前收到回應，則立即執行通訊重試或存取分散式伺服器，而無需等待逾時到期。
• iOS 修正了使用 Configuration 類別的 setZone 方法更改 Hive SDK 連接的伺服器群組 Zone 時，hive_config.xml 檔案中的 gameLanguage 值被初始化的錯誤。

Authentication¶

• iOS 修正了在執行 iOS 18 或更高版本的裝置上 QQ 網頁版登入無法正常進行的錯誤。
• Windows 修正了使用 Hive SDK WebView 進行通訊時，增強型安全協定的 JWT 令牌無法傳輸的問題。

Billing¶

• Windows 修正了當 Hive SDK 方法回呼嵌套過多時，呼叫以下方法之一會導致應用卡死的問題。
• IAPV4.transactionFinish
• IAPV4.transactionMultiFinish
• IAPV4.restore

Marketing Attribution¶

• Android 修正了使用 Adjust 功能確定安裝狀態時，推播通知顯示為空的問題。
• Android 修改系統，使其在透過 Airbridge 購買多個商品時，根據單價和數量提供銷售資訊。

Provisioning¶

• Android iOS 修正了在 SDK 初始化之前初始化廣告模組 (Adiz) 時，用於年齡檢查的 AgeGate 值在 COPPA 或 GDPR 等合規性情況下基於 hive_config.xml 中設定的值運行的錯誤。

Chat¶

• Android 修正了聊天連線間歇性斷開的問題。

已知問題¶

Marketing Attribution¶

• Android 用於 MMP 服務整合 的 Hive SDK 識別碼中缺少「did」值，這是一個錯誤。請使用 SDK v4 Unity Android & iOS 25.2.1 版本，此版本已解決此問題。

v4.25.1.3¶

檢查此 SDK 版本的開發環境。

新功能¶

Plugins¶

• Android iOS 支援虛幻引擎 5.3。

變更功能¶

Billing¶

• Android 將 PG 支付的行為更改為與其他計費（IAPv4）功能中的市場行為一致。如果您正在使用 PG 支付，則必須參考 PG 支付 文件來修改您的程式碼實作。

Marketing Attribution¶

• iOS 新增對 Airbridge 延遲深度連結追蹤 功能的支援。

修復的錯誤¶

Billing¶

• iOS 修正了在顯示彈出式 UI 請求同意傳輸消費資訊時背景變為不透明的錯誤。
• iOS 修正了在關閉請求同意傳輸消費資訊的彈出式 UI 時，應用程式螢幕方向會向非預期方向旋轉的錯誤。

Promotion¶

• iOS 修正了在顯示包含影像的審核彈出視窗時，如果發生旋轉事件，則顯示的影像會消失的錯誤。

Marketing Attribution¶

• iOS 修正了 Airbridge 在透過 Adiz 傳輸時將廣告收入資訊傳送給 AdMob 而不是 Adiz 的錯誤。

v4.25.1.0¶

檢查此 SDK 版本的開發環境。

新功能¶

Authentication¶

• Windows Telegram 已支援為新的身分提供者 (IdP)。請參閱Telegram 登入的機器人設定。
• Windows [新增支援] X（以前稱為 Twitter）作為身份驗證方法（../../dev/authv4/hive-sdk-prep/common.md#hive-config）。
• Windows 它提供共享已驗證會話的網頁瀏覽功能。

Remote Play¶

• Windows 從 UE4 Windows 25.1.0 或更高版本開始，Hive SDK v4 支援 遠端播放。

Others¶

• Windows 提供 Configuration.setUsePrivateBrowsingForAuth 函數，讓您設定登入 Google 時是否使用隱身模式。
• 也在 hive_config.xml 檔案中提供設定。
• Windows 提供 PlatformHelper.openBrowser 函數，該函數可以使用 URL 開啟瀏覽器。

變更功能¶

Billing¶

• Windows 將 PG 支付的行為更改為與其他計費（IAPv4）功能中的市場行為一致。如果您正在使用 PG 支付，則必須參考 PG 支付 文件來修改您的程式碼實作。

Promotion¶

• Windows 修改透過 additionalInfo 傳遞的值，使其不包含不必要的資訊。

Development Environment¶

• Windows 將所需的最低 Microsoft Visual C++ Redistributable 版本更新至 14.42.34438。

修復的錯誤¶

Authentication¶

• Windows 修正了當使用者選擇非 Hive 會員登入並取消登入時，Hive SDK 控制器的滑鼠操作處於活動狀態的錯誤。

v4.25.0.1¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

新功能¶

Marketing Attribution¶

• iOS 修正了使用 Hive SDK v4 25.0.0 或更高版本並套用 Adjust v5 時，SDK 會自動收集和傳送的 did 和 vid 值未傳送的錯誤。

變更功能¶

Development Environment¶

• Windows 將所需的最低 Microsoft Visual C++ Redistributable 版本更新至 14.38.33130。

修復的錯誤¶

Billing¶

• Windows 修正了使用 JWT 令牌的增強型安全協議時，退款用戶付款資訊不顯示的問題。

v4.25.0.0¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

新功能¶

Authentication¶

• Android iOS Telegram 已支援為新的身分提供者 (IdP)。請參閱Telegram 登入的機器人設定。

Billing¶

• iOS 它支援一項功能，可以詢問用戶是否同意將應用程式內產品消費資訊發送到 Apple App Store。

Promotion¶

• Android iOS 收集登入事件，以便在輸入邀請碼的使用者安裝應用程式時提供獎勵（../../operation/promotion/ua.md/#_7）。

Matchmaking¶

• Android iOS 符合功能已更新，新增支援群組符合。 ※ 此功能與 Hive SDK 的早期版本介面不相容。若要使用更新的配對功能，您必須使用 Hive SDK v4 25.0.0 或更高版本。

Marketing Attribution¶

• All 現在，在發送行銷追蹤事件時，可以使用 向 Airbridge 發送其他屬性 功能。
• Android 新增對 Airbridge 延遲深度連結追蹤 功能的支援。

Others¶

• Windows 使用遊戲控制器時，新增了對控制器按鍵映射的支持，允許您集中註意力並控制某些Hive UI元素。
• Windows 現在可以使用自訂遊標來取代標準滑鼠遊標。
• Windows 新增了啟用或停用遊戲控制器操作的設定。

Chat¶

• Android iOS 聊天 功能已新增支援。

變更功能¶

Authentication¶

• Android iOS 刪除不再使用的 Auth 模組類別、介面、方法、委託和監聽器。
• All 使用 JWT 令牌實施更強大的安全協定。
• Android iOS 由於 TalkPlus 停止支持，TalkPlus 身份驗證令牌方法將被移除。
• Android 除了 Apple Login WebView 中的登入功能外，還允許使用密碼恢復等瀏覽功能。

Promotion¶

• Windows 在「新聞」選單標籤中新增了新的內容通知。

Marketing Attribution¶

• Android iOS 更新以支援 Adjust v5。
• 移除 Adjust Signature 庫。
• Android iOS 變更設置，以便在將 Adiz 廣告收入與 Adjust 聚合時，將廣告收入來源傳送至 AdMob 來源。
• Android 反映了 Appsflyer 廣告收入聚合庫已整合到主庫中。
• 6.14.2 → 6.15.2
• 移除 Appsflyer 廣告收入庫。

Hercules¶

• All 2024.11.20

修復的錯誤¶

Authentication¶

• Android 解決了在執行 signIn 方法期間發生網路回應延遲時 UI 執行緒間歇性被佔用的問題。
• Windows 修正了處於退款/還款狀態的使用者登入電腦時發生的「CommonUnknown」錯誤。
• Windows 改進了使用者介面，使拖曳「保持登入狀態」文字時不會出現「隱私警告」訊息。

Billing¶

• iOS 修正了在使用 UserEngagement 誘導應用程式內購買時觸發額外 IAP_UPDATE 事件的錯誤。
• Windows 修復了在 Steam 付款進行過程中，如果使用 ESC 鍵或其他鍵關閉覆蓋層，則付款無法繼續的問題。

Others¶

• Windows 我們已透過最佳化循環迭代條件修復了此問題，使 CPU 使用率恢復正常。 ※ 如果您使用的是受影響的版本（4.24.1.0 或更高版本），請更新至 SDK v4 Unity Windows 25.0.0 並檢查 CPU 使用率是否穩定。

已知問題¶

Marketing Attribution¶

• iOS 使用 Adjust 時，SDK 會自動收集並傳送的 did 和 vid 值無法傳輸，這是一個錯誤。您需要將 Hive SDK 更新至 v4 25.0.1 或更高版本。

v4.24.5.0¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

檢查此 SDK 版本的開發環境。

新功能¶

• Android iOS 支持 Unity 6 (Unity 6000)。
• Windows 新增了與 Hive SDK v4 Unity Android & iOS 24.5.0 介面相容的更新。

Authentication¶

• Android iOS 新增對 Steam 和 X（原 Twitter）的身份驗證方式支援。
• 通用準備工作
• Android 準備工作
• iOS 準備工作
• 品牌指南
• Android 它提供共享已驗證會話的網頁瀏覽功能。

Promotion¶

• Android iOS 廣告也可以在Spot Banner中顯示。
• Android 我們支援 X（原 Twitter）的用戶邀請分享功能。

Matchmaking¶

• Android iOS 我們支援匹配服務作為一項新功能。

變更功能¶

Authentication¶

• Android iOS 修改衝突彈出視窗中顯示的提供者名稱。

Plugins¶

• Android iOS Hive 配置設定選單的位置已更改，現在可以針對每個目標平台配置設定。

修復的錯誤¶

Billing¶

• iOS 當某些產品的價格無法精確地以浮點數表示時，請修改 JSON 格式，將數值顯示為十進位數而非循環小數。
• 例如：4.99$（字串）→ 4.9900000000000011（雙精度浮點數）→ 4.99（JSON 數字）

v4.24.4.2¶

檢查此 SDK 版本的開發環境。

變更功能¶

• Windows 移除了使用者介面中未使用的不必要資源。

v4.24.4.1¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

變更功能¶

Authentication¶

• Windows 我們對 IdP 選擇介面進行了更改，以便更清楚地顯示是否選擇了「保持登入狀態」介面。
• Windows 身分提供者 (IdP) 選擇介面的英文翻譯已修改。
• 修改前：保持登入狀態
• 修改後：保持登入狀態

v4.24.4.0¶

檢查此 SDK 版本的開發環境。

新功能¶

Billing¶

• Android Windows 在進行 PG 付款請求時，支援使用 IAPv4.purchase 進行多件購買。

Marketing Attribution¶

• Android iOS 我們支援 Airbridge 作為 Hive SDK 的專用服務。
• 使用 Airbridge 自動追蹤事件
• 使用 Airbridge 手動追蹤事件

Remote Execution¶

• Windows 它支援跨平台啟動器遠端執行。

修復的錯誤¶

Analytics¶

• iOS 修正了僅選擇同意橫幅中的一個選項時，未正確反映的錯誤。

v4.24.3.0¶

檢查此 SDK 版本的開發環境。

新功能¶

Marketing Attribution¶

• Windows Appsflyer 1.0.1 ???+ 警告 Appsflyer（僅限 Steam 平台）1.0.1 版本已發布。 Hive 從 SDK v4 24.0.0 開始，行銷歸因功能僅在 Appsflyer 1.0.1 及更高版本中支援。

Plugins¶

• Android iOS [插件] 提供專為虛幻引擎設計的介面。



• 相容於現有的 C++ 介面。

• Android iOS 我們提供支援虛幻引擎專屬新介面的範例程式碼。

• Android iOS 支援虛幻引擎 5.4。

Provisioning¶

• All 在條款和條件螢幕上增加了一項功能，用於檢查是否已獲得法定代表人的同意。

變更功能¶

Authentication¶

• Android iOS 更改了註銷行為。
• 之前：當呼叫 signOut 時，Hive SDK 會登出使用者帳號。 訪客在呼叫 signOut API 時會收到伺服器傳回的失敗回應。
• 變更後：當呼叫 signOut 時，Hive SDK 會向 Hive 伺服器要求確認註銷使用者帳戶是否安全，然後根據伺服器回應登出使用者帳戶。
• Android iOS 登出訪客帳戶時，不再回傳成功回應，而是傳回錯誤代碼。它仍然保持訪客帳戶與 Hive SDK 和 Hive 伺服器之間的會話。
• Android iOS 對於已暫停的帳戶，設定將變更為自動從身分識別提供者 (IdP) 登出，以便您可以使用相同 IdP 上的其他帳戶登入。此設定僅在無法自動登入時適用。
• Android iOS 在使用 AuthV4.connect 方法執行身分識別提供者 (IdP) 整合時，請進行相應修改，以便在帳戶切換到已暫停帳戶時執行登出操作。
• All 變更設備管理服務，使其根據設備的連線區域自動套用國際電話國家代碼。
• iOS 我們正在更改設置，即使您已拒絕應用程式追蹤透明度 (ATT) 同意，也允許 Facebook 登入。
• Windows 在通過年齡驗證後訂閱裝置管理服務時，如果一個手機號碼可訂閱的帳號數量超過限制，則會顯示錯誤訊息「您使用相同手機號碼可訂閱的帳號數量已超過限制」。

Promotion¶

• Android iOS 修改透過 additionalInfo 傳送的值，使其不包含不必要的資訊。
• All 更改以 2:3 或 3:2 比例顯示全螢幕橫幅廣告
• Android iOS 將首頁橫幅上的文字「1 天後停止展示」改為「今天停止展示」。

Marketing Attribution¶

• Android iOS 調整簽章 將版本從 v1 變更為 v3。

Library updates¶

• Android Google Play結算庫 6.1 → 7.0 Google Play服務遊戲 20.0.0 → 20.1.2
• iOS Facebook SDK 16.2.1 → 17.0.2

修復的錯誤¶

• Android 透過修改資源引用邏輯，修復了無法分配記憶體的錯誤。
• iOS 修正了在 iOS 14 裝置上檢查 App Tracking Transparency (ATT) 的同意情況時導致間歇性崩潰的錯誤。
• iOS 修正了在相簿中選擇存取限制（僅允許存取部分照片）時導致崩潰的錯誤。

Notification¶

• Android 修正了當設定了不支援的 type 時，本地推播通知 中推播訊息顯示不正確的錯誤。
• iOS 修改以傳送應用程式版本資訊。

v4.24.2.1¶

檢查此 SDK 版本的開發環境。

新功能¶

Community¶

• Windows 更改以允許在遵循 Hive 協議的社區中使用 自訂網域地址，而不是 withhive.com 或 com2us.com。

v4.24.1.3¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

變更功能¶

Authentication¶

• Android iOS 變更設備管理服務，使其根據設備的連線區域自動套用國際電話國家代碼。

v4.24.2.0¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

新功能¶

• Android iOS 提供一個函數，用於返回歐盟和歐洲經濟區（受 GDPR 約束）內未滿 16 歲的用戶是否已同意相關條款。您可以檢查使用者是否未滿 16 歲。
• Android 在執行 Android OS 11 或更高版本的裝置上，或在安裝了支援模組的裝置上使用相簿時，預設使用 PhotoPicker。
• iOS 您可以在 macOS 控制台應用程式中查看 Hive SDK 偵錯日誌，並選擇要查看的特定日誌類型。

Authentication¶

• All 當一個手機號碼可註冊的帳戶數量超過限制時，請求發送驗證碼時會顯示一條錯誤訊息，提示「您使用相同手機號碼建立的帳戶數量已超過限制」。
• Windows 支援Steam IdP 隱含登入。使用AuthV4.Helper.signIn。

Promotion¶

• Android iOS 它提供了一項功能，用於控制交叉推廣活動的曝光度。
• Android iOS 今天，我們支援N 天不顯示，這是改進後的「不顯示」功能。

變更功能¶

Authentication¶

• Windows 更改設置，使得在使用 Google 登入時，不會授予 games_lite 權限來檢查 Google Play Games 資訊。

Promotion¶

• iOS 改進了使用者體驗，在使用遊戲邀請（UA）功能時，最小化了剪貼簿貼上權限同意彈窗的顯示。
  
  1. 權限同意彈窗的顯示時間已從受邀使用者啟動應用程式後立即顯示，變更為在應用程式啟動後 Hive SDK 初始化時顯示。
  2. 只有當邀請方 URL 資料存在於剪貼簿中時，才顯示彈跳窗。

Notification¶

• Android 支援在新亞馬遜 Fire 裝置上執行的執行時間程式庫（Push Amazon Device Message 1.2.0）。

Library updates¶

• Android 三星 Galaxy 應用程式商店 IAP 版本 6.1 → 6.1.1 亞馬遜設備訊息版本 1.0.1 → 1.2.0

Analytics¶

• iOS 將 saveAnalyticsLogBeforeCrash 設定的預設值（該選項用於在應用程式崩潰時將未傳送的日誌儲存到檔案中）變更為 false。

修復的錯誤¶

Authentication¶

• Android iOS 修改為：當從中國訪問的用戶在實名驗證過程中發送的簡訊數量超過限制時，顯示錯誤訊息，而不是重置剩餘時間。
• Android 修正了使用者在 Google Play 登入過程中未按返回鍵登入時，沒有正確回應回呼的錯誤。
• Android 修正了在低解析度裝置上無法進行鍵盤輸入的錯誤。
• Windows 修正了裝置管理服務驗證的手機驗證畫面上的問題，即當出現錯誤彈出視窗時，即使點擊“返回上一頁”，使用者也不會回到上一個畫面。
• Windows 修正了在行動裝置管理服務驗證的手機驗證畫面上，當驗證碼輸入欄位處於活動狀態時，使用滑鼠滾輪操作會導致輸入欄位中輸入值的問題。
• Windows 修正了在巢狀回呼中呼叫 AuthV4.Helper.switchAccount 或 AuthV4.Helper.resolveConflict 時無法傳遞 Hive SDK 回呼的問題。
• Windows 修正了 AuthV4.Helper.switchAccount 和 AuthV4.Helper.resolveConflict 中無法傳遞 PlayerInfo Unity 外掛程式參數的問題。

Promotion¶

• iOS 修正了在新聞視圖中顯示新框架視圖時出現凍結的錯誤。
• Windows 修正了從「促銷自訂直接全螢幕」切換到「框架」時發生的當機問題。

Marketing Attribution¶

• Android 修正了使用自訂條款執行初始化時，Adjust 事件會傳送延遲的錯誤。

Provisioning¶

• Windows 我們修改了設置，以便在再次查看術語時，使用 Hive 伺服器新提供的術語 URL 數據，而不是先前保存的數據。

v4.24.1.2¶

檢查此 SDK 版本的開發環境。

修復的錯誤¶

Authentication¶

• Android 修正了在 Google 登入過程中，如果按下返回鍵取消登錄，則無法正確回應回呼的錯誤。此錯誤僅在 Hive 控制台中的「Google 舊版支援」值為 true 時才會出現。
• Android 修正了低解析度裝置上無法進行鍵盤輸入的錯誤。

v4.24.1.0¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

變更功能¶

• Windows 它支援透過 Hive SDK 實現的 UI 上的遊戲控制器進行滑鼠移動。

Library updates¶

• iOS AppsFlyer(iOS) v6.13.1 → v6.14.3 QQ (iOS) v3.5.14 → v3.5.16 Facebook SDK v17.0.0 → v16.2.1

Analytics¶

• iOS 我們會根據裝置是否同意追蹤來更改同意橫幅的顯示方式。
  
  • 如果拒絕追蹤同意，則不會顯示同意橫幅。

修復的錯誤¶

Billing¶

• iOS 修正了從低於 v4 24.0.0 的 Hive SDK 版本（例如 v4 23.4.0）更新到 v4 24.0.0 時產品查找失敗的錯誤。

v4.24.0.0¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。

新功能¶

• Windows 新增了一個功能，在遊戲服務結束後嘗試初始化 Hive SDK 時，傳回 錯誤代碼。

Authentication¶

• Windows 已新增 透過 Hive 社群登入自動登入 PC 遊戲 功能。

Billing¶

• iOS 如果初始訂閱折扣資訊可用，則會在檢索產品資訊時一併傳遞。使用 getProductInfo 時，您可以透過查看回呼中接收到的 IAPV4Product 物件清單中 original_price 欄位值與 price 欄位值之間的差異來檢查折扣資訊。

Promotion¶

• Android 它支援自訂標籤頁，該標籤頁使用裝置上設定的預設瀏覽器來顯示外部頁面。您可以使用PlatformHelper類別的showInAppBrowser方法來公開應用程式內瀏覽器。
• iOS 支援SafariViewController，它使用瀏覽器顯示外部頁面。您可以使用PlatformHelper類別的showInAppBrowser方法公開應用程式內瀏覽器。

變更功能¶

• iOS 在區分應用程式版本時，我們也會使用CFBundleShortVersionString。
• Windows HIVE SDK UI 和 WebView 已更改，現在它們根據 DPI 設定而不是顯示器解析度顯示。

Authentication¶

• Windows 現在您可以使用 Windows「隱身模式」下設定的預設瀏覽器登入 Google。支援的瀏覽器如下：
• Google Chrome
• Microsoft Edge
• Mozilla Firefox
• Naver Whale
• Windows 如果您使用非主流瀏覽器登錄，請使用「普通模式」登入。

Billing¶

• Android iOS 我們已將退款使用者付款介面中顯示的 PG 付款類型文字從「HiveStore」變更為「PG Payment」。
• Android 我們將PG付款頁面的顯示方式從應用程式內瀏覽器變更為應用程式內WebView。這樣即使在不支援應用程式內瀏覽器環境的裝置上，也能使用PG支付。

Library updates¶

• Android Google Play 服務 - 遊戲 v2（Android）v19.0.0 → 20.0.0
• Facebook SDK Android v16.2.0 → 17.0.0
• LINE（Android）v5.9.1 → 5.10.0
• iOS 微信 2.0.2 → 2.0.4
• Hercules 2024.01.23 → 2024.04.11
• Singular 12.3.2 → 12.4.1
• Windows 蒸汽機車 1.55 → 1.59

Analytics¶

• Android 將 Firebase 事件收集功能中的廣告標識符收集設定的預設值變更為 true。

修復的錯誤¶

Authentication¶

• Windows 修正了中文實名驗證過程中出現的錯誤，該錯誤允許在驗證時間到期後輸入驗證碼。
• Windows 修正了某些網頁（例如 Apple 登入）僅以英文顯示的錯誤。
• Windows 修正了在巢狀回呼函數中呼叫 IAPv4 getSubscriptionProductInfo 時無法傳遞 SDK 回呼的錯誤。
• Windows 修正瞭如果未收到來自 Google 的個人資料圖片則登入失敗的錯誤。 （已修改，即使未收到個人資料圖片也能登入。）

Billing¶

• Windows 修正了退款用戶重新付款介面中 PG 付款顯示為 Hive Store 的錯誤。
• Windows 我們對退款用戶付款介面的阿拉伯語螢幕進行了修改，使其使用適合阿拉伯語特點的介面。

Promotion¶

• Windows 修正了 getBannerInfo 和 getBannerInfoString 函數無法正常運作的錯誤。
• Windows 修改了推廣 API，使其獨立於 AuthV4 驗證運行。

Others¶

• Windows 修正了在特定大小的視窗中執行點擊等輸入事件時使用者介面閃爍的錯誤。

已知問題¶

Authentication¶

• iOS 使用 Facebook SDK iOS 17.0.0 時，如果用戶不同意“應用程式追蹤透明度”，則無法在 iOS 17.0 或更高版本的裝置上登入。若要在此條件下實現 Facebook 登錄，請使用 Hive SDK v4 24.1.0。