SDK Cocos2d-x 版本說明¶

本指南按版本介紹 Hive SDK Cocos2d-x 的主要更新。

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

• Android SDK Cocos2d-x Android 更新
• iOS SDK Cocos2d-x iOS 更新
• Windows SDK Cocos2d-x Windows 更新
• All SDK Cocos2d-x Android、iOS 和 Windows 更新

必要項目¶

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

• **使用 Hive SDK v4 Cocos2d-x 25.0.0 或更高版本時，必須取得安全金鑰（請參閱 ../../operation/appcenter/securitykey_settings.md）。 **
  • 由於身分驗證安全協定的變更，使用 Hive SDK v4 Cocos2d-x 25.0.0 或更高版本時，您必須從 Hive 控制台 > 安全金鑰設定 取得安全金鑰（請參閱 ../../operation/appcenter/security_pkeycenter/xkey.如果您未取得安全性金鑰，則無法登入應用程式。
• Hive SDK v4 Cocos2d-x 25.1.3 或更高版本需要對 PG 支付實作進行更改
  • 若要在 Android 25.1.3 或更高版本上實現 PG 支付，您必須參考 PG 支付作業流程 修改 PG 支付實作程式碼。

v4.26.0.2¶

修復的錯誤¶

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

v4.25.9.1¶

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

修復的錯誤¶

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

v4.25.8.3¶

修復的錯誤¶

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

v4.26.1.3¶

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

修復的錯誤¶

Authentication¶

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

Billing¶

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

Marketing Attribution¶

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

v4.26.1.2¶

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

變更功能¶

Authentication¶

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

修復的錯誤¶

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

v4.26.1.0¶

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

新功能¶

Authentication¶

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

Promotion¶

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

Others¶

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

變更功能¶

Authentication¶

• iOS 我們支援透過網頁和應用程式進行年齡驗證。
• iOS 移除 透過 SNS 登入時自動收集個人資料圖片和暱稱。
• iOS 透過新增 AuthV4.setAutoLoginEnabled(預設值：PC 關閉/行動裝置開啟)，自動登入行為策略變更如下：
• 之前：在帳戶衝突後切換到其他帳戶時，新帳戶在行動裝置上保持自動登錄，但在 PC 上停用自動登入。
• 變更後：在帳戶衝突後切換到其他帳戶時，如果已使用 AuthV4.setAutoLoginEnabled 註冊了自動登入會話，則新帳戶在行動裝置和 PC 上均保持自動登入；否則，停用自動登入（存在例外情況）。

Promotion¶

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

Push¶

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

Marketing Attribution¶

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

Add-ons¶

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

Provisioning¶

• iOS 我們單獨提供年齡範圍 API，以便根據《應用商店責任法案》的要求進行應用。
• 《應用商店責任法案》將於2026年1月1日在美國德州生效，目前暫緩實施，可依開發情況選擇性地應用。
• 也可選擇性地應用，以符合將於2026年5月在美國猶他州和2026年7月在美國路易斯安那州生效的《應用商店責任法案》。

Library updates¶

• 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¶

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

修復的錯誤¶

Authentication¶

• iOS 修正了使用聊天機器人時聊天訊息輸入欄位間歇性不顯示的錯誤。
• iOS 修正了以下錯誤：當裝置管理中已註冊的裝置數量超過限制時，如果已註冊的裝置在通過成人驗證後被刪除，則成人驗證彈出視窗會重新出現。

Promotion¶

• iOS 修正了當新聞項目數量超過某個限制時，新聞選單無法正常運作的錯誤。
• iOS 修正了當正面橫幅上顯示的影像寬度或高度為「0」或伺服器傳輸錯誤訊息時，系統無法正常運作的錯誤。
• iOS 修正了透過直接連結公開社群時，如果缺少 URL 參數則直接連結無法正常運作的錯誤。

Push¶

• 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¶

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

v4.26.0.0¶

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

新功能¶

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

Provisioning¶

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

已知問題¶

Provisioning¶

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

v4.25.9.0¶

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

新功能¶

Authentication¶

• All 已提供身分驗證服務（../../dev/authv4/verification.md）。
• 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¶

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

新功能¶

Chat¶

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

變更功能¶

Chat¶

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

v4.25.5.2¶

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

修復的錯誤¶

Authentication¶

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

v4.25.5.1¶

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

新功能¶

Authentication¶

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

Promotion¶

• 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 購買事件而進行的變更。

修復的錯誤¶

Promotion¶

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

Provisioning¶

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

Analytics¶

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

已知問題¶

Others¶

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

v4.25.2.2¶

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

修復的錯誤¶

Marketing Attribution¶

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

v4.25.2.0¶

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

變更功能¶

Authentication¶

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

Billing¶

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

Promotion¶

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

Marketing Attribution¶

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

Provisioning¶

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

Library updates¶

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

Chat¶

• 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) 時，用於年齡檢查的 AgeGate 值在 COPPA 或 GDPR 等合規性情況下基於 hive_config.xml 中設定的值運行的錯誤。

Chat¶

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

已知問題¶

Marketing Attribution¶

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

v4.25.1.3¶

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

變更功能¶

Billing¶

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

Marketing Attribution¶

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

修復的錯誤¶

Billing¶

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

Promotion¶

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

Marketing Attribution¶

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

v4.25.0.1¶

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

新功能¶

Marketing Attribution¶

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

v4.25.0.0¶

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

新功能¶

Authentication¶

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

Billing¶

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

Promotion¶

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

Matchmaking¶

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

Marketing Attribution¶

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

Chat¶

• All 聊天 功能已新增支援。

變更功能¶

Authentication¶

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

Marketing Attribution¶

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

Hercules¶

• All 2024.11.20

修復的錯誤¶

Authentication¶

• Android 解決了在執行 signIn 方法期間發生網路回應延遲時 UI 執行緒間歇性被佔用的問題。

Billing¶

• iOS 修正了在使用 UserEngagement 誘導應用程式內購買時觸發額外 IAP_UPDATE 事件的錯誤。

已知問題¶

Marketing Attribution¶

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

v4.24.5.0¶

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

新功能¶

• All 支持 Unity 6 (Unity 6000)。

Authentication¶

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

Promotion¶

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

Matchmaking¶

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

變更功能¶

Authentication¶

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

修復的錯誤¶

Billing¶

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

v4.24.4.0¶

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

新功能¶

Billing¶

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

Marketing Attribution¶

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

修復的錯誤¶

Analytics¶

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

v4.24.3.0¶

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

新功能¶

Provisioning¶

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

變更功能¶

Authentication¶

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

Promotion¶

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

Marketing Attribution¶

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

Library updates¶

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

修復的錯誤¶

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

Notification¶

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

v4.24.1.3¶

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

變更功能¶

Authentication¶

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

v4.24.2.0¶

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

新功能¶

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

Authentication¶

• All 當一個手機號碼可註冊的帳戶數量超過限制時，請求發送驗證碼時會顯示一條錯誤訊息，提示「您使用相同手機號碼建立的帳戶數量已超過限制」。

Promotion¶

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

變更功能¶

Promotion¶

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

Notification¶

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

Library updates¶

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

Analytics¶

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

修復的錯誤¶

Authentication¶

• All 修改為：當從中國訪問的用戶在實名驗證過程中發送的簡訊數量超過限制時，顯示錯誤訊息，而不是重置剩餘時間。
• Android 修正了使用者在 Google Play 登入過程中未按返回鍵登入時，沒有正確回應回呼的錯誤。
• Android 修正了在低解析度裝置上無法進行鍵盤輸入的錯誤。

Promotion¶

• iOS 修正了在新聞視圖中顯示新框架視圖時出現凍結的錯誤。

Marketing Attribution¶

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

v4.24.1.2¶

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

修復的錯誤¶

Authentication¶

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

v4.24.1.0¶

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

變更功能¶

Library updates¶

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

Analytics¶

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

修復的錯誤¶

Billing¶

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

v4.24.0.0¶

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

新功能¶

Billing¶

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

Promotion¶

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

變更功能¶

• iOS 在區分應用程式版本時，我們也會使用CFBundleShortVersionString。

Billing¶

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

Library updates¶

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

Analytics¶

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

已知問題¶

Authentication¶

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