本文内容

● 已知问题    

● 网络日志

● 装备未列在装备治理器中

● k4aviewer无法打开相机

● 装备固件更新问题

● 图像质量问题

● 纷歧致或意外的时间戳

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

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

 本文包罗在 Femto Bolt  中使用 Orbbec SDK K4A Wrapper 时可能会遇到的已知问题及其故障扫除提醒。

已知问题

● Linux平台下，深度引擎库需要使用OpenGL，若是应用层也使用OpenGL、且跨线程挪用OpenGL实例，可能会造成上下文冲突，导致深度引擎在初shi化时泛起问题，以及无法正常启动深度数据流。

若是应用层使用了OpenGL渲染，要在应用层参考OpenGL下面链接切换Context：

(https://www.khronos.org/opengl/wiki/OpenGL_and_multithreading)

以下是大宝娱乐使用glfw库的解决要领：

a. 在开流之前，挪用glfwMakeContextCurrent(NULL) 。

b. 然后再开流。

c. 开流竣事后，挪用glfwMakeContextCurrent(currentContext)。

// 参考github： file: tools/k4aviewer/k4adevicedockcontrol.cpp
GLFWwindow *currentContext = glfwGetCurrentContext(); // store the current context
glfwMakeContextCurrent(NULL);  // make current context to NULL
StartCameras(); //  will initialize the DepthEngine
glfwMakeContextCurrent(currentContext); // restore the current context

● 有关其他相关问题，请审查 GitHub Issues

网络日志

Orbbec SDK K4A Wrapper 的日志由底层 Orbbec SDK 输出，默认输出到应用法式事情目录下的 目录下。日志以循环笼罩的方式输出到牢靠 4 个文件中，默认单个文件最大 100 MB。建议用户反馈问题时可以将日志文件一并打包发送。

装备未列在装备治理器中

● 请审查后面指示灯，若是闪橙黄色，体现供电不足，请用电源适配器供电再试，若是此时闪白灯，体现USB毗连异常，请找其他缘故原由。

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

● 实验改用 USB3 端口来建设数据毗连（建议使用靠近主板的 USB 端口，例如，电膟uan趁娴 USB 端口）。

● 检查线缆的状态，受损或劣质的线缆会导致列出的信息不行靠（装备在装备治理器中一直“闪灼”）。

● 若是已毗连到眘hi潜镜缒远襣ai电脑以电池运行，则端口的电量可能会受到限制。

● 重新启动主机电脑。

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

k4aviewer 无法打开相机

● 先检查装备是否列在 Windows 装备治理器中。

● 检查是否有任何其他应用法式正在使用gai装备（例如 Windows 相机应用法式）。 每ci只能有一个应用法式会见gai装备。

● 检查日志中的错误新闻。

● 打开 Windows 相机应用法式，检查它是否可正常事情。

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

● 重新启动主机电脑。

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

● 若是你使用自己的 SDK 版本，请实验使用正式宣布的版本（若是可以解决问题）。

装备固件更新问题

● 若是更新后未陈诉准确的版本号，则可能需要关闭再打开装备；

● 装备固件更新历程被打断，可以重新给设惫亓后再执行更新。

图像质量问题

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

● 若是问题在特定的模式下发生，请实验差异的运行模式，以缩小问题的检查规模。

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

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

2. 使用Femto Bolt 审查器录制，例如 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。

在无外设 Linux 系统上使用 Femto Bolt

Linux 上的 Femto Bolt 深度引擎使用 OpenGL。 OpenGL 需要一个窗口实例，gai实例需要将监视器毗连到系统。 此问题的解决要领是：

1. 为妄想使用的用户帐户启用自动登录。 有关怎样启用自动登录的说明，请参阅此文。

2. 关闭系统电源，断开显示器的毗连，然后打开系统电源。 自动登录会强制建设 x-server 会话。

3. 通过 ssh 举行毗连，并设置 DISPLAY 情形变量 export DISPLAY=:0

4. 启动 Femto Bolt 应用法式。

xtrlock 适用工具可用于在自动登录后连忙锁定屏幕。 添加以下下令以启动应用法式或 systemd 服务：

bash -c “xtrlock -b”