this Chinese, Click to English
通过图像匹配算法，从原神客户端中获取角色在地图上的位置的DLL动态链接库
联系 QQ群717355752
| 原神版本 | 地图区域 | dll版本 |
|---|---|---|
| 1.0 | 蒙德、雪山、璃月 | - |
| - | 稻妻I、稻妻II、稻妻III(鹤观)、稻妻IIII(渊下宫)、璃月II(层岩)、璃月III(地下层岩) | - |
| 3.0 | 须弥 | 6.1.51 |
| 3.1 | 须弥沙漠 | 6.4.17 |
| 3.4 | 千壑沙地 | 7.4.0 |
| 3.6 | 苍漠罗囿 | 7.7.2 |
| 版本 | 键盘模式 | 手柄模式 | 分辨率支持列表 |
|---|---|---|---|
| 6.4.x | √ | × | 1920x1080 |
| 6.5.39 | √ | × | 1920x1080, 2560x1440, 2560x1080 |
| 6.5.92 | - | - | - |
| 7.0.1 | √ | √(DX模式下不支持) | 16:9 系列(但不包括4K及以上), 21:9 系列, 以及1920*1080以下的所有分辨率 |
| 7.3.0 | √ | √ | √(有用户反馈5k 21:9无法使用，待测试） |
| 7.3.0 | √ | √ | √ |
- 添加对秘境中的角度和视野识别
- 实现无透明通道下的视野识别
- 实现日志可控制不输出
- 添加定位的惯性加速度导航算法（见 dev-inrtial-position 分支）
- 添加定位的自动校准算法
- 支持任意地图区域
- 支持传入地图而非内嵌
- 可选的嵌入预计算结果
- 更高的匹配精度
- 使用二进制文件而不是xml序列化追踪特征点
- 下载编译好的动态链接库。
- 装载动态链接库后，根据函数手册对相关函数进行调用或封装。
- 部分语言的调用可参见
impl文件夹内的调用示例。 - 由于默认接口输出的是天理坐标模型的坐标，所以使用者需要根据自身地图坐标系与天理坐标模型之间的映射关系，设置世界中心以及缩放系数或者后期手动换算。
-
安装 Visual Studio 2019 +
-
创建 Opencv 库的环境变量，若不使用环境变量则需要手动修改 cvAutoTrack 项目的
附加包含目录和附加库目录$OpenCvDir = C:\projects\opencv\ -
下载 Opencv 4.5.0 static lib zip 并解压到任意目录
7z x ./*.zip -y -o%OpenCvDir% -
Clone 代码
Git Clone https://github.com/GengGode/cvAutoTrack -
进入项目文件夹解压资源文件
cd .\cvAutoTrack | 7z -x resource.zip -
编译项目
msbuild cvAutoTrack.sln
- 目前只编译了 Windows x64 平台上的动态链接库（.dll），对于 Windows x86 或其它平台，如 Linux 平台（.so），需要下载源代码另行编译。
- 本项目借游戏画面的窗口截图进行图像处理算法以实现所有功能，其不会对游戏内存进行读写，因而不会有封号的风险，但效果也因此具备一定的局限。
- 项目仅在有限的条件下测试过，如需排查错误，强烈建议按照以下描述进行环境配置。
- 原神客户端 > 右上角派蒙 > 设置 > 抗锯齿，设置为
SMAA - 原神客户端 > 右上角派蒙 > 设置 > 其他 > 小地图锁定，设置为
锁定方向
- 原神客户端 > 右上角派蒙 > 设置 > 抗锯齿，设置为
- 码云上的仓库：https://gitee.com/Yu_Sui_Xian/yuanshen-auto-tracking-dll
- Git上的仓库： https://github.com/GengGode/cvAutoTrack
- cvAutoTrack，dll工程
- doc，文档及部分插图
- impl，部分语言的调用示例
- Cpp/TEST_cvAutoTrack_Cpp C++调用
- CSharp/TEST_cvAutoTrack_CSharp C#调用
- Python Python调用
函数目录( 详细文档 )
| 接口名称 | 接口功能 |
|---|---|
verison |
获取Dll版本。 |
init |
初始化运行环境。 |
uninit |
卸载初始化时所占用的内存。 |
startServe |
（未完成）开始服务，开启循环检测线程。 |
stopServe |
（未完成）停止服务，停止循环检测线程。 |
| ... | ... |
GetCompileVersion |
获取编译版本号信息。 |
GetCompileTime |
获取编译时间信息。 |
| ... | ... |
SetUseBitbltCaptureMode |
设置使用Bitblt截图，默认启用，速度较快，效果好，但某些系统不支持。 |
SetUseDx11CaptureMode |
设置使用DirectX截图，效果较差，但支持win11及以上系统。 |
SetHandle |
设置原神客户端的窗口句柄。 |
SetWorldCenter |
设置映射目标地图坐标系的原点中心所在天理坐标模型中的坐标。 |
SetWorldScale |
设置映射目标地图坐标系缩放系数与所在天理坐标模型缩放系数的的比值。 |
| ... | ... |
SetDisableFileLog |
设置禁用日志文件。 |
SetEnableFileLog |
设置启用日志文件。 |
| ... | ... |
DebugCapture |
获取本地视频中的UID、当前人物所在位置以及角度（箭头朝向）并保存至文本中。 |
DebugCapturePath |
获取本地视频中的UID、当前人物所在位置以及角度（箭头朝向）并保存至指定路径中。 |
| ... | ... |
GetTransformOfMap |
获取当前人物所在位置、角度（箭头朝向）及所在地图区域并重映射坐标区域。 |
GetPositionOfMap |
获取所在位置的所在地图区域并重映射坐标区域。 |
GetDirection |
获取当前角度（箭头朝向）。 |
GetRotation |
获取当前视角方位（视角朝向）。 |
GetStar |
获取小地图上可见的神瞳。 |
GetStarJson |
获取小地图上可见的所有神瞳。 |
GetUID |
获取在屏幕右下角显示的玩家的UID。 |
GetAllInfo |
获取所在位置、地图区域、角度、视角和UID。所有信息的最新的状态。 |
| ... | ... |
GetInfoLoadPicture |
获取本地图片中的UID、当前人物所在位置以及角度（箭头朝向）。 |
GetInfoLoadVideo |
获取本地视频中的UID、当前人物所在位置以及角度（箭头朝向）并保存至文本中。 |
| ... | ... |
GetLastErr |
获取最后设置的错误码。 |
GetLastErrMsg |
获取最后设置的错误信息。 |
GetLastErrJson |
获取错误码堆栈信息。 |
由于原神游戏中地图会不断扩展，而且不同的物理区块对应的地图贴图分辨率存在差异，所以直接根据贴图像素坐标系不可取，对未来的扩展不利
所以设计出与像素位置无关的坐标模型，暂称为“天理坐标”，开发者需要写转换算法，以将“天理坐标”转换为自己软件的地图坐标系。
天理坐标的规则如下。
由于提瓦特大陆四周会不断扩展，所以需要定义一个恒定的原点，使扩展后旧地图的坐标不变。
目前将原点定义在璃月港玉京台的香炉所在位置，向右为x正方向，向下为y正方向。
作为参考，天守阁“女士”周本的精确坐标为(x=9894,y=5458)
特殊地区的范围一般不会发生变化。以下定义一系列参考图，其左上角坐标为(0,0)，右下角坐标如下给出。
如果自己的地图软件使用的参考图不一致，需要额外做适当的换算。
- 参考图
- 地图id: 1
- 右下角坐标：x = y = 2400
- 参考图
- 地图id: 2
- 右下角坐标：x = y = 1700