Android & iOS

v4.24.5.0¶

下載¶

開發環境¶

共通開發環境¶

• Hive SDK v4 UE4 Android & iOS 24.5.0
• 虚幻引擎 4.27 Plus
  提交哈希: ee4a7175fe6ea7620c3b78eea6332ebbb631b661

虛幻引擎 4: 安卓¶

• JDK 11
• Android Studio 4.1
• Android NDK r21
• Android SDK 最小版本 24
• Android SDK 目標版本 34

虛幻引擎 4: iOS¶

• Xcode 15.3+
• iOS 版本 12.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¶

下載¶

開發環境¶

虛幻引擎 4: 安卓¶

• Hive SDK v4 UE4 Android & iOS 24.4.0
• 虚幻引擎 4.27 Plus
  提交哈希: ee4a7175fe6ea7620c3b78eea6332ebbb631b661
• JDK 11
• Android Studio 4.1
• Android NDK r21
• Android SDK 最小版本 24
• Android SDK 目标版本 34

虛幻引擎 4: iOS¶

• Hive SDK v4 UE4 Android & iOS 24.4.0
• Unreal Engine 4.27 Plus
  Commit Hash: ee4a7175fe6ea7620c3b78eea6332ebbb631b661
• Xcode 15.3+
• iOS Version 12.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.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( 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.0.1
• GooglePlay 服務-應用程式更新 (Android) v2.1.0
• Google reCaptcha (Android) v18.4.0
• Google reCaptcha (iOS) v18.4.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

新功能¶

行銷歸因¶

• 所有 Hive 的 SDK 特化服务支持 Airbridge。
  • 通过 Airbridge 自动追踪事件
  • 通过 Airbridge 手动追踪事件

計費¶

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

修改的功能¶

• 不適用

解決的錯誤¶

分析¶

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

開發環境更新¶

• 不適用

開發者指南變更點¶

• 我們已經添加了有關行銷歸因的問題解決指南。

v4.24.3.0¶

下載¶

開發環境¶

虛幻引擎 4: 安卓¶

• Hive SDK v4 UE4 Android & iOS 24.3.0
• Unreal Engine 4.27 Plus
  • 提交哈希: efd8cf7bd1770ab68ec34f10bd2e33579c4307b2
• JDK 11
• Android Studio 4.1
• Android NDK r21
• Android SDK 最小版本 24
• Android SDK 目标版本 34

虛幻引擎 4: iOS¶

• Hive SDK v4 UE4 Android & iOS 24.3.0
• Unreal Engine 4.27 Plus
  • 提交哈希: efd8cf7bd1770ab68ec34f10bd2e33579c4307b2
• Xcode 15.3+
• iOS 版本 12.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.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v7.0.0
• OneStore (Android) v21.01.00
• WeChat (Android) v6.8.0
• Amazon (Android) v3.0.4
• Huawei (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.4.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¶

下載¶

開發環境¶

虛幻引擎 4: 安卓¶

• Unreal Engine 4.27 Plus
  • 提交哈希：0db0b74ff0822a57a5ce49a4cd10c8672fc57a4b
• JDK 8
• AndroidStudio 4.1
• Android NDK r21
• Android SDK 最小版本 21
• Android SDK 目标版本 34

虛幻引擎 4: iOS¶

• Unreal Engine 4.27 Plus
  • 提交哈希: 0db0b74ff0822a57a5ce49a4cd10c8672fc57a4b
• Xcode 15.1+
• iOS 版本 12.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 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.10.0
• Huawei (Android) v6.12.0.300

IAP¶

• Google Billing Library (Android) v6.0.1
• OneStore (Android) v21.01.00
• WeChat (Android) v6.8.0
• Amazon (Android) v3.0.4
• Huawei (Android) v6.13.0.300

推送¶

• 亞馬遜 (Android) v1.0.1
• FCM(雲端消息傳遞) (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.4.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

更改的功能¶

認證¶

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

v4.24.1.2 (2024-07-01)¶

下載¶

開發環境¶

虛幻引擎 4: 安卓¶

• 虛幻引擎 4.27 Plus
  • 提交哈希: 0db0b74ff0822a57a5ce49a4cd10c8672fc57a4b
• JDK 8
• AndroidStudio 4.1
• Android NDK r21
• Android SDK 最小版本 21
• Android SDK 目標版本 34

虛幻引擎 4: iOS¶

• Unreal Engine 4.27 Plus
  • 提交哈希: 0db0b74ff0822a57a5ce49a4cd10c8672fc57a4b
• Xcode 15.1+
• iOS 版本 12.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 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.10.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.4.0
• YoutubeAndroidWebPlayerApi (Android) v1.0.1

解決的錯誤¶

認證¶

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

v4.24.1.0 (2024-06-07)¶

新功能¶

不適用

更改的功能¶

分析¶

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

開發環境更新¶

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

解決的錯誤¶

計費¶

• 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支付页面更改为在应用内Web视图中显示，而不是应用内浏览器。即使在不支持应用内浏览器环境的设备上，也支持PG支付。

分析¶

• Android Firebase 事件收集功能中的广告标识符收集设置默认值更改为 true。

已知問題¶

認證¶

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

開發環境更新¶

虛幻引擎 4¶

• 虛幻引擎 4.27 Plus
  • 提交哈希：0db0b74ff0822a57a5ce49a4cd10c8672fc57a4b

安卓¶

• 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
• 单一 12.3.2 → 12.4.1

開發者指南變更點¶

• displayOriginalPrice 已更改說明。
• displayPrice 已更改下方註解 說明。
• Hive 功能選擇應用（Android, iOS）圖片已更改，並在下方添加了註解。