> For the complete documentation index, see [llms.txt](https://docs.velogicfit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.velogicfit.com/zh/di-02-jie-shi-yong-velogic-studio/troubleshooting.md). # Velogic Studio 故障排除 Velogic Studio 常见问题的综合故障排除指南，包括性能、崩溃和视频问题 如果你完全无法从 Kinect 获取任何信息，或者 Kinect 正在断开连接：请查看我们的 [硬件兼容性指南](/zh/di-01-jie-ru-men/pc-system-requirements.md) 和 [Kinect 摄像头故障排查指南](/zh/di-01-jie-ru-men/kinect-troubleshooting.md) 。 一旦你确认 Kinect 工作正常（即 Kinect 配置验证器保持稳定并输出 29-30 FPS），本指南将帮助你排查应用程序问题。 ## 线框图未自动显示 请参阅： [排查标记检测问题](/zh/di-02-jie-shi-yong-velogic-studio/troubleshooting-marker-detection.md) ## 帧率很低 如果你想获得最佳环境条件（以提高帧率），有一些事项需要检查。 * 如果这是你第一次运行 Velogic Studio，或者你刚刚升级到新版本——Windows 可能仍在忙于为你的电脑优化此应用程序。请让它运行几分钟，然后关闭并重新启动。 * 骑手后方的强光源（窗户、门、灯泡），若处于 Kinect 的视野中，会导致帧率变差，图像模糊（不过这不会影响测量——只会影响彩色图像）。 * 不良的照明条件可能意味着环境昏暗，或者只有头顶照明。任何会在骑手身上形成渐变（例如上方明亮、下方昏暗）或热点（直接照射到某个标记上）的照明情况，都会降低照明评分。 另请参阅： [照明与环境](/zh/di-01-jie-ru-men/lighting-environment.md) ## 实时预览并非实时（在一帧后冻结） 这是 Intel Iris Xe 显卡驱动程序中的一个已知问题。有几种不同的解决方案： * 你可以将驱动程序更新到最新版本，看看问题是否已修复。你应该可以通过设备管理器（展开“显示适配器”，右键单击你的显卡并选择“更新驱动程序”）来完成，或者手动安装 [Intel 推荐的驱动程序版本](https://www.intel.com/content/www/us/en/download/19344/30579/intel-graphics-windows-dch-drivers.html?) 以修复这个特定问题。如果你安装了该驱动版本后仍然出现冻结，请尝试使用 [Intel 自己的管理软件](https://www.intel.com/content/www/us/en/support/detect.html) 将显卡驱动更新到更高版本。 * 你可以在注册表编辑器中设置此 dword 标志，从而为整台电脑禁用有问题的代码： `HKCU\SOFTWARE\Microsoft\Avalon.Graphics\DisableHWAcceleration : 1` * Velogic Studio 提供了一个特殊设置来禁用硬件加速，以解决此问题：设置 -> 支持 -> 强制软件渲染模式。通常最好将此设置关闭（因为它会强制你的 CPU 执行本应由 GPU 完成的工作），但开启后可以绕过驱动程序问题。 ## 偶发性随机崩溃 Velogic Studio 是一款非常稳定的应用程序，但如果你偶尔遇到崩溃，请继续阅读可能的解决方案。 ### 更新显示驱动程序 Velogic Studio 使用了显卡驱动中的功能。如果显卡驱动有错误，可能会导致 Velogic Studio 不稳定。 按照 [这份微软指南](https://support.microsoft.com/en-us/windows/update-drivers-in-windows-10-ec62f46c-ff14-c91d-eead-d7126dc1f7b6)操作，但在设备管理器中请选择“显示适配器”，而不是文章中给出的示例： ![Device Manager window showing Display Adapters section for updating video drivers](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-78e146ad5890a5387a593d3c40fc9d49021e8839%2Ftroubleshooting.png?alt=media) ### 让杀毒软件不要检查 Velogic Studio 保存的文件 如果你在保存采集内容时 Velogic Studio “卡死”了，这也许会有帮助。Windows 自带的杀毒软件会扫描保存到磁盘上的每个文件。我们有时认为它会把正在保存的视频误判为病毒，并且会在不发送任何错误报告的情况下使 Velogic Studio 停止运行。 你可以通过让 Windows 忽略 Velogic Studio 拟合数据的保存目录，来避免这些误报，并减少每次采集结果保存所需的时间： * 点击“开始”，输入“病毒”，然后点击“病毒和威胁防护” * 在“病毒和威胁防护设置”中点击“管理设置” ![Windows Defender 病毒和威胁防护设置，显示“管理设置”按钮](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-5eed58b05bb9fbe0b708891f47118cbf07997a55%2Ftroubleshooting-1.png?alt=media) * 点击“添加或删除排除项” ![病毒防护设置页面，显示“添加或删除排除项”选项](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-e622bccfce29fe80e578a4c77b31906f5b9fec54%2Ftroubleshooting-2.png?alt=media) * 点击“添加排除项”，然后选择“文件夹” ![添加排除项对话框，已选中“文件夹”选项以排除拟合数据目录](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a1554c9b0cfb1e1b034b6c180158e4681cb3e49e%2Ftroubleshooting-3.png?alt=media) * 选择 Velogic Studio 保存拟合数据的文件夹（通常是“Documents\Velogic Studio fits”，但你可能在 Velogic Studio 的设置中修改过） * 重新启动 Velogic Studio ### 检查是否有其他应用程序正在使用 LibUSB 一些客户报告称，当同一台电脑上安装了其他使用 LibUSB 的应用程序时，Velogic Studio 会卡死。其中一个此类应用程序的例子是 EBike 管理软件。 你可以在驱动程序管理器中查找 LibUSB。 ![设备管理器在系统设备列表中显示 LibUSB 驱动程序](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-1949740b9d24d140f8b2e2c78090a2920de2b875%2Ftroubleshooting-4.png?alt=media) 如果你发现电脑上存在 LibUSB，请尝试移除电脑上的其他 USB 加密狗。如果 Velogic Studio 仍然不稳定，请尝试从电脑中移除 libUSB（在设备管理器中的条目上右键单击并选择“卸载设备”） ### 在事件查看器中检查 Velogic Studio 的错误消息 Visual Studio 会将错误信息写入 Windows 事件日志。我们可能会让你检查日志，并向我们发送包含相关信息的文件。操作方法如下： * 按 Windows 键并搜索“事件查看器”，然后点击运行它 ![Windows 开始菜单搜索结果，显示事件查看器应用程序](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-0020cf6f004c6bba0ac6552c9a5289f1cb9b658f%2Ftroubleshooting-5.png?alt=media) * 点击“Windows 日志”，然后点击“应用程序” ![事件查看器中高亮显示“Windows 日志”和“应用程序”部分](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-66fb067705fb03676854ee610b0534563f9ca44a%2Ftroubleshooting-6.png?alt=media) * 在窗口右侧的“操作”区域中，点击“筛选当前日志” ![事件查看器“操作”面板，已选中“筛选当前日志”选项](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-16848a6983b9c3a4a260d4c79b9e658824c0b2b8%2Ftroubleshooting-7.png?alt=media) * 在“筛选”弹窗中，设置以下选项：事件级别 = 错误，事件源 = .NET Runtime，事件 ID = 1011，然后点击确定 ![“筛选当前日志”对话框，已配置错误级别和 .NET Runtime 设置](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-53e1f68e8d8cde5680481b65981a26099c9a9e02%2Ftroubleshooting-8.png?alt=media) * 在窗口右侧的“操作”区域中，点击“将筛选后的日志另存为...” ![事件查看器“操作”面板，显示“将筛选后的日志另存为”选项](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-75aa2f2d6a1cd4dc0daa3f572d1c07b1a3c6fae0%2Ftroubleshooting-9.png?alt=media) * 在保存对话框中，为文件命名（例如你的姓名），并将其保存在你之后能找到的位置，例如桌面 ![将筛选后的事件日志文件导出到桌面的“另存为”对话框](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-74dc2128b1d90e07023a1b40a284514564a14d75%2Ftroubleshooting-10.png?alt=media) * 发送一封附有该文件的电子邮件至 ### 上传转储文件 如果 Velogic Studio 意外退出（崩溃），它应该会在你电脑上的某个目录中写入一个转储文件，然后重新启动。 重新启动后，它会检测到转储文件已存在，并在 Velogic Studio 主窗口底部显示提示。 ![Velogic Studio 崩溃转储上传提示，窗口底部有“上传”按钮](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-b07da01dd3e5207065367f1fbca048ec0543b210%2Ftroubleshooting-11.png?alt=media) 这些转储文件对帮助我们诊断并最终修复导致崩溃的问题非常有用。如果你看到这条消息，并且你的网络连接还算正常，请点击“上传”按钮。Velogic Studio 会将转储文件压缩并上传给我们的支持团队。 上传可能需要几分钟，但在上传过程中你仍可以正常使用该应用程序，而且你可以随时取消。 如果你不想将文件上传给支持团队，可以点击“删除”。或者你也可以点击 X 按钮隐藏该消息而不执行任何操作。 ### 向我们发送手动转储文件 如果 Visual Studio 变得无响应，但它没有自动创建转储文件（见上文），我们可能会要求你手动创建一个转储文件。操作如下： * 运行任务管理器（同时按下 ctrl+shift+esc 键） * 找到 Velogic Studio，并点击其旁边的展开按钮 ![任务管理器显示 Velogic Studio 进程及其子进程的展开视图](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-9ed9554ad89842648da249e060da5fcf4eb24bff%2Ftroubleshooting-12.png?alt=media) * 右键单击该进程并选择“创建转储文件” ![进程右键菜单，显示“创建转储文件”选项](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a055a3ac74dfdabf9c0055385e8fc73287357ef3%2Ftroubleshooting-13.png?alt=media) * 你会看到类似这样的消息： ![转储文件创建进度对话框，显示文件正在生成](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-5efe042bba4a54dc8ba954ae605335cc39a8779b%2Ftroubleshooting-14.png?alt=media) ……然后几秒钟后，你会看到： ![转储文件创建完成对话框，显示文件路径位置](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-29c458bdaabcb998fbf5e7d65565dfa073a49412%2Ftroubleshooting-15.png?alt=media) * 在你的网页浏览器中，访问 ，然后点击“选择文件”按钮 ![vlgc.io/upload 的网页上传界面，带有“选择文件”按钮](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-44ad9584d63e9094155da844db9575bceb60b279%2Ftroubleshooting-16.png?alt=media) * 导航到上一步中的路径（例如 c:\Users\\AppData\Local\temp\Velogic.Studio.App.DMP）。为方便起见，你可以在“文件名”框中输入： `%localappdata%\temp\Velogic.Studio.App.DMP` * 输入你的名和姓，然后点击“上传” ![文件上传表单，包含姓名字段和用于发送转储文件的“上传”按钮](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-c980fa2f2fce73b68f324afdf74f84c46950469f%2Ftroubleshooting-17.png?alt=media) * 根据你的网络连接情况，上传可能需要几分钟。转储文件大约可能有 1GB，因此如果你的网络费用较高，请联系我们以确认这是否是最适合你的流程。 * 也请发送电子邮件至 ，说明你为什么发送 .dmp 文件。理想情况下，你的邮件应包含： * 你当时正在做什么 * 你预期会发生什么 * 实际发生了什么 ## 应用程序整体感觉迟缓，视频有卡顿 Velogic 应用程序在性能合理的硬件上应始终感觉“反应迅速”，并具有良好的性能。如果你的硬件已经超过了我们的最低配置，但仍未达到预期性能，你可以检查以下几点。 ### 试着拔掉摄像头 我们收到一些用户反馈，某些摄像头本身就会占用大量 CPU，导致留给 Velogic 应用程序工作的资源不足。尝试断开摄像头连接，如果性能明显改善，请改用其他摄像头。 ### 使用 Process Explorer 找出瓶颈 Process Explorer 是来自 Microsoft 的免费工具（属于免费的 Sysinternals 工具集）。 你可以从以下位置下载或直接运行 [Process Explorer 网页](https://docs.microsoft.com/en-us/sysinternals/downloads/process-explorer)。只需在进程列表中找到 Velogic 进程，然后右键单击并选择“属性”。在你在 Velogic Studio 中执行一些操作时保持它运行，然后查看这些图表。 ![Process Explorer 性能图表，显示 CPU 使用率、内存和 I/O 统计信息](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-695dd3522704a4b50c5d68b8a15716dfbcaac5bd%2Ftroubleshooting-18.png?alt=media) 你可以查看： * CPU 使用率 - CPU 使用率很低，这很好。（高 CPU 使用率并不一定是坏事，除非你对应用程序的整体性能不满意） * “Private Bytes”——这表示内存使用情况，并且应大致保持恒定，约为 500-700MB。如果它持续且快速上升，你可能遇到了内存泄漏——请联系我们，并发送你的图表副本（你可以使用 \[Shift]-\[Windows]-\[s] 组合键截图） * I/O——在采集期间，当应用程序将视频写入磁盘时，I/O 会达到峰值。除此之外，I/O 较低。采集期间 CPU 的峰值相当小，因此 CPU 在编码视频时并没有过度工作。 我们很乐意帮助诊断你在使用我们软件时遇到的任何性能问题。请尽可能提供更多信息与我们联系——理想情况下包括一张 Process Explorer 的截图。 ### 提交性能数据供我们分析 我们在 Velogic Studio 中内置了一个工具，你可以用它来提交详细的性能数据。请参阅 [这篇文章](/zh/di-01-jie-ru-men/submitting-performance-data.md) 了解详情。 ### 向我们发送系统信息 Windows 有一个内置工具，可以收集有关你系统硬件和操作系统的详细信息。这有时有助于我们诊断问题。如果我们向你索取这些信息： * 点击 Windows 菜单并输入“系统信息”，然后运行该应用程序： ![Windows 开始菜单搜索结果，显示“系统信息”应用程序](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-3357cd97f790a4ab99602800af6415263a9d6633%2Ftroubleshooting-19.png?alt=media) * * 点击 文件 -> 导出，将文件保存在某处（例如你的桌面），然后通过电子邮件将该文件发给我们 - --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.velogicfit.com/zh/di-02-jie-shi-yong-velogic-studio/troubleshooting.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.