Android & iOS

v4.24.5.0¶

下載¶

開發環境¶

共通開發環境¶

• Hive SDK v4 UE5 Android & iOS 24.5.0
• 虛幻引擎 5.4.4

虛幻引擎 5: 安卓¶

• JDK 11
• Android Studio 4.1
• Android NDK r25
• Android SDK 最低版本 26
• Android SDK 目標版本 34

虛幻引擎 5: iOS¶

• Xcode 15.3+
• iOS 版本 15.0+
• macOS Ventura 14+

必填項目¶

• Kotlin (Android) v1.9.22
• 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.19.7

選擇項目¶

IDP¶

• Facebook SDK Android v17.0.0
• Facebook SDK iOS v17.1.0
• GooglePlay Services-Auth (Android) v20.7.0
• GooglePlay Services-Games v2 (Android) v20.1.2
• Google Sign-In SDK (iOS) v7.1.0
• QQ (Android) v3.5.14 (3.5.14.3_rc26220c)
• QQ (iOS) v3.5.17
• 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.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (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 Cloud Messaging) (Android) v24.0.2

行銷追蹤分析¶

• Airbridge(Android) v4.1.0
• Airbridge(iOS) v4.1.0
• Adjust(Android) v4.38.5
• adjust-android-signature-3.20.1.aar
• Adjust(iOS) v4.38.4
• AdjustSigSdk 3.20.1
• Singular(Android) v12.6.0
• Singular(iOS) v12.5.0
• AppsFlyer(Android) v6.14.2
• AppsFlyer(iOS) v6.15.3
• FirebaseAnalytics(Android) v22.1.2
• FirebaseAnalytics(iOS) v10.29.0

其他¶

• GooglePlay 服務-評價 (Android) v2.0.1
• GooglePlay 服務-應用程式更新 (Android) v2.1.0
• Google reCaptcha (Android) v18.6.1
• Google reCaptcha (iOS) v18.6.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

新功能¶

認證¶

• 所有 新增的認證方式支援 Steam 和 X（前 Twitter）。
  • 事前準備：共通
  • 事前準備：Android
  • 事前準備：iOS
  • 品牌指導
• 所有 認證的會話提供 應用內瀏覽功能。

配對製作¶

• 所有 新功能支持 配對服務。

促銷¶

• 全部 廣告橫幅也可以顯示廣告。
• Android 用戶邀請分享功能支持X（前Twitter）。

更改的功能¶

插件¶

• Hive Config Settings 菜單的位置已更改，並且可以根據目標平台進行設置。

認證¶

• 所有 修改在冲突弹窗中显示的提供者名称。

解決的錯誤¶

計費¶

• iOS 部分商品价格无法用浮点数准确表示时，将该值修改为在JSON格式中以准确的小数点表示，而不是用循环小数表示。
  • 例如> 4.99$ (string) → 4.9900000000000011 (double) → 4.99 (JSON number)

開發者指南變更事項¶

• 在跨推广全屏横幅展示中，使用 showCustomContents 方法展示的广告横幅已在笔记中更新注意事项。
• 在 iOS 上使用 Steam 登录时，已在笔记中添加注意事项。

開發環境更新¶

安卓¶

• Google reCaptcha 18.4.0 → 18.6.1
• Kotlin 1.8.0 → 1.9.22
• FCM(FirebaseCloudMessaging) 23.2.1 → 24.0.2
• AppsFlyer 6.13.0 → 6.14.2
• Singular 12.5.4 → 12.6.0
• Firebase 21.5.0 → 22.1.2

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 (自定義)
• 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¶

下載¶

開發環境¶

共通開發環境¶

• Hive SDK v4 UE5 Android & iOS 24.4.0
• 虛幻引擎 5.4.4

虛幻引擎 5: 安卓¶

• JDK 11
• Android Studio 4.1
• Android NDK r25
• Android SDK 最小版本 26
• Android SDK 目標版本 34

虛幻引擎 5: iOS¶

• Xcode 15.3+
• iOS 版本 15.0+
• macOS Ventura 14+

必填項目¶

• 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

選擇項目¶

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 Billing Library (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（FirebaseCloudMessaging） (Android) v23.2.1

行銷追蹤分析¶

• Airbridge(Android) v4.1.0
• Airbridge(iOS) v4.1.0
• 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

新功能¶

行銷歸因¶

• 所有 Hive SDK 特化服務支持 Airbridge。
  • 使用 Airbridge 自動追蹤事件
  • 使用 Airbridge 手動追蹤事件

計費¶

• Android PG 付款時，提供可以按所需數量購買單一商品的功能。

更改的功能¶

• 不適用

解決的錯誤¶

分析¶

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

開發環境更新¶

• 不適用

開發者指南變更點¶

• 行銷歸因問題解決指南已新增。

v4.24.3.0 (2024-09-30)¶

下載¶

開發環境¶

共通開發環境¶

• Hive SDK v4 UE5 Android & iOS 24.3.0
• 虛幻引擎 5.4.4

虛幻引擎 5: 安卓¶

• JDK 11
• Android Studio 4.1
• Android NDK r25
• Android SDK 最小版本 26
• Android SDK 目標版本 34

虛幻引擎 5: iOS¶

• Xcode 15.3+
• iOS 版本 15.0+
• macOS Ventura 14+

必填項目¶

• 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

選擇項目¶

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.1.2
• 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
• OneStore (Android) v21.01.00
• 微信 (Android) v6.8.0
• 亚马逊 (Android) v3.0.4
• 华为 (Android) v6.13.0.300

推送¶

• 亞馬遜 (Android) v1.0.1
• FCM( FirebaseCloudMessaging) (Android) v23.2.1

行銷追蹤分析¶

• Adjust(Android) v4.38.5
• Adjust(iOS) v4.38.4
• 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

新功能¶

虛幻引擎¶

• 全部 [插件] 提供專用於 Unreal Engine 的介面。
• 與現有的 C++ 介面相容。

• 全部 提供支持新 Unreal Engine 专用接口的示例代码。

• 全部 支援 Unreal Engine 5.4。

配置¶

• 全部 在条款页面添加确认是否获得法定代理人同意的功能。
• 可以通过Configuration类的getLegalGuardianConsentAgree方法的返回值进行确认。

更改的功能¶

認證¶

• 全部 更改登出操作。
  • 原先: 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 修正为发送应用版本信息。

開發環境更新¶

安卓¶

• Google Play 计费库 6.1 → 7.0
• Google Play 服务游戏 20.0.0 → 20.1.2
• Adjust 4.38.5 → 4.38.2

iOS¶

• Facebook SDK 16.2.1 → 17.0.2
• Adjust 4.38.0 → 4.38.4

v4.24.1.3¶

下載¶

開發環境¶

虛幻引擎 5：Android¶

• 虛幻引擎 5.3.2
• minSdkVersion 26
• NDK r25b
• targetSdkVersion 34

虛幻引擎 5: iOS¶

• 虛幻引擎 5.3.2
• xcode 15.1+
• iOS 15+
• macOS Ventura 14+

必填項目¶

• 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

選擇項目¶

IDP¶

• Facebook SDK Android v17.0.0
• Facebook SDK iOS v16.2.1
• 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) v6.0.1
• OneStore (Android) v21.01.00
• 微信 (Android) v6.8.0
• 亚马逊 (Android) v3.0.4
• 华为 (Android) v6.13.0.300

推送¶

• 亞馬遜 (Android) v1.0.1
• FCM(雲端Firebase消息) (Android) v23.2.1

行銷追蹤分析¶

• Adjust(Android) v4.38.2
• Adjust(iOS) v4.38.0
• 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

更改的功能¶

認證¶

• 全部 設備管理服務使用中，當註冊移動設備時，國際電話國家號碼將根據設備接入地區自動應用，而不是+82。

v4.24.1.2 (2024-07-01)¶

下載¶

開發環境¶

虛幻引擎 5：安卓¶

• 虛幻引擎 5.3.2
• minSdkVersion 26
• NDK r25b
• targetSdkVersion 34

虛幻引擎 5: iOS¶

• 虛幻引擎 5.3.2
• xcode 15.1+
• iOS 15+
• macOS Ventura 14+

必填項目¶

• 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

選擇項目¶

IDP¶

• Facebook SDK Android v17.0.0
• Facebook SDK iOS v16.2.1
• 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) v6.0.1
• OneStore (Android) v21.01.00
• 微信 (Android) v6.8.0
• 亚马逊 (Android) v3.0.4
• 华为 (Android) v6.13.0.300

推送¶

• 亞馬遜 (Android) v1.0.1
• FCM( Firebase雲端消息) (Android) v23.2.1

行銷追蹤分析¶

• Adjust(Android) v4.38.2
• Adjust(iOS) v4.38.0
• 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

解決的錯誤¶

認證¶

• Android 修正了在进行谷歌登录时按下返回按钮取消登录时没有适当响应回调的错误。此错误仅在 Hive 控制台内 Google Legacy Support 值为真时发生。
• Android 修正了在低分辨率设备上无法进行键盘输入的错误。

v4.24.1.0 (2024-06-07)¶

新功能¶

N/A

更改的功能¶

分析¶

• iOS 設備的追蹤同意與否將決定是否顯示同意橫幅。
  • 如果拒絕追蹤同意，則不顯示同意橫幅。

開發環境更新¶

iOS¶

• 根據 Apple Privacy Manifest 政策，更新外部庫。
  • 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

解決的錯誤¶

账单¶

• iOS Hive SDK v4 24.0.0 之前的版本（例如：v4 23.4.0）更新到 v4 24.0.0 时，修复商品查询无法进行的错误。

v4.24.0.0 (2024-04-30)¶

新功能¶

促銷¶

• Android 支持使用设备上设置的默认浏览器来显示外部页面的 自定义标签。可以通过 PlatformHelper 类的 showInAppBrowser 方法显示 应用内浏览器。
• iOS 支持使用浏览器显示外部页面的 SafariViewController。可以通过 PlatformHelper 类的 showInAppBrowser 方法显示 应用内浏览器。

計費¶

• iOS 首次訂閱折扣信息會在查詢商品信息時一併傳遞。使用 getProductInfo 時，可以通過回調接收到的 IAPV4Product 對象列表中的 original_price 欄位值和 price 欄位值的差異來確認折扣信息。

更改的功能¶

Hive SDK 共通¶

• iOS 應用程式版本的區分時，額外使用 CFBundleShortVersionString。

計費¶

• 全部 在退款用户重新支付的 UI 中，将 PG 支付类型的文字从 "HiveStore" 更改为 "PG 支付"。
• Android 将 PG 支付页面更改为在应用内网页视图中显示，而不是应用内浏览器。即使在不支持应用内浏览器环境的设备上，也支持 PG 支付。

分析¶

• Android Firebase 事件收集功能中的廣告識別碼收集設置的默認值更改為 true。

已知問題¶

認證¶

• iOS 使用 Facebook SDK iOS 17.0.0 时，如果用户在 iOS 17.0 及以上设备上不同意“应用追踪透明度（App Tracking Transparency）”，则无法登录。在该条件下实现 Facebook 登录，请使用 Hive SDK v4 24.1.0。

開發環境更新¶

安卓¶

• GooglePlay 服務 - 遊戲 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
• 海克力士 2024.01.23 → 2024.04.11
• Singular 12.3.2 → 12.4.1

開發者指南變更點¶

• displayOriginalPrice 已更改說明。
• displayPrice 已更改下方註解 說明。