Android & iOS

v4.25.6.0¶

下載¶

開發環境¶

Cocos2d-x¶

• Cocos2d-x 3.17.2

安卓¶

iOS¶

• Xcode 16.1 或更高版本
• Xcode 版本必須根據Apple App Store 政策進行更新。

註解¶

• 由於身份驗證安全協議的變更，當使用 Hive SDK v4 Cocos 25.0.0 或更高版本時，您必須在 Hive 控制台 > 安全金鑰設置 中發出 安全金鑰。如果沒有安全金鑰，將無法在應用程序中登錄。

• 由於PG支付流程的變更，要使用Hive SDK v4 Cocos 25.1.3或更高版本的PG支付，請參考PG支付流程並更新您的代碼實現。

新功能¶

聊天¶

• 所有 增加了在特定聊天消息上表達或顯示「喜歡」的能力。
• 所有 增加了對特定聊天消息寫「回覆」的能力，並提供有關回覆關係的信息。
• 所有 增加了提及特定用戶的能力，並提供有關用戶提及的信息。

更改的功能¶

聊天¶

• 全部 将 频道消息查询方法 从基于索引更改为基于消息 ID。

v4.25.5.1¶

新功能¶

認證¶

• 所有 提供了一個新的 多帳戶登錄 功能。詳細信息包括： * 將當前登錄的帳戶保存到設備 * 查看已保存的帳戶 * 登出並刪除已保存的帳戶 * 快速使用另一個已保存的帳戶登錄

推廣¶

• 所有 添加了新的 直接連結功能。

通知¶

• 所有 新增了 推播動作按鈕 功能。 * 當收到推播通知時，您可以透過推播動作按鈕執行預定義的動作。

聊天¶

• 所有 消息發送 * 增加了將聊天消息自動翻譯為用戶語言的功能，以及翻譯特定消息的能力。 * 增加了發送公告消息的能力，只有特定語言的用戶可以接收。 * 增加了消息ID到websocket消息中，以確保回調順序。
• 所有 頻道 * 增加了進入聊天頻道時查看以前聊天記錄的能力。 * 提供當前頻道的參與者數量。 * 增加了檢索頻道列表時的排序選項。
• 所有 事件管理 * 增加了以二進制方式發送自定義數據事件的能力。
• 所有 連接管理 * 增加了重新連接功能。

更改的功能¶

常見問題¶

• Android 更新了構建所需的混淆規則。
• iOS 之前分開的 HiveAppTrackingTransparents.framework 庫現在已整合到 Service.framework 中。

認證¶

• 全部 當不使用 Hive 會員帳戶時，showMyInquiry 方法現在顯示查詢頁面。
• Android 將 VK 認證彈出窗口從網頁視圖更改為應用內瀏覽器。

行銷歸因¶

• iOS 現在支持自動收集 Firebase 購買事件。

海克力士¶

• 所有 更新海克力士庫。 * 安卓 20250527 * iOS 20250218

修正的錯誤¶

配置¶

• iOS 修正了當顯示條款時，網頁視圖不會滾動的問題。

推廣¶

• iOS 修正了iPad設備上新聞UI的角落半徑。

分析¶

• iOS 修正邏輯，以便在同意條款後立即發送分析日誌。

v4.25.2.0¶

更改的功能¶

配置¶

• 所有 在條款詳細資訊和審查頁面上，如果鏈接不是條款 URL 或包含超鏈接標籤，則現在在外部瀏覽器中打開。

認證¶

• 所有 更改了 VK 认证方法。新方法可以在 新的 VK 开发者控制台 中使用。

• iOS 更新了用于 Apple GameCenter 登录的已弃用 GameKit API 的验证协议。

• Android 由於不再支援 Google Sign-In 函式庫，現在的身份驗證使用 Google Credential Manager 和 AuthorizationClient API 進行隱式和明確登錄。

計費¶

• Android 當透過 PG 付款購買的產品被退回時，會添加一個 order_id 值以區分之前的交易。
• Android 在 PG 付款交易完成後，購買完成日誌現在會從客戶端發送。

促銷¶

• Android 將 Telegram 添加到 UserAcquisition 共享的曝光列表中。
• Android 更改了 webview 曝光的緩存政策。

行銷歸因¶

• 所有 添加了 Hive SDK 标识符以便于 与 MMP 服务集成。
• 所有 在手动跟踪事件时，现在可以添加自定义属性。
• Android 在初始化 Airbridge 时，现在会发送市场来源信息。
• iOS 在使用 sendEventWithAttributes API 时，semantic value 类型浮点值的精度范围从 float 更改为 double。

聊天¶

• 全部 在發送或接收消息數據時，extraData 現在會被發送和接收。
• 全部 在連接到聊天伺服器時，extraData 不再被發送。
• 全部 現在除了字符串時間值外，還會接收整數時間值。
• 全部 當網絡被阻塞且 websocket 無法正確斷開時，已更改為使重新連接嘗試不會因為重複連接而失敗。

其他¶

• 更新了外部庫。 * Airbridge(Android) v4.1.0 → v4.3.0 * Airbridge(iOS) v4.1.1 → v4.3.0 * Adjust(Android) v5.0.1 → v5.2.0 * Adjust(iOS) v5.0.1 → v5.2.0 * Singular(Android) v12.6.1 → v12.7.0 * Singular(iOS) v12.6.1 → v12.7.1 * AppsFlyer(Android) v6.15.2 → v6.16.2 * AppsFlyer(iOS) v6.15.3 → v6.16.1 * QQ(iOS) 3.5.17.3 → 3.5.17.4

修正的錯誤¶

常見¶

• Android 當需要重試通信或連接到分佈式伺服器時，如果在最大超時之前收到響應，則立即重試或連接，而無需等待超時。

• iOS 修正了一個錯誤，當使用 Configuration 類的 setZone 方法更改伺服器組區域時，hive_config.xml 中的 gameLanguage 值會被重置。

配置¶

• 所有 在SDK初始化之前初始化广告模块（Adiz）并遵守COPPA或GDPR时，修复了一个错误，该错误导致AgeGate值根据在hive_config.xml中设置的值进行操作。

認證¶

• iOS 修正了在 iOS 18 或更高版本的设备上 QQ 网页登录无法正常工作的错误。

行銷歸因¶

• Android 修正了在使用 Adjust 确定安装状态时显示空推送通知的问题。

• Android 使用 Airbridge 時，修正為在購買多個項目時根據單價和數量發送銷售信息。

聊天¶

• Android 修復了連接聊天時偶爾出現的連接失敗問題。

v4.25.1.3¶

更改的功能¶

行銷歸因¶

• iOS 新增支持 Airbridge 延遲深層鏈接追蹤。

計費¶

• Android 更改了 PG 付款行为，以匹配其他计费 (IAPv4) 市场。如果使用 PG 付款，请参考 PG 付款流程 并更新您的代码。

v4.25.1.0¶

修復的錯誤¶

行銷歸因¶

• iOS 修正了一个错误，该错误导致通过 Adiz 发送的广告收入信息在 Airbridge 中被错误地标记为 AdMob，而不是 Adiz。

計費¶

• iOS 修正了一個錯誤，該錯誤導致同意發送消費信息的彈出 UI 以不透明背景顯示。

• iOS 修正了一個錯誤，即在關閉同意發送消費信息的彈出 UI 時，應用程序屏幕意外旋轉。

促銷¶

• iOS 修正了一個錯誤，即在帶有圖像的審核彈出窗口中發生旋轉事件時圖像消失。

v4.25.0.0¶

新功能¶

認證¶

• 全部 新增 Telegram 作為新的身份驗證方法 (IdP)。請參閱 Telegram 機器人設置以進行登錄。

計費¶

• iOS 支援 請求用戶同意將應用內產品消費信息發送到 Apple App Store。

行銷歸因¶

• 所有 新增支持 发送额外属性到 Airbridge 以进行营销跟踪事件。
• Android 新增支持 Airbridge 延迟深度链接跟踪。

聊天¶

• 所有 新增支持 聊天 功能。

配對¶

• 所有 更新了匹配功能，以新支持 群组匹配。

   <span style='color:#FF0000;'>※ 不兼容以前的 Hive SDK 接口。要使用更新的匹配功能，请使用 Hive SDK v4 25.0.0 或更高版本。</span>
  

更改的功能¶

認證¶

• 所有 移除未使用的 Auth 模組類別、介面、方法、委派和監聽器。
• 所有 使用 JWT 令牌應用更強的安全協議。
• 所有 由於 TalkPlus 支援結束，移除 TalkPlus 認證令牌方法。
• Android 允許在 Apple 登入網頁視圖中瀏覽，例如密碼恢復，而不僅僅是登入。

促銷¶

• 所有 收集登录事件，以便在输入邀请码的用户安装应用程序时给予奖励。请参见此处。

行銷歸因¶

• 所有 更新以支援 Adjust v5。 * 移除了 Adjust Signature 函式庫。
• 所有 在與 Adjust 聚合廣告收入時，將 AdMob 作為廣告收入來源。
• Android 將 Appsflyer 廣告收入聚合函式庫的整合反映到主函式庫中。 * 6.14.2 → 6.15.2 * 移除了 Appsflyer 廣告收入函式庫。

其他¶

• 所有 更新了赫拉克勒斯庫版本。 * 安卓: 20241120 * iOS: 20241120

修復的錯誤¶

認證¶

• Android 修正了一個問題，即在 signIn 方法執行期間，如果網絡響應延遲，UI 線程會間歇性被佔用。

計費¶

• iOS 修正了一個錯誤，當使用 UserEngagement 來誘導應用內產品購買時，會發生額外的 IAP_UPDATE 事件。

v4.24.5.0¶

新功能¶

認證¶

• 所有 新增支援 Steam 和 X（前身為 Twitter）作為身份驗證方法。 * 準備：通用 * 準備：Android * 準備：iOS * 品牌指南
• 所有 提供 應用內網頁瀏覽功能，可共享已驗證的會話。

配對¶

• 所有 新增支持 配對服務。

促銷¶

• 所有 Spot banners 現在支持廣告曝光。
• Android 在用戶邀請分享中新增對 X（前身為 Twitter）的支持。

更改的功能¶

認證¶

• 所有 修改的提供者名稱顯示在衝突彈出窗口中。

修復的錯誤¶

計費¶

• iOS 修正了無法精確表示為浮點數的價格，現在在 JSON 格式中顯示為準確的小數。 * 例子: 4.99$ (字串) → 4.9900000000000011 (雙精度) → 4.99 (JSON 數字)

v4.24.4.0¶

新功能¶

行銷歸因¶

• 全部 支持 Airbridge 作为专门为 Hive SDK 提供的服务。 - 使用 Airbridge 自动跟踪事件 - 使用 Airbridge 手动跟踪事件

計費¶

• Android 支持通过 PG 付款购买所需数量的单一产品。

修復的錯誤¶

分析¶

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

v4.24.3.0¶

新功能¶

配置¶

• 所有 增加了在條款畫面上檢查是否已獲得法定監護人同意的功能。

更改的功能¶

認證¶

• 所有 更改了登出行為。 * 之前：當呼叫signOut時，Hive SDK會登出用戶帳戶。來賓帳戶在呼叫signOut API時會收到伺服器的失敗響應。 * 之後：當呼叫signOut時，Hive SDK會請求Hive伺服器確認用戶帳戶是否可以登出，並根據響應進行登出。
• 所有 當登出來賓帳戶時，不再返回成功響應，而是返回錯誤代碼。Hive SDK和Hive伺服器保持來賓帳戶會話。
• 所有 對於暫停的帳戶，自動登出IdP，以便可以使用相同的IdP登錄另一個帳戶。僅在無法自動登錄時適用。
• 所有 當使用AuthV4.connect連接IdP時，切換到暫停帳戶現在會觸發登出。
• 所有 設備管理服務現在根據設備區域自動應用國際電話國碼。
• iOS 即使拒絕了應用追蹤透明度（ATT）同意，Facebook登錄現在也可以使用。

促銷¶

• 全部 修改以便不包括通過 additionalInfo 發送的值中的不必要信息。
• 全部 更改為允許 2:3 或 3:2 比例的全螢幕橫幅。
• 全部 將全螢幕橫幅中的 "不要顯示 1 天" 文本更改為 "今天不顯示"。

行銷歸因¶

• 全部 已更改 調整簽名 版本從 v1 更改為 v3.

修復的錯誤¶

Hive SDK 通用¶

• Android 修正了由於資源引用邏輯導致內存未釋放的錯誤。
• iOS 修正了在 iOS 14 設備上檢查 ATT 同意狀態時的間歇性崩潰。
• iOS 修正了在相簿中選擇有限照片訪問時的崩潰。

通知¶

• Android 修正了一個錯誤，該錯誤導致不支持的 type 設置在 本地推送通知 中無法顯示推送消息。
• iOS 修改為發送應用版本信息。

v4.24.2.0¶

新功能¶

Hive SDK 通用¶

• 所有 提供一個 功能以返回16歲以下用戶是否同意條款 在適用GDPR的歐盟和EEA地區。
• Android 在Android OS 11+或受支持的模塊上，默認使用 PhotoPicker 來訪問相冊。
• iOS 現在可以在MacOS控制台應用程序中檢查Hive SDK調試日誌，並且可以過濾特定的日誌類型。

認證¶

• 所有 當請求身份驗證碼超過每個電話號碼的最大帳戶數時，顯示錯誤消息：“超過可以使用相同電話號碼創建的帳戶數。”

促銷¶

• 全部 提供跨促銷曝光的控制。
• 全部 改進了「今天不顯示」功能，以支持不顯示N天。

更改的功能¶

通知¶

• Android 支援新款 Amazon Fire 設備的運行時庫 (Push Amazon Device Message 1.2.0)。

促銷¶

• iOS 透過最小化使用遊戲邀請 (UA) 功能時的剪貼簿權限彈出窗口來改善可用性。 * 將彈出窗口的顯示時機從應用啟動更改為 Hive SDK 初始化。 * 現在只有在剪貼簿中存在邀請者 URL 數據時，彈出窗口才會顯示。

分析¶

• iOS saveAnalyticsLogBeforeCrash 选项的默认值，现在是 false，该选项在崩溃时将未发送的日志保存到文件中。

修復的錯誤¶

認證¶

• 全部 在中國用戶的實名驗證中，修正了剩餘時間不會重置的問題，並在超過短信發送限制時顯示錯誤消息。
• 安卓 修正了在Google Play登錄過程中按下返回鍵時未提供回調的錯誤。
• 安卓 修正了在低解析度設備上無法進行鍵盤輸入的錯誤。

促銷¶

• iOS 修正了在新聞視圖中顯示新框架視圖時的凍結問題。

行銷歸因¶

• Android 在使用自定義條款初始化時，調整事件發送的固定延遲。

v4.24.1.2¶

修復的錯誤¶

認證¶

• Android 修正了一個錯誤，當在 Google 登錄過程中按下返回按鈕時未提供回調。此錯誤僅在 Hive 控制台啟用 Google 遺留支持時發生。
• Android 修正了一個錯誤，低解析度設備上無法進行鍵盤輸入。

v4.24.1.0¶

更改的功能¶

分析¶

• iOS 更改為根據設備追蹤同意來決定同意橫幅的顯示。 * 如果拒絕追蹤同意，則不顯示同意橫幅。

v4.24.0.0¶

新功能¶

促銷¶

• Android 支持使用設備的預設瀏覽器顯示外部頁面的自定義標籤。使用PlatformHelper類的showInAppBrowser方法來顯示應用內瀏覽器。
• iOS 支持SafariViewController來顯示外部頁面。使用PlatformHelper類的showInAppBrowser方法來顯示應用內瀏覽器。

計費¶

• iOS 當產品有首次訂閱折扣時，產品信息查詢會在 IAPV4Product 對象中返回 original_price 和 price 字段以獲取折扣信息。

更改的功能¶

Hive SDK 通用¶

• iOS 現在也使用 CFBundleShortVersionString 來區分應用程式版本。

計費¶

• 所有 在退款用户界面中将PG支付类型的措辞从“HiveStore”更改为“PG支付”。
• 安卓 将PG支付页面更改为在应用内网页视图中显示，而不是在应用内浏览器中显示。现在支持在不支持应用内浏览器的设备上进行PG支付。

分析¶

• Android 在 Firebase 事件收集中收集广告标识符的默认值现在是 true。

v4.23.0.0¶

下載¶

開發環境¶

Cocos2d-x¶

• 3.17.2

Android¶

iOS

• Xcode 15.0+
• 應根據Apple App Store 政策更新Xcode版本。

更改的功能¶

Hive SDK 通用¶

• Android 访问 Java Enum 接口 ResultAPI 类的方式已更改。请参见下面的示例。
  • 之前：仅支持 ResultAPI.Companion.getSUCCESS()。
  • 更改：同时支持 ResultAPI.Companion.getSUCCESS() 和 ResultAPI.SUCCESS。
• Android 在 Java 中支持实例方法风格和类方法风格。请参见下面的示例。
  • 之前：仅支持 IAPV4.INSTANCE.getProductInfo。
  • 更改：同时支持 IAPV4.INSTANCE.getProductInfo 和 IAPV4.getProductInfo。
• Android 已进行调整，以确保查询窗口、聊天机器人和成人认证窗口在 Z-Flip 5 前显示屏上不会超出屏幕范围。
• iOS 支持的开发环境已更改为 Xcode 15 或更高版本。可以在 macOS Ventura13.5 或更高版本上使用。支持的操作系统如下：
  • iOS 12 或更高版本
  • iPadOS 13 或更高版本

認證¶

• 全部 對於設備管理、中國的實名驗證等，如果用戶在短信驗證的時間限制內未輸入短信，則發送按鈕將被禁用。
• Android 每個IDP被分為可選的應用程序庫。可以額外應用以下庫：
  • Apple 登入
  • Weverse
  • 會員資格
• Android 變更僅信任由Hive伺服器直接驗證的登錄信息，解決了一些Google Play Games登錄期間的AuthV4ServerResponseError情況。
• iOS Hive SDK使用的reCAPTCHA庫已更新為官方版本。
• iOS 每個IDP被分為可選的應用程序庫。可以額外應用以下庫：
  • Apple 登入
  • GameCenter
  • 會員資格

促銷¶

• 所有 更改已完成，以便在屏幕上仅显示新闻或插播横幅中的一个。只有第一个调用的窗口会出现，后续调用的窗口将不会出现。
• 所有 在UA 活动信息中包含campaignId。
• iOS 更新SDWebImage库，并应用与图像缓存和下载相关的LRU缓存策略。

Billing¶

• 全部 不再支持 IAPv2 接口和功能。
• Android 进行了更改，以便在有待处理的购买时，延迟的购买结果不会影响当前进行的支付。

配置¶

• 全部 添加基於帳戶的服務條款曝光功能

Hercules

• 所有 更新Hercules 庫版本。
  • Android: 20231122
  • iOS: 20231116

<

修復的錯誤¶

認證¶

• Android 修正了在顯示葡萄牙語的使用限制彈出窗口時，按鈕顯示不正確的問題。
• iOS 修正了在快速點擊編輯個人資料圖片時，應用程序崩潰的問題。

促銷¶

• Android 修正了一個錯誤，即在遊戲退出彈出窗口顯示時，應用從前景 > 背景 > 再次前景時，換行無法正常工作。
• iOS 修正了一個問題，即通過推廣橫幅顯示社區網頁等時，頂部凹口區域被截斷。

配置¶

• iOS 修改為不顯示被暫停用戶解除暫停的剩餘時間。

資料庫¶

• iOS 如果您将空值作为参数传递给set方法，它现在会删除之前设置的值，以确保正常操作。

通知¶

• Android 修正了一個問題，該問題導致推送消息內容在應用重新啟動時無法顯示，因為檢索推送消息的過程中出現了問題。

Analytics

• 全部 在同時用戶日誌傳輸中，將未知國家的國家代碼從 Unknown 更改為兩個空格字符。

<

已知問題¶

此版本的 Hive SDK 没有已知问题。
<

開發者指南變更¶

常見

• 將 COPPA ageGateU13 更改為可以直接設置的值。
• 更新了 hive_config.xml 示例。
• 從 這裡 刪除了與不支持的 IdP WEIBO 相關的內容。
• 修訂了 應用內更新 的描述。

Android

• 為Gradle、Android Gradle Plugin、Kotlin Gradle Plugin添加最低版本。
• 由於Hive SDK功能已內部分離為單獨的庫，因此更改了Android Gradle文件的內容。
• 由於WeChat Auth是由Hive SDK自動添加的，因此從AndroidManifest.xml設置中刪除了相關內容。還刪除了內容，因為Hive SDK不直接使用FOREGROUND SERVICE。
• 更改了此處在build.gradle中設置所需庫的內容，以支持Facebook Cloud Game構建。
• 更改了此處的模塊級build.gradle文件的內容，以添加Firebase Analytics。
• 更新了添加Huawei構建設置。
• 更改了此處在build.gradle中設置所需庫的內容，以支持Google Play Games在PC構建上的內容。
• 更改了此處的模塊級build.gradle文件的內容，以支持Google登錄。
• 由於ONE Store版本已更新至21.01.00，因此修訂了描述。

iOS

• 新增了Apple Game Center到IdP整合指南。
• 更改了iOS Podfile的內容，因為Hive SDK功能已內部分為不同的庫。