使用 Cameras.yml 限制可发现的相机

要限制 Zivid SDK 可以连接的相机，请下载 Cameras.yml，在其中列出允许的 IP 地址或主机名，然后将其放入 Zivid 配置文件夹中。

Zivid SDK 如何找到相机？

Zivid SDK 使用多播 DNS（mDNS）在网络上自动发现相机。在 SDK 2.7 及更早版本中，使用非默认 IP 的相机必须列在 Zivid 配置文件夹中的 Cameras.yml 文件中，SDK 会搜索该文件以发现相机。

尽管 mDNS 消除了对 Cameras.yml 的需求，但该文件仍可用于覆盖 SDK 可以连接的相机。因此，如果提供了 Cameras.yml，它就具有限制 PC 可连接相机的功能。

如果您只需要连接到某个已知地址的特定相机，可以直接通过其 IP 地址或主机名连接，而无需使用 Cameras.yml。有关操作方法，请参阅 捕获教程。

Cameras.yml

如果您希望限制 Zivid SDK 搜索的 IP，请下载 Cameras.yml 并将其放入 Zivid 配置文件夹中，如下所示。

Windows

mkdir %LOCALAPPDATA%\Zivid\API
move %HOMEPATH%\Downloads\Cameras.yml %LOCALAPPDATA%\Zivid\API\

Ubuntu

mkdir --parents "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API
mv ~/Downloads/Cameras.yml "${XDG_CONFIG_HOME-$HOME/.config}"/Zivid/API/

小心

任何现有的配置文件都将被覆盖。

小心

Zivid 配置文件必须使用 .yml 文件扩展名（不是 .yaml）。

下面展示了一些 Cameras.yml 的示例，分别使用主机名或 IP 地址。

选项：限制 IP 地址

Cameras.yml 文件示例（IP 地址）

__version__: 1
Cameras:
    NetworkCameras:
        - NetworkCamera:
              Host: 172.28.60.5
        - NetworkCamera:
              Host: 172.28.60.6
        - NetworkCamera:
              Host: 172.28.60.7

选项：限制主机名

Cameras.yml 文件示例（主机名）

__version__: 1
Cameras:
    NetworkCameras:
        - NetworkCamera:
              Host: zivid-2152D404.local
        - NetworkCamera:
              Host: zivid-20205M19.local
        - NetworkCamera:
              Host: zivid-21389K63.local

Next Steps

返回 连接到相机。