测试质量保障计算机视觉【免费下载链接】AirtestUI Automation Framework for Games and Apps项目地址https://gitcode.com/gh_mirrors/ai/Airtest点击查看免费下载导读本文基于 Airtest 官方 API 参考文档 airtest.core.android.rotation.rst 所对应的模块文档深入剖析airtest.core.android.rotation模块的完整设计。你将掌握 Airtest 如何通过RotationWatcher实时监听 Android 设备屏幕旋转、如何通过XYTransformer在横竖屏切换时完成坐标换算并了解方向信息如何驱动截图、触摸与录制功能从而在游戏与应用 UI 自动化脚本中正确处理旋转场景。模块定位负责屏幕方向的感知与坐标换算airtest.core.android.rotation是 Airtest Android 自动化体系中的方向处理模块其职责可以概括为两件事感知方向通过RotationWatcher类实时监听设备屏幕旋转并向注册的回调推送最新的方向值0、1、2、3分别对应旋转 0°、90°、180°、270°。换算坐标通过XYTransformer类在“原始物理屏幕坐标”与“竖屏upright截图坐标”之间互相转换保证横竖屏切换后触摸、断言等操作仍然准确。从源码结构看该模块被 android.py 在构造 Android 设备对象时实例化并集成self.rotation_watcher RotationWatcher(self.adb, self.ori_method)见 android.py#L66同时被 minicap.py 注册方向变化回调以触发画面重连是整个 Android 方向体系的中枢。方向获取的两种方案ORI_METHOD方向值本身由设备端提供但获取途径有两种定义在 constant.py 的ORI_METHOD类中常量值含义ORI_METHOD.ADBADBORI通过 adb 命令轮询设备方向ORI_METHOD.MINICAPMINICAPORI通过 rotationwatcher 服务推送方向默认方案Android设备对象构造函数的ori_method参数默认取ORI_METHOD.MINICAP见 android.py#L43即优先使用高精度的 rotationwatcher 服务只有在服务安装或启动失败时才会按源码中的降级逻辑自动回退到ADBORI见 rotation.py#L109-L116if self.ori_method ORI_METHOD.MINICAP: try: self.setup_server() except: LOGGING.error(RotationWatcher setup failed, use ADBORI instead.) self.ori_method ORI_METHOD.ADB这意味着即使设备不支持 minicap 相关能力Airtest 也能依靠 adb 方案继续工作保证兼容性。RotationWatcher实时方向监听器RotationWatcher是模块的核心类负责在设备上部署 rotationwatcher 服务、维护后台监听线程并分发方向变化事件。其完整 API 如下方法作用install()推送rotationwatcher.jar到设备并赋权uninstall()从设备删除 jar 文件setup_server()启动设备端 app_process 服务进程start()启动守护线程并返回初始方向值teardown()停止进程、清空回调、注销清理钩子reg_callback(cb)注册方向变化回调回调参数为方向值 ori部署与启动流程install()先将本地静态资源 rotationwatcher.jar 推送至设备/data/local/tmp/rotationwatcher.jar并通过chmod 755赋予执行权限若目标文件已存在且大小一致则跳过安装以节省时间见 rotation.py#L34-L55。setup_server()使用app_process方式在设备上运行 Java 服务见 rotation.py#L80-L90p self.adb.start_shell( app_process -Djava.class.path{0} /data/local/tmp com.example.rotationwatcher.Main.format( self.path_in_android))服务启动后其标准输出被包装为NonBlockingStreamReader用于异步读取方向数据。如果进程立即退出说明服务可能已被其他连接占用此时抛出RuntimeError提示 setup 失败。守护线程与两种刷新模式start()会创建名为rotationwatcher的守护线程持续运行见 rotation.py#L139-L166并根据当前ori_method选择刷新来源MINICAP 模式从nbsp.readline()读取服务推送的数据。设备产生旋转时读到形如b90\r\n的数据换算为ori int(int(line) / 90)即 90° 对应方向值 1平时读到空数据返回None进程结束时读到b触发teardown()。ADB 模式调用self.adb.getDisplayOrientation()轮询且只有当方向值发生变化时才继续处理未变化时time.sleep(3)后跳过避免无意义的重复回调。线程每轮都会将新方向通过所有已注册回调广播出去并在进程退出is_exiting()时自动执行teardown()。初始化时start()会先同步读取一次当前方向作为current_orientation返回供上层立即使用。回调注册机制reg_callback(ow_callback)负责登记方向变化的监听者见 rotation.py#L170-L181回调统一约定参数一定是 ori若服务断掉则传None。该机制使方向事件能够被多个组件同时消费Android 设备对象用它刷新_current_orientationandroid.py#L1082Minicap 采集组件用它触发画面重连minicap.py#L61rotation_watcher.reg_callback(lambda x: self.update_rotation(x * 90))因为 minicap 在横竖屏切换时必须重新连接数据流。teardown()会设置线程退出事件、杀掉服务进程、清空回调列表并注销全局清理钩子reg_cleanup确保脚本退出或设备断开时不留残留进程rotation.py#L92-L99。方向值语义与坐标变换XYTransformerXYTransformer是一个纯静态工具类负责在“竖屏截图坐标upright”与“原始物理屏幕坐标original”之间做二维坐标变换其核心依据是方向值orientationorientation含义旋转角度0竖屏0°1右横屏90°2倒竖屏180°3左横屏270°up_2_ori截图坐标 → 物理坐标up_2_ori(tuple_xy, tuple_wh, orientation)将竖屏截图上的坐标换算为设备物理屏幕坐标rotation.py#L188-L211if orientation 1: x, y w - y, x elif orientation 2: x, y w - x, h - y elif orientation 3: x, y y, h - x return x, y该方法是触摸坐标换算的关键环节。在 android.py#L1084-L1101 中_touch_point_by_orientation正是调用它把图像识别得到的坐标转换为真实物理坐标再交由 minitouch / maxtouch 执行点击。坐标原点约定为设备物理屏幕的左上角。ori_2_up物理坐标 → 截图坐标ori_2_up(tuple_xy, tuple_wh, orientation)执行反向换算rotation.py#L213-L236if orientation 1: x, y y, w - x elif orientation 2: x, y w - x, h - y elif orientation 3: x, y h - y, x return x, y两个方法互为逆运算当方向值为 0 时坐标不做任何变换直接返回原值。方向信息的下游消费链路从源码集成看方向值最终会转化为设备对外暴露的统一状态display_info 更新在 android.py#L820-L827 中display_info属性会优先采用 rotation_watcher 的实时方向注释明确指出 update ow orientation, which is more accurate写入rotation角度制ori * 90与orientation方向值两个字段。测试 test_android.py#L39-L40 断言display_info中同时包含orientation与rotation键。分辨率换算get_current_resolution()在方向为 1/3横屏时交换宽高android.py#L848-L852get_render_resolution()也会对渲染偏移量做同样的宽高交换android.py#L872-L874。生命周期管理disconnect()按顺序执行 minicap/javacap 停止 → minitouch/maxtouch 停止 →rotation_watcher.teardown()android.py#L1120-L1134保证断开设备时方向服务一并释放。ADB 方案的底层实现getDisplayOrientation当使用ORI_METHOD.ADB时方向值来自 adb.py#L1204-L1235 的getDisplayOrientation()该方法针对不同系统版本实现了多级回退解析dumpsys SurfaceFlinger输出中的orientation(\d)兼容老设备注释提到适用于 SDK 15 的三星旧机型回退解析dumpsys input中的SurfaceOrientation:\s(\d)再回退解析dumpsys window displays中的DisplayFrames.*r(\d)全部失败时打印警告并返回 0。这套多级探测策略保证了在缺乏 minicap 服务能力的环境下仍能稳定获得方向数据。测试覆盖与验证仓库测试对 rotation 模块的集成路径提供了直接验证test_minicap.py先调用rotation_watcher.get_ready()启动方向服务再将rotation_watcher注入Minicap测试结束时调用teardown()其中test_rotation用例直接验证旋转场景。test_screen_proxy.pyScreenProxy.auto_setup以rotation_watcherself.dev.rotation_watcher方式接入方向服务。test_touch_proxy.py触摸代理通过ori_transformerself.dev._touch_point_by_orientation接入坐标换算链路。这些用例印证了方向监听与坐标变换并非孤立功能而是深度嵌入采集cap、触摸touch与屏幕代理screen proxy的完整链路。实战要点与最佳实践默认无需干预使用connect_device(android:///)或Android()创建设备对象时rotation 服务会自动初始化ori_method默认MINICAPORI脚本层通常无需手动调用rotation_watcher的接口。横竖屏切换的坐标安全截图中识别到的坐标会经_touch_point_by_orientation自动换算为物理坐标因此脚本中始终以竖屏截图坐标为基准编写旋转发生时无需修改脚本逻辑。需要手动接入时参考 screen_proxy.py#L83 的用法将rotation_watcher显式传给需要感知方向的组件。自定义方向回调可通过dev.rotation_watcher.reg_callback(lambda x: ...)注册自己的监听函数但要注意回调运行在独立线程中需自行保证线程安全源码注释明确提示 callback is called in another thread, so be careful about thread-safety。方向与录屏start_recording的orientation参数1 竖屏、2 横屏、0 跟随旋转与方向体系相互独立可按录制需求单独指定见 android.py#L890 及 test_android_recorder.py#L113-L121。小结airtest.core.android.rotation模块以极简的 API 封装了 Android 屏幕旋转的完整处理链RotationWatcher负责方向感知与事件分发MINICAP 服务优先、ADB 轮询兜底XYTransformer负责横竖屏坐标的双向换算二者共同保障了 Airtest 在任意旋转状态下截图、点击、断言与录屏的一致性。理解这一模块是编写稳定横竖屏 UI 自动化脚本的前提。如需进一步阅读可深入 rotation.py、android.py 与 constant.py 的源码实现。赞分享测试质量保障计算机视觉【免费下载链接】AirtestUI Automation Framework for Games and Apps项目地址https://gitcode.com/gh_mirrors/ai/Airtest点击查看免费下载相关推荐深入解析 VictoriaMetrics 依赖的 Azure azidentity 模块Go 语言 Microsoft Entra ID 凭证体系实战指南深入解析 VictoriaMetrics 依赖的 Azure azidentity 模块Go 语言 Microsoft Entra ID 凭证体系实战指南 本测试质量保障计算机视觉lo 泛型类型操作Type Manipulation核心辅助函数全解析nil 检测、指针转换与 Coalesce 家族lo 泛型类型操作Type Manipulation核心辅助函数全解析nil 检测、指针转换与 Coalesce 家族 lo 是基于 Go 1.18 泛测试质量保障计算机视觉QtScrcpy屏幕旋转处理指南VideoForm实现横竖屏动态切换QtScrcpy屏幕旋转处理指南VideoForm实现横竖屏动态切换 QtScrcpy是一款强大的Android实时投屏软件提供USB和TCP/IP连接的A桌面应用音视频上一篇Apache Airflow Apache Flink Provider 实战指南基于 Kubernetes 的 Flink 应用编排与状态感知下一篇libSQL 数据库修复工具测试指南sqlite3_checker 的构建、TCL 测试框架与用例解析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考