Velogic Studio 故障排除

Velogic Studio 常见问题的全面故障排除指南,包括性能、崩溃和视频问题

如果你完全无法从 Kinect 获取任何信息,或者 Kinect 经常断开连接:请先查看我们的 硬件兼容性指南Kinect 相机故障排除指南 首先。

一旦你确定 Kinect 工作正常(即 Kinect 配置验证器稳定并显示 29-30 FPS),本指南将帮助你排查应用程序问题。

线框未自动显示

参见: 标记检测故障排除

帧率低

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

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

  • 在骑乘者背后且 Kinect 可见范围内的强光源(窗户、门、灯泡)会导致帧率变差且图像模糊(尽管这不会影响测量——只是彩色图像)。

  • 光线条件差可能意味着光线很暗,或只有顶灯。任何在骑乘者身上产生梯度的照明情况(例如上方明亮而下方昏暗)或热点(直接照射到某个标记)都会损害照明评分。

另见: 照明与环境

Liveview 不是实时的(在一帧后冻结)

这是 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 保存拟合数据的目录来避免这些误报,并减少保存每次捕获结果所需的时间:

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

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

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 设置
  • 在窗口右侧的操作区域,点击“将筛选的日志文件另存为...”

事件查看器操作面板,显示 将筛选的日志文件另存为 选项
  • 在保存对话框中,为文件命名(例如你的名字)并将其保存到你能找到的位置,例如桌面

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

上传转储文件

如果 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<yourname>\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]

最后更新于