monkey script 用法和相关参数

前言：作者做为一个monkeyscript脚本的初次使用者，在写monkeyscript时发现很多资料讲解的不是很全，因此做比较全面的整理。有不对的地方多多指正，QQ：461087346

写monkeyscript的目的在于通过脚本实现一些有规律的操作，monkey是随机的事件操作无规律可以进行，虽然有随机种子，但是随机种子只能重复上次进行的步骤执行，不能进行有规律有计划的操作。

monkey script的事件操作

1.点击事件（DispatchPointer）

DispatchPointer用于向一个执行的坐标位置发送单个手势消息，一般用户模拟点击的操作

DispatchPointer具体的参数为：

DispatchPointer ( downTime , eventTime , action , x , y , pressure , size , metaState , xPrecision , yPrecision , device , edgeFlags)

每个参数的定义如下

 long downTime //键最初被按下的时间 

 long eventTime //事件发生的时间 

 int action //（ACTION_DOWN=0，ACTION_MOVE=1，ACTION_UP=2，ACTION_CANCEL=3） 

 float x //x坐标 

 float y //y坐标 

 float pressure //当前事件的压力，范围0-1 

 float size //触摸的近似值，范围0-1 

 int metaState //当前按下的meta键的标识 

 float xPrecision //x坐标精确值 

 float yPrecision //y坐标精确值 

 int device //事件来源，范围0-x，0表示不来自物理设备 

 int sedgeFlags // 

点击事件中最常用的参数只有三个action，x，y，其中action中数字0代表按下，1代表抬起最为常用。参数中的其他参数都是设置为默认的为0。

2.按键事件（DispatchKey）

DispatchKey 主要发送Android一些标准的EventKey（事件键值）按键消息，需要输入指定的对应code码

DispatchKey具体参数如下：

DiapatchKey ( downTime ,eventTime ,action ,code ,repeat ,metaState ,device ,scancode)

每个参数定义如下

 long downTime //键最初被按下的时间 

 long eventTime //事件发生的时间 

 int action //（ACTION_DOWN=0，ACTION_UP=1，ACTION_MULTIPLE=2） 

 int code //键值，比如KEYCODE_DPAD_DOWN（20） 

 int repeat // 重复次数

 int metaState //当前按下的meta键的标识 

 int device //事件发生的设备id 

 int scancode // 

按键事件同点击事件一样只需要关注的参数是action，code，repeat三个参数，action同样是0代表按下，1代表抬起。其余的参数可以设置成默认参数0。

3.轨迹球事件（DispatchTrackball）

DispatchTrackball 主要用于向一个指定位置发送单个轨迹球消息。

DispatchTrackball(long downtime,long eventtide,int action,float x,float y,float pressure,float size,int metastate,float xprecision,float yprecision,int device,int edgeflags)

每个参数的定义如下

long downtime//指键最初被按下的时间

long eventtide//指事件发生的时间

int action//指具体操作的动作，如按下

float x,float y//指x和y的坐标

float pressure//压力事件的大小（0~1）

float size//指触摸的记事值（0~1）

int metastate//指当前按下mate键的标识

int device//事件的来源（0~x）

float xprecision，float yprecision//指x和y坐标的精确值

int edgeflags//指超出屏幕了范围

其中参数中action：0代表按下，1代表弹起；最常用的参数是action，x，y。

4.拖拽（Drg）

Drg用户模拟一个按钮拖拽

Drag( xStart, yStart, xEnd, yEnd, stepCount)

具体参数如下

xStart, yStart//拖拽的起点位置坐标

xEnd, yEnd//拖拽的终点位置坐标

stepCount//拖拽的事件

注：stepCount拖拽的事件是指有多少个小事件，小事件数目越多操作越连贯

5.缩放事件（PinchZoom）

PinchZoom用于模拟缩放（两指头操作）

PinchZoom( pt1xStart, pt1yStart, pt1xEnd, pt1yEnd, pt2xStart, pt2yStart, pt2xEnd, pt2yEnd, stepCount)

具体参数如下

pt1xStart, pt1yStart//开始的坐标位置1

pt1xEnd, pt1yEnd//结束的坐标位置1

pt2xStart, pt2yStart//开始的坐标位置2

pt2xEnd, pt2yEnd//结束的坐标位置2

stepCount//事件

其中stepCount设置事件多少次完成缩放

6.手指单击事件（Tap）

Tap用于模拟手指一次单机事件

Tap(x,y,tapDuration)

具体参数如下

x,y//为坐标参数

tapDuration//时间

注：tapDuration时间长了可以模拟长按

7.长按事件（LongPress）

LongPress（）

LongPress 命令用于模拟长按时间，标准为长按 2s 。它是一个无参的方法，直接调用即可

8.长按（消息）事件（PressAndHold）

PressAndHold用于模拟一个长按时间

PressAndHold( x, y, pressDuration)

参数定义如下

x，y//坐标位置

pressDuration//时间

和 LongPress 类似，但是它是可以定制长按时长的

9.唤醒设备并解锁设备（DeviceWakeUp）

DeviceWakeUp（）

DeviceWakeUp 命令可以唤醒设备，并进行解锁。当然需要是一个无加密的设备才可以，有数字密码或者图形密码，都会导致失败。

10.等待5s时间（ProfileWait）

ProfileWait（）

ProfileWait已经设定好等待的时长，就是 5s ，直接调用即可

11.等待事件（UserWait）

UserWait（sleepTime）

参数定义如下

sleepTime//参数单位为毫秒

UserWait 命令用于让脚本中断执行一段时间。因为是脚本执行，多个事件之间执行的速度会非常的快，有时候我们需要等待一些事件触发之后的结果返回，需要等待一段时间之后，再继续执行脚本。

12.输入字符串时间（DispatchString）

DispatchString用于向 Shell 输入一个字符串

DispatchString( input )

参数定义如下

input//输入字符串参数

注：MS 对中文的支持并不好，所以尽量输入英文的测试数据

13.运行shell命令（RunCmd）

RunCmd 命令用于在设备上运行 shell 命令。当然这些 shell 命令必须是当前待测试设备支持的 shell 命令

RunCmd ( cmd )

参数定义如下

cmd//需要执行的shell命令

14.键盘事件（DispatchPress）

DispatchPress 命令用于模拟敲击键盘的事件

DispatchPress( keyName )

参数定义如下

keyName//键盘上名字（见下键盘对应表）

15.软键盘开关（DispatchFlip）

DispatchFlip用于打开或者关闭软键盘

DispatchFlip (keyboardOpen)

参数定义如下

keyboardOpen//布尔值

16.旋转屏幕（RotateScreen）

RotateScreen用于发送旋转测试设备屏幕事件

RotateScreen ( rotationDegree , persist)

参数定义如下

rotateDegree//旋转的角度。

persist//是否保持旋转前的状态。0 为不保持，1 为保持

注：旋转的角度只能是90的倍数，只有4个角度可选。

17.启动Activity（LaunchActivity）

如果未进行设置，可以手动打开appLaunchActivity用于打开任意应用的一个页面，但是前提条件是打开的Activity 需要属性 android:exported 被设定为true，才可以通过 LaunchActivity 打开

如果未进行设置，可以手动打开app

LaunchActivity ( pkg_name , act_name )

参数定义如下

pkg_name//启动的app名字

act_name//打开的 Activity 的名称

 

======键盘对应值摘自https://blog.csdn.net/letsstudy/article/details/89077389

字母和数字键的键码值(keyCode)
按键	键码	按键	键码	按键	键码	按键	键码
A	65	J	74	S	83	1	49
B	66	K	75	T	84	2	50
C	67	L	76	U	85	3	51
D	68	M	77	V	86	4	52
E	69	N	78	W	87	5	53
F	70	O	79	X	88	6	54
G	71	P	80	Y	89	7	55
H	72	Q	81	Z	90	8	56
I	73	R	82	0	48	9	57

　　

数字键盘上的键的键码值(keyCode)				功能键键码值(keyCode)
按键	键码	按键	键码	按键	键码	按键	键码
0	96	8	104	F1	112	F7	118
1	97	9	105	F2	113	F8	119
2	98	*	106	F3	114	F9	120
3	99	+	107	F4	115	F10	121
4	100	Enter	108	F5	116	F11	122
5	101	-	109	F6	117	F12	123
6	102	.	110
7	103	/	111

　　

控制键键码值(keyCode)
按键	键码	按键	键码	按键	键码	按键	键码
BackSpace	8	Esc	27	Right Arrow	39	-_	189
Tab	9	Spacebar	32	Dw Arrow	40	.>	190
Clear	12	Page Up	33	Insert	45	/?	191
Enter	13	Page Down	34	Delete	46	`~	192
Shift	16	End	35	Num Lock	144	[{	219
Control	17	Home	36	;:	186	\|	220
Alt	18	Left Arrow	37	=+	187	]}	221
Cape Lock	20	Up Arrow	38	,<	188	'"	222

 

多媒体键码值(keyCode)
按键	键码	按键	键码	按键	键码	按键	键码
音量加	175
音量减	174
停止	179
静音	173
浏览器	172
邮件	180
搜索	170
收藏	171