| API说明—脚本控制 |
● 设置当前脚本是否需要验证
● 停止脚本所在物体上的所有脚本运行
● 获得当前日期,年月日时分秒
● 获得指定物体指定脚本栏的脚本状态
● 重设脚本计时器
● 输出字符串信息到调试信息里
● 停止当前脚本执行
● 改变脚本状态
● 设置指定人物指定事件槽的触发事件指向脚本所在物体
设置当前脚本是否需要验证
函数:
int uSetControlCheck(check);
参数:
(1) check:8位整型,填写0或1,0不需要验证,1需要验证。如在本脚本中使用uSetControlCheck(1)则只有脚本拥有人才能使用脚本,通过其他脚本远程执行无效。
返回值:
详见5.4返回值类型。
备注:
(1) 此api需要触发后才能生效。
Eg:
(1) uSetControlCheck(1);
--设置只有脚本拥有人才能使用脚本,且不能使用其它脚本远程控制。
停止脚本所在物体上的所有脚本运行
函数:
int uStopFSM();
返回值:
详见5.4返回值类型。
Eg:
(1) uStopFSM();
--停止物体上所有脚本运行。
获得当前日期,年月日时分秒
函数:
int uGetDate();
返回值:
当前时间。
备注:
(1) 此api返回的是服务器当前时间。
Eg:
(1) local date = uGetDate();
uPrintf(date);
--将当前时间赋值给date,输出date的值。
获得指定物体指定脚本栏的脚本状态
函数:
int uGetScriptState(itemId,pos);
参数:
(1) itemId:字符串,目标物体id。
(2) pos:整型,目标物体的脚本栏号,1-4。
返回值:
脚本栏脚本的当前执行状态和在此状态时间,返回字符串中用空格分隔开了状态名和时间,时间用毫秒计算。
Eg:
(1) local state = uGetScriptState(uGetItemId(),2);
uPrintf(state);
--将脚本栏第二栏位的脚本当前执行状态和状态时间赋值给state,输出state的值。
重设脚本计时器
函数:
int uResetScriptTimer();
返回值:
详见5.4返回值类型。
Eg:
(1) uResetScriptTimer();
--重新开始脚本状态计时器计时。
输出字符串信息到调试信息里
函数:
int uPrintf(info);
参数:
(1) info:字符串,输出内容。
返回值:
详见5.4返回值类型。
Eg:
(1) uPrintf("今天天气不错");
--输出“今天天气不错”到调试信息里。
停止当前脚本执行
函数:
int uStopScript();
返回值:
详见5.4返回值类型。
Eg:
(1) uStopScript();
--停止当前脚本执行。
改变脚本状态
函数:
int uTransState(nextState);
参数:
(1) nextState:字符串,改变成的目标状态。
返回值:
详见5.4返回值类型。
Eg:
(1) uTransState("state2");
--进入当前脚本“state2”状态。
设置指定人物指定事件槽的触发事件指向脚本所在物体
函数:
int uSetPlayerEvent(playerId,int eventPos);
参数:
(1) playerId:字符串,目标用户id。如果不填则默认为执行脚本的用户。
(2) eventPos:整型,事件槽id,角色身上共有0-7八个事件槽。
返回值:
详见5.4返回值类型。
备注:
(1) 此api目前只用于触发键盘响应事件。角色身上共有0-7八个事件槽,此api作用将脚本所在物体绑定至对应人物的指定事件槽。当某人物触发小键盘数字键后,如物体关心键盘触发事件且已和该人物事件槽绑定,则物体会收到小键盘消息。未进行绑定的物体不受人物小键盘数字键的操作。
Eg:
(1) uSetPlayerEvent(uGetToucherId(),0);
--待测试。