Skip to content

Commit

Permalink
Bumps version to v0.7.0
Browse files Browse the repository at this point in the history
  • Loading branch information
gehongyan committed Apr 2, 2024
1 parent 034673a commit 1f600a8
Show file tree
Hide file tree
Showing 3 changed files with 89 additions and 1 deletion.
46 changes: 46 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,52 @@

---

## v0.7.0 [2024-04-02]

### Update Roadmap

The KOOK client now supports sending messages within voice channels. As a result, the following APIs have been modified:

- `CreateVoiceChannelProperties` now inherits from `CreateTextChannelProperties`.
- `ModifyVoiceChannelProperties` now inherits from `ModifyTextChannelProperties`.
- `IVoiceChannel` now inherits from `ITextChannel`.
- The value of `ChannelPermissions.Voice` now includes permissions for text channels.
- The `SocketTextChannel.GetMessagesAsync` series of methods are now virtual methods, to be overridden
by `SocketVoiceChannel`.

It's important to note that, due to limitations in the KOOK API, fetching message history and pinning messages are not
supported within voice channels. Therefore, calling `GetMessagesAsync` and `GetPinnedMessagesAsync` methods from
`IMessageChannel` on voice channels is not supported.

Additionally, while voice channels support operations on `Topic` and `SlowModeInterval` at the API level, the KOOK client
currently does not reflect these capabilities.

Creating channels does not immediately support specifying a Topic. The `Topic` property in `CreateTextChannelProperties`
has been removed and does not take effect. Please use the `ITextChannel.ModifyAsync` method to modify the channel after
creation.

### Added

- Added support for defining card messages via XML.
- `IVoiceChannel` now inherits from `ITextChannel`, with relevant implementations updated.
- Added `SentRequest` event to `BaseKookClient`.
- Added non-null result prompts for parsing card message-related `Try*` methods.

### Fixed

- Corrected the issue with `ConnectionManager` incorrectly updating `State` when `Disconnected`.

### Changed

- Removed the `Topic` property from `CreateTextChannelProperties`.

### Miscellaneous

- Marked the project as not supporting AOT and assembly trimming.
- Added example project `Kook.Net.Samples.CardMarkup`.
- Added documentation for defining card messages via XML.
- Added Logo.

## v0.6.0 [2024-02-28]

### Update Roadmap
Expand Down
2 changes: 1 addition & 1 deletion Kook.Net.targets
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
<IsPackable>false</IsPackable>
<IsTrimmable>false</IsTrimmable>
<IsAotCompatible>false</IsAotCompatible>
<VersionSuffix>beta3</VersionSuffix>
<!-- <VersionSuffix>beta3</VersionSuffix>-->
<LangVersion>latest</LangVersion>
<SymbolPackageFormat>snupkg</SymbolPackageFormat>
<PackageVersion>$(Version)</PackageVersion>
Expand Down
42 changes: 42 additions & 0 deletions docs/changelog/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,48 @@ title: 变更日志

# 变更日志

## v0.7.0 [2024-04-02]

### 更新路线

KOOK 客户端现已支持在语音频道内发送消息,与此相关地以下 API 产生了变动:

- `CreateVoiceChannelProperties` 现已继承自 `CreateTextChannelProperties`
- `ModifyVoiceChannelProperties` 现已继承自 `ModifyTextChannelProperties`
- `IVoiceChannel` 现已继承自 `ITextChannel`
- `ChannelPermissions.Voice` 的值已附加文字频道的权限
- `SocketTextChannel.GetMessagesAsync` 系列方法现已为虚方法,以供 `SocketVoiceChannel` 重写

需要注意的是,受限于 KOOK API,语音频道内不支持通过 API 获取历史消息,无置顶消息功能,因此,语音频道上不支持调用
`IMessageChannel``GetMessagesAsync``GetPinnedMessagesAsync` 方法。

另外,语音频道在 API 层面支持操作 Topic 及 SlowModeInterval,但 KOOK 客户端暂无相关表现。

创建频道时不支持立即指定 `Topic``CreateTextChannelProperties` 中的 `Topic` 属性不生效,现已移除,
请在创建频道后调用 `ITextChannel.ModifyAsync` 方法进行修改。

### 新增

- 新增支持通过 XML 定义卡片消息
- `IVoiceChannel` 现已继承自 `ITextChannel`,相关实现已更新
- `BaseKookClient` 新增 `SentRequest` 事件
- 为卡片消息解析相关的 `Try*` 方法添加非空结果提示诊断

### 修复

- 修正 `ConnectionManager` 引发 `Disconnected``State` 不正确的问题

### 变更

- CreateTextChannelProperties 中的 Topic 属性已移除

### 其它

- 标记项目不支持 AOT 及程序集裁剪
- 新增示例项目 Kook.Net.Samples.CardMarkup
- 新增 XML 定义卡片消息的相关文档
- 新增 Logo

## v0.6.0 [2024-02-28]

### 更新路线
Expand Down

0 comments on commit 1f600a8

Please sign in to comment.