iOS

v4.25.2.1¶

下載¶

重要注意事項¶

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

開發環境¶

iOS¶

• Xcode 16.1 或更高版本
• 請根據 Apple App Store 要求 更新您的 Xcode 版本。

必要的組件¶

• 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¶

下載¶

重要注意事項¶

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

開發環境¶

iOS¶

• Xcode 16.1 或更高版本
• 請根據 Apple App Store 要求 更新您的 Xcode 版本。

必要的組件¶

• 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 網頁登錄無法正常工作的問題。

開發者指南變更¶

• 更新了基本设置 > 配置文件 > Unity，以反映HiveConfig编辑器的更改。
• 在身份验证 > 准备 > 常见中添加了LINE IdP集成设置。
• 在身份验证 > 准备 > IdP密钥输入中更新了VK登录方法。
• 添加了使用Singular、AppsFlyer、Firebase Analytics进行MMP集成的手动事件跟踪和添加自定义属性。
• 从市场归因 > 参考中删除了遗留的Adjust Signature V1设置。
• 添加了Airbridge应用市场标识符设置。
• 更新了聊天 > 连接管理，以反映重连和示例代码的更改。

開發環境更新¶

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¶

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

必要¶

• SDWebImage (iOS) v5.20.0

可選¶

身份提供者¶

• 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

新功能¶

• 不適用

更改的功能¶

行銷歸因¶

• 新增支援 Airbridge 延遲深層連結追蹤 功能。

修復的錯誤¶

行銷歸因¶

• 當通過 Adiz 發送廣告收入信息時，修正 Airbridge 發送到 AdMob 而不是 Adiz 的錯誤。

計費¶

• 修正了在显示询问是否同意发送消费信息的弹出用户界面时背景不透明的错误。

• 修正了在關閉詢問是否同意發送消費信息的彈出 UI 時，應用程序的螢幕方向意外旋轉的錯誤。

促銷¶

• 修正了在顯示包含圖像的評論彈出窗口時，當發生旋轉事件時顯示的圖像消失的錯誤。

v4.25.0.1¶

下載¶

注意事項¶

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

開發環境¶

iOS¶

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

必需品¶

• 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¶

下載¶

注意事項¶

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

開發環境¶

iOS¶

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

必填項目¶

• 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

新功能¶

認證¶

• 現在支持Telegram作為新的身份驗證方法（IdP）。請參考Telegram登錄的機器人設置。

計費¶

• 支持查詢用戶是否同意將in-app 產品消費信息發送到 Apple App Store。

行銷歸因¶

• 新增支持在發送行銷追蹤事件時向 Airbridge 發送額外屬性。

聊天¶

• 新增對聊天功能的支持。

配對¶

• 更新了配對功能，以新支持 群組配對。

  ※ 此版本不兼容於之前的 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¶

• Xcode 15.3 或更高版本
• Xcode 版本必须根据 Apple App Store 政策 进行更新。

所需的函式庫¶

• 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

有什麼新消息¶

認證¶

• Steam 和 X（前身为 Twitter）现在被支持作为身份提供者（IdP）进行身份验证。
  • 前提条件：所有引擎
  • 前提条件：Android
  • 前提条件：iOS
  • 品牌指南
• 应用内浏览 现在支持提供一个带有身份验证会话的网页视图。

配對製作¶

• 配對系統 已經新增，以幫助玩家找到其他人一起遊玩。

促銷¶

• 現在，您可以在 Spot Banner 上展示廣告。

更改的功能¶

認證¶

• 更改了在冲突弹出窗口中显示的提供者名称。

修復的錯誤¶

計費¶

• 修正了一個問題，即某些無法準確表示為浮點數的產品價格現在在 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¶

下載¶

開發環境¶

• Xcode 15.3+
  • Xcode 版本應該根據Apple App Store 政策進行更新。

可選¶

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

否則¶

• Google reCaptcha (iOS) v18.3.0

有什麼新消息¶

行銷歸因¶

• 我們支持 Airbridge 作為專門為 Hive SDK 提供的服務。
  • 使用 Airbridge 自動追蹤事件
  • 使用 Airbridge 手動追蹤事件
    

更改的功能¶

• 不適用

修正的錯誤¶

分析¶

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

開發環境更新¶

iOS¶

• Xcode 15 -> 15.3

v4.24.3.0¶

下載¶

開發環境¶

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

必填¶

• 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（FirebaseCloudMessaging）(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集成时，切换到暂停账户将触发登出。
• 更改设备管理服务以根据设备访问区域自动应用国际电话国家代码。
• 更改为允许Facebook登录，即使拒绝了应用追踪透明度（ATT）同意。

促銷¶

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

行銷歸因¶

• 將Adjust Signature版本從v1更改為v3。

修復的錯誤¶

Hive SDK 通用¶

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

通知¶

• 修改以發送應用版本信息。

開發環境更新¶

• Facebook SDK 16.2.1 → 17.0.2

開發者指南變更¶

• 術語「大型橫幅」已更改為 「全橫幅」。
• 已更新自定義本地推送通知中type字段的指導。
• 現在指出，可以使用Configuration.getLegalGuardianConsentAgree來檢查法定監護人同意。
• 為有使用限制的帳戶新增IdP整合指導。
• 在手動更新或安裝Hive SDK Unity時，必須在構建應用程序之前刪除XML文件。

v4.24.2.0 (2024-07-05)¶

有什麼新消息¶

Hive SDK 通用¶

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

認證¶

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

促銷¶

• 提供控制交叉促銷曝光的功能。
• 支持“N天內不顯示”功能，改善了之前的“今天不再顯示”。

更改的功能¶

促銷¶

• 通过最小化在使用游戏邀请（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¶

下載¶

更改的功能¶

認證¶

• 在使用設備管理服務時註冊移動設備時，將根據設備的連接區域自動應用國際撥號碼，而不是使用+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¶

• 支持使用瀏覽器來顯示外部頁面的 SafariViewController。您可以使用 PlatformHelper 類的 showInAppBrowser 方法來顯示 應用內瀏覽器。

更改的功能¶

Hive SDK 常見¶

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

Billing

• 退款用戶還款界面中顯示的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默认操作所需的强制框架中移除HiveAppTrackingTransparency和HiveResource。