本文内容

● 已知问题    

● 收集日志

● 设备未列在设备管理器中

● k4aviewer无法打开相机

● 设备固件更新问题

● 图像质量问题

● 不一致或意外的时间戳

● 将人体跟踪 SDK 与 Unreal 配合使用

● 在无外设 Linux 系统上使用 Femto Mega

本文包含在 Femto Mega 中使用 Orbbec SDK K4A Wrapper 时可能会遇到的已知问题及其故障排除提示。

收集日志

Orbbec SDK K4A Wrapper 的日志由底层 Orbbec SDK 输出，默认输出到应用程序工作目录下的 目录下。日志以循环覆盖的方式输出到固定 4 个文件中，默认单个文件最大 100 MB。建议用户反馈问题时可以将日志文件一并打包发送。

设备未列在设备管理器中

● 请查看后面指示灯，如果闪橙黄色，表示供电不足，请用电源适配器供电再试，如果此时闪白灯，表示USB连接异常，请找其他原因。

● 检查是否已连接电源线并使用 USB3 端口来传输数据。

● 尝试改用 USB3 端口来建立数据连接（建议使用靠近主板的 USB 端口，例如，电脑背面的 USB 端口）。

● 检查线缆的状态，受损或劣质的线缆会导致列出的信息不可靠（设备在设备管理器中不断“闪烁”）。

● 如果已连接到笔记本电脑并且该电脑以电池运行，则端口的电量可能会受到限制。

● 重新启动主机电脑。

● 如果问题仍然存在，则可能是存在兼容性问题。

k4aviewer 无法打开相机

● 先检查设备是否列在 Windows 设备管理器中。

● 检查是否有任何其他应用程序正在使用该设备（例如 Windows 相机应用程序）。 每次只能有一个应用程序访问该设备。

● 检查日志中的错误消息。

● 打开 Windows 相机应用程序，检查它是否可正常工作。

● 关闭再打开设备的电源，等待流 LED 熄灭，然后再使用设备。

● 重新启动主机电脑。

● 确保在电脑上使用最新的图形驱动程序。

● 如果你使用自己的 SDK 版本，请尝试使用正式发布的版本（如果可以解决问题）。

设备固件更新问题

● 如果更新后未报告正确的版本号，则可能需要关闭再打开设备；

● 设备固件更新过程被打断，可以重新给设备上电后再执行更新。

图像质量问题

● 启动 Femto Mega 查看器，检查设备的位置，以确定是否存在干扰、传感器被遮挡，或者镜头脏污。

● 如果问题在特定的模式下发生，请尝试不同的运行模式，以缩小问题的检查范围。

● 若要与团队配合解决图像质量问题，可以：

1. 抓取Femto Mega 查看器的暂停视图并抓取屏幕截图，或

2. 使用Femto Mega 查看器录制，例如 k4arecorder.exe -l 5 -r 5 output.mkv

不一致或意外的设备时间戳

调用 k4a_device_set_color_control 可能会暂时引发设备的计时更改，这些更改可能需要几个捕获才能稳定。 避免在图像捕获循环中调用 API，以免重置每个新图像的内部计时计算。 可以改为在启动相机之前或需要更改图像捕获循环内的值时调用 API。 具体而言，请避免调用 k4a_device_set_color_control(K4A_COLOR_CONTROL_AUTO_EXPOSURE_PRIORITY)。

将人体跟踪 SDK 与 Unreal 配合使用

若要将人体跟踪 SDK 与 Unreal 配合使用，请确保已将 <SDK Installation Path>\tools 添加到环境变量 PATH，并已将 dnn_model_2_0.onnx 和 cudnn64_7.dll 复制到 Program Files/Epic Games/UE_4.23/Engine/Binaries/Win64。