全局函数

callScript

执行移动端脚本中的main函数,其返回值为脚本的返回值。
属性:
属性名 类型 必填 说明
scriptName string 必填 移动端脚本名
params... object 选填 任意个参数,参数直接透传给脚本。

stop

停止执行脚本。
属性:
属性名 类型 必填 说明
refresh boolean 选填 停止后是否刷新界面,默认为true

getUserCustomData

获取用户自定义数据(在「管理中心」/「账户信息」"自定义数据"中设置值,每个子账户户可以单独设置该值,子账户之间相互独立),返回结果结果为string。
属性:
属性名 类型 必填 说明
key string 选填 返回键为key的值,默认key为空,表示返回所有数据

getCustomData

获取用户在「管理中心」/「自定义数据」中创建的全局数据项(这个数据项在其所有子账户中共享使用),返回结果结果为string。
属性:
属性名 类型 必填 说明
name string 必填 数据名

smartGetCustomData

先获取设备的自定义数据,如果有就返回,否则获取用户自定义数据,如果有就返回,否则获取全局自定义数据。返回结果结果为string。
属性:
属性名 类型 必填 说明
name string 必填 数据名

setCustomData

在移动端设置用户在「管理中心」/「自定义数据」中创建的全局数据项,返回结果结果为boolean(注意api不会自动创建不存在的自定义数据)。
属性:
属性名 类型 必填 说明
name string 必填 数据名
data string 必填 数据

sleep

等待一段时间。
属性:
属性名 类型 必填 说明
time integer 必填 延迟时间,单位毫秒

sendMessage

发送消息到客户端程序,可以用于显示引擎正在做的事情,比如:显示下载进度等,例:sendMessage('run_msg', '正在初始化对象...');。返回boolean值。(仅用于移动端脚本)
属性:
属性名 类型 必填 说明
消息id string 必填 消息的唯一标识,系统内置消息id「run_msg」,用于显示程序内部运行的信息。
params... object 选填 任意个参数

getAppName

通过包名获取已经安装的app的名称。返回string。(仅用于移动端脚本)
属性:
属性名 类型 必填 说明
packageName string 选填 默认为空,表示获取当前客户端的程序名。

getCurAppName

获取当前正在运行的app名称。返回string。(仅用于移动端脚本)
属性:
属性名 类型 必填 说明

prob

根据概率返回boolean值。
参数:
参数名 类型 必填 说明
probability integer 必填 0-100的整数,如果为30,表示概率为30%,如果落在30%内返回true,否则返回false

alert

显示警告框
参数:
参数名 类型 必填 说明
message object 必填 显示的内容

parseInt

解析字符串返回integer,或者将float转换成integer
参数:
参数名 类型 必填 说明
data string/float 必填 数据

parseFloat

解析字符串返回float,或者将integer转换成float
参数:
参数名 类型 必填 说明
data string/integer 必填 数据

parseBoolean

解析字符串返回boolean
参数:
参数名 类型 必填 说明
data string 必填 数据

setClipboardData

设置剪切板数据,返回boolean值
参数:
参数名 类型 必填 说明
data string 必填 数据

getClipboardData

获取剪切板数据
参数:
参数名 类型 必填 说明

toast

弹出框,可用于调试,或者显示信息(注意:toast可能会导致当前界面更新,所以尽量使用console.log()来代替toast)。当x>=0且y>=0时,按坐标来显示,否则显示在屏幕中央,
注意:左上角为(0, 0),x坐标向为正,y坐标向下为正。
参数:
参数名 类型 必填 说明
text string 必填 文本
duration integer 选填 toast持续时间,默认值1000,单位毫秒
x integer 选填 x坐标值,默认值-1,单位像素
y integer 选填 y坐标值,默认值-1,单位像素

digest

摘要算法,返回字符串
参数:
参数名 类型 默认值 说明
type string 必填 支持md5,sha-256,hmac-sha-256
str string 必填 字符串
secret string 选填 为hmac-sha-256时有效

startActivity

启动页面
例子,以下脚本表示显示桌面:
var intent = new Intent();
intent.setAction('android.intent.action.MAIN').addCategory('android.intent.category.HOME');
startActivity(intent);
                            
参数:
参数名 类型 默认值 说明
Intent intent 必填 用于描述启动哪个页面
intent对象支持如下函数(每个函数都返回当前intent对象):
函数名 参数 说明
setAction string 用于描述意图抽象动作
addCategory string 用于为action增加额外的类别信息
setData string 用于向action提供操作数据
setType string 设置数据类型
setClassName string,string 两个参数分别表示className和packageName

shell

shell,返回字符串
shell('cp /sdcard/aznfz/temp.txt /sdcard/aznfz/file.txt');
参数:
参数名 类型 默认值 说明
cmd string 必填 shell命令

enableWifi

enableWifi,开启或者关闭wifi,返回boolean
var ret = enableWifi(false);
参数:
参数名 类型 默认值 说明
enable boolean 必填 true表示开启wifi,false表示关闭wifi

getIp

获取当前设备的外网ip,返回字符串
var ret = getIp();
参数:
参数名 类型 默认值 说明

killBackgroundApp

杀掉后台app(注意:由于部分app加入了防杀掉功能,调用可能失败)
killBackgroundApp('com.xx.tt');
参数:
参数名 类型 默认值 说明
packageName string 必填 app对应的包名