SDK Native 版本說明
本指南按版本介紹 Hive SDK Native 的主要更新。
Hive SDK Native 各目標作業系統的更新用以下作業系統標籤區分。
- Android SDK Native Android 更新
- iOS SDK Native iOS 更新
- Windows SDK Native Windows 更新
- All SDK Native Android、iOS 和 Windows 更新
必要項目
在使用 Hive SDK 各發佈版本之前，我們將指導您進行與版本特定限制相關的必要設定。
- 安全金鑰設定 適用於 Hive SDK v4 Native 25.0.0 及更高版本
- 由於身分驗證安全協定的變更，在使用 Hive SDK v4 Native 25.0.0 及更高版本時，您必須在Hive 控制台 > 安全金鑰設定中[頒發安全金鑰設定中[頒發安全金鑰](../../operation.center/mdettm）。沒有安全金鑰，您將無法登入應用程式。
- Hive SDK v4 Native 25.1.3 及更高版本需要對 PG 支付實作進行更改
- 若要在 Android 25.1.3 及更高版本上實現 PG 支付，您必須參考 [PG 支付流程]PG 支付流程 修改 PG 支付實現代碼。
v4.26.1.3
修復的錯誤
Authentication
- iOS 修正了在 iPad 上點擊 AgeGate 彈出視窗或日曆相關彈出視窗中需要輸入出生日期資訊的空白區域會導致應用程式凍結（無回應）的問題。
- iOS 修正了在 iOS 裝置上執行裝置管理服務時，某些彈出視窗會顯示不必要的捲軸的問題。
Billing
- iOS 修正了在呼叫 getAccountUUID 方法時傳回的值會改變的錯誤。
- Android 修正了當遊戲應用程式在背景運行時，如果發生用戶互動 (UE) 直接連結事件，促銷彈窗就會消失的問題。
Marketing Attribution
- iOS 修正了在解析度寬度小於 1170px 的 iOS 裝置上，《數位市場法案》(DMA) 同意橫幅中的某些文字無法顯示的問題。
v4.26.1.2
變更功能
Authentication
- All 如果您之前在中國登入 Hive Membership 時已驗證過手機號碼，那麼在中國進行的實名驗證步驟將直接進行身份驗證，而無需驗證手機號碼。
- 由於現有的 Hive Membership 登入流程僅驗證您的會員 ID（電子郵件地址），而不驗證您的手機號碼，因此您需要在後續的中國實名驗證步驟中驗證您的手機號碼。
修復的錯誤
- iOS 修正了在執行 Apple 提交時包含了錯誤產生的捆綁檔案 Info.plist 而導致分發版本驗證失敗的錯誤。
- iOS 修正了退款用戶付款介面中 PG 付款被顯示為 Hive Store 的錯誤。
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
- All 我們支援延遲深度鏈接，即使用戶尚未安裝該應用，點擊直接鏈接後，該用戶仍可被重定向到鏈接中指定的應用內頁面。
Add-ons
- Android 當使用 PlatformHelper 類別的 showInWebView 方法在 作為遊戲內 webview 開啟 中公開 webview 時，我們提供了使用 Game Activity 而不是 Hive Activity 來公開它的選項。
Others
- All 您可以使用
Configuration 類別中的 getGameLanguage 方法檢查 SDK 中設定的語言設定。 - iOS 隨著 CocoaPod 服務的結束，我們現在透過 SPM（Swift Package Manager）提供分發服務。
變更功能
Authentication
- All 成人身份驗證方法不僅支援網頁版，也支援應用程式版。
- All 移除登入SNS時自動收集個人資料圖片和暱稱。
- All
AuthV4.setAutoLoginEnabled(預設值：PC 關閉 / 行動裝置開啟) 根據新增內容，自動登入行為策略已變更如下： - 原有：帳戶衝突後切換到其他帳戶時，新帳戶在行動裝置上保持自動登錄，但在 PC 上停用自動登入。
- 變更：帳戶衝突後切換到其他帳戶時，如果已透過
AuthV4.setAutoLoginEnabled 註冊了自動登入工作階段，則新帳戶在行動裝置和 PC 上均保持自動登入。否則，將停用自動登入（存在例外情況）。
Billing
- Android 將用於 Google Play 結算的庫變更為 Google Play 結算庫 8.0。
- All 修正了透過自訂視圖/直接視圖導航到外部瀏覽器時 webview 會閃爍的問題。
Push
- iOS 在收集推播通知的令牌時，根據建置環境變更以收集其他令牌資訊。
Marketing Attribution
- All 我們更新了彈出視窗的設計，並改進了DMA 同意橫幅的行為。
- 現有同意橫幅已獲得的任何同意歷史記錄都將保留，重新顯示時，將顯示一個文字和使用者介面都已改進的新同意橫幅。
- 如果您先前為現有同意橫幅使用了自訂文本，則必須根據更改的資料結構重新配置文本，請參閱設定自訂同意橫幅使用者介面。
- All 更改以防止將相同收據的重複銷售日誌發送到 MMP。
- All 新增了在傳送 Firebase 購買事件時，將銷售額傳送到 value 鍵的功能。
- 之前，銷售額會傳送到 revenue 鍵。
Add-ons
- All 改進了 PlatformHelper 類別的 showInAppView 方法在 開啟遊戲內 webview 中顯示的關閉 webview 按鈕的可見性。
Provisioning
- All 我們提供了一個單獨的年齡範圍 API，供用戶選擇是否使用，以遵守《應用商店責任法案》。
- 《應用商店責任法案》將於2026年1月1日在美國德州生效，目前尚未實施，可根據開發情況選擇性地應用。
- 《應用商店責任法案》將於2026年5月在美國猶他州生效，並於2026年7月在美國路易斯安那州生效，也可選擇性地應用。
Library updates
- 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 修正了在裝置管理中註冊裝置數量超過限制後刪除已註冊裝置時，成人身分驗證彈出視窗會再次出現的錯誤。
- iOS 修正了當新聞項目數量超過一定數量時，新聞選單無法正常運作的問題。
- iOS 修正了當正面橫幅上顯示的圖像寬度或高度為“0”或從伺服器發送錯誤訊息時，阻止正常運行的錯誤。
- iOS 修復了在公開帶有直接連結的社群時，如果沒有 URL 參數，直接連結將無法正常運作的問題。
Push
- Android 修正了即使受 COPPA 約束，推播通知令牌仍被收集的錯誤。
- iOS 修正了 ForegroundPush 設定無法變更為 False 的問題。
Marketing Attribution
- iOS 修復了 Firebase 中缺少安裝或更新事件的錯誤。
Add-ons
- iOS 修正了當遊戲應用程式使用者的網路狀態離線或當應用程式開啟遊戲內瀏覽器中的 PlatformHelper 類別的 showInAppBrowser 方法時，遊戲應用程式會閃爍並關閉視窗的問題。
v4.26.0.1
變更功能
- iOS 用於 Hive SDK 開發環境的 Xcode 版本已變更如下：
- 先前版本：Xcode 26.2 Beta2
- 更改版本：Xcode 26.2
Provisioning
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
v4.25.9.0
注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。
新功能
Authentication
- All 我們提供身分驗證服務。
- SteamDeck 不提供身分驗證服務（身分驗證、成人驗證、家長同意）。您必須在手機或電腦上使用身分驗證服務，然後透過 SteamDeck 重新存取遊戲。
v4.25.8.0
檢查此 SDK 版本的開發環境。
新功能
- Android 支援 Android OS 16（API 等級 36）。
- Android 為 Android OS 15（API 等級 35）或更高版本建置時，支援 16KB 頁面大小的建置。
變更功能
- Android 移除已棄用的
android.permission.FOREGROUND_SERVICE 權限。 - Android Android 最低建置目標從
19 改為 23。
Authentication
- iOS 移除在 Xcode 26 中建置時不可用的庫引用。
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
修復的錯誤
Authentication
- iOS 修正了聊天機器人彈出視窗偶爾會以橫屏模式而不是豎屏模式顯示的問題。
- iOS 修復了空數組引用錯誤。
- 使用 Authv4 類別的
showConflict 方法時，如果缺少必要的輸入數據，則會發生當機。
Analytics
- Android 當客戶端連線傳輸失敗時，會對其進行修改，以避免重傳不必要的資訊。
v4.25.7.0
注意：此 SDK 版本未提供單獨的發佈檔案，該功能包含在 SDK 的更新版本中。
新功能
Authentication
- All 成人驗證完成後，即可識別已通過成人驗證的使用者。 取得識別值的方法中提供了相關資訊。識別資訊是經過哈希處理的DI值。
變更功能
Authentication
- All Hive 如果您在控制台中設定了使用成人驗證的應用程式，登入後將自動執行成人驗證程序。
- 此功能僅在韓國可用。
- All 用於執行成人驗證的
showAdultConfirm 方法已被棄用。 showAdultConfirm 方法可能會在未來的更新中移除。
v4.25.6.0
新功能
Chat
- All 增加了「讚」或標記特定聊天訊息的功能。
- All 提供訊息，使您可以對特定的聊天訊息進行「回應」或指示回覆關係。
- All 可以提及特定使用者或提供被提及使用者的資訊。
變更功能
Chat
v4.25.5.2
修復的錯誤
Authentication
- iOS 修正了在橫螢幕模式下顯示聊天機器人時會導致崩潰的問題。
v4.25.5.1
新功能
Authentication
- All 我們新增了一項名為「多帳號切換」的功能。功能詳情如下：
- 將目前登入帳號儲存到設備
- 查看已儲存的帳號
- 登出並刪除已儲存的帳號
- 使用其他已儲存的帳號快速登入
Notification
- All 我們新增了一個推送操作按鈕。
- 收到推播通知時，您可以使用推播選擇動作按鈕執行預先定義的操作。
Chat
- All 訊息發送
- 新增自動將聊天訊息翻譯成使用者語言的功能，以及翻譯特定訊息的功能。
- 新增僅接收特定語言使用者的通知訊息的功能。
- 為 WebSocket 訊息新增了訊息 ID 值，以確保回呼順序。
- All 頻道
- 新增進入聊天頻道時查看歷史對話記錄的功能。
- 顯示頻道內目前人數。
- 提供頻道清單排序功能。
- All 事件管理
- 新增了以二進位形式發送自訂資料事件的功能到聊天中。
- All 連線管理
- 新增了重新連接功能。
Hercules
- Android 20241125-2 -> 20250527
- iOS 20241120 -> 20250218
變更功能
- Android 更新建置所需的混淆規則。
- iOS 先前單獨提供的
HiveAppTrackingTransparents.framework 庫現在已整合到 Service.framework 中。
Authentication
- All 修改了
showMyInquiry 方法，使其在未使用 Hive 會員帳戶時顯示查詢頁面，先前該方法無法正常運作。 - Android 將 VK 驗證彈出視窗從 WebView 變更為應用程式內瀏覽器。
Marketing Attribution
- iOS 啟用此功能後，將支援自動收集 Firebase 購買事件。
修復的錯誤
- iOS 修正了 iPad 裝置上「最新動態」使用者介面的邊角曲率問題。
Provisioning
- iOS 修改網頁視圖，使其在顯示條款和條件時不捲動。
Analytics
- iOS 修改邏輯，以便在條款協議完成後立即發送分析日誌。
已知問題
Others
- iOS 在橫屏模式下使用聊天機器人時，出現錯誤導致其崩潰。
- 請更新至 Hive SDK Unity iOS 25.5.2 或以上版本。
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
變更功能
Authentication
- All 我們更新了 VK 的身份驗證方法。更新後的身份驗證方法可在新版 VK 開發者控制台中使用。
- iOS 更新了登入 Apple GameCenter 時所使用的已棄用的 GameKit API 的驗證協定。
- Android 由於 Google 登入庫已棄用，我們將改用 Google Credential Manager 和 AuthorizationClient API 進行身份驗證，以實現隱含和明確登入。
Billing
- Android 如果您要退還使用 PG 付款購買的商品，請新增
order_id 值，以便將其與先前的交易區分開來。 - Android 當 PG 支付交易完成後，會透過行銷歸因發送購買完成日誌。
- Android 分享用戶獲取策略時，請將其變更為新增至 Telegram 支援的曝光清單中。
- Android 在公開 webview 時更改快取策略。
Marketing Attribution
- All 發送額外的 Hive SDK 識別碼以支援 與 MMP 服務整合。
- 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
- All 發送或接收訊息資料時，額外發送和接收「extraData」。
- All 連接到聊天伺服器時，不再發送
extraData。 - All 此外，它接收的是整數時間值，而不是字串時間值。
- All 當在網路阻塞等通訊不可能的情況下，嘗試在未正確斷開 websocket 連線的情況下重新連線時，問題變成不會因重複連線而失敗。
修復的錯誤
- Android 在需要透過網路重試通訊或連接到分散式伺服器的情況下，如果在配置的最大逾時時間到期之前收到回應，則修改通訊重試或連接到分散式伺服器的操作，不再等待逾時，而是立即重試通訊或連接到分散式伺服器。
- iOS 修正了使用 Configuration 類別的
setZone 方法變更連接到 Hive SDK 的伺服器群組 Zone 時，hive_config.xml 檔案中的 gameLanguage 值初始化時出現的錯誤。
Authentication
- iOS 修正了在執行 iOS 18 或更高版本的裝置上 QQ 網頁版登入無法正常運作的問題。
Marketing Attribution
- Android 修正了在使用 Adjust 功能來確定是否已完成安裝時，推播通知沒有內容的問題。
- Android 當使用 Airbridge 購買多個商品時，銷售資訊會根據單價和數量進行修改並傳輸。
Provisioning
- All 在初始化 SDK 之前初始化廣告模組 (Adiz) 時，如果需要符合 COPPA 或 GDPR 等法規，則檢查年齡的
AgeGate 值固定為使用 hive_config.xml 中設定的值。
Chat
已知問題
Marketing Attribution
v4.25.1.3
檢查此 SDK 版本的開發環境。
變更功能
Billing
- Android 更改 PG 支付的工作方式，使其與計費 (
IAPv4) 功能中其他市場的行為保持一致。如果您正在使用 PG 支付，則應參考 PG 支付 文件來修改您的程式碼實作。
Marketing Attribution
修復的錯誤
Billing
- iOS 修正了在顯示詢問是否同意傳輸消費資訊的彈出式使用者介面時背景不透明的錯誤。
- iOS 在修正了關閉詢問是否同意傳輸消費資訊的彈出式使用者介面時，應用程式螢幕方向會朝非預期方向旋轉的問題。
- iOS 修正了在顯示包含影像的審核彈出視窗時，發生旋轉事件會導致正在顯示的影像消失的問題。
Marketing Attribution
- iOS 修正了 Airbridge 在透過 Adiz 發送廣告收入資訊時，會將廣告收入資訊傳送給 AdMob 而不是 Adiz 的錯誤。
v4.25.0.1
新功能
Marketing Attribution
- iOS 當使用 Hive SDK v4 25.0.0 或更高版本並套用 Adjust v5 時，修正了 SDK 自動收集和傳輸的 did 和 vid 值未傳輸的錯誤。
v4.25.0.0
新功能
Authentication
Billing
- iOS 支援詢問用戶是否同意將應用程式內產品消費資訊傳送至 Apple App Store 的功能。
Matchmaking
- All 匹配功能已更新，支援新的群組匹配功能。 ※ 此功能與 Hive SDK 介面的舊版本不相容。若要使用更新的配對功能，您必須使用 Hive SDK v4 25.0.0 或更高版本。
Marketing Attribution
Chat
變更功能
Authentication
- All 刪除未使用的
Auth 模組類別和介面、方法、委託和監聽器。 - All 使用 JWT 令牌實施更強大的安全協定。
- All 由於我們停止對 TalkPlus 的支持，我們將棄用 TalkPlus 身份驗證令牌方法。
- Android Apple 登入網頁視圖除了提供登入功能外，還允許瀏覽網頁，例如尋找密碼。
Marketing Attribution
- All 已更新以支援 Adjust v5。
- 移除 Adjust Signature 庫。
- All 使用 Adjust 聚合 Adiz 廣告收入時，將 Adiz 廣告收入聚合來源變更為 AdMob。
- Android 這反映了 Appsflyer 廣告收入聚合庫已整合到主庫中。
- 6.14.2 → 6.15.2
- 移除了 Appsflyer 廣告收入庫。
Hercules
修復的錯誤
Authentication
- Android 解決了在執行
signIn 方法期間出現網路回應延遲時 UI 執行緒間歇性被佔用的問題。
Billing
已知問題
Marketing Attribution
- iOS 如果您正在使用 Adjust 功能，則會出現一個錯誤，即 SDK 自動收集和傳輸的 did 和 vid 值未傳送。您需要將 Hive SDK 更新至 v4 25.0.1 或更高版本。
v4.24.5.0
檢查此 SDK 版本的開發環境。
新功能
- All 支持 Unity 6 (Unity 6000)。
Authentication
- All 您也可以在Spot Banner中顯示廣告。
- Android 支援 X（原 Twitter）的用戶邀請分享功能。
Matchmaking
變更功能
Authentication
修復的錯誤
Billing
- iOS 當某些產品價格無法精確地以浮點數表示時，請修改 JSON 格式，將這些值表示為精確的小數位，而不是循環小數。
- 例如：
4.99$（字串）→ 4.9900000000000011（雙精度浮點數）→ 4.99（JSON 數字）
v4.24.4.0
檢查此 SDK 版本的開發環境。
新功能
Billing
- Android 請求 PG 付款時，我們支援使用
IAPv4.purchase 進行多件購買。
Marketing Attribution
修復的錯誤
Analytics
- iOS 修正了僅選擇一個選項時，同意橫幅選項顯示不正確的錯誤。
v4.24.3.0
檢查此 SDK 版本的開發環境。
新功能
Provisioning
- All 在「條款和條件」畫面上增加了檢查是否已獲得法定代表人同意的功能。
變更功能
Authentication
- All 更改了註銷行為。
- 之前：當呼叫
<code>signOut</code> 時，Hive SDK 會登出使用者帳戶。 當呼叫 signOut API 時，訪客會收到來自伺服器的失敗回應。 - 變更後：當呼叫
<code>signOut</code> 時，Hive SDK 會向 Hive 伺服器詢問是否可以登出使用者帳戶，然後根據伺服器回應登出使用者。 - All 註銷訪客帳號 不再回傳成功回應，而是回傳錯誤代碼。訪客帳號會話在 Hive SDK 和 Hive 伺服器中都有維護。
- All 被暫停的帳戶會自動從身分提供者 (IdP) 登出，可以使用相同身分提供者的其他帳戶重新登入。但前提是無法自動登入。
- All 使用
AuthV4.connect 方法連接到 IdP 時，將其變更為在切換到已暫停的帳戶時登出。 - All 變更設備管理服務，使其根據設備存取區域自動套用國際長途國家代碼。
- iOS 我們正在進行一些更改，以便即使您拒絕應用程式追蹤透明度 (ATT) 同意，您仍然可以登入 Facebook。
- All 修改傳送給
additionalInfo 的值，避免包含不必要的資訊。 - All 更改以允許以 2:3 或 3:2 比例顯示全螢幕橫幅。
- All 將首頁橫幅上的文字「停止觀看 1 天」改為「立即停止觀看」。
Marketing Attribution
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.1.3
檢查此 SDK 版本的開發環境。
變更功能
Authentication
- All 變更設備管理服務，使其根據設備存取區域自動套用國際長途國家代碼。
v4.24.2.0
新功能
- All 在適用 GDPR 的歐盟和歐洲經濟區，我們提供了一個函數，返回 未滿 16 歲的用戶是否已同意條款和條件。您可以檢查使用者是否未滿 16 歲。
- Android 在執行 Android OS 11 或更高版本的裝置或安裝了支援模組的裝置上使用照片庫時，預設使用 PhotoPicker。
- iOS 您也可以在 macOS 控制台應用程式中查看 Hive SDK 偵錯日誌，並選擇要查看的 Hive SDK 日誌中的特定日誌類型。
Authentication
- All 當您使用一個手機號碼建立的帳戶數量超過限制時，請求驗證碼時將顯示錯誤訊息：「使用相同手機號碼建立的帳戶數量已超過限制」。
- All 提供控制交叉推廣展示效果的功能。
- All 今天，我們推出了一項改進的插頁式橫幅廣告功能，名為N 天插頁式橫幅廣告。
變更功能
- iOS 我們透過最小化使用遊戲邀請（用戶代理）功能時剪貼簿貼上權限彈出視窗的顯示，提升了用戶體驗。
- 權限同意彈出視窗的顯示時間已從受邀使用者啟動應用程式後立即顯示，變更為在應用程式啟動後 Hive SDK 初始化完成後顯示。
- 現在，只有當邀請者的 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
- All 對於從中國訪問的用戶，在進行實名認證過程中，如果發送的簡訊數量超過限制，則會顯示錯誤訊息，而不是重置剩餘時間。
- Android 修正了使用者在 Google Play 登入過程中按下返回鍵不登入時，沒有正確回應回呼的問題。
- Android 修正了在低解析度裝置上無法進行鍵盤輸入的問題。
- iOS 修正了在新聞視圖中顯示新框架視圖時導致畫面凍結的錯誤。
Marketing Attribution
- Android 修正了使用自訂條款初始化時 Adjust 事件分發延遲的問題。
v4.24.1.2
檢查此 SDK 版本的開發環境。
修復的錯誤
Authentication
- Android 修正了在登入過程中按返回按鈕取消 Google 登入時，未收到正確回應回呼的問題。此錯誤僅在 Hive 控制台中的「Google 舊版支援」值設為「true」時才會出現。
- Android 修正了低解析度裝置上無法進行鍵盤輸入的問題。
v4.24.1.0
變更功能
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
新功能
Billing
- iOS 如果有首次訂閱折扣訊息，則會在檢索產品資訊時一併傳遞。您可以透過尋找在使用
getProductInfo 回呼函數時收到的 IAPV4Product 物件清單中的 original_price 欄位和 price 欄位之間的差異來檢查折扣資訊。
變更功能
- iOS 區分應用程式版本時，也可以使用
CFBundleShortVersionString。
Billing
- All 退款使用者付款介面中顯示的 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
Analytics
- Android 將 Firebase 事件收集功能中廣告標識符收集設定的預設值變更為
true。
已知問題
Authentication
- iOS 使用 iOS 17.0.0 的 Facebook SDK 時，如果用戶未同意“應用程式追蹤透明度”，則無法在 iOS 17.0 或更高版本的裝置上登入。若要在此條件下實現 Facebook 登錄，請使用 Hive SDK v4 24.1.0。