Skip to content

v2.0-RC-7
Compare
Choose a tag to compare
@Xwdit Xwdit released this 25 Jun 11:22
· 269 commits to main since this release
v2.0-rc-7
bead2ef

RainyBot版本 v2.0-RC-7 现已正式发布，此版本带来了对MacOS/Linux(暂未测试)平台的支持，新增了与群公告相关的各类API，新增对商城表情消息类型的支持，大幅简化了场景加载与图像生成相关的API，且支持异步并发的场景加载与图像生成，优化了资源重新导入的稳定性与速度，同时还带来了多个方面的细节改进与问题修复。建议所有用户均升级至此版本以获得最佳的开发与使用体验～

重要兼容性变更:

  • 此版本开始，大幅简化了场景加载与图像生成相关的API，场景默认进行异步加载且不再支持随插件进行热重载 (必须重启RainyBot来应用更改，可通过主菜单来快速重启)，并且移除了插件类中的所有的Viewport相关函数
  • 插件类中load_scene()函数的用法更改为：
## 加载一个场景文件，并根据第二个参数将其准备为用于图像捕捉或用于其他用途(如自定义GUI)，需要配合await关键字来使用此函数
##
## 注意：加载场景与根目录的相对路径必须与场景在原项目时所在的相对路径相同，且加载前请确保已重新导入所有资源(位于插件菜单中)，否则可能会加载失败或出现未知问题
## 例如，原项目中位于"res://plugins"的场景在加载时必须位于"RainyBot根目录/plugins"路径下
##
## 需要的参数从左到右分别为: 
## - 场景文件的路径，可以是相对路径(以res://开头)，也可以是绝对路径(如D:/RaintBot/plugins，可通过get_plugin_path()函数来获取插件目录的绝对路径)
## - 是否将加载的场景准备为用于图像捕捉 (可选，默认为false，必须启用才可使用get_scene_image()函数来获取其中内容的图像，否则会直接将其添加为插件的子项以便用于其他用途(如自定义GUI))
##
## 小贴士：出于性能原因，对已加载的场景或其附加脚本所做的的任何修改均无法通过重载插件来实时更新，因此在修改场景或其脚本后，请通过主菜单中的重新启动选项来快速重启RainyBot以便应用您所做的任何更改
func load_scene(path:String,for_capture:bool=false)->Node:
  • 原先用于获取Viewport图像的函数，更改为可以直接获取场景图像的get_scene_image()函数，用法为:
## 将指定场景实例中的当前内容获取为[Image]类图像的实例，需要配合await关键字来使用此函数
##
## 请确保指定的场景是通过load_scene()函数加载的，且加载时在函数中启用了for_capture参数，否则将无法正确获取其中的内容
##
## 需要的参数从左到右分别为: 
## - 需要从其中获取图像的场景实例，场景实例需要满足上述条件才能被正确获取为图像
## - 要生成的图像的原始大小，这决定了场景的内容将会以何种分辨率渲染为图像
## - 图像生成后要拉伸到的大小(可选，默认为Vector2i(0,0))，若设置为大于0的值，则将基于第二个参数的大小渲染图像，并将渲染后的图像拉伸为此参数指定的大小
## - 设置生成的图像是否启用透明背景(可选，默认为false)。若启用透明背景，则场景中任何拥有透明度的位置在获取的图像中将拥有同样的透明度，空白的位置在获取的图像中将完全透明
func get_scene_image(scene:Node,size:Vector2i,stretch_size:Vector2i=Vector2i.ZERO,transparent:bool=false)->Image:

更新日志:

  • 新增了了对MacOS/Linux(待测试)平台的支持，对应平台的发行包将在稍后于此页面中更新
  • 新增了与群公告相关的各类API，可前往GroupAPI的Group类与GroupAnnounce相关类中查看详情
  • 新增对商城表情消息类型的支持，目前仅支持读取与转发，暂不支持手动构造发送，可前往MessageAPI/Types/MarketFaceMessage.gd下查看相关API
  • 大幅简化了场景加载与图像生成相关的API，详情请查看上方“重要兼容性变更”处所述的内容
  • 支持异步并发的场景加载与图像生成，可以在每次不同的请求中异步创建独立的场景并进行独立的图像生成，即多个场景加载与图像生成可以同时进行且互不干扰
  • 优化了资源重新导入的稳定性与速度，提升了对不同平台下的兼容性
  • 其余各项细节的改进与修复，若要查看更详细的更新内容，请参阅Commits更改日志

更新说明:

  • 此版本包含了增量更新包(文件名以-update结尾)，以及与以往相同的完整发行包(文件名以-full结尾)
  • 若您从v2.0-RC-4之前的版本更新，请删除RainyBot根目录/adapters/mirai/下除bots文件夹以外的所有内容，删除RainyBot根目录下的.pck(如果有)及.exe文件，删除Rainybot根目录下的project.godot(如果有)/project.binary(如果有)文件以及libs(如果有)和.godot(如果有)文件夹，随后下载完整发行包并用其中所有内容直接覆盖旧版本文件即可。
  • 若您从v2.0-RC-4或之后的版本更新，请删除Rainybot根目录下的project.godot文件以及libs文件夹，随后下载增量更新包并将其中的所有内容放置在RainyBot根目录下即可

国内下载镜像(坚果云)：

Assets 4
0 Join discussion