使用手册 - Simple:从使用到开发：修订间差异
无编辑摘要 |
|||
| 第9行： | 第9行： | ||
下图为错误示范，由于开发项目时引用不规范，导致编译出很多无用的dll库文件，且直接放在Simple根目录下，有时会导致Simple启动时报错。 | 下图为错误示范，由于开发项目时引用不规范，导致编译出很多无用的dll库文件，且直接放在Simple根目录下，有时会导致Simple启动时报错。 | ||
[[ | [[Index.php?title=文件:2e1c582f8ddd429e798bbc9f3f7ef65.png|链接=文件:2e1c582f8ddd429e798bbc9f3f7ef65.png|无框|600x600像素]] | ||
==== 1.2 认识simple.json文件 ==== | ==== 1.2 认识simple.json文件 ==== | ||
| 第23行： | 第23行： | ||
==== 2.1 simple主界面 ==== | ==== 2.1 simple主界面 ==== | ||
如下图，为simple主界面，界面中的各个元素的功能如标注中所示。 | 如下图，为simple主界面，界面中的各个元素的功能如标注中所示。 | ||
[[文件:Cb0653332cab21edd407a7d9eb74773.png|无框|600x600像素]] | [[文件:Cb0653332cab21edd407a7d9eb74773.png|无框|600x600像素]] | ||
| 第67行： | 第68行： | ||
|队列动作 | |队列动作 | ||
|codeQueue:agv.Put();代表在此点发生路径切换时执行Put动作 | |codeQueue:agv.Put();代表在此点发生路径切换时执行Put动作 | ||
|- | |||
|站点 | |||
|routing | |||
|必经点 | |||
|参考使用手册-routing字段使用 | |||
|- | |||
|路径 | |||
|speed | |||
|该路径速度 | |||
|speed:1000，代表在此段路径上车辆速度切换为1000 | |||
|- | |||
|路径 | |||
|direction | |||
|该路径方向 | |||
|direction:1代表此段路径为单行道且只能正向，2代表反向，0不限制方向 | |||
|- | |||
|路径 | |||
|reverseDst | |||
|小车倒走 | |||
|reverseDst:2，代表从此点到id为2的点，小车需要倒退走 | |||
|} | |} | ||
2023年10月19日 (四) 11:03的版本
Simple：从使用到开发
1.认识simple
1.1 认识Simple根目录
下图是某项目的Simple根目录，其中SimpleComposer.exe为Simple的应用程序，simple.json为配置文件，根目录下的各种.dll库文件为依赖项，如本项目中用到AbstractChainDeliveryMission类，就引用自MDCSToolBox.dll中。其余json文件，如1510.json为Simple的工程文件。plugins文件夹下存储了工程师开发的当前场景的插件。
下图为错误示范，由于开发项目时引用不规范，导致编译出很多无用的dll库文件，且直接放在Simple根目录下，有时会导致Simple启动时报错。
链接=文件:2e1c582f8ddd429e798bbc9f3f7ef65.png|无框|600x600像素
1.2 认识simple.json文件
下图为simple.json文件中的内容，autoload代表了自动加载此工程文件，ip及port为simple监听的ip及端口。
1.3 加载simple插件
打开Simple文件夹，在Plugin里面会有工程师提供的当前场景的插件（默认名称AMRScene.dll），根据车型以及业务场景的不同，工程师会编写对应的插件，如果插件有更新，替换Simple/Plugins目录内AMRScene.dll即可。AMRScene.pdb为调试所用，可以简单的理解为，当程序异常或报错时，可以在控制台看到异常的程序在哪一行。
2.如何使用Simple
2.1 simple主界面
如下图，为simple主界面，界面中的各个元素的功能如标注中所示。
2.2 创建小车
如下图，点击车辆-添加，可以选择添加的小车类型，本地模拟可以添加模拟车，实际生产中需添加本项目车型。
添加车辆后，若为本地模拟，只需要设置速度，将速度填写在speed字段中；若为实际车辆，还需要填写ip地址，填写在address字段中。
2.3 创建站点和路径
如下图所示，点击场景-添加，即可添加站点和路径，首先添加站点，添加路径时需要将站点连接起来。
2.4 添加/修改站点、路径字段
如下图所示，选中站点或路径时，可以看到添加的字段。字段需要根据程序中所写的内容进行添加。
simple中内置了很多字段，如下表
| 字段类型 | 字段名称 | 字段含义 | 举例 |
|---|---|---|---|
| 站点 | mustFree | 必空点 | 给某个点设置mustFree:[1,2,3]，代表此站点被锁时，id为1、2、3的站点不允许被其它点锁定 |
| 站点 | codeArrive | 到达此点动作 | codeArrive:agv.Put();代表到达此点后执行Put动作 |
| 站点 | codeLeave | 离开此点动作 | codeLeave:agv.Put();代表离开此点时执行Put动作 |
| 站点 | codeQueue | 队列动作 | codeQueue:agv.Put();代表在此点发生路径切换时执行Put动作 |
| 站点 | routing | 必经点 | 参考使用手册-routing字段使用 |
| 路径 | speed | 该路径速度 | speed:1000，代表在此段路径上车辆速度切换为1000 |
| 路径 | direction | 该路径方向 | direction:1代表此段路径为单行道且只能正向，2代表反向，0不限制方向 |
| 路径 | reverseDst | 小车倒走 | reverseDst:2，代表从此点到id为2的点，小车需要倒退走 |