Это старая версия документа!
Содержание
Замена mjpg-streamer на ustreamer
Зачем и почему?
ustreamer (читается как мю-стример) это mjpg-streamer «на стероидах». Таблица различий есть на странице проекта. Из достаточно полезного - он быстрее (кодирует jpeg в несколько потоков), умеет не падать, если отключить камеру. В сообществе есть пруфы, что на mjpg-streamer'e картинка с c270 сыпалась, а с мю-стримером все заработало без проблем.
Как пишет сам разработчик: «Если вы собираетесь вести прямую трансляцию с веб-камеры на заднем дворе и вам нужно ее контролировать, используйте mjpg-streamer. Если вам нужно качественное изображение с высоким FPS — µStreamer в помощь». Мю-стример не умеет работать с камерами с сервоприводами и управлением фокусировкой, но нам это и не нужно.
Ну и ложка дегтя - в kiauh mjpg-streamer на момент написания статьи пропал, плюс есть инфа что его (mjpg-streamer) разломали. У него там половину библиотек умерло, вернее они обновились новыми и нужно уже разбираться что да как.
Здесь описывается локальная сборка, в идеале надо сделать пакет, но это, возможно, в будущем.
Отключаем mjpg-streamer
Первым делом надо остановить и отключить mjpg-streamer, если он есть в системе. Так как ustreamer вырос из mjpg-streamer'a. Выполняем команды:
sudo systemctl stop webcamd sudo systemctl disable webcamd
Такими действиями мы не удалили, но отключили mjpg-streamer.
Сборка ustreamer
Далее нам надо собрать ustreamer. В принципе, инструкция есть на домашней странице проекта на гитхабе.
Пререквизиты для сборки make, gcc, libevent c поддержкой pthreads, libjpeg-turbo и libbsd.
sudo apt install libevent-dev libjpeg62-turbo-dev libbsd-dev libgpiod-dev libsystemd-dev
Собираем его (по-умолчанию в нашем домашнем каталоге, ~/, он же /home/klipper). Сборку делаем с поддержкой GPIO (не смог придумать кейс, но пусть будет) и поддержкой SYSTEMD (для автозапуска).
git clone --depth=1 https://github.com/pikvm/ustreamer cd ustreamer WITH_GPIO=1 WITH_SYSTEMD=1 make ./ustreamer --help
Установка ustreamer
В итоге, если все получилось, инсталлируем стример локально.
sudo make install
После выполнения этой команды бинарник стримера будет установлен в /usr/local/bin/
Дальше нам надо решить вопрос с автозапуском. Что нужно сделать описано здесь. Но мы приведем здесь последовательность действий, адаптированную под нашу систему.
Первым делом надо убедиться, что установка прошла успешно:
ls -l /usr/local/bin/ustreamer -rwxr-xr-x 1 root root 419392 ноя 10 12:18 /usr/local/bin/ustreamer
У вас права доступа (-rwxr-xr-x) должны быть как в примере выше.
Запускать процесс будем от имени пользователя klipper.
Добавляем пользователя в группу video (он там уже должен быть, но хуже от команды точно не будет):
sudo usermod -a -G video klipper
Далее нам нужно создать руками конфигурационный файл для systemd. В нашем случае мы не будем делать как предлагает автор ustreamer'a, сделаем конфиг под конкретное видеоустройство, а именно /dev/video1 (если у вас камера на другом порту, то надо указывать его, конечно), а также, чтобы ustreamer «слушал» на порту 8080, там видеопоток ожидает клиппер.
Используем наиболее привычный вам текстовый редактор в unix-среде (vim, nano, joe..):
sudo nano /etc/systemd/system/ustreamer.service
в файле пишем следующее (обратите внимание - формат, fps и качество задаются в ключах resolution, desired-fps и quality соответственно):
[Unit] Description=uStreamer service After=network.target [Service] Environment="SCRIPT_ARGS=1" User=klipper ExecStart=/usr/local/bin/ustreamer --process-name-prefix ustreamer-1 --log-level 0 --device /dev/video1 --device-timeout=8 --quality 100 --resolution 1280x720 --desired-fps=30 --host=0.0.0.0 --port=8080 --static /var/www/html/ustreamer-1/ [Install] WantedBy=multi-user.target
Включаем автозапуск стримера:
sudo systemctl enable ustreamer.service
и, наконец, запускаем сервис:
sudo systemctl start ustreamer.service
Убеждаемся, что все запустилось:
systemctl status ustreamer <master> ● ustreamer.service - uStreamer service Loaded: loaded (/etc/systemd/system/ustreamer.service; enabled; vendor preset: enabled) Active: active (running) since Thu 2022-11-10 12:44:07 MSK; 4s ago Main PID: 4544 (main) Tasks: 7 (limit: 2218) Memory: 3.3M CPU: 1.287s CGroup: /system.slice/ustreamer.service └─4544 ustreamer-1: /usr/local/bin/ustreamer --process-name-prefix ustreamer-1 --log-level 0 --device /dev/video1 --device-timeout=8 --quality 100 --resolution 1280x720 --desired-fps=30 --host=0.0.0.0 --port=8080 --static /var/www/html/ustreamer-1/
Финально заходим в интерфейс клиппера - всё должно работать (если вы до этого уже настраивали камеру и прописывали все нужные настройки, конечно).