IP-камера

Адаптер IP-камер для ioBroker

Вы можете интегрировать свои веб/IP-камеры в vis и другие средства визуализации. Если вы настроите камеру с именем cam1, она будет доступна на веб-сервере по адресу http(s)://iobroker-IP:8082/cameras.0/cam1.

Используйте именно этот URL-адрес — без расширения файла. Каждый запрос к нему получает новый кадр с камеры, поэтому периодическая перезагрузка обеспечивает отображение изображения в реальном времени.

Адаптер дополнительно сохраняет последний кадр в файл под адресом cameras.0/cam1.jpg, который веб-сервер также обслуживает под адресом http(s)://iobroker-IP:8082/cameras.0/cam1.jpg. Этот файл перезаписывается только при запуске адаптера и при обработке сообщения image — он не обновляется при запросе. Поэтому при наведении виджета на .jpg отображается изображение, которое никогда не обновляется, независимо от заданного интервала обновления.

Кроме того, изображение можно запросить через сообщение:

sendTo('cameras.0', 'image', {
    name: 'cam1',
    width: 100, // optional
    height: 50, // optional
    angle: 90,   // optional
    noCache: true // optional, if you want to get the image not from cache
}, result => {
    const img = 'data:' + result.contentType + ';base64,' + result.data;
    console.log('Show image: ' + img);
});

Результат всегда отображается в формате jpg.

Поддерживаемые камеры:

• Reolink E1 Pro через RTSP (важно, без Pro работать не будет)
• Eufy через адаптер eusec
• HiKam второго и третьего поколения через ONVIF (для S6, Q8, A7 2. Generation), A7 Pro, A9
• WIWICam M1 через адаптер HiKam
• Поддержка RTSP (если ваша камера поддерживает протокол RTSP)
• Скриншоты через HTTP-адрес - если вы можете получить снимок с вашей камеры через URL-адрес.

URL изображения

Это обычный URL-запрос, где все параметры находятся в самом URL. Например, http://mycam/snapshot.jpg

Изображение по URL с базовой аутентификацией

Это запрос изображения по URL, где все параметры указаны в URL, но вы можете указать учетные данные для базовой аутентификации. Например, http://mycam/snapshot.jpg

FFmpeg

Для доступа к снимкам с RTSP-камер можно использовать ffmpeg. Необходимо установить ffmpeg на вашем компьютере:

• В Windows ffmpeg уже скомпилирован, и ничего скачивать не нужно. (Версия для Windows взята отсюда: https://www.gyan.dev/ffmpeg/builds/ffmpeg-git-full.7z)
• Linux: sudo apt-get install ffmpeg -y

Как обновить версию ffmpeg для Windows:

• Скачать файл https://www.gyan.dev/ffmpeg/builds/ffmpeg-git-full.7z
• Распакуйте файл bin/ffmpeg.exe — Переименовать ffmpeg.exe в win-ffmpeg.exe
• Заархивируйте файл win-ffmpeg.exe в файл win-ffmpeg.zip — Поместите файл win-ffmpeg.zip в корневую папку этого репозитория. — Выполните команду win-ffmpeg.exe --version, чтобы получить версию, и сохраните её в константе WIN_FFMPEG_VERSION в файле main.ts (например, 2025-02-02-git-957eb2323a-full_build-www.gyan.dev).

Вот пример того, как добавить Reolink E1:

Ezviz - Как повторно включить RTSP для камер EZVIZ

По какой-то причине компания EZVIZ решила отключить протокол RTSP для своих камер:

Откройте приложение EZVIZ и перейдите в: Профиль / Настройки / Просмотр в режиме реального времени по локальной сети — Начните сканирование, затем выберите «Камера»: — Войдите в систему, используя пароль от вашей камеры (пароль по умолчанию указан на наклейке камеры). — Нажмите на значок «Настройки» и выберите «Настройки локальных служб».

• Включить RTSP

Как добавить новую камеру (для разработчиков)

Простой способ: новый производитель универсального типа

Большинству камер не требуется никакого кода. Тип universal определяется файлами данных в src-admin/public/data/, которые генерируются с сайта ispyconnect.com:

1. Добавьте производителя в карту MANUFACTURERS в верхней части файла tools/parser.js.
2. Запустите node tools/parser.js <manufacturer> — это запишет src-admin/public/data/<manufacturer>.json

и обновления manufacturers.json

3. Запустите node tools/logos.js, чтобы добавить логотип. Он использует фирменный знак из simple-icons, если это необходимо.

В коллекции указан производитель, в противном случае генерируется монограмма. Чтобы использовать настоящий логотип, просто поместите <manufacturer>.svg, .png или .jpg в src-admin/public/data/ — существующие файлы никогда не перезаписываются (если не указан --force).

Новый производитель затем отображается в выпадающем списке типа камеры «По производителю».

Специализированный тип камеры

Требуется только в том случае, если камере необходима собственная логика. Создайте запрос на слияние (Pull Request) со следующим содержимым:

• src/types.d.ts — добавить ключ в объединение CameraType, добавить CameraConfigMyCam extends CameraConfig

и добавить его в объединение CameraConfigAny

• src/cameras/MyCamCamera.ts — расширить GenericCamera для получения простого HTTP-снимка или GenericRtspCamera

для RTSP (заполните this.settings и this.decodedPassword в init() перед вызовом super.init())

• src/cameras/Factory.ts — добавить case для нового типа
• src-admin/src/Types/MyCam.tsx — диалоговое окно настройки, расширяющее ConfigGeneric.
• src-admin/src/Tabs/Cameras.tsx — импортируйте диалоговое окно и добавьте его в структуру TYPES, например:

mycam: { Config: MyCamConfig as unknown as IConfigGeneric, name: 'MyCam' },. Ключ должен быть идентичен ключу type, используемому в бэкэнде.

• Добавьте новые метки ко всем файлам в src-admin/src/i18n/

Go2rtc (необязательно)

Если в настройках включен параметр go2rtc, локальный процесс go2rtc заменяет процессы ffmpeg: по одному на каждый снимок в адаптере и по одному на каждую камеру в веб-расширении. go2rtc поддерживает одно соединение на каждую камеру и обслуживает всех потребителей с этой камеры.

go2rtc привязывает свой API к 127.0.0.1 и никогда не доступен напрямую из браузера. Весь доступ осуществляется через адаптер web, поэтому он использует ту же аутентификацию и ту же схему http/https, что и остальная часть ioBroker — никаких дополнительных портов открывать не нужно. Помимо существующего веб-сокета, каждая камера также предлагает /<instance>/<camera>/stream.mjpeg, который можно использовать в обычном <img src="/ru/adapterref/iobroker.cameras/...">.

Если исполняемый файл не найден или не запускается, адаптер автоматически переключается на ffmpeg.

Todo

• Отправлять новые запросы на подписку на RTSP-камеры, если диалоговое окно открыто или закрыто

Changelog

3.0.2 (2026-08-17)

• (@GermanBluefox) The web extension can now request snapshots via messages instead of the private HTTP server, which is used automatically when the cameras adapter runs on a different host than the web instance
• (@GermanBluefox) Fixed: a failed snapshot request answered with an empty {} instead of the error message

3.0.1 (2026-08-16)

• (@GermanBluefox) Completely rewritten in TypeScript
• (@GermanBluefox) Added Ezviz cameras
• (@GermanBluefox) Snapshot requests are answered with Cache-Control: no-store so browsers cannot show a stale frame
• (@GermanBluefox) Fixed: a list of allowed IPs was never split correctly, so any list with more than one address rejected every request
• (@GermanBluefox) Fixed: connections from the IPv6 loopback address were not recognized as local
• (@GermanBluefox) Fixed: a failed image request could terminate the adapter with ERR_HTTP_HEADERS_SENT
• (@GermanBluefox) The cameras are reachable immediately after start instead of only after the first frame of every camera was grabbed
• (@GermanBluefox) The web extension picks up a changed key by itself, without restarting ioBroker.web
• (@paul179) Added Steinel cameras (as manufacturer of the universal camera type)
• (@GermanBluefox) The universal camera type now offers ~50 manufacturers with ~13000 models, each with a logo
• (ioBroker-Bot) Removed the deprecated common.materialize from io-package.json
• (ioBroker-Bot) Adapter requires js-controller >= 6.0.11 now
• (ioBroker-Bot) Adapter requires node.js >= 22 now
• (@GermanBluefox) Added Instar cameras
• (@GermanBluefox) Added optional go2rtc support for snapshots and live streams, proxied via the web adapter
• (@GermanBluefox) Fixed: the second viewer of the same camera did not receive any picture
• (@GermanBluefox) Added two widgets for ioBroker.devices: RTSP camera and snapshot camera
• (@GermanBluefox) Fixed: the .running state did not start or stop the stream
• (@GermanBluefox) Fixed: width/height/angle of the image message were ignored
• (@GermanBluefox) Fixed: a camera in the dialog of the snapshot widget was never used

2.1.2 (2024-07-15)

• (bluefox) Updated packages

2.1.1 (2024-07-07)

• (bluefox) Removed withStyles package

2.0.8 (2024-06-09)

• (bluefox) Packages updated
• (bluefox) Allowed selecting another source (with bigger resolution) for URL cameras

License

MIT License

Copyright (c) 2020-2026 bluefox dogafox@gmail.com

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.