升级指南¶

本页面提供有关 Hive 聊天 API 所有更改的指导，以及不再支持的项目.
请参考此内容，以顺利将您的 Hive 聊天集成升级到最新版本。

SDK 26.4.0¶

Hive SDK 25.8.0¶

更改¶

更改¶

• 新增 onConnectStarted、onConnectCompleted 事件。onConnectStarted、onConnectCompleted 事件将替代现有 Chat.reconnect 事件 onReconnectStarted、onReconnected。现在，当聊天连接自动重试时，会传递 onConnectStarted、onConnectCompleted 事件。
• 从 SDK 25.8.0 开始，Windows 版本支持聊天功能。
  • onConnectStarted 事件会在尝试聊天连接时发生。
  • Steam Deck 目前尚不支持聊天功能（未来将提供支持）。
  • onConnectCompleted 事件用于传递聊天连接结果。无论聊天连接状态是成功还是失败，都会原样传递连接结果。由于 onConnectCompleted 事件会替代 onReconnected 事件，因此应基于 onConnectCompleted 事件结果实现聊天连接成功或失败时的处理逻辑。

Hive SDK 25.6.0¶

不支持的项目¶

更改¶

• （即将停止支持）不支持 Chat 类的 reconnect 方法。

  • 现有的手动重连请求功能将由 Chat.connect 方法替代。
  • 渠道消息检索方法已从获取最新消息更改为在特定消息 ID 之前和之后获取消息范围。
  • （即将停止支持）不支持 onReconnectStarted、onReconnected 事件。原本由 onReconnected 事件传递的进入成功频道列表和进入失败频道列表将以空数组形式提供。
  • 添加了唯一标识每个消息对象的消息 ID。
  • （即将停止支持）不支持 onConnected 事件。应使用 onConnectCompleted 事件替代该事件，并实现连接成功或失败时的处理逻辑。
  • 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 方法来处理。