feat(admin): рычаги нагрузки медиа — потолок качества публикации и лимит плиток
instance_settings.media_limits (publish_quality_cap: off/720p/360p/180p, stage_max_tiles: 4/9/16/25) — новая вкладка «Нагрузка» в админке, дефолты (off/25) сохраняют текущее поведение существующих инсталляций. Настройка отдаётся не только GET /admin/settings, но и в join-ответе (JoinOut) — участнику нужно иметь её на руках ДО публикации трека, а /admin/settings доступен только администратору. Потолок качества применяется через RoomOptions.publishDefaults (videoEncoding + videoSimulcastLayers на пресетах VideoPresets LiveKit) — режет битрейт верхнего слоя симулкаста, реальное разрешение WebRTC подстраивает сам. Лимит плиток — фильтрация STAGE_GRID_LAYOUTS по columns*rows в StageGrid, лишние участники уходят на страницу пагинации вместо подписки. Значение приезжает в joinState вместе с токеном ДО первого рендера LiveKitRoom (RoomPage не рендерит его, пока joinState не заполнен целиком), поэтому смена настройки не переподключает уже вошедшего участника — roomOptions пересчитывается по стабильной ссылке на joinState, которая после подключения не меняется. Проверено вживую на локальном стенде (docker compose --profile media): сохранение/персист настроек, join отдаёт актуальные значения, уже подключённый участник не разрывается при смене настройки в другом окне.
This commit is contained in:
@@ -62,6 +62,28 @@ SummaryRecipientsMode = Literal["all", "owner"]
|
||||
"""Режим рассылки саммари по умолчанию: всем участникам либо только
|
||||
владельцу конференции (переопределяется на уровне `conferences.summary_recipients`)."""
|
||||
|
||||
PublishQualityCap = Literal["off", "180p", "360p", "720p"]
|
||||
"""Потолок качества исходящего видео участника (задача «рычаги качества
|
||||
медиа»). `off` — без ограничения (дефолт, поведение как до появления
|
||||
настройки). Остальные значения режут `publishDefaults.videoEncoding` и
|
||||
`videoSimulcastLayers` на клиенте (`frontend/src/lib/publishQualityCap.ts`) —
|
||||
именно битрейт верхнего слоя симулкаста, а не жёсткое разрешение захвата
|
||||
камеры; фактическое разрешение WebRTC подстраивает под битрейт сам."""
|
||||
|
||||
StageMaxTiles = Literal[4, 9, 16, 25]
|
||||
"""Потолок числа одновременно видимых плиток на сцене (`StageGrid`) —
|
||||
режет набор доступных раскладок сетки, что бросает лишних участников на
|
||||
следующую страницу пагинации вместо подписки на их треки. `25` — дефолт,
|
||||
совпадает с текущим максимумом сетки (5×5), то есть без ограничения."""
|
||||
|
||||
|
||||
class MediaLimitsConfig(BaseModel):
|
||||
"""Рычаги нагрузки медиа для администратора инстанса (не логика состояния
|
||||
конференции — статичные потолки, применяются на клиенте при входе)."""
|
||||
|
||||
publish_quality_cap: PublishQualityCap = "off"
|
||||
stage_max_tiles: StageMaxTiles = 25
|
||||
|
||||
|
||||
class InstanceConfig(BaseModel):
|
||||
"""Эффективная конфигурация инстанса (значения `instance_settings` поверх дефолтов
|
||||
@@ -87,3 +109,9 @@ class InstanceConfig(BaseModel):
|
||||
# адреса) — см. `services/instance_settings.py`, `services/email.py`.
|
||||
contact_email_enabled: bool = False
|
||||
contact_email: str | None = None
|
||||
# Потолок качества публикации + максимум плиток сцены — см.
|
||||
# `services/instance_settings.py`. Отдаётся участнику ДО входа в
|
||||
# LiveKit-комнату (в ответе join, `schemas/conferences.py::JoinOut`), а
|
||||
# не только в админке — настройка должна быть на руках у клиента до
|
||||
# публикации трека.
|
||||
media_limits: MediaLimitsConfig = Field(default_factory=MediaLimitsConfig)
|
||||
|
||||
Reference in New Issue
Block a user