Monkeyrunner API(一)

上一篇 / 下一篇  2014-07-04 11:41:45 / 个人分类:Monkeyrunner

MonkeyRunner

 

string alert ( string message, string title, string okTitle)

当前程序运行过程中显示一个警告对话框。对话框是模态,因此该计划将暂停,直到用户点击对话框的按钮。

参数

message 在对话框中显示的消息。

title 对话框的标题。默认值是“Alert(警报)”。

okTitle 在对话框中的按钮显示的文本。默认值是“OK”。

 

integer choice (string message, iterable choices, string title)

显示当前程序运行过程的选项列表“对话框 对话框是模态,使程序暂停,直到用户点击对话框的按钮之一。

参数

message 显示在对话框的提示消息。

choices 一个Python迭代包含一个或多个显示为字符串的对象。建议的形式是一个字符串数组。

title 对话框的标题。默认的是“输入”。

返回

如果用户选择,并单击“确定”按钮,该方法返回的迭代器内的选择基于0的索引。如果用户点击“取消”按钮,该方法返回-1

 

void help (string format)

显示在Python的风格类似的monkeyrunner API参考 pydoc工具,使用指定的格式。

参数

format 在输出中使用标记格式。可能的值是“txt”为纯文本或“html”为HTML

 

string input (string message string initialValue, string title, string okTitle, string cancelTitle)

显示一个对话框,接受输入并返回到程序。对话框是模态,使程序暂停,直到用户点击对话框的按钮之一。

该对话框包含两个按钮,其中一个显示的okTitle的价值和其他cancelTitle价值。如果的用户点击okTitle的按钮,输入框的当前值返回。如果的用户点击cancelTitle的按钮,则返回一个空字符串。

参数

message 显示在对话框的提示消息。

initialValue 初始值显示在对话框中。默认是一个空字符串。

title 对话框的标题。默认的是“输入”。

okTitle 在okTitle按钮显示的文本。默认的是“OK”。

cancelTitle 在cancelTitle按钮显示的文本。默认是“cancel”。

返回

如果用户点击okTitle按钮,则该方法返回当前值对话框的输入框中。如果的用户点击cancelTitle的按钮,该方法返回一个空字符串。

 

void sleep ( float seconds )

暂停当前​​程序中指定的秒数。

参数

seconds 暂停的秒数。

 

MonkeyDevice waitForConnection (float timeout, string deviceId)

试图使之间的连接monkeyrunner后端和指定的设备或模拟器。

参数

timeout 等待连接的秒数。默认情况下是永远等待。

deviceId 一个正则表达式指定的设备或仿真器的序列号。请参阅主题 Android调试桥 的设备描述和仿真器的序列号。

返回

一个MonkeyDevice 设备或模拟器的实例。使用这个对象来控制和通信设备或模拟器。

MonkeyImage

使用 MonkeyDevice.takeSnapshot()创建一个新实例

string convertToBytes ( string format)

当前图像转换成特定的格式,并返回一个字符串 ,然后可以访问作为一个迭代的二进制字节。

参数

format 所需的输出格式。支持所有常见的栅格输出格式。默认值是“PNG(便携式网络图形)。

tuple getRawPixel (integer x, integer y)

返回单个像素在图像的位置(XY),作为一个元组整数的形式,(ARGB)。

参数

 

x 像素的水平位置,在左边方向的屏幕截图时0开始。

y 像素的垂直位置,方向的屏幕截图时顶部0开始。

返回

一个元组代表像素的整数形式(ARGB),其中aalpha通道值,RGB是红色,绿色和蓝色值,分别为。

tuple getRawPixelInt (integer x, integer y)

单个像素,在图像的位置(XY)返回一个整数。使用这种方法,以节约内存。

参数

 

x 像素的水平位置,在左边方向的屏幕截图时0开始。

y 像素的垂直位置,方向的屏幕截图时顶部0开始。

返回

 

ARgb值的像素为8位值组合成一个32位的整数,最左边的8位,R的最右边,等等。

MonkeyImage getSubImage (tuple rect)

创建一个新的MonkeyImage从当前图像的矩形选择的对象。

参数

 

RECT 一个元组(XYWH)指定选择。xy指定0的像素位置,选择左上角的角落。w指定区域的宽度,h指定的高度,像素为单位。

图像的方向是在截图时屏幕方向相同。

返回

一个新MonkeyImage的对象,包含选择。

boolean sameAs ( MonkeyImage otherImage, float percent )

比较这MonkeyImage对象到另一个对象,并返回比较的结果。%的参数指定两个图像是“平等”的百分比差异。

参数

other 另一个MonkeyImage对象这一个比较。

percent 在范围内的浮动0.01.0,包容,表示真正的需要,是该方法返回相同的像素的百分比 。默认为1.0,表明所有的像素必须匹配。

返回

布尔如果图像匹配,或者布尔值,否则返回false

void writeToFile (string filename, string format)

当前图像写入指定的文件名 ​​,在指定的格式格式。

参数

 

path 完全合格的文件名和输出文件的扩展。

format 使用的文件输出格式。如果没有提供的格式,则该​​方法试图猜测文件名的扩展名的格式。如果没有扩展,并没有指定格式,然后使用“PNG(便携式网络图形)的默认格式。


TAG:

 

评分:0

我来说两句

Open Toolbar