diff --git a/_docs/event.md b/_docs/event.md index cdef9c0a..461b2c9c 100644 --- a/_docs/event.md +++ b/_docs/event.md @@ -2244,6 +2244,26 @@ core.insertAction([ !> 从V2.5.3开始,提供了一个"不自动执行下一个事件"的选项(`"async": true`)。如果设置了此项,那么在该部分代码执行完毕后,不会立刻执行下一个事件。你需要在脚本中手动调用`core.events.doAction()`来执行下一个事件。可以通过此项来实现一些异步的代码,即在异步函数的回调中再执行下一个事件。使用此选项请谨慎,最好向开发者寻求咨询。 +## 自动事件 + +从V2.6.4开始,提供了自动事件。每个点都可以绑定若干个自动事件,其类似于RM的事件页。 + +自动事件可以设置一个触发条件,当满足此条件时将自动执行。 + +![](img/autoEvent.png) + +自动事件可以设置如下几项内容: + +- 条件:当满足此条件时将自动执行 +- 优先级:当多个自动事件的条件同时满足时,将按照优先级从大到小执行;相同优先级的按照楼层和坐标排序。 +- 仅在本层检测:是否仅在本层检测该条件。 +- 事件流中延迟执行:如果此项为true,则若满足条件时正在事件流的处理中,则将该自动事件延迟到事件流结束时执行。 +- 允许多次执行:如果此项为true,则该自动事件允许被多次触发;否则只会被触发一次。值得注意的是,即使允许多次触发,也不允许在正在执行本自动事件时再触发。(即在执行本自动事件时将暂时禁用自身,直到执行完毕为止) + +自动事件的检测时机为刷新状态栏,即每次刷新状态栏时都会进行检测。 + +可以给自动事件加上【转变图块】,从而达到类似RM的多事件页并转变图块的效果 + ## 独立开关 从V2.5.3开始,针对每个事件都提供了独立开关。 diff --git a/_docs/img/autoEvent.png b/_docs/img/autoEvent.png new file mode 100644 index 00000000..06dd923e Binary files /dev/null and b/_docs/img/autoEvent.png differ