Velogic Studio 故障排除

关于常见 Velogic Studio 问题（包括性能、崩溃和视频问题）的综合故障排除指南

如果你完全无法从 Kinect 获取任何信息，或者 Kinect 不断断开连接：请查看我们的 硬件兼容性指南 和 Kinect 摄像头故障排除指南 首先。

一旦你确认 Kinect 工作正常（例如 Kinect 配置验证器稳定并显示 29-30 FPS），本指南将帮助你排查应用程序问题。

线框不会自动出现

参见： 标记检测故障排除

帧率低

如果你正在尝试获得最佳的环境条件（以改善帧率），有一些事项需要检查。

• 如果这是你第一次运行 Velogic Studio，或你刚升级到新版本——Windows 可能仍在为你的计算机优化应用程序。请让它运行几分钟，然后关闭并重新启动。

• 骑手背后、处于 Kinect 视野内的强光源（窗户、门、灯泡）会导致帧率下降和图像模糊（尽管这不会影响测量——只是彩色图像）。

• 光线条件差可能意味着环境光线昏暗，或仅来自顶灯。任何在骑手上产生梯度的照明情况（例如顶部明亮、底部昏暗）或热点（直接照射到某个标记）都会影响照明评分。

另见： 照明与环境

实时视图不是实时的（在一帧后冻结）

这是 Intel Iris Xe 图形驱动的已知问题。有几种不同的解决方法：

• 你可以将驱动更新到最新版本，看看问题是否解决。你应该可以通过设备管理器完成此操作（展开“显示适配器”，右键点击你的显卡并选择“更新驱动程序”），或者手动安装 Intel 推荐的驱动版本 以修复这个特定问题。如果你安装了该驱动版本仍然出现冻结，尝试使用 Intel 自家的管理软件 更新到更高版本的图形驱动。

• 你可以通过在注册表编辑器中设置此 dword 标志，为整台计算机禁用有问题的代码： HKCU\SOFTWARE\Microsoft\Avalon.Graphics\DisableHWAcceleration : 1

• Velogic Studio 有一个专门设置用于禁用硬件加速以规避此问题：设置 -> 支持 -> 强制软件渲染模式。通常建议保持此设置关闭（因为开启会强制 CPU 做本应由 GPU 完成的工作），但开启可以绕过驱动问题。

偶尔随机崩溃

Velogic Studio 是一个非常稳定的应用，但如果你偶尔遇到崩溃，请继续阅读可能的解决方案。

更新显示驱动

Velogic Studio 使用你的视频驱动中的功能。如果视频驱动有缺陷，可能会导致 Velogic Studio 不稳定。

请参阅 微软的这篇指南，但在设备管理器中选择“显示适配器”而不是文章中给出的示例：

告诉杀毒软件不要检查 Velogic Studio 保存的文件

如果在保存捕获时 Velogic Studio 出现“卡住”的情况，这可能有帮助。Windows 内置的杀毒软件会扫描保存到磁盘的每个文件。有时它会错误地将正在保存的视频识别为病毒，并在没有任何错误报告的情况下中断 Velogic Studio。

你可以通过告诉 Windows 忽略 Velogic Studio 保存拟合数据的目录，来避免这些误报，同时也能减少保存每次捕获结果所需的时间：

• 点击“开始”并输入“Virus”，然后点击“病毒与威胁防护”

• 在“病毒与威胁防护设置”中点击“管理设置”

带有“管理设置”按钮的 Windows Defender 病毒与威胁防护设置

• 点击“添加或删除排除项”

病毒防护设置页面，带有“添加或删除排除项”选项

• 点击“添加排除项”，然后选择“文件夹”

添加排除项对话框，已选择“文件夹”以排除拟合数据目录

• 选择 Velogic Studio 保存拟合数据的文件夹（通常为“Documents\Velogic Studio fits”，但你可能在 Velogic Studio 设置中更改过）

• 重启 Velogic Studio

检查是否有其他应用使用 LibUSB

一些客户报告在同一台计算机上安装了其他使用 LibUSB 的应用时，Velogic Studio 会发生冻结。此类应用的一个例子是电动自行车管理软件（EBike management software）。

你可以在设备管理器中检查 LibUSB。

设备管理器显示系统设备列表中的 LibUSB 驱动

如果你发现计算机上存在 LibUSB，尝试拔掉计算机上的其他 USB 加密狗。如果 Velogic Studio 仍然不稳定，尝试从计算机上移除 libUSB（在设备管理器中右键该条目并选择“卸载设备”）

在事件查看器中检查 Velogic Studio 错误信息

Visual Studio 会将错误信息写入 Windows 事件日志。我们可能会请你检查日志并发送包含相关信息的文件给我们。操作步骤如下：

• 按下 Windows 键并搜索“事件查看器”，然后点击运行它

Windows 开始菜单搜索结果显示事件查看器应用

• 点击“Windows 日志”，然后选择“应用程序”

事件查看器中突出显示 Windows 日志和应用程序部分

• 在窗口右侧的“操作”区域，点击“筛选当前日志”

事件查看器操作面板，已选择“筛选当前日志”选项

• 在筛选弹出窗口中，设置选项：事件级别 = 错误，事件来源 = .NET Runtime，事件 ID = 1011，然后点击确定

筛选当前日志对话框，配置为错误级别和 .NET Runtime 设置

• 在窗口右侧的“操作”区域，点击“将筛选后的日志文件另存为...”

事件查看器操作面板显示“保存筛选的日志文件”选项

• 在保存对话框中，为文件命名（例如你的名字）并将其保存到一个容易找到的位置，例如桌面

将筛选后的事件日志导出到桌面的另存为对话框

• 将该文件作为附件通过电子邮件发送到 [email protected]

上传转储文件

如果 Velogic Studio 意外退出（崩溃），它应该会将转储文件写入计算机上的某个目录，然后重启。

当它重启时，会注意到转储文件存在，并在 Velogic Studio 主窗口底部显示提示。

Velogic Studio 崩溃转储上传提示，窗口底部带有上传按钮

这些转储文件对帮助我们诊断并最终修复导致崩溃的问题非常有用。如果你看到此消息，并且网络连接良好，请点击“上传”按钮。Velogic Studio 会将转储文件压缩并上传给我们的支持团队。

上传可能需要几分钟，但在上传过程中你仍可正常使用应用，也可以随时取消上传。

如果你不想将文件上传给支持，可以点击“删除”。或者你也可以点击 X 按钮隐藏该消息而不执行任何操作。

向我们手动发送转储文件

如果 Visual Studio 无响应，但没有自动创建转储文件（见上文），我们可能会请你手动创建转储文件。步骤如下：

• 运行任务管理器（同时按下 ctrl+shift+esc 键）

• 找到 Velogic Studio，并点击其旁边的展开按钮

任务管理器显示 Velogic Studio 进程并展开子进程视图

• 右键点击该进程并选择“创建转储文件”

进程的右键上下文菜单显示“创建转储文件”选项

• 你会看到类似这样的信息：

  

  转储文件创建进度对话框，显示正在生成文件

  ……几秒钟后，你会看到：

  

  转储文件创建完成对话框，显示文件路径位置
• 在你的网络浏览器中，访问 https://vlgc.io/upload，然后点击“选择文件”按钮

vlgc.io/upload 的网页上传界面，带有“选择文件”按钮

• 导航到上一步中的路径（例如 c:\Users<你的名字>\AppData\Local\temp\Velogic.Studio.App.DMP）。为方便起见，你可以在文件名框中输入： %localappdata%\temp\Velogic.Studio.App.DMP

• 输入你的名字和姓氏，然后点击“上传”

文件上传表单，带有姓名字段和用于发送转储文件的上传按钮

• 上传将花费几分钟，具体取决于你的网络连接。转储文件大约为 1GB，因此如果你使用的是昂贵的网络，请与我们联系以确认这是否是最佳流程。

• 请同时发送一封电子邮件到 [email protected]，说明你为何发送 .dmp 文件。理想情况下，你的邮件应包含：

  • 你当时在做什么

  • 你期望发生什么

  • 实际发生了什么

应用总体感觉迟缓，视频有滞后

Velogic 的应用在合理硬件上应始终感觉“响应迅速”并具有良好性能。如果你的硬件超过我们的最低规格，但未达到预期性能，你可以检查以下事项。

尝试拔掉网络摄像头

我们收到用户报告称某些网络摄像头本身会占用大量 CPU，导致留给 Velogic 应用的资源不足。尝试断开摄像头，如果性能明显提升，请更换摄像头。

使用 Process Explorer 查找瓶颈

Process Explorer 是微软提供的免费实用工具（Sysinternals 工具集的一部分）。

你可以从以下页面下载或直接运行 Process Explorer 网页。在进程列表中找到 Velogic 进程，然后右键选择“属性”。在你在 Velogic Studio 中执行一些操作时保持该窗口运行，然后检查图表。

Process Explorer 性能图表，显示 CPU 使用率、内存和 I/O 统计

你可以查看：

• CPU 使用率 - CPU 使用率较低是好事。（高 CPU 使用率并不一定是坏事，除非你对应用的整体性能不满意）

• “私有字节（Private Bytes）” - 这是内存使用，应保持相对稳定，大约在 500-700MB 左右。如果它持续且快速上升，你可能遇到了内存泄漏——请联系我们并发送你的图表（你可以用 [Shift]-[Windows]-[s] 快捷键截图）

• I/O - 在捕获期间 I/O 会有峰值，因为应用在将视频写入磁盘。除此之外 I/O 很低。捕获期间的 CPU 峰值相当小，因此 CPU 在编码视频时工作量并不大。

我们很乐意帮助诊断你在使用我们软件时遇到的任何性能问题。请尽可能提供详细信息与我们联系——理想情况下包括来自 Process Explorer 的截图。

提交性能数据供我们分析

我们在 Velogic Studio 中内置了一个工具，可用于提交详细的性能数据。详情请参见 这篇文章 。

向我们发送系统信息

Windows 有一个内置工具，可以收集有关系统硬件和操作系统的详细信息。这有时有助于我们诊断问题。如果我们要求你提供这个：

• 点击 Windows 菜单并输入“系统信息”，然后运行该应用：

  

  Windows 开始菜单搜索显示系统信息应用
• 点击 文件 -> 导出，将文件保存到某处（例如你的桌面），然后通过电子邮件将该文件发送给我们 - [email protected]