跳轉至

iOS

v4.25.2.2

下載


iOS
下載 Hive SDK v4 Native iOS 25.2.2
發佈日期 2025-06-23

重要注意事項


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


開發環境


iOS

必要的組件

  • SDWebImage (iOS) v5.20.0

可選組件

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

下載


iOS
下載 Hive SDK v4 原生 iOS 25.2.1
發佈日期 2025-05-14

重要的注意事項


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


開發環境


iOS

所需組件

  • SDWebImage (iOS) v5.20.0

可選組件

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

下載


iOS
下載 Hive SDK v4 原生 iOS 25.2.0
發佈日期 2025-04-29

重要注意事項


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


開發環境


iOS

必要的組件

  • SDWebImage (iOS) v5.20.0

可選組件

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)或包含超鏈接標籤,現在會在外部瀏覽器中打開。

認證

  • 更改了 VK 認證方法。新方法可在 VK 開發者控制台 上使用。

  • 更新了用於 Apple GameCenter 登錄的過時 GameKit API 驗證協議。

行銷歸因

  • 添加了 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

下載


iOS
下載 Hive SDK v4 Native iOS 25.1.3
發佈日期* 2025-04-10

註解


  • 由於身份驗證安全協議的變更,當使用 Hive SDK v4 Native iOS 25.0.0 或更高版本時,您必須在 Hive 控制台中發佈安全金鑰 > 安全金鑰設置,通過發佈安全金鑰。如果未發佈安全金鑰,應用用戶將無法登錄應用。
  • 由於身份驗證安全協議的變更,當使用 Hive SDK v4 Native iOS 25.0.0 或更高版本時,您必須在 Hive 控制台中發佈安全金鑰 > 安全金鑰設置,通過發佈安全金鑰。如果未發佈安全金鑰,應用用戶將無法登錄應用。


開發環境


iOS

必要

  • SDWebImage (iOS) v5.20.0

可選

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

下載


iOS
下載 Hive SDK v4 原生 iOS 25.0.1
發佈日期 2025-03-10

注意事項


由於身份驗證安全協議的變更,當使用 Hive SDK v4 Native iOS 25.0.0 或更高版本時,您必須從 Hive 控制台 > 安全金鑰設置 獲取 安全金鑰。如果沒有安全金鑰,應用程序用戶將無法登錄應用程序。


開發環境


iOS

必需品

  • SDWebImage (iOS) v5.20.0

可選項目

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

下載


iOS
下載 Hive SDK v4 原生 iOS 25.0.0
發佈日期 2025-01-24

注意事項


由於身份驗證安全協議的變更,使用 Hive SDK v4 Native iOS 25.0.0 時,您必須從 Hive 控制台 發出安全密鑰 > 安全密鑰設置 在這裡。如果您未獲得安全密鑰,應用程序用戶將無法登錄應用程序。


開發環境


iOS

必填項目

  • SDWebImage (iOS) v5.20.0

可選項目

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 接口不兼容。要使用更新的配對功能,您必須使用 Hive SDK v4 25.0.0 或更高版本。


更改的功能


認證

  • 移除了已過時的Auth模組類別、介面、方法、委派和監聽器。
  • 使用JWT令牌應用了更強的安全協議。
  • 由於停止支持TalkPlus,移除了TalkPlus身份驗證令牌方法。

促銷

  • 收集登入事件,以便在輸入邀請碼的用戶安裝應用程式時可以授予獎勵。

行銷歸因

  • 更新以支持 Adjust v5。
    • 移除了 Adjust Signature 库。
  • 更改为在与 Adjust 聚合 Adiz 广告收入时将广告收入来源发送为 AdMob。
    • 6.14.2 → 6.15.2
    • 移除了 Appsflyer 广告收入库。

其他

  • 更新了赫拉克勒斯庫版本。
    • iOS: 20241120


修復的錯誤


計費

  • 修正了一個錯誤,即在使用 UserEngagement 提示應用內購買時,會額外發生 IAP_UPDATE 事件。


開發者指南變更

  • 由於在行銷歸因中移除了 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
下載 Hive SDK v4 原生 iOS 24.5.0
發佈日期 2024-11-08

開發者環境


iOS

所需的庫

  • SDWebImage (iOS) v5.19.7

可選的庫

IDP

  • 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

有什麼新消息


認證

配對製作

  • 配對系統 已經添加,以幫助玩家找到其他人一起遊玩。

促銷

更改的功能


認證

  • 更改了在衝突彈出窗口中顯示的提供者名稱。

修復的錯誤


計費

  • 修正了一個問題,某些無法準確表示為浮點數的產品價格現在在 JSON 格式中正確顯示為小數,而不是重複的小數。
    • 例子: 4.99$ (字符串) → 4.9900000000000011 (雙精度) → 4.99 (JSON)

開發者指南變更

  • 更新了顯示廣告橫幅的note,使用showCustomContents方法進行交叉推廣的插頁廣告曝光。
  • 添加了一個note,用於在iOS上使用Steam登錄。

開發環境更新


iOS

  • SDWebImage 5.18.7 → 5.19.7
  • reCaptcha 18.4.0 → 18.6.0
  • Facebook 17.0.2 → 17.1.0
  • QQ 3.5.16 → 3.5.17 (custom)
  • AppsFlyer 6.14.3 → 6.15.3
  • Singular 12.4.1 → 12.5.0
  • Firebase 10.22.0 → 10.29.0

v4.24.4.0


下載


iOS
下載 Hive SDK v4 原生 iOS 24.4.0
發佈日期 2024-10-14

 

開發環境


可選

IDP
  • Facebook SDK iOS v17.0.2
  • 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.4.1
  • AppsFlyer(iOS) v6.14.3
  • FirebaseAnalytics(iOS) v10.22.0
Else
  • Google reCaptcha (iOS) v18.3.0

 

有什麼新消息


行銷歸因

更改的功能


  • 不適用


修復的錯誤


分析

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

開發環境更新


iOS

  • Xcode 15 -> 15.3

 

v4.24.3.0


下載


iOS
下載 Hive SDK v4 原生 iOS 24.3.0
發佈日期 2024-09-03

 

開發環境


必需

  • Kotlin (Android) v1.8.0
  • Kotlin Coroutine (Android) 1.4.3
  • AndroidX (Android) v1.0.0+
  • Constraint Layout (Android) v2.1.4
  • Glide (Android) v4.13.0
  • SDWebImage (iOS) v5.18.7


OPTIONAL

IDP
  • Facebook SDK Android v17.0.0
  • Facebook SDK iOS v17.0.2
  • GooglePlay Services-Auth (Android) v20.7.0
  • GooglePlay Services-Games v2 (Android) v20.0.0
  • Google Sign-In SDK (iOS) v7.1.0
  • QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
  • QQ (iOS) v3.5.16
  • VK (Android) v3.5.1
  • VK (iOS) v1.6.4
  • WeChat (Android) v6.8.0
  • WeChat (iOS) v2.0.4
  • LINE (Android) v5.10.0
  • LINE (iOS) v5.11.0
  • Huawei (Android) v6.12.0.300
IAP
  • Google 计费库 (Android) v7.0.0
  • Samsung GalaxyStore IAP (Android) v6.1.1
  • OneStore (Android) v21.01.00
  • WeChat (Android) v6.8.0
  • Amazon (Android) v3.0.4
  • Huawei (Android) v6.13.0.300
推送
  • 亞馬遜 (Android) v1.2.0
  • FCM(Firebase雲端訊息) (Android) v23.2.1
行銷追蹤分析
  • Adjust(Android) v4.38.5
  • adjust-android-signature-3.20.1.aar
  • Adjust(iOS) v4.38.4
  • AdjustSigSdk 3.20.1
  • Singular(Android) v12.5.4
  • Singular(iOS) v12.4.1
  • AppsFlyer(Android) v6.13.0
  • AppsFlyer(iOS) v6.14.3
  • FirebaseAnalytics(Android) v21.5.0
  • FirebaseAnalytics(iOS) v10.22.0
其他
  • GooglePlay 服務-評價 (Android) v2.1.0
  • GooglePlay 服務-應用更新 (Android) v2.1.0
  • Google reCaptcha (Android) v18.4.0
  • Google reCaptcha (iOS) v18.3.0
  • YoutubeAndroidWebPlayerApi (Android) v1.0.1

 

有什麼新消息


配置

  • 已新增一項功能,以檢查是否已在條款和條件畫面上獲得法定代表人的同意。


更改的功能


認證

  • 修改了登出行為。
    • 之前:當調用signOut時,用戶帳戶會從Hive SDK中登出。
    • 當來賓調用signOut API時,會從伺服器收到失敗響應。
    • 更改:當調用signOut時,Hive SDK將請求Hive伺服器確認登出用戶帳戶,並根據響應進行登出。
  • 來賓帳戶登出將不再返回成功響應,而是返回錯誤代碼。來賓帳戶會話將由Hive SDK和Hive伺服器維護。
  • 被暫停的帳戶將自動從IdP登出,以允許使用不同帳戶登錄同一IdP。這僅在無法自動登錄的情況下適用。
  • 當使用AuthV4.connect方法與IdP集成時,切換到暫停的帳戶將觸發登出
  • 更改設備管理服務,自動根據設備訪問區域應用國際電話國碼。
  • 即使拒絕了應用程序跟踪透明度(ATT)同意,也允許Facebook登錄。

促銷

  • 修改以確保通過additionalInfo發送的值中不包含不必要的信息。
  • 更改以允許以2:3或3:2的比例顯示完整橫幅
  • 將完整橫幅上的文本從“今天不顯示”更改為“今天不顯示”。

行銷歸因


修復的錯誤


Hive SDK 通用

  • 修復了在 iOS 14 設備上檢查應用程式追蹤透明度 (ATT) 同意時偶爾發生的崩潰。
  • 修復了在照片庫中選擇限制訪問(僅允許訪問某些照片)時發生的崩潰。

通知

  • 修改以發送應用程式版本資訊。


開發環境更新


  • Facebook SDK 16.2.1 → 17.0.2


開發者指南變更


 

v4.24.2.0 (2024-07-05)


有什麼新消息


Hive SDK 通用

  • 提供一個功能,返回在歐盟和EEA地區(GDPR適用)中,16歲以下的用戶是否同意服務條款,並檢查他們是否未滿16歲。 在這裡檢查此功能。
  • 允許在MacOS控制台應用程序中查看Hive SDK調試日誌並選擇特定的日誌類型進行查看。

認證

  • 當使用單一手機號碼可以註冊的帳戶數量超過時,請求發送驗證碼將顯示錯誤訊息:「您已超過可以使用相同手機號碼創建的帳戶數量。」
  • 當使用單一手機號碼可以註冊的帳戶數量超過時,請求發送驗證碼將顯示錯誤訊息:「您已超過可以使用相同手機號碼創建的帳戶數量。」

促銷


更改的功能


促銷

  • 通过在使用游戏邀请(UA)功能时最小化剪贴板粘贴权限的同意弹出窗口来改善可用性。
    1. 将同意弹出窗口的时机从启动应用后立即更改为在应用启动后初始化 Hive SDK 的时候。
    2. 仅在剪贴板中有邀请者 URL 数据时显示弹出窗口。

分析

  • saveAnalyticsLogBeforeCrash的預設值更改為false,該選項在崩潰發生時將未傳輸的日誌保存到文件中。


錯誤修正


認證

  • 在中國訪問的用戶進行實名驗證過程中,當超過發送消息限制且剩餘時間未重置時,將顯示錯誤消息。

促銷

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


開發環境更新


iOS

  • 不適用


開發者指南變更


  • 由於從 Hive SDK v4 24.2.0 開始停止支持 Facebook Cloud Games,以下頁面已相應更新:
    • 設置 Unity
    • 設置 Unity > 配置 Facebook Cloud Games
    • 設置 Android
    • 計費
    • 通知
  • 增強了對 Lebi 的 市場選擇屏幕 的解釋。

 

v4.24.1.3


下載


iOS
下載 Hive SDK v4 iOS 24.1.3
發佈日期 2024-07-25


更改的功能


認證

  • 在使用設備管理服務註冊移動設備時,國際撥號碼將根據設備的連接區域自動應用,而不是使用+82

 

v4.24.1.2 (2024-06-27)


有什麼新消息


不適用


更改的功能


不適用


修復的錯誤


不適用


開發者指南更新


不適用

 

v4.24.1.0 (2024-05-14)


有什麼新消息


不適用


更改的功能


Analytics

  • 更改為根據設備是否同意追蹤來決定是否顯示同意橫幅。
    • 如果您拒絕同意追蹤,則不會顯示同意橫幅。


開發環境更新


iOS

  • 根據 Apple 隱私清單政策更新外部庫。
    • AppsFlyer(iOS) v6.13.1 → v6.14.3
    • QQ (iOS) v3.5.14 → v3.5.16
  • 降級 Facebook SDK。
    • Facebook SDK v17.0.0 → v16.2.1


修復的錯誤


Billing

  • 修復在將 Hive SDK 從低於 v4 24.0.0 的版本(例如,v4 23.4.0)更新到 v4 24.0.0 時,產品查詢失敗的問題。


開發者指南的變更


不適用

 

v4.24.0.0 (2024-04-30)


有什麼新消息


Promotion


更改的功能


Hive SDK 常見

  • 額外使用 CFBundleShortVersionString 來區分應用程式版本

Billing

  • 退款用戶償還 UI 中顯示的 PG 付款類型短語已從 "HiveStore" 更改為 "PG 付款"。


開發環境更新


iOS

  • 微信 2.0.2 → 2.0.4
  • 赫拉克勒斯 2024.01.23 → 2024.04.11
  • Singular 12.3.2 → 12.4.1


開發者指南的變更


  • 已更改`displayOriginalPrice`的描述。
  • 已更改`displayPrice`底部的说明。
  • 第三方框架依赖关系,设置iOS中的Podfile编写示例已更改。已从Hive SDK默认操作所需的强制框架中删除HiveAppTrackingTransparencyHiveResource