Skip to content

概述

提示

本文档内不含 MaaFramework Pipeline 等框架知识,您需要在阅读前有一定框架基础,此文档仅提供 MaaPipelineEditor (MPE) 的使用说明,请在自行初步尝试框架及 Pipeline 之后再继续阅读文档!

在查阅手册前,请先通过 快速上手 了解 MPE 的使用方法。

MPE 的核心是创建基于 Pipeline 连接的流程图 —— 连接与节点的集合,核心部分如下图所示:

文件与视口

上图即为一个视口,展示了 新建Pipeline2 文件的内容。

文件以视口作为载体,每个文件有一个单独的视口,分别包含了若干个节点与连接。

特别的,您需要区分以下描述的不同:

  • 文件:指包含了若干个节点与连接的视口
  • Pipeline:指被编译后的 JSON 代码
  • Pipeline 文件:同时指文件与编译后的 Pipeline,使用此描述时一般无所谓编译前后的形式
  • 协议:在没有其他定语时,指 Pipeline v2 协议

节点

MPE 包含了两种节点,且提供了一些快捷配置的模板,但基于不同端口的连接关系才是 MPE 真正神奇的地方。

节点包含了节点名、字段、端口三个部分,三者共同决定了一个 Pipeline 节点应该如何被编译。

提示

特别的,节点可以指 Pipeline 中的一组字段,也可以指 MPE 的一个节点组件。虽然其两者确实是一一对应的关系,但为了区分,在后续文档中,我们会将 Pipeline 的节点描述为“Pipeline 节点”,而将 MPE 节点组件直接描述为“节点”

连接

用于描述两个节点之间关系,分别对应了协议的 nextjump_backon_error 字段。

MPE 依据连接解析 Pipeline 与编译工作流。