Создание стрима и управление им¶

Стрим — это то, что вы отдаёте зрителю: источники, обработка, архив и воспроизведение под одним именем. Конфигурацию стрима хранит central, а работает стрим на стримере — где именно, central решает сам. Эта страница проводит по жизненному циклу: создать, найти в списке и понять состояние, править, выключить, удалить.

Создайте стрим¶

На экране Стримы введите имя в поле Имя нового стрима и нажмите Создать. Стрим создаётся сразу включённым, и открывается его страница — источников у него ещё нет, их вы добавляете следующим шагом.

Имя — это и адрес: оно входит в URL воспроизведения вида /streaming/v/<имя>/index.m3u8. Используйте латиницу, цифры, дефис и подчёркивание; пробелам и спецсимволам в URL не место.

Полный путь от пустой инсталляции до играющего стрима разобран в Быстром старте.

Найдите его в списке¶

Экран Стримы — все стримы инсталляции, строка на стрим, статистика перечитывается каждые несколько секунд. Поле Поиск по имени фильтрует таблицу по мере ввода, фильтр Статус — по значению индикатора.

В цепочке источников цвет точки — здоровье входа:

• Зелёная — источник работает.
• Полая зелёная — проверенный резерв.
• Жёлтая — источник деградировал.
• Красная — источник мёртв.
• Полая серая — ещё не проверялся.

Активный вход обведён кольцом. Клик по ячейке ведёт на соответствующую вкладку стрима: цепочка — в источники, DVR — в архив, число зрителей — в сессии.

Какой стрим на каком стримере работает, решает лейаутер. Дошло ли его решение до стримеров и почему стрим именно там, где он есть, показывает вкладка Лейаут страницы стрима — см. Состояние размещения.

Статусы¶

Индикатор в колонке Статус сведён по всем стримерам, которые участвуют в обработке стрима.

• Зелёный — работает: вход получает данные.
• Синий — неактивен: стрим не работает, и это нормально. Он ждёт зрителя, ждёт вещателя или у него нет входов.
• Жёлтый — ожидание: стрим запускается, вход открывается или ждёт первых кадров. Дольше таймаутов входа это не длится: потом стрим становится красным.
• Красный — авария: стрим не работает из-за ошибки. Ошибка бывает двух видов. Первый — стример не смог забрать источник: причину показывает цепочка источников в этой же строке. Второй — стрим не размещён как настроен: лейаутер не создал назначение, назначенный стример офлайн или стример отверг конфигурацию. Причину называет баннер в шапке страницы стрима, см. Состояние размещения.
• Серый — неизвестно: стримеры не присылают данных о стриме, и причины для ошибки не видно. Так выглядит стрим, который лейаутер ещё не разместил или о котором назначенные стримеры ещё не отчитались.

Надпись данных нет вместо индикатора: статистики о стриме нет вовсе. Стрим выключен либо только что создан.

Стрим может работать на нескольких стримерах сразу: один захватывает источник, другой пишет резервную копию архива, третий раздаёт стрим на эдже. Каждый стример сообщает свой статус стрима, роль при этом значения не имеет, а в списке показан худший из них. Пример: на стримере захвата стрим работает, а на стримере резервной копии ещё запускается — в списке стрим жёлтый; на любом из них ошибка — красный.

Отдельно — янтарная подсветка всей строки: стрим жив, но работает не так, как задумано — активный вход деградировал либо стрим переключился с основного источника на запасной. Красная точка в начале цепочки источников — упавший основной. Как устроено переключение и как его настраивать — на странице резервирования источников.

Как применяются правки¶

Клик по имени стрима открывает его страницу: вкладки с настройками, а в шапке — Сохранить, Отмена, Удалить.

• Правки на любых вкладках копятся в браузере, пока вы не сохраните. Вкладка с несохранёнными изменениями помечается точкой.
• Сохранить активна, только когда изменения есть, и отправляет их все разом. Если какое-то значение не прошло проверку, страница называет конкретное поле, и не применяется ничего.
• Отмена откатывает всё несохранённое.
• Сохранённая конфигурация вступает в силу не мгновенно: central доставляет её стримеру, и через несколько секунд стрим работает по-новому.

Пока несохранённых правок нет, страница каждые несколько секунд подтягивает конфигурацию из central — изменение, сделанное коллегой, появится само. Ваши несохранённые правки фоновая синхронизация не затирает.

Выключите, не удаляя¶

Выключатель Включено живёт на вкладке основных настроек. Выключенный стрим останавливается: источники не забираются, зрителям ничего не отдаётся, в списке вместо индикатора стоит «данных нет». Конфигурация целиком остаётся — включите обратно, и стрим поднимется таким же.

Выключатель — такая же правка, как остальные: без Сохранить стрим продолжит работать.

Удалите¶

Кнопка Удалить в шапке страницы стрима, с подтверждением. Central убирает стрим из конфигурации, стример останавливает захват и раздачу. Остановка не мгновенна: несколько секунд стример ещё может отдавать поток, пока сворачивает работу.

Архив удалённого стрима остаётся на дисках стримеров ещё сутки: стримеры докладывают о нём central, тот назначает ему чистку как сироте, и стримеры стирают его. Стрим, созданный под тем же именем в эти сутки, получает старый архив как свой.

Что дальше¶

• Шаблоны стримов — вынести общие настройки транскодера и архива в умолчания вместо правки каждого стрима.
• Диагностика источника — как читать здоровье входа, дрифт таймлайна и ошибки источника.