GenshinImpact AutoTrack DLL

一个通过opencv图像匹配算法，从原神客户端中获取角色在地图上的位置的DLL动态链接库。

支持原神2.1稻妻地图，扩展了城镇中的稳定性，为此定位的整体稳定性略有下降。

地图目前支持至原神2.1版

如何使用

1. 下载编译好的动态链接库。
   • https://pan.baidu.com/s/1y-lgkGiyIJPa3_y0aRlOnQ（提取码：e7zv）
   • https://github.com/GengGode/GenshinImpact_AutoTrack_DLL/releases/
2. 装载动态链接库后，根据函数手册对相关函数进行调用或封装。
3. 部分语言的调用可参见 impl 文件夹内的调用示例。
4. 由于默认接口输出的是天理坐标模型的坐标，所以使用者需要根据自身地图坐标系与天理坐标模型之间的映射关系，设置世界中心以及缩放系数或者后期手动换算。

注意事项

• 目前只编译了 Windows x64 平台上的动态链接库（.dll），对于 Windows x86 或其它平台，如 Linux 平台（.so），需要下载源代码另行编译。
• Windows 规定 64位 进程/DLL与 32位 进程/DLL之间不能相互调用/加载，因此调用动态链接库前，请务必确保调用进程是 64位进程 。
• 本项目借游戏画面的窗口截图进行图像处理算法以实现所有功能，其不会对游戏内存进行读写，因而不会有封号的风险，但效果也因此具备一定的局限。
• 项目仅在有限的条件下测试过，如需排查错误，强烈建议按照以下描述进行环境配置。
  • 原神客户端 > 右上角派蒙 > 设置 > 抗锯齿，设置为 SMAA
  • 原神客户端 > 右上角派蒙 > 设置 > 分辨率，设置为 1920x1080

对于开发者

• 码云上的仓库：https://gitee.com/Yu_Sui_Xian/yuanshen-auto-tracking-dll
• Git上的仓库： https://github.com/GengGode/GenshinImpact_AutoTrack_DLL

项目结构

• cvAutoTrack，dll工程
• cvAT_dllTest，C++下调用dll的测试工程
• impl，部分语言的调用示例。

函数目录

函数手册

init

bool init();

初始化运行环境。

返回值

• true 表示初始化完毕。当前处在 已初始化 状态。
• false 表示初始化失败。当前处在 未初始化 状态。

说明

部分函数需要初始化后才能调用，具体见 函数手册 其它函数。

经过简单测试，初始化的过程大概会持续1-10秒，内存占用峰值约为 1 GB，之后稳定在 270 MB 左右。

已经处在 已初始化 状态则不会进行任何操作。

uninit

bool uninit();

卸载初始化时所占用的内存。

返回值

• true 表示卸载成功，所有需要初始化后才能调用的函数此时不能再被调用。当前处在 未初始化 状态。
• false 表示卸载失败。当前处在 已初始化 状态。

说明

已经处在 未初始化 状态则不会进行任何操作。

GetLastErr

int GetLastErr();

获取最后设置的错误码。

返回值

返回一个整数，表示错误码。错误码含义如下：

说明

由于函数成功执行后可能不会将错误码设为 0 ，以及一些函数不会设置错误码，因此取出的错误码不一定代表前一条函数产生/引发的错误。

SetHandle

bool SetHandle(
    long long int handle
);

设置原神客户端的窗口句柄。

参数

• handle 原神客户端的窗口句柄。如果提供非零值，则程序不再自动获取窗口句柄，如果提供 0，则自动获取。

返回值

• true 表示提供的值是窗口句柄。
• false 表示提供的值并不是窗口句柄。

说明

某些原神数据的获取是基于原神客户端的，因此需要一个客户端的窗口句柄。默认情况下此句柄由程序自动获取，但有可能会因为编码问题或其它未知的原因而获取不到，此时就需要手动指定客户端的窗口句柄。

注意，不论本函数返回何值，handle 只要不是 0，就会被设置为窗口句柄，并禁止自动获取窗口句柄。

SetWorldCenter

bool SetWorldCenter(
	double x,
	double y
);

设置映射目标地图坐标系的原点中心所在天理坐标模型中的坐标。

参数

• x 原点在天理坐标模型的横坐标。
• y 原点在天理坐标模型的纵坐标。

返回值

• true 表示设置成功。
• false 表示程序出现预料之外的异常（理论上永不出现）。

说明

要从天理坐标模型映射至目标地图模型时，将目标地图模型的原点在天理坐标模型的对应坐标传入函数，输出即被转换为该坐标为中心。

SetWorldScale

bool SetWorldScale(
	double scale
);

设置映射目标地图坐标系缩放系数与所在天理坐标模型缩放系数的的比值。

参数

• scale 放大scale倍即为天理坐标模型缩放系数。

返回值

• true 表示设置成功。
• false 表示程序出现预料之外的异常（理论上永不出现）。

说明

映射目标地图坐标系缩放系数与所在天理坐标模型缩放系数的的比值。

GetTransform

bool GetTransform(
    float &x,
    float &y,
    float &a
);

获取当前人物所在位置以及角度（箭头朝向）。

参数

• x 获取到的人物的x轴坐标位置。
• y 获取到的人物的y轴坐标位置。
• a 获取到的角度。

返回值

• true 表示获取成功。
• false 表示获取失败，此时三个参数均不会被改变。

说明

无论成功与否都会设置 LastErr 值。调用 GetLastErr() 可以获取错误码。

GetPosition

bool GetPosition(
    double &x,
    double &y
);

获取当前人物所在位置。

参数

• x 获取到的人物的x轴坐标位置。
• y 获取到的人物的y轴坐标位置。

返回值

• true 表示坐标位置获取成功。
• false 表示坐标位置获取失败，此时两个参数均不会被改变。

说明

输出结果前进行了卡尔曼滤波，提高了定位精度。

无论成功与否都会设置 LastErr 值。调用 GetLastErr() 可以获取错误码。

调用本函数前，如果没有初始化过，或最后一次初始化返回失败，则需要调用 init() 函数进行初始化。

GetDirection

bool GetDirection(
    double &a
);

获取当前角度（箭头朝向）。

参数

• a 获取到的角度。

返回值

• true 表示获取成功。
• false 表示获取失败，此时参数不会被改变。

说明

无论成功与否都会设置 LastErr 值。调用 GetLastErr() 可以获取错误码。

GetRotation

bool GetRotation(
    double &a
);

获取当前视角方位（视角朝向）。

参数

• a 获取到的角度。

返回值

• true 表示获取成功。
• false 表示获取失败，此时参数不会被改变。

说明

无论成功与否都会设置 LastErr 值。调用 GetLastErr() 可以获取错误码。

GetUID

bool GetUID(
    int &uid
);

获取在屏幕右下角显示的玩家的UID。

参数

• uid 获取到的玩家UID。

返回值

• true 表示获取成功。
• false 表示获取失败，此时参数不会被改变。

说明

无论成功与否都会设置 LastErr 值。调用 GetLastErr() 可以获取错误码。

GetInfoLoadPicture

bool GetInfoLoadPicture(
    char* path,
    int &uid,
    double &x,
    double &y,
    double &a
);

获取本地图片中的UID、当前人物所在位置以及角度（箭头朝向）。

参数

• path 输入图片文件路径
• uid 获取到的玩家UID。
• x 获取到的人物的x轴坐标位置。
• y 获取到的人物的y轴坐标位置。
• a 获取到的角度。

返回值

• true 表示获取成功。
• false 表示获取失败，此时四个输出参数均不会被改变。

说明

无论成功与否都会设置 LastErr 值。调用 GetLastErr() 可以获取错误码。

GetInfoLoadPicture

bool GetInfoLoadVideo(
    char* path,
	char * pathOutFile
);

获取本地视频中的UID、当前人物所在位置以及角度（箭头朝向）并保存至文本中。

参数

• path 输入视频文件路径
• pathOutFile 输出的路径数据保存文件路径

返回值

• true 表示写入成功。
• false 表示写入失败。

说明

写入文本格式如下：

| int Time | int uid | double x | double y| double a | 

无论成功与否都会设置 LastErr 值。调用 GetLastErr() 可以获取错误码。

天理坐标模型

由于原神游戏中地图会不断扩展，而且不同的物理区块对应的地图贴图分辨率存在差异，所以直接根据贴图像素坐标系不可取，对未来的扩展不利。

所以目前根据原神2.0版本已有的地图区块，规划出了一个较为合理且易于扩展的地图模型，称为天理坐标模型。

之后所有关于地图坐标的接口都会默认以该坐标系输出。

目前模型以游戏中城镇位置的贴图缩放为标准缩放尺寸，即没有放大缩小的尺寸。

根据该尺寸将其他贴图一同缩放到相同比例下，最后拼合成为总图，此时的缩放系数即为天理坐标模型的缩放系数。

在该缩放系数下，原神2.1版本中，总图尺寸为 之后选择位于璃月的请仙典仪祭坛中心作为世界原点，即( 0 , 0 )。

之后为了便于Opencv的坐标计算，设定为地图从蒙德到璃月，是横坐标正方向。

地图从璃月到稻妻，是纵坐标正方向。

即

即将更新

bool startSever();

开始服务，开启循环检测线程。

bool stopSever();

停止服务，停止循环检测线程

bool getAllInfo(double &x,double &y,double &a,int &uid);

获取所有信息，得到最新的状态数据