跳轉至

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 檔案。
    1. 下載並解壓縮 包含修正後 HTML 檔案資料夾的壓縮檔
    2. 將整個資料夾複製到 Plugins/HIVESDK/Source/HiveSDKWindows/assets/additional 目錄下並覆蓋原有檔案。
    3. 重新建置應用程式。
  • 在 Hive SDK v4 Unity 25.4.0 及以上版本中使用 SDK Manager 時,請升級至 SDK Manager v2.0.0 及以上版本

v4.26.2.0

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Interface 2026-03-25
SDK Unity Android 2026-03-25
SDK Unity iOS 2026-03-25
SDK Unity Windows 2026-04-01

請確認此 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 內容的影片廣告功能
    • 變更原因: 由於播放功能異常導致穩定性下降,且缺少實際使用案例,因此使用率較低

外掛

函式庫更新

  • 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity iOS 2026-03-20

已修復的問題

  • iOS 修復了在 iOS 26.4 環境中,使用 WebView 的彈窗(登入、橫幅、客服中心、社群等)無法正常運作的錯誤。

v4.26.0.2

按目標 OS 劃分的 SDK 發佈日期
SDK Unity iOS 2026-03-20

已修復的問題

  • iOS 修復了在 iOS 26.4 環境中,使用 WebView 的彈窗(登入、橫幅、客服中心、社群等)無法正常運作的錯誤。

v4.25.9.1

按目標 OS 劃分的 SDK 發佈日期
SDK Unity iOS 2026-03-20

已修復的問題

  • iOS 修復了在 iOS 26.4 環境中,使用 WebView 的彈窗(登入、橫幅、客服中心、社群等)無法正常運作的錯誤。

v4.25.8.3

按目標 OS 劃分的 SDK 發佈日期
SDK Unity iOS 2026-03-20

已修復的問題

  • iOS 修復了在 iOS 26.4 環境中,使用 WebView 的彈窗(登入、橫幅、客服中心、社群等)無法正常運作的錯誤。

v4.26.1.4

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2026-03-05

變更功能

認證

  • 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2026-02-06
SDK Unity iOS 2026-02-06

已修復的問題

認證

  • iOS 修復了在 iPad 裝置中,當點擊需要輸入出生日期資訊的年齡限制(AgeGate) 彈窗或與日曆相關彈窗的空白區域時,應用程式發生卡死(無回應) 的問題。
  • iOS 修復了裝置管理服務在 iOS 裝置上執行時,部分彈窗中顯示不必要捲軸的問題。

計費

  • iOS 修復了呼叫 getAccountUUID 方法時回傳值發生變化的問題。

推廣

  • Android 修復了在遊戲應用程式以背景模式執行時顯示推廣彈窗,如果發生使用者參與(User Engagement, UE) 直達連結事件,推廣彈窗會消失的問題。

行銷歸因

  • iOS 修復了在解析度寬度低於 1170px 的 iOS 裝置中,Digital Markets Act(DMA) 同意橫幅的部分文字無法顯示的問題。

v4.26.1.2

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Interface 2026-01-23
SDK Unity Android 2026-01-23
SDK Unity iOS 2026-01-23

變更功能

認證

  • Android iOS iOS 在中國地區進行 Hive 會員登入時,如果已完成手機號碼認證,則在中國實名認證階段不再執行手機號碼認證,而是直接進入身分證認證。
  • 現有 Hive 會員登入中執行的是會員 ID(電子郵件地址) 認證而非手機號碼認證,因此在後續中國實名認證階段仍需進行手機號碼認證。

已修復的問題

  • iOS 修復了執行 Apple Submission 時,錯誤生成的 bundle 檔案 Info.plist 被包含在內,導致發行版本驗證失敗的問題。
  • iOS 修復了在退款使用者重新支付 UI 中,PG 支付顯示為 Hive Store 的問題。

v4.26.1.1

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Interface 2026-01-15
SDK Unity iOS -

說明: 此 SDK 版本不單獨提供發佈檔案,對應功能包含在更高版本 SDK 中。

已修復的問題

外掛

  • iOS 修復了在 iOS 目標環境中設定外部函式庫依賴之後,Hive SDK 版本資訊無法被準確反映的問題。

v4.26.1.0

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Interface 2026-01-13
SDK Unity Android 2026-01-13
SDK Unity iOS 2026-01-13
SDK Unity Windows 2026-01-13

請確認此 SDK 版本的 開發環境

新功能

認證

  • All 提供 AuthV4.checkAgeGate 方法。在顯示輸入出生日期的彈窗後,當使用者輸入出生日期時,會透過回呼回傳該值。
  • All 新增 AuthV4.setAutoLoginEnabled 方法,用於將下一次而非目前登入工作階段註冊為自動登入工作階段(ON/OFF)。設定為 ON 後,透過登入方法完成登入時,該登入工作階段會儲存為自動登入工作階段。之後登入時,執行 AuthV4.Helper.signIn,或以 ProviderType.AUTO 執行 AuthV4.signIn,即可使用自動登入。
  • Android 支援 使用 Xiaomi 登入

計費

推廣

  • All 支援 Deferred Deep Link。即使使用者在未安裝應用程式的狀態下點擊直達連結,也可在安裝完成後跳轉到連結中指定的應用程式內頁面。

行銷歸因

遠端遊玩

  • Windows 從遠端遊玩外掛 1.01.02 及以上版本開始,在遠端遊玩過程中點擊外部連結時,可以在遠端裝置上開啟頁面。因此,即使在遠端遊玩過程中也可以進行 PG 支付。

附加功能

  • Android透過遊戲內 WebView 開啟 場景中,當透過 PlatformHelper 類別的 showInWebView 方法顯示 WebView 時,提供使用 Game Activity 而非 Hive Activity 進行顯示的選項。

其他

  • AllConfiguration 類別中新增 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 鍵傳輸營收值。
    • 現有是將營收值傳輸到 revenue 鍵。

附加功能

  • 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2025-12-18
SDK Unity iOS 2025-12-18

變更功能

  • iOS Hive SDK 開發環境使用的 Xcode 版本變更如下。
    • 變更前: Xcode 26.2 Beta2
    • 變更後: Xcode 26.2

配置

  • Android 為應對應用程式商店責任法,Hive SDK 支援的 Google Play Age Signals API 版本變更如下。
    • 變更前: 0.0.1-Beta2
    • 變更後: 0.0.2

v4.26.0.0

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Interface 2025-12-08
SDK Unity Android 2025-12-08
SDK Unity iOS 2025-12-08

請確認此 SDK 版本的 開發環境

新功能

  • iOS 現在可以在 iOS Xcode 26.2 及以上版本中建置 Hive SDK。
    • 最低支援 OS 版本為 iOS 15

配置

  • 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 及以上版本。

已知問題

配置

  • Android 為應對應用程式商店責任法,Hive SDK 26.0.0 Beta 中支援的 Google Play Age Signals API 0.0.1-beta02 版本 無法在接收實際年齡訊號的使用者環境中使用。
    如需接收實際年齡訊號,請升級至支援 Google Play Age Signals API 0.0.2 版本(非 Beta 版)的 Hive SDK v4.26.0.1

v4.25.8.2

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Windows 2025-11-25

請確認此 SDK 版本的 開發環境

已修復的問題

支付

  • Windows 修復了在 Google Play Games PC 支付中,當註冊商品超過 20 個時無法取得全部商品資訊的問題。

v4.25.8.1

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Windows -

說明: 此 SDK 版本不單獨提供發佈檔案,對應功能包含在更高版本 SDK 中。

已修復的問題

其他

  • Windows 修復了變更遊戲語言後,關閉提示 UI 仍以初始設定語言顯示的問題。

聊天

  • Windows 修復了韓文訊息不會觸發回呼的問題。

v4.25.9.0

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Interface 2025-11-07
SDK Unity Android 2025-11-07
SDK Unity iOS 2025-11-07
SDK Unity Windows 2025-10-31

請確認此 SDK 版本的 開發環境

新功能

認證

  • All 提供 本人確認服務
    • SteamDeck 不提供本人確認服務(本人確認、成人認證、監護人同意)。請先在行動裝置或 PC 上使用本人確認服務後,再於 SteamDeck 上重新接入遊戲。

已修復的問題

其他

  • Windows 修復了變更遊戲語言後,關閉提示 UI 仍以初始設定語言顯示的問題。

v4.25.7.1

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Windows -

說明: 此 SDK 版本不單獨提供發佈檔案,對應功能包含在更高版本 SDK 中。

已修復的問題

其他

  • Windows 透過套用 DX12 渲染器 GPU 同步增強了渲染穩定性。
  • Windows 修復了推廣公告中關閉按鈕偶爾無法正常運作的已知問題。

v4.25.8.0

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Interface 2025-10-02
SDK Unity Android 2025-10-02
SDK Unity iOS 2025-10-02
SDK Unity Windows 2025-10-02

請確認此 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 建置。

遊戲資料儲存

聊天

  • Windows 新增 聊天 功能。

變更功能

  • 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.CancelQuitApplication.wantsToQuit 取消遠端遊玩連線結束,連線仍會被關閉的問題。現在僅在應用程式真正結束時才會結束連線。

其他

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

分析

  • Android 修復了在用戶端並發傳輸失敗時,不會夾帶不必要資訊進行重新傳送的問題。

v4.25.7.0

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android -
SDK Unity iOS -
SDK Unity Windows -

說明: 此 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android -
SDK Unity iOS -

說明: 此 SDK 版本不單獨提供發佈檔案,對應功能包含在更高版本 SDK 中。

新功能

聊天

  • Android iOS 新增可對特定聊天訊息表達或顯示「按讚」的功能。
  • Android iOS 提供可對特定聊天訊息撰寫「回覆」以及顯示回覆關聯關係的資訊。
  • Android iOS 提供提及特定使用者或傳遞提及使用者資訊的功能。

變更功能

聊天


v4.25.5.2

按目標 OS 劃分的 SDK 發佈日期
SDK Unity iOS 2025-07-30

請確認此 SDK 版本的 開發環境

已修復的問題

認證

  • iOS 修復了在橫向模式下顯示聊天機器人時會發生當機的錯誤。

v4.25.5.1

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Interface 2025-07-23
SDK Unity Android 2025-07-23
SDK Unity iOS -
SDK Unity Windows -

說明: 此 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Windows 2025-07-14

請確認此 SDK 版本的 開發環境

新功能

認證

分析

  • WindowsAirbridge 日誌 中新增 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Windows 2025-06-26

請確認此 SDK 版本的 開發環境

新功能

認證

  • Windows 新增 多帳號切換 功能。相關詳細功能如下。
    • 將目前登入帳號儲存到裝置
    • 查詢已儲存帳號
    • 登出並刪除已儲存帳號
    • 使用其他已儲存帳號快速登入
  • Windows 當已被停止遊戲使用的使用者嘗試登入時,調整為僅在應用程式內登出而不關閉應用程式。
  • Windows 可在 遠端遊玩外掛 中使用增強認證協定。

其他

已修復的問題

其他

  • Windows 解決了 Hive 功能行為的漏斗日誌未統計問題。

v4.25.3.0

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Windows -

說明: 此 SDK 版本不單獨提供發佈檔案,對應功能包含在更高版本 SDK 中。

新功能

推廣

其他

  • 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2025-06-23

請確認此 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2025-05-14

請確認此 SDK 版本的 開發環境

已修復的問題

行銷歸因

  • Android 修復了用於 MMP 服務聯動 的 Hive SDK 識別碼中 did 值缺失的問題。

v4.25.2.0

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2025-04-29
SDK Unity iOS 2025-04-29
SDK Unity Windows 2025-05-12

請確認此 SDK 版本的 開發環境

新功能

  • Android iOS 支援 Unity 6.1 (6000.1)。

認證

  • Windows 新增支援將 LINE 作為認證方式(IdP)。

配對

配置

變更功能

認證

  • Android iOS 調整並提供 VK 認證方式。變更後的認證方式可在 新版 VK Developer Console 中使用。
  • iOS 更新 Apple GameCenter 登入時使用的已廢棄 GameKit API 驗證協定。
  • Android 隨著 Google Sign-In 函式庫停止支援,調整為在隱式登入和顯式登入時使用 Google Credential Manager 與 AuthorizationClient API 進行認證。

計費

  • 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.transactionFinish
    • IAPV4.transactionMultiFinish
    • IAPV4.restore

行銷歸因

  • Android 修復了在使用 Adjust 判斷安裝狀態的功能時,會顯示空白推播通知的問題。
  • Android 修復了在使用 Airbridge 時,如果發生購買多個商品的事件,會依據單價和數量傳遞營收資訊的問題。

配置

  • Android iOS 修復了在 SDK 初始化之前執行廣告模組(Adiz) 初始化時,即使需要遵守 COPPA 或 GDPR 等合規要求,用於年齡確認的 AgeGate 值仍依 hive_config.xml 中設定的值運作的問題。

聊天

  • Android 修復了聊天連線偶發失敗的問題。

已知問題

行銷歸因


v4.25.1.3

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2025-04-10
SDK Unity iOS 2025-04-10

請確認此 SDK 版本的 開發環境

變更功能

計費

  • Android 將 PG 支付的行為方式更改為與其他計費(IAPv4) 功能中的市場一致。如果正在套用 PG 支付,則必須參考 PG 支付 文件修改程式碼實作。

行銷歸因

已修復的問題

計費

  • iOS 修復了顯示詢問是否同意傳輸消費資訊的彈窗 UI 時,背景畫面不透明的問題。
  • iOS 修復了關閉詢問是否同意傳輸消費資訊的彈窗 UI 時,應用程式畫面方向會朝非預期方向旋轉的問題。

推廣

  • iOS 修復了顯示包含圖片的評論彈窗時,如果發生旋轉事件,正在顯示的圖片會消失的問題。

行銷歸因

  • iOS 修復了透過 Adiz 傳輸廣告收益資訊時,Airbridge 會將其識別為 AdMob 而非 Adiz 的問題。

v4.25.1.0

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Windows 2025-04-03

請確認此 SDK 版本的 開發環境

新功能

認證

其他

變更功能

計費

  • Windows 將 PG 支付的行為方式更改為與其他計費(IAPv4) 功能中的市場一致。如果正在套用 PG 支付,則必須參考 PG 支付 文件修改程式碼實作。

推廣

  • Windows 調整透過 additionalInfo 傳遞的值,使其不再包含不必要的資訊。

開發環境

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

已修復的問題

認證

  • Windows 修復了當使用者選擇 Hive 會員以外的登入方式後取消登入時,Hive SDK 控制器的滑鼠操作功能仍會生效的問題。

v4.25.0.1

按目標 OS 劃分的 SDK 發佈日期
SDK Unity iOS 2025-03-10
SDK Unity Windows 2025-03-11

請確認此 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2025-01-24
SDK Unity iOS 2025-01-24
SDK Unity Windows 2025-02-20

請確認此 SDK 版本的 開發環境

新功能

認證

計費

推廣

配對

  • Android iOS 更新配對功能,新增支援 群組配對 功能。 ※ 與舊版本 Hive SDK Interface 不相容。要使用更新後的配對功能,必須使用 Hive SDK v4 25.0.0 及以上版本。

行銷歸因

其他

  • Windows 在 ASUS ROG Ally 等搭載觸控螢幕的掌上型裝置中支援 觸控手勢
  • Windows 在使用遊戲控制器時,新增支援 控制器按鍵映射,並可聚焦與操作部分 Hive UI 元素。
  • Windows 新增支援套用 自訂游標,以取代一般滑鼠游標。
  • Windows 新增可啟用或停用遊戲控制器操作的設定。

聊天

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

變更功能

認證

  • Android iOS 刪除不再使用的 Auth 模組類別、介面、方法、代理與監聽器。
  • All 使用 JWT token 套用更強的安全協定。
  • Android iOS 隨著 TalkPlus 支援終止,刪除 TalkPlus 認證 token 方法。
  • Android 允許在 Apple 登入 WebView 中,除登入功能外還可進行找回密碼等瀏覽操作。

推廣

  • Windows 在公告選單分頁中新增新內容提醒顯示。

行銷歸因

  • Android iOS 更新以支援 Adjust v5。
    • 移除 Adjust Signature 函式庫。
  • Android iOS 調整為在透過 Adjust 統計 Adiz 廣告營收時,將廣告營收來源作為 AdMob 來源傳輸。
  • Android 反映 Appsflyer 廣告營收統計函式庫已整合到主函式庫中的變更。
    • 6.14.2 → 6.15.2
    • 移除 Appsflyer ad-revenue 函式庫。

Unity

  • All 改進 Hive Config Setting UI。

Hercules

  • All 2024.11.20

已修復的問題

認證

  • 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2024-11-08
SDK Unity iOS 2024-11-08
SDK Unity Windows 2024-12-10

請確認此 SDK 版本的 開發環境

新功能

  • Android iOS 支援 Unity 6(Unity 6000)。
  • Windows 新增用於相容 Hive SDK v4 Unity Android & iOS 24.5.0 Interface 的更新。

認證

推廣

  • Android iOSSpot Banner 中也可顯示廣告。
  • Android 在使用者邀請分享功能中支援 X(原 Twitter)。

配對

變更功能

認證

  • Android iOS 調整衝突彈窗中顯示的 Provider 名稱。

外掛

  • Android iOS 套用提供的 EDM4U 最新版本。
    • 1.2.178 → 1.2.183
  • 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Windows -

說明: 此 SDK 版本不單獨提供發佈檔案,對應功能包含在更高版本 SDK 中。

變更功能

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

v4.24.4.1

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Windows 2024-12-03

請確認此 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2024-10-14
SDK Unity iOS 2024-10-14
SDK Unity Windows 2024-11-15

請確認此 SDK 版本的 開發環境

新功能

計費

  • Android Windows 在請求 PG 支付時,支援使用 IAPv4.purchase 進行 多數量購買

行銷歸因

遠端執行

變更功能

外掛

  • Android iOS 調整為 Android 的 Package Name 或 iOS 的 Bundle Name 自動設定功能,可依 Hive AppId 選擇性生效。

已修復的問題

分析

  • iOS 修復了在同意橫幅中只選擇一個選項時無法正確反映的問題。

v4.24.3.0

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2024-09-03
SDK Unity iOS 2024-09-03
SDK Unity Windows 2024-10-14

請確認此 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Windows -

說明: 此 SDK 版本不單獨提供發佈檔案,對應功能包含在更高版本 SDK 中。

新功能

社群

  • Windows 調整為在遵循 Hive 規範的社群中,也可使用非 withhive.com、com2us.com自訂網域位址

v4.24.1.3

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android -
SDK Unity iOS -

說明: 此 SDK 版本不單獨提供發佈檔案,對應功能包含在更高版本 SDK 中。

變更功能

認證

  • Android iOS 調整為在裝置管理服務中根據裝置接入地區自動套用國際電話國碼。

v4.24.2.0

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2024-07-05
SDK Unity iOS 2024-07-05
SDK Unity Windows 2024-06-26

請確認此 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) 功能時,透過最小化剪貼簿貼上權限同意彈窗的顯示來改善使用性。
    1. 將顯示權限同意彈窗的時點,從受邀使用者啟動應用程式後立即顯示,變更為應用程式啟動後初始化 Hive SDK 時顯示。
    2. 調整為僅在剪貼簿中存在邀請者 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.switchAccountAuthV4.Helper.resolveConflict 時,Hive SDK 無法傳遞回呼的問題。
  • Windows 修復了在 AuthV4.Helper.switchAccountAuthV4.Helper.resolveConflict 中,無法傳遞 PlayerInfo Unity Plugin 參數的問題。

推廣

  • iOS 修復了在公告檢視中顯示新的 Frame View 時發生卡頓的問題。
  • Windows 修復了 Promotion Custom Direct Fullscreen 跳轉到 Frame 時發生當機的問題。

行銷歸因

  • Android 修復了使用自訂條款執行初始化時,Adjust 事件傳送延遲的問題。

配置

  • Windows 修復了在重新查看條款時,不再使用過去儲存的資料,而是使用 Hive 伺服器新下發的條款 URL 資料的問題。

v4.24.1.2

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2024-06-27

請確認此 SDK 版本的 開發環境

已修復的問題

認證

  • Android 修復了在 Google 登入過程中按下返回按鈕取消登入時,沒有適當回應回呼的問題。該問題僅在 Hive 控制台中 Google Legacy Support 值為 true 時發生。
  • Android 修復了低解析度裝置中無法進行鍵盤輸入的問題。

v4.24.1.0

按目標 OS 劃分的 SDK 發佈日期
SDK Unity iOS 2024-05-14
SDK Unity Windows 2024-05-30

請確認此 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

按目標 OS 劃分的 SDK 發佈日期
SDK Unity Android 2024-04-30
SDK Unity iOS 2024-04-30
SDK Unity Windows 2024-05-22

請確認此 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 修復了 getBannerInfogetBannerInfoString 函式無法運作的錯誤。
  • 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。