C++ 模拟真人鼠标轨迹算法

一.简介

鼠标轨迹算法是一种模拟人类鼠标操作的程序，它能够模拟出自然而真实的鼠标移动路径。

鼠标轨迹算法的底层实现采用C/C++语言，原因在于C/C++提供了高性能的执行能力和直接访问操作系统底层资源的能力。

鼠标轨迹算法具有以下优势：

模拟人工轨迹：算法能够模拟出非贝塞尔曲线的自然鼠标移动，避免了机械式的直线移动。
适当的停顿/加速/减速：算法能够根据需要模拟出鼠标的停顿、加速和减速，使得轨迹更加真实。
随机轨迹：在固定两点间，算法能够生成不同的随机轨迹，增加了轨迹的不可预测性。

二.应用场景

游戏鼠标轨迹检测（检测能过无畏fps类型、传奇、梦幻等游戏，已经在游戏中验证）
滑块拖动验证
部分网页鼠标轨迹检测

三.支持多种编程语言

1.C++头文件

/******************************************************************************************/
 
@SDK功能描述：C++鼠标轨迹
 
/******************************************************************************************/
 

 
#ifndef _SN_SDK_H__
#define _SN_SDK_H__
 
 
 
#include <windows.h>


enum SN_TRACK_MOVE_TYPE
{
	TRACK_MOVE_TYPE_NORMAL=0,		// 用于常规轨迹 - 普通游戏鼠标轨迹
	TRACK_MOVE_TYPE_SLIDER,			// 用于滑块轨迹，比常规常规轨迹密度更大 - 滑块验证轨迹
};

enum SN_TRACK_POINT_TYPE
{
	TRACK_POINT_TYPE_NORMAL=0,		// 默认绝对坐标
	TRACK_POINT_TYPE_RELATIVE,		// 相对坐标
};


//返回参数
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：		卡密(购买卡密：https://shop.4yuns.com/links/7C9F16B7)
* 	[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] density：		轨迹密度调节 ,必须大于或者等于 1，默认 5,举个例子：假如轨迹有 100 个点，累计耗时 1000 毫秒，设置 density 如下：
*								-  density = 1  时，轨迹有 100/1=100 个点，整个轨迹累计耗时 1000/1=1000 毫秒 （默认 1  倍速度）
*								-  density = 2  时，轨迹有 100/2=50  个点，整个轨迹累计耗时 1000/2=500  豪秒 （等价 2  倍速度）
*								-  density = 3  时，轨迹有 100/3=33  个点，整个轨迹累计耗时 1000/3=333  豪秒 （等价 3  倍速度）
*								-  density = 5  时，轨迹有 100/5=20  个点，整个轨迹累计耗时 1000/5=200  豪秒 （等价 5  倍速度）
*								-  density = 20 时，轨迹有 100/20=5  个点，整个轨迹累计耗时 1000/20=50  豪秒 （等价 20 倍速度）
*								
*  	[in] type：			轨迹类型（0代表绝对普通轨迹，1代表滑块轨迹（获得的轨迹点数比普通轨迹点数更多）,具体参考enum SN_TRACK_MOVE_TYPE）
*
* 返回值：返回参数SN_RESULT.code(错误码)如果为 0 表示成功，否则表示错误号;
*
*/
int WINAPI apiSNSetTrackParams(HANDLE handle, int density=5, int type=0);


/*获取鼠标移动轨迹
*
* 参数：
*	[in] handle：		句柄（通过调用apiSNCreateHandle得到）
* 	[in] startPoint：	开始坐标，左上角（0，0），右下角（1920，1080 - 以实际屏幕为准）
* 	[in] endPoint：		结束坐标，左上角（0，0），右下角（1920，1080 - 以实际屏幕为准）
*  	[in] type：			轨迹坐标类型（0代表绝对坐标，1代表相对坐标,具体参考enum SN_TRACK_POINT_TYPE）
* 	[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得到）
* 	[out] pResult：		返回错误信息，参数pResult->code(错误码)如果为 0 表示成功，否则表示错误号;
*
* 返回值：返回卡密到期时间，失败返回NULL，错误信息请查看参数 pResult->message
*
*/
char* WINAPI apiSNGetKeyExpiresTime(HANDLE handle, SN_RESULT* pResult);


/*获取错误信息
*
* 参数：
*	[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接口

/****************************************************************************************/
 
@SDK功能描述：鼠标轨迹
/******************************************************************************************/
//
 
#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*)"SNKJ86RYDBY1YxafpLG3ep1R6NHFYLjz2UFFcE8Lx9Tq";
	//1.创建句柄
	HANDLE pHandle = apiSNCreateHandle(pKey,NULL, &pResult);
	if (!pHandle)
	{
		printf("error code:%d message:%s \n", pResult.code, pResult.message);
		return -__LINE__;
	}

	//获取卡密到期时间
	char* pTime = apiSNGetKeyExpiresTime(pHandle, &pResult);
	if (pTime)
		printf("卡密到期时间:%s \n", pTime);


	//设置轨迹参数，默认5倍速，根据自身需求设置
	// 轨迹密度density调节 ,density必须大于或者等于 1，默认 5,举个例子：假如轨迹有100个点,耗时1000毫秒，设置 density 如下：
	//		density = 1  时，轨迹有 100/1=100 个点，整个轨迹累计耗时 1000/1=1000 毫秒 （默认 1  倍速度）
	//		density = 2  时，轨迹有 100/2=50  个点，整个轨迹累计耗时 1000/2=500  豪秒 （等价 2  倍速度）
	//		density = 3  时，轨迹有 100/3=33  个点，整个轨迹累计耗时 1000/3=333  豪秒 （等价 3  倍速度）
	//		density = 5  时，轨迹有 100/5=20  个点，整个轨迹累计耗时 1000/5=200  豪秒 （等价 5  倍速度）
	//		density = 20 时，轨迹有 100/20=5  个点，整个轨迹累计耗时 1000/20=50  豪秒 （等价 20 倍速度）
	int ret2 = apiSNSetTrackParams(pHandle, 5, 0);
	if (ret2 != 0)
	{
		printf("error code:%d  \n", ret2);
		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 0
	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);
	}
#endif
	//4.释放内存
	ret = apiSNDestroyHandle(pHandle);
	return 1;
}

5.云盘源码下载

百度云盘
夸克云盘
123云盘

云盘目录介绍：

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）作为轨迹结束的标记，现在修改为（10000，10000）作为轨迹结束标记，目的是为了兼容相对坐标）

4.鼠标轨迹设置相对坐标

在函数 apiSNMouseMove 中 type 参数，0 为绝对坐标 ; 1 为相对坐标

5.如何调节点的密集程度

在（2024.12.22）SDK2.0版本中新增接口 apiSNSetTrackParams 中的 density 参数可以用来调节轨迹密度，举个例子：

density = 1 时，默认轨迹有 100 个点，整个轨迹累计耗时 1000 毫秒（默认 1 倍速度）
density = 2 时，轨迹有 100/2=50 个点，整个轨迹累计耗时 500 毫秒（等价 2 倍速度）
density = 3 时，轨迹有 100/3=33 个点，整个轨迹累计耗时 333 毫秒（等价 3 倍速度）
density = 5 时，轨迹有 100/5=20 个点，整个轨迹累计耗时 200 毫秒（等价 5 倍速度）

不同的游戏需要的轨迹密度不一样，类似 fps 游戏，鼠标滑动轨迹比较快，density 可以设置为 5 或者更高 ; 类似魔兽世界或者梦幻，density 可以调节为 2 或者 3或者5

6.滑块验证轨迹