一.简介
鼠标轨迹算法是一种模拟人类鼠标操作的程序，它能够模拟出自然而真实的鼠标移动路径。
鼠标轨迹算法的底层实现采用C/C++语言，原因在于C/C++提供了高性能的执行能力和直接访问操作系统底层资源的能力。
鼠标轨迹算法具有以下优势：
- 模拟人工轨迹：算法能够模拟出非贝塞尔曲线的自然鼠标移动，避免了机械式的直线移动。
- 适当的停顿/加速/减速：算法能够根据需要模拟出鼠标的停顿、加速和减速，使得轨迹更加真实。
-
随机轨迹：在固定两点间，算法能够生成不同的随机轨迹，增加了轨迹的不可预测性。
QQ截图20241110111818.jpg
二.应用场景
游戏鼠标轨迹检测（检测能过无畏fps类型、传奇、梦幻等游戏，已经在游戏中验证）
滑块拖动验证
部分网页鼠标轨迹检测
三.支持多种编程语言
1.C++头文件
/******************************************************************************************/
@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： 卡密
* [out] pResult： 返回错误信息，参数pResult.code(错误码)如果为 0 表示成功，否则表示错误号;
*
* 返回值：成功返回句柄，失败返回NULL
*
*/
HANDLE WINAPI apiSNCreateHandle(char* szKey, SN_RESULT* pResult);
/*获取鼠标移动轨迹
*
* 参数：
* [in] handle： 句柄（通过调用apiSNCreateHandle得到）
* [in] startPoint： 开始坐标，左上角（0，0），右下角（1920，1080 - 以实际屏幕为准）
* [in] endPoint： 结束坐标，左上角（0，0），右下角（1920，1080 - 以实际屏幕为准）
* [out] points： 轨迹数组，如果数组中元素 point 出现(-1,-1),表示鼠标轨迹结束
*
* 返回值：返回参数SN_RESULT.code(错误码)如果为 0 表示成功，否则表示错误号;
*
*/
SN_RESULT WINAPI apiSNMouseMove(HANDLE handle, SN_POINT startPoint, SN_POINT endPoint, SN_POINT_PARAMS* points);
/*获取版本号
*
* 参数：
* [in] handle： 句柄（通过调用apiSNCreateHandle得到）
* [out] szVersion： 版本号
*
* 返回值：返回参数SN_RESULT.code(错误码)如果为 0 表示成功，否则表示错误号;
*
*/
SN_RESULT WINAPI apiSNGetVersion(HANDLE handle, char* szVersion);
/*获取错误信息
*
* 参数：
* [in] handle： 句柄（通过调用apiSNCreateHandle得到）
*
* 返回值：返回参数SN_RESULT.code(错误码)如果为 0 表示成功，否则表示错误号;
*
*/
SN_RESULT WINAPI apiSNGetError(HANDLE handle);
/*释放句柄（内存）
*
* 参数：
* [in] handle： 句柄（通过调用apiSNCreateHandle得到）
*
* 返回值：返回参数SN_RESULT.code(错误码)如果为 0 表示成功，否则表示错误号;
*
*/
SN_RESULT WINAPI apiSNDestroyHandle(HANDLE handle);
#endif // !_SN_SDK_H__
2.其他编程语言
为了易于集成和使用，我们将鼠标轨迹算法封装为DLL（动态链接库）。这种封装方式不仅保留了算法的性能优势，还提供了跨平台和跨语言的兼容性，目前支持编程语言如下：
- C++
- Python
- 易语言
推算轨迹算法耗时均为毫秒级，<= 5ms ，速度超快，fps类型游戏完全无压力！
3.鼠标轨迹API调用流程图
QQ截图20241103105733.jpg
注意：如果是多线程，每个线程都需要通过apiSNCreateHandle创建HANDLE句柄,这样才能多个线程互不影响
4.C++鼠标轨迹接口
/****************************************************************************************/
@SDK功能描述：鼠标轨迹
/******************************************************************************************/
//
#include <iostream>
#include "include/SNSDK.h"
#pragma comment(lib,"./dll/x86/SNSDK.lib")
int main()
{
SN_RESULT pResult = { 0 };
char* pKey = (char*)"SNKJaURwbfuhcaQaCMJVhdByPZMVsZdqRUMjfWrxY1A5";
//1.创建句柄
HANDLE pHandle = apiSNCreateHandle(pKey,&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 };//轨迹
pResult = apiSNMouseMove(pHandle, startPoint, endPoint, track);
if (pResult.code != 0)
{
printf("error code:%d message:%s \n", pResult.code, pResult.message);
return -__LINE__;
}
//3.鼠标根据轨迹移动,轨迹最后一个点（-1，-1）
for (int i = 0; i < 4096; i++)
{
struct SN_POINT point = track[i].point;
if (point.x <= 0 && point.y <= 0)//轨迹最后一个点（-1，-1）
break;
printf("x:%d y:%d delay_time:%d \n", point.x, point.y, track[i].delayTime);
}
//4.释放内存
pResult = apiSNDestroyHandle(pHandle);
return 1;
}
/*
x:100 y:100 delay_time:0
x:100 y:98 delay_time:10
x:103 y:98 delay_time:15
x:111 y:98 delay_time:16
x:116 y:101 delay_time:15
x:122 y:104 delay_time:2
x:129 y:107 delay_time:13
x:135 y:109 delay_time:2
x:144 y:112 delay_time:14
x:155 y:117 delay_time:2
x:167 y:123 delay_time:14
x:180 y:128 delay_time:2
x:193 y:134 delay_time:13
x:209 y:138 delay_time:2
x:225 y:144 delay_time:13
x:238 y:149 delay_time:5
x:254 y:157 delay_time:10
x:269 y:162 delay_time:5
x:282 y:168 delay_time:11
x:298 y:175 delay_time:5
x:311 y:180 delay_time:10
x:326 y:185 delay_time:6
x:341 y:193 delay_time:9
x:369 y:211 delay_time:15
x:396 y:231 delay_time:16
x:419 y:251 delay_time:16
x:442 y:270 delay_time:16
x:461 y:285 delay_time:17
x:481 y:300 delay_time:15
x:491 y:311 delay_time:15
x:502 y:319 delay_time:2
x:513 y:329 delay_time:14
x:523 y:343 delay_time:2
x:535 y:355 delay_time:14
x:546 y:369 delay_time:0
x:558 y:383 delay_time:15
x:570 y:397 delay_time:2
x:582 y:411 delay_time:13
x:596 y:427 delay_time:2
x:608 y:443 delay_time:14
x:620 y:459 delay_time:5
x:633 y:476 delay_time:10
x:645 y:490 delay_time:5
x:656 y:503 delay_time:11
x:666 y:515 delay_time:5
x:675 y:527 delay_time:11
x:684 y:538 delay_time:5
x:694 y:551 delay_time:11
x:702 y:565 delay_time:5
x:710 y:577 delay_time:11
x:716 y:588 delay_time:5
x:723 y:598 delay_time:11
x:728 y:606 delay_time:5
x:733 y:615 delay_time:11
x:738 y:622 delay_time:5
x:743 y:631 delay_time:11
x:747 y:637 delay_time:5
x:750 y:644 delay_time:11
x:753 y:652 delay_time:5
x:756 y:659 delay_time:10
x:759 y:666 delay_time:5
x:761 y:673 delay_time:11
x:764 y:680 delay_time:5
x:766 y:687 delay_time:11
x:768 y:694 delay_time:5
x:769 y:701 delay_time:10
x:771 y:708 delay_time:5
x:772 y:714 delay_time:11
x:773 y:722 delay_time:5
x:774 y:729 delay_time:10
x:777 y:743 delay_time:16
x:778 y:755 delay_time:15
x:778 y:764 delay_time:16
x:780 y:775 delay_time:16
x:781 y:784 delay_time:16
x:781 y:785 delay_time:15
x:781 y:789 delay_time:2
x:781 y:790 delay_time:13
x:781 y:792 delay_time:2
x:782 y:796 delay_time:14
x:782 y:796 delay_time:2
x:782 y:797 delay_time:14
x:782 y:798 delay_time:15
x:782 y:800 delay_time:311
x:784 y:800 delay_time:16
x:784 y:800 delay_time:5
x:785 y:800 delay_time:10
x:786 y:800 delay_time:5
x:786 y:800 delay_time:11
x:788 y:800 delay_time:6
x:789 y:800 delay_time:9
x:790 y:800 delay_time:5
x:791 y:800 delay_time:10
x:793 y:800 delay_time:16
x:795 y:800 delay_time:16
x:796 y:800 delay_time:15
x:797 y:800 delay_time:15
x:797 y:800 delay_time:2
x:798 y:800 delay_time:15
x:798 y:800 delay_time:30
x:799 y:800 delay_time:15
x:799 y:800 delay_time:15
*/
————————————————
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 条鼠标轨迹
3cdb6cf550104cd3946b3bf63fd1f772.gif
五.常见问题
1.是否支持多线程
支持
2.如何使用多线程
参考前面的《2.鼠标轨迹API调用流程图》，多线程和单线程类似；如果是多线程,那么每个线程都需要通过apiSNCreateHandle创建HANDLE句柄,这样才能多个线程互不影响
六.更新日志
- 2024.09.28 新增易语言demo
- 2024.09.21 修复部分水平/垂直轨迹出现负数的情况
- 2024.09.19 优化部分轨迹延迟时间为0的情况（可能会造成鼠标瞬移）
- 2024.08.20 优化部分轨迹可能出现负数的问题
- 2024.07.15 优化水平/垂直轨迹
- 2024.06.25 新增错误日志信息
- 2024.06.06 python 模拟人工鼠标轨迹demo
- 2024.02.06 c++ 模拟人工鼠标轨迹demo
