一.简介
鼠标轨迹算法是一种模拟人类鼠标操作的程序,它能够模拟出自然而真实的鼠标移动路径。
鼠标轨迹算法的底层实现采用C/C++语言,原因在于C/C++提供了高性能的执行能力和直接访问操作系统底层资源的能力。
鼠标轨迹算法具有以下优势:
- 模拟人工轨迹:算法能够模拟出非贝塞尔曲线的自然鼠标移动,避免了机械式的直线移动。
- 适当的停顿/加速/减速:算法能够根据需要模拟出鼠标的停顿、加速和减速,使得轨迹更加真实。
- 随机轨迹:在固定两点间,算法能够生成不同的随机轨迹,增加了轨迹的不可预测性。
二.应用场景
要验证京东滑块验证码的轨迹算法,通常涉及到模拟人类用户的行为,即在滑块验证码中滑动鼠标轨迹。这类验证通常是为了防止自动化脚本(如机器人)的滥用。
三.支持多种编程语言
1.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);
#pragma region 鼠标驱动相关
int WINAPI apiSNMouseRightClick(HANDLE handle); // 鼠标右键点击
int WINAPI apiSNMouseLeftClick(HANDLE handle); // 鼠标左键点击
int WINAPI apiSNMouseMoveRelative(HANDLE handle, int dx, int dy); // 鼠标相对移动
int WINAPI apiSNMouseMoveAbsolute(HANDLE handle, int x, int y); // 鼠标绝对移动
int WINAPI apiSNMouseLeftDown(HANDLE handle); // 鼠标按键操作
int WINAPI apiSNMouseLeftUp(HANDLE handle); // 鼠标按键操作
int WINAPI apiSNMouseRightDown(HANDLE handle); // 鼠标按键操作
int WINAPI apiSNMouseRightUp(HANDLE handle); // 鼠标按键操作
#endif // !_SN_SDK_H__
2.其他编程语言
为了易于集成和使用,我们将鼠标轨迹算法封装为DLL(动态链接库)。这种封装方式不仅保留了算法的性能优势,还提供了跨平台和跨语言的兼容性,目前支持编程语言如下:
- C++
- Python
- 易语言
推算轨迹算法耗时均为毫秒级,<= 5ms ,速度超快,fps类型游戏完全无压力!
3.鼠标轨迹API调用流程图
注意:如果是多线程,每个线程都需要通过apiSNCreateHandle创建HANDLE句柄,这样才能多个线程互不影响
4.Python加载C++鼠标轨迹dll接口
/****************************************************************************************/
@SDK功能描述:鼠标轨迹
/******************************************************************************************/
//
from ctypes import cdll, Structure, c_int, c_char, c_char_p, POINTER, create_string_buffer
import ctypes
import platform
import time
class SN_RESULT(ctypes.Structure):
_fields_ = [("code", ctypes.c_int),
("message", ctypes.c_char * 4096)]
class SN_POINT(ctypes.Structure):
_fields_ = [("x", ctypes.c_int),
("y", ctypes.c_int)]
class SN_POINT_PARAMS(ctypes.Structure):
_fields_ = [("point", SN_POINT),
("delayTime", ctypes.c_int)]
class SN_MOUSE_TRACK_SDK:
def __init__(self, key, onnx_path, dll_path):
self.key = key.encode('utf-8')
self.onnx_path = onnx_path.encode('utf-8')
self.sn_sdk = ctypes.WinDLL(dll_path)
self.handle = None
self.result = SN_RESULT()
self._initialize_sdk()
def _initialize_sdk(self):
self.sn_sdk.apiSNCreateHandle.argtypes = [ctypes.POINTER(ctypes.c_char), ctypes.POINTER(ctypes.c_char),
ctypes.POINTER(SN_RESULT)]
self.sn_sdk.apiSNCreateHandle.restype = ctypes.c_void_p
# 检测当前是 x64 还是 x86
print(platform.architecture())
self.handle = self.sn_sdk.apiSNCreateHandle(self.key, self.onnx_path, ctypes.byref(self.result))
if self.result.code != 0:
print(f"Failed to create handle: {self.result.message.decode('gbk', errors='replace')}")
else:
print("sn_sdk.apiSNCreateHandle success")
# 获取版本信息
def get_version(self):
version = ctypes.create_string_buffer(4096)
self.sn_sdk.apiSNGetVersion.argtypes = [ctypes.c_void_p, ctypes.POINTER(ctypes.c_char)]
self.sn_sdk.apiSNGetVersion.restype = ctypes.c_int
if self.handle is None:
print("apiSNCreateHandle fail!")
return ""
result = self.sn_sdk.apiSNGetVersion(self.handle, version)
if result != 0:
raise Exception(f"Failed to get version: {result}")
return version.value.decode()
def set_track_params(self, density, isSliderTrack):
self.sn_sdk.apiSNSetTrackParams.argtypes = [ctypes.c_void_p, ctypes.c_int, ctypes.c_int]
self.sn_sdk.apiSNSetTrackParams.restype = ctypes.c_int
return self.sn_sdk.apiSNSetTrackParams(self.handle, density, isSliderTrack)
def get_key_expires_time(self):
self.sn_sdk.apiSNGetKeyExpiresTime.argtypes = [ctypes.c_void_p, ctypes.POINTER(SN_RESULT)]
self.sn_sdk.apiSNGetKeyExpiresTime.restype = ctypes.c_char_p
if self.handle is None:
print("apiSNCreateHandle fail!")
return ""
return self.sn_sdk.apiSNGetKeyExpiresTime(self.handle, ctypes.byref(self.result))
def move_mouse(self, start_point, end_point, type, num_points=4096):
points_array = (SN_POINT_PARAMS * num_points)()
self.sn_sdk.apiSNMouseMove.argtypes = [ctypes.c_void_p, POINTER(SN_POINT), POINTER(SN_POINT), ctypes.c_int,
POINTER(SN_POINT_PARAMS)]
self.sn_sdk.apiSNMouseMove.restype = ctypes.c_int
if self.handle is None:
print("apiSNCreateHandle fail!")
# 强制给 points_array 赋值
points_array[0].point.x = 10000 # 设置 X 坐标
points_array[0].point.y = 10000 # 设置 Y 坐标
points_array[0].delayTime = 0 # 设置延迟时间
return points_array
result_code = self.sn_sdk.apiSNMouseMove(self.handle, start_point, end_point, type, points_array)
if result_code != 0:
print(f"Failed to move mouse start_point:{start_point.x},{start_point.y} end_point:{end_point.x},{end_point.y} ,Error core:{result_code}")
# 强制给 points_array 赋值
points_array[0].point.x = 10000 # 设置 X 坐标
points_array[0].point.y = 10000 # 设置 Y 坐标
points_array[0].delayTime = 0 # 设置延迟时间
return points_array
# 鼠标左键点击
def leftClick(self):
self.sn_sdk.apiSNMouseLeftClick.argtypes = [ctypes.c_void_p]
self.sn_sdk.apiSNMouseLeftClick.restype = ctypes.c_int
return self.sn_sdk.apiSNMouseLeftClick(self.handle)
# 鼠标左键按下
def leftDown(self):
self.sn_sdk.apiSNMouseLeftDown.argtypes = [ctypes.c_void_p]
self.sn_sdk.apiSNMouseLeftDown.restype = ctypes.c_int
return self.sn_sdk.apiSNMouseLeftDown(self.handle)
# 鼠标左键弹起
def leftUp(self):
self.sn_sdk.apiSNMouseLeftUp.argtypes = [ctypes.c_void_p]
self.sn_sdk.apiSNMouseLeftUp.restype = ctypes.c_int
return self.sn_sdk.apiSNMouseLeftUp(self.handle)
# 鼠标右键点击
def rightClick(self):
self.sn_sdk.apiSNMouseRightClick.argtypes = [ctypes.c_void_p]
self.sn_sdk.apiSNMouseRightClick.restype = ctypes.c_int
return self.sn_sdk.apiSNMouseRightClick(self.handle)
# 鼠标右键按下
def rightDown(self):
self.sn_sdk.apiSNMouseRightDown.argtypes = [ctypes.c_void_p]
self.sn_sdk.apiSNMouseRightDown.restype = ctypes.c_int
return self.sn_sdk.apiSNMouseRightDown(self.handle)
# 鼠标右键弹起
def rightUp(self):
self.sn_sdk.apiSNMouseRightUp.argtypes = [ctypes.c_void_p]
self.sn_sdk.apiSNMouseRightUp.restype = ctypes.c_int
return self.sn_sdk.apiSNMouseRightUp(self.handle)
# 鼠标移动 - 相对坐标
def moveRelative(self,x,y):
self.sn_sdk.apiSNMouseMoveRelative.argtypes = [ctypes.c_void_p, ctypes.c_int, ctypes.c_int]
self.sn_sdk.apiSNMouseMoveRelative.restype = ctypes.c_int
return self.sn_sdk.apiSNMouseMoveRelative(self.handle,x,y)
# 鼠标移动 - 绝对坐标
def mouseAbsolute(self,x,y):
self.sn_sdk.apiSNMouseMoveAbsolute.argtypes = [ctypes.c_void_p, ctypes.c_int, ctypes.c_int]
self.sn_sdk.apiSNMouseMoveAbsolute.restype = ctypes.c_int
return self.sn_sdk.apiSNMouseMoveAbsolute(self.handle,x,y)
def destroy_handle(self):
self.sn_sdk.apiSNDestroyHandle.argtypes = [ctypes.c_void_p]
self.sn_sdk.apiSNDestroyHandle.restype = ctypes.c_int
return self.sn_sdk.apiSNDestroyHandle(self.handle)
if __name__ == "__main__":
# 初始化 SDK - 只需要创建一次,然后通过循环不停的设置开始和结束坐标获取轨迹即可
# 初始化 SDK - 只需要创建一次,然后通过循环不停的设置开始和结束坐标获取轨迹即可
# 初始化 SDK - 只需要创建一次,然后通过循环不停的设置开始和结束坐标获取轨迹即可
# 初始化 SDK - 只需要创建一次,然后通过循环不停的设置开始和结束坐标获取轨迹即可
# 初始化 SDK - 只需要创建一次,然后通过循环不停的设置开始和结束坐标获取轨迹即可
sdk = SN_MOUSE_TRACK_SDK(key="SNKJUMWwseUjELLDsmvxPH1WYNcZAUDbWdYdEgWjUhxL",
onnx_path="d://SNTrack.onnx",
dll_path="d://SNSDK.dll")
# 获取版本号
version = sdk.get_version()
print("SDK Version:", version)
# 设置轨迹参数 ,详细参数解释参考 SNSDK.h
'''
设置轨迹参数,轨迹密度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 倍速度)
isSliderTrack 表示是否为滑块轨迹,0表示默认轨迹,1表示滑块轨迹
'''
sdk.set_track_params(density=5, isSliderTrack=1)
# 获取卡密到期时间
expires_time = sdk.get_key_expires_time()
print("Key expires time:", expires_time)
# 模拟鼠标移动 - 通过设置开始和结束位置,不停获取轨迹(仅仅只是演示代码,只获取一次轨迹)
while True:
start_point = SN_POINT(100, 100)
end_point = SN_POINT(800, 800)
points_array = sdk.move_mouse(start_point, end_point, type=0)
# 打印轨迹点
for i, point in enumerate(points_array):
if point.point.x == 10000 and point.point.y == 10000:
break
print(f"Point {i}: ({point.point.x}, {point.point.y}, {point.delayTime})")
#sdk.mouseAbsolute(point.point.x,point.point.y)
#time.sleep(point.delayTime/1000.0)
# 仅仅只是演示代码,只获取一次轨迹
break
# 销毁句柄
sdk.destroy_handle()
5.云盘源码下载
云盘目录介绍:
demo - 包含各种编程语言的demo
dll - 分别是x86和x64平台所需要的dll/lib/h文件
windows 鼠标轨迹测试工具 - exe测试鼠标轨迹效果( demo 中的 c++ 工程编译后的exe可执行文件)
四.效果演示
五.常见问题
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文字识别失败问题(带有中文路径的图片)
- 2025.04.19
- 新增京东鼠标轨迹
- 新增鼠标驱动(支持x64平台)
七.重要提醒
您好!在使用本算法之前,我们希望您能够仔细阅读并遵守以下条款:
1.合法性声明
本算法仅供学习和研究之用,严禁用于任何非法活动。我们强烈建议您在使用过程中遵守当地法律法规,确保您的行为合法合规。
2.责任声明
如果您选择使用本算法,即表示您已经充分理解并同意,任何因使用本算法而产生的法律后果将由您个人承担。开发者对于任何非法使用行为及其后果不承担任何责任。
3.用途限制
请确保您使用本算法的目的仅限于教育和研究,不得用于任何商业用途或其他未经授权的用途。
4.后果自负
如果您违反上述条款,导致任何法律问题或损失,开发者将不承担任何责任。您将自行承担由此产生的一切后果。
5.开发者声明
开发者提供本算法是为了促进技术交流和知识分享,我们不鼓励、不参与、也不支持任何非法使用行为。
我们感谢您的理解与合作,并希望您在使用本算法的过程中,能够遵守相关法律法规,共同维护一个健康、合法的技术环境。