基础界面自动化¶

本章节为您描述 LAMDA 提供的自动化基础功能，当然还有进阶使用在下一章，本章为您介绍常用的一些基础功能。

LAMDA 基本使用 (基础自动化代码编写)

获取设备信息¶

获取当前设备信息如设备名称，屏幕大小，屏幕转向和当前应用等信息。

d.device_info()

>>> d.device_info()
productName: "bumblebee"
sdkInt: 34
displayHeight: 2400
displaySizeDpX: 411
displaySizeDpY: 914
displayWidth: 1080
screenOn: true
naturalOrientation: true
currentPackageName: "com.android.launcher3"

>>> result = d.device_info()
>>> print (result.displayWidth)
1080

屏幕息屏¶

以下接口将会使当前的手机屏幕息屏，相当于您在亮屏的情况下按一下电源键的效果。

d.sleep()

屏幕亮屏¶

以下接口将会使当前的手机屏幕点亮，相当于您在息屏的情况下按一下电源键的效果。

d.wake_up()

屏幕是否点亮¶

您可以通过如下接口检查当前设备的屏幕是否是点亮的状态，以便判断是否可以操作。

d.is_screen_on()

屏幕是否锁定¶

您可以通过如下接口检查当前设备的屏幕舒服是解锁的状态，以便判断是否可以操作。

d.is_screen_locked()

显示 Toast¶

您可以使用如下接口，在手机的界面上显示一条 Hello from Lamda! 的 Toast 消息。

d.show_toast("Hello from Lamda!")

读取剪切板¶

以下接口用于读取手机当前剪切板的内容，暂时不支持安卓10+。

d.get_clipboard()

写入剪切板¶

以下接口用于向当前设备的剪切板写入内容。

d.set_clipboard("剪切板内容")

物理按键¶

您可以使用下面的方法来执行模拟按键的操作，支持如 KEY_BACK、KEY_DOWN、KEY_HOME 等十余种按键。

d.press_key(Keys.KEY_BACK)
d.press_key(Keys.KEY_CAMERA)
d.press_key(Keys.KEY_CENTER)
d.press_key(Keys.KEY_DELETE)
d.press_key(Keys.KEY_DOWN)
d.press_key(Keys.KEY_ENTER)
d.press_key(Keys.KEY_HOME)
d.press_key(Keys.KEY_LEFT)
d.press_key(Keys.KEY_MENU)
d.press_key(Keys.KEY_POWER)
d.press_key(Keys.KEY_RECENT)
d.press_key(Keys.KEY_RIGHT)
d.press_key(Keys.KEY_SEARCH)
d.press_key(Keys.KEY_UP)
d.press_key(Keys.KEY_VOLUME_DOWN)
d.press_key(Keys.KEY_VOLUME_MUTE)
d.press_key(Keys.KEY_VOLUME_UP)

同时为了支持其他更多的按键，也可以使用这个方法来模拟，您可以在这个安卓官方文档内找到所有支持的按键名称 https://developer.android.com/reference/android/view/KeyEvent。

d.press_keycode(KeyCodes.KEYCODE_CALL)

屏幕截图¶

我们提供了屏幕截图的方法，这样您可以记录流程或做一些图像识别操作，以下的调用解释为，截取清晰度为60的图像，并保存在当前目录的 screenshot.png 文件。

d.screenshot(60).save("screenshot.png")

>>> result = d.screenshot(60)
>>> result
<lamda.types.BytesIO object at 0x7a28361d60>
>>> result.save("screenshot.png")
52917
>>> result.getvalue( )
b'\xff\xd8\xff\xe0\x00\x10JFIF\x00\x01....'

当前，我们也支持区域和元素截图，元素截图并不在本章内介绍，这里为您介绍区域截图，您需要了解区域的概念和定义，在我们的接口中，区域以 Bound 来定义，它包含四个参数 top、left、right、bottom，安卓屏幕与常规坐标系不同，当前设备屏幕的左上角为原点，他的坐标为 x=0, y=0，我们假设当前屏幕为竖屏，分辨率 1080x1920，那么如果要截取一个全屏的区域截图，您可以这样做。

d.screenshot(60, bound=Bound(top=0, left=0, right=1080, bottom=1920)).save("screenshot.png")

这样将会产生一张全屏截图，当然这是没必要的，因为默认就是全屏截图，那么如果我们想要截取一张靠着左上角的 200x200 的图像该怎么做，这也很简单，您只需要像下面这样。

d.screenshot(60, bound=Bound(top=0, left=0, right=200, bottom=200)).save("screenshot.png")

到这里，我们该为您介绍这几个参数的意义是什么，参数中，top 代表从 Y 轴往下数 top 个像素，bottom 代表从 Y 轴往下数 bottom 个像素，left 以及 right 即代表从 X 轴往右数 N 个像素，其中，top 永远小于 bottom，left 永远小于 right。下面我们再演示一个，截取屏幕右下角 200x200 的图像，您只需要像下面这样调用接口。

d.screenshot(60, bound=Bound(top=1920-200, bottom=1920, left=1080-200, right=1080)).save("screenshot.png")

点击屏幕上的一个点¶

您可以通过如下接口来模拟点击屏幕，在示例中，我们点击了屏幕上的 100,100 坐标的点。

d.click(Point(x=100, y=100))

点按点A并将其拖动到点B¶

通过如下接口可以实现将点 A 位置的东西拖动到点 B，比如将图标拖动到文件夹这种操作。

A = Point(x=100, y=100)
B = Point(x=500, y=500)

d.drag(A, B)

从点A滑动到点B¶

通过如下接口可以实现从屏幕的 100x100 坐标滑动到 500x500 坐标。

A = Point(x=100, y=100)
B = Point(x=500, y=500)

d.swipe(A, B)

稍复杂的多点滑动¶

如下接口可以模拟多点滑动，比如如下调用将会从 100x100 滑动到 500x500 并回到 200x200，下面的演示中只滑动了三个点，实际上您可以提供更多的点位，甚至实现九宫格解锁。

p1 = Point(x=100, y=100)
p2 = Point(x=500, y=500)
p3 = Point(x=200, y=200)

d.swipe_points(p1, p2, p3)

打开快捷设置¶

如下调用可以打开屏幕上的通知栏，但是是半开的状态。

d.open_quick_settings()

打开通知栏¶

如下调用可以打开屏幕上的通知栏。

d.open_notification()

获取页面布局¶

如下调用可以获取当前页面的 XML 布局，您也可以自行解析来支持 xpath 自动化。

d.dump_window_hierarchy()

>>> result = d.dump_window_hierarchy()
>>> result
<lamda.types.BytesIO object at 0x7add660680>
>>> result.getvalue()
b'<?xml version=\'1.0\' encoding=\'UTF-8\' standalone=\'yes\' ?>\r\n<hierarchy rotation="0">\r\n  <node index="0" text="" resource-id="" class="android.widget.FrameLayout" package="com.android.systemui" content-desc="" checkable="false" checked="false" clickable="false"...

等待窗口静止¶

您可以执行如下调用来等待当前窗口处于静止状态，类似于 selenium 的 implicitly_wait，参数的单位是毫秒，5*1000 则代表的是等待 5 秒钟，毫秒转秒的单位为 1000。

d.wait_for_idle(5*1000)

获取最近的 Toast¶

您可以执行如下的调用来获取系统中的最近一条 Toast 消息，但是需要注意，只支持系统内 API 发送的 Toast 消息，第三方实现的类 Toast UI 的消息无法获取。

d.get_last_toast()

>>> result = d.get_last_toast()
>>> print (result)
timestamp: 1700000000000
package: "com.android.settings"
message: "\346\202\250\345\267\262\345\244\204\344\272\216\345\274\200\345\217\221\350\200\205\346\250\241\345\274\217\357\274\214\346\227\240\351\234\200\350\277\233\350\241\214\346\255\244\346\223\215\344\275\234\343\200\202"
>>> print (result.message)
您已处于开发者模式，无需进行此操作。