> For the complete documentation index, see [llms.txt](https://docs.velogicfit.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.velogicfit.com/zh/di-01-jie-ru-men/lighting-environment.md).

# 照明与环境

优化照明条件和摄像头环境设置的指南，以提高标记点检测和整体系统性能。

系统将在接近黑暗的环境中识别标记点。不过，如果你在环境设置上多加留意，摄像头的表现会更好。

## 质量指标

质量指标是一个小型屏幕显示，用于帮助你快速识别适配区域中的任何问题。

在第1步：配置中，质量指标会出现在 Kinect 摄像头预览旁边：

![Velogic Studio 第1步：配置，显示摄像头预览旁边的质量指标面板，用于监控系统性能](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-6473f03bcb1404f27a2acee72f17a0203f987e19%2Fquality-indicators-step1.png?alt=media)

如果你点击加号按钮，质量指标将展开，显示每个指标的数值以及一些附加选项：

![展开的质量指标面板，显示数值和附加选项，用于详细性能监控](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-a33acde197e9ecbda1df9034e6ffb9e38c641d13%2Fexpanded-quality-indicators.png?alt=media)

质量指标也会出现在第2步：捕捉中，并增加一个“检测”指标：

![第2步：捕捉视图，显示质量指标，包括帧率、曝光和检测状态，并增加了检测指标](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-18b60fcf2aef9201296253bbc977452758f71863%2Fquality-indicators-step2.png?alt=media)

## 曝光

曝光是指相机光圈保持开启以捕获每一帧的毫秒数。

一般来说，你希望光圈开启的时间尽可能短，以尽量减少视频和静态图像中的运动模糊。但前提是光圈需要保持开启足够长的时间，以便捕获足够的光线，为每一帧拍出清晰的场景图像。

我们希望摄像头达到每秒30帧，这意味着曝光时间应小于33毫秒。（每帧33毫秒 × 每秒30帧 = 1秒）

Kinect 摄像头内置了自动曝光方法。其工作原理大致如下：

1. 如果光线足以在30fps下生成白平衡良好的图像，就这样做
2. 如果光线不够好，就降到15fps
3. 如果光线非常差，就降到低于15fps

有时，如果光照条件不理想，或者背景是纯白或纯黑，即使看起来应该可以达到，Kinect 摄像头也不会以 30fps 运行。在这种情况下，我们可以覆盖 Kinect 摄像头内置的自动曝光功能，手动设置曝光。

只需点击“曝光模式”下拉菜单，并选择“手动曝光”：

![手动曝光控件，显示“曝光模式”下拉菜单已设为“手动”，并提供“曝光”和“增益”滑块以微调摄像头设置](https://2529810062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjxwtZYYk0lvusnMTywNR%2Fuploads%2Fgit-blob-c6deb8768417db193115a357668f085bb5a6679d%2Fmanual-exposure-controls.png?alt=media)

然后你会看到两个额外的控件：

1. 一个“曝光”滑块，可让你手动将曝光设置为 1 毫秒到 30 毫秒。
2. 一个“增益”滑块，可让你设置增益（亮度）

请注意，在使用手动曝光控件时，在某些光照条件下，图像有时会看起来“闪烁”，这取决于你的电源频率。你可以稍微调整曝光来减少闪烁。

## 照明提示

1. 理想情况下，你希望光线均匀扩散，也就是在空间中持续均匀分布。骑行者或背景上出现亮斑并不会提高分数。
2. 浅色背景有助于让光线在空间中反射，而不是被吸收
3. 间接的自然光（例如来自窗户）非常好

## 照明产品

如果你需要为场景添加人工照明，以下是一些其他安装者成功使用过的产品：

1. [Nanoleaf 灯带](https://nanoleaf.me/en-NZ/products/essentials/lightstrips/?category=lightstrips\&standard=matter\&pack=smarter-kit\&size=2) 可产生约 2200 流明，对于 LED 灯带来说相当明亮。用一条或多条这样的灯带照亮你的 fit 工作室，是一种经济且外观有趣的方式来增加照明。
2. 亚马逊上的“车库灯”，例如 [这款](https://www.amazon.com/POLARPRA-LED-Garage-Light-Adjustable/dp/B0BFNNQXWH) 非常明亮，而且由于它们适配标准灯座，因此可以搭配 [灯泡支架](https://www.amazon.com/Emart-Photography-Holder-Light-Umbrella/dp/B07X37NZSK) 使用，而该支架可以安装到三脚架上。

## 帧率

帧率表示 Velogic Studio 每秒能够从 Kinect 获取并处理多少帧。如果你只有 15/16fps，很可能是 Kinect 的自动曝光方法降低了 Kinect 摄像头的 FPS。请参见上面的“曝光”部分。

## 检测

检测显示系统是否能够稳定地找到恰好 7 个标记点。

## 仍然有问题吗？

查看我们的 [故障排除指南](/zh/di-02-jie-shi-yong-velogic-studio/troubleshooting.md) 如果你在使用质量指标时难以获得良好结果。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.velogicfit.com/zh/di-01-jie-ru-men/lighting-environment.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.