Skip to content

Commit

Permalink
Update position-tracking.md (#253)
Browse files Browse the repository at this point in the history
  • Loading branch information
@boxsnake
boxsnake authored Jun 9, 2024
2 parents 4f8af4f + e00ea74 commit 451fb91
Showing 1 changed file with 102 additions and 178 deletions.
280 changes: 102 additions & 178 deletions src/zh/manual/client/position-tracking.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -6,263 +6,187 @@ title: 位置追踪

[文：【位置追踪】注意事项]: # 'https://support.qq.com/products/321980/faqs/102055'

## 使用说明
​## 简介

- 在开启位置追踪后，《空荧酒馆》会实时获取游戏中玩家的位置，并在地图中显示小箭头，帮助玩家拖动地图并显示自己的位置，以方便玩家更快的找到需要标记的点位。
本功能用于在空荧酒馆中同步显示玩家在游戏中的坐标，以方便查找附近的宝箱。本功能基于图像识别实现，不是外挂，不会导致封号，但识别精度有限。

## 特性 {#capabilities}

- 本功能基于【图像识别】技术实现，不会侵入游戏进程，请放心使用，
- 离线工作，可支持大部分原神客户端的匹配，不限服务器和语言
- 适配多种屏幕比例
- 支持全地区追踪，包括渊下宫，层岩巨渊和4.0之后的地下分层地图。目前自动切换层级功能在开发中

## 开启

成功开启位置追踪后，

- 【地图客户端】右下角会**显示 UID**
- 基于OCR识别，没有读取在线数据
- 在窗口模式下，uid可能会因为标题栏的挤压显示在屏幕外面，可能会影响到uid的识别，但不会影响到追踪
- 筛选列表下方显示**位置追踪版本**

![image](https://github.com/Sallee1/docs/assets/99392726/b9c6cbbd-430b-4886-ac70-ee4bc9f27633)

- 自动检测游戏内**当前角色位置**（小地图坐标位置）并同步显示到【地图客户端】上（像游戏内地图一样）

![](/imgs/zh/manual/auto-tracking/autotrackingegaged.png)

---

[见：位置追踪问题排查.docx]: # '以下为 位置追踪支持列表： 内容'

## 支持的程序 {#Software}

- Windows10/11 下的原神Unity客户端
- 【已不再支持】云原神（_云原神有反录屏，无法获取到截图_）

---

## 推荐画面设置 {#Graphics}

- 支持任意分辨率（不小于 1280x720，建议1920x1080以上）
- 支持任意画面比例（推荐画面比例在 4:3~21:9 之间）
- 如果画面是小于16:9的窄屏，则按照宽度固定计算等效分辨率
- 如果画面是大于16:9的带鱼屏，则按照高度固定计算等效分辨率
- 支持手柄、键鼠
- 支持独占全屏和窗口（建议使用“[无边框窗口](/manual/client/fullscreen-windowed)”代替全屏模式）
- 小地图仅支持锁定方向，不支持锁定玩家视角
- 不支持秘境，室内等有独立地图的区域
- 不要使用可能影响屏幕色彩的软件，包括但不限于：
- 第三方校色软件
- 第三方亮度调节软件
- Windows 11 自动 HDR (影响角度定位精确度)
- 开启了护眼
- 显卡滤镜

## 无法追踪怎么办

参见：[【位置追踪】注意事项](/manual/client/position-tracking)

## 问题反馈 {#Troubleshooting}

1. 位置追踪基于图像识别，不会侵入游戏进程，不存在封号的风险，如果出现封号问题，请联系官方客服，可能是其他软件导致的误封禁。
2. 图像识别的准确度并不高，可能会出现抖动，延迟这个属于图像识别本身的缺陷，无法完全解决
3. 在反馈之前，请确定程序和画面设置没有问题
4. 在反馈问题前，请确保了解位置追踪产生的日志文件，以方便为开发组排查问题:

**追踪日志：**

```
<地图安装目录>/AutoTrack.log
```

可用记事本打开的文本文件（建议使用第三方文本编辑器，如 notepad3,vscode）

**追踪截图：**

```
<地图安装目录>/capture.png
```

png 图像，用来排查 UI 定位的问题。因为带有 Alpha 通道，所以可能会有很大的色差，用 PS 打开或者粘贴到 QQ 上既可正常显示游戏画面

**定位缓存：**

```
<地图安装目录>/cvAutoTrack.xml
```

后缀为xml，实际上是二进制文件，用于对匹配加速

如果坐标不准确或者新地图无法追踪，可以尝试删除，会重新生成
若想使用本功能，请确认：

**崩溃镜像：**
* 您的操作版本至少是**win10或以上版本**（win7不支持追踪）
* 使用**官方正版原神客户端**，不限服务器，支持Unity客户端和云原神客户端。
* 支持非官方启动器，只要游戏本体是官方正版即可。
* 游戏内【解锁神像点亮地图】，游戏内【左上角小地图】完整
* 游戏内【左上角小地图】中，无大面积遮挡（如黄色的任务范围圆圈），设置为北向上
* 未开启显卡滤镜或者其他会影响到画面颜色的选项。
* 可支持独占全屏，推荐使用【无边框全屏】模式运行游戏。

```
<地图安装目录>/cvAutoTrack-[时间].dmp
```
## 基础说明

位置追踪崩溃后自动生成的文件，如果近期没有出现崩溃的问题，可以删除
成功开启位置追踪后，菜单左下角会出现自动追踪版本号。

**【注意】：如果反馈群要求发送追踪截图，请不要使用截图，拍屏或者用 qq 的发送图片功能，必须要以文件的方式发送图像。可以将追踪截图的文件直接拖到聊天框来发送文件。**
​​![image](https://github.com/Sallee1/docs/assets/99392726/4cdb4060-6aee-4ebf-9475-df58968266ad)

[反馈方式]: # '最适合目标语言用户的反馈方式'
将实时识别游戏内**当前角色位置**（小地图坐标位置）并同步显示到【地图客户端】上（像游戏内地图一样）。以便于对照地图，防止迷路。

### 请确保问题排查的措施都尝试过，依然没有解决问题后再尝试在[开发反馈 QQ 群：228382171](https://jq.qq.com/?_wv=1027&k=EqhYN9uI)反馈相关问题。
![image](https://github.com/Sallee1/docs/assets/99392726/e23d5c97-9951-4f37-a33b-f39b4ba01521)

## 帮助开发
## 云原神客户端使用说明

仓库地址：https://github.com/GengGode/cvAutoTrack
只有7.14.2及以上版本的位置追踪对云原神做了适配，在使用之前，请确认你的位置追踪是最新版本。

位置追踪基于 **C++和OpenCV** 技术栈，如果你想参与到**空荧酒馆原神地图**位置追踪模块的开发，可以[点击这里](https://qm.qq.com/cgi-bin/qm/qr?k=wXbtoDmXCjlR8iJ-3lRwdNIOWio3quit&jump_from=webapi&authKey=aS/Be7vKSbcu/6zrmYVlpF6DsSnkHVMGT6Arn+RU+IiJf8ItKIFEXnVvfFmOL9We)加入到开发组。或者自行fork修改
建议在游戏启动之后再开启位置追踪，以防识别到错误的窗口。

[文：位置追踪问题排查.docx]: # '以下为“问题排查”内容'
云原神只支持**DirectX**截图模式，在开启位置追踪前，请在设置->位置追踪->截图模式中，将bitblt切换为DirectX。

```card
theme: medium
title: 官方开发反馈 QQ 群
desc: 228382171（https://jq.qq.com/?_wv=1027&k=EqhYN9uI）
link: https://jq.qq.com/?_wv=1027&k=EqhYN9uI
```
![image](https://github.com/Sallee1/docs/assets/99392726/2b2c18fc-abd6-4c17-a08e-88521f918ed1)

## 简介
此外，为了确保追踪可用，请确定：

本功能基于【图像识别】技术实现。不是外挂，不会导致封号。
* 分辨率大于等于1920x1080，窗口或全屏均可
* 画质在“标清”以上，越高越好
* 如果有“画质增强Beta”选项，可尝试开启

若想使用本功能，请确认：
## 扩展使用

- 您的操作版本至少是win10或以上版本（win7不支持追踪）
- 使用原神客户端，不限服务器，不支持云游戏
- 游戏内【解锁神像点亮地图】，游戏内【左上角小地图】完整。
- 游戏内【左上角小地图】中，无大面积遮挡（如黄色的任务范围圆圈）
- 可支持独占全屏，推荐使用【[无边框全屏](http://support.qq.com/products/321980/faqs/97887)】模式运行游戏。
* 可在设置中开启【窗口置顶】，并拖动缩小地图窗口，以替代游戏内小地图
* 可在设置中开启【覆盖模式】，可自行设置触发快捷键，以替代游戏内大地图

## 基础说明
## 注意事项

成功开启位置追踪后，菜单左下角会出现自动追踪版本号。
### 自动追踪无反应

![192584e1056ce0916dc418c79e942977.png](https://txc.gtimg.com/data/321980/2023/0825/192584e1056ce0916dc418c79e942977.png)
* Win11系统可能由于使用了「窗口化游戏优化」导致追踪失败，在图形设置中开启「不使用窗口化游戏优化」（见下图）

将实时识别游戏内当前角色位置（小地图坐标位置）并同步显示到【地图客户端】上（像游戏内地图一样）。以便于对照地图，防止迷路。
* 如果图像设置中没有「原神」，可以将“<游戏安装目录>/Genshin Impact Game/YuanShen.exe”添加到列表中。

![fd745ec564afdff997a49957a17f4080.png](https://txc.gtimg.com/data/321980/2021/0611/fd745ec564afdff997a49957a17f4080.png)
![image](https://github.com/Sallee1/docs/assets/99392726/374bf277-55d4-4117-9429-e4f840d4127e)

## 扩展使用
* 如果自动追踪长时间没反应，或者出现原地卡死，可使用菜单中的“追踪截图”功能获取追踪截图，并选择“截图目录”查看。
* 如果追踪截图空白，或者追踪截图截取的是很久以前的画面，启动器的画面，空荧酒馆的画面，请尝试重启空荧酒馆客户端。如果依然无效，可以更换截图模式。
* 由于系统兼容性问题，我们提供了两种追踪模式：Bitblt、DirectX，两种模式**除兼容性外无区别**，任何一种模式能用即可。
* 如果能正常截图，但依然出现原地卡死，请检查地图是否是**北向上，分辨率是否过小（不小于1280x720，建议1920x1080以上），地图是否解锁，是否有大面积遮挡，是否有显著的特征。**若调整后依旧无法追踪，请参见文末提交反馈。
* 开启了滤镜或者HDR可能会导致无法追踪。如果追踪截图与原版画面相比有很大的色差，请关闭后试试。

可在设置中开启【窗口置顶】，并拖动缩小地图窗口，以替代游戏内小地图
### 自动追踪坐标错误

可在设置中开启【覆盖模式】，可自行设置触发快捷键，以替代游戏内大地图
* 表现为箭头能跟着角色移动，没有晃动等异常情况，但坐标偏差很大（比如人在璃月港，箭头却在层岩巨渊）。
* 或者已经更新到新版本，但新地图依然无法追踪
* 重启地图客户端，在设置中选择「清理定位缓存」后重新开启即可。

## 注意事项
### 自动追踪晃动，速度慢

### 自动追踪无反应
限于算法限制，晃动和延迟很难避免，一般10m以内算正常误差

- Win11系统可能由于使用了「窗口化游戏优化」导致追踪失败，在图形设置中开启「不使用窗口化游戏优化」（见下图）
目前存在的问题如下：

- 如果图像设置中没有「原神」，可以将“<游戏安装目录>/Genshin Impact Game/YuanShen.exe”添加到列表中。
* 为了尽量减少晃动，输出结果进行了滤波，在移动时可能会出现轻微的惯性。
* 对于形状比较规则的区域（梅洛彼得堡，赤王遗迹群等）识别精度可能会大幅度下降。
* 特征不明显的区域（沙漠，平原，海洋等），坐标偏移比较严重
* 因为视角扇形的遮挡，原地转动视角可能会导致追踪小箭头抖动。

![7c54b7ab7d92dcf0885fddb388bde9e3.jpeg](https://txc.gtimg.com/data/321980/2023/0225/7c54b7ab7d92dcf0885fddb388bde9e3.jpeg)
以下是减轻晃动的几个建议：

- 如果自动追踪长时间没反应，或者出现原地卡死，可使用菜单中的“追踪截图”功能获取追踪截图，并选择“截图目录”查看。如果追踪截图空白，或者与当前地图不符，可能是截图模式不兼容当前系统，更换截图模式即可。
* 如果能正常截图，但时常出现乱晃的现象，请检查**分辨率是否过小（不小于1280x720，建议1920x1080以上），小地图是否解锁，是否有大面积遮挡，是否有显著的特征**。
* 若开启**滤镜、HDR**等改变色彩显示的功能，则可能会影响到自动追踪的精度。
* **后台暂停**会导致位置追踪也同时暂停，可能会导致切地图时，追踪延迟变高。
* 在配置允许的情况下，将追踪间隔调到0.1秒，能比较好的改善延迟高的问题。
* 如果在某一个区域，长时间没反应（超过3分钟以上），或者箭头跑到地图外面，请于文末与开发者联系反馈。

- 由于系统兼容性问题，我们提供了两种追踪模式：Bitblt、DirectX，两种模式除兼容性外无区别，任何一种模式能用即可。
### 自动追踪崩溃

- 如果能正常截图，但依然出现原地卡死，请检查分辨率是否过小（不小于1280x720，建议1920x1080以上），小地图是否解锁，是否有大面积遮挡，是否有显著的特征。若调整后依旧无法追踪，请参见文末提交反馈。
- 官方的【云 · 原神】由于设置了不可捕获屏幕，所以无法追踪（可能由于防止多开脚本缘故）。
自动追踪（特别是DirectX模式）有概率会崩溃，崩溃的表现包括但不限于：

### 自动追踪坐标错误
* 弹出「Runtime Error」窗口或者「该内存不能为Read」
* 地图客户端突然无响应
* 地图客户端自动关闭，任务栏卡派蒙
* 地图客户端所有地图消失，变成灰蓝底暗角

- 表现为箭头能跟着角色移动，没有晃动等异常情况，但坐标偏差很大（比如人在璃月港，箭头却在层岩巨渊）。
- 或者已经更新到新版本，但新地图依然无法追踪
如果遇到以上情况，请检查「空荧酒馆」的安装目录是否生成dmp格式的文件。如果有，则证明自动追踪发生了崩溃现象。

- 重启地图客户端，在设置中选择「清理定位缓存」后重新开启即可。
遇到崩溃，可以先尝试清理定位缓存，如果无效，可以升级或者重装显卡驱动

### 自动追踪晃动，速度慢
如果依旧不行，请添加反馈QQ群，并把dmp文件发送给@小狸卡 分析崩溃原因
如果有其他问题请提交反馈。

限于算法限制，晃动和延迟很难避免，一般10m以内算正常误差
紧急问题请加入开发反馈QQ群：228382171

目前存在的问题如下：
## 更新日志

- 为了尽量减少晃动，输出结果进行了滤波，在移动时可能会出现轻微的惯性。
- 对于比较规则的区域（梅洛彼得堡，赤王遗迹群等）识别精度可能会大幅度下降。
- 特征点较少的区域，坐标偏移比较严重
- 因为视角扇形的遮挡，原地转动视角可能会导致追踪小箭头绕圈转
以下更新日志供参考，用于排查bug使用

以下是减轻晃动的几个建议：
### 【7.14.2】

- 如果能正常截图，但时常出现乱晃的现象，请检查分辨率是否过小（不小于1280x720，建议1920x1080以上），小地图是否解锁，是否有大面积遮挡，是否有显著的特征。
- 若开启显卡滤镜、HDR等改变色彩显示的功能，则可能会影响到自动追踪的精度。
- 后台暂停会导致位置追踪也同时暂停，可能会导致切地图时，追踪延迟变高。
- 在配置允许的情况下，将追踪间隔调到0.1秒，能比较好的改善延迟高的问题。
- 如果在某一个区域，长时间没反应（超过3分钟以上），或者箭头跑到地图外面，请于文末与开发者联系反馈。
1. 重写DirectX截图算法，降低崩溃的概率
2. 支持“云原神”追踪

### 自动追踪崩溃：
### 【7.13.1】

- 自动追踪（特别是DirectX模式）有概率会崩溃，崩溃的表现包括但不限于：
适配旧日之海

- 弹出「Runtime Error」窗口或者「该内存不能为Read」
- 地图客户端突然无响应
- 地图客户端崩溃，任务栏卡派蒙
- 地图客户端所有地图消失，变成灰蓝底暗角
### 【7.12.2】

- 如果遇到以上情况，请检查「空荧酒馆」的安装目录是否生成dmp格式的文件。如果有，则证明自动追踪发生了崩溃现象。
- 遇到崩溃，可以先尝试清理定位缓存，如果无效，可以升级或者重装显卡驱动
- 如果依旧不行，请添加反馈QQ群，并把dmp文件发送给@小狸卡 分析崩溃原因
修复层岩巨渊，渊下宫坐标偏差

如果有其他问题请提交反馈。
### 【7.12.1】

紧急问题请加入[开发反馈QQ群：228382171](https://jq.qq.com/?_wv=1027&k=EqhYN9uI)
适配沉玉谷

## 更新日志
### 【7.11.1】

以下更新日志供参考，用于排查bug使用
适配枫丹3

【7.10.2】
### 【7.10.2】

1\. 修正了地下的坐标映射，现在地下坐标会更准确一些
2\. 如果没有获取到坐标，将不会在枫丹左上角显示箭头
3\. 降低了在地下区域，箭头瞬移到地图外的概率 4. 修复了歌剧院坐标漂移 5. 修复须弥城无法追踪
1. 修正了地下的坐标映射，现在地下坐标会更准确一些
2. 如果没有获取到坐标，将不会在枫丹左上角显示箭头
3. 降低了在地下区域，箭头瞬移到地图外的概率
4. 修复了歌剧院坐标漂移
5. 修复须弥城无法追踪

#### 7.10.0
### 【7.10.0】

1. 适配枫丹2

2. 适配地下地图，暂时不支持检测层级

3. 调整坐标系，稍微提高了精度
4. 修复望舒客栈无法追踪

#### 7.9.36
4. 修复望舒客栈无法追踪

### 【7.9.36】

继续修复DirectX截图崩溃问题

#### 7.9.35
### 【7.9.35】

修复DirectX截图崩溃问题

#### 7.9.33
### 【7.9.33】

支持枫丹的水下区域追踪

#### 7.9.32
### 【7.9.32】

1. 支持枫丹已解锁地区追踪
2. 优化主城内的识别
1：支持枫丹已解锁地区追踪
2：优化主城内的识别

#### GIv38海岛分支
### 【GIv38海岛分支】

1.适配3.8活动地图2.大幅减小了包体体积（需要测试）3.修复了自动追踪缓存无法正常更新的问题
1.适配3.8活动地图
2.大幅减小了包体体积
3.修复了自动追踪缓存无法正常更新的问题

#### 7.9.5
### 【7.9.5】

修复传送后箭头漂移

#### 7.9.1
### 【7.9.1】

1. 改进视角识别算法
2. 提高识别稳定性
3. 修复若干DirectX的报错

#### 7.8.55
### 【7.8.55】

优化定位缓存文件的大小

Expand Down

0 comments on commit 451fb91

Please sign in to comment.