# Velogic Studio 故障排除 如果你完全无法从 Kinect 获取任何信息，或者 Kinect 不断断开连接：请查看我们的 [硬件兼容性指南](https://docs.velogicfit.com/zh/di-01-jie-ru-men/pc-system-requirements) 和 [Kinect 摄像头故障排除指南](https://docs.velogicfit.com/zh/di-01-jie-ru-men/kinect-troubleshooting) 首先。 一旦你确认 Kinect 工作正常（例如 Kinect 配置验证器稳定并显示 29-30 FPS），本指南将帮助你排查应用程序问题。 ## 线框不会自动出现 参见： [标记检测故障排除](https://docs.velogicfit.com/zh/di-02-jie-shi-yong-velogic-studio/troubleshooting-marker-detection) ## 帧率低 如果你正在尝试获得最佳的环境条件（以改善帧率），有一些事项需要检查。 * 如果这是你第一次运行 Velogic Studio，或你刚升级到新版本——Windows 可能仍在为你的计算机优化应用程序。请让它运行几分钟，然后关闭并重新启动。 * 骑手背后、处于 Kinect 视野内的强光源（窗户、门、灯泡）会导致帧率下降和图像模糊（尽管这不会影响测量——只是彩色图像）。 * 光线条件差可能意味着环境光线昏暗，或仅来自顶灯。任何在骑手上产生梯度的照明情况（例如顶部明亮、底部昏暗）或热点（直接照射到某个标记）都会影响照明评分。 另见： [照明与环境](https://docs.velogicfit.com/zh/di-01-jie-ru-men/lighting-environment) ## 实时视图不是实时的（在一帧后冻结） 这是 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 保存拟合数据的目录，来避免这些误报，同时也能减少保存每次捕获结果所需的时间： * 点击“开始”并输入“Virus”，然后点击“病毒与威胁防护” * 在“病毒与威胁防护设置”中点击“管理设置” ![带有“管理设置”按钮的 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 management software）。 你可以在设备管理器中检查 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 是微软提供的免费实用工具（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 中内置了一个工具，可用于提交详细的性能数据。详情请参见 [这篇文章](https://docs.velogicfit.com/zh/di-01-jie-ru-men/submitting-performance-data) 。 ### 向我们发送系统信息 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) * * 点击 文件 -> 导出，将文件保存到某处（例如你的桌面），然后通过电子邮件将该文件发送给我们 -