Skip to content
 
 

Repository files navigation

AI Aimbot Android

Android FPS 游戏 AI 瞄准辅助工具,基于 YOLOv8n 实时目标检测,支持骁龙 Hexagon QNN HTP 加速。


设备要求

项目 要求
芯片 骁龙 8 Gen 1 及以上(SM8450+)
系统 Android 12 (API 31) 及以上
架构 arm64-v8a

低于骁龙 8 Gen 1 的设备可能无法正常运行或推理速度过慢。


下载安装

  1. 前往 Releases 页面
  2. 下载最新版本的 APK 文件
  3. 在手机上安装 APK(需允许安装未知来源应用)

前置准备

1. 安装 Shizuku

本应用依赖 Shizuku 进行触控注入,必须先完成 Shizuku 的设置:

  1. 在应用商店或 Shizuku 官网 下载安装 Shizuku
  2. 打开 Shizuku,选择 通过无线调试启动
  3. 按照 Shizuku 内的指引完成配对(需在开发者选项中开启无线调试)
  4. 确保 Shizuku 状态显示为 运行中

2. 授权应用

  1. 打开 Shizuku → 管理已授权应用
  2. 找到本应用,开启授权

使用教程

第一步:启动应用

打开应用后,主界面会显示当前状态和可用模型列表。

第二步:授予权限

首次运行需要授予以下权限:

  • 屏幕录制权限:用于截取游戏画面进行检测
  • 悬浮窗权限:用于显示检测覆盖层和控制面板

应用会自动弹出权限请求,按提示允许即可。

第三步:选择模型

在主界面选择要使用的检测模型:

模型 说明
INT8 192 推荐,速度快,精度足够
INT8 256 精度更高,速度稍慢
Float32 192 测试用,不推荐日常使用

第四步:启动服务

  1. 点击 启动 按钮
  2. 悬浮球(AI图标)会出现在屏幕上
  3. 切换到游戏

第五步:游戏内操作

悬浮球

  • 可以拖动到任意位置
  • 点击悬浮球打开/关闭控制面板
  • 长按悬浮球可停止服务

控制面板(点击悬浮球打开):

标签 功能
自瞄 开关自动瞄准、调节 PID 参数(响应速度/平滑度)
扳机 开关自动扳机(准心对准目标时自动开火)
模型 切换检测模型
系统 置信度阈值、系统设置

功能说明

自动瞄准

  • 检测到敌人后,自动将准心移动到目标位置
  • 通过 PID 控制器实现平滑追踪,不会出现瞬移
  • 支持调节响应速度:Kp(比例)越大响应越快,Kd(微分)越大越平滑

自动扳机

  • 当准心与检测到的目标重合时,自动开火
  • 可设置触发区域大小

按住开火(Hold-to-Fire)

  • 需要用物理手指按住触发区域,自动瞄准才会激活
  • 松手即停止,防止非预期操作

检测覆盖层

  • 屏幕上会显示检测到的目标边界框
  • 绿色框 = 高置信度,黄色框 = 低置信度
  • 可在设置中关闭覆盖层显示

常见问题

Q: 启动后没有检测框出现

  • 确认已授予屏幕录制权限
  • 确认 Shizuku 正在运行且已授权本应用
  • 尝试降低置信度阈值(控制面板 → 系统)

Q: 自瞄不生效

  • 确认 Shizuku 状态为运行中
  • 确认已在控制面板中开启自瞄开关
  • 如果开启了「按住开火」,需要物理手指按住触发区域

Q: 推理速度慢 / 卡顿

  • 确认设备芯片为骁龙 8 Gen 1 或以上
  • 尝试切换到 INT8 192 模型(速度最快)
  • 关闭其他占用性能的应用

Q: 提示 Shizuku 连接失败

  • 重新启动 Shizuku(通过无线调试启动)
  • 确认无线调试的配对码已正确输入
  • 重启手机后重试

Q: 游戏内触摸无响应

  • 检查是否与其他悬浮窗应用冲突
  • 重新启动本应用的服务

注意事项

  • 本工具仅供学习和研究用途
  • 在线游戏中使用可能违反游戏条款,请自行承担风险
  • 首次启动时模型文件会从 assets 解压到内部存储,可能需要几秒钟
  • 建议在游戏开始前启动服务,游戏结束后停止服务以节省电量

License

GNU GPL v3 - See LICENSE

About

安卓运行yolo模型进行图像识别

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages