SDK Cocos2d-x 版本說明¶

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

必要項目¶

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

安全金鑰設定適用於 Hive SDK v4 Cocos2d-x 25.0.0 及更高版本
- 由於身分驗證安全協定的變更，在使用 Hive SDK v4 Cocos2d-x 25.0.0 及更高版本時，您必須在Hive 控制台 > 安全金鑰設定中[頒發安全金鑰設定中[頒發安全金鑰](../../operation.center/mdettm）。沒有安全金鑰，您將無法登入應用程式。
Hive SDK v4 Cocos2d-x 25.1.3 及更高版本需要對 PG 支付實作進行更改
- 若要在 Android 25.1.3 及更高版本上實現 PG 支付，您必須參考 PG 支付流程修改 PG 支付實現代碼。

v4.26.0.1¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x Android	2025-12-18
SDK Cocos2d-x iOS	2025-12-18

變更功能¶

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 Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

新功能¶

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

Provisioning¶

Android 我們新增了一項合規功能（../../dev/provisioning/compliance.md）。
如果您將遊戲應用程式分發到 Google Play 或 Amazon Appstore，Hive SDK 提供了一個 年齡範圍 API，用於檢查用戶的年齡範圍，以符合將於 2026 年 1 月 1 日在美國德克薩斯州生效的《應用商店問責法案》。
iOS 我們新增了一項合規功能（../../dev/provisioning/compliance.md）。
如果您將遊戲應用程式發佈到 Apple App Store，Hive SDK 提供了一個 年齡範圍 API，用於檢查使用者年齡範圍，以符合將於 2026 年 1 月 1 日在美國德克薩斯州生效的《App Store 問責法案》。
僅支援 iOS 26.2 或更高版本。

已知問題¶

Provisioning¶

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

v4.25.9.0¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

新功能¶

Authentication¶

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

v4.25.8.0¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x Android	2025-10-02
SDK Cocos2d-x iOS	2025-10-02

檢查此 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 Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

新功能¶

Authentication¶

All 成人驗證完成後，即可識別已通過成人驗證的使用者。取得識別值的方法中提供了相關資訊。識別資訊是經過哈希處理的DI值。

變更功能¶

Authentication¶

All Hive 如果您在控制台中設定了使用成人驗證的應用程式，登入後將自動執行成人驗證程序。
此功能僅在韓國可用。
All 用於執行成人驗證的 showAdultConfirm 方法已被棄用。
showAdultConfirm 方法可能會在未來的更新中移除。

v4.25.6.0¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x Android	2025-07-31
SDK Cocos2d-x iOS	2025-07-31

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

新功能¶

Chat¶

All 增加了「讚」或標記特定聊天訊息的功能。
All 提供訊息，使您可以對特定的聊天訊息進行「回應」或指示回覆關係。
All 可以提及特定使用者或提供被提及使用者的資訊。

變更功能¶

Chat¶

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

v4.25.5.2¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x iOS	-

修復的錯誤¶

Authentication¶

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

v4.25.5.1¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

新功能¶

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 Cocos2d-x Android	-

變更功能¶

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 Cocos2d-x Android	-

修復的錯誤¶

Marketing Attribution¶

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

v4.25.2.0¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

變更功能¶

Authentication¶

All 我們更新了 VK 的身份驗證方法。更新後的身份驗證方法可在新版 VK 開發者控制台中使用。
iOS 更新了登入 Apple GameCenter 時所使用的已棄用的 GameKit API 的驗證協定。
Android 由於 Google 登入庫已棄用，我們將改用 Google Credential Manager 和 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 在以下情況下，「條款與條件詳情」和「回放」頁面將改為在新瀏覽器視窗中打開，而不是載入「條款與條件」頁面（網頁視圖）：
當跳到「條款與條件」網址以外的網頁時
點擊「條款與條件」頁面內的超連結 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¶

Android 修復了聊天連線偶爾會失敗的問題。

已知問題¶

Marketing Attribution¶

Android 與 MMP 服務整合時，使用的 Hive SDK 識別碼有錯誤，缺少 did 值。請使用已修正此問題的 SDK v4 Unity Android & iOS 25.2.1。

v4.25.1.3¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

變更功能¶

Billing¶

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

Marketing Attribution¶

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

修復的錯誤¶

Billing¶

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

Promotion¶

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

Marketing Attribution¶

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

v4.25.0.1¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x iOS	-

新功能¶

Marketing Attribution¶

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

v4.25.0.0¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

新功能¶

Authentication¶

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

Billing¶

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

Promotion¶

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

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 登入網頁視圖除了提供登入功能外，還允許瀏覽網頁，例如尋找密碼。

Marketing Attribution¶

All 已更新以支援 Adjust v5。
移除 Adjust Signature 庫。
All 使用 Adjust 聚合 Adiz 廣告收入時，將 Adiz 廣告收入聚合來源變更為 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 Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

新功能¶

All 支持 Unity 6 (Unity 6000)。

Authentication¶

All 新增對 Steam 和 X（原 Twitter）作為身份驗證方式的支援。
Prep: Common
Prep: Android
Prep: 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 Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

新功能¶

Billing¶

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

Marketing Attribution¶

All 支援將 Airbridge 作為 Hive SDK 的一項特定服務。
使用 Airbridge 自動追蹤事件
使用 Airbridge 手動追蹤事件

修復的錯誤¶

Analytics¶

iOS 修正了僅選擇一個選項時，同意橫幅選項顯示不正確的錯誤。

v4.24.3.0¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

新功能¶

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。

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

Notification¶

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

v4.24.1.3¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

變更功能¶

Authentication¶

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

v4.24.2.0¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

新功能¶

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

Authentication¶

All 當您使用一個手機號碼建立的帳戶數量超過限制時，請求驗證碼時將顯示錯誤訊息：「使用相同手機號碼建立的帳戶數量已超過限制」。

Promotion¶

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

變更功能¶

Promotion¶

iOS 我們透過最小化使用遊戲邀請（用戶代理）功能時剪貼簿貼上權限彈出視窗的顯示，提升了用戶體驗。
1. 權限同意彈出視窗的顯示時間已從受邀使用者啟動應用程式後立即顯示，變更為在應用程式啟動後 Hive SDK 初始化完成後顯示。
2. 現在，只有當邀請者的 URL 資料存在於剪貼簿中時，才會顯示此彈出視窗。

Notification¶

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

Library updates¶

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

Analytics¶

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

修復的錯誤¶

Authentication¶

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

Promotion¶

iOS 修正了在新聞視圖中顯示新框架視圖時導致畫面凍結的錯誤。

Marketing Attribution¶

Android 修正了使用自訂條款初始化時 Adjust 事件分發延遲的問題。

v4.24.1.2¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x Android	-

修復的錯誤¶

Authentication¶

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

v4.24.1.0¶

依目標作業系統的 SDK	發佈日期
SDK Cocos2d-x iOS	-

變更功能¶

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 Cocos2d-x Android	-
SDK Cocos2d-x iOS	-

新功能¶

Billing¶

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

Promotion¶

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

變更功能¶

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。