Python 模拟真人鼠标轨迹算法 - 防止游戏检测

一.简介

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

鼠标轨迹算法的底层实现采用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功能描述：鼠标轨迹
/******************************************************************************************/
//'''@SDK功能描述：鼠标轨迹'''
from ctypes import cdll, Structure, c_int, c_char, c_char_p, POINTER, create_string_buffer
import ctypes
import os
import sys# 创建句柄
key = "SNKJ86RYDBY1YxafpLG3ep1R6NHFYLjz2UFFcE8Lx9Tq"  # 字符串
key_bytes = key.encode('utf-8')  # 将字符串转换为 bytes# 设置模型文件路径
onnx = "d://SNTrack.onnx"  # 字符串
onnx_bytes = onnx.encode('utf-8')  # 将字符串转换为 bytes# 假设 DLL 文件名为 SNSDK.dll
sn_sdk = ctypes.WinDLL('d://SNSDK.dll')# 定义 SN_RESULT 结构体
class SN_RESULT(ctypes.Structure):_fields_ = [("code", ctypes.c_int),("message", ctypes.c_char * 4096)]# 定义 SN_POINT 结构体
class SN_POINT(ctypes.Structure):_fields_ = [("x", ctypes.c_int),("y", ctypes.c_int)]# 定义 SN_POINT_PARAMS 结构体
class SN_POINT_PARAMS(ctypes.Structure):_fields_ = [("point", SN_POINT),("delayTime", ctypes.c_int)]# 定义函数原型
sn_sdk.apiSNCreateHandle.argtypes = [ctypes.POINTER(ctypes.c_char), ctypes.POINTER(ctypes.c_char),ctypes.POINTER(SN_RESULT)]
sn_sdk.apiSNCreateHandle.restype = ctypes.c_void_psn_sdk.apiSNGetVersion.argtypes = [ctypes.c_void_p, ctypes.POINTER(ctypes.c_char)]
sn_sdk.apiSNGetVersion.restype = ctypes.c_intsn_sdk.apiSNSetTrackParams.argtypes = [ctypes.c_void_p, ctypes.c_int,ctypes.c_int]
sn_sdk.apiSNSetTrackParams.restype = ctypes.c_intsn_sdk.apiSNGetKeyExpiresTime.argtypes = [ctypes.c_void_p, ctypes.POINTER(SN_RESULT)]
sn_sdk.apiSNGetKeyExpiresTime.restype = c_char_psn_sdk.apiSNMouseMove.argtypes = [ctypes.c_void_p, POINTER(SN_POINT), POINTER(SN_POINT), ctypes.c_int, ctypes.POINTER(SN_POINT_PARAMS)]
sn_sdk.apiSNMouseMove.restype = ctypes.c_int  # 根据实际情况调整sn_sdk.apiSNDestroyHandle.argtypes = [ctypes.c_void_p]
sn_sdk.apiSNDestroyHandle.restype = ctypes.c_intresult = SN_RESULT()  # 创建 SN_RESULT 实例
handle = sn_sdk.apiSNCreateHandle(key_bytes, onnx_bytes, ctypes.byref(result))
if result.code != 0:message = result.message.decode('gbk', errors='replace').strip()print("Result message:", message)
else:print("Handle created successfully")# 获取版本号
version = ctypes.create_string_buffer(4096)
version_result = sn_sdk.apiSNGetVersion(handle, version)
if version_result != 0:print("Result message:", version_result)
else:message = result.message.decode('gbk', errors='replace').strip()print("Result message:", version.value.decode())# 获取卡密到期时间
print("key 到期时间:", sn_sdk.apiSNGetKeyExpiresTime(handle, ctypes.byref(result)))'''
设置轨迹参数，轨迹密度density调节，默认5倍速，根据自身需求设置 ,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 倍速度）'''sn_sdk.apiSNSetTrackParams(handle, 5, 0)# 默认5倍速，如果不调节速度/密度的情况下可以不调用# 获取轨迹
# 定义开始和结束坐标
start_point = SN_POINT(100, 100)
end_point = SN_POINT(800, 800)# 轨迹类型： 0 表示绝对坐标   1 表示相对坐标  其他值返回错误
type = 0# 假设返回的轨迹点数量
num_points = 4096# 创建一个数组来接收轨迹点
points_array = (SN_POINT_PARAMS * num_points)()# 调用 apiSNMouseMove 函数
move_result_code = sn_sdk.apiSNMouseMove(handle, start_point, end_point, type, points_array)# 检查结果
if move_result_code != 0:print("apiSNMouseMove error code:", move_result_code)
else:# 遍历并打印每个点for i in range(num_points):# 判断是否轨迹是否结束（x 和 Y 都是 10000 时，轨迹结束）if points_array[i].point.x == 10000 and points_array[i].point.y == 10000:break  # 轨迹结束print(f"Point {i}: ({points_array[i].point.x}, {points_array[i].point.y},{points_array[i].delayTime})")  # X坐标 ,Y坐标 ,延时时间# 释放句柄
destroy_result_code = sn_sdk.apiSNDestroyHandle(handle)
if destroy_result_code != 0:print("apiSNDestroyHandle error code:", destroy_result_code)
else:print("Handle destroyed successfully")'''
输出鼠标轨迹如下：Handle created successfully
Result message: 1.0
Point 0: (100, 100,0)
Point 1: (100, 98,10)
Point 2: (103, 98,15)
Point 3: (111, 98,16)
Point 4: (116, 101,15)
Point 5: (122, 104,2)
Point 6: (129, 107,13)
Point 7: (135, 109,2)
Point 8: (144, 112,14)
Point 9: (155, 117,2)
Point 10: (167, 123,14)
Point 11: (180, 128,2)
Point 12: (193, 134,13)
Point 13: (209, 138,2)
Point 14: (225, 144,13)
Point 15: (238, 149,5)
Point 16: (254, 157,10)
Point 17: (269, 162,5)
Point 18: (282, 168,11)
Point 19: (298, 175,5)
Point 20: (311, 180,10)
Point 21: (326, 185,6)
Point 22: (341, 193,9)
Point 23: (369, 211,15)
Point 24: (396, 231,16)
Point 25: (419, 251,16)
Point 26: (442, 270,16)
Point 27: (461, 285,17)
Point 28: (481, 300,15)
Point 29: (491, 311,15)
Point 30: (502, 319,2)
Point 31: (513, 329,14)
Point 32: (523, 343,2)
Point 33: (535, 355,14)
Point 34: (546, 369,0)
Point 35: (558, 383,15)
Point 36: (570, 397,2)
Point 37: (582, 411,13)
Point 38: (596, 427,2)
Point 39: (608, 443,14)
Point 40: (620, 459,5)
Point 41: (633, 476,10)
Point 42: (645, 490,5)
Point 43: (656, 503,11)
Point 44: (666, 515,5)
Point 45: (675, 527,11)
Point 46: (684, 538,5)
Point 47: (694, 551,11)
Point 48: (702, 565,5)
Point 49: (710, 577,11)
Point 50: (716, 588,5)
Point 51: (723, 598,11)
Point 52: (728, 606,5)
Point 53: (733, 615,11)
Point 54: (738, 622,5)
Point 55: (743, 631,11)
Point 56: (747, 637,5)
Point 57: (750, 644,11)
Point 58: (753, 652,5)
Point 59: (756, 659,10)
Point 60: (759, 666,5)
Point 61: (761, 673,11)
Point 62: (764, 680,5)
Point 63: (766, 687,11)
Point 64: (768, 694,5)
Point 65: (769, 701,10)
Point 66: (771, 708,5)
Point 67: (772, 714,11)
Point 68: (773, 722,5)
Point 69: (774, 729,10)
Point 70: (777, 743,16)
Point 71: (778, 755,15)
Point 72: (778, 764,16)
Point 73: (780, 775,16)
Point 74: (781, 784,16)
Point 75: (781, 785,15)
Point 76: (781, 789,2)
Point 77: (781, 790,13)
Point 78: (781, 792,2)
Point 79: (782, 796,14)
Point 80: (782, 796,2)
Point 81: (782, 797,14)
Point 82: (782, 798,15)
Point 83: (782, 800,311)
Point 84: (784, 800,16)
Point 85: (784, 800,5)
Point 86: (785, 800,10)
Point 87: (786, 800,5)
Point 88: (786, 800,11)
Point 89: (788, 800,6)
Point 90: (789, 800,9)
Point 91: (790, 800,5)
Point 92: (791, 800,10)
Point 93: (793, 800,16)
Point 94: (795, 800,16)
Point 95: (796, 800,15)
Point 96: (797, 800,15)
Point 97: (797, 800,2)
Point 98: (798, 800,15)
Point 99: (798, 800,30)
Point 100: (799, 800,15)
Point 101: (799, 800,15)
Handle destroyed successfullyProcess finished with exit code 0'''

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.滑块验证轨迹

在函数 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文字识别失败问题（带有中文路径的图片）