QQ飞车霹雳天使的礼物

Python自动化领取QQ飞车霹雳天使的礼物实操教程

一、开发环境与依赖库安装

要实现自动化领取游戏礼包，我们需要搭建基于Python的UI自动化测试环境。这里选用Airtest框架，因为它基于图像识别，无需反编译游戏客户端，适合零门槛上手。

1. 安装Python运行环境

请务必下载Python 3.8或3.9版本（避免使用3.10及以上版本，部分库兼容性存在问题）。直接访问以下链接下载Windows x64可执行安装包：

https://www.python.org/ftp/python/3.9.7/python-3.9.7-amd64.exe

安装时，务必勾选"Add Python to PATH"选项，这是后续命令行操作的基础。

2. 安装Airtest核心库

打开CMD命令行窗口，依次执行以下两条命令，安装自动化核心库及Poco UI识别库：

```bash pip install airtest pip install pocoui ```

如果下载速度过慢，请使用国内清华源镜像：

```bash pip install airtest -i https://pypi.tuna.tsinghua.edu.cn/simple pip install pocoui -i https://pypi.tuna.tsinghua.edu.cn/simple ```

3. 下载AirtestIDE辅助工具

虽然我们可以用纯代码写，但为了获取图片坐标，需要IDE辅助。下载地址如下：

https://airtest.netease.com/

下载后解压直接运行AirtestIDE.exe即可，无需安装。

二、模拟器连接与ADB配置

为了不影响日常使用手机，建议在模拟器上运行脚本。推荐使用雷电模拟器4或9，分辨率设置为1280x720，DPI设置为240。

1. 开启模拟器ADB连接

在CMD中输入以下命令连接模拟器（默认雷电模拟器端口为5555）：

```bash adb connect 127.0.0.1:5555 ```

如果提示connected，则表示连接成功。如果提示adb不是内部或外部命令，需要将Android SDK的platform-tools目录配置到系统环境变量Path中。

2. 在AirtestIDE中连接设备

打开AirtestIDE，点击右上角刷新设备列表，选择Android下拉框中的127.0.0.1:5555，点击Connect按钮。当窗口显示手机画面时，环境准备完成。

三、核心素材准备与截图逻辑

脚本的核心逻辑是“识别图片-点击坐标”。我们需要准备以下四张关键图片，并保存到脚本的同一目录下。请在AirtestIDE中点击设备画面上的相应按钮，使用截图按钮保存为以下文件名：

• activity_icon.png：游戏主界面右上角的“活动”图标。
• angel_gift.png：活动列表中“霹雳天使的礼物”活动入口图标。
• receive_btn.png：活动详情界面的“领取”按钮（通常为橙色或黄色按钮）。
• confirm_btn.png：领取成功后的“确认”或“关闭”弹窗按钮。

注意事项：截图时尽量只截取按钮的独特部分，不要截取太多背景，以提高识别准确率。如果按钮有动态效果，请截取静态部分。

四、完整自动化代码实现

新建一个Python文件（例如auto_gift.py），将以下代码完整复制进去。代码包含异常处理和等待逻辑，确保在界面加载延迟时也能正常运行。

```python -- encoding=utf8 -- __author__ = "SeniorTechExpert" from airtest.core.api import 根据实际连接情况初始化设备，如果是本地模拟器通常不需要这行，IDE会自动注入 auto_setup(__file__, devices=["Android://127.0.0.1:5037/127.0.0.1:5555"]) def start_game_and_claim(): try: 启动QQ飞车，包名可能因版本不同微调，雷电模拟器通常通用 start_app("com.tencent.qqspeed") sleep(10) 等待游戏资源加载，根据电脑性能调整时间 print("等待进入主界面...") 循环检测主界面是否加载完成，以“活动”图标为准 wait(Template(r"activity_icon.png", record_pos=(0.0, 0.0), resolution=(1280, 720), threshold=0.9), timeout=60) print("点击活动中心...") touch(Template(r"activity_icon.png", record_pos=(0.0, 0.0), resolution=(1280, 720))) sleep(3) 等待活动列表加载 检测是否进入活动列表，这里假设活动列表有特定特征，或者直接滑动查找 print("查找霹雳天使活动...") if exists(Template(r"angel_gift.png", record_pos=(0.0, 0.0), resolution=(1280, 720), threshold=0.8)): touch(Template(r"angel_gift.png", record_pos=(0.0, 0.0), resolution=(1280, 720))) print("进入活动详情...") sleep(3) 核心操作：领取礼物 print("尝试领取礼物...") 设置超时检测，防止按钮未出现 for i in range(5): if exists(Template(r"receive_btn.png", threshold=0.8)): touch(Template(r"receive_btn.png")) print("点击领取按钮成功") sleep(2) break else: print("未找到领取按钮，等待0.5秒重试...") sleep(0.5) 处理弹窗 print("处理领取后弹窗...") if exists(Template(r"confirm_btn.png", threshold=0.8)): touch(Template(r"confirm_btn.png")) print("关闭弹窗，领取完成") else: print("未检测到弹窗，可能已领取或无需确认") else: print("未找到霹雳天使活动入口，请检查截图或活动是否已结束") except TargetNotFoundError: print("错误：无法找到指定图片，请检查游戏分辨率是否为1280x720") except Exception as e: print(f"发生未知错误: {e}") if __name__ == "__main__": start_game_and_claim() ```

五、脚本运行与参数调优

1. 运行脚本

在AirtestIDE中，直接点击右上角的运行按钮即可。如果要在命令行运行，确保当前目录下有图片素材，执行：

```bash python auto_gift.py ```

2. 识别阈值调整

如果脚本运行时报错TargetNotFoundError，通常是因为图片匹配度不够。在代码中找到threshold=0.9或0.8，将其适当调低（例如改为0.7）。阈值越低，对模糊图片的容忍度越高，但也越容易误触。

3. 分辨率强制锁定

代码中的resolution=(1280, 720)参数至关重要。如果你改变了模拟器分辨率，必须修改这里的参数，并重新截图，否则坐标计算会完全错乱。

六、常见异常处理方案

1. 出现“adb server version doesn't match this client”错误

这是因为Airtest自带的adb与模拟器的adb版本冲突。解决方法是在CMD中执行：

```bash taskkill /f /im adb.exe ```

然后只启动模拟器，再在AirtestIDE中连接，让IDE自动使用模拟器的adb服务。

2. 游戏卡顿导致点击失效

在touch命令前增加sleep(1)，或者在wait函数中增加timeout参数。对于性能较差的电脑，建议将初始加载的sleep(10)改为sleep(20)。

3. 活动列表需要滑动

如果“霹雳天使”活动不在当前屏幕，需要在代码中检测活动图标前加入滑动逻辑：

```python 向上滑动查找活动列表 swipe(Template(r"activity_icon.png"), vector=[0, -0.5]) ```

这行代码会以活动图标为起点，向上滑动半个屏幕的距离，用于加载更多活动内容。