关闭TARS
# TaskRunner 自定程序 - 关闭TARS
# 1. 说明
- 任务运行器 TaskRunner 通过自定程序，呼叫 TARS 执行关闭的操作。
- 自定程序的运行依赖于 TARS ，请在安装 TARS 后执行后续操作。以下假设 TARS 安装于默认目录
C:\Program Files\IsoFace\TARS。
# 2. 设计程序
TaskRunner 的初始示例已包含 关闭TARS 自定程序。下面介绍创建自定程序的流程。
- 点击
自定程序选项卡，在自定程序界面中点击新建按钮，打开新建程序界面。 - 在新建程序界面，填写要设计的自定程序的基本信息。如下图所示。填写完成点击
保存按钮。
- 返回自定程序列表界面，选择刚才创建的
JS007自定程序，点击菜单栏中的设计按钮，打开程序设计器界面。 - 在程序设计器界面中输入自定程序代码，代码示例如下。完成后，点击
保存按钮。
{
//结束TARS进程
UGCM.KillTask("TARS.exe");
}
1
2
3
4
2
3
4
- 如需要测试效果，可在程序设计器界面中点击
运行按钮进行测试。本机的 TARS 如处在运行状态，则会结束名称为TARS.exe的进程。
# 3. 调用执行
设计完成的自定程序可使用以下方式来调用执行。
# 3.1. RestAPI
使用浏览器或RestAPI 客户端，访问以下地址，执行自定程序调用。请将 {ip} 修改为运行 TaskRunner 主机的IP地址，{port} 修改为 TaskRunner WebSocket 服务端监听的地址。
http://{ip}:{port}?restapi=script&taskname=JS007
1
# 3.2. WebSocket
使用WebSocket客户端，连接至 TaskRunner 中的 WebSocket 服务端。向 WebSocket 服务端发送以下文本实现自定程序的调用。
{"action":"script","taskname":"JS007"}
1
# 3.3. MQTT
使用 MQTT 客户端，连接至 TaskRunner 连接的 MQTT 服务器。MQTT 客户端向 TaskRunner 订阅的主题发送以下文本实现自定程序的调用。
{"action":"script","taskname":"JS007"}
1
注意
TaskRunner 使用 MQTT 来结束 TARS 进程时， 连接的 MQTT 服务端如果为本机的TARS，运行过程中 MQTT 连接会丢失。建议使用其它 MQTT 服务来代替 TARS。