Настройка работы с картой захвата

Труконф08.10.2026Около 5 мин

Настройка работы с картой захвата

«Пустой» кадр (blank-picture)

Для корректного переключения источника на предыдущий при его отключении от карты захвата TrueConf Room распознаёт сигнал статуса от карты захвата.

Если же карта захвата не поддерживает определения статуса подключения устройств, TrueConf Room предоставляет возможность настроить пустой кадр, по которому определяется неактивность в таком случае.

Принцип работы

  1. При запуске программа читает все файлы-эталоны из определённой папки.

  2. Каждый кадр с карты захвата уменьшается до 128×128 и сравнивается с эталонами по яркости, «структуре» картинки и т.п.

  3. Если кадр совпал с эталоном хотя бы по одному из признаков — карта считается не передающей картинку (пустой кадр).

Настройка «пустого» кадра

Чтобы TrueConf Room мог определить пустой кадр, необходимо:

  1. Подключить карту захвата без отображаемого изображения (отключите источник сигнала).

  2. Подключите клавиатуру к ПК с установленным TrueConf Room

  3. Сделайте скриншот изображения пустого кадра с карты захвата. Файл изображения должен соответствовать требованиям (сделать это можно например в разделе настроек Видео).

  4. Поместите файл в папку ../TrueConf/Room/captureCards.

  5. Перезапустите TrueConf Room.

  6. Проверьте лог-файлы.

Требования к изображению

Поддерживаются распространённые растровые форматы:

ФорматРасширения
PNG.png
JPEG.jpg, .jpeg
BMP.bmp
GIF.gif
ПрочиеTGA, PSD, PNM, HDR

Файл должен быть обычным изображением. Не используйте текстовые файлы, файлы Word/Excel, сжатые архивы и т.п. — они не распознаются как изображения.

Свойства подходящего изображения:

ПараметрТребование
Минимальный размерне меньше 128×128 по каждой стороне
Максимальный размерне больше 10000×10000 по каждой стороне
Максимальный размер файлане больше 10 МБ
Рекомендуемый размерот 128×128 до 1920×1080, желательно в том же разрешении, что и кадр карты

Любое изображение автоматически уменьшается до 128×128 для сравнения, поэтому точное разрешение не критично, главное — соблюсти минимум и максимум.

Изображение не должно быть однотонным (сплошная заливка одним цветом). Такие файлы пропускаются и не участвуют в сравнении.

Порог определения

В имени файла можно указать порог совпадения — токен acc с числом (регистр букв не важен, перед токеном ставится _ или -):

Имя файлаПорогЧто это значит
stub.png80 (по умолчанию)стандартная точность
stub_ACC90.png90кадр должен почти совпадать с эталоном
stub_acc85.png85промежуточный вариант
dexpAnycast_ACC91.bmp91пример который изначально находится в папке приложения

Как выбрать порог:

  • Частые ложные срабатывания (обычный кадр ошибочно считается «пустым») -> увеличьте число, например acc95.
  • Функция не срабатывает (пустой кадр не распознаётся) -> уменьшите число, например acc75.

Если токен acc отсутствует или записан неверно — используется порог по умолчанию 80. Число должно быть от 0 до 100.

Путь расположения файлов

Папка captureCards находиться по пути:

  • Windows: C:\Program Files\TrueConf\Room\captureCards

  • Linux: /opt/trueconf/room/captureCards

Правила размещения:

Где лежит файлДля кого работает
Прямо в папке captureCards/общий эталон - проверяется для всех карт захвата
В подпапке captureCards/<идентификатор>/эталон только для одной конкретной карты

Подпапка для конкретных устройств

Чтобы не возникало конфликтов при сравнении пустых изображений разных карт захвата, вы можете создать отдельную папку с именем в виде идентификатора устройства в формате vid#pid (без учёта регистра) для записи отдельных пустых экранов для конкретных устройств. Примеры уже используемых имён: 07ca#0110, 17ef#7219, 17ef#722f.

Как узнать свой vid#pid:

  • Windows: Диспетчер устройств → устройство захвата → Свойства → Сведения → Идентификаторы оборудования. Строка вида USB\VID_07CA&PID_0110, имя подпапки 07ca#0110.

  • Linux: команда lsusb показывает ID 07ca:0110 → имя подпапки будет 07ca#0110.

Если идентификатор неизвестен — используйте общий эталон положив файл прямо в ../captureCards.

Лог-файлы для проверки работы

После запуска программы в логе должна появиться строка вида:

[BlankPicture] Loaded 3 high-priority and 1 low-priority capture card stubs

Искать по подстроке [BlankPicture]

  • high-priority - эталоны в подпапках (для конкретных устройств);
  • low-priority - общие эталоны (в корне папки).

Если эталон не загрузился, в логе появится предупреждение [BlankPicture] с причиной: неподдерживаемый формат, слишком маленькое изображение, однотонное изображение и т.п.

ПлатформаПуть к папке логов TCR
Windows%USERPROFILE%\AppData\Local<Const name='company-name'/>\Room\logs\
Linux~/.config/trueconf/room/logs/

Частые проблемы

  • В логе нет строки Loaded ... stubs

    Проверьте, что папка captureCard существует и не пуста.

  • В логе unsupported format or corrupted

    Убедитесь, что файл пустого кадра имеет формат изображения.

  • В логе Image dimensions too small

    Убедитесь, что файл соответствующего размера.

  • В логе Skipping uniform stub

    Эталонный файл пустого кадра был считан, как однотонный.

  • Пустой кадр не определяется

    Вероятно порог определения эталонного изображения слишком высок.

  • Обычный кадр определяется как «пустой»

    Проверьте, что порог определения эталонного изображения достаточно высок.

Последнее обновление: