2.6

docs/mconline/60-我的世界创造营教程/玩法组件进阶教程/2-逻辑编辑器基础/5-逻辑编辑器的基础概念（4）.md

@@ -0,0 +1,100 @@
+---
+front:
+hard: 进阶
+time: 20分钟
+---
+# 逻辑编辑器的基础概念（4）
+
+在学习使用了官方提供的各种零件接口和SDK接口之后，现在我们就可以尝试自己自定义一个接口啦。
+
+<iframe src="https://cc.163.com/act/m/daily/iframeplayer/?id=6328664ee6c041f2578ca804" width="800" height="600" allow="fullscreen"/>
+
+## 什么是自定义接口
+
+在大型玩法开发中，我们会发现有时候很多地方都需要调用相同的功能，执行除了参数以外，几乎一样的逻辑节点。那么自定义接口就可以很好地解决这个问题，我们可以自定义一个接口，并且定义接口内部执行的逻辑节点。并且自由地调用它。这样可以极大地简化我们的逻辑代码。
+
+## 定义自定义接口
+
+在逻辑编辑器中，我们在左侧可以看到自定义接口一栏。在这里就可以创建一个自定义接口。
+
+![](./images/56.png)
+
+点击自定义接口右侧的加号，就可以创建一个自定义接口。然后修改其名字，我们这里改成`f_test`，需要注意，自定义接口必须以`f_`开头。
+
+并且在顶部可以看到`Graph > f_test`，代表我们正在编辑的接口。
+
+点击Graph即可返回到原来的编辑界面。双击左侧的自定义接口中的`f_test`，即可返回这个自定义接口的编辑。
+
+![](./images/57.png)
+
+我们可以在这里编写我们需要的逻辑，从In的输入处开始执行，直到输出处的Out，就退出自定义函数。
+
+自定义函数必须要从In到Out有一条完整的执行连线，否则无法正常工作。
+
+例如我们在这里循环从1打印到100，然后链接输出。
+
+![](./images/58.png)
+
+这样就完成了自定义接口的编辑。我们回到Graph界面。
+
+可以从左侧自定义接口中，选中`f_test`，并拖动到编辑界面中，就创建了一个节点调用我们的自定义接口。然后我们把它连接到服务端初始化之后来执行，查看日志窗口的输出效果。
+
+![](./images/59.png)
+
+![](./images/60.png)
+
+可以看到像预期一样，从1打印到了100。
+
+## 自定义接口的参数
+
+自定义接口如果只是能像刚刚所做的那样，能把一部分节点，封装到一个接口中，进行调用，就会显得很死板，因为其中的值都被固定。
+
+遇到这种情况，我们就可以给它创建一个参数，在外部调用这个接口的时候，将参数带入接口，就可以让这个接口的实用性大大提高。
+
+![](./images/61.png)
+
+在左侧自定义接口选中了要编辑的自定义接口后，右侧属性面板就会出现相应的配置。可以看到有一个`inputParams`栏，还有一个`outputParams`栏。
+
+我们可以在这里新增输入和输出参数，让它在运行前传入一些值，在运行结束后，再传出一些值。
+
+假如还是刚才的循环的自定义接口，我们希望传入参数，指定它从1循环到多少，我们就可以新增一个`inputParams`，点击加号新增。
+
+如果我们还需要这个接口将某个运算结果传递回来，也可以新增一个`outputParams`，作为返回值。
+
+![](./images/62.png)
+
+我们这里先新增一个输入参数，定义它的名字为`循环到`，类型为`int`，然后再次回到自定义接口编辑处。就可以看到输入的节点多了一个循环到的端口，我们可以将它进行对应的参数传递，来达到预期的效果。
+
+![](./images/63.png)
+
+这样我们就可以在自定义接口外部定义需要循环多少次。现在就可以输入需要循环到的数字。
+
+![](./images/64.png)
+
+## Python模块
+
+除了逻辑编辑器已经提供的接口外，我们还可以直接调用Python的内置模块，来实现更强大的功能。
+
+![](./images/65.png)
+
+细心的同学可能早就发现了，在我们的编辑器中，还有一个内置Python接口的分类，在这里可以调用一些Python提供的接口，例如对列表和字典的工具函数。
+
+具体使用方法可以查阅Python的函数文档。
+
+## 课后作业
+
+在`实体受到伤害`事件中，利用自定义接口 定义`实体标识符`、`手持物品名称`、`物品列表`三个参数，并重新实现攻击实体会随机掉落物品列表内的物品`的逻辑。
+
+### 操作步骤
+
+首先我们需要新建一个自定义接口，这里叫做`f_dropRandomItem`，并给它定义3个输入参数，物品列表的类型应该为list，但是这里并没有列出list，所以选择Any代表任意。
+
+![](./images/66.png)
+
+接下来我们可以把部分之前已经编写过的逻辑节点，复制到自定义接口中。然后对其连线进行调整。最后的效果如图:
+
+![](./images/67.png)
+
+完成配置后，再回到Graph中，直接将随机生成掉落物的逻辑节点，替换成调用自定义接口就可以了。
+
+![](./images/69.png)