易語言模擬真人鼠標軌跡算法

一.簡介

鼠標軌跡算法是一種模擬人類鼠標操作的程序，它能夠模擬出自然而真實的鼠標移動路徑。

鼠標軌跡算法的底層實現采用C/C++語言，原因在于C/C++提供了高性能的執行能力和直接訪問操作系統底層資源的能力。

鼠標軌跡算法具有以下優勢：

模擬人工軌跡：算法能夠模擬出非貝塞爾曲線的自然鼠標移動，避免了機械式的直線移動。
適當的停頓/加速/減速：算法能夠根據需要模擬出鼠標的停頓、加速和減速，使得軌跡更加真實。
隨機軌跡：在固定兩點間，算法能夠生成不同的隨機軌跡，增加了軌跡的不可預測性。

二.應用場景

游戲鼠標軌跡檢測（檢測能過無畏fps類型、傳奇、夢幻等游戲，已經在游戲中驗證）
滑塊拖動驗證
部分網頁鼠標軌跡檢測

三.支持多種編程語言

1.C++頭文件

/******************************************************************************************/@SDK功能描述：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.易語言鼠標軌跡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.云盤源碼下載

百度云盤
夸克云盤
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.滑塊驗證軌跡