# 海龟函数(2/2)

在源码编辑器中使用海龟函数即可连接海龟编辑器，由海龟编辑器负责处理数据及返回结果，源码编辑器负责调用数据及运行结果。

用户可使用Python语言定义源码积木，实现源码编辑器和海龟编辑器的联合互通。

# 一、使用要求

# 1、源码编辑器

浏览器：谷歌chrome64版本以上
（360等浏览器都不行哦）

设备环境：网页端（PC客户端功能开发中）

# 2、海龟编辑器

设备环境：客户端最新版v0.8.3以上

# 二、执行函数

• 执行类型积木，可直接触发海龟编辑器中设定好的函数内容。

• # 如何控制海龟编辑器的函数运行？

• # 第一步：定义函数（函数名称必须一致）

源码编辑器：定义海龟函数，作为发送的指令

海龟编辑器：定义相同命名的函数，作为接收的事件

• # 第二步：启动Kitten Server

在海龟编辑器上，选择 设置>工具>启动Kitten Server，保持在Server运行的状态

• # 第三步：调式程序

源码编辑器：点击开始，执行海龟函数，触发海龟编辑器相应函数执行

海龟编辑器：开始执行函数内的指令

# 三、获取返回值积木

• 输出类型积木，可用于调取海龟编辑器中对应函数的内容。

• # 如何将海龟编辑器的返回值传输到源码编辑器？

• # 第一步：定义函数（函数名称必须一致）

源码编辑器：定义海龟函数，获取返回值；

海龟编辑器：定义相同命名的函数，末尾返回字符串。

• # 第二步：调式程序

源码编辑器：点击开始，执行海龟函数，触发海龟编辑器相应函数执行，获取返回值；

海龟编辑器：开始执行函数内的指令，将返回值传输到源码编辑器。

# 四、获取带参数的返回值

• # 如何将带参数的返回值传输到源码编辑器？

• # 第一步：定义函数（函数名称必须一致）

源码编辑器：定义海龟函数，点击“+”按钮添加参数，作为输入值

海龟编辑器：定义相同命名的函数，点击“+”按钮添加参数，末尾返回数值

• # 第二步：调式程序

源码编辑器：点击开始，执行海龟函数，触发海龟编辑器相应函数执行，输入参数222

海龟编辑器：开始执行函数内的指令，将运算结果“666”返回到源码编辑器

# 五、具体案例

掌握了基本用法后，通过2个案例来了解下具体用法。

• # 制作图灵机器人

1、在海龟编辑器中定义一个[图灵机器人]函数

定义函数后，编写相应代码，最后记得要return，返回数据,否则源码编辑器无法收到内容。

2、在源码编辑器中同样定义一个[图灵机器人]函数

根据自己的需求编写脚本积木

3、运行

源码编辑器：询问并获得答复，作为参数传输到海龟编辑器

海龟编辑器：调用图灵机器人的接口，匹配参数，返回相应的值到源码编辑器

• # 天气

1、在海龟编辑器中定义一个[天气]函数

2、在源码编辑器中同样定义[天气]函数

3、运行

源码编辑器：询问并获得答复，作为参数传输到海龟编辑器；

海龟编辑器：调取天气库，匹配参数，返回相应的值到源码编辑器。

# 六、注意事项

• # 常见错误

# 1.函数名不匹配

源码编辑器与海龟编辑器中，定义的函数名称必须一致。

注意：函数不支持数字命名

# 2、函数参数不匹配

海龟编辑器中未设置参数，源码编辑器设置了，则报错。

海龟编辑器中设置了参数，而源码编辑器未设置，则报错。

• # 特殊规则

# 1、调用多个函数

当源码编辑器调用多个海龟函数时，必须等一个函数执行完毕后才会继续执行下一个函数。

• 比如：

海龟函数“等待”执行，等待2秒，执行完毕，

对话积木执行，调用海龟函数“b”。

# 2、返回多个值

当海龟编辑器返回多个值的时候，源码编辑器以元组类型（如图）展现

# 3.函数没有返回值时

如果在海龟编辑器中，函数没有设定返回值时，

则在源码编辑器中返回NaN。

# 4、存在同名函数时

当在海龟编辑器中存在多个同名函数时，以海龟编辑器后定义的函数输出结果为准，后面的函数会覆盖前面的。