易语言模拟真人鼠标轨迹算法

一.简介

鼠标轨迹算法是一种模拟人类鼠标操作的程序，它能够模拟出自然而真实的鼠标移动路径。 鼠标轨迹算法的底层实现采用C/C++语言，原因在于C/C++提供了高性能的执行能力和直接访问操作系统底层资源的能力。 鼠标轨迹算法具有以下优势：

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

二.应用场景

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

三.支持多种编程语言

1.C++头文件

// @SDK功能描述：C++鼠标轨迹 // // @SDK功能描述：C++鼠标轨迹 // #ifndef SN_SDK_H_ #define SN_SDK_H_ #include 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.易语言鼠标轨迹dll接口

// @SDK功能描述：鼠标轨迹 / .版本 2 .支持库 spec .程序集 窗口程序集_启动窗口 .子程序 _启动子程序, 整数型 _临时子程序 () 返回 (0) .子程序 _临时子程序 .局部变量 handle, 整数型 .局部变量 pResult, SN_RESULT, 静态, , 返回错误信息，参数pResult.code(错误码)如果为 0 表示成功，否则表示错误号; .局部变量 startPoint, SN_POINT, , , 开始坐标，左上角（0，0），右下角（1920，1080 - 以实际屏幕为准） .局部变量 endPoint, SN_POINT, , , 结束坐标，左上角（0，0），右下角（1920，1080 - 以实际屏幕为准） .局部变量 type, 整数型, , , 轨迹类型，0 为绝对坐标 ，1为相对坐标 .局部变量 points, SN_POINT_PARAMS, , “3000”, 轨迹数组，如果数组中元素 point 出现(10000,10000),表示鼠标轨迹结束 .局部变量 szTime, 文本型, , , 卡密结束时间; .局部变量 index, 整数型 .局部变量 density, 整数型, , , 设置轨迹类型/速度/密度 - 默认是5倍速度/密度，可以不设置，具体根据自身要求设置 ’ ————————————————————— ’ 1.创建句柄 ’ 其中卡密 SNKJ86RYDBY1YxafpLG3ep1R6NHFYLjz2UFFcE8Lx9Tq 仅用于测试，需要找开发人员重新购买，购买卡密连接：https://shop.4yuns.com/links/7C9F16B7 ’ ————————————————————— handle ＝ apiSNCreateHandle (“SNKJ86RYDBY1YxafpLG3ep1R6NHFYLjz2UFFcE8Lx9Tq”, “SNTrack.onnx”, pResult) 调试输出 (pResult.code, 到文本 (pResult.message)) 调试输出 (“句柄”, handle) .如果真 (pResult.code ＜ 0) 调试输出 (“———–程序结束———–”) 返回 () .如果真结束 ’ 获取卡密到期时间 szTime ＝ apiSNGetKeyExpiresTime (handle, pResult) 调试输出 (到文本 (szTime)) ’ 设置轨迹类型/速度/密度 - 默认是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 倍速度） density ＝ 5 apiSNSetTrackParams (handle, density, 0) ’ 开始坐标 startPoint.x ＝ 100 startPoint.y ＝ 100 ’ 结束坐标 endPoint.x ＝ 800 endPoint.y ＝ 800 ’ 轨迹类型，0 为绝对坐标 ，1为相对坐标 type ＝ 0 调试输出 (“预备定义数组数量”, 取数组成员数 (points)) ’ ————————————————————— ’ 2.获取鼠标轨迹 ’ ————————————————————— apiSNMouseMove (handle, startPoint, endPoint, type, points) 调试输出 (取变量地址 (startPoint.x), 取变量地址 (startPoint.y)) .计次循环首 (取数组成员数 (points), index) .如果真 (points [index].point.x ＝ 10000 且 points [index].point.y ＝ 10000) 删除成员 (points, index ＋ 1, 10000 － index) 跳出循环 () .如果真结束 ’ 调试输出 (index, “坐标”, points [index].point.x, points [index].point.y, points [index].delayTime) .计次循环尾 () 调试输出 (取数组成员数 (points)) .计次循环首 (取数组成员数 (points), index) 调试输出 (“坐标”, points [index].point.x, points [index].point.y, points [index].delayTime) .计次循环尾 () ’ ————————————————————— ’ 3.释放内存 ’ ————————————————————— apiSNDestroyHandle (handle) 调试输出 (“———–程序结束———–”)

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）作为轨迹结束的标记，现在修改为（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.滑块验证轨迹 在函数 apiSNSetTrackParams 中 type 参数，0 为普通鼠标轨迹 ; 1 为滑块轨迹

普通鼠标贵和滑块轨迹区别：滑块轨迹比普通鼠标轨迹坐标点更多（相同的开始/结束坐标），点与点之间更加密集，轨迹的开始和结束暂停/加速更加明显

六.更新日志

• 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 支持移动轨迹为相对坐标（默认是轨迹是绝对坐标）
• 2024.12.15 新增文字识别OCR，支持编程语言如下：
• Python
• 易语言
• C语言
• C++
• 2024.12.22 优化鼠标轨迹
• 新增滑块轨迹
• 优化鼠标轨迹 - 支持密度调节
• 2024.12.29
• 修复鼠标轨迹可能会崩溃的问题
• 修复OCR文字识别失败问题（带有中文路径的图片）