forked from bot/app
74 lines
2.4 KiB
Markdown
74 lines
2.4 KiB
Markdown
|
---
|
|||
|
|
title: 轻雪函数
|
|||
|
|
icon: code
|
|||
|
|
order: 2
|
|||
|
|
category: 开发
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## **轻雪函数**
|
|||
|
|
|
|||
|
|
轻雪函数 Liteyuki Function 是轻雪的一个功能，它允许你在轻雪中运行一些自定义的由数据驱动的命令，类似于Minecraft的mcfunction，属于资源包的一部分，但需单独起篇幅.
|
|||
|
|
|
|||
|
|
### **函数文件**
|
|||
|
|
|
|||
|
|
函数文件放在资源包的`functions`目录下，文件名以`.mcfunction` `.lyfunction` `.lyf`结尾，例如`test.mcfunction`，文件内容为一系列的命令，每行一个命令，支持单行注释`#`(编辑时的语法高亮可采取`shell`格式)，例如：
|
|||
|
|
|
|||
|
|
```shell
|
|||
|
|
# 在发信器输出"hello world"
|
|||
|
|
cmd echo hello world
|
|||
|
|
|
|||
|
|
# 如果你想同时输出多行内容可以尝试换行符(Python格式)
|
|||
|
|
cmd echo hello world\nLiteyuki bot
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
也支持句末注释，例如：
|
|||
|
|
```shell
|
|||
|
|
cmd echo hello world # 输出"hello world"
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### **命令文档**
|
|||
|
|
|
|||
|
|
```shell
|
|||
|
|
var <var1=value1> [var2=value2] ... # 定义变量
|
|||
|
|
cmd <command> # 在设备上执行命令
|
|||
|
|
api <api_name> [var=value...] # 调用Bot API
|
|||
|
|
function <func_name> # 调用函数，可递归
|
|||
|
|
sleep <time> # 异步等待，单位s
|
|||
|
|
nohup <command> # 使用新的task执行命令，即不等待
|
|||
|
|
end # 结束函数关键字，包括子task
|
|||
|
|
await # 等待所有异步任务结束，若函数中启动了其他task，需要在最后调用，否则task对象会被销毁
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
|
|||
|
|
#### **示例**
|
|||
|
|
|
|||
|
|
```shell
|
|||
|
|
# 疯狂戳好友
|
|||
|
|
# 使用 /function poke user_id=123456 执行
|
|||
|
|
# 每隔0.2s戳两次，无限戳，会触发最大递归深度限制
|
|||
|
|
# 若要戳20s后停止，则需要删除await，添加sleep 20和end
|
|||
|
|
api friend_poke user_id=user_id
|
|||
|
|
api friend_poke user_id=user_id
|
|||
|
|
sleep 0.2
|
|||
|
|
nohup function poke
|
|||
|
|
await
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### **API**
|
|||
|
|
|
|||
|
|
理论上所有基于onebotv11的api都可调用，不同Adapter api也有差别.
|
|||
|
|
|
|||
|
|
[Onebot v11 API文档](https://283375.github.io/onebot_v11_vitepress/api/index.html)
|
|||
|
|
|
|||
|
|
### **结束关键字**
|
|||
|
|
|
|||
|
|
由于LiteyukiBot基于异步运行, 所以在编写lyfunction时也要注意异步的调用，避免出现"单线程走到底"的情况是效率提升的关键.
|
|||
|
|
|
|||
|
|
`await` 异步任务结束关键字，用于结束当前已完成function的执行
|
|||
|
|
|
|||
|
|
> [!warning]
|
|||
|
|
> 但若出现非单function的情况，有一个task任务没有完成而await被执行了，那么当前所有函数包的task都会被截停销毁
|
|||
|
|
|
|||
|
|
|
|||
|
|
> [!tip]
|
|||
|
|
> 编写轻雪函数推荐你使用VS Code插件[Liteyuki Function](https://github.com/LiteyukiStudio/lyfunctionTextmate)实现语法高亮
|