ЛУЧ
RU
Главная / Как это работает

Как работает Луч

Две части: служба на компьютере и приложение-приёмник на экране. Служба забирает картинку и звук, кодирует и отправляет по UDP, приёмник декодирует и показывает.

Режимы показа

РежимЧто показываетЗадержка отправителя
fastвесь основной монитор прямо из кадрового буфера (KMS), курсор дорисовывается; HEVC или H.264, в зависимости от приёмника≈ 5–6 мс
monitorэкран через системный портал (PipeWire, DMA-BUF, без копирования)≈ 15–25 мс
windowодно окно через порталкак у monitor
virtualвторой экран, расширяющий рабочий стол (в GNOME создаётся виртуальный монитор)как у monitor

Цифры из документации проекта. Звук (Opus, кадры 5 мс) снимается с основного вывода во всех режимах.

Откуда малая задержка

Захват и кодированиеСеть в одну сторонуДекодирование на приёмникеИтого, без экрана
≈ 5,5 мс≈ 2 мс≈ 5,5 мс (HEVC)≈ 13 мс

Приёмы: ни одной лишней копии кадра, одно опорное изображение и без B-кадров, бесконечная группа кадров с ключевым кадром по запросу, буфер на один кадр, самый быстрый режим кодировщика. Пакеты уходят в тот момент, когда кодировщик их отдал.

Примеры замеров

УстройствоРежимЗахватПреобразованиеКодированиеИтого на отправителе
Steam Deck (AMD), кадр 1280×800, 60 кадров/сfast≈ 0,08 мс≈ 2,3 мс≈ 9,4 мс≈ 12 мс

Данные из журнала помощника luch-kms во время показа на Google TV Streamer. Замеры с других устройств будут добавлены.

Из чего состоит

ЧастьЧто делает
luchdслужба пользователя: находит приёмники в сети (Avahi, _luch._tcp), держит каналы управления, снимает и отправляет картинку и звук, отдаёт D-Bus API dev.luch.Luch1
luch-kmsмаленький помощник для режима с минимальной задержкой: читает кадровый буфер, переводит в NV12 на GPU, кодирует через VA-API. Единственная часть с повышенными правами (CAP_SYS_ADMIN)
luchctlконсольная утилита: список, показ, остановка, статистика
приёмникприложение для Android: показывает картинку, играет звук, считает статистику

Что нужно

Компьютер

Linux с VA-API-кодировщиком и Mesa EGL. Видеокарты Intel и AMD поддерживаются полностью. Для режимов через портал нужна сессия GNOME на Wayland. Режим fast работает в любом композиторе, который выводит картинку через KMS.

Приёмник

Устройство на Android 5.0 и новее с приложением Луч. Должно быть в той же сети, что и компьютер: mDNS через маршрутизаторы не проходит.

Сеть

Локальная сеть, лучше Wi-Fi 5 ГГц или кабель. Поток привязан к сетевому интерфейсу, найденному приёмником, поэтому VPN с полным туннелем его не несёт.