脚本进阶教程 位置导航:首页 > 资料中心 > 脚本进阶教程
   API说明—脚本事件

● 向一个指定物体发送一个带参数的事件
● 在当前街区扫描是否存在指定类别和id的对象并在搜索成功时触发OnSensor事件
● 在当前基本地块扫描是否存在指定类别和id的对象并在搜索成功时触发OnSensor事件
● 在当前个人地块扫描是否存在指定类别和id的对象并在搜索成功时触发OnSensor事件
● 以指定id物体为中心扫描指定距离内的指定类别和id的对象并在搜索成功时触发OnSensor事件
● 扫描当前街区内指定类别指定个数的对象,并在字符串中返回id
● 扫描当前基本地块内指定类别指定个数的对象id,并在字符串中返回
● 扫描当前个人地块内指定类别指定个数的对象id,并在字符串中返回
● 以指定物体为中心扫描指定范围内指定类别指定个数的对象id,并在字符串中返回


向一个指定物体发送一个带参数的事件
函数:
int uSendEventToItem(eventId,itemId,value);
参数:
(1) event:字符串,事件类型。目前填写ONOBJINPUT。
(2) itemId:字符串,指定物体的id。
(3) value:字符串,同事件一起发送的参数。
返回值:
详见5.4返回值类型。
备注:
(1) 此api常和OnObjInput事件一起使用,用于脚本间的信息传递。
Eg:
(1) uSendEventToItem(ONOBJINPUT, "2251799816559832", "be careful!");
--向id为“2251799816559832”的物体上的脚本发送一个“ONOBJINPUT”类型的消息,同时发送参数“be careful!”。


在当前街区扫描是否存在指定类别和id的对象并在搜索成功时触发OnSensor事件
函数:
int uScan(groupType,id);
参数:
(1) groupType:整型,要扫描对象的类型。类型详见5.2对象类型。
(2) Id:字符串,指定对象的id。当填写为“NULL”时,只要扫描到有指定类型的对象,则搜索成功。
返回值:
详见5.4返回值类型。
备注:
(1) 此api常和OnSensor事件一起使用。
Eg:
(1) uScan(4, "NULL");
--扫描当前街区内是否存在物体,如有则返回扫描成功,并触发OnSensor事件。


在当前基本地块扫描是否存在指定类别和id的对象并在搜索成功时触发OnSensor事件
函数:
int uScanLandUnit(groupType,id);
参数:
(1) groupType:整型,要扫描对象的类型。类型详见5.2对象类型。
(2) Id:字符串,指定对象的id。当填写为“NULL”时,只要扫描到有指定类型的对象,则搜索成功。
返回值:
详见5.4返回值类型。
备注:
(1) 此api常和OnSensor事件一起使用。
Eg:
(1) uScanLandUnit(4, "NULL");
--扫描当前基本地块内是否存在物体,如有则返回扫描成功,并触发OnSensor事件。


在当前个人地块扫描是否存在指定类别和id的对象并在搜索成功时触发OnSensor事件
函数:
int uScanPersonalLand(groupType,id);
参数:
(1) groupType:整型,要扫描对象的类型。类型详见5.2对象类型。
(2) Id:字符串,指定对象的id。当填写为“NULL”时,只要扫描到有指定类型的对象,则搜索成功。
返回值:
详见5.4返回值类型。
备注:
(1) 此api常和OnSensor事件一起使用。
Eg:
(1) uScanPersonalLand(4, "NULL");
--扫描当前个人地块内是否存在物体,如有则返回扫描成功,并触发OnSensor事件。


 以指定id物体为中心扫描指定距离内的指定类别和id的对象并在搜索成功时触发OnSensor事件
函数:
int uScanPoint(groupType,id,range,itemId);
参数:
(1) groupType:整型,要扫描对象的类型。类型详见5.2对象类型。
(2) Id:字符串,指定对象的id。当填写为“NULL”时,只要扫描到有指定类型的对象,则搜索成功。
(3) range:浮点型,扫描距离,单位:米。距离不能超过一个街区。
(4) itemId:字符串,指定物体的id。
返回值:
详见5.4返回值类型。
备注:
(1) 此api常和OnSensor事件一起使用。
Eg:
(1) uScanPoint(4, "NULL",10, "2251799816559832");
--以id为“2251799816559832”的物体为中心,扫描10米范围内是否存在物体,如有则返回扫描成功,并触发OnSensor事件。


扫描当前街区内指定类别指定个数的对象,并在字符串中返回id
函数:
string uScanRet(groupType,num);
参数:
(1) groupType:整型,要扫描对象的类型。类型详见5.2对象类型。
(2) num:整型,返回的id数量。最大为16个。
返回值:
按街区扫描到的指定对象顺序记录“num”个对象id,并返回所有id的字符串。
备注:
(1) 此api不会触发OnSensor事件。
Eg:
(1) local ret = uScanRet(4,3);
uPrintf(string.sub(ret,1,16).. " "..string.sub(ret,17,32).. " "..string.sub(ret,33,48));
--返回当前街区扫描到的3个物体id,并输出。


扫描当前基本地块内指定类别指定个数的对象id,并在字符串中返回
函数:
string uScanRetLandUnit(groupType,num);
参数:
(1) groupType:整型,要扫描对象的类型。类型详见5.2对象类型。
(2) num:整型,返回的id数量。最大为16个。
返回值:
按基本地块内扫描到的指定对象顺序记录“num”个对象id,并返回所有id的字符串。
备注:
(1) 此api不会触发OnSensor事件。
Eg:
(1) local ret = uScanRetLandUnit(4,3);
uPrintf(string.sub(ret,1,16).. " "..string.sub(ret,17,32).. " "..string.sub(ret,33,48));
--返回当前基本地块扫描到的3个物体id,并输出。


扫描当前个人地块内指定类别指定个数的对象id,并在字符串中返回
函数:
string uScanRetPersonalLand(groupType,num);
参数:
(1) groupType:整型,要扫描对象的类型。类型详见5.2对象类型。
(2) num:整型,返回的id数量。最大为16个。
返回值:
按基本地块内扫描到的指定对象顺序记录“num”个对象id,并返回所有id的字符串。
备注:
(1) 此api不会触发OnSensor事件。
Eg:
(1) local ret = uScanRetPersonalLand(4,3);
uPrintf(string.sub(ret,1,16).. " "..string.sub(ret,17,32).. " "..string.sub(ret,33,48));
--返回当前个人地块扫描到的3个物体id,并输出。


以指定物体为中心扫描指定范围内指定类别指定个数的对象id,并在字符串中返回
函数:
string uScanRetPoint (groupType,num,range,itemId);
参数:
(1) groupType:整型,要扫描对象的类型。类型详见5.2对象类型。
(2) num:整型,返回的id数量。最大为16个。
(3) range:浮点型,扫描距离,单位:米。距离不能超过一个街区。
(4) itemId:字符串,指定物体的id。
返回值:
按指定物体为中心制定范围内扫描到的指定对象顺序记录“num”个对象id,并返回所有id的字符串。
备注:
(1) 此api不会触发OnSensor事件。
Eg:
(1) local ret = uScanRetPoint(4,3,10, "2251799816559832");
uPrintf(string.sub(ret,1,16).. " "..string.sub(ret,17,32).. " "..string.sub(ret,33,48));
--以id为“2251799816559832”的物体为中心,返回10米范围内扫描到的3个物体id,并输出。

.
公司介绍  |  由我博客  |  招聘信息  |  商务合作 |  媒体合作  |  联系我们  |  新浪微博  |  开心多尼
优万科技(北京)有限公司 版权所有 京ICP证08336号 ISBN 978-7-900648-32-7 《网络文化经营许可证》编号:文网文[2009]076号 新出网证(京)字099号
Copyright (C)2007-2010 UOneNet CO., LTD. All Rights Reserved.