AAIS

1. AAIS 介绍

AAIS 是一种简化的脚本语言,该语言只支持在多控中心执行。目前支持英文、中文两种命令行格式。小语言写成的脚本,不需要指定任何的设备(device),脚本在所有多控中心勾选设备上执行。AAIS 依赖于 AAI 功能,命令行格式通常会使用 AAI 功能的 query,query 的相关功能可以参考 FindNode 文档,我们通常可以在 UI explorer 中快速获取 node 的 query 信息。目前支持如下命令:


2. 英文命令

2.1 longClick

命令介绍:长点击

命令格式 1:longClick query,例如 longClick “T:OK||D:right”

命令格式 2:longClick string,string 表示组件的 text 值,例如 longClick “OK”,他的作用等同于:longClick “T:OK”


2.2 click

命令介绍:点击

命令格式 1:click query,例如 click “T:OK||D:right”

命令格式 2:click string,string 表示组件的 text 值,例如 click “OK”,他的作用等同于:click “T:OK”


2.3 open

命令介绍:用于启动一个 app,参数通常是包名。如果设备处于 home 桌面,也可以通过关键字启动,关键字为 app 在桌面上的名字。

命令格式 1:open packagename,例如 open “com.sigma_rt.totalcontrol”

命令格式 2:open string,string 表示组件 app 在桌面的名字,例如 open “Total Control”


2.4 wait

命令介绍:等待某个组件出现,默认等待时间为5秒

命令格式1:wait query,timeout 其中 timeout 为 ms,例如:wait “T:OK”,10000

命令格式2:wait string,timeout,string 表示组件的 text 值,例如 wait “OK”,10000 ,他的作用等同于:wait “T:OK”,10000

命令格式3:wait query 这个时候默认等待时间是 5 秒

命令格式4:wait string 这个时候默认等待时间是 5 秒


2.5 text

命令介绍:在输入框中输入内容

命令格式1:text 输入内容,序号。其中,序号为 0 号输入框,从 0 开始排序,例如: text “hello word”,0 表示 0 号输入框中输入,也就是第 1 号

命令格式2:text 输入内容。没有跟序号时,表示 0 号输入框中输入


2.6 press

命令介绍:输入键码

命令格式1:press functionkey 输入功能键

支持如下功能按键:

  • ENTER 回车,例如 press ENTER
  • BACK 返回,例如 press BACK
  • HOME 主页,例如 press HOME
  • SPACE 空格,例如 press SPACE
  • SEARCH 搜索,例如 press SEARCH
  • BACK_SPACE 删除,例如 press BACK_SPACE
  • POWER 电源按键 ,例如 press POWER
  • TAB tab 按键,例如 press TAB

命令格式2:press keycode 直接输入字符,例如 press 1,表示输入 ”1”

命令格式3:press KeyCode,键码值,meta 值。Meta 表示是否按下 shift 按键。例如:press KeyCode,47,1 其中 47 位 q 的键码值,后面为 1,表示输入大写的 Q


2.7 find

命令介绍:滑动查找某个组件

命令格式 1:find query,滑动查找指定 query 的组件,例如 find “T:OK”

命令格式 2:find string,滑动查找 text 字段为指定字符串的 node,例如 find “OK”,作用等同于 find “T:OK”


2.8 exec

命令介绍:执行其他 AAIS 脚本

命令格式 1:exec 直接跟脚本名,例如 exec “text.tst”,会去搜索执行器下默认目录下的指定的 AAIS 文件并执行

命令格式 2:exec 绝对路径,例如:exec “C:\\abc.txt”


2.9 print

命令介绍:打印信息

命令格式: print string,例如 print “hello world”


2.10 swipe

命令介绍:滑动,参考 javascripts 一节滑动的相关介绍

命令格式: 格式举例 swipe "[[11,22,44],[22,33,55]]",每个中括号里面的,第一个值为 x 坐标,第二个值为y坐标,第三个值为延迟


2.11 restart

命令介绍:用于重启一个 app,参数通常是包名。如果设备处于 home 桌面,也可以通过关键字重启,关键字为 app 在桌面上的名字。

命令格式 1:restart packagename,例如 restart “com.sigma_rt.totalcontrol”

命令格式 2:restart string,string表示组件app在桌面的名字,例如restart “Total Control”


3. 中文命令

3.1 长点击

命令介绍:长点击

命令格式 1:长点击 query,例如 长点击 “T:OK||D:right”

命令格式 2:长点击 string,string 表示组件的 text 值,例如 长点击 “OK”,他的作用等同于:长点击 “T:OK”


3.2 点击

命令介绍:点击

命令格式 1:点击 query,例如 点击 “T:OK||D:right”

命令格式 2:点击 string,string 表示组件的 text 值,例如 点击 “OK”,他的作用等同于:点击 “T:OK”


3.3 启动

命令介绍:用于启动一个 app,参数通常是包名。如果设备处于 home 桌面,也可以通过关键字启动,关键字为 app 在桌面上的名字。

命令格式 1:启动 packagename,例如 启动 “com.sigma_rt.totalcontrol”

命令格式 2:启动 string,string 表示组件 app 在桌面的名字,例如启动 “Total Control”


3.4 等待

命令介绍:等待某个组件出现,默认等待时间为5秒

命令格式 1:等待 query,timeout 其中timeout 为 ms,例如:等待 “T:OK”,10000

命令格式 2:等待 string,timeout,string 表示组件的 text 值,例如 等待 “OK”,10000,他的作用等同于:等待 “T:OK”,10000

命令格式 3:等待 query 这个时候默认等待时间是 5 秒

命令格式 4:等待 string 这个时候默认等待时间是 5 秒


3.5 文本

命令介绍:在输入框中输入内容

命令格式 1:文本输入内容,序号,其中,序号为 0 号输入框,从 0 开始排序,例如,文本 “hello word”,0 表示 0 号输入框中输入,也就是第 1 号

命令格式 2:文本 输入内容, 没有跟序号时,表示 0 号输入框中输入


3.6 按键

命令介绍:输入键码

命令格式 1:按键 functionkey 输入功能键

支持如下功能按键:

  • ENTER 回车,例如:按键 ENTER
  • BACK 返回,例如:按键 BACK
  • HOME 主页,例如:按键 HOME
  • SPACE 空格,例如:按键 SPACE
  • SEARCH 搜索,例如:按键SEARCH
  • BACK_SPACE 删除,例如:按键 BACK_SPACE
  • POWER 电源按键 ,例如:按键 POWER
  • TAB tab按键,例如:按键TAB

命令格式 2:按键 keycode 直接输入字符,例如:按键 1,表示输入”1”

命令格式 3:按键 KeyCode,键码值,meta 值。Meta 表示是否按下 shift 按键。例如:按键 KeyCode,47,1 其中 47 位 q 的键码值,后面为 1,表示输入大写的 Q


3.7 查找

命令介绍:滑动查找某个组件

命令格式 1:查找 query,滑动查找指定 query 的组件,例如查找 “T:OK”

命令格式 2:查找 string,滑动查找 text 字段为指定字符串的 node,例如 查找 “OK”,作用等同于查找 “T:OK”


3.8 执行

命令介绍:执行其他 AAIS 脚本

命令格式 1:执行 直接跟脚本名,例如 执行 “text.tst”,会去搜索执行器下默认目录下的指定的 AAIS 文件并执行

命令格式 2:执行 绝对路径,例如:执行 “C:\\abc.txt”


3.9 打印

命令介绍:打印信息

命令格式: 打印 string,例如 打印 “hello world”


3.10 滑动

命令介绍:滑动,参考 javascripts 一节滑动的相关介绍

命令格式: 格式举例 滑动 "[[11,22,44],[22,33,55]]",每个中括号里面的,第一个值为 x 坐标,第二个值为 y 坐标,第三个值为延迟


3.11 重启

命令介绍:用于重启一个 app,参数通常是包名。如果设备处于 home 桌面,也可以通过关键字重启,关键字为 app 在桌面上的名字。

命令格式 1:重启 packagename,例如: 重启 “com.sigma_rt.totalcontrol”

命令格式 2:重启 string,string 表示组件 app 在桌面的名字,例如:重启 “Total Control”


4. AAIS 中文示例:test.tst

打印"执行开始"
启动"com.skype.rover"
延迟10000
点击"D:“联系人”选项卡"
延迟10000
等待"添加新的联系人"
点击"添加新的联系人"
延迟10000
文本"11111",0
按键BACK
找到"芳芳"
执行"提醒.tst"
滑动"[[10,10,10],[20,20,50]]"
打印"执行完成"
			

5. AAIS 英文示例:testnew.tst

open "com.sigma_rt.com"
click "T:OK" 
wait "T:好了"
text "aaaa",3
press ENTER
delay 10000
find "T:你好"
exec "abc.tst"
swipe "[[10,10,10],[20,20,50]]"
press "执行完成"
			

6. 如何执行:

第一步:在脚本目录下,创建一个 txt 的文本文件,然后将其扩展名由 txt 修改成 tst

第二步:在里面编辑您需要的内容

第三步:在多控执行器中进行执行

图片1.png

图片2.png

7. OBJ 脚本录制

功能介绍:可以根据组件信息进行录制

步骤:

1)进入多控中心并打开多控中心执行器

图片3.png

2)在执行器中进行OBJ方式录制

图片4.png

图片5.png

3)开始录制后,开始操作主控手机

图片6.png

4)录制完成后,保存

图片7.png