注：我们的 Airtest 官方公众号（AirtestProject）会持续更新大家对于 Airtest 感兴趣的问题，欢迎有需要的同学关注并查看我们更多的内容。
如想向我们反馈关于 AirtestProject 想了解的问题，欢迎到公众号后台留言

前言

很多用户会问到我们一些关于坐标的问题，其实，airtest 和 poco 操作时的坐标系是不一样的。下文我们将主要介绍以下两方面的内容：

1.airtest 和 poco 分别使用的一些坐标系；

2.如何使用屏幕坐标的功能来查看坐标。

Airtest 的坐标系

使用绝对坐标系的 touch 和 swipe 接口

airtest 的 touch 接口，实际上点击的是一个 (x, y) 绝对坐标，在截图语句中，airtest 会先根据传入的图片找到该图片在当前画面上的位置坐标，然后进行点击。我们举一个简单的例子：

下图时执行了一条 touch 语句，我们查看 log 日记，可以看出实际点击的是该图片在当前画面上的一个位置坐标。


再比如过场动画会很慢，我们想要跳过，这时就可以使用 touch 来点击画面内的一个位置坐标来实现。



而 airtest 的 swipe 接口，滑动起点和滑动终点使用的也是 (x, y) 绝对坐标。例如：

在考拉 app 打开后，有 4 个介绍页滑动后才能进去。我们可以通过使用固定坐标位置滑动，执行四下即可跳过介绍页。（要注意的是，这里坐标脚本的连续运行操作得太快，设备甚至有可能会反应不过来，一般每行语句后面需要加一下 sleep(1.0),等待一下设备响应。 ）

使用屏幕坐标的功能查看坐标

打开 IDE 的选项>--设置，可以看到在 Device 设置部分，有实时坐标显示和相对坐标显示俩个选项。


勾选实时坐标选项，可以实时在手机屏幕画面上显示出鼠标位置的坐标，方便大家获取绝对坐标。此时 点击鼠标右键，还可以自动将当前坐标信息复制到剪贴板中，在代码里只需要直接粘贴即可插入点击位置的坐标。

在勾选了实时显示坐标的情况下，再勾选相对坐标选项，将会以 (0, 0) 到 (1, 1) 为范围显示出相对坐标。使用相对坐标可以避免跨分辨率的操作点超出屏幕的问题，使坐标操作兼容性更好。

poco 的坐标系

使用局部坐标系的 click 接口

首先我们需要知道点击默认是点在 anchorPoint 上的，每个 UI 都会有一个 anchorPoint ，也就是检视器 (Inspector) 中 UI 包围盒的那个红点，大部分情况下 anchorPoint 都在 UI 包围盒的正中央。



所以当我们使用 poco 默认的 click 接口时，点击的是 UI 包围盒中间的红点，举个例子：

poco("com.miui.home:id/workspace").offspring("天气").offspring("com.miui.home:id/icon_icon").click()

执行后报告显示的点击位置如下图：

我们引入局部坐标系来表示相对于某 UI 的坐标。局部坐标系以 UI 包围盒左上角为原点，向右为 x 轴，向下为 y 轴，包围盒宽和高均为单位一。 局部坐标系可以更灵活地定位 UI 内或外的位置，例如 (0.5, 0.5) 就代表 UI 的正中央，也就相当于我们上文中默认的 anchorPoint；超过 1 或小于 0 的坐标值则表示 UI 的外面。



所以如果我们想点击 anchorPoint 以外的其他指定位置时，可以传一个参数到 click 方法中，这个参数是一个用 list 或 tuple 表示的 2 维向量，其 [x, y] 值分别表示相对于包围盒左上角的偏移量，左上角为 [0, 0] ，右下角为 [1, 1] 。例如：

poco("com.miui.home:id/workspace").offspring("天气").offspring("com.miui.home:id/icon_icon").click([0,0])

执行后报告显示的点击位置如下图：



可以看出点击的是我们 UI 包围框左上角的原点 (0,0)。

另外，我们想改变以 anchorPoint 为起点，也可以使用focus方法：

poco("com.miui.home:id/workspace").offspring("天气").offspring("com.miui.home:id/icon_icon").focus([0,0]).click()

使用归一化坐标系的 swipe 接口

归一化坐标系就是将屏幕宽和高按照单位一来算，这样 UI 在 poco 中的宽和高其实就是相对于屏幕的百分比大小了，好处就是不同分辨率设备之间，同一个 UI 的归一化坐标系下的位置和尺寸是一样的，有助于编写跨设备测试用例。

归一化坐标系的空间是均匀的，屏幕正中央一定是 (0.5, 0.5)，其他标量和向量的计算方法同欧式空间。

swipe 操作同样是以 anchorPoint 为起点，如果你想改变起点也是使用上述的 focus 方法，然后朝给定向量所代表的方向滑动，距离也就是向量的长度。

下面展示使用 swipe 方法的一个例子：

joystick = poco('movetouch_panel').child('point_img')
joystick.swipe('up')
joystick.swipe([0.2, -0.2])  # swipe sqrt(0.08) unit distance at 45 degree angle up-and-right
joystick.swipe([0.2, -0.2], duration=0.5)

最后，如果大家对 Airtest 有疑问、BUG、建议，请到https://github.com/AirtestProject/AirtestIDE/issues 发布 issue，我们会有专人解答。同时，我们还提供了官方 QQ 群给大家沟通交流，目前 1 群已满，欢迎大家加入 2 群：