SDK Unity 版本說明
本頁介紹 Hive SDK Unity 各版本的主要更新內容。
Hive SDK Unity 按目標 OS 的更新內容透過以下 OS 標籤區分。
- 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 控制台 > 安全金鑰設定 中簽發安全金鑰。若未簽發安全金鑰，將無法在應用程式中登入。
- 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 檔案。
- 下載並解壓縮 包含修正後 HTML 檔案資料夾的壓縮檔。
- 將整個資料夾複製到
Plugins/HIVESDK/Source/HiveSDKWindows/assets/additional 目錄下並覆蓋原有檔案。 - 重新建置應用程式。
- 在 Hive SDK v4 Unity 25.4.0 及以上版本中使用 SDK Manager 時，請升級至 SDK Manager v2.0.0 及以上版本。
v4.26.7.0
新功能
- Android 改善 Android 遊戲控制器操作性及 UI 焦點。
- 改善控制器操作，讓使用者可以移動滑鼠指標來選擇及控制 UI。
- 改善控制器操作，讓使用者可以更輕鬆地識別目前取得焦點的 UI 物件。
其他
- Android 作為 Google Level Up 計畫的一部分，提供
GameStat 整合功能。
變更功能
合規
- Android 將 Google Age-Signal 更新至 0.0.4 版本。
Hercules
- Android iOS 將
Configuration 類別的 SetUseHercules 方法標記為 Deprecated。 - 將 Hercules 函式庫更新至
2026.08.31 版本。
v4.26.6.0
新功能
認證
- Android 支援在日本本地市場 AGO（AnimateGo）中使用使用者認證（登入）和應用程式內購買功能的整合流程。
- All 支援日本 DMM 平台的認證方式 DMM 登入。
計費
- Windows 支援在日本商店 DMM 購買商品。
其他
- Android 支援 Google Level Up 計畫提供的 Sidekick 遊戲內覆蓋層整合功能。
變更功能
計費
- Windows 當
marketConnect 方法執行期間 Google Play Games PC SDK 初始化失敗且需要終止應用程式處理程序時，Hive SDK 將不再終止應用程式處理程序，而是回傳以下錯誤代碼。 - 新增錯誤代碼
IAPV4PlayStoreActionRequiredShutdown（-6100706）。
- All 改善 UI，在無法完成購買時引導使用者前往可用的付款路徑（商店 + 平台）。這解決了退款使用者在不同於原購買路徑的平台上重新購買時，付款按鈕僅被停用而沒有引導的問題。
- 市場相符時：若存在商品 PID，則可付款並正常顯示付款按鈕；若沒有商品 PID，則顯示商品不可購買標題和停用的付款按鈕。
- 市場不相符時：若目前市場無法付款，UI 會以 Web Store PG(Windows) 2 項、Google Play(Android) 1 項等格式引導可用付款路徑。
- iOS 在支援多個商店的環境中呼叫
marketConnect 方法時，變更邏輯，使部分商店連線失敗不會被視為整個商店整合失敗。
促銷
- Windows 在視窗模式執行應用程式時，改善促銷插頁式橫幅，使整張橫幅圖片依應用程式視窗大小縮放並完整顯示。
- Windows 將促銷插頁式橫幅的「今天不再顯示」功能變更為「N 天內不顯示」功能。
行銷歸因
- Android iOS 支援自動向主要行銷分析解決方案（MMP）傳送登入事件。
- 與 Firebase、AppsFlyer、Singular 和 Adjust 整合時，會自動傳送登入事件。
- Android iOS 支援為 Adjust 的跨行銷追蹤在裝置之間整合相同識別碼。
函式庫更新
- Windows Google Play Games PC SDK 25.5.818.0 → 26.3.312.0
Hercules
- Android Windows 將 Hercules 函式庫更新至
2026.06.15。 - iOS 將 Hercules 函式庫更新至 2026.07.06。
修復問題
促銷
- iOS 修正版面，使畫面載入期間顯示的進度指示器 UI 位於畫面中央。
- iOS 修復顯示大型橫幅時，長寬比超過 3:1 或小於 1:3 時 UI 版面無法正確顯示的問題。
行銷歸因
- iOS 修復傳送 Adjust 收益資料時自訂附加參數（
pub_param_revenue）遺失的問題。 - 現在發生收益事件時會與標準收益資料（
revenue_original）一起正確傳送。
開發者指南變更事項
v4.26.5.0
新功能
認證
- Android iOS 支援越南 Funtap 商店，並套用強化的身分驗證彈窗。新增一個需要以下詳細欄位作為參數的方法。
- serverId (伺服器 ID)
- serverName (伺服器名稱)
- characterId (角色 ID)
- characterName (角色名稱)
v4.26.4.0
請確認此 SDK 版本的 開發環境。
新功能
認證
- All 登入成功時，新增回傳的
PlayerInfo 物件中的 isNewUser 欄位，用以手動追蹤 NU(New User) 事件。
外掛
- Windows 支援 Unity 6 的 New Input 系統。
變更功能
- Android 移除 OneStore 已不再使用的 Maven 存放庫 URL。
- iOS 在 iPad 裝置上顯示 SDK UI 時，提供控制螢幕底部 Home Indicator 顯示的選項。
- iOS 修正網路監控模組未完全啟用前初始化其他模組會導致 Hive SDK 初始化失敗的問題。
認證
- All 本人認證請求時傳遞用於識別使用者的資訊。
- Android Google 登入可選擇 Google Sign-In 或 Google Credential Manager。
- iOS 配合越南 Funtap 市場推出，也支援 iOS 環境下顯示用於使用者身分驗證的 WebView 彈窗。
- Android 環境自 Hive SDK 26.2.0 起支援此功能。
- Windows 與行動端同步，刪除最後註冊的裝置時會顯示引導彈窗。
聊天
- All (即將終止支援) 即將終止
Chat.reconnect 支援。原有手動重新連線功能請改用 Chat.connect。詳情請參閱 聊天升級指南。
行銷歸因
- iOS 設定自訂購買事件時，改為僅傳送各 MMP 提供的「專用標準購買事件」格式，而非使用自訂事件名稱傳送資料。
函式庫更新
- Android Adjust 5.4.2 → 5.6.1
- Appsflyer 6.17.3 → 6.17.6
- Singular 12.10.0 → 12.11.0
- Airbridge 4.7.1 → 4.9.4
- Facebook 18.0.1 → 18.2.3
- Line 5.11.1 → 5.12.0
- iOS Adjust 5.4.6 → 5.6.2
- Airbridge 4.8.1 → 4.9.3
- Appsflyer 6.17.2 → 6.17.9
- Firebase Analytics 12.5.0 → 12.12.0
- Singular 12.9.0 → 12.10.0
- Line 5.14.0 → 5.15.0
- QQ 3.5.18 → 3.6.20
- SDWebImage 5.21.1 → 5.21.7
- hercules 2025.02.18 → 2026.04.29
- Facebook 18.0.2 → 18.0.3
解決的問題
- Windows 修正 Hive SDK 收到無法解析的 JSON 以外資料時發生當機的問題。
外掛
- iOS 修正未使用
PushAction 模組的環境中，建置設定狀態仍顯示為啟用的問題。 - iOS 修正 Swift Package Manager(SPM) 發佈封裝規格，使開發者在 SPM 整合建置階段上傳 App Store Connect 驗證不再失敗。
其他
- Windows 修正 Steam 環境中，其他未整合 Hive SDK 的應用程式 Steam 登入回呼導致應用程式當機的問題。
- Windows 修正同時執行兩個以上整合 Hive SDK 的應用程式時，一邊開啟並關閉 Hive 登入 WebView 會導致另一邊應用程式當機的問題。
v4.26.3.4
已變更的功能
Compliance
- iOS Age Range 模組程式庫根據
PermissionKit 依賴項分離為 HiveAgeRangeApple 和 HiveAgeRangePermissionApple。 - 實作巴西 ECA 合規時，僅使用不含
PermissionKit 依賴項的 HiveAgeRangeApple。 - 實作美國 App Store 責任法合規時，除 HiveAgeRangeApple 外，還需使用含
PermissionKit 依賴項的 HiveAgeRangePermissionApple。
v4.26.3.2
新功能
Billing
Compliance
- Android 為因應未成年人保護年齡驗證法，Hive SDK 提供的 Age Range 模組新增支援巴西 ECA 法合規。
變更功能
說明: 此 SDK 版本不含新功能與變更，僅更新版本號。
v4.26.3.0
v4.26.2.0
請確認此 SDK 版本的 開發環境。
新功能
- Windows 提供使用 OSR(Off-Screen Rendering)，透過遊戲引擎 UI 系統在遊戲畫面上顯示 Hive SDK 提供的 UI Overlay 功能。
認證
推廣
- Android iOS 支援行動裝置中全螢幕(Full-screen) WebView 和應用程式內瀏覽器的畫面方向設定。
- 應用程式內瀏覽器的畫面方向遵循 Hive 控制台中設定的顯示方向(橫向/直向/雙向)。但在部分 Android 目標裝置的應用程式內瀏覽器中，會遵循裝置本身設定的方向。
分析
- All 除 Analytics 外，還額外提供 ThinkingData(TD) 服務。您可以在兩種服務中選擇其一，並設定資料蒐集與登入聯動。
聊天
合規
- Android 擴充支援面向 Galaxy Store 發佈應用程式的 Age Range 模組。
- 與 應對應用程式商店責任法 相關，現在也支援在透過 Galaxy Store 發佈的遊戲應用程式中使用 Age Range 模組來確認使用者年齡資訊。
變更功能
- Windows 進行改善，即使 URI 中包含空網域，也能正常擷取 URL 元素(協定、網域)。
認證
- All 利用 PASS 本人認證結果簡化認證流程。
- 如果已透過 PASS(網頁/應用程式) 完成本人認證，可利用認證結果中的使用者資訊跳過以下認證步驟。
- 跳過透過 PASS(網頁/應用程式) 進行的成人認證步驟
- 跳過裝置管理服務註冊所需的 OTP 認證步驟
- 在本人確認服務執行過程中，只會執行 1 次本人認證，不會重複執行 PASS(網頁/應用程式) 認證。
- All 當因同一手機號碼反覆嘗試認證導致 OTP 傳送次數超限時，新增錯誤彈窗。
- 在裝置管理服務中，如果同一手機號碼因反覆嘗試認證而超出 OTP 傳送次數限制，將新增向使用者說明認證失敗原因的錯誤彈窗。
- Windows 調整為在 Windows 中也顯示個人資料裡的 Hive 帳號設定 按鈕。
推廣
- Windows 現在可以 按照遊戲指定的畫面方向(橫向或直向)顯示公告頁面 UI。畫面方向分為將分頁從上到下排列(以畫面左上角為基準)的橫向型，以及從左到右排列的直向型。
- Android iOS iOS 移除 YouTube 影片廣告播放功能。
- 變更點: 移除原本在不統計播放量的情況下播放 YouTube 內容的影片廣告功能
- 變更原因: 由於播放功能異常導致穩定性下降，且缺少實際使用案例，因此使用率較低
外掛
- iOS 將 Hive SDK Unity iOS 中包含的 External-Dependency-Manager for Unity(EDM4U) 套件升級至最新版本。
函式庫更新
- Android OneStore Billing Library (Android): v21.02.00 → v21.04.00
已修復的問題
- Android 修復 Android 15(API Level 35) 顯示器挖孔區域 UI 重疊問題。
- 修復了在搭載 Android 15(API Level 35) 的裝置中，SDK UI 渲染侵入顯示器挖孔區域(瀏海/相機開孔) 的問題。現在會考慮挖孔區域，並在安全區域(Safe Area)內正常顯示所有 UI 元素。
v4.26.1.5
已修復的問題
- iOS 修復了在 iOS 26.4 環境中，使用 WebView 的彈窗(登入、橫幅、客服中心、社群等)無法正常運作的錯誤。
v4.26.0.2
已修復的問題
- iOS 修復了在 iOS 26.4 環境中，使用 WebView 的彈窗(登入、橫幅、客服中心、社群等)無法正常運作的錯誤。
v4.25.9.1
已修復的問題
- iOS 修復了在 iOS 26.4 環境中，使用 WebView 的彈窗(登入、橫幅、客服中心、社群等)無法正常運作的錯誤。
v4.25.8.3
已修復的問題
- iOS 修復了在 iOS 26.4 環境中，使用 WebView 的彈窗(登入、橫幅、客服中心、社群等)無法正常運作的錯誤。
v4.26.1.4
變更功能
認證
- Android 將使用 Credential Manager 的 Google 登入功能改為「選項啟用(Opt-In)」方式。
- 變更原因: 在部分支援 16 KB 頁面大小(pageSize) 的 Android 16(API Level 36) 裝置中，使用 Credential Manager 的 Google 登入存在相容性問題。
- 主要變更點: 將 Google 登入方式回退為原有的 Google Sign-In。
- 後續計畫: 在後續發佈的 Hive SDK Android 版本中，提供將「使用 Credential Manager 登入」作為預設登入方式啟用的 API。
v4.26.1.3
已修復的問題
認證
- iOS 修復了在 iPad 裝置中，當點擊需要輸入出生日期資訊的年齡限制(AgeGate) 彈窗或與日曆相關彈窗的空白區域時，應用程式發生卡死(無回應) 的問題。
- iOS 修復了裝置管理服務在 iOS 裝置上執行時，部分彈窗中顯示不必要捲軸的問題。
計費
- iOS 修復了呼叫 getAccountUUID 方法時回傳值發生變化的問題。
推廣
- Android 修復了在遊戲應用程式以背景模式執行時顯示推廣彈窗，如果發生使用者參與(User Engagement, UE) 直達連結事件，推廣彈窗會消失的問題。
行銷歸因
- iOS 修復了在解析度寬度低於 1170px 的 iOS 裝置中，Digital Markets Act(DMA) 同意橫幅的部分文字無法顯示的問題。
v4.26.1.2
變更功能
認證
- Android iOS iOS 在中國地區進行 Hive 會員登入時，如果已完成手機號碼認證，則在中國實名認證階段不再執行手機號碼認證，而是直接進入身分證認證。
- 現有 Hive 會員登入中執行的是會員 ID(電子郵件地址) 認證而非手機號碼認證，因此在後續中國實名認證階段仍需進行手機號碼認證。
已修復的問題
- iOS 修復了執行 Apple Submission 時，錯誤生成的 bundle 檔案 Info.plist 被包含在內，導致發行版本驗證失敗的問題。
- iOS 修復了在退款使用者重新支付 UI 中，PG 支付顯示為 Hive Store 的問題。
v4.26.1.1
說明: 此 SDK 版本不單獨提供發佈檔案，對應功能包含在更高版本 SDK 中。
已修復的問題
外掛
- iOS 修復了在 iOS 目標環境中設定外部函式庫依賴之後，Hive SDK 版本資訊無法被準確反映的問題。
v4.26.1.0
請確認此 SDK 版本的 開發環境。
新功能
認證
計費
推廣
- All 支援 Deferred Deep Link。即使使用者在未安裝應用程式的狀態下點擊直達連結，也可在安裝完成後跳轉到連結中指定的應用程式內頁面。
行銷歸因
遠端遊玩
- Windows 從遠端遊玩外掛 1.01.02 及以上版本開始，在遠端遊玩過程中點擊外部連結時，可以在遠端裝置上開啟頁面。因此，即使在遠端遊玩過程中也可以進行 PG 支付。
附加功能
- Android 在 透過遊戲內 WebView 開啟 場景中，當透過 PlatformHelper 類別的 showInWebView 方法顯示 WebView 時，提供使用 Game Activity 而非 Hive Activity 進行顯示的選項。
其他
- All 在
Configuration 類別中新增 getGameLanguage 方法，可確認 SDK 中設定的語言值。 - iOS 隨著 CocoaPod 服務終止，提供透過 SPM(Swift Package Manager) 的發佈服務。
變更功能
- Windows 改進 HTTP 通訊邏輯，增強穩定性。
認證
- Android iOS 成人認證方式不僅支援網頁方式，也支援應用程式方式。
- All 移除 SNS 登入時自動蒐集頭像和暱稱的功能，詳見 相關說明。
- All 隨著新增
AuthV4.setAutoLoginEnabled(預設值: PC OFF / Mobile ON)，自動登入行為策略調整如下。 - 現有: 發生帳號衝突後切換到其他帳號時，變更後的帳號在行動端保持自動登入，在 PC 端關閉自動登入
- 變更後: 發生帳號衝突後切換到其他帳號時，若變更後的帳號已在行動端和 PC 端透過
AuthV4.setAutoLoginEnabled 註冊自動登入工作階段，則保持自動登入；否則解除自動登入(存在例外情況)
- Windows 在 SteamDeck 上使用本人認證功能時，新增關於不支援 Pass 的提示彈窗。
- Android 調整為 Google 登入時同時使用 Credential Manager 和 PlayService Auth。當 Credential Manager 發生 FailOver 時，會嘗試透過 PlayService Auth 登入。
計費
- Windows PG 支付現在會透過外部瀏覽器執行。
- Android 將 Google Play 支付所使用的函式庫更改為 Google Play Billing Library 8.0。
推廣
- Windows 修復了透過自訂檢視/直達檢視跳轉到外部瀏覽器時 WebView 會閃爍的問題。
- Android iOS 修復了透過自訂檢視/直達檢視跳轉到外部瀏覽器時 WebView 會閃爍的問題。
推播
- iOS 在蒐集用於傳送推播的 token 時，調整為根據建置環境蒐集 token 的附加資訊。
行銷歸因
- Android iOS 調整 顯示 DMA 同意橫幅 彈窗的設計並改進其行為。
- 現有同意橫幅中已同意的記錄會繼續保留，再次顯示時將展示改進後的文案與 UI 的新同意橫幅。
- 如果之前對同意橫幅文案進行了自訂，則需要根據變更後的資料結構，參考 自訂同意橫幅 UI 設定 重新進行設定。
- Android iOS 調整為不會重複傳送傳輸到 MMP 的同一收據營收日誌。
- Android iOS 在傳送 Firebase 購買事件時，新增同時向 value 鍵傳輸營收值。
附加功能
- Android iOS 改進 透過遊戲內 WebView 開啟 時，透過 PlatformHelper 類別的 showInAppView 方法顯示的 WebView 關閉按鈕可視性。
外掛
- iOS 改進隨 SDK 一併發佈的 JSONObject 類別相容性。
- 避免與建置環境中的其他 JSONObject 類別發生名稱衝突。
配置
- Windows 在伺服器維護、更新、公告與封鎖彈窗中，調整為點擊按鈕時透過結束回呼的方式處理退出。
- Android iOS 將可應對應用程式商店責任法的 Age Range API 以可選方式拆分提供。
- 2026 年 1 月 1 日起在美國德州施行的應用程式商店責任法目前處於暫緩施行狀態，可依開發情況選擇性套用。
- 可為應對 2026 年 5 月美國猶他州、7 月路易斯安那州施行的應用程式商店責任法而選擇性套用。
函式庫更新
- Windows 調整為使用 14.44.35211.0 及以上版本的 Microsoft Visual C++ Redistributable。
- Android Amazon AppStore (Android) v3.0.4 → v3.0.8
- Samsung GalaxyStore IAP (Android) v6.1.1 → v6.5.0
- Google Billing Library (Android) v7.0.0 → v8.0.0
- QQ (Android) v3.5.17 → v3.5.18
- Xiaomi (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
其他
- All 調整為
Configuration.setZone 僅在初始化之前有效。
已修復的問題
- Android 修復了在整體共通區域 UI 的背景不透明時，內容顯示到挖孔區域內的問題。
認證
- iOS 修復了使用聊天機器人時，聊天訊息輸入欄偶爾無法顯示的問題。
- iOS 修復了在超過裝置管理註冊數量的狀態下完成成人認證後，刪除已註冊裝置時會再次顯示成人認證彈窗的問題。
- Windows 修復了在 AuthV4 認證過程中嘗試結束應用程式時無法退出的問題。
- Windows 修復了請求本人認證頁面的應用程式結束後，在其他應用程式(或重新啟動的應用程式)中請求認證時，先前請求的認證結果被錯誤傳遞，導致出現錯誤(
-1200001, -8) 的問題。
推廣
- iOS 修復了當公告選單數量超過一定數量時無法正常運作的錯誤。
- iOS 修復了當全螢幕橫幅中顯示圖片的寬或高為
0，或伺服器傳送錯誤資訊時無法正常運作的問題。 - iOS 修復了透過直達連結顯示社群時，如果沒有 URL 參數則直達連結無法運作的錯誤。
- Windows 修復了在推廣中點擊「今天不再顯示」後，該推廣永久不再顯示的問題。
推播
- Android 修復了即使屬於 COPPA 對象也會蒐集推播通知 token 的錯誤。
- iOS 修復了 ForegroundPush 設定無法變更為 False 的錯誤。
行銷歸因
- iOS 修復了在 Firebase 中 Install 或 Update 事件遺漏的問題。
- Windows 修復了行銷歸因中的購買日誌被重複蒐集的問題。
遠端遊玩
- Windows 修復了遠端遊玩中更新 JWT token 時發生當機的問題。
附加功能
- iOS 修復了在 開啟遊戲內瀏覽器 時，如果應用程式使用者網路狀態為離線或切換為離線，並且套用 PlatformHelper 類別的 showInAppBrowser 方法，會出現遊戲應用程式閃爍並關閉視窗的現象。
其他
- Windows 修復了在 interwork:// 等內部 scheme 中，當輸入
?831020 這類非 key-value 形式的 query 值時，先前會被錯誤傳遞為 831020=，現在已改善為按 831020 原樣傳遞。 - Windows 修復了在使用遠端遊玩等外掛時，透過
Configuration.setZone 設定的 Zone 無法生效的問題。
v4.26.0.1
變更功能
- iOS Hive SDK 開發環境使用的 Xcode 版本變更如下。
- 變更前: Xcode 26.2 Beta2
- 變更後: Xcode 26.2
配置
v4.26.0.0
請確認此 SDK 版本的 開發環境。
新功能
- iOS 現在可以在 iOS Xcode 26.2 及以上版本中建置 Hive SDK。
配置
- Android 新增 合規 功能。
- 當透過 Google Play 和 Amazon Appstore 發佈遊戲應用程式時，Hive SDK 提供 Age Range API，用於應對自 2026 年 1 月 1 日起在美國德州施行的應用程式商店責任法，以確認使用者年齡範圍。
- iOS 新增 合規 功能。
- 當透過 Apple App Store 發佈遊戲應用程式時，Hive SDK 提供 Age Range API，用於應對自 2026 年 1 月 1 日起在美國德州施行的應用程式商店責任法，以確認使用者年齡範圍。
- 僅支援 iOS 26.2 及以上版本。
已知問題
配置
v4.25.8.2
請確認此 SDK 版本的 開發環境。
已修復的問題
支付
- Windows 修復了在 Google Play Games PC 支付中，當註冊商品超過 20 個時無法取得全部商品資訊的問題。
v4.25.8.1
說明: 此 SDK 版本不單獨提供發佈檔案，對應功能包含在更高版本 SDK 中。
已修復的問題
其他
- Windows 修復了變更遊戲語言後，關閉提示 UI 仍以初始設定語言顯示的問題。
聊天
- Windows 修復了韓文訊息不會觸發回呼的問題。
v4.25.9.0
請確認此 SDK 版本的 開發環境。
新功能
認證
- All 提供 本人確認服務。
- SteamDeck 不提供本人確認服務(本人確認、成人認證、監護人同意)。請先在行動裝置或 PC 上使用本人確認服務後，再於 SteamDeck 上重新接入遊戲。
已修復的問題
其他
- Windows 修復了變更遊戲語言後，關閉提示 UI 仍以初始設定語言顯示的問題。
v4.25.7.1
說明: 此 SDK 版本不單獨提供發佈檔案，對應功能包含在更高版本 SDK 中。
已修復的問題
其他
- 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 Level 36)。
- Android 在以 Android OS 15(API Level 35) 及以上版本進行建置時，支援 16KB Page Size 建置。
遊戲資料儲存
聊天
變更功能
- Android 移除不再使用的
android.permission.FOREGROUND_SERVICE 權限。 - Android 將 Android 最低建置目標從
19 調整為 23。
認證
- iOS 移除在 Xcode 26 中建置時無法使用的函式庫參照。
計費
- Windows 將 Google Play for Native PC (EAP) 整合方式從 Web API 方式切換為基於 Google Play Games PC SDK 的方式。
- 現在不再透過 Hive SDK 認證，而是需要透過 Google Play Games PC 應用程式使用 Google 帳號登入。請查看 初始化注意事項。
- 無論是現有專案還是新專案，都需要按照 Google 指南 準備 Manifest 設定和程式碼簽章。
函式庫更新
- 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 Sign-In) 20.7.0 → 21.3.0
- play-services-games-v2(Android) (Play Games Services) 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 Sign-In(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。
已修復的問題
認證
- iOS 修復了顯示聊天機器人彈窗時，偶爾顯示為橫向而不是直向的問題。
- iOS 修復了可能發生空陣列參照錯誤的問題。
- 在使用 Authv4 類別的
showConflict 方法時，如果缺少必填輸入資料，會導致當機。
遠端遊玩
- Windows 修復了即使透過
Application.CancelQuit 或 Application.wantsToQuit 取消遠端遊玩連線結束，連線仍會被關閉的問題。現在僅在應用程式真正結束時才會結束連線。
其他
- Windows 提升了對快速連續方法呼叫的穩定性。
分析
- Android 修復了在用戶端並發傳輸失敗時，不會夾帶不必要資訊進行重新傳送的問題。
v4.25.7.0
說明: 此 SDK 版本不單獨提供發佈檔案，對應功能包含在更高版本 SDK 中。
新功能
認證
- All 完成成人認證後，可以識別已完成成人認證的使用者。提供 取得識別值的方法。識別資訊為雜湊處理後的 DI 值。
變更功能
認證
- Android iOS 如果在 Hive 控制台中將應用程式設定為使用成人認證，則登入後會自動執行成人認證流程。
- Android iOS 將執行成人認證的
showAdultConfirm 方法標記為 deprecated。 showAdultConfirm 方法可能會在後續更新中移除。
已修復的問題
認證
- Windows 修復了因 監護人同意 失敗而導致登入失敗時，登入資訊不會重設的問題。
- Windows 修復了使用 自訂登入 的使用者在遊戲內購買道具後，如果在應用程式商店中出現 自動退款 情況，再用相同帳號重新連線遊戲時登入失敗的問題。
- Windows 修復了在
AuthV4.signOut 回呼內部呼叫 AuthV4.showSignIn 時發生當機的問題。
其他
- Windows 修復了當遊戲以管理員權限執行時，透過 Hive SDK 開啟外部 Web 瀏覽器時，如果 URL 長度超過 800 個字元，瀏覽器無法正常開啟的問題。
v4.25.6.0
說明: 此 SDK 版本不單獨提供發佈檔案，對應功能包含在更高版本 SDK 中。
新功能
聊天
- Android iOS 新增可對特定聊天訊息表達或顯示「按讚」的功能。
- Android iOS 提供可對特定聊天訊息撰寫「回覆」以及顯示回覆關聯關係的資訊。
- Android iOS 提供提及特定使用者或傳遞提及使用者資訊的功能。
變更功能
聊天
- Android iOS 將 頻道訊息查詢方式 從基於索引改為基於訊息 ID 查詢。
v4.25.5.2
請確認此 SDK 版本的 開發環境。
已修復的問題
認證
- iOS 修復了在橫向模式下顯示聊天機器人時會發生當機的錯誤。
v4.25.5.1
說明: 此 SDK 版本不單獨提供發佈檔案，對應功能包含在更高版本 SDK 中。
請確認此 SDK 版本的 開發環境。
新功能
認證
- Android iOS 新增 多帳號切換 功能。相關詳細功能如下。
- 將目前登入帳號儲存到裝置
- 查詢已儲存帳號
- 登出並刪除已儲存帳號
- 使用其他已儲存帳號快速登入
推廣
通知
- Android iOS 新增 推播動作按鈕。
- 在收到推播通知時，可透過推播選擇動作按鈕執行預先定義的動作。
聊天
- 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 中。
認證
- Android iOS 調整為在不使用 Hive 會員帳號的情況下呼叫原本無法運作的
showMyInquiry 方法時，也能顯示諮詢頁面。 - Android 將 VK 認證彈窗從 WebView 更改為應用程式內瀏覽器。
行銷歸因
- iOS 調整為在啟用自動蒐集的 Firebase 購買事件時提供支援。
已修復的問題
推廣
- iOS 修復 iPad 裝置中公告 UI 圓角顯示問題。
配置
- iOS 修復顯示條款時 WebView 無法捲動的問題。
分析
- iOS 調整邏輯，使其能夠在條款同意結束後立即傳送 Analytics 日誌。
已知問題
其他
- iOS 在橫向模式下使用聊天機器人時存在當機問題。
- 請升級至 Hive SDK Unity iOS 25.5.2 及以上版本。
v4.25.5.0
請確認此 SDK 版本的 開發環境。
新功能
認證
分析
- Windows 在 Airbridge 日誌 中新增
device.platform。該值為 "Steam" 或 "Desktop"。此值也可在 Airbridge 儀表板中即時查看。
變更功能
其他
- Windows 改進了與 MMP 相關的內部邏輯。
已修復的問題
認證
- Windows 修復了使用 多帳號切換 時，在自動登入後呼叫登出會使工作階段失效、從而無法重新登入的問題。
推廣
- Windows 修復了在呼叫 Promotion.updatePromotionData() 後立即開啟公告頁面時，偶發當機的問題。
其他
- Windows 解決了 Hive SDK 開啟新視窗時，NVIDIA 顯示卡驅動 572.16 與 DirectX 11 之間發生的相容性衝突問題(Apple 登入、Facebook 登入、PG 支付)。
v4.25.4.0
請確認此 SDK 版本的 開發環境。
新功能
認證
- Windows 新增 多帳號切換 功能。相關詳細功能如下。
- 將目前登入帳號儲存到裝置
- 查詢已儲存帳號
- 登出並刪除已儲存帳號
- 使用其他已儲存帳號快速登入
- Windows 當已被停止遊戲使用的使用者嘗試登入時，調整為僅在應用程式內登出而不關閉應用程式。
- Windows 可在 遠端遊玩外掛 中使用增強認證協定。
其他
- Windows 新增可將 Hive SDK 及相關依賴 隔離到單獨資料夾 的功能。
已修復的問題
其他
- Windows 解決了 Hive 功能行為的漏斗日誌未統計問題。
v4.25.3.0
說明: 此 SDK 版本不單獨提供發佈檔案，對應功能包含在更高版本 SDK 中。
新功能
推廣
- Windows 調整為在呼叫
Promotion.getBannerInfo 時傳遞 typeCampaign 值。 - Windows 蒐集登入事件，以便在 輸入邀請碼的使用者安裝應用程式 時發放獎勵。
其他
- Windows 新增在透過跨平台啟動器啟動遊戲時，查詢附加在啟動 URI 上的 啟動參數 功能。
- Windows 在控制器按鍵映射支援對象中新增 特定 UI。
- Windows 新增在可透過控制器按鈕關閉時顯示關閉按鈕說明的 UI。
變更功能
函式庫更新
- Windows 將 Chromium Embedded Framework 函式庫版本更換為 128.45。
已修復的問題
其他
- Windows 修復了當遊戲引擎設定預設滑鼠游標時，WebView 關閉後進行滑鼠操作會交替顯示 Windows 預設游標的問題。
- Windows 修復了 Hive SDK 內部將非 JSON 而是 HTML 作為結果傳遞時發生錯誤的問題。
- Windows 調整為將 Steam 市場連線失敗錯誤碼細分後傳遞。
- 新增錯誤碼
IAPV4SteamMarketResponseError(-6101001)。 - 依
[IAPv4] Steam server response error : (code: ... , message: ...) 形式傳遞錯誤碼與訊息。
- Windows 修復了在 Steam 離線模式下嘗試 Steam 登入時無法回傳回呼的問題。
v4.25.2.2
請確認此 SDK 版本的 開發環境。
變更功能
認證
- Android 由於 Google Credential Manager 相容性較低，導致部分使用者無法接入，因此將認證方式回退為原有的 Google Sign-In。
函式庫更新
- Android GooglePlay Services-Auth(Android) v20.7.0 (重新支援 Google Sign-In 回退)
- Google Credential Play Services Auth(Android) v1.3.0 (移除 Google Sign-In 回退)
v4.25.2.1
請確認此 SDK 版本的 開發環境。
已修復的問題
行銷歸因
- Android 修復了用於 MMP 服務聯動 的 Hive SDK 識別碼中 did 值缺失的問題。
v4.25.2.0
請確認此 SDK 版本的 開發環境。
新功能
- Android iOS 支援 Unity 6.1 (6000.1)。
認證
- Windows 新增支援將 LINE 作為認證方式(IdP)。
配對
配置
- Windows 新增對 按帳號顯示條款功能(
agreementDetermineBase) 的支援。
變更功能
認證
計費
- Android 在透過 PG 支付購買的商品被退款時，為了與先前交易區分，新增
order_id 值。 - Android Windows 調整為在 PG 支付交易完成時，透過行銷歸因傳送購買完成日誌。
推廣
- Android 在分享 User Acquisition 時，調整為將 Telegram 加入支援的顯示清單中。
- Android 調整 WebView 顯示時的快取策略。
行銷歸因
- Android iOS 為支援 MMP 服務聯動，追加傳輸 Hive SDK 識別碼。
- Windows 為支援 行銷歸因，追加傳輸 Hive SDK 識別碼。
- All 調整為在手動追蹤事件時，追加 自訂屬性 後再傳輸。
- Android 調整為在初始化 Airbridge 時傳輸市場來源資訊。
- iOS 使用 sendEventWithAttributes API 時，將
semantic value 類型浮點值的精度範圍從 float 更改為 double。
配置
- All 在條款詳情查看與重新查看頁面中，以下情況下將不再使用條款頁面(WebView)，而是新開外部瀏覽器進行載入。
- 跳轉到條款 URL 之外的網頁時
- 點擊條款中的超連結 HTML 標籤(a 標籤、tel:// 等)時
函式庫更新
- 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
- GooglePlay Services-Auth(Android) v20.7.0 (停止支援)
- Google Credential Play Services Auth(Android) v1.3.0 (新增支援)
- iOS Airbridge(iOS) v4.1.1 → v4.3.0
- Adjust(iOS) v5.0.1 → v5.2.0
- Singular(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
聊天
- Android iOS 在傳送或接收訊息資料時，追加傳輸與接收
extraData。 - Android iOS 在連線聊天伺服器時，不再傳輸
extraData。 - Android iOS 除字串時間值外，另外接收整數型時間值。
- Android iOS 在網路被阻斷等無法通訊的情況下，如果 WebSocket 未能正常釋放而嘗試重新連線，調整為不會因重複連線狀態而失敗。
已修復的問題
- Android 修復了在需要透過網路重新嘗試通訊，或需要連線到分散式伺服器的情況下，如果在設定的最大逾時時間之前收到回應，不再繼續等待逾時，而是立即進行通訊重試或連線分散式伺服器的問題。
- iOS 修復了當透過 Configuration 類別的
setZone 方法變更 Hive SDK 連線的伺服器群組 Zone 時，hive_config.xml 檔案中的 gameLanguage 值會被初始化的問題。
認證
- iOS 修復了在 iOS 18 及以上裝置中，QQ Web 登入無法正常進行的問題。
- Windows 修復了用於增強安全協定的 JWT token 無法傳遞到利用 Hive SDK WebView 通訊流程中的問題。
計費
- Windows 修復了在多重巢狀 Hive SDK 方法回呼的狀態下呼叫以下任一方法時，應用程式會卡死的問題。
IAPV4.transactionFinishIAPV4.transactionMultiFinishIAPV4.restore
行銷歸因
- Android 修復了在使用 Adjust 判斷安裝狀態的功能時，會顯示空白推播通知的問題。
- Android 修復了在使用 Airbridge 時，如果發生購買多個商品的事件，會依據單價和數量傳遞營收資訊的問題。
配置
- Android iOS 修復了在 SDK 初始化之前執行廣告模組(Adiz) 初始化時，即使需要遵守 COPPA 或 GDPR 等合規要求，用於年齡確認的
AgeGate 值仍依 hive_config.xml 中設定的值運作的問題。
聊天
已知問題
行銷歸因
v4.25.1.3
請確認此 SDK 版本的 開發環境。
變更功能
計費
- Android 將 PG 支付的行為方式更改為與其他計費(
IAPv4) 功能中的市場一致。如果正在套用 PG 支付，則必須參考 PG 支付 文件修改程式碼實作。
行銷歸因
已修復的問題
計費
- iOS 修復了顯示詢問是否同意傳輸消費資訊的彈窗 UI 時，背景畫面不透明的問題。
- iOS 修復了關閉詢問是否同意傳輸消費資訊的彈窗 UI 時，應用程式畫面方向會朝非預期方向旋轉的問題。
推廣
- iOS 修復了顯示包含圖片的評論彈窗時，如果發生旋轉事件，正在顯示的圖片會消失的問題。
行銷歸因
- iOS 修復了透過 Adiz 傳輸廣告收益資訊時，Airbridge 會將其識別為 AdMob 而非 Adiz 的問題。
v4.25.1.0
請確認此 SDK 版本的 開發環境。
新功能
認證
其他
變更功能
計費
- Windows 將 PG 支付的行為方式更改為與其他計費(
IAPv4) 功能中的市場一致。如果正在套用 PG 支付，則必須參考 PG 支付 文件修改程式碼實作。
推廣
- Windows 調整透過
additionalInfo 傳遞的值，使其不再包含不必要的資訊。
開發環境
- Windows 將所需的最低 Microsoft Visual C++ Redistributable 版本更新為 14.42.34438。
已修復的問題
認證
- Windows 修復了當使用者選擇 Hive 會員以外的登入方式後取消登入時，Hive SDK 控制器的滑鼠操作功能仍會生效的問題。
v4.25.0.1
請確認此 SDK 版本的 開發環境。
新功能
行銷歸因
- iOS 修復了在使用套用了 Adjust v5 的 Hive SDK v4 25.0.0 及以上版本時，SDK 自動蒐集並傳送的 did、vid 值不會被傳送的問題。
變更功能
開發環境
- Windows 將所需的最低 Microsoft Visual C++ Redistributable 版本更新為 14.38.33130。
已修復的問題
計費
- Windows 修復了在使用 JWT token 套用增強安全協定時，退款使用者重新支付功能不顯示的問題。
v4.25.0.0
請確認此 SDK 版本的 開發環境。
新功能
認證
計費
推廣
配對
- Android iOS 更新配對功能，新增支援 群組配對 功能。 ※ 與舊版本 Hive SDK Interface 不相容。要使用更新後的配對功能，必須使用 Hive SDK v4 25.0.0 及以上版本。
行銷歸因
其他
- Windows 在 ASUS ROG Ally 等搭載觸控螢幕的掌上型裝置中支援 觸控手勢。
- Windows 在使用遊戲控制器時，新增支援 控制器按鍵映射，並可聚焦與操作部分 Hive UI 元素。
- Windows 新增支援套用 自訂游標，以取代一般滑鼠游標。
- Windows 新增可啟用或停用遊戲控制器操作的設定。
聊天
變更功能
認證
- Android iOS 刪除不再使用的
Auth 模組類別、介面、方法、代理與監聽器。 - All 使用 JWT token 套用更強的安全協定。
- Android iOS 隨著 TalkPlus 支援終止，刪除 TalkPlus 認證 token 方法。
- Android 允許在 Apple 登入 WebView 中，除登入功能外還可進行找回密碼等瀏覽操作。
推廣
- Windows 在公告選單分頁中新增新內容提醒顯示。
行銷歸因
- Android iOS 更新以支援 Adjust v5。
- Android iOS 調整為在透過 Adjust 統計 Adiz 廣告營收時，將廣告營收來源作為 AdMob 來源傳輸。
- Android 反映 Appsflyer 廣告營收統計函式庫已整合到主函式庫中的變更。
- 6.14.2 → 6.15.2
- 移除 Appsflyer ad-revenue 函式庫。
Unity
- All 改進 Hive Config Setting UI。
Hercules
已修復的問題
認證
- Android 解決了在執行
signIn 方法過程中，如果網路回應延遲發生，偶爾會佔用 UI 執行緒的問題。 - Windows 修復了退款使用者重新支付狀態的使用者在 PC 上登入時發生
CommonUnknown 錯誤的問題。 - Windows 改進 UI，使拖曳「保持登入狀態」文字時不會出現「隱私保護警告」文案。
計費
- iOS 修復了在使用 UserEngagement 引導使用者購買應用程式內商品時，會額外觸發
IAP_UPDATE 事件的問題。 - Windows 修復了在 Steam 支付過程中，如果透過 ESC 鍵或其他按鍵操作關閉 Overlay，就無法繼續支付的問題。
其他
- Windows 透過最佳化迴圈重複條件，修復了 CPU 使用率無法恢復正常的問題。 ※ 如果正在使用受影響版本(4.24.1.0 及以上)，請升級至 SDK v4 Unity Windows 25.0.0 後確認 CPU 使用率是否恢復穩定。
已知問題
行銷歸因
- 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 Interface 的更新。
認證
- Android iOS 新增支援 Steam、X(原 Twitter) 作為認證方式。
- Android 提供可共享已認證工作階段的 應用程式內瀏覽功能。
推廣
- Android iOS 在 Spot Banner 中也可顯示廣告。
- Android 在使用者邀請分享功能中支援 X(原 Twitter)。
配對
變更功能
認證
- Android iOS 調整衝突彈窗中顯示的 Provider 名稱。
外掛
- Android iOS 套用提供的 EDM4U 最新版本。
- iOS 調整為在使用 GameCenter 登入時，自動 新增建置所需的 Entitlement 設定值。
- 現有即使使用 GameCenter 登入，也需要額外進行 Capability Manger 設定。
- 如果缺少 Entitlement 設定值，在 iOS 18 及以上裝置中將無法正常登入。
已修復的問題
計費
- iOS 修復了當部分商品價格屬於浮點數無法精確表示的類型時，在 JSON 格式中不會以循環小數而會以正確小數形式表示的問題。
- 例如>
4.99$ (string) → 4.9900000000000011 (double) → 4.99 (JSON number)
外掛
- All 使用顯式命名空間，以避免與部分外部外掛產生導致編譯錯誤的介面重複問題。
- Android 修復了在使用 Firebase 行銷追蹤工具或 Huawei 認證功能時，Android 目標平台所需設定缺失的問題(發生於 SDK v4 24.3.0 及以上版本)。
v4.24.4.2
說明: 此 SDK 版本不單獨提供發佈檔案，對應功能包含在更高版本 SDK 中。
變更功能
- Windows 移除了 UI 中未使用的不必要資源。
v4.24.4.1
請確認此 SDK 版本的 開發環境。
新功能
遠端遊玩
- Windows 從 Hive SDK Unity Windows v4.24.4.1 及以上版本開始，支援 遠端遊玩。
變更功能
認證
- Windows 調整 IdP 選擇 UI，讓使用者能更清楚辨識 保持登入狀態 UI 是否被選取。
- Windows 修正 IdP 選擇 UI 的英文翻譯文案。
- 變更前: Keep me logged in
- 變更後: Stay signed in
v4.24.4.0
請確認此 SDK 版本的 開發環境。
新功能
計費
- Android Windows 在請求 PG 支付時，支援使用
IAPv4.purchase 進行 多數量購買。
行銷歸因
- Android iOS 支援面向 Hive SDK 特化的 Airbridge 服務。
遠端執行
變更功能
外掛
- Android iOS 調整為 Android 的 Package Name 或 iOS 的 Bundle Name 自動設定功能，可依 Hive AppId 選擇性生效。
已修復的問題
分析
- iOS 修復了在同意橫幅中只選擇一個選項時無法正確反映的問題。
v4.24.3.0
請確認此 SDK 版本的 開發環境。
新功能
行銷歸因
- Windows Appsflyer 1.0.1 ???+ warning 已發佈 Appsflyer(Steam 專用) 1.0.1。從 Hive SDK v4 24.0.0 及以上版本開始，行銷歸因功能僅支援 Appsflyer 1.0.1 及以上版本。
配置
- All 新增在條款畫面中確認是否已取得法定代理人同意的功能。
變更功能
認證
- 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 調整為即使拒絕 App Tracking Transparency(ATT) 同意，也可以進行 Facebook 登入。
- Windows 在成人認證後加入裝置管理服務時，如果超出一個手機號碼可加入的帳號數量，將顯示「已超出同一手機號碼可註冊的帳號數量」錯誤訊息。
推廣
- Android iOS 調整透過
additionalInfo 傳遞的值，使其不再包含不必要的資訊。 - All 調整為可 依 2:3 或 3:2 比例顯示全螢幕橫幅。
- Android iOS 將全螢幕橫幅中的「1 天內不再顯示」文案更改為「今天不再顯示」。
行銷歸因
外掛
- Android iOS 最小化 Hive External Dependency Manager 所管理的 XML 檔案數量。
函式庫更新
- Android Google Play Billing Library 6.1 → 7.0 Google Play Service Games 20.0.0 → 20.1.2
- iOS Facebook SDK 16.2.1 → 17.0.2
已修復的問題
- Android 透過修正資源參照邏輯，解決了無法 확보記憶體的問題。
- iOS 修復了在 iOS 14 裝置中確認 App Tracking Transparency(ATT) 同意狀態時偶發當機的問題。
- iOS 修復了在相簿中選擇存取限制(僅允許存取部分照片)時發生當機的問題。
通知
- Android 修復了在 本機推播通知 中設定不支援的
type 時，推播訊息無法正常顯示的問題。 - iOS 調整為傳輸應用程式版本資訊。
v4.24.2.1
說明: 此 SDK 版本不單獨提供發佈檔案，對應功能包含在更高版本 SDK 中。
新功能
社群
- Windows 調整為在遵循 Hive 規範的社群中，也可使用非 withhive.com、com2us.com 的 自訂網域位址。
v4.24.1.3
說明: 此 SDK 版本不單獨提供發佈檔案，對應功能包含在更高版本 SDK 中。
變更功能
認證
- Android iOS 調整為在裝置管理服務中根據裝置接入地區自動套用國際電話國碼。
v4.24.2.0
請確認此 SDK 版本的 開發環境。
新功能
- Android iOS 在適用 GDPR 的歐盟與歐洲經濟區地區，提供回傳 16 歲以下使用者是否同意條款的功能。可藉此確認使用者是否未滿 16 歲。
- Android 在 Android OS 11 及以上裝置，或安裝了支援模組的裝置中使用相簿時，預設使用 PhotoPicker。
- iOS 在 MacOS Console 應用程式中也可以查看 Hive SDK 偵錯日誌，並可選擇查看 Hive SDK 日誌中的特定日誌類型。
- All 提供在 Unity Editor 中控制 Hive SDK 偵錯日誌 顯示的功能。
認證
- All 當一個手機號碼可註冊的帳號數量超限時，如果請求傳送認證碼，將顯示「已超出使用同一手機號碼可建立的帳號數量。」錯誤訊息。
- Windows 支援 Steam IdP 隱式登入。請使用
AuthV4.Helper.signIn。
推廣
變更功能
認證
- Windows 調整為在 Google 登入時不再請求用於查看 Google Play Games 資訊的
games_lite 權限。
推廣
- iOS 在使用遊戲邀請(UA) 功能時，透過最小化剪貼簿貼上權限同意彈窗的顯示來改善使用性。
- 將顯示權限同意彈窗的時點，從受邀使用者啟動應用程式後立即顯示，變更為應用程式啟動後初始化 Hive SDK 時顯示。
- 調整為僅在剪貼簿中存在邀請者 URL 資料時才顯示彈窗。
通知
- Android 適配執行於 Amazon 新款 Fire 裝置上的執行階段函式庫(Push Amazon Device Message 1.2.0)。
函式庫更新
- Android Samsung GalaxyStore IAP 6.1 → 6.1.1 Amazon Device Message 1.0.1 → 1.2.0
分析
- iOS 將應用程式當機時把未傳送日誌儲存到檔案的選項
saveAnalyticsLogBeforeCrash 的預設值更改為 false。
已修復的問題
認證
- 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 Plugin 參數的問題。
推廣
- iOS 修復了在公告檢視中顯示新的 Frame View 時發生卡頓的問題。
- Windows 修復了 Promotion Custom Direct Fullscreen 跳轉到 Frame 時發生當機的問題。
行銷歸因
- Android 修復了使用自訂條款執行初始化時，Adjust 事件傳送延遲的問題。
配置
- Windows 修復了在重新查看條款時，不再使用過去儲存的資料，而是使用 Hive 伺服器新下發的條款 URL 資料的問題。
v4.24.1.2
請確認此 SDK 版本的 開發環境。
已修復的問題
認證
- Android 修復了在 Google 登入過程中按下返回按鈕取消登入時，沒有適當回應回呼的問題。該問題僅在 Hive 控制台中 Google Legacy Support 值為 true 時發生。
- Android 修復了低解析度裝置中無法進行鍵盤輸入的問題。
v4.24.1.0
請確認此 SDK 版本的 開發環境。
變更功能
- Windows 支援在 Hive SDK 實作的 UI 上透過遊戲控制器移動滑鼠。
函式庫更新
- 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
分析
- iOS 調整為根據裝置是否同意追蹤來決定是否顯示同意橫幅。
已修復的問題
計費
- iOS 修復了從 Hive SDK v4 24.0.0 以下版本(例如 v4 23.4.0) 升級到 v4 24.0.0 時，無法查詢商品的問題。
v4.24.0.0
請確認此 SDK 版本的 開發環境。
新功能
- Windows 新增了當遊戲服務終止後嘗試初始化 Hive SDK 時，會回傳 錯誤碼 的功能。
認證
計費
- iOS 當存在首次訂閱折扣資訊時，會在查詢商品資訊時一併回傳。使用
getProductInfo 時，可在回呼接收的 IAPV4Product 物件清單中，透過 original_price 欄位值與 price 欄位值的差異確認折扣資訊。
推廣
變更功能
- iOS 在區分應用程式版本時，追加使用
CFBundleShortVersionString。 - Windows 調整為 HIVE SDK 的 UI 及 WebView 不再按顯示器解析度，而是按 DPI 設定輸出。
認證
- Windows 調整為在 Google 登入時，可使用 Windows 預設 Web 瀏覽器的「隱身模式」進行登入。對應瀏覽器如下。
- Google Chrome
- Microsoft Edge
- Mozilla Firefox
- Naver whale
- Windows 如果使用上述瀏覽器之外的其他 Web 瀏覽器登入，則使用「一般模式」進行登入。
計費
- Android iOS 將退款使用者重新支付 UI 中顯示的 PG 支付類型文案從 "HiveStore" 更改為 "PG 支付"。
- Android 調整為 PG 支付頁面使用應用程式內 WebView 而不是應用程式內瀏覽器顯示。即使裝置不支援應用程式內瀏覽器環境，也能支援 PG 支付。
函式庫更新
- Android GooglePlay Services-Games 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 WeChat 2.0.2 → 2.0.4
- Hercules 2024.01.23 → 2024.04.11
- Singular 12.3.2 → 12.4.1
- Windows Steamworks 1.55 → 1.59
分析
- Android 將 Firebase 事件蒐集中廣告識別碼蒐集設定的預設值更改為
true。
已修復的問題
認證
- Windows 修復了在中國實名認證中，認證時間結束後仍可輸入認證碼的問題。
- Windows 修復了特定網頁(如 Apple 登入等) 語言只顯示英文的問題。
- Windows 修復了在巢狀回呼函式內部呼叫
IAPv4 getSubscriptionProductInfo 時，SDK 無法傳遞 callback 的問題。 - Windows 修復了在 Google 登入時，如果未從 Google 收到頭像，則登入失敗的問題。(現已修復為即使未收到頭像也可登入。)
計費
- Windows 修復了在退款使用者重新支付 UI 中，PG 支付顯示為 Hive Store 的問題。
- Windows 修復了在退款使用者重新支付 UI 的阿拉伯語介面中，未使用符合阿拉伯語特性的 UI 的問題。
推廣
- Windows 修復了
getBannerInfo、getBannerInfoString 函式無法運作的錯誤。 - Windows 修復了 Promotion API 可獨立於 AuthV4 認證而運作的邏輯。
其他
- Windows 修復了在特定尺寸視窗中執行點擊等輸入事件時 UI 會閃爍的問題。
已知問題
認證
- iOS 在使用 Facebook SDK iOS 17.0.0 時，如果 iOS 17.0 及以上裝置中的使用者未同意「應用程式追蹤透明性(App Tracking Transparency)」，則無法登入。如果要在該條件下實作 Facebook 登入，請使用 Hive SDK v4 24.1.0。