一.简介
鼠标轨迹算法是一种模拟人类鼠标操作的程序,它能够模拟出自然而真实的鼠标移动路径。
鼠标轨迹算法的底层实现采用C/C++语言,原因在于C/C++提供了高性能的执行能力和直接访问操作系统底层资源的能力。
鼠标轨迹算法具有以下优势:
- 模拟人工轨迹:算法能够模拟出非贝塞尔曲线的自然鼠标移动,避免了机械式的直线移动。
- 适当的停顿/加速/减速:算法能够根据需要模拟出鼠标的停顿、加速和减速,使得轨迹更加真实。
- 随机轨迹:在固定两点间,算法能够生成不同的随机轨迹,增加了轨迹的不可预测性。
二.应用场景
- 游戏鼠标轨迹检测**(检测能过无畏fps类型、传奇、梦幻等游戏,已经在游戏中验证)**
- 滑块拖动验证
- 部分网页鼠标轨迹检测
三.支持多种编程语言
1.C++头文件
cpp
/******************************************************************************************/
@SDK功能描述:C++鼠标轨迹
/******************************************************************************************/
#ifndef _SN_SDK_H__
#define _SN_SDK_H__
#include <windows.h>
//返回参数
typedef struct SN_RESULT {
int code; //错误码,如果为 0 表示成功,否则表示错误号
char message[4096]; //错误信息,如果为 "OK" 表示成功,否则返回错误信息
}SN_RESULT;
//坐标参数
typedef struct SN_POINT
{
int x; //屏幕坐标,左上角(0,0),右下角(1920,1080 - 以实际屏幕为准)
int y; //屏幕坐标,左上角(0,0),右下角(1920,1080 - 以实际屏幕为准)
}SN_POINT;
//轨迹参数
typedef struct SN_POINT_PARAMS
{
struct SN_POINT point;//屏幕坐标,左上角(0,0),右下角(1920,1080 - 以实际屏幕为准)
int delayTime; //延时时间(单位:毫秒),仅供参考
}SN_POINT_PARAMS;
/*创建句柄
*
* 参数:
* [in] szKey: 卡密
* [in] pOnnxFilePath:设置 onnx 模型文件路径,如果设置为 NULL,默认和 DLL文件同级目录
* [out] pResult: 返回错误信息,参数pResult.code(错误码)如果为 0 表示成功,否则表示错误号;
*
* 返回值:成功返回句柄,失败返回NULL
*
*/
HANDLE WINAPI apiSNCreateHandle(char* szKey, char* pOnnxFilePath, SN_RESULT* pResult);
/*获取鼠标移动轨迹
*
* 参数:
* [in] handle: 句柄(通过调用apiSNCreateHandle得到)
* [in] startPoint: 开始坐标,左上角(0,0),右下角(1920,1080 - 以实际屏幕为准)
* [in] endPoint: 结束坐标,左上角(0,0),右下角(1920,1080 - 以实际屏幕为准)
* [in] type: 轨迹类型(0代表绝对坐标,1代表相对坐标)
* [out] points: 轨迹数组,如果数组中元素 point 出现(10000,10000),表示鼠标轨迹结束
*
* 返回值:返回参数SN_RESULT.code(错误码)如果为 0 表示成功,否则表示错误号;
*
*/
int WINAPI apiSNMouseMove(HANDLE handle, SN_POINT *startPoint, SN_POINT *endPoint, int type, SN_POINT_PARAMS* points);
/*获取版本号
*
* 参数:
* [in] handle: 句柄(通过调用apiSNCreateHandle得到)
* [out] szVersion: 版本号
*
* 返回值:返回参数SN_RESULT.code(错误码)如果为 0 表示成功,否则表示错误号;
*
*/
int WINAPI apiSNGetVersion(HANDLE handle, char* szVersion);
/*获取错误信息
*
* 参数:
* [in] handle: 句柄(通过调用apiSNCreateHandle得到)
*
* 返回值:返回参数SN_RESULT.code(错误码)如果为 0 表示成功,否则表示错误号;
*
*/
int WINAPI apiSNGetError(HANDLE handle);
/*释放句柄(内存)
*
* 参数:
* [in] handle: 句柄(通过调用apiSNCreateHandle得到)
*
* 返回值:返回参数SN_RESULT.code(错误码)如果为 0 表示成功,否则表示错误号;
*
*/
int WINAPI apiSNDestroyHandle(HANDLE handle);
#endif // !_SN_SDK_H__
2.其他编程语言
为了易于集成和使用,我们将鼠标轨迹算法封装为DLL(动态链接库)。这种封装方式不仅保留了算法的性能优势,还提供了跨平台和跨语言的兼容性,目前支持编程语言如下:
- C++
- Python
- 易语言
推算轨迹算法耗时均为毫秒级,<= 5ms ,速度超快,fps类型游戏完全无压力!
3.鼠标轨迹API调用流程图
注意:如果是多线程,每个线程都需要通过apiSNCreateHandle创建HANDLE句柄,这样才能多个线程互不影响
4.加载C++鼠标轨迹dll接口
cpp
/****************************************************************************************/
@SDK功能描述:鼠标轨迹
/******************************************************************************************/
//
// ConsoleApplication1.cpp : 此文件包含 "main" 函数。程序执行将在此处开始并结束。
//
#include <iostream>
#include "include/SNSDK.h"
#ifdef SDK_X86
#pragma comment(lib,"./dll/x86/SNSDK.lib")
#else
#pragma comment(lib,"./dll/x64/SNSDK.lib")
#endif
int main()
{
SN_RESULT pResult = { 0 };
char* pKey = (char*)"SNKJ5RC8rvSVzAF96CZpx7HBbx28P9dZUgnuYVNHCsWx";
//1.创建句柄
HANDLE pHandle = apiSNCreateHandle(pKey,NULL, &pResult);
if (!pHandle)
{
printf("error code:%d message:%s \n", pResult.code, pResult.message);
return -__LINE__;
}
//2.获取轨迹
SN_POINT startPoint = { 100,100 }; //开始坐标
SN_POINT endPoint = { 800,800 }; //结束坐标
SN_POINT_PARAMS track[4096] = { 0 };//轨迹
//轨迹类型,0 为绝对坐标 ,1为相对坐标
int type = 0;
int ret = apiSNMouseMove(pHandle, &startPoint, &endPoint, type, track);
if (ret != 0)
{
printf("error code:%d message:%s \n", pResult.code, pResult.message);
return -__LINE__;
}
//3.鼠标根据轨迹移动,轨迹最后一个点(10000,10000)
for (int i = 0; i < 4096; i++)
{
struct SN_POINT point = track[i].point;
if (point.x == 10000 && point.y == 10000)//轨迹最后一个点(10000,10000)
break;
printf("x:%d y:%d delay_time:%d \n", point.x, point.y, track[i].delayTime);
}
if (type == 1)//如果是相对坐标,验证结果
{
int endX = startPoint.x;
int endY = startPoint.y;
for (int i = 0; i < 4096; i++)
{
struct SN_POINT point = track[i].point;
if (point.x == 10000 && point.y == 10000)//轨迹最后一个点(10000,10000)
break;
endX += point.x;
endY += point.y;
printf("x:%d y:%d delay_time:%d \n", point.x, point.y, track[i].delayTime);
}
printf("endX:%d endY:%d \n", endX, endY);
}
//4.释放内存
ret = apiSNDestroyHandle(pHandle);
return 1;
}
5.云盘源码下载
云盘目录介绍:
demo - 包含各种编程语言的demo
dll - 分别是x86和x64平台所需要的dll/lib/h文件
windows 鼠标轨迹测试工具 - exe测试鼠标轨迹效果( demo 中的 c++ 工程编译后的exe可执行文件)
四.效果演示
1.开始坐标为(100,100),结束坐标为(800,800),通过调用接口获得 4 条鼠标轨迹
2.开始坐标为(1000,100),结束坐标为(800,800),通过调用接口获得 2 条鼠标轨迹
五.常见问题
1.是否支持多线程
支持
2.如何使用多线程
参考前面的《2.鼠标轨迹API调用流程图》,多线程和单线程类似;如果是多线程,那么每个线程都需要通过apiSNCreateHandle创建HANDLE句柄,这样才能多个线程互不影响
3.如何判断轨迹结束
可以通过循环判断得到的轨迹坐标,如果当前坐标的X值和Y值都是1000的情况下,默认轨迹结束
(之前的判断是(-1,-1)作为轨迹结束的标记,现在修改为(1000,1000)作为轨迹结束标记,目的是为了兼容相对坐标)
六.更新日志
- 2024.02.06 c++ 模拟人工鼠标轨迹demo
- 2024.06.06 python 模拟人工鼠标轨迹demo
- 2024.06.25 新增错误日志信息
- 2024.07.15 优化水平/垂直轨迹
- 2024.08.20 优化部分轨迹可能出现负数的问题
- 2024.09.19 优化部分轨迹延迟时间为0的情况(可能会造成鼠标瞬移)
- 2024.09.21 修复部分水平/垂直轨迹出现负数的情况
- 2024.09.28 新增易语言demo
- 2024.11.01 修改接口,兼容易语言代码
- 2024.11.17 支持移动轨迹为相对坐标(默认是轨迹是绝对坐标)