SDK Unity 版本說明¶

本指南按版本介紹 Hive SDK Unity 的主要更新。

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

• Android SDK Unity Android 更新
• iOS SDK Unity iOS 更新
• Windows SDK Unity Windows 更新
• All SDK Unity Android、iOS 和 Windows 更新

必要項目¶

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

• 安全金鑰設定 適用於 Hive SDK v4 Unity 25.0.0 及更高版本
  • 由於身分驗證安全協定的變更，在使用 Hive SDK v4 Unity 25.0.0 及更高版本時，您必須在Hive 控制台 > 安全金鑰設定中[頒發安全金鑰設定中[頒發安全金鑰](../../operation.center/mdettm）。沒有安全金鑰，您將無法登入應用程式。
• Hive SDK v4 Unity 25.1.3 或更高版本需要對 PG 支付實作進行更改
  • 若要在 Android 和 iOS 25.1.3 或更高版本，或 Windows 25.1.0 或更高版本上實現 PG 支付，您必須參考 PG 支付流程 修改 PG 支付實現代碼。
• Hive SDK v4 Unity Windows 25.8.1 存在一個問題，即點擊前端推廣橫幅廣告無法正確跳到連結。若要解決此問題，請依下列步驟取代前端橫幅廣告的 HTML 檔案：
  1. 下載並解壓縮包含修改後 HTML 檔案的 zip 檔案（https://hive-fn.qpyou.cn/hivedev/sdk/hive_sdk_v4_with_core/patch/hivesdk_win_respatch_min25_8_1.zip）。
  2. 將整個資料夾複製到 Plugins/HIVESDK/Source/HiveSDKWindows/assets/additional 目錄下並覆蓋原有資料夾。
  3. 重新建構應用程式。
• 如果您正在使用 Hive SDK v4 Unity 25.4.0 或更高版本，請將 SDK 管理員更新至 SDK 管理員 v 2.0.0 或更高版本。

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¶

變更功能¶

Authentication¶

• Android iOS 如果您之前在中國登入 Hive Membership 時已驗證過手機號碼，那麼在中國進行的實名驗證步驟將直接進行身份驗證，而無需驗證手機號碼。
• 由於現有的 Hive Membership 登入流程僅驗證您的會員 ID（電子郵件地址），而不驗證您的手機號碼，因此您需要在後續的中國實名驗證步驟中驗證您的手機號碼。

修復的錯誤¶

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

v4.26.1.1¶

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

修復的錯誤¶

Plugins¶

• iOS 修正了在面向 iOS 時設定外部庫依賴項後 Hive SDK 版本資訊未準確反映的問題。

v4.26.1.0¶

檢查此 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 支援 使用 Xiaomi 登入。

Billing¶

• Android 支援使用 小米計費。

Promotion¶

• All 我們支援延遲深度鏈接，即使用戶尚未安裝該應用，點擊直接鏈接後，該用戶仍可被重定向到鏈接中指定的應用內頁面。

Marketing Attribution¶

• Windows 我們正在發布 Appsflyer for Native PC，它可以在桌面電腦環境中傳輸必要的訊息，而不是在 Steam 環境中傳輸。
• Windows 從 Airbridge 1.1.4 版本開始，我們提供了在使用者登入後延遲向 MMP 伺服器發送安裝事件日誌的功能。透過在使用者登入後發送安裝事件日誌，遊戲開發者可以將包括玩家 ID 在內的帳戶資訊傳輸到 MMP 伺服器。

Remote Play¶

• Windows 從遠端播放外掛程式 1.01.02 版本及更高版本開始，在遠端播放運行時點擊外部連結將在遠端裝置上開啟頁面。這樣就可以在遠端播放期間進行 PG 付款。

Add-ons¶

• Android 當使用 PlatformHelper 類別的 showInWebView 方法在 作為遊戲內 webview 開啟 中公開 webview 時，我們提供了使用 Game 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 已新增彈出窗口，提示在使用 Steam Deck 的身份驗證功能時不支援 Pass。
• Windows 將您的 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¶

• iOS 提升與 SDK 隨附的 JSONObject 類別的兼容性。
• 確保名稱不會與建置環境中的其他 JSONObject 類別重疊。

Provisioning¶

• 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 修正了即使受 COPPA 約束，推播通知令牌仍被收集的錯誤。
• iOS 修正了 ForegroundPush 設定無法變更為 False 的問題。

Marketing Attribution¶

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

Remote Play¶

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

Add-ons¶

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

Others¶

• Windows 我們已經修正了查詢值不是鍵值格式（例如 ?831020）的問題，該問題在內部方案（例如 interwork://）中被錯誤地傳輸為 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 您可以使用 Xcode 26.2 或更高版本在 iOS 上建置 Hive SDK。
• 最低支援的作業系統版本為 iOS 15。

Provisioning¶

• Android 我們新增了一項合規功能（../../dev/provisioning/compliance.md）。
• 如果您將遊戲應用程式分發到 Google Play 或 Amazon Appstore，Hive SDK 提供了一個 年齡範圍 API，用於檢查用戶的年齡範圍，以符合將於 2026 年 1 月 1 日在美國德克薩斯州生效的《應用商店問責法案》。
• iOS 我們新增了一項合規功能（../../dev/provisioning/compliance.md）。
• 如果您將遊戲應用程式發佈到 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 版本的開發環境。

修復的錯誤¶

Payment¶

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

v4.25.8.1¶

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

修復的錯誤¶

Others¶

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

Chat¶

• Windows 修正了韓文訊息無法呼叫回呼函數的問題。

v4.25.9.0¶

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

新功能¶

Authentication¶

• All 我們提供身分驗證服務。
• SteamDeck 不提供身分驗證服務（身分驗證、成人驗證、家長同意）。您必須在手機或電腦上使用身分驗證服務，然後透過 SteamDeck 重新存取遊戲。

修復的錯誤¶

Others¶

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

v4.25.7.1¶

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

修復的錯誤¶

Others¶

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

v4.25.8.0¶

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

新功能¶

• All 最低支援的 Unity 版本已更改。
• 支援 16KB 頁面大小的 Unity 版本清單：
• Unity 6000.1.0f1
• Unity 6000.0.38f1
• Unity 2022.3.56f1
• Unity 2021.3.48f1
• 支援 Android 16 目標平台的 Unity 版本清單：
• Unity 6000.1.0f1
• Unity 2022.3.62f1
• Unity 2021.3.51f1
• 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 方法時，如果缺少必要的輸入數據，則會發生當機。

Remote Play¶

• Windows 修正了即使使用 Application.CancelQuit 或 Application.wantsToQuit 取消連接，遠端播放連接仍會斷開的問題。現在，連接將在應用程式實際退出時斷開。

Others¶

• Windows 提高了方法呼叫快速連續時的穩定性。

Analytics¶

• Android 當客戶端連線傳輸失敗時，會對其進行修改，以避免重傳不必要的資訊。

v4.25.7.0¶

注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 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 版本的開發環境。

修復的錯誤¶

Authentication¶

• iOS 修正了在橫螢幕模式下顯示聊天機器人時會導致崩潰的問題。

v4.25.5.1¶

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

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

新功能¶

Authentication¶

• Android iOS 我們新增了一項名為「多帳號切換」的功能。功能詳情如下：
• 將目前登入帳號儲存到設備
• 查看已儲存的帳號
• 登出並刪除已儲存的帳號
• 使用其他已儲存的帳號快速登入

Promotion¶

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

Notification¶

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

Chat¶

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

Hercules¶

• All 20241120 -> 20250217
• 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 版本的開發環境。

新功能¶

Authentication¶

• Windows 我們新增了一項名為「多帳號切換」的功能。功能詳情如下：
• 將目前登入帳號儲存到設備
• 查看已儲存的帳號
• 登出並刪除已儲存的帳號
• 使用其他已儲存的帳號快速登入
• Windows 當被遊戲封鎖的用戶嘗試登入時，應用程式不會再關閉，而是會將其登出。
• Windows RemotePlay 外掛程式中提供了增強的身份驗證協定。

Others¶

• Windows 增加了將 Hive SDK 及其相依性隔離到單獨資料夾中的功能（../../dev/overview/prep-build/unity-windows.md）。

修復的錯誤¶

Others¶

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

v4.25.3.0¶

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

新功能¶

Promotion¶

• Windows 修改 Promotion.getBannerInfo 調用，傳遞 typeCampaign 值。
• Windows 我們收集登入事件，以便獎勵輸入邀請碼並安裝應用程式的使用者。

Others¶

• Windows 增加了透過 Crossplay Launcher 啟動遊戲時，尋找附加到啟動 URI 的啟動參數的功能。
• Windows 將 特定 UI 新增至控制器按鍵映射支援。
• Windows 當可以透過控制器按鈕關閉時，新增 UI 以顯示關閉按鈕的指導資訊。

變更功能¶

Library updates¶

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

修復的錯誤¶

Others¶

• Windows 修正了當遊戲引擎設定了預設滑鼠遊標時，關閉網頁視圖後預設滑鼠遊標會在 Windows 預設遊標和滑鼠遊標之間交替出現的問題。
• Windows 修正了在 Hive SDK 中傳遞 HTML 而不是 JSON 作為結果時會發生錯誤的問題。
• Windows 我們更改了 Steam 市場連線失敗錯誤代碼的顯示方式。
• 新增錯誤代碼 IAPV4SteamMarketResponseError (-6101001)。
• 錯誤代碼和訊息現在以 [IAPv4] Steam 伺服器回應錯誤：(代碼：...，訊息：...) 的格式顯示。
• Windows 修正了在 Steam 離線模式下嘗試登入 Steam 時不會返回回呼的問題。

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 版本的開發環境。

新功能¶

• Android iOS 支持 Unity 6.1 (6000.1)。

Authentication¶

• Windows 支援 line 作為新的身份驗證方法 (IdP)。

Matchmaking¶

• Windows 新功能支援符合。

Provisioning¶

• Windows 新增對根據帳戶公開條款和條件(agreementDetermineBase)的支援。

變更功能¶

Authentication¶

• Android iOS 我們更新了 VK 的身份驗證方法。更新後的身份驗證方法可在新版 VK 開發者控制台中使用。
• iOS 更新了登入 Apple GameCenter 時所使用的已棄用的 GameKit API 的驗證協定。
• Android 由於 Google 登入庫已棄用，我們將改用 Google Credential Manager 和 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。

Provisioning¶

• All 在以下情況下，「條款與條件詳情」和「回放」頁面將改為在新瀏覽器視窗中打開，而不是載入「條款與條件」頁面（網頁視圖）：
• 當跳到「條款與條件」網址以外的網頁時
• 點擊「條款與條件」頁面內的超連結 HTML 標籤（例如，「a」標籤、「tel://」）時

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) 時，如果需要符合 COPPA 或 GDPR 等法規，則檢查年齡的 AgeGate 值固定為使用 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 版本的開發環境。

變更功能¶

Billing¶

• Android 更改 PG 支付的工作方式，使其與計費 (IAPv4) 功能中其他市場的行為保持一致。如果您正在使用 PG 支付，則應參考 PG 支付 文件來修改您的程式碼實作。

Marketing Attribution¶

• iOS 新增對 Airbridge 延遲深度連結追蹤 的支持

修復的錯誤¶

Billing¶

• iOS 修正了在顯示詢問是否同意傳輸消費資訊的彈出式使用者介面時背景不透明的錯誤。
• iOS 在修正了關閉詢問是否同意傳輸消費資訊的彈出式使用者介面時，應用程式螢幕方向會朝非預期方向旋轉的問題。

Promotion¶

• iOS 修正了在顯示包含影像的審核彈出視窗時，發生旋轉事件會導致正在顯示的影像消失的問題。

Marketing Attribution¶

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

v4.25.1.0¶

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

新功能¶

Authentication¶

• Windows 我們現在支援 Telegram 作為新的身份驗證方法（身分提供者）。請參閱設定 Telegram 登入機器人。
• Windows 新增支援 X（以前稱為 Twitter）作為身份驗證方法。
• Windows 提供共享已驗證會話的網頁瀏覽功能。

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 Membership 以外的登入方式並取消登入後，使用 Hive SDK 控制器進行滑鼠操作將無法正常運作的問題。

v4.25.0.1¶

檢查此 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 版本的開發環境。

新功能¶

Authentication¶

• Android iOS 我們現在支援 Telegram 作為新的身份驗證方法（身分提供者）。請參閱設定 Telegram 登入機器人。

Billing¶

• iOS 支援詢問用戶是否同意將應用程式內產品消費資訊傳送至 Apple App Store 的功能。

Promotion¶

• Android iOS 我們收集登入事件，以便獎勵輸入邀請碼並安裝應用程式的使用者。

Matchmaking¶

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

Marketing Attribution¶

• All 我們在發送行銷追蹤事件時，增加了對 向 Airbridge 發送附加屬性 的支援。
• Android 新增對 Airbridge 延遲深度連結追蹤 的支持

Others¶

• Windows 支援在有觸控螢幕的手持裝置上使用觸控手勢，例如 ASUS ROG Ally。
• Windows 使用遊戲控制器時，新增了對控制器按鍵映射的支持，允許您集中註意力並操作一些Hive UI元素。
• Windows 新增對應用自訂遊標而非標準滑鼠遊標的支持
• Windows 新增了啟用或停用遊戲控制器控制的設定。

Chat¶

• Android iOS 現在支援聊天功能。

變更功能¶

Authentication¶

• Android iOS 刪除未使用的 Auth 模組類別和介面、方法、委託和監聽器。
• All 使用 JWT 令牌實施更強大的安全協定。
• Android iOS 由於我們停止對 TalkPlus 的支持，我們將棄用 TalkPlus 身份驗證令牌方法。
• Android Apple 登入網頁視圖除了提供登入功能外，還允許瀏覽網頁，例如尋找密碼。

Promotion¶

• Windows 在「最新動態」功能表標籤中新增了內容通知顯示。

Marketing Attribution¶

• Android iOS 已更新以支援 Adjust v5。
• 移除 Adjust Signature 庫。
• Android iOS 使用 Adjust 聚合 Adiz 廣告收入時，將 Adiz 廣告收入聚合來源變更為 AdMob。
• Android 這反映了 Appsflyer 廣告收入聚合庫已整合到主庫中。
• 6.14.2 → 6.15.2
• 移除了 Appsflyer 廣告收入庫。

Unity¶

• All 改進了 Hive 配置設定介面。

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 版本的開發環境。

新功能¶

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

Authentication¶

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

Promotion¶

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

Matchmaking¶

• Android iOS 新功能支援匹配服務。

變更功能¶

Authentication¶

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

Plugins¶

• Android iOS 請使用提供的最新版本 EDM4U。 * 1.2.178 → 1.2.183
• iOS 如果您使用 Game Center 登錄，請將其變更為自動將所需的授權設定新增至建置。
• 以前，即使您使用 Game Center 登錄，也必須額外設定功能管理員。
• 如果缺少授權設置，運行 iOS 18 或更高版本的裝置將無法正常登入。

修復的錯誤¶

Billing¶

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

Plugins¶

• All 使用明確命名空間可以避免介面重複，從而防止某些外部插件出現編譯錯誤。
• Android 修正了使用 Firebase 行銷追蹤工具或華為驗證功能時，Android 目標平台上缺少必要設定的問題（在 SDK v4 24.3.0 及更高版本中出現）。

v4.24.4.2¶

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

變更功能¶

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

v4.24.4.1¶

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

新功能¶

Remote Play¶

• Windows Hive SDK Unity Windows v4.24.4.1 及更高版本支援 遠端播放。

變更功能¶

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 支援 Crossplay Launcher Remote Launch。

變更功能¶

Plugins¶

• Android iOS 更改了自動設定 Android 上的 Package Name 或 iOS 上的 Bundle Name 的功能，使其可以透過 Hive AppId 選擇性地工作。

修復的錯誤¶

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 或更高版本進行行銷歸因分析。

Provisioning¶

• All 在「條款和條件」畫面上增加了檢查是否已獲得法定代表人同意的功能。

變更功能¶

Authentication¶

• Android iOS 更改了註銷行為。
• 之前：當呼叫 <code>signOut</code> 時，Hive SDK 會登出使用者帳戶。 當呼叫 signOut API 時，訪客會收到來自伺服器的失敗回應。
• 變更後：當呼叫 <code>signOut</code> 時，Hive SDK 會向 Hive 伺服器詢問是否可以登出使用者帳戶，然後根據伺服器回應登出使用者。
• Android iOS 註銷訪客帳號 不再回傳成功回應，而是回傳錯誤代碼。訪客帳號會話在 Hive SDK 和 Hive 伺服器中都有維護。
• Android iOS 被暫停的帳戶會自動從身分提供者 (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。

Plugins¶

• Android iOS 盡量減少 Hive 外部相依性管理器管理的 XML 檔案數量。

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 裝置上確認應用程式追蹤透明度 (ATT) 同意時導致間歇性崩潰的問題。
• iOS 修正了在照片庫中選擇「限制存取」（僅允許存取某些照片）時會導致崩潰的錯誤。

Notification¶

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

v4.24.2.1¶

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

新功能¶

Community¶

• Windows 將遵循 Hive 約定的社區更改為使用 自訂網域地址 而不是 withhive.com, com2us.com。

v4.24.1.3¶

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

變更功能¶

Authentication¶

• Android iOS 變更設備管理服務，使其根據設備存取區域自動套用國際長途國家代碼。

v4.24.2.0¶

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

新功能¶

• Android iOS 在適用 GDPR 的歐盟和歐洲經濟區，我們提供了一個函數，返回 未滿 16 歲的用戶是否已同意條款和條件。您可以檢查使用者是否未滿 16 歲。
• Android 在執行 Android OS 11 或更高版本的裝置或安裝了支援模組的裝置上使用照片庫時，預設使用 PhotoPicker。
• iOS 您也可以在 macOS 控制台應用程式中查看 Hive SDK 偵錯日誌，並選擇要查看的 Hive SDK 日誌中的特定日誌類型。
• All 能夠控制在 Unity 編輯器中顯示 Hive SDK 偵錯日誌。

Authentication¶

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

Promotion¶

• Android iOS 提供控制交叉推廣展示效果的功能。
• Android iOS 今天，我們推出了一項改進的插頁式橫幅廣告功能，名為N 天插頁式橫幅廣告。

變更功能¶

Authentication¶

• Windows 更改了登入 Google 時不檢查 Google Play Games 資訊的權限，games_lite。

Promotion¶

• iOS 我們透過最小化使用遊戲邀請（用戶代理）功能時剪貼簿貼上權限彈出視窗的顯示，提升了用戶體驗。
  
  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 版本的開發環境。

變更功能¶

• 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 版本的開發環境。

新功能¶

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

Authentication¶

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

Billing¶

• iOS 如果有首次訂閱折扣訊息，則會在檢索產品資訊時一併傳遞。您可以透過尋找在使用 getProductInfo 回呼函數時收到的 IAPV4Product 物件清單中的 original_price 欄位和 price 欄位之間的差異來檢查折扣資訊。

Promotion¶

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

變更功能¶

• iOS 區分應用程式版本時，也可以使用CFBundleShortVersionString。
• Windows HIVE SDK 的 UI 和 webview 已變更為根據 DPI 設定而不是顯示器解析度進行顯示。

Authentication¶

• Windows 現在登入 Google 時，您可以使用 Windows 預設瀏覽器的「隱身模式」。受影響的瀏覽器包括：
• Google Chrome
• Microsoft Edge
• Mozilla Firefox
• Naver Whale
• Windows 如果您使用上述瀏覽器以外的網頁瀏覽器登錄，請使用「普通模式」登入。

Billing¶

• Android iOS 退款使用者付款介面中顯示的 PG 付款類型已從「HiveStore」變更為「PG 付款」。
• 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 發送的個人資料照片則無法登入 Google 的問題。 （我們也修復了即使未收到個人資料照片也能登入的問題。）

Billing¶

• Windows 修正了退款用戶付款介面中 PG 付款顯示為 Hive Store 的錯誤。
• Windows 修改了退款用戶付款介面的阿拉伯語螢幕，使其使用更適合阿拉伯語的介面。

Promotion¶

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

Others¶

• Windows 修正了執行輸入事件（例如點擊特定大小的視窗）時使用者介面會閃爍的問題。

已知問題¶

Authentication¶

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