mirror of
https://jihulab.com/DGP-Studio/Snap.Hutao.Docs.git
synced 2025-11-19 21:16:31 +08:00
Update docs
This commit is contained in:
@@ -7,6 +7,7 @@ redirectFrom: /en/advanced/mihoyo-risk-tip.html
|
|||||||
---
|
---
|
||||||
|
|
||||||
# Common Program Exceptions
|
# Common Program Exceptions
|
||||||
|
|
||||||
This document covers solutions of **foreseeable client error**
|
This document covers solutions of **foreseeable client error**
|
||||||
|
|
||||||
## RuntimeEnvironmentException
|
## RuntimeEnvironmentException
|
||||||
@@ -33,15 +34,15 @@ This document covers solutions of **foreseeable client error**
|
|||||||
|
|
||||||
## Return Code: 1034 Verification Failed
|
## Return Code: 1034 Verification Failed
|
||||||
|
|
||||||
- If Snap Hutao returns `1034` status code and hints verification failed (usually during the operation of Realtime Notes),
|
- If Snap Hutao returns `1034` status code and hints verification failed (usually during the operation of Realtime Notes),
|
||||||
it means the operation is blocked by MiHoYo BBS anti-bot system
|
it means the operation is blocked by MiHoYo BBS anti-bot system
|
||||||
- Solution:
|
- Solution:
|
||||||
- Enter `Realtime Notes`
|
- Enter `Realtime Notes`
|
||||||
- Click on `Verify Current User and Role` button
|
- Click on `Verify Current User and Role` button
|
||||||
- Follow the instruction in MiHoYo BBS to verify
|
- Follow the instruction in MiHoYo BBS to verify
|
||||||
- After finishing the verification process, click `Complete` to close the verification window
|
- After finishing the verification process, click `Complete` to close the verification window
|
||||||
- Now, the account should back to normal; If not, process the step above again
|
- Now, the account should back to normal; If not, process the step above again
|
||||||
::: tip
|
::: tip
|
||||||
|
|
||||||
If the risk prompt is too frequent, or the verification cannot be triggered at all, it means that the risk of your
|
If the risk prompt is too frequent, or the verification cannot be triggered at all, it means that the risk of your
|
||||||
account is too high, please change the password, so that the simultaneous login status of multiple devices will be reset
|
account is too high, please change the password, so that the simultaneous login status of multiple devices will be reset
|
||||||
@@ -59,17 +60,29 @@ account is too high, please change the password, so that the simultaneous login
|
|||||||
:::
|
:::
|
||||||
|
|
||||||
## HttpRequestException Metadata Download Failed
|
## HttpRequestException Metadata Download Failed
|
||||||
|
|
||||||
### 403 (Forbidden) / 404 (Not Found)
|
### 403 (Forbidden) / 404 (Not Found)
|
||||||
|
|
||||||
Solution: Update your Snap Hutao to latest version
|
Solution: Update your Snap Hutao to latest version
|
||||||
|
|
||||||
### 502 (Bad Gateway)
|
### 502 (Bad Gateway)
|
||||||
|
|
||||||
> Associated Issue: [https://github.com/DGP-Studio/Snap.Hutao/issues/100](https://github.com/DGP-Studio/Snap.Hutao/issues/100)
|
> Associated Issue: [https://github.com/DGP-Studio/Snap.Hutao/issues/100](https://github.com/DGP-Studio/Snap.Hutao/issues/100)
|
||||||
|
|
||||||
This HTTP Exception occurs when Snap Hutao failed to fetch remote resource (usually static image and configuration)
|
This HTTP Exception occurs when Snap Hutao failed to fetch remote resource (usually static image and configuration)
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
|
|
||||||
If you are using proxy software, you may need to turn it off or using TUN mode proxy;
|
If you are using proxy software, you may need to turn it off or using TUN mode proxy;
|
||||||
otherwise you need to use [Windows 8 AppContainer Loopback Utility](https://www.telerik.com/fiddler/add-ons) to remove
|
otherwise you need to use [Windows 8 AppContainer Loopback Utility](https://www.telerik.com/fiddler/add-ons) to remove
|
||||||
[Windows APP Container Loopback limits](https://learn.microsoft.com/zh-CN/windows/iot-core/develop-your-app/loopback).
|
[Windows APP Container Loopback limits](https://learn.microsoft.com/zh-CN/windows/iot-core/develop-your-app/loopback).
|
||||||
|
|
||||||
|
## Error Finding Required Modules
|
||||||
|
|
||||||
|
When user launching game with unlock frame-rate feature on, the game may be failed to be launched with the following error shows up:
|
||||||
|
|
||||||
|
1. Error finding required modules: could not read any module, the protection driver may have been loaded
|
||||||
|
2. Error finding required modules: timeout
|
||||||
|
|
||||||
|
This issue only occurs when Genshin Impact's anti-cheat module starts earlier than frame-rate-unlocker module.
|
||||||
|
When these errors happen, Snap Hutao will exit game process, and you can re-launch the game.
|
||||||
|
|||||||
@@ -10,4 +10,4 @@ order: 3
|
|||||||
|
|
||||||
This document records known issues that **need to be fixed**.
|
This document records known issues that **need to be fixed**.
|
||||||
|
|
||||||
All known issues before 1.7 version have been fixed
|
You can view latest version of opened BUG report on [https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+label%3ABUG](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+label%3ABUG)
|
||||||
|
|||||||
@@ -18,7 +18,7 @@ As open-source software, community power is an important part of the ecology of
|
|||||||
|
|
||||||
## QQ Group (CN)
|
## QQ Group (CN)
|
||||||
|
|
||||||
- [Snap Hutao](https://go.hut.ao/qun1)
|
- [Snap Hutao](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=DmW_LDX35YEr1CQZwjZ6x4JYP03soai2&authKey=z3PzXsuYlaPTm%2FW7TyE0o9KNz7H6LA%2BTEZ4mK2BE9%2Fcz0HhH3s1qgbydciAmrGeg&noverify=0&group_code=910780153)
|
||||||
- _Snap Developer Open Discussion Group_
|
- _Snap Developer Open Discussion Group_
|
||||||
- General tech talk, not Snap Hutao Project development group
|
- General tech talk, not Snap Hutao Project development group
|
||||||
- The Dev group requires some basic tech knowledge
|
- The Dev group requires some basic tech knowledge
|
||||||
|
|||||||
@@ -28,19 +28,20 @@ comment: false
|
|||||||
|
|
||||||
:::
|
:::
|
||||||
|
|
||||||
- Enter Game Launcher page
|
Enter Game Launcher page
|
||||||
In the `General - Server` field, select the server you want
|
In the `General - Server` field, select the server you want
|
||||||
|
|
||||||
- Current available serves options include:
|
- Current available serves options include:
|
||||||
|
|
||||||
| Option | Server |
|
| Option | Server |
|
||||||
| -------------- | --------------------------------------------------------- |
|
| -------------- | --------------------------------------------------------- |
|
||||||
| CN Default | Mainland China server |
|
| CN Default | Mainland China server |
|
||||||
| CN NoTapTap | Mainland China server without TapTap account login method |
|
| CN Official | Mainland China server, no difference with previous row |
|
||||||
| BiliBili | Chinese server with BiliBili account system |
|
| CN NoTapTap | Mainland China server without TapTap account login method |
|
||||||
| Global Default | HoYoVerse servers |
|
| BiliBili | Chinese server with BiliBili account system |
|
||||||
| Global Epic | HoYoVerse servers with Epic Store payment gateway |
|
| Global Default | HoYoVerse servers |
|
||||||
| Global Google | HoYoVerse servers with Google Pay payment gateway |
|
| Global Epic | HoYoVerse servers with Epic Store payment gateway |
|
||||||
|
| Global Google | HoYoVerse servers with Google Pay payment gateway |
|
||||||
|
|
||||||
- click `Launcher` button on the top-right to launch the game, Snap Hutao will download server required files and then launch the game
|
- click `Launcher` button on the top-right to launch the game, Snap Hutao will download server required files and then launch the game
|
||||||
|
|
||||||
@@ -82,6 +83,7 @@ comment: false
|
|||||||
- Enter Game Launcher page
|
- Enter Game Launcher page
|
||||||
- In the `Appearance` category, there are 6 available options:
|
- In the `Appearance` category, there are 6 available options:
|
||||||
- **Exclusive Fullscreen**, the game process will run in exclusive fullscreen mode
|
- **Exclusive Fullscreen**, the game process will run in exclusive fullscreen mode
|
||||||
|
- **You should only use this option when you are able to independently describe technical principles and effects of exclusive fullscreen**
|
||||||
- **Fullscreen**, the game display mode is set to fullscreen
|
- **Fullscreen**, the game display mode is set to fullscreen
|
||||||
- **Borderless**, the game display mode is set to borderless
|
- **Borderless**, the game display mode is set to borderless
|
||||||
- **Width**, game window width, such as `1920`
|
- **Width**, game window width, such as `1920`
|
||||||
|
|||||||
@@ -3,7 +3,12 @@ headerDepth: 2
|
|||||||
icon: debug
|
icon: debug
|
||||||
category: [FAQ]
|
category: [FAQ]
|
||||||
order: 2
|
order: 2
|
||||||
redirectFrom: [/advanced/exceptions.html,/advanced/mihoyo-risk-tip.html,/zh/advanced/mihoyo-risk-tip.html]
|
redirectFrom:
|
||||||
|
[
|
||||||
|
/advanced/exceptions.html,
|
||||||
|
/advanced/mihoyo-risk-tip.html,
|
||||||
|
/zh/advanced/mihoyo-risk-tip.html,
|
||||||
|
]
|
||||||
---
|
---
|
||||||
|
|
||||||
# 常见的程序异常
|
# 常见的程序异常
|
||||||
@@ -78,3 +83,11 @@ redirectFrom: [/advanced/exceptions.html,/advanced/mihoyo-risk-tip.html,/zh/adva
|
|||||||
- 网络请求错误,请求异常前程序会说明具体哪一个功能的网络请求失败。
|
- 网络请求错误,请求异常前程序会说明具体哪一个功能的网络请求失败。
|
||||||
- 如果仅是偶尔出现的问题,你可以考虑忽略该错误
|
- 如果仅是偶尔出现的问题,你可以考虑忽略该错误
|
||||||
- 如果持续该错误,请检查本地网络到目标服务器的连接是否正常
|
- 如果持续该错误,请检查本地网络到目标服务器的连接是否正常
|
||||||
|
|
||||||
|
## 在查找必要的模块时出现问题
|
||||||
|
|
||||||
|
当用户在解锁游戏帧数限制的情况下启动游戏时,可能会遇上以下错误提示并启动游戏失败
|
||||||
|
|
||||||
|
1. 在查找必要的模块时遇到问题:无法读取任何模块,可能是保护驱动已经加载完成
|
||||||
|
2. 在查找必要的模块时遇到问题:查找模块超时
|
||||||
|
该问题仅当原神反作弊模块早于解锁帧率模块启动时出现。在出现该错误后,胡桃会主动关闭游戏进程,用户再次尝试启动游戏即可。
|
||||||
|
|||||||
@@ -10,4 +10,4 @@ redirectFrom: /advanced/known-issue.html
|
|||||||
|
|
||||||
该文档包含由所有已知问题和修复计划
|
该文档包含由所有已知问题和修复计划
|
||||||
|
|
||||||
1.7 版本前已知问题已全部修复
|
你可以在 [https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+label%3ABUG](https://github.com/DGP-Studio/Snap.Hutao/issues?q=is%3Aissue+is%3Aopen+label%3ABUG]) 查看最新的来自社区的 BUG 报告
|
||||||
|
|||||||
@@ -21,7 +21,7 @@ order: 8
|
|||||||
|
|
||||||
> 若入群问题为最新版本号则请输入三位版本号(如 `1.2.3`)而不是四位版本号(如 `1.2.3.0`)
|
> 若入群问题为最新版本号则请输入三位版本号(如 `1.2.3`)而不是四位版本号(如 `1.2.3.0`)
|
||||||
|
|
||||||
- [Snap Hutao](https://go.hut.ao/qun1)
|
- [Snap Hutao](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=DmW_LDX35YEr1CQZwjZ6x4JYP03soai2&authKey=z3PzXsuYlaPTm%2FW7TyE0o9KNz7H6LA%2BTEZ4mK2BE9%2Fcz0HhH3s1qgbydciAmrGeg&noverify=0&group_code=910780153)
|
||||||
- _Snap 开发交流群_
|
- _Snap 开发交流群_
|
||||||
- 广泛的技术交流群,并非胡桃工具箱开发群
|
- 广泛的技术交流群,并非胡桃工具箱开发群
|
||||||
- 开发群对申请者的技术水平有一定要求
|
- 开发群对申请者的技术水平有一定要求
|
||||||
|
|||||||
@@ -36,6 +36,7 @@ comment: false
|
|||||||
| 选项 | 服务器 |
|
| 选项 | 服务器 |
|
||||||
| --------------- | ------------------------------------------------- |
|
| --------------- | ------------------------------------------------- |
|
||||||
| 官方服 Default | 中国大陆服务器 |
|
| 官方服 Default | 中国大陆服务器 |
|
||||||
|
| 官方服 Official | 中国大陆服务器,与上一栏无实质区别 |
|
||||||
| 官方服 NoTapTap | 禁用 TapTap 帐号登录的中国大陆服务器 |
|
| 官方服 NoTapTap | 禁用 TapTap 帐号登录的中国大陆服务器 |
|
||||||
| 渠道服 Default | 使用 BiliBili 帐号登录的中国大陆服务器 |
|
| 渠道服 Default | 使用 BiliBili 帐号登录的中国大陆服务器 |
|
||||||
| 国际服 Default | HoYoverse 国际服服务器 |
|
| 国际服 Default | HoYoverse 国际服服务器 |
|
||||||
@@ -82,6 +83,7 @@ comment: false
|
|||||||
- 在主界面点击左侧菜单栏进入`启动游戏`标签
|
- 在主界面点击左侧菜单栏进入`启动游戏`标签
|
||||||
- 在`外观`功能中,有六个选项:
|
- 在`外观`功能中,有六个选项:
|
||||||
- **独占全屏**,即选择游戏进程以独占全屏模式运行
|
- **独占全屏**,即选择游戏进程以独占全屏模式运行
|
||||||
|
- **你应仅在能独立描述独占全屏的技术原理和效果的情况下开启本项**
|
||||||
- **全屏**,即选择启动游戏后的游戏界面是否设置为全屏
|
- **全屏**,即选择启动游戏后的游戏界面是否设置为全屏
|
||||||
- **无边框**,即选择启动游戏后的游戏界面是否设置为无边框窗口
|
- **无边框**,即选择启动游戏后的游戏界面是否设置为无边框窗口
|
||||||
- **宽度**,即选择启动游戏后的游戏界面的宽度,例如`1920`
|
- **宽度**,即选择启动游戏后的游戏界面的宽度,例如`1920`
|
||||||
|
|||||||
Reference in New Issue
Block a user