升級指南¶

本頁提供有關 Hive 聊天 API 所有變更的指導，以及不再支持的項目。
請參考此內容，以順利將您的 Hive 聊天集成升級到最新版本。

SDK 26.4.0¶

變更¶

• 新增 onConnectStarted、onConnectCompleted 事件。onConnectStarted、onConnectCompleted 事件會取代既有的 Chat.reconnect 事件 onReconnectStarted、onReconnected。現在自動重新嘗試聊天連線時，會傳遞 onConnectStarted、onConnectCompleted 事件。
  • onConnectStarted 事件會在嘗試聊天連線時發生。
  • onConnectCompleted 事件是傳遞聊天連線結果的事件。無論聊天連線狀態成功或失敗，都會原樣傳遞連線結果。由於 onConnectCompleted 事件會取代 onReconnected 事件，因此必須根據 onConnectCompleted 事件結果，實作在聊天連線成功或失敗時執行的處理。

不支援的項目¶

• （預計終止支援）不支援 Chat 類別的 reconnect 方法。
  • 既有的手動重新連線請求功能改以 Chat.connect 方法取代。
• （預計終止支援）不支援 onReconnectStarted、onReconnected 事件。原本由 onReconnected 事件傳遞的進入成功頻道清單與進入失敗頻道清單，將以空陣列提供。
• （預計終止支援）不支援 onConnected 事件。請改用 onConnectCompleted 事件，實作在連線成功或失敗時執行的處理。

Hive SDK 25.8.0¶

變更¶

• 從 SDK 25.8.0 開始，Windows 版本已支援聊天功能。
  • Steam Deck 目前尚未支援聊天功能（未來將提供支援）。

Hive SDK 25.6.0¶

變更¶

• 頻道訊息檢索方法已從獲取最新訊息更改為在特定訊息 ID 之前和之後獲取範圍內的訊息。
  • 已添加一個唯一標識每個訊息對象的訊息 ID。
  • ChannelMessageListQueryParams 類已更新。要保持以前的行為，將 messageId 設置為 null，並將相同的值分配給 size 和 prevSize。

Hive SDK 25.4.0¶

變更¶

• 已對通過 Chat 類的 addConnectionListener 方法註冊的監聽器事件進行了以下更改：
  • 新增了一個 onReconnectStarted 事件。當調用 Chat 類的 reconnect API 或因內部狀態變更而自動重試聊天連接時，將觸發此事件。
  • onReconnected 事件現在包含一個 ResultAPI 對象，該對象包含結果信息。

不支援的項目¶

• Chat 類別的 addDirectMessageListener 和 removeDirectMessageListener 方法不再受支援。以前的 1:1 訊息接收功能現在可以使用 Chat 類別的 addUserListener 和 removeUserListener 方法來處理。