iOS
所需信息
- Hive SDK v4 Native 25.0.0 或更高版本:需要 安全金鑰發行
- 由於身份驗證安全協議的變更,使用版本 25.0.0 或更高版本時,必須從 Hive 控制台發行安全金鑰。否則,將無法登錄。
- Hive SDK v4 Native 25.1.3 或更高版本:需要 PG 付款實現變更
- 使用 Android 25.1.3 或更高版本的 PG 付款時,必須根據 PG 付款流程 修改實現。
v4.26.1.0
下載
新功能
計費
認證
促銷
- 支援延遲深層連結,當尚未安裝應用程式的用戶點擊直接連結時,能將用戶導向指定的應用程式內頁面,即使在安裝應用程式後也能如此。
附加元件
- 在遊戲內網頁視圖中打開 提供了一個選項,可以使用遊戲活動而不是 Hive 活動來顯示網頁視圖,當使用 PlatformHelper 類的 showInWebView 方法暴露網頁視圖時。
其他
- 您可以使用
Configuration 类中的 getGameLanguage 方法检查 SDK 中配置的语言设置。 - 由于 CocoaPod 服务的终止,我们通过 SPM(Swift 包管理器)提供分发服务。
更改的功能
資料庫更新
- 亞馬遜應用商店 (Android) v3.0.4 → v3.0.8
- 三星 GalaxyStore IAP (Android) v6.1.1 → v6.5.0
- 谷歌計費庫 (Android) v7.0.0 → v8.0.0
- QQ (Android) v3.5.17 → v3.5.18
- 小米 (Android) v3.2.5_12798 → v3.4.6
- 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
行銷歸因
- 更改以防止對於發送到 MMP 的相同收據重複發送收入日誌。
- 在發送 Firebase 購買事件時,將收入值添加到值鍵中。
計費
- 將用於 Google Play 計費的庫更改為 Google Play Billing Library 8.0。
分析
- 更改了彈出設計並改善了曝光DMA同意橫幅的行為。
- 先前同意橫幅的現有同意歷史將被保留,並且在重新曝光時將顯示改進的文本和新的同意橫幅UI。
- 如果您之前使用了自定義文本的同意橫幅,則必須根據更改的數據結構重新配置,具體參考自定義同意橫幅UI設置。
認證
- 支援透過網頁和應用程式方法進行成人驗證。
- 移除 SNS 登入過程中自動收集個人資料圖片和暱稱的功能。
- 由於新增了
AuthV4.setAutoLoginEnabled(預設:PC 關閉 / 手機開啟),自動登入行為政策更改如下: - 之前:在帳戶衝突後切換到另一個帳戶時,變更的帳戶在手機上保持自動登入,而在 PC 上禁用自動登入
- 更改後:在帳戶衝突後切換到另一個帳戶時,如果自動登入會話已使用
AuthV4.setAutoLoginEnabled 註冊,則變更的帳戶在手機和 PC 上都保持自動登入,否則將禁用(存在例外)
推送
- 針對推播通知收集令牌時,根據構建環境收集額外的令牌資訊的變更。
促銷
- 解決了在通過自定義視圖/直接視圖轉移到外部瀏覽器時網頁視圖閃爍的問題。
配置
- 提供年齡範圍API作為可選功能,以回應App Store問責法案。
- 原定於2026年1月1日在美國德克薩斯州生效的App Store問責法案目前已被推遲,因此您可以根據開發狀態選擇是否應用。
- 您可以選擇在2026年5月在美國猶他州和7月在路易斯安那州生效的App Store問責法案中應用它。
附加元件
- 在 使用遊戲內網頁視圖開啟 中,我們改善了 PlatformHelper 類別的 showInAppView 方法所顯示的網頁視圖的關閉按鈕的可見性。
其他
Configuration.setZone 的行為已更改為僅在初始化之前有效。
修復的錯誤
行銷歸因
- 修正了在 Firebase 中缺少安裝或更新事件的問題。
認證
- 修正了在使用聊天機器人時聊天消息輸入字段間歇性不顯示的問題。
- 修正了在設備管理中註冊設備數量超過限制後,刪除已註冊設備後成人驗證彈出窗口再次出現的問題。
通知
- 修正了即使對於 Android COPPA 目標也會收集推送通知的令牌的問題。
- 修正了 iOS ForegroundPush 設定不會變更為 False 的問題。
促銷
- 修正了當項目數量超過某個限制時新聞菜單無法正常工作的問題。
- 修正了當全螢幕橫幅上顯示的圖像的寬度或高度為 '0' 或伺服器發送錯誤信息時無法正常工作的問題。
- 修正了在沒有 URL 參數的情況下通過直接鏈接暴露社區時直接鏈接無法正常工作的問題。
附加元件
- 修正了當用戶的網絡狀態為離線或在使用遊戲內瀏覽器的PlatformHelper類的showInAppBrowser方法時,遊戲應用閃爍並關閉窗口的問題。
v4.26.0.1
下載
更改的功能
常見
- Hive SDK 開發環境的 Xcode 版本已更改如下:
- 之前:Xcode 26.2 Beta2
- 更改:Xcode 26.2
v4.26.0.0 Beta
下載
新功能
配置
- 新增的合規性功能。
- 如果您將遊戲應用程式分發到Apple App Store,Hive SDK提供**年齡範圍API**以驗證用戶年齡範圍,以響應將於2026年1月1日在美國德克薩斯州生效的App Store問責法。
- 僅支持iOS 26.2或更高版本。
常見
- Hive SDK 現在可以使用 iOS Xcode 26.2 或更高版本進行構建。
- 最低支持的操作系統版本是 iOS 15。
v4.25.9.0
下載
新功能
認證
v4.25.8.0
下載
開發環境
iOS
必要的組件
- SDWebImage (iOS) v5.20.0 → 5.21.1
可選組件
IDP
- Facebook SDK (iOS) v17.4.0 → 18.0.0
- Google Sign-In SDK (iOS) v8.0.0 → 9.0.0
- QQ (iOS) v3.5.17.4 (custom/redistributed) → 3.5.17.5 (custom/redistributed)
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2 → 5.13.0
行銷追蹤分析
- Airbridge (iOS) v4.3.0 → 4.7.0
- Adjust (iOS) v5.2.0 → 5.4.3
- Singular (iOS) v12.7.1 → 12.8.1
- AppsFlyer (iOS) v6.16.1 → 6.17.2
- FirebaseAnalytics (iOS) v11.6.0 → 11.15.0
其他
- Google reCaptcha (iOS) v18.6.0 → 18.7.0
重要注意事項
-
由於身份驗證安全協議的變更,當使用 Hive SDK v4 Unreal Engine 25.0.0 或更高版本時,您必須從 Hive Console > Security Key Settings 中 發出安全金鑰。如果沒有安全金鑰,將無法在應用中登錄。
-
由於 PG 付款流程的變更,如果您在 Hive SDK v4 Unreal Engine 25.1.3 或更高版本中使用 PG 付款,則必須根據 PG 付款流程 更新您的代碼。
新功能
更改的功能
認證
- 移除在使用 Xcode 26 构建时无法使用的库的引用。
其他
- 更新外部庫:
- 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
錯誤修正
認證
- 修正了聊天機器人彈出窗口在橫屏模式下間歇性出現而不是豎屏模式的問題。
- 修正以防止空數組引用錯誤。
- 在使用Authv4類的
showConflict方法時,當缺少必要的輸入數據時會發生崩潰。
v4.25.7.0
下載
注意:此 SDK 版本不提供單獨的發佈檔案,功能已包含在更高版本的 SDK 中。
新功能
認證
- 提供一個API以獲取個性化的身份識別信息。
- 身份識別信息是一個哈希的DI值。在調用API並完成成人驗證後,您可以使用此信息來識別已完成成人驗證的用戶。
更改的功能
認證
v4.25.6.0
下載
重要注意事項
- 由於身份驗證安全協議的變更,當使用 Hive SDK v4 Native iOS 25.0.0 或更高版本時,您必須從 Hive Console > Security Key Settings 發出安全金鑰。如果沒有安全金鑰,將無法在應用程式中登錄。
開發環境
iOS
必要的組件
可選組件
IDP
- Facebook SDK (iOS) v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.17.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
行銷追蹤分析
- Airbridge (iOS) v4.3.0
- Adjust (iOS) v5.2.0
- Singular (iOS) v12.7.1
- AppsFlyer (iOS) v6.16.1
- FirebaseAnalytics (iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
新功能
聊天
- 增加了在特定聊天消息上表达或显示“喜欢”的功能。
- 增加了对特定聊天消息写回复并显示回复关系的功能。
- 增加了提及特定用户并显示提及信息的功能。
更改的功能
聊天
開發者指南變更
v4.25.5.2
下載
重要注意事項
- 由於身份驗證安全協議的變更,當使用 Hive SDK v4 Native iOS 25.0.0 或更高版本時,您必須從 Hive Console > 安全金鑰設置 中 發出安全金鑰。如果沒有安全金鑰,則無法在應用程序中登錄。
開發環境
iOS
必要的組件
可選組件
IDP
- Facebook SDK (iOS) v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.17.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
行銷追蹤分析
- Airbridge (iOS) v4.3.0
- Adjust (iOS) v5.2.0
- Singular (iOS) v12.7.1
- AppsFlyer (iOS) v6.16.1
- FirebaseAnalytics (iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
錯誤修正
認證
- 修正了在橫向模式下顯示聊天機器人時發生的崩潰問題。
v4.25.5.1
下載
重要注意事項
- 由於身份驗證安全協議的變更,當使用 Hive SDK v4 Native iOS 25.0.0 或更高版本時,您必須從 Hive Console > Security Key Settings 發出 安全金鑰。如果沒有安全金鑰,將無法在應用程式中登錄。
開發環境
iOS
必要組件
可選組件
IDP
- Facebook SDK (iOS) v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.17.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
行銷追蹤分析
- Airbridge (iOS) v4.3.0
- Adjust (iOS) v5.2.0
- Singular (iOS) v12.7.1
- AppsFlyer (iOS) v6.16.1
- FirebaseAnalytics (iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
新功能
認證
- 新增了 多帳戶切換 功能:
- 將當前登錄的帳戶保存到設備
- 查看已保存的帳戶
- 登出並刪除已保存的帳戶
- 快速使用其他已保存的帳戶登錄
促銷
通知
- 添加了推送操作按钮功能:
- 接收到推送通知时,您可以通过可选择的推送操作按钮执行预定义的操作。
聊天
- 消息發送
- 新增自動翻譯聊天消息為用戶語言的功能,並能翻譯特定消息。
- 新增公告消息功能,可僅發送給特定語言的用戶。
- 為WebSocket消息新增消息ID,以保證回調順序。
- 頻道
- 新增進入頻道時查看先前聊天歷史的能力。
- 提供當前頻道的參與者數量。
- 在檢索頻道列表時新增排序選項。
- 事件管理
- 新增以二進制格式傳輸自定義數據事件。
- 連接管理
- 新增重新連接功能。
更改的功能
常見
- 之前分開的
HiveAppTrackingTransparents.framework 庫現在已整合到 Service.framework 中。
認證
showMyInquiry 方法現在即使不使用 Hive 會員帳戶也會顯示查詢頁面。
行銷歸因
- 現在支持在啟用時自動收集的 Firebase 購買事件。
海克力士
- 更新了海克力士库:
- 20241120 → 20250218
錯誤修正
配置
推廣
分析
已知問題
- 在橫向模式下使用聊天機器人時會發生崩潰。
- 請更新至 Hive SDK iOS 25.5.2 或更高版本。
開發者指南變更
v4.25.2.2
下載
重要注意事項
- 由於身份驗證安全協議的變更,當使用 Hive SDK v4 Native iOS 25.0.0 或更高版本時,您必須從 Hive 控制台 > 安全密鑰設置 中 發出安全密鑰。如果沒有安全密鑰,將無法在應用程序中登錄。
開發環境
iOS
必要的組件
可選組件
IDP
- Facebook SDK (iOS) v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.17.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
行銷追蹤分析
- Airbridge (iOS) v4.3.0
- Adjust (iOS) v5.2.0
- Singular (iOS) v12.7.1
- AppsFlyer (iOS) v6.16.1
- FirebaseAnalytics (iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
v4.25.2.1
下載
重要注意事項
- 由於身份驗證安全協議的變更,使用 Hive SDK v4 原生 iOS 25.0.0 或更高版本時,您必須從 Hive 控制台 > 安全密鑰設置 發出安全密鑰。如果沒有安全密鑰,將無法在應用中登錄。
開發環境
iOS
所需組件
可選組件
IDP
- Facebook SDK (iOS) v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.17.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
行銷追蹤分析
- Airbridge (iOS) v4.3.0
- Adjust (iOS) v5.2.0
- Singular (iOS) v12.7.1
- AppsFlyer (iOS) v6.16.1
- FirebaseAnalytics (iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
v4.25.2.0
下載
重要注意事項
- 由於身份驗證安全協議的變更,當使用 Hive SDK v4 Native iOS 25.0.0 或更高版本時,您必須從 Hive Console > Security Key Settings 發出 安全金鑰。如果沒有安全金鑰,將無法在應用中登錄。
開發環境
iOS
必要的組件
可選組件
IDP
- Facebook SDK (iOS) v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.16
VK (iOS) v1.6.4 - WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
行銷追蹤分析
- 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
- FirebaseAnalytics (iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
新功能
更改的功能
配置
- 更改了行為,使得如果條款頁面鏈接是一個網絡地址(不是條款 URL)或包含超鏈接標籤,則現在在外部瀏覽器中打開。
認證
行銷歸因
- 添加了 Hive SDK 标识符以支持 MMP 服务集成。
- 在手动事件跟踪期间更改为 包含自定义属性。
- 将
sendEventWithAttributes API 中的 semantic value 精度从 float 更改为 double。
聊天
- 現在在發送或接收消息數據時會發送和接收
extraData。 - 連接到聊天服務器時不再發送
extraData。 - 現在除了字符串類型外,還會接收整數類型的時間值。
- 改進了處理,以避免在因網絡問題導致的斷開連接後嘗試重新連接時出現重複的WebSocket連接。
其他
- 更新的外部庫:
- 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) v3.5.17.3 → v3.5.17.4
錯誤修正
常見
- 修正了在 Configuration 類別中使用
setZone 方法更改伺服器群組區域時,導致 hive_config.xml 中的 gameLanguage 值重置的問題。
配置
- 修正了一個問題,即在COPPA/GDPR合規性期間,當Adiz廣告模組在SDK之前初始化時,_hive_config.xml_中的
AgeGate值被錯誤使用。
認證
- 修正了在運行 iOS 18 或更高版本的設備上,QQ 網頁登錄無法正常工作的問題。
開發者指南變更
開發環境更新
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) v3.5.17.3 → v3.5.17.4
v4.25.1.3
下載
註解
- 由於身份驗證安全協議的變更,當使用 Hive SDK v4 Native iOS 25.0.0 或更高版本時,您必須在 Hive 控制台 > 安全金鑰設置 中發行安全金鑰,通過 發行安全金鑰。如果未發行安全金鑰,應用程序用戶將無法登錄應用程序。
- 由於身份驗證安全協議的變更,當使用 Hive SDK v4 Native iOS 25.0.0 或更高版本時,您必須在 Hive 控制台 > 安全金鑰設置 中發行安全金鑰,通過 發行安全金鑰。如果未發行安全金鑰,應用程序用戶將無法登錄應用程序。
開發環境
iOS
必要
可選
IDP
- Facebook SDK iOS v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.16
- VK (iOS) v1.6.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
行銷追蹤分析
- Airbridge(iOS) v4.1.1
- Adjust(iOS) v5.0.1
- Singular(iOS) v12.6.1
- AppsFlyer(iOS) v6.15.3
- FirebaseAnalytics(iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
新功能
更改的功能
行銷歸因
修復的錯誤
行銷歸因
- 在透過 Adiz 發送廣告收入信息時,修正 Airbridge 發送到 AdMob 而不是 Adiz 的錯誤。
計費
促銷
- 修正了在顯示包含圖像的評論彈出窗口時,當發生旋轉事件時顯示的圖像消失的錯誤。
v4.25.0.1
下載
註解
由於身份驗證安全協議的變更,當使用 Hive SDK v4 原生 iOS 25.0.0 或更高版本時,您必須從 Hive 控制台 > 安全金鑰設置 獲取 安全金鑰。如果沒有安全金鑰,應用程序用戶將無法登錄到應用程序。
開發環境
iOS
必需品
可選項目
IDP
- Facebook SDK iOS v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.16
- VK (iOS) v1.6.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
行銷追蹤分析
- Airbridge(iOS) v4.1.1
- Adjust(iOS) v5.0.1
- Singular(iOS) v12.6.1
- AppsFlyer(iOS) v6.15.3
- FirebaseAnalytics(iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
新功能
更改的功能
修復的錯誤
行銷歸因
- 修正了在使用 Hive SDK v4 25.0.0 或更高版本与 Adjust v5 时,自动收集并由 SDK 发送的 did 和 vid 值未被发送的问题。
v4.25.0.0
下載
註解
由於身份驗證安全協議的變更,使用 Hive SDK v4 Native iOS 25.0.0 時,您必須從 Hive 控制台 > 安全金鑰設置發出安全金鑰 在這裡。如果您未獲得安全金鑰,應用程序用戶將無法登錄應用程序。
開發環境
iOS
必填項目
可選項目
身份提供者
- Facebook SDK iOS v17.4.0
- Google Sign-In SDK (iOS) v8.0.0
- QQ (iOS) v3.5.16
- VK (iOS) v1.6.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.2
行銷追蹤分析
- Airbridge(iOS) v4.1.1
- Adjust(iOS) v5.0.1
- Singular(iOS) v12.6.1
- AppsFlyer(iOS) v6.15.3
- FirebaseAnalytics(iOS) v11.6.0
其他
- Google reCaptcha (iOS) v18.6.0
新功能
認證
計費
行銷歸因
聊天
配對
※ 這與之前版本的 Hive SDK 介面不相容。要使用更新的配對功能,您必須使用 Hive SDK v4 25.0.0 或更高版本。
更改的功能
認證
- 移除了已過時的
Auth模組類別、介面、方法、委託和監聽器。 - 使用JWT令牌應用更強的安全協議。
- 由於停止支持TalkPlus,移除了TalkPlus身份驗證令牌方法。
促銷
- 收集登錄事件,以便在輸入邀請碼的用戶安裝應用程式時可以授予獎勵。
行銷歸因
- 更新以支持 Adjust v5。
- 更改为在与 Adjust 聚合 Adiz 广告收入时将广告收入来源发送为 AdMob。
- 6.14.2 → 6.15.2
- 移除了 Appsflyer 广告收入库。
其他
修復的錯誤
計費
開發者指南變更
- 由於在行銷歸因中移除了 Adjust Signature 函式庫,整合 SDK 簽名的方法已經改變。
開發環境更新
iOS
- Xcode 15.3 → 16.1
- 更新到 Xcode 版本將最低 iOS 目標提高到 13。
- SDWebImage v5.19.7 → v5.20.0
- Facebook v17.1.0 → v17.4.0
- Google Sign-In v7.1.0 → v8.0.0
- LINE v5.10.0 → v5.11.2
- AirBridge v4.1.0 → v4.1.1
- AppsFlyer v6.14.3 → v6.15.3
- Adjust v4.38.4 → v5.0.1
- Singular v12.5.0 → v12.6.1
- Firebase v10.29.0 → v11.6.0
v4.24.5.0
下載
開發者環境
iOS
所需的庫
可選的庫
身份提供者
- Facebook SDK iOS v17.1.0
- Google Sign-In SDK (iOS) v7.1.0
- QQ (iOS) v3.5.16
- VK (iOS) v1.6.4
- WeChat (iOS) v2.0.4
- LINE (iOS) v5.11.0
行銷追蹤分析
- Adjust(iOS) v4.38.4
- AdjustSigSdk 3.20.1
- Singular(iOS) v12.5.0
- AppsFlyer(iOS) v6.15.3
- FirebaseAnalytics(iOS) v10.29.0
其他
- Google reCaptcha (iOS) v18.6.0
有什麼新消息
認證
- Steam 和 X(前身为 Twitter)现在支持作为身份提供者(IdP)进行身份验证。
- 应用内浏览 现在支持提供带有身份验证会话的网页视图。
配對
- 配對系統 已經新增,以幫助玩家找到其他人一起遊玩。
促銷
更改的功能
認證
修復的錯誤