回顶部

AIS(指端精灵)开发工具文档

messagebox -消息框
函数名:
messagebox
消息框
函数描述: 显示信息到屏幕
函数原型:
messagebox(str)
消息框(字符串)
函数参数: str:要显示的字串
返回值:
脚本示例:

messagebox("hello Ais!")

getsdcardpath -获取SD卡路径
函数名:
getsdcardpath
获取sdcard路径
函数描述: 获取sdcard卡绝对路径
函数原型:
getsdcardpath()
获取sdcard路径()
函数参数:
返回值: 返回sdcard卡的绝对路径.
脚本示例:

local ret=getsdcardpath()
messagebox(ret)

rnd -取随机数
函数名:
rnd
随机数
函数描述: 获得指定范围内的一个随机数
函数原型:
rnd(min,max)
随机数(最小值,最大值)
函数参数: min:随机数最小数
max:随机数最大数
返回值: 返回[min,max]之内的一个随机数
脚本示例:

local ret=rnd(1,100)
messagebox(ret)

getrcpath -取资源路径
函数名:
getrcpath
获取资源路径
函数描述: 获取rc:(资源)路径的真实全路径(不会判断文件是否存在,只会转换当前资源路径返回)
函数原型:
getrcpath(rcpath)
获取资源路径(资源路径)
函数参数: rcpath: 资源文件路径(支持多路径用|线隔开)
返回值: 返回程序当前资源文件临时目录的全路径
脚本示例:

local path=getrcpath("rc:1.bmp")
messagebox(path)

sleep -延时
函数名:
sleep
延时
函数描述: 让程序进入一个短暂的延时等待(单位ms),超过时间才会返回
函数原型:
sleep(ms)
等待(毫秒)
函数参数: ms:程序等待的时间(单位ms)
返回值:
脚本示例:

Sleep(2000)

gettickcount --获取系统时间

注意:如果系统很长时间没有重启过,可能返回值为负值,解决方法如下: local lasttick = gettickcount() local timediff= tonumber(mabs(gettickcount() - lasttick)) 取绝对值(现在的系统经历时间 - 上次保存的时间)

函数名:
gettickcount
获取系统时间
函数描述: 获取系统从开机到现在所经历的时间(单位ms)
函数原型:
gettickcount()
获取系统时间()
函数参数:
返回值: 返回开机到现在的时间
脚本示例:

local ret=gettickcount()
messagebox(ret)

getrotatescreen -获取坐标体系
函数名:
getrotatescreen
获取坐标体系
函数描述: 根据重力感应系统获取坐标体系方向,模拟器不支持默认为0
函数原型:
getrotatescreen()
获取坐标体系()
函数参数:
返回值: 返回 0,以home键在下边为标准;1,以home键在右边为标准,2,以home键在左边为标准,3,以home键在上边为标准
脚本示例:

local ret = getrotatescreen()
messagebox(ret)

setrotatescreen -设置坐标体系
函数名:
setrotatescreen
设置坐标体系
函数描述: 改变坐标体系,影响模拟点击,图色,识字一系列操作,以屏幕实际旋转为准,如果屏幕没有旋转,强行设置坐标体系会引起部分操作出现错误(需要root权限)
函数原型:
setrotatescreen(type)
设置坐标体系(类型)
函数参数: type:默认参数为0,以home键在下边为标准,旋转0度;1,以home键在右边为标准,旋转-90度,2,以home键在左边为标准,旋转90度,3,以home键在上边为标准,旋转180度
返回值: 设置成功返回true,失败返回false
脚本示例:

setrotatescreen(1)
local x,y,ret
local path = getrcpath("rc:")
x,y,ret = findpic(0,0,2000,2000,path ,"宠物.bmp","000000",0.8,0)
if ret>-1 then
    tap(x,y)
end

traceprint -调试输出
函数名:
traceprint
调试输出
函数描述: 在输出栏,输出相应信息
函数原型:
traceprint(str)
调试输出(字符串)
函数参数: str:要输出的信息
返回值:
脚本示例:

traceprint("hello Ais")

logOpen -打开日志功能
函数名:
logOpen
打开日志
函数描述: 开启日志功能,日志将在悬浮窗设置窗口中的日志文件中显示,配合logEx(str)使用
函数原型:
logOpen()
打开日志()
函数参数:
返回值:
脚本示例:

logOpen()
logEx("指端精灵Ais")

logEx -记录日志功能
函数名:
logEx
记录日志
函数描述: 记录日志文件
函数原型:
logEx(str)
记录日志(日志文本)
函数参数: str:要记录的日志文本
返回值:
脚本示例:

LogOpen()
logEx("指端精灵Ais")

gettopactivity -获取顶层activity
函数名:
gettopactivity
获取顶层activity
函数描述: 获取当前窗口的activity名称
函数原型:
gettopactivity()
获取顶层activity()
函数参数:
返回值: 返回activity名称
脚本示例:

traceprint(gettopactivity())

getimei -获取imei
函数名:
getimei
获取imei
函数描述: 获取设备的唯一标识(使用过程中注意判断标识的真实性,此标识是有机率可以被修改的),某些平板可能会没有imei码,那么就会返回空字符串
函数原型:
getimei()
获取imei()
函数参数:
返回值: 返回设备标识字符串
脚本示例:

local info = getimei()
messagebox(info)