Compare commits
17 Commits
v0.0.23
...
0e029a2bf8
| Author | SHA1 | Date | |
|---|---|---|---|
| 0e029a2bf8 | |||
| f89bf1ad64 | |||
| aee76329c4 | |||
| 10a3f8b3b4 | |||
| 65fbcf952c | |||
| b44652d6a6 | |||
| d11b808e97 | |||
| ed6f9fff44 | |||
| 06455f2401 | |||
| 3847476798 | |||
| a895782250 | |||
| fa8270c156 | |||
| a9e24f6692 | |||
| 8b63c24332 | |||
| cd5399f88a | |||
| 2be799b19d | |||
| 6b9d0b833e |
@@ -122,7 +122,7 @@ SMTP_TIMEOUT_S=30
|
||||
# --- Версия инстанса (релиз v0.0.1) ---
|
||||
# install.sh копирует значение из корневого файла VERSION при каждой
|
||||
# установке/обновлении — руками менять не нужно.
|
||||
VIDCONF_VERSION=0.0.23
|
||||
VIDCONF_VERSION=0.0.29
|
||||
|
||||
# --- Профили compose. Дефолт ниже (`media,monitoring`) — только для ручного
|
||||
# `docker compose up` БЕЗ install.sh: медиа (LiveKit+coturn) + мониторинг,
|
||||
|
||||
171
CHANGELOG.md
171
CHANGELOG.md
@@ -3,6 +3,177 @@
|
||||
Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/),
|
||||
проект придерживается [семантического версионирования](https://semver.org/lang/ru/).
|
||||
|
||||
## [0.0.29] — 2026-08-04
|
||||
|
||||
Кнопка «демонстрация экрана» в мини-окне конференции.
|
||||
|
||||
### Добавлено
|
||||
- В мини-окне (Document PiP) рядом с кнопкой микрофона появилась кнопка
|
||||
демонстрации экрана: начать и остановить показ можно, не разворачивая
|
||||
основное окно. Кнопка и кнопка основного тулбара отражают одно
|
||||
состояние — обе читают его из комнаты, а не из разметки.
|
||||
- Своя демонстрация показывается в мини-окне по обычным правилам сцены:
|
||||
забирает крупную плитку при старте, держится, пока говорят другие, и
|
||||
уступает говорящему либо закреплённому участнику после остановки.
|
||||
|
||||
### Примечания
|
||||
- Кнопка есть только там, где мини-окно — настоящее окно со своей
|
||||
разметкой, то есть в Chrome и Edge. В Safari мини-окно выводится
|
||||
средствами системы (нативный «картинка в картинке»), собственных
|
||||
кнопок в нём быть не может; в Firefox мини-окна нет вовсе. Это
|
||||
ограничение браузеров, а не недоработка.
|
||||
- При выборе «весь экран» мини-окно попадает в собственную
|
||||
демонстрацию — как и у всех остальных участников. Чтобы этого
|
||||
избежать, показывайте конкретное окно, а не экран целиком.
|
||||
|
||||
## [0.0.28] — 2026-08-04
|
||||
|
||||
Очередь поднятых рук видна всем участникам + отключаемый модуль.
|
||||
|
||||
### Добавлено
|
||||
- Очередь поднятых рук больше не спрятана от обычных участников — её
|
||||
видит любой, кто в конференции, не только организатор. Опустить чужую
|
||||
руку по-прежнему может только организатор: сервер это уже проверял
|
||||
(`api/chat.py`, задача B1), правки — только на фронте, кнопка
|
||||
«Опустить» показывается у записи, если это своя рука либо пользователь
|
||||
сам организатор.
|
||||
- «Поднятие руки» (кнопка «Рука» + очередь целиком) — отключаемый модуль
|
||||
в админке (`instance_settings.hand_queue`, дефолт `enabled=true` —
|
||||
поведение существующих инсталляций не меняется). Настройка едет
|
||||
участнику в `JoinOut` (как `chat_enabled`) до входа в комнату.
|
||||
Выключенный модуль гасит кнопки на фронте и отклоняет
|
||||
`raise_hand`/`lower_hand` на сервере кодом `hand_queue_disabled` —
|
||||
вторая линия защиты для клиента со старым `JoinOut` на руках.
|
||||
Переключение применяется со следующего входа в комнату (та же
|
||||
застылость на время жизни соединения, что и у `chat_enabled`).
|
||||
|
||||
## [0.0.27] — 2026-08-04
|
||||
|
||||
Разрыв связи больше не выбрасывает участника из конференции.
|
||||
|
||||
### Исправлено
|
||||
- Телефон с погасшим экраном выпадал из конференции, а при возвращении
|
||||
мог оказаться в лобби вместо комнаты. Причина установлена по логам
|
||||
прода: Chrome срезает ресурсы фоновой вкладке, телефон перестаёт
|
||||
отвечать по ICE, и LiveKit закрывает участника через 5 с после потери
|
||||
соединения (замерено: 37 с после блокировки экрана, 23 с после
|
||||
сворачивания браузера — то есть достаточно просто убрать вкладку в
|
||||
фон, гасить экран не обязательно). Восстановить сессию после этого
|
||||
нельзя — участника на сервере уже нет; нужен полный повторный вход,
|
||||
и `livekit-client` пытается сделать его сам, но его бюджет повторов
|
||||
(10 попыток за ~44 с) в фоновой вкладке успевает сгореть. Тогда
|
||||
приходило событие `Disconnected`, и страница комнаты уводила
|
||||
пользователя в лобби.
|
||||
|
||||
Теперь непреднамеренный разрыв не уводит со страницы: сбрасывается
|
||||
состояние входа, и работает уже имевшийся путь авто-перезахода —
|
||||
резолв конференции, свежий токен, вход заново. Намеренный выход
|
||||
отличается по нажатию кнопки «Выйти», а не по коду причины: причину
|
||||
`CLIENT_INITIATED` присылает и кнопка, и сам `livekit-client`, который
|
||||
при заморозке вкладки (событие `freeze`) вызывает `disconnect()`
|
||||
самостоятельно. Разрывы, после которых возвращаться нельзя (участника
|
||||
выгнал организатор, конференция закрыта, вход той же личностью с
|
||||
другого устройства), уводят в лобби как раньше. От цикла «вошёл —
|
||||
сразу выбросило» защищает лимит в 5 перезаходов подряд; соединение,
|
||||
прожившее дольше 30 с, счётчик обнуляет.
|
||||
|
||||
## [0.0.26] — 2026-08-04
|
||||
|
||||
Мобильная комната: свайп шторки настроек и полноэкранный режим.
|
||||
|
||||
### Исправлено
|
||||
- Шторка «Настройки» на мобильном не закрывалась свайпом вниз почти никогда:
|
||||
обработчики висели только на ручке-волоске (`.room-sheet-handle`,
|
||||
40×4px) — палец в неё практически невозможно попасть, и палец почти
|
||||
всегда приземлялся на панель, где обработчиков не было вовсе. Теперь
|
||||
свайп закрывает шторку при жесте по любому месту панели, но только
|
||||
когда её содержимое проскроллено в самый верх (`scrollTop === 0` на
|
||||
начало жеста) — иначе свайп вниз листает список устройств, как и должен
|
||||
стандартный bottom sheet.
|
||||
|
||||
### Добавлено
|
||||
- Полноэкранный режим комнаты — на мобильном кнопка «Экран» в тулбаре (как
|
||||
на десктопе), при активации топбар и тулбар уходят из потока и лежат
|
||||
оверлеем поверх сцены: показываются по тапу/клику по сцене вне элементов
|
||||
управления и сами прячутся через несколько секунд бездействия. На
|
||||
десктопе — та же логика (топбар/тулбар тоже прячутся в полноэкранном
|
||||
режиме), дополнительный способ вернуть их — навести мышь в нижнюю полосу
|
||||
экрана.
|
||||
|
||||
### Изменено
|
||||
- Кнопка настроек устройств в тулбаре на мобильном подписана «Настройки»
|
||||
вместо «Устройства».
|
||||
- Раскладка кнопок мобильного тулбара, когда они не помещаются в один ряд
|
||||
(7 и больше — с полноэкранным режимом и «Очередью» у организатора это
|
||||
обычный случай), стала равномерной сеткой на 4 колонки (7 → 4+3,
|
||||
8 → 4+4) вместо переноса «как получится» через `flex-wrap`.
|
||||
- `deploy/render-templates.sh` умеет читать значения из файла, заданного
|
||||
переменной `ENV_FILE`, а не только из корневого `.env` (см. коммит
|
||||
`3847476`, вошёл в этот релиз) — для локальных стендов, где корневой
|
||||
`.env` указывает на боевые адреса.
|
||||
|
||||
## [0.0.25] — 2026-08-03
|
||||
|
||||
Два дефекта мини-окна конференции (Document PiP), оба видны только в Chrome.
|
||||
|
||||
### Исправлено
|
||||
- В Chrome пропадал звук других участников после возврата сцены из
|
||||
мини-окна в основное. `RoomAudioRenderer` жил внутри `RoomStage` и
|
||||
рендерился в обеих её ветках, поэтому скрытые `<audio>` с чужими
|
||||
аудиотреками физически переезжали в документ PiP-окна и обратно.
|
||||
После такого переезда Chrome теряет аудиовыход у remote-трека: пакеты
|
||||
продолжают приходить (`packetsReceived` растёт), а
|
||||
`totalSamplesDuration` и `totalAudioEnergy` замирают, и трек молчит
|
||||
даже в свежесозданном `<audio>` со свежим `MediaStream`. Тот же цикл
|
||||
detach/attach в пределах одного документа безвреден — дело именно в
|
||||
переезде между документами. Рендерер вынесен в `RoomPage`: один
|
||||
экземпляр, всегда в основном документе, в PiP-окне аудиоэлементов нет
|
||||
вовсе. В Safari бага не было — там Document PiP не используется
|
||||
(video-фолбэк), сцена из основного окна не уезжает.
|
||||
- В мини-окне не действовало закрепление участника, а демонстрация
|
||||
экрана слетала на говорящего от любой чужой реплики. Мини-плеер
|
||||
намеренно ходил с упрощёнными правилами выбора фокуса (без
|
||||
`holdScreenShare`, без приоритета говорящего с камерой, без
|
||||
антидребезга) и с собственным локальным состоянием закрепления.
|
||||
Теперь `pickStageFocus` получает одинаковые правила в обоих вариантах
|
||||
сцены, а закрепление переезжает между окнами тем же мостиком через
|
||||
`RoomPage`, что и фокус. Сознательно оставлено одно отличие —
|
||||
фолбэк «показать себя» (`localKey`) только у мини-плеера: это защита
|
||||
от дефекта 0.0.11, когда мини-окно открывалось на самом пользователе.
|
||||
- Закрепление сбрасывалось при каждом монтировании сцены: на первом
|
||||
рендере `useTracks` отдаёт пустой набор треков, и правило «закреплённый
|
||||
вышел из комнаты» принимало это за уход участника.
|
||||
|
||||
### Изменено
|
||||
- Кнопка-булавка на плитке подписана «Закрепить» вместо «Закрепить в
|
||||
основном окне» — закрепление больше не ограничено основным окном.
|
||||
|
||||
## [0.0.24] — 2026-08-03
|
||||
|
||||
Три артефакта вёрстки, вылезающие за границы блоков (эмодзи-поповер чата,
|
||||
заголовок брендовой панели, чат в Firefox) + аудит похожих мест.
|
||||
|
||||
### Исправлено
|
||||
- Заголовок «Ваша инфраструктура» на странице входа вылезал за край
|
||||
брендовой панели на широком окне с узкой панелью (`.layout` — flex
|
||||
42/58) — старый фикс уменьшал кегль только по ширине ОКНА (`@media`),
|
||||
а не панели. Кегль `.brand-headline` теперь считается через container
|
||||
query (`container-type: inline-size` + `cqw`) — тот же приём, что у
|
||||
аватара участника в комнате. Тем же механизмом обрезались плашки
|
||||
статистики («AI-саммари») — `.brand-stats` теперь переносит их на
|
||||
мобильном и десктопе одинаково.
|
||||
- Эмодзи-поповер в чате комнаты: последняя (5-я) колонка вылезала за
|
||||
правый край поповера. Причина — гонка CSS-специфичности: правило
|
||||
круглой кнопки «Отправить» (`.chat-input-row button`, 42×42px)
|
||||
продолжало красить размер и кнопкам эмодзи внутри поповера (та же
|
||||
гонка чинилась для цвета в 0.0.19, но не для размера). Добавлены явные
|
||||
`width`/`height: auto` нужной специфичности + `max-width` на попап как
|
||||
общая страховка.
|
||||
- Чат комнаты вылезал за границы панели в Firefox: `.chat-messages`
|
||||
(flex-колонка) без `min-height: 0` не сжималась в Firefox, `textarea`
|
||||
поля ввода без `min-width: 0` упиралась в автоматическую минимальную
|
||||
ширину (Firefox считает её от атрибута `cols`, жёстче Chrome/Safari).
|
||||
|
||||
## [0.0.23] — 2026-08-02
|
||||
|
||||
Документация по сайзингу под медиа-нагрузку + видимость TURN-аллокаций в логах.
|
||||
|
||||
@@ -456,6 +456,7 @@ def _to_settings_out(cfg: InstanceConfig, *, transcription_queue_served: bool) -
|
||||
"""Собрать `SettingsOut` из эффективной конфигурации + доступность уровней AI."""
|
||||
return SettingsOut(
|
||||
chat_enabled=cfg.chat.enabled,
|
||||
hand_queue_enabled=cfg.hand_queue.enabled,
|
||||
transcription_enabled=cfg.transcriber.enabled,
|
||||
ai_level=cfg.ai_level,
|
||||
ai_levels=detect_ai_levels(cfg),
|
||||
|
||||
@@ -71,6 +71,7 @@ async def chat_websocket(
|
||||
except ChatAuthError as exc:
|
||||
await _close_quietly(websocket, exc.close_code)
|
||||
return
|
||||
hand_queue_enabled = await service.hand_queue_enabled()
|
||||
|
||||
pubsub = redis_client.pubsub()
|
||||
channel = chat_channel(conference.id)
|
||||
@@ -94,7 +95,11 @@ async def chat_websocket(
|
||||
|
||||
async with asyncio.TaskGroup() as tg:
|
||||
tg.create_task(_pump_pubsub_to_websocket(websocket, pubsub, channel, seen_ids))
|
||||
tg.create_task(_pump_websocket_to_service(websocket, service, conference, identity))
|
||||
tg.create_task(
|
||||
_pump_websocket_to_service(
|
||||
websocket, service, conference, identity, hand_queue_enabled
|
||||
)
|
||||
)
|
||||
except* WebSocketDisconnect:
|
||||
# Штатное закрытие соединения клиентом — не ошибка.
|
||||
pass
|
||||
@@ -163,9 +168,20 @@ async def _pump_pubsub_to_websocket(
|
||||
|
||||
|
||||
async def _pump_websocket_to_service(
|
||||
websocket: WebSocket, service: ChatService, conference: Conference, identity: ChatIdentity
|
||||
websocket: WebSocket,
|
||||
service: ChatService,
|
||||
conference: Conference,
|
||||
identity: ChatIdentity,
|
||||
hand_queue_enabled: bool,
|
||||
) -> None:
|
||||
"""Читать сообщения клиента (текст чата / поднять-опустить руку), валидировать и обработать."""
|
||||
"""Читать сообщения клиента (текст чата / поднять-опустить руку), валидировать и обработать.
|
||||
|
||||
`hand_queue_enabled` — снятый один раз при подключении тоггл модуля
|
||||
«поднятие руки» (см. `ChatService.hand_queue_enabled`): при `False`
|
||||
`raise_hand`/`lower_hand` отклоняются кодом `hand_queue_disabled` — вторая
|
||||
линия защиты сверх того, что фронт при выключенном модуле вообще не
|
||||
рисует кнопки (см. `RoomToolbar`/`HandQueueMenu`).
|
||||
"""
|
||||
is_organizer = conference.owner_id is not None and conference.owner_id == identity.user_id
|
||||
while True:
|
||||
raw = await websocket.receive_text()
|
||||
@@ -178,11 +194,21 @@ async def _pump_websocket_to_service(
|
||||
if isinstance(envelope, ChatMessageIn):
|
||||
await service.persist_and_publish(conference, identity=identity, text=envelope.text)
|
||||
elif isinstance(envelope, RaiseHandIn):
|
||||
if not hand_queue_enabled:
|
||||
await websocket.send_json(
|
||||
ChatErrorOut(code="hand_queue_disabled").model_dump(mode="json")
|
||||
)
|
||||
continue
|
||||
await hand_queue.raise_hand(
|
||||
conference.id, identity=_identity_key(identity), name=identity.author_name
|
||||
)
|
||||
await hand_queue.publish_snapshot(conference.id)
|
||||
else:
|
||||
if not hand_queue_enabled:
|
||||
await websocket.send_json(
|
||||
ChatErrorOut(code="hand_queue_disabled").model_dump(mode="json")
|
||||
)
|
||||
continue
|
||||
target = envelope.identity or _identity_key(identity)
|
||||
if target != _identity_key(identity) and not is_organizer:
|
||||
await websocket.send_json(
|
||||
|
||||
@@ -33,12 +33,19 @@ class ChatConfig(BaseModel):
|
||||
enabled: bool = True
|
||||
|
||||
|
||||
class HandQueueConfig(BaseModel):
|
||||
"""Конфигурация переключателя модуля «поднятие руки» (кнопка + очередь целиком)."""
|
||||
|
||||
enabled: bool = True
|
||||
|
||||
|
||||
class PluginsConfig(BaseModel):
|
||||
"""Корневая модель конфигурации для `config/plugins.yaml`."""
|
||||
|
||||
transcriber: TranscriberConfig = Field(default_factory=TranscriberConfig)
|
||||
summarizer: SummarizerConfig = Field(default_factory=SummarizerConfig)
|
||||
chat: ChatConfig = Field(default_factory=ChatConfig)
|
||||
hand_queue: HandQueueConfig = Field(default_factory=HandQueueConfig)
|
||||
|
||||
|
||||
def load_plugins_config(path: str | Path) -> PluginsConfig:
|
||||
@@ -92,6 +99,7 @@ class InstanceConfig(BaseModel):
|
||||
transcriber: TranscriberConfig
|
||||
summarizer: SummarizerConfig
|
||||
chat: ChatConfig
|
||||
hand_queue: HandQueueConfig = Field(default_factory=HandQueueConfig)
|
||||
ai_level: AiLevel = "min"
|
||||
summary_recipients: SummaryRecipientsMode = "all"
|
||||
display_timezone: str = "Europe/Moscow"
|
||||
|
||||
@@ -147,6 +147,7 @@ class SettingsOut(BaseModel):
|
||||
"""
|
||||
|
||||
chat_enabled: bool
|
||||
hand_queue_enabled: bool
|
||||
transcription_enabled: bool
|
||||
ai_level: AiLevel
|
||||
ai_levels: list[AiLevelStatus]
|
||||
|
||||
@@ -130,6 +130,9 @@ class JoinOut(BaseModel):
|
||||
# Тоггл инстанса `chat.enabled` на момент входа — клиент решает,
|
||||
# показывать ли UI чата, не дожидаясь ошибки WS-подключения.
|
||||
chat_enabled: bool
|
||||
# Тоггл инстанса `hand_queue.enabled` на момент входа — гасит модуль
|
||||
# «поднятие руки» целиком (кнопка + очередь), см. `HandQueueConfig`.
|
||||
hand_queue_enabled: bool
|
||||
# Рычаги нагрузки медиа (`instance_settings.media_limits`) — отдаются
|
||||
# прямо в join-ответе, а не только в админке: участнику нужно иметь их
|
||||
# на руках ДО публикации своего трека (см. `services/conference_access.py`).
|
||||
|
||||
@@ -148,6 +148,15 @@ class ChatService:
|
||||
raise WrongRoomError
|
||||
return conference
|
||||
|
||||
async def hand_queue_enabled(self) -> bool:
|
||||
"""Тоггл инстанса `hand_queue.enabled` — снимается один раз при подключении WS
|
||||
(см. `api/chat.py::chat_websocket`), а не на каждое сообщение: та же
|
||||
осознанная «застылость» на время жизни соединения, что и у
|
||||
`is_organizer` в `_pump_websocket_to_service` — переключение модуля
|
||||
администратором применяется со следующего подключения."""
|
||||
cfg = await InstanceSettingsService(self._session).get()
|
||||
return cfg.hand_queue.enabled
|
||||
|
||||
async def history(self, conference: Conference) -> list[ChatMessageOut]:
|
||||
"""Последние сообщения открытой сессии конференции (пусто, если сессии ещё нет)."""
|
||||
session_record = await self._sessions.get_open_by_conference(conference.id)
|
||||
|
||||
@@ -53,6 +53,7 @@ def build_join(
|
||||
identity: str,
|
||||
name: str,
|
||||
chat_enabled: bool,
|
||||
hand_queue_enabled: bool,
|
||||
publish_quality_cap: PublishQualityCap,
|
||||
stage_max_tiles: StageMaxTiles,
|
||||
avatar_url: str | None = None,
|
||||
@@ -61,9 +62,10 @@ def build_join(
|
||||
"""Построить ответ join: LiveKit access-токен для входа в комнату конференции.
|
||||
|
||||
Имя LiveKit-комнаты всегда равно `conference.slug` (ADR-001, п.4).
|
||||
`chat_enabled`/`publish_quality_cap`/`stage_max_tiles` — снятые вызывающей
|
||||
стороной значения `instance_settings`: читаются здесь параметрами, а не
|
||||
заново из БД, чтобы не плодить отдельный запрос настроек на каждый join.
|
||||
`chat_enabled`/`hand_queue_enabled`/`publish_quality_cap`/`stage_max_tiles`
|
||||
— снятые вызывающей стороной значения `instance_settings`: читаются здесь
|
||||
параметрами, а не заново из БД, чтобы не плодить отдельный запрос настроек
|
||||
на каждый join.
|
||||
`avatar_url`/`is_organizer`
|
||||
прокидываются в метаданные токена как JSON `{"avatar_url": ..., "is_organizer": true}`
|
||||
— поля добавляются, только если заданы (гость без аватара и не-организатор
|
||||
@@ -91,6 +93,7 @@ def build_join(
|
||||
room_name=conference.slug,
|
||||
conference_id=conference.id,
|
||||
chat_enabled=chat_enabled,
|
||||
hand_queue_enabled=hand_queue_enabled,
|
||||
publish_quality_cap=publish_quality_cap,
|
||||
stage_max_tiles=stage_max_tiles,
|
||||
)
|
||||
|
||||
@@ -155,6 +155,7 @@ class ConferenceService:
|
||||
identity=str(owner_id),
|
||||
name=owner_name,
|
||||
chat_enabled=cfg.chat.enabled,
|
||||
hand_queue_enabled=cfg.hand_queue.enabled,
|
||||
publish_quality_cap=cfg.media_limits.publish_quality_cap,
|
||||
stage_max_tiles=cfg.media_limits.stage_max_tiles,
|
||||
avatar_url=resolve_avatar_url(self._media_root, owner_avatar_path),
|
||||
@@ -251,6 +252,7 @@ class ConferenceService:
|
||||
identity=str(user.id),
|
||||
name=user.name_user,
|
||||
chat_enabled=cfg.chat.enabled,
|
||||
hand_queue_enabled=cfg.hand_queue.enabled,
|
||||
publish_quality_cap=cfg.media_limits.publish_quality_cap,
|
||||
stage_max_tiles=cfg.media_limits.stage_max_tiles,
|
||||
avatar_url=resolve_avatar_url(self._media_root, user.avatar_path),
|
||||
@@ -275,6 +277,7 @@ class ConferenceService:
|
||||
identity=f"guest:{guest.id}",
|
||||
name=data.display_name,
|
||||
chat_enabled=cfg.chat.enabled,
|
||||
hand_queue_enabled=cfg.hand_queue.enabled,
|
||||
publish_quality_cap=cfg.media_limits.publish_quality_cap,
|
||||
stage_max_tiles=cfg.media_limits.stage_max_tiles,
|
||||
)
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
"""Хранилище настроек инстанса (`instance_settings`, key-value JSONB) и их бутстрап.
|
||||
|
||||
Ключи зеркалят секции конфигурации (`transcriber`, `summarizer`, `chat`,
|
||||
`ai_level`, `summary_recipients`, `display_timezone`,
|
||||
`hand_queue`, `ai_level`, `summary_recipients`, `display_timezone`,
|
||||
`registration_team_choice`, `registration_email_domain`, `contact_email`,
|
||||
`media_limits`) —
|
||||
новая настройка не требует миграции, только новая строка. Бутстрап (`ensure_bootstrapped`)
|
||||
@@ -28,6 +28,7 @@ from core.config import Settings
|
||||
from core.plugins.config import (
|
||||
AiLevel,
|
||||
ChatConfig,
|
||||
HandQueueConfig,
|
||||
InstanceConfig,
|
||||
MediaLimitsConfig,
|
||||
PluginsConfig,
|
||||
@@ -45,6 +46,7 @@ from services.ai_tiers import TIERS
|
||||
_KEY_TRANSCRIBER = "transcriber"
|
||||
_KEY_SUMMARIZER = "summarizer"
|
||||
_KEY_CHAT = "chat"
|
||||
_KEY_HAND_QUEUE = "hand_queue"
|
||||
_KEY_AI_LEVEL = "ai_level"
|
||||
_KEY_SUMMARY_RECIPIENTS = "summary_recipients"
|
||||
_KEY_DISPLAY_TIMEZONE = "display_timezone"
|
||||
@@ -100,6 +102,7 @@ class SettingsUpdateIn(BaseModel):
|
||||
"""
|
||||
|
||||
chat_enabled: bool | None = None
|
||||
hand_queue_enabled: bool | None = None
|
||||
transcription_enabled: bool | None = None
|
||||
ai_level: AiLevel | None = None
|
||||
summary_recipients: SummaryRecipientsMode | None = None
|
||||
@@ -154,6 +157,7 @@ def build_bootstrap_defaults(
|
||||
_KEY_TRANSCRIBER: plugins.transcriber.model_dump(mode="json"),
|
||||
_KEY_SUMMARIZER: plugins.summarizer.model_dump(mode="json"),
|
||||
_KEY_CHAT: plugins.chat.model_dump(mode="json"),
|
||||
_KEY_HAND_QUEUE: plugins.hand_queue.model_dump(mode="json"),
|
||||
_KEY_AI_LEVEL: dict(_DEFAULT_AI_LEVEL_VALUE),
|
||||
_KEY_SUMMARY_RECIPIENTS: dict(_DEFAULT_SUMMARY_RECIPIENTS_VALUE),
|
||||
_KEY_DISPLAY_TIMEZONE: dict(_DEFAULT_DISPLAY_TIMEZONE_VALUE),
|
||||
@@ -286,6 +290,10 @@ class InstanceSettingsService:
|
||||
cfg.chat = ChatConfig(enabled=patch.chat_enabled)
|
||||
await self._set(_KEY_CHAT, cfg.chat.model_dump(mode="json"))
|
||||
|
||||
if patch.hand_queue_enabled is not None:
|
||||
cfg.hand_queue = HandQueueConfig(enabled=patch.hand_queue_enabled)
|
||||
await self._set(_KEY_HAND_QUEUE, cfg.hand_queue.model_dump(mode="json"))
|
||||
|
||||
if patch.registration_team_choice is not None:
|
||||
cfg.registration_team_choice = patch.registration_team_choice
|
||||
await self._set(
|
||||
@@ -399,6 +407,7 @@ async def load_effective_config(session: AsyncSession) -> InstanceConfig:
|
||||
transcriber=plugins.transcriber,
|
||||
summarizer=plugins.summarizer,
|
||||
chat=plugins.chat,
|
||||
hand_queue=plugins.hand_queue,
|
||||
)
|
||||
else:
|
||||
cfg = _build_config(rows)
|
||||
@@ -492,6 +501,7 @@ def _build_config(rows: dict[str, Any]) -> InstanceConfig:
|
||||
transcriber=TranscriberConfig.model_validate(rows.get(_KEY_TRANSCRIBER, {})),
|
||||
summarizer=SummarizerConfig.model_validate(rows.get(_KEY_SUMMARIZER, {})),
|
||||
chat=ChatConfig.model_validate(rows.get(_KEY_CHAT, {})),
|
||||
hand_queue=HandQueueConfig.model_validate(rows.get(_KEY_HAND_QUEUE, {})),
|
||||
ai_level=rows.get(_KEY_AI_LEVEL, _DEFAULT_AI_LEVEL_VALUE).get("level", "min"),
|
||||
summary_recipients=rows.get(_KEY_SUMMARY_RECIPIENTS, _DEFAULT_SUMMARY_RECIPIENTS_VALUE).get(
|
||||
"mode", "all"
|
||||
|
||||
@@ -646,12 +646,17 @@ async def test_put_settings_partial_update(
|
||||
|
||||
response = await client.put(
|
||||
"/api/v1/admin/settings",
|
||||
json={"chat_enabled": False, "display_timezone": "Asia/Yekaterinburg"},
|
||||
json={
|
||||
"chat_enabled": False,
|
||||
"hand_queue_enabled": False,
|
||||
"display_timezone": "Asia/Yekaterinburg",
|
||||
},
|
||||
headers=_auth_headers(admin),
|
||||
)
|
||||
assert response.status_code == 200, response.text
|
||||
body = response.json()
|
||||
assert body["chat_enabled"] is False
|
||||
assert body["hand_queue_enabled"] is False
|
||||
assert body["display_timezone"] == "Asia/Yekaterinburg"
|
||||
assert body["ai_level"] == "min"
|
||||
assert body["transcription_queue_served"] is False
|
||||
|
||||
@@ -8,13 +8,15 @@ import uuid
|
||||
from collections.abc import Callable
|
||||
from typing import Any
|
||||
|
||||
import httpx
|
||||
from sqlalchemy.ext.asyncio import AsyncSession
|
||||
|
||||
from core.security import hash_password
|
||||
from core.security import create_access_token, hash_password
|
||||
from models.conference import Conference
|
||||
from models.guest import GuestAccess
|
||||
from models.user import User
|
||||
from services.conference_ids import generate_number, generate_slug
|
||||
from services.instance_settings import InstanceSettingsService, SettingsUpdateIn
|
||||
from services.livekit_tokens import create_room_access_token
|
||||
from tests.conftest import ASGIWebSocketSession
|
||||
|
||||
@@ -270,3 +272,66 @@ async def test_organizer_joining_late_sees_already_raised_hands(
|
||||
initial_queue = await _connect_auth_and_queue(ws_owner, _user_token(conference, owner))
|
||||
|
||||
assert _identities(initial_queue) == [str(alice.id)]
|
||||
|
||||
|
||||
# --- Отключаемый модуль (`instance_settings.hand_queue`) ---------------------
|
||||
|
||||
|
||||
async def test_hand_queue_disabled_rejects_raise_and_lower(
|
||||
db_session: AsyncSession, ws_client: WSFactory
|
||||
) -> None:
|
||||
"""Выключенный модуль — вторая линия защиты сверх фронта: `raise_hand`/
|
||||
`lower_hand` отклоняются кодом `hand_queue_disabled`, очередь не меняется."""
|
||||
conference = await _make_conference(db_session)
|
||||
alice = await _make_user(db_session, name="Alice")
|
||||
await db_session.commit()
|
||||
|
||||
await InstanceSettingsService(db_session).update(SettingsUpdateIn(hand_queue_enabled=False))
|
||||
|
||||
ws = ws_client(_chat_path(conference.id))
|
||||
await _connect_auth_and_queue(ws, _user_token(conference, alice))
|
||||
|
||||
await ws.send_json({"type": "raise_hand"})
|
||||
error = await ws.receive_json()
|
||||
assert error == {"type": "error", "code": "hand_queue_disabled"}
|
||||
|
||||
await ws.send_json({"type": "lower_hand"})
|
||||
error = await ws.receive_json()
|
||||
assert error == {"type": "error", "code": "hand_queue_disabled"}
|
||||
|
||||
|
||||
async def test_join_out_reflects_hand_queue_enabled_toggle(
|
||||
client: httpx.AsyncClient, db_session: AsyncSession
|
||||
) -> None:
|
||||
user = await _make_user(db_session, name="Toggle Tester")
|
||||
await db_session.commit()
|
||||
headers = {"Authorization": f"Bearer {create_access_token(user.id, user.role)}"}
|
||||
|
||||
response = await client.post(
|
||||
"/api/v1/conferences", json={"title": "Standup"}, headers=headers
|
||||
)
|
||||
assert response.status_code == 201, response.text
|
||||
assert response.json()["join"]["hand_queue_enabled"] is True
|
||||
|
||||
await InstanceSettingsService(db_session).update(SettingsUpdateIn(hand_queue_enabled=False))
|
||||
|
||||
response = await client.post(
|
||||
"/api/v1/conferences", json={"title": "Standup 2"}, headers=headers
|
||||
)
|
||||
assert response.status_code == 201, response.text
|
||||
assert response.json()["join"]["hand_queue_enabled"] is False
|
||||
|
||||
|
||||
async def test_guest_join_out_reflects_hand_queue_enabled(
|
||||
client: httpx.AsyncClient, db_session: AsyncSession
|
||||
) -> None:
|
||||
conference = await _make_conference(db_session)
|
||||
await db_session.commit()
|
||||
|
||||
await InstanceSettingsService(db_session).update(SettingsUpdateIn(hand_queue_enabled=False))
|
||||
|
||||
response = await client.post(
|
||||
f"/api/v1/conferences/{conference.id}/guest-join", json={"display_name": "Dave"}
|
||||
)
|
||||
assert response.status_code == 200, response.text
|
||||
assert response.json()["hand_queue_enabled"] is False
|
||||
|
||||
@@ -65,6 +65,7 @@ _MANAGED_KEYS = (
|
||||
"transcriber",
|
||||
"summarizer",
|
||||
"chat",
|
||||
"hand_queue",
|
||||
"ai_level",
|
||||
"summary_recipients",
|
||||
"display_timezone",
|
||||
@@ -121,6 +122,7 @@ async def test_ensure_bootstrapped_imports_yaml_defaults(
|
||||
"transcriber",
|
||||
"summarizer",
|
||||
"chat",
|
||||
"hand_queue",
|
||||
"ai_level",
|
||||
"summary_recipients",
|
||||
"display_timezone",
|
||||
@@ -132,6 +134,9 @@ async def test_ensure_bootstrapped_imports_yaml_defaults(
|
||||
cfg = await service.get()
|
||||
assert cfg.transcriber.provider == "faster_whisper_cpu"
|
||||
assert cfg.ai_level == "min"
|
||||
# Дефолт обязан сохранять поведение существующих инсталляций — модуль
|
||||
# «поднятие руки» был доступен всегда, тоггл включён по умолчанию.
|
||||
assert cfg.hand_queue.enabled is True
|
||||
assert cfg.summary_recipients == "all"
|
||||
assert cfg.display_timezone == "Europe/Moscow"
|
||||
assert cfg.registration_team_choice is False
|
||||
@@ -162,6 +167,22 @@ async def test_ensure_bootstrapped_is_idempotent_and_keeps_admin_edits(
|
||||
assert cfg.display_timezone == "Asia/Yekaterinburg"
|
||||
|
||||
|
||||
async def test_update_hand_queue_enabled(
|
||||
db_session: AsyncSession, clean_instance_settings: None
|
||||
) -> None:
|
||||
service = InstanceSettingsService(db_session)
|
||||
await service.ensure_bootstrapped(PLUGINS_YAML)
|
||||
|
||||
cfg = await service.update(SettingsUpdateIn(hand_queue_enabled=False))
|
||||
assert cfg.hand_queue.enabled is False
|
||||
|
||||
cfg = await service.get()
|
||||
assert cfg.hand_queue.enabled is False
|
||||
|
||||
cfg = await service.update(SettingsUpdateIn(hand_queue_enabled=True))
|
||||
assert cfg.hand_queue.enabled is True
|
||||
|
||||
|
||||
@pytest.mark.parametrize(
|
||||
("preset", "chat_enabled", "ai_enabled", "ai_level"),
|
||||
[
|
||||
|
||||
@@ -33,3 +33,6 @@ summarizer:
|
||||
|
||||
chat:
|
||||
enabled: true
|
||||
|
||||
hand_queue:
|
||||
enabled: true
|
||||
|
||||
@@ -89,7 +89,7 @@ services:
|
||||
MEDIA_ROOT: ${MEDIA_ROOT:-/app/media}
|
||||
# Версия инстанса (релиз v0.0.1) — install.sh копирует значение
|
||||
# из файла VERSION (корень репозитория) в .env; отдаётся в GET /api/health.
|
||||
VIDCONF_VERSION: ${VIDCONF_VERSION:-0.0.23}
|
||||
VIDCONF_VERSION: ${VIDCONF_VERSION:-0.0.29}
|
||||
# Число процессов uvicorn (см. backend/Dockerfile). Дефолт 2 рассчитан
|
||||
# на 4-ядерный сервер, где ядра делятся с LiveKit. Поднимая значение,
|
||||
# проверьте бюджет соединений с БД: каждый воркер держит свой пул
|
||||
|
||||
@@ -9,16 +9,32 @@
|
||||
# запускайте ПЕРЕД `docker compose up` (и после каждого изменения .env,
|
||||
# влияющего на эти конфиги) — из корня репозитория:
|
||||
# ./deploy/render-templates.sh
|
||||
#
|
||||
# Источник значений можно подменить переменной ENV_FILE:
|
||||
# ENV_FILE=.env.local ./deploy/render-templates.sh
|
||||
# Это нужно для локальных стендов: корневой `.env` рабочего чекаута обычно
|
||||
# держит боевые значения (LIVEKIT_NODE_IP/TURN_EXTERNAL_IP смотрят на прод), и
|
||||
# рендерить конфиги из него для локального запуска нельзя. Без этой переменной
|
||||
# путь был жёстко зашит, и локальные сессии повторяли логику скрипта вручную
|
||||
# через envsubst — расхождение с реальным рендером ждало своего часа.
|
||||
# По умолчанию — как раньше, `<корень репозитория>/.env`, поэтому install.sh
|
||||
# и сервер ничего не замечают (свою переменную ENV_FILE install.sh не
|
||||
# экспортирует, так что она сюда не протекает).
|
||||
set -euo pipefail
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||
ENV_FILE="$SCRIPT_DIR/../.env"
|
||||
# Относительный путь разрешаем от текущей директории вызова (`ENV_FILE=.env.local`
|
||||
# из корня репозитория), абсолютный — как есть.
|
||||
ENV_FILE="${ENV_FILE:-$SCRIPT_DIR/../.env}"
|
||||
|
||||
if [ ! -f "$ENV_FILE" ]; then
|
||||
echo "render-templates.sh: не найден $ENV_FILE — сначала запустите ./install.sh или скопируйте .env.example в .env" >&2
|
||||
echo "render-templates.sh: другой файл значений можно задать так: ENV_FILE=.env.local $0" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
echo "[render] источник значений: $ENV_FILE"
|
||||
|
||||
# Читаем только нужные ключи через grep/cut (НЕ `source .env`) — .env содержит
|
||||
# значения вроде `SMTP_FROM=VidConf <no-reply@vidconf.example>`, где `<` —
|
||||
# валидный литерал для docker-compose/pydantic, но невалидный bash-синтаксис
|
||||
|
||||
@@ -191,6 +191,14 @@ chmod 600 .env # секреты внутри — только root может
|
||||
собирает образы, поднимает `postgres`/`redis`, применяет миграции Alembic +
|
||||
seed, поднимает остальной стек (`up -d --wait`).
|
||||
|
||||
По умолчанию `render-templates.sh` читает корневой `.env`. Другой файл
|
||||
значений задаётся переменной окружения — это нужно, когда рядом с рабочим
|
||||
`.env` (боевые адреса) поднимается локальный стенд:
|
||||
|
||||
```bash
|
||||
ENV_FILE=.env.local ./deploy/render-templates.sh
|
||||
```
|
||||
|
||||
**Не запускайте `docker compose` вручную без `--env-file .env`** — без него
|
||||
compose не подхватывает корневой `.env` (файл на уровень выше
|
||||
`deploy/docker-compose.yml`) и подставляет небезопасные дефолты из самого
|
||||
|
||||
@@ -19,6 +19,8 @@ export interface AiLevelStatus {
|
||||
/** Эффективные настройки инстанса. */
|
||||
export interface SettingsOut {
|
||||
chat_enabled: boolean
|
||||
/** Включён ли модуль «поднятие руки» — кнопка «Рука» и очередь целиком. */
|
||||
hand_queue_enabled: boolean
|
||||
/** Единый переключатель модуля AI (транскрибация + суммаризация). */
|
||||
transcription_enabled: boolean
|
||||
/** Есть ли хотя бы один Celery-воркер, обслуживающий очередь транскрибации. */
|
||||
@@ -48,6 +50,7 @@ export interface SettingsOut {
|
||||
/** Тело частичного обновления настроек инстанса — все поля опциональны. */
|
||||
export interface SettingsUpdateIn {
|
||||
chat_enabled?: boolean
|
||||
hand_queue_enabled?: boolean
|
||||
transcription_enabled?: boolean
|
||||
/** Недоступный уровень (см. `ai_levels`) — backend отвечает 400. */
|
||||
ai_level?: AiLevel
|
||||
|
||||
@@ -61,6 +61,8 @@ export interface ConferenceJoinData {
|
||||
conference_id: string
|
||||
/** Включён ли чат для этой конференции — при `false` панель/кнопка чата не рендерятся. */
|
||||
chat_enabled: boolean
|
||||
/** Включён ли модуль «поднятие руки» — при `false` кнопка «Рука» и очередь не рендерятся. */
|
||||
hand_queue_enabled: boolean
|
||||
/** Потолок качества публикации видео на момент входа — см. `PublishQualityCap`. */
|
||||
publish_quality_cap: PublishQualityCap
|
||||
/** Максимум одновременно видимых плиток сцены (`StageGrid`) на момент входа. */
|
||||
|
||||
@@ -68,6 +68,7 @@ function AdminSettingsForm({ data }: { data: SettingsOut }) {
|
||||
const { user } = useAuth()
|
||||
|
||||
const [chatEnabled, setChatEnabled] = useState(data.chat_enabled)
|
||||
const [handQueueEnabled, setHandQueueEnabled] = useState(data.hand_queue_enabled)
|
||||
const [aiEnabled, setAiEnabled] = useState(data.transcription_enabled)
|
||||
const [aiLevel, setAiLevel] = useState<AiLevel>(data.ai_level)
|
||||
const [recipients, setRecipients] = useState<SummaryRecipientsMode>(data.summary_recipients)
|
||||
@@ -132,6 +133,7 @@ function AdminSettingsForm({ data }: { data: SettingsOut }) {
|
||||
// валился бы в 400, блокируя правку вообще любой другой настройки.
|
||||
const payload: SettingsUpdateIn = {}
|
||||
if (chatEnabled !== data.chat_enabled) payload.chat_enabled = chatEnabled
|
||||
if (handQueueEnabled !== data.hand_queue_enabled) payload.hand_queue_enabled = handQueueEnabled
|
||||
if (aiEnabled !== data.transcription_enabled) payload.transcription_enabled = aiEnabled
|
||||
if (aiLevel !== data.ai_level) payload.ai_level = aiLevel
|
||||
if (recipients !== data.summary_recipients) payload.summary_recipients = recipients
|
||||
@@ -175,6 +177,21 @@ function AdminSettingsForm({ data }: { data: SettingsOut }) {
|
||||
</label>
|
||||
</div>
|
||||
|
||||
<div className="toggle-row">
|
||||
<div className="toggle-copy">
|
||||
<strong>Поднятие руки</strong>
|
||||
<span>Кнопка «Рука» и очередь поднятых рук в комнате — целиком</span>
|
||||
</div>
|
||||
<label className="switch">
|
||||
<input
|
||||
type="checkbox"
|
||||
checked={handQueueEnabled}
|
||||
onChange={(e) => setHandQueueEnabled(e.target.checked)}
|
||||
/>
|
||||
<span className="slider" />
|
||||
</label>
|
||||
</div>
|
||||
|
||||
<div className="toggle-row">
|
||||
<div className="toggle-copy">
|
||||
<strong>Транскрибация и суммаризация (AI)</strong>
|
||||
|
||||
@@ -11,7 +11,7 @@ interface DeviceSettingsDialogProps extends StageViewProps {
|
||||
onClose: () => void
|
||||
}
|
||||
|
||||
/** Свайп ручки шторки вниз дальше этого порога (px) закрывает панель, меньше — она возвращается на место. */
|
||||
/** Свайп панели вниз дальше этого порога (px) закрывает шторку, меньше — она возвращается на место. */
|
||||
const SHEET_DISMISS_THRESHOLD_PX = 80
|
||||
|
||||
/** Человекочитаемая подпись пункта списка устройств — `label` пуст, пока нет разрешения на медиа. */
|
||||
@@ -30,7 +30,13 @@ function deviceLabel(device: MediaDeviceInfo, index: number, fallback: string):
|
||||
* `deviceId` при следующем подключении.
|
||||
*
|
||||
* На мобильной ширине (`useIsCompactViewport`) рендерится шторкой снизу вместо
|
||||
* модалки — по клику вне, Escape (`useModalDismiss`) и свайпу вниз за ручку.
|
||||
* модалки — по клику вне, Escape (`useModalDismiss`) и свайпу вниз по ЛЮБОМУ
|
||||
* месту панели (не только за ручку-волосок `.room-sheet-handle` — та её не
|
||||
* пережила бы: 40×4px, попасть пальцем почти нереально). Свайп срабатывает,
|
||||
* только если содержимое панели проскроллено в самый верх (`scrollTop === 0`
|
||||
* на touchstart, см. `dragEligibleRef`) — иначе палец должен листать список
|
||||
* устройств, а не закрывать окно; решение фиксируется на весь жест, а не
|
||||
* пересчитывается на каждый touchmove, как в любом стандартном bottom sheet.
|
||||
* Десктоп не меняется.
|
||||
*
|
||||
* Там же, и только там, первой секцией идёт «Вид» (режим показа участников и
|
||||
@@ -61,6 +67,12 @@ export function DeviceSettingsDialog({
|
||||
useModalDismiss(onClose)
|
||||
|
||||
const dragStartYRef = useRef<number | null>(null)
|
||||
// Жест начат, когда контент панели был проскроллен в самый верх — свайп по
|
||||
// панели, у которой ещё есть что скроллить, должен листать содержимое, а не
|
||||
// закрывать шторку. Решается ОДИН раз в touchstart и держится весь жест
|
||||
// (даже если внутри него направление сменится) — так же, как в любом
|
||||
// стандартном bottom sheet.
|
||||
const dragEligibleRef = useRef(false)
|
||||
const [dragOffset, setDragOffset] = useState(0)
|
||||
const [isDragging, setIsDragging] = useState(false)
|
||||
|
||||
@@ -92,18 +104,21 @@ export function DeviceSettingsDialog({
|
||||
}
|
||||
}
|
||||
|
||||
function handleHandleTouchStart(e: React.TouchEvent<HTMLDivElement>) {
|
||||
function handlePanelTouchStart(e: React.TouchEvent<HTMLDivElement>) {
|
||||
dragEligibleRef.current = e.currentTarget.scrollTop === 0
|
||||
if (!dragEligibleRef.current) return
|
||||
dragStartYRef.current = e.touches[0].clientY
|
||||
setIsDragging(true)
|
||||
}
|
||||
|
||||
function handleHandleTouchMove(e: React.TouchEvent<HTMLDivElement>) {
|
||||
if (dragStartYRef.current === null) return
|
||||
function handlePanelTouchMove(e: React.TouchEvent<HTMLDivElement>) {
|
||||
if (!dragEligibleRef.current || dragStartYRef.current === null) return
|
||||
const delta = e.touches[0].clientY - dragStartYRef.current
|
||||
if (delta > 0) setDragOffset(delta)
|
||||
}
|
||||
|
||||
function handleHandleTouchEnd() {
|
||||
function handlePanelTouchEnd() {
|
||||
if (!dragEligibleRef.current) return
|
||||
if (dragOffset > SHEET_DISMISS_THRESHOLD_PX) {
|
||||
onClose()
|
||||
return
|
||||
@@ -124,20 +139,16 @@ export function DeviceSettingsDialog({
|
||||
<div
|
||||
className={isCompact ? 'room-sheet-panel' : 'room-modal-panel'}
|
||||
onClick={(e) => e.stopPropagation()}
|
||||
onTouchStart={isCompact ? handlePanelTouchStart : undefined}
|
||||
onTouchMove={isCompact ? handlePanelTouchMove : undefined}
|
||||
onTouchEnd={isCompact ? handlePanelTouchEnd : undefined}
|
||||
style={
|
||||
isCompact && dragOffset
|
||||
? { transform: `translateY(${dragOffset}px)`, transition: isDragging ? 'none' : undefined }
|
||||
: undefined
|
||||
}
|
||||
>
|
||||
{isCompact && (
|
||||
<div
|
||||
className="room-sheet-handle"
|
||||
onTouchStart={handleHandleTouchStart}
|
||||
onTouchMove={handleHandleTouchMove}
|
||||
onTouchEnd={handleHandleTouchEnd}
|
||||
/>
|
||||
)}
|
||||
{isCompact && <div className="room-sheet-handle" />}
|
||||
|
||||
<div className="room-modal-head">
|
||||
<h2 id="device-settings-title">{isCompact ? 'Настройки' : 'Настройки устройств'}</h2>
|
||||
|
||||
@@ -1,5 +1,6 @@
|
||||
import { useEffect, useRef, useState } from 'react'
|
||||
import { Hand, ListOrdered } from 'lucide-react'
|
||||
import { useLocalParticipant } from '@livekit/components-react'
|
||||
import { useIsOrganizer } from '@/hooks/useIsOrganizer'
|
||||
import type { HandQueueEntry } from '@/hooks/useChat'
|
||||
|
||||
@@ -9,8 +10,15 @@ interface HandQueueMenuProps {
|
||||
}
|
||||
|
||||
/**
|
||||
* Кнопка «Очередь» в тулбаре с поповером над ней — видна только организатору
|
||||
* (задача B1). Тот же самодостаточный паттерн, что и `StageViewMenu` («Вид»):
|
||||
* Кнопка «Очередь» в тулбаре с поповером над ней — видна ВСЕМ участникам
|
||||
* (сессия «28-hand-queue-for-all»: раньше очередь видел только организатор).
|
||||
* Опустить чужую запись может по-прежнему только организатор — обычный
|
||||
* участник видит кнопку «Опустить» только напротив СВОЕЙ записи (или не
|
||||
* видит её вовсе, если сам руку не поднимал): сервер (`api/chat.py`) всё
|
||||
* равно отклонит попытку опустить чужую руку кодом `forbidden`, но мёртвая
|
||||
* кнопка, которая молча не работает, хуже отсутствующей.
|
||||
*
|
||||
* Тот же самодостаточный паттерн, что и `StageViewMenu` («Вид»):
|
||||
* собственное состояние открытия, закрытие по клику вне/Escape, поповер
|
||||
* `.tb-menu` над кнопкой — а не боковая панель на весь экран (как чат):
|
||||
* очередь рук — короткий список, а не история переписки, разворачивать её
|
||||
@@ -19,11 +27,12 @@ interface HandQueueMenuProps {
|
||||
* Размер поповера подстраивается под число записей — `.hand-queue-list`
|
||||
* растёт вместе со списком и не даёт пустого места при 1–2 поднятых руках,
|
||||
* но не бесконечно: после ~10 строк список упирается в `max-height` и дальше
|
||||
* скроллится (см. room.css) — иначе организатор на энергичной встрече
|
||||
* получил бы поповер выше экрана.
|
||||
* скроллится (см. room.css) — иначе участник на энергичной встрече получил
|
||||
* бы поповер выше экрана.
|
||||
*/
|
||||
export function HandQueueMenu({ queue, onLower }: HandQueueMenuProps) {
|
||||
const isOrganizer = useIsOrganizer()
|
||||
const { localParticipant } = useLocalParticipant()
|
||||
const [open, setOpen] = useState(false)
|
||||
const wrapRef = useRef<HTMLDivElement>(null)
|
||||
|
||||
@@ -47,8 +56,6 @@ export function HandQueueMenu({ queue, onLower }: HandQueueMenuProps) {
|
||||
}
|
||||
}, [open])
|
||||
|
||||
if (!isOrganizer) return null
|
||||
|
||||
return (
|
||||
<div className="tb-menu-wrap" ref={wrapRef}>
|
||||
<button
|
||||
@@ -74,22 +81,28 @@ export function HandQueueMenu({ queue, onLower }: HandQueueMenuProps) {
|
||||
<p className="chat-empty">Пока никто не поднял руку</p>
|
||||
) : (
|
||||
<ol className="hand-queue-list">
|
||||
{queue.map((entry, index) => (
|
||||
<li className="hand-queue-item" key={entry.identity}>
|
||||
<span className="hand-queue-position">{index + 1}</span>
|
||||
<span className="hand-queue-name">
|
||||
<Hand className="lucide" aria-hidden="true" />
|
||||
{entry.name}
|
||||
</span>
|
||||
<button
|
||||
type="button"
|
||||
className="hand-queue-lower"
|
||||
onClick={() => onLower(entry.identity)}
|
||||
>
|
||||
Опустить
|
||||
</button>
|
||||
</li>
|
||||
))}
|
||||
{queue.map((entry, index) => {
|
||||
const isOwn = entry.identity === localParticipant.identity
|
||||
const canLower = isOrganizer || isOwn
|
||||
return (
|
||||
<li className="hand-queue-item" key={entry.identity}>
|
||||
<span className="hand-queue-position">{index + 1}</span>
|
||||
<span className="hand-queue-name">
|
||||
<Hand className="lucide" aria-hidden="true" />
|
||||
{entry.name}
|
||||
</span>
|
||||
{canLower && (
|
||||
<button
|
||||
type="button"
|
||||
className="hand-queue-lower"
|
||||
onClick={() => onLower(entry.identity)}
|
||||
>
|
||||
Опустить
|
||||
</button>
|
||||
)}
|
||||
</li>
|
||||
)
|
||||
})}
|
||||
</ol>
|
||||
)}
|
||||
</div>
|
||||
|
||||
@@ -126,8 +126,10 @@ function TileBody({
|
||||
const showSharingChip = Boolean(
|
||||
onStopSharing && trackReference.source === Track.Source.ScreenShare && trackReference.participant.isLocal,
|
||||
)
|
||||
// Кнопка закрепления — только там, где сцена умеет закрепление (основное
|
||||
// окно передаёт `onTogglePin`; в мини-плеере плитка одна, закреплять нечего).
|
||||
// Кнопка закрепления — только там, где сцена её даёт (основное окно передаёт
|
||||
// `onTogglePin`; в мини-плеере своего тулбара нет и плитка одна, поэтому
|
||||
// булавки там нет — само закрепление, сделанное в основном окне, с 0.0.25
|
||||
// действует и в мини-плеере, см. `initialPinnedKey` в `RoomStage`).
|
||||
// Ключ плитки берём из её собственного трека: в карусели/гриде плитки
|
||||
// рендерятся шаблоном без пропсов, снаружи «какая это плитка» не передать.
|
||||
const tileKey = stageTrackKey(trackReference)
|
||||
@@ -200,10 +202,8 @@ function TileBody({
|
||||
type="button"
|
||||
className={`room-pin-toggle${isPinned ? ' is-pinned' : ''}`}
|
||||
aria-pressed={isPinned}
|
||||
title={isPinned ? 'Открепить' : 'Закрепить в основном окне'}
|
||||
aria-label={
|
||||
isPinned ? `Открепить: ${displayName}` : `Закрепить в основном окне: ${displayName}`
|
||||
}
|
||||
title={isPinned ? 'Открепить' : 'Закрепить'}
|
||||
aria-label={isPinned ? `Открепить: ${displayName}` : `Закрепить: ${displayName}`}
|
||||
onClick={(e) => {
|
||||
// Иначе клик долетит до самой плитки (`onParticipantClick`
|
||||
// у `ParticipantTile`) — булавка не должна означать «клик по плитке».
|
||||
|
||||
@@ -1,10 +1,9 @@
|
||||
import { useEffect, useState, type ReactNode } from 'react'
|
||||
import { EyeOff, Mic, MicOff, Users } from 'lucide-react'
|
||||
import { EyeOff, Mic, MicOff, ScreenShare, ScreenShareOff, Users } from 'lucide-react'
|
||||
import { Track, type Participant } from 'livekit-client'
|
||||
import {
|
||||
CarouselLayout,
|
||||
FocusLayoutContainer,
|
||||
RoomAudioRenderer,
|
||||
isTrackReference,
|
||||
useRoomContext,
|
||||
useSpeakingParticipants,
|
||||
@@ -14,8 +13,10 @@ import {
|
||||
} from '@livekit/components-react'
|
||||
import { RoomParticipantTile } from '@/components/room/RoomParticipantTile'
|
||||
import { StageGrid } from '@/components/room/StageGrid'
|
||||
import { useToast } from '@/components/ui/ToastProvider'
|
||||
import { useIsCompactViewport } from '@/hooks/useIsCompactViewport'
|
||||
import { pickStageFocus, stageTrackKey } from '@/components/room/stageFocus'
|
||||
import { SCREEN_SHARE_CAPTURE_OPTIONS } from '@/lib/screenShareOptions'
|
||||
import type { StageLayoutMode } from '@/lib/stageLayoutMode'
|
||||
|
||||
/**
|
||||
@@ -44,9 +45,11 @@ const STAGE_TRACK_SOURCES = [
|
||||
]
|
||||
|
||||
/**
|
||||
* Удержание фокуса основного окна при смене говорящего, мс.
|
||||
* Удержание фокуса при смене говорящего, мс. Действует в ОБОИХ вариантах
|
||||
* сцены — и в основном окне, и в мини-плеере (до 0.0.25 в PiP удержания не
|
||||
* было вовсе, фокус там переключался мгновенно).
|
||||
*
|
||||
* Основное окно следует за спикером (`followSpeaker`, задача 3.2), и без
|
||||
* Сцена следует за спикером (`followSpeaker`, задача 3.2), и без
|
||||
* удержания короткие реплики («ага», «угу») уводили бы большую плитку на
|
||||
* секунду и возвращали обратно. Источник говорящих (`useSpeakingParticipants`
|
||||
* поверх `RoomEvent.ActiveSpeakersChanged`) сам по себе не дребезжит, но
|
||||
@@ -59,6 +62,10 @@ const STAGE_TRACK_SOURCES = [
|
||||
* фокус с задержкой, которая на глаз читается как плавность, а не как тормоз.
|
||||
* Меньше (~0.6 с) — короткие «ага» всё ещё пролезают, больше (~2 с) — заметно
|
||||
* запаздывает переход на нового докладчика.
|
||||
*
|
||||
* В мини-плеере удержание тем более уместно: там плитка ОДНА, и мгновенное
|
||||
* переключение читается не как «камера следует за разговором», а как мигание
|
||||
* всего окна целиком.
|
||||
*/
|
||||
const SPEAKER_HOLD_MS = 1200
|
||||
|
||||
@@ -69,8 +76,9 @@ const SPEAKER_HOLD_MS = 1200
|
||||
* применять уже нечего (cleanup эффекта гасит таймер, а новое значение
|
||||
* сравнивается по ссылке с текущим).
|
||||
*
|
||||
* `holdMs <= 0` — удержания нет, значение отдаётся как есть (режим PiP: там
|
||||
* фокус обязан следовать за говорящим мгновенно, поведение не менялось).
|
||||
* `holdMs <= 0` — удержания нет, значение отдаётся как есть. Сейчас этим
|
||||
* режимом никто не пользуется (обе сцены удерживают состав), но параметр
|
||||
* оставлен: он и делает функцию пригодной для повторного использования.
|
||||
*/
|
||||
function useSteadySpeakers(speakers: Participant[], holdMs: number): Participant[] {
|
||||
const [steady, setSteady] = useState(speakers)
|
||||
@@ -109,7 +117,7 @@ function PipMicToggle() {
|
||||
<button
|
||||
type="button"
|
||||
{...mic.buttonProps}
|
||||
className={`room-pip-mic-toggle${mic.enabled ? '' : ' is-off'}`}
|
||||
className={`room-pip-btn room-pip-mic-toggle${mic.enabled ? '' : ' is-off'}`}
|
||||
aria-label={mic.enabled ? 'Выключить микрофон' : 'Включить микрофон'}
|
||||
>
|
||||
{mic.enabled ? <Mic className="lucide" aria-hidden="true" /> : <MicOff className="lucide" aria-hidden="true" />}
|
||||
@@ -117,6 +125,59 @@ function PipMicToggle() {
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* Кнопка демонстрации экрана в мини-плеере — сестра `PipMicToggle` (0.0.29).
|
||||
* Тот же `useTrackToggle` и те же `SCREEN_SHARE_CAPTURE_OPTIONS`, что у кнопки
|
||||
* основного тулбара (`RoomToolbar`), поэтому обе кнопки — два вида одного
|
||||
* состояния: включённая из мини-окна демонстрация показывает основную кнопку
|
||||
* активной и наоборот, рассинхрону взяться неоткуда (состояние читается из
|
||||
* `RoomContext`, а не из DOM).
|
||||
*
|
||||
* 🔬 ПОЧЕМУ ЭТО ВООБЩЕ РАБОТАЕТ ИЗ ДРУГОГО ОКНА. `getDisplayMedia()` требует
|
||||
* транзиентной активации пользователя, а клик здесь происходит в PiP-окне,
|
||||
* тогда как сам код (React-дерево целиком остаётся в основном документе,
|
||||
* порталом уезжает только DOM) вызывает `navigator` ОСНОВНОГО окна. Замерено
|
||||
* в Chrome 150 отдельной пробой: после клика в Document PiP
|
||||
* `navigator.userActivation.isActive === true` в ОБОИХ окнах — активация
|
||||
* доезжает до опенера, вызов проходит, системный пикер выбора экрана
|
||||
* открывается отдельным окном поверх остальных (а не прячется за заглушкой
|
||||
* «Конференция открыта в отдельном мини-окне» в основном окне). Проверять это
|
||||
* пришлось живьём: спецификация такого поведения не обещает, и на других
|
||||
* движках оно может отличаться — но Document PiP есть только в Chrome/Edge,
|
||||
* так что других движков здесь и не бывает (в Safari мини-окно — нативный
|
||||
* video-PiP без собственного DOM, кнопке там просто негде жить, в Firefox
|
||||
* мини-окна нет вовсе).
|
||||
*
|
||||
* Ошибку показываем тостом основного окна: пользователь его сейчас не видит
|
||||
* (там заглушка), но увидит, как только вернётся, — а единственный частый
|
||||
* «сбой», отмена пикера, и так молча игнорируется, как в основном тулбаре.
|
||||
*/
|
||||
function PipScreenShareToggle() {
|
||||
const toast = useToast()
|
||||
const screenShare = useTrackToggle({
|
||||
source: Track.Source.ScreenShare,
|
||||
captureOptions: SCREEN_SHARE_CAPTURE_OPTIONS,
|
||||
onDeviceError: (error) => {
|
||||
if (error.name === 'NotAllowedError') return
|
||||
toast.show('Не удалось начать демонстрацию экрана', 'error')
|
||||
},
|
||||
})
|
||||
return (
|
||||
<button
|
||||
type="button"
|
||||
{...screenShare.buttonProps}
|
||||
className={`room-pip-btn room-pip-share-toggle${screenShare.enabled ? ' is-on' : ''}`}
|
||||
aria-label={screenShare.enabled ? 'Остановить демонстрацию экрана' : 'Демонстрация экрана'}
|
||||
>
|
||||
{screenShare.enabled ? (
|
||||
<ScreenShareOff className="lucide" aria-hidden="true" />
|
||||
) : (
|
||||
<ScreenShare className="lucide" aria-hidden="true" />
|
||||
)}
|
||||
</button>
|
||||
)
|
||||
}
|
||||
|
||||
/**
|
||||
* Основная сцена конференции: превью остальных участников + крупная плитка
|
||||
* активного спикера (FocusLayoutContainer + CarouselLayout при нескольких
|
||||
@@ -148,9 +209,9 @@ function PipMicToggle() {
|
||||
* `tiles` скрывать нечего (карусели нет), переключатель там заблокирован —
|
||||
* см. `StageViewOptions`.
|
||||
*
|
||||
* ФОКУС ПЕРЕЖИВАЕТ ПЕРЕЕЗД В МИНИ-ПЛЕЕР. Сцена в мини-плеере — ОТДЕЛЬНЫЙ
|
||||
* экземпляр этого компонента (портал в PiP-окно), и своё состояние фокуса он
|
||||
* начинал с нуля: демонстрации нет, никто прямо сейчас не говорит — и
|
||||
* ФОКУС И ЗАКРЕПЛЕНИЕ ПЕРЕЖИВАЮТ ПЕРЕЕЗД В МИНИ-ПЛЕЕР. Сцена в мини-плеере —
|
||||
* ОТДЕЛЬНЫЙ экземпляр этого компонента (портал в PiP-окно), и своё состояние
|
||||
* фокуса он начинал с нуля: демонстрации нет, никто прямо сейчас не говорит — и
|
||||
* `pickStageFocus` доходил до последнего фолбэка `localKey`, то есть мини-окно
|
||||
* открывалось на самом пользователе вместо того, что он видел крупно. В Safari
|
||||
* бага не было видно: там Document PiP не используется, а video-фолбэк
|
||||
@@ -159,6 +220,13 @@ function PipMicToggle() {
|
||||
* `RoomPage` → `initialFocusKey` следующего экземпляра. Работает в обе стороны
|
||||
* — возврат из мини-плеера тоже не сбрасывает фокус.
|
||||
*
|
||||
* Ровно тем же мостиком с 0.0.25 ездит и ЗАКРЕПЛЕНИЕ (`initialPinnedKey` /
|
||||
* `onPinnedKeyChange`): раньше `pinnedKey` был чисто локальным `useState`, и
|
||||
* закрепление, сделанное в основном окне, в мини-плеер не попадало вовсе.
|
||||
* Отдельный «общий» источник правды здесь не нужен: экземпляр сцены в каждый
|
||||
* момент ровно один (пока открыт Document PiP, основное окно показывает
|
||||
* заглушку — см. `RoomPage`), поэтому состояние достаточно передать по эстафете.
|
||||
*
|
||||
* Раскладка — вертикальная колонка миниатюр слева от основной сцены (не
|
||||
* горизонтальная лента, см. design/mockups/room.html после правки: узкая
|
||||
* колонка сбоку, скролл по вертикали). Это штатное поведение самого
|
||||
@@ -188,12 +256,21 @@ function PipMicToggle() {
|
||||
* показываем ТОЛЬКО одну крупную плитку активного окна — без карусели/грида;
|
||||
* режимы показа и скрытие остальных на мини-плеер не влияют вовсе.
|
||||
*
|
||||
* Фокус следует за активным спикером в ОБОИХ вариантах (`followSpeaker` у
|
||||
* `pickStageFocus`; для основного окна — с 0.0.6, задача 3.2), но по-разному:
|
||||
* PiP переключается мгновенно и всегда показывает говорящего, а основное окно
|
||||
* ждёт `SPEAKER_HOLD_MS` (не дёргается на коротких репликах), не уводит из
|
||||
* фокуса живую демонстрацию экрана (`holdScreenShare`) и умеет закрепление
|
||||
* участника (`pinnedKey`, задача 3.1) — кнопка-булавка на плитке.
|
||||
* ВЫБОР ФОКУСА ОДИНАКОВ В ОБОИХ ВАРИАНТАХ (с 0.0.25). До этого мини-плеер был
|
||||
* намеренно «упрощён»: без удержания говорящего, без удержания демонстрации
|
||||
* экрана (`holdScreenShare`), без приоритета говорящего с включённой камерой и
|
||||
* без закрепления. На практике это читалось как поломка: в мини-окне
|
||||
* демонстрация экрана слетала от любой чужой реплики, а закрепление,
|
||||
* сделанное в основном окне, не действовало. Теперь `pickStageFocus`
|
||||
* получает одни и те же правила независимо от варианта — разным остаётся
|
||||
* ровно одно: `localKey` (см. ниже) и то, что PiP рисует одну плитку вместо
|
||||
* раскладки.
|
||||
*
|
||||
* Единственное сознательное отличие — `localKey`: у мини-плеера есть
|
||||
* последний фолбэк «показать себя», у основного окна его нет (там фолбэк —
|
||||
* первый трек по порядку, поведение не менялось). Строка из того же сюжета,
|
||||
* что и `initialFocusKey`: без неё свежеоткрытое мини-окно на пустой комнате
|
||||
* выбирало произвольного участника.
|
||||
*/
|
||||
export function RoomStage({
|
||||
variant = 'full',
|
||||
@@ -203,6 +280,8 @@ export function RoomStage({
|
||||
onHideOthers,
|
||||
initialFocusKey = null,
|
||||
onFocusKeyChange,
|
||||
initialPinnedKey = null,
|
||||
onPinnedKeyChange,
|
||||
onPinFocus,
|
||||
raisedHandIdentities,
|
||||
conferenceId,
|
||||
@@ -221,6 +300,10 @@ export function RoomStage({
|
||||
initialFocusKey?: string | null
|
||||
/** Сообщать наружу текущий фокус, чтобы его пережил переезд сцены в мини-плеер и обратно. */
|
||||
onFocusKeyChange?: (key: string | null) => void
|
||||
/** Чем инициализировать закрепление при монтировании — тот же мостик через `RoomPage`, что и у фокуса. */
|
||||
initialPinnedKey?: string | null
|
||||
/** Сообщать наружу закрепление, чтобы оно пережило переезд сцены в мини-плеер и обратно. */
|
||||
onPinnedKeyChange?: (key: string | null) => void
|
||||
/**
|
||||
* Участника только что закрепили (не открепили) в режиме без крупной
|
||||
* плитки — сцена сама переключиться не может (режим живёт в `RoomPage`),
|
||||
@@ -245,9 +328,9 @@ export function RoomStage({
|
||||
// (`Room.activeSpeakers`, обновляются по `RoomEvent.ActiveSpeakersChanged`,
|
||||
// событие шлётся лишь при РЕАЛЬНОЙ смене состава/порядка говорящих — не
|
||||
// дребезжит на каждый чих, в отличие от сырого `participant.isSpeaking`).
|
||||
// Основное окно поверх этого ещё и удерживает состав (см. `useSteadySpeakers`
|
||||
// и `SPEAKER_HOLD_MS`), PiP берёт значение как есть.
|
||||
const speakingParticipants = useSteadySpeakers(useSpeakingParticipants(), variant === 'pip' ? 0 : SPEAKER_HOLD_MS)
|
||||
// Поверх этого сцена ещё и удерживает состав (см. `useSteadySpeakers` и
|
||||
// `SPEAKER_HOLD_MS`) — в обоих вариантах одинаково.
|
||||
const speakingParticipants = useSteadySpeakers(useSpeakingParticipants(), SPEAKER_HOLD_MS)
|
||||
|
||||
const cameraTracks = tracks.filter((t) => t.source === Track.Source.Camera)
|
||||
const screenShareTracks = tracks.filter((t) => isTrackReference(t) && t.source === Track.Source.ScreenShare)
|
||||
@@ -289,8 +372,10 @@ export function RoomStage({
|
||||
const [focusKey, setFocusKey] = useState<string | null>(initialFocusKey)
|
||||
// Закрепление живёт в состоянии сцены (задача 3.1): ключ `identity:source`
|
||||
// плитки, которую пользователь закрепил булавкой; `null` — закрепления нет.
|
||||
// Только для основного окна — в PiP плитка одна и закреплять нечего.
|
||||
const [pinnedKey, setPinnedKey] = useState<string | null>(null)
|
||||
// Стартовое значение приходит от предыдущего экземпляра сцены (тот же
|
||||
// мостик через `RoomPage`, что и у фокуса), поэтому закрепление, сделанное
|
||||
// в основном окне, действует и в мини-плеере.
|
||||
const [pinnedKey, setPinnedKey] = useState<string | null>(initialPinnedKey)
|
||||
const [prevPinnedKey, setPrevPinnedKey] = useState<string | null>(null)
|
||||
|
||||
const cameraKeys = cameraTracks.map(stageTrackKey)
|
||||
@@ -299,13 +384,23 @@ export function RoomStage({
|
||||
// камера есть у КАЖДОГО участника хотя бы плейсхолдером, — ни среди
|
||||
// демонстраций) — закрепление снимаем, чтобы сцена не осталась в подвешенном
|
||||
// состоянии и булавка не «висела» на исчезнувшем ключе.
|
||||
//
|
||||
// `tracksKnown` — обязательная охрана, а не перестраховка: на ПЕРВОМ рендере
|
||||
// нового экземпляра сцены `useTracks` отдаёт ПУСТОЙ массив (реальный состав
|
||||
// приезжает следующим рендером, из подписки на события комнаты). Без этой
|
||||
// проверки пустой набор читается как «все вышли», и закрепление, приехавшее
|
||||
// через `initialPinnedKey`, обнулялось сразу при монтировании — то есть
|
||||
// мини-плеер терял его каждый раз (найдено живой отладкой при 0.0.25).
|
||||
// Пустых наборов при живой комнате не бывает: камера есть у каждого
|
||||
// участника хотя бы плейсхолдером.
|
||||
const tracksKnown = cameraKeys.length > 0 || screenShareKeys.length > 0
|
||||
const pinnedAlive = pinnedKey !== null && (cameraKeys.includes(pinnedKey) || screenShareKeys.includes(pinnedKey))
|
||||
|
||||
const tracksChanged = tracks !== prevTracks
|
||||
const speakingChanged = speakingParticipants !== prevSpeakingParticipants
|
||||
const pinnedChanged = pinnedKey !== prevPinnedKey
|
||||
|
||||
if (pinnedKey !== null && !pinnedAlive) {
|
||||
if (pinnedKey !== null && tracksKnown && !pinnedAlive) {
|
||||
setPinnedKey(null)
|
||||
}
|
||||
|
||||
@@ -328,14 +423,12 @@ export function RoomStage({
|
||||
cameraKeys,
|
||||
screenShareKeys,
|
||||
speakingCameraKeys,
|
||||
// Приоритет «говорящий с камерой выше говорящего без камеры» — только
|
||||
// основному окну: PiP по договорённости ведёт себя ровно как раньше.
|
||||
cameraKeysWithVideo: variant === 'pip' ? [] : cameraTracks.filter(hasLiveVideo).map(stageTrackKey),
|
||||
cameraKeysWithVideo: cameraTracks.filter(hasLiveVideo).map(stageTrackKey),
|
||||
prevKeys,
|
||||
prevFocusKey: focusKey,
|
||||
pinnedKey: pinnedAlive ? pinnedKey : null,
|
||||
followSpeaker: true,
|
||||
holdScreenShare: variant !== 'pip',
|
||||
holdScreenShare: true,
|
||||
// Только для PiP — в основном окне фолбэк на «первый трек» не менялся.
|
||||
localKey: variant === 'pip' ? `${room.localParticipant.identity}:${Track.Source.Camera}` : null,
|
||||
})
|
||||
@@ -352,6 +445,11 @@ export function RoomStage({
|
||||
onFocusKeyChange?.(focusKey)
|
||||
}, [focusKey, onFocusKeyChange])
|
||||
|
||||
// То же самое для закрепления — см. `initialPinnedKey`.
|
||||
useEffect(() => {
|
||||
onPinnedKeyChange?.(pinnedKey)
|
||||
}, [pinnedKey, onPinnedKeyChange])
|
||||
|
||||
const focusTrack = tracks.find((t) => stageTrackKey(t) === focusKey) ?? screenShareTracks[0] ?? cameraTracks[0]
|
||||
const focusTrackKey = focusTrack ? stageTrackKey(focusTrack) : null
|
||||
// При активной демонстрации карусель — ВСЕ камеры (включая демонстратора) И
|
||||
@@ -394,13 +492,30 @@ export function RoomStage({
|
||||
// Мини-плеер показывает ТОЛЬКО активное окно — без карусели/
|
||||
// грида, одна плитка на весь контейнер (см. `.room-single-tile`,
|
||||
// `styles/room.css`). `focusTrack` уже вычислен выше тем же `pickStageFocus`
|
||||
// (с `followSpeaker: true` для этого варианта) — переиспользуем как есть.
|
||||
// и по тем же правилам, что и в основном окне (закрепление, удержание
|
||||
// демонстрации, антидребезг говорящего) — переиспользуем как есть.
|
||||
// Булавки на плитке здесь нет намеренно: своего тулбара у мини-окна нет,
|
||||
// закрепление делается в основном окне и приезжает сюда через
|
||||
// `initialPinnedKey`. А вот микрофон и демонстрация экрана в мини-окне есть:
|
||||
// это не «вид», а действия, которые нужны прямо посреди разговора, и ради них
|
||||
// разворачивать основное окно (то есть закрывать мини-окно) бессмысленно.
|
||||
//
|
||||
// СОБСТВЕННАЯ ДЕМОНСТРАЦИЯ в мини-окне ПОКАЗЫВАЕТСЯ — по тем же правилам
|
||||
// `pickStageFocus`, что и в основном окне (last-wins на старте, возврат на
|
||||
// говорящего/закреплённого после остановки). Решение оператора при приёмке
|
||||
// 0.0.29: демонстратор должен видеть, что именно он демонстрирует, ровно то
|
||||
// же, что видят остальные. Пробная версия прятала свой шэр из PiP (чтобы
|
||||
// вместо него была видна аудитория и чтобы при выборе «весь экран» не
|
||||
// получался зеркальный туннель «мини-окно внутри мини-окна») — отклонена.
|
||||
// Туннель при выборе «весь экран» остаётся известным и принятым поведением.
|
||||
if (variant === 'pip') {
|
||||
return (
|
||||
<section className="stage room-single-tile">
|
||||
{focusTrack && <RoomParticipantTile trackRef={focusTrack} onStopSharing={handleStopSharing} />}
|
||||
<PipMicToggle />
|
||||
<RoomAudioRenderer />
|
||||
<div className="room-pip-controls">
|
||||
<PipMicToggle />
|
||||
<PipScreenShareToggle />
|
||||
</div>
|
||||
</section>
|
||||
)
|
||||
}
|
||||
@@ -496,7 +611,6 @@ export function RoomStage({
|
||||
<span>Показать остальных ({sideTracks.length})</span>
|
||||
</button>
|
||||
)}
|
||||
<RoomAudioRenderer />
|
||||
</section>
|
||||
)
|
||||
}
|
||||
|
||||
@@ -13,33 +13,14 @@ import {
|
||||
Video,
|
||||
VideoOff,
|
||||
} from 'lucide-react'
|
||||
import { Track, type ScreenShareCaptureOptions } from 'livekit-client'
|
||||
import { Track } from 'livekit-client'
|
||||
import { DisconnectButton, useLocalParticipant, useTrackToggle } from '@livekit/components-react'
|
||||
import { useToast } from '@/components/ui/ToastProvider'
|
||||
import { useIsCompactViewport } from '@/hooks/useIsCompactViewport'
|
||||
import type { HandQueueEntry } from '@/hooks/useChat'
|
||||
import { StageViewMenu, type StageViewProps } from '@/components/room/StageViewOptions'
|
||||
import { HandQueueMenu } from '@/components/room/HandQueueMenu'
|
||||
|
||||
/**
|
||||
* Опции захвата демонстрации экрана: `audio: true` — звук
|
||||
* вкладки/экрана там, где браузер его отдаёт (Chrome/Edge — вкладка почти
|
||||
* всегда, целый экран — только Windows); `selfBrowserSurface: 'exclude'`
|
||||
* — не предлагать в списке
|
||||
* источников собственную вкладку (зеркальный туннель самой конференции);
|
||||
* `surfaceSwitching: 'include'` — разрешить переключать источник прямо во
|
||||
* время демонстрации, не останавливая её; `systemAudio: 'include'` — не
|
||||
* запрещать захват системного звука при выборе «весь экран». Вынесено в
|
||||
* модульную константу — `useTrackToggle` держит `JSON.stringify(captureOptions)`
|
||||
* в зависимостях внутреннего `useMemo`, инлайновый литерал был бы безвреден,
|
||||
* но константа явнее фиксирует неизменность опций.
|
||||
*/
|
||||
const SCREEN_SHARE_CAPTURE_OPTIONS: ScreenShareCaptureOptions = {
|
||||
audio: true,
|
||||
selfBrowserSurface: 'exclude',
|
||||
surfaceSwitching: 'include',
|
||||
systemAudio: 'include',
|
||||
}
|
||||
import { SCREEN_SHARE_CAPTURE_OPTIONS } from '@/lib/screenShareOptions'
|
||||
|
||||
interface RoomToolbarProps extends StageViewProps {
|
||||
/** Показывать ли кнопку чата — `JoinOut.chat_enabled` И чат не помечен недоступным (close-код 4404). */
|
||||
@@ -58,6 +39,8 @@ interface RoomToolbarProps extends StageViewProps {
|
||||
pipSupported: boolean
|
||||
pipActive: boolean
|
||||
onTogglePiP: () => void
|
||||
/** `JoinOut.hand_queue_enabled` — при `false` кнопка «Рука» и очередь не рендерятся вовсе. */
|
||||
handQueueEnabled: boolean
|
||||
/**
|
||||
* Очередь поднятых рук целиком (задача B1, `useChat().handQueue`) — сама
|
||||
* решает, поднята ли СВОЯ рука (сравнивая с `localParticipant.identity`
|
||||
@@ -68,6 +51,16 @@ interface RoomToolbarProps extends StageViewProps {
|
||||
onLowerHand: () => void
|
||||
/** Опустить ЧУЖУЮ руку по identity — только организатору (панель очереди, `HandQueueMenu`). */
|
||||
onLowerHandById: (identity: string) => void
|
||||
/** Тулбар в оверлее полноэкранного режима — см. докстринг `RoomTopbar.overlayVisible`, тот же механизм. */
|
||||
overlayVisible?: boolean
|
||||
/**
|
||||
* Пользователь нажал «Выйти» — вызывается ПЕРЕД тем, как `DisconnectButton`
|
||||
* отключит комнату (обработчики в `mergeProps` вызываются цепочкой). Нужен
|
||||
* `RoomPage`, чтобы отличить намеренный выход от разрыва: причина
|
||||
* `CLIENT_INITIATED` приходит и от кнопки, и от livekit-client при заморозке
|
||||
* вкладки — см. докстринг `handleDisconnected`.
|
||||
*/
|
||||
onLeave?: () => void
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -77,16 +70,22 @@ interface RoomToolbarProps extends StageViewProps {
|
||||
* панели чата, стилизованные по design/mockups/room.html.
|
||||
*
|
||||
* Кнопка «Вид» (режимы показа и скрытие остальных) рендерится ТОЛЬКО на
|
||||
* широком экране — условным рендерингом, а не скрытием через CSS: тулбар на
|
||||
* мобильном и так ужат до пяти «безусловных» кнопок (демонстрация/
|
||||
* полноэкранный режим/мини-плеер скрыты на узком экране через CSS, см.
|
||||
* `styles/room.css`), а те же настройки там доступны секцией «Вид» в шторке
|
||||
* настроек (`DeviceSettingsDialog`). «Рука» — сознательное исключение из этой
|
||||
* широком экране — условным рендерингом, а не скрытием через CSS: демонстрация
|
||||
* и мини-плеер скрыты на узком экране через CSS (см. `styles/room.css`), а те
|
||||
* же настройки показа сцены доступны секцией «Вид» в шторке настроек
|
||||
* (`DeviceSettingsDialog`). «Рука» — сознательное исключение из этой
|
||||
* экономии: поднять руку посреди разговора — действие со временем жизни в
|
||||
* секунды, прятать его в шторку настроек означало бы делать его практически
|
||||
* недоступным с телефона. «Очередь» показывается только организатору —
|
||||
* встречается редко, но по той же причине оставлена в тулбаре, а не в
|
||||
* шторке: организатору с телефона тоже нужно видеть очередь сразу.
|
||||
* недоступным с телефона. «Очередь» видна ЛЮБОМУ участнику (сессия
|
||||
* «28-hand-queue-for-all»: раньше только организатору), по той же причине
|
||||
* оставлена в тулбаре, а не в шторке: любому участнику с телефона тоже нужно
|
||||
* видеть очередь сразу. Обе кнопки целиком гасятся `handQueueEnabled`
|
||||
* (`JoinOut.hand_queue_enabled`, отключаемый модуль в админке).
|
||||
* Полноэкранный режим на мобильном ОСТАЁТСЯ в тулбаре (не спрятан в шторку,
|
||||
* как демонстрация/мини-плеер) — по решению оператора вход в него должен
|
||||
* быть по аналогии с десктопом; если из-за этого кнопки не помещаются в один
|
||||
* ряд, `mobileButtonCount`/`.tb-wrap-grid` ниже раскладывают их равномерной
|
||||
* сеткой, а не как получится через `flex-wrap`.
|
||||
*/
|
||||
export function RoomToolbar({
|
||||
chatVisible,
|
||||
@@ -100,6 +99,7 @@ export function RoomToolbar({
|
||||
pipSupported,
|
||||
pipActive,
|
||||
onTogglePiP,
|
||||
handQueueEnabled,
|
||||
handQueue,
|
||||
onRaiseHand,
|
||||
onLowerHand,
|
||||
@@ -108,11 +108,31 @@ export function RoomToolbar({
|
||||
onLayoutModeChange,
|
||||
hideOthers,
|
||||
onHideOthersChange,
|
||||
overlayVisible,
|
||||
onLeave,
|
||||
}: RoomToolbarProps) {
|
||||
const toast = useToast()
|
||||
const isCompact = useIsCompactViewport()
|
||||
const { localParticipant } = useLocalParticipant()
|
||||
const handRaised = handQueue.some((entry) => entry.identity === localParticipant.identity)
|
||||
|
||||
// Сколько кнопок реально видно на мобильном (демонстрация/мини-окно там
|
||||
// скрыты через CSS всегда, «Вид» не рендерится вовсе — см. докстринг) —
|
||||
// считаем в JS, а не через CSS-селекторы вида `:nth-child`: у «Очереди»
|
||||
// в DOM есть своя обёртка `.tb-menu-wrap`, из-за которой позиция остальных
|
||||
// кнопок «плывёт», и подсчёт по структуре DOM был бы хрупким. От порога
|
||||
// зависит `.tb-wrap-grid` в room.css — ниже он переключает перенос на
|
||||
// 2 строки с «как поместится» (flex-wrap) на равномерную сетку 4 колонки
|
||||
// (7 → 4+3, 8 → 4+4). «Рука»/«Очередь» — обе теперь видны любому участнику
|
||||
// (сессия «28-hand-queue-for-all»), их наличие зависит только от
|
||||
// `handQueueEnabled`, не от роли.
|
||||
const mobileButtonCount =
|
||||
2 /* микрофон, камера */ +
|
||||
(handQueueEnabled ? 2 : 0) /* рука, очередь */ +
|
||||
1 /* настройки */ +
|
||||
(fullscreenSupported ? 1 : 0) +
|
||||
(chatVisible ? 1 : 0) +
|
||||
1 /* выйти */
|
||||
const mic = useTrackToggle({ source: Track.Source.Microphone })
|
||||
const camera = useTrackToggle({ source: Track.Source.Camera })
|
||||
const screenShare = useTrackToggle({
|
||||
@@ -129,7 +149,9 @@ export function RoomToolbar({
|
||||
})
|
||||
|
||||
return (
|
||||
<footer className="room-toolbar">
|
||||
<footer
|
||||
className={`room-toolbar${overlayVisible ? ' is-visible' : ''}${mobileButtonCount >= 7 ? ' tb-wrap-grid' : ''}`}
|
||||
>
|
||||
<button
|
||||
type="button"
|
||||
{...mic.buttonProps}
|
||||
@@ -178,23 +200,25 @@ export function RoomToolbar({
|
||||
<span className="label">Демонстрация</span>
|
||||
</button>
|
||||
|
||||
<button
|
||||
type="button"
|
||||
className={`tb-btn${handRaised ? ' is-hand-raised' : ''}`}
|
||||
aria-pressed={handRaised}
|
||||
aria-label={handRaised ? 'Опустить руку' : 'Поднять руку'}
|
||||
onClick={() => (handRaised ? onLowerHand() : onRaiseHand())}
|
||||
>
|
||||
<span className="icon-shell">
|
||||
<Hand className="lucide" aria-hidden="true" />
|
||||
{handQueue.length > 0 && (
|
||||
<span className="badge-count">{handQueue.length > 9 ? '9+' : handQueue.length}</span>
|
||||
)}
|
||||
</span>
|
||||
<span className="label">Рука</span>
|
||||
</button>
|
||||
{handQueueEnabled && (
|
||||
<button
|
||||
type="button"
|
||||
className={`tb-btn${handRaised ? ' is-hand-raised' : ''}`}
|
||||
aria-pressed={handRaised}
|
||||
aria-label={handRaised ? 'Опустить руку' : 'Поднять руку'}
|
||||
onClick={() => (handRaised ? onLowerHand() : onRaiseHand())}
|
||||
>
|
||||
<span className="icon-shell">
|
||||
<Hand className="lucide" aria-hidden="true" />
|
||||
{handQueue.length > 0 && (
|
||||
<span className="badge-count">{handQueue.length > 9 ? '9+' : handQueue.length}</span>
|
||||
)}
|
||||
</span>
|
||||
<span className="label">Рука</span>
|
||||
</button>
|
||||
)}
|
||||
|
||||
<HandQueueMenu queue={handQueue} onLower={onLowerHandById} />
|
||||
{handQueueEnabled && <HandQueueMenu queue={handQueue} onLower={onLowerHandById} />}
|
||||
|
||||
{!isCompact && (
|
||||
<StageViewMenu
|
||||
@@ -214,7 +238,10 @@ export function RoomToolbar({
|
||||
<span className="icon-shell">
|
||||
<Settings className="lucide" aria-hidden="true" />
|
||||
</span>
|
||||
<span className="label">Устройства</span>
|
||||
{/* На мобильном подпись шире по смыслу («Настройки»): там же в шторке
|
||||
секция «Вид», а отдельной кнопки под неё в тулбаре нет. На десктопе
|
||||
панель — только настройки устройств, подпись это отражает. */}
|
||||
<span className="label">{isCompact ? 'Настройки' : 'Устройства'}</span>
|
||||
</button>
|
||||
|
||||
{fullscreenSupported && (
|
||||
@@ -276,7 +303,7 @@ export function RoomToolbar({
|
||||
</button>
|
||||
)}
|
||||
|
||||
<DisconnectButton className="tb-btn danger" aria-label="Выйти из конференции">
|
||||
<DisconnectButton className="tb-btn danger" aria-label="Выйти из конференции" onClick={onLeave}>
|
||||
<span className="icon-shell">
|
||||
<LogOut className="lucide" aria-hidden="true" />
|
||||
</span>
|
||||
|
||||
@@ -15,6 +15,12 @@ interface RoomTopbarProps {
|
||||
/** Slug/номер конференции из адреса — для инвайт-чипа (копирование ссылки). */
|
||||
slug?: string
|
||||
number?: string
|
||||
/**
|
||||
* Полноэкранный режим (`RoomPage.tsx`) прячет топбар в оверлей и показывает
|
||||
* его только по этому флагу — вне полноэкранного режима не влияет ни на что
|
||||
* (CSS-правило само по себе действует лишь под `.room-fullscreen-overlay`).
|
||||
*/
|
||||
overlayVisible?: boolean
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -26,7 +32,7 @@ interface RoomTopbarProps {
|
||||
* тёмных токенов темы `room` (см. `--color-room-tile*`), без новых
|
||||
* цветов и форм.
|
||||
*/
|
||||
export function RoomTopbar({ title, slug, number }: RoomTopbarProps) {
|
||||
export function RoomTopbar({ title, slug, number, overlayVisible }: RoomTopbarProps) {
|
||||
const participants = useParticipants()
|
||||
const [copied, setCopied] = useState(false)
|
||||
|
||||
@@ -44,7 +50,7 @@ export function RoomTopbar({ title, slug, number }: RoomTopbarProps) {
|
||||
}
|
||||
|
||||
return (
|
||||
<header className="room-topbar">
|
||||
<header className={`room-topbar${overlayVisible ? ' is-visible' : ''}`}>
|
||||
<div className="room-title-block">
|
||||
<h1>{title ?? 'Конференция без названия'}</h1>
|
||||
<p>
|
||||
|
||||
@@ -62,8 +62,10 @@ export interface PickStageFocusInput {
|
||||
/** Ключ, что был в фокусе на предыдущем рендере; `null` — фокус ещё не выбирался. */
|
||||
prevFocusKey: string | null
|
||||
/**
|
||||
* Ключ трека, ЗАКРЕПЛЁННОГО пользователем в основном окне (кнопка-булавка на
|
||||
* плитке, состояние живёт в `RoomStage.tsx`); `null` — закрепления нет.
|
||||
* Ключ трека, ЗАКРЕПЛЁННОГО пользователем (кнопка-булавка на плитке
|
||||
* основного окна; состояние живёт в `RoomStage.tsx` и переезжает в
|
||||
* мини-плеер через `RoomPage`, см. там `initialPinnedKey`); `null` —
|
||||
* закрепления нет.
|
||||
* Закрепление держит фокус вопреки говорящим, но уступает ЛЮБОЙ активной
|
||||
* демонстрации экрана (формулировка оператора: «перебивается только чьей-либо
|
||||
* демонстрацией экрана») — а когда демонстрация закончилась, фокус
|
||||
@@ -79,19 +81,22 @@ export interface PickStageFocusInput {
|
||||
* не удерживать текущий). С 0.0.6 включено и для мини-плеера (PiP), и для
|
||||
* основного окна — решение оператора (этап 3, задача 3.2). Защита от
|
||||
* дребезга — на стороне вызывающего: источник «говорящих» — throttled
|
||||
* `useSpeakingParticipants()` поверх `RoomEvent.ActiveSpeakersChanged`, а в
|
||||
* основном окне ещё и удержание в ~1.2 с (см. `useSteadySpeakers` в
|
||||
* `RoomStage.tsx`), не сырой дребезжащий `participant.isSpeaking`.
|
||||
* `useSpeakingParticipants()` поверх `RoomEvent.ActiveSpeakersChanged` плюс
|
||||
* удержание в ~1.2 с (см. `useSteadySpeakers` в `RoomStage.tsx`, с 0.0.25 —
|
||||
* в обеих сценах), не сырой дребезжащий `participant.isSpeaking`.
|
||||
* По умолчанию `false` — фокус удерживается (см. правило 5).
|
||||
*/
|
||||
followSpeaker?: boolean
|
||||
/**
|
||||
* Живая демонстрация экрана в фокусе НЕ уступает заговорившему участнику
|
||||
* (правило 3). Нужно основному окну: там демонстрация — это содержательный
|
||||
* центр разговора, и уводить её из большого окна на каждую реплику нельзя.
|
||||
* Мини-плеер (PiP) показывает ровно одну плитку и намеренно ведёт себя иначе
|
||||
* — всегда показывает того, кто говорит, поэтому там `false` (поведение
|
||||
* PiP не менялось с 0.0.4).
|
||||
* (правило 3). Демонстрация — это содержательный центр разговора, и уводить
|
||||
* её из фокуса на каждую реплику нельзя.
|
||||
*
|
||||
* С 0.0.25 включено в ОБЕИХ сценах. До этого мини-плеер (PiP) намеренно
|
||||
* ходил с `false` — «одна плитка, всегда показываем говорящего»; на практике
|
||||
* это выглядело как поломка: демонстрация в мини-окне пропадала, стоило
|
||||
* кому-то сказать слово. По умолчанию всё ещё `false` — это поведение
|
||||
* функции без явного запроса удержания.
|
||||
*/
|
||||
holdScreenShare?: boolean
|
||||
/**
|
||||
@@ -132,16 +137,14 @@ function pickSpeakerKey(
|
||||
* фокус безусловно переходит на него (последний из новых, если появилось
|
||||
* сразу несколько), даже если до этого в фокусе была камера или другая
|
||||
* демонстрация. Так же ведут себя типовые UI конференций (Google Meet).
|
||||
* 2. Закрепление (`pinnedKey`, только основное окно): закреплённый участник
|
||||
* 2. Закрепление (`pinnedKey`): закреплённый участник
|
||||
* забирает фокус у говорящих и у удержания предыдущего фокуса, но уступает
|
||||
* ЛЮБОЙ активной демонстрации экрана. Поэтому правило и стоит выше
|
||||
* удержания (правило 5): как только демонстрация закончилась и
|
||||
* `screenShareKeys` опустел, фокус возвращается на закреплённого, а не
|
||||
* остаётся на том, кто был в фокусе до демонстрации.
|
||||
* 3. `holdScreenShare` (только основное окно): демонстрация, уже стоящая в
|
||||
* фокусе, не уступает заговорившему — иначе большое окно уводило бы шэр на
|
||||
* каждую реплику. В PiP шаг пропускается (там одна плитка и она всегда
|
||||
* показывает говорящего).
|
||||
* 3. `holdScreenShare`: демонстрация, уже стоящая в фокусе, не уступает
|
||||
* заговорившему — иначе окно уводило бы шэр на каждую реплику.
|
||||
* 4. `followSpeaker`: если сейчас есть говорящий — фокус СРАЗУ переходит на
|
||||
* него, даже если текущий фокус ещё жив; среди одновременно говорящих
|
||||
* предпочитаем того, у кого включена камера (`cameraKeysWithVideo`).
|
||||
|
||||
29
frontend/src/lib/screenShareOptions.ts
Normal file
29
frontend/src/lib/screenShareOptions.ts
Normal file
@@ -0,0 +1,29 @@
|
||||
import type { ScreenShareCaptureOptions } from 'livekit-client'
|
||||
|
||||
/**
|
||||
* Опции захвата демонстрации экрана: `audio: true` — звук
|
||||
* вкладки/экрана там, где браузер его отдаёт (Chrome/Edge — вкладка почти
|
||||
* всегда, целый экран — только Windows); `selfBrowserSurface: 'exclude'`
|
||||
* — не предлагать в списке
|
||||
* источников собственную вкладку (зеркальный туннель самой конференции);
|
||||
* `surfaceSwitching: 'include'` — разрешить переключать источник прямо во
|
||||
* время демонстрации, не останавливая её; `systemAudio: 'include'` — не
|
||||
* запрещать захват системного звука при выборе «весь экран».
|
||||
*
|
||||
* Вынесено в модульную константу — `useTrackToggle` держит
|
||||
* `JSON.stringify(captureOptions)` в зависимостях внутреннего `useMemo`,
|
||||
* инлайновый литерал был бы безвреден, но константа явнее фиксирует
|
||||
* неизменность опций.
|
||||
*
|
||||
* Живёт в `lib/`, а не рядом с тулбаром, потому что кнопок демонстрации теперь
|
||||
* ДВЕ: в основном тулбаре (`RoomToolbar`) и в мини-окне (`RoomStage`,
|
||||
* `PipScreenShareToggle`). Опции у них обязаны совпадать: обе кнопки управляют
|
||||
* одной и той же публикацией, и разойдись они хотя бы в `audio`, демонстрация
|
||||
* получалась бы разной в зависимости от того, откуда её запустили.
|
||||
*/
|
||||
export const SCREEN_SHARE_CAPTURE_OPTIONS: ScreenShareCaptureOptions = {
|
||||
audio: true,
|
||||
selfBrowserSurface: 'exclude',
|
||||
surfaceSwitching: 'include',
|
||||
systemAudio: 'include',
|
||||
}
|
||||
@@ -146,6 +146,7 @@ export function JoinPage() {
|
||||
title: resolved.title,
|
||||
conferenceId: data.conference_id,
|
||||
chatEnabled: data.chat_enabled,
|
||||
handQueueEnabled: data.hand_queue_enabled,
|
||||
publishQualityCap: data.publish_quality_cap,
|
||||
stageMaxTiles: data.stage_max_tiles,
|
||||
},
|
||||
|
||||
@@ -43,6 +43,7 @@ export function LobbyPage() {
|
||||
title: conference.title,
|
||||
conferenceId: conference.join.conference_id,
|
||||
chatEnabled: conference.join.chat_enabled,
|
||||
handQueueEnabled: conference.join.hand_queue_enabled,
|
||||
publishQualityCap: conference.join.publish_quality_cap,
|
||||
stageMaxTiles: conference.join.stage_max_tiles,
|
||||
number: conference.number,
|
||||
|
||||
@@ -2,8 +2,8 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
|
||||
import { createPortal } from 'react-dom'
|
||||
import { useLocation, useNavigate, useParams } from 'react-router-dom'
|
||||
import { PictureInPicture2 } from 'lucide-react'
|
||||
import { LiveKitRoom, usePersistentUserChoices } from '@livekit/components-react'
|
||||
import type { RoomOptions } from 'livekit-client'
|
||||
import { LiveKitRoom, RoomAudioRenderer, usePersistentUserChoices } from '@livekit/components-react'
|
||||
import { DisconnectReason, type RoomOptions } from 'livekit-client'
|
||||
import '@livekit/components-styles'
|
||||
import '@/styles/room.css'
|
||||
import { joinConference, resolveConference, type PublishQualityCap } from '@/api/conferences'
|
||||
@@ -22,6 +22,29 @@ import { loadAudioOutputDeviceId } from '@/lib/audioOutputDevice'
|
||||
import { buildPublishDefaults } from '@/lib/publishQualityCap'
|
||||
import { loadStageLayoutMode, saveStageLayoutMode, type StageLayoutMode } from '@/lib/stageLayoutMode'
|
||||
|
||||
/** Сколько мс держать топбар/тулбар видимыми в полноэкранном режиме без взаимодействия, прежде чем спрятать их снова. */
|
||||
const FULLSCREEN_CONTROLS_AUTO_HIDE_MS = 4000
|
||||
|
||||
/** Полоса у нижнего края экрана (px) — наведение мыши в неё в полноэкранном режиме на десктопе показывает тулбар без клика. */
|
||||
const FULLSCREEN_FOOTER_HOVER_ZONE_PX = 72
|
||||
|
||||
/**
|
||||
* Сколько раз подряд страница возвращается в конференцию сама после разрыва,
|
||||
* которого пользователь не просил. Ограничение — защита от бесконечного цикла
|
||||
* «вошёл → сразу выбросило»: например, если конференция кончилась ровно в
|
||||
* момент разрыва или сервер по какой-то причине не принимает участника.
|
||||
* Исчерпав бюджет, страница ведёт себя как раньше — уводит в лобби.
|
||||
*/
|
||||
const AUTO_REJOIN_LIMIT = 5
|
||||
|
||||
/**
|
||||
* Соединение, прожившее дольше этого времени, считается состоявшимся: бюджет
|
||||
* авто-перезаходов обнуляется. Без этого редкие разрывы за длинную встречу
|
||||
* (телефон засыпал пять раз за час) постепенно съели бы лимит и шестое
|
||||
* пробуждение выбросило бы участника в лобби.
|
||||
*/
|
||||
const AUTO_REJOIN_BUDGET_RESET_MS = 30_000
|
||||
|
||||
interface RoomJoinState {
|
||||
livekitUrl: string
|
||||
token: string
|
||||
@@ -32,6 +55,8 @@ interface RoomJoinState {
|
||||
number?: string
|
||||
/** `JoinOut.chat_enabled` — при `false` кнопка чата и панель не рендерятся. */
|
||||
chatEnabled?: boolean
|
||||
/** `JoinOut.hand_queue_enabled` — при `false` кнопка «Рука» и очередь не рендерятся. */
|
||||
handQueueEnabled?: boolean
|
||||
/**
|
||||
* Рычаги нагрузки медиа (`JoinOut.publish_quality_cap`/`stage_max_tiles`,
|
||||
* `instance_settings.media_limits`) — приезжают вместе с токеном, ДО
|
||||
@@ -72,13 +97,88 @@ export function RoomPage() {
|
||||
const [joinState, setJoinState] = useState<RoomJoinState | null>(initialState)
|
||||
const [error, setError] = useState<string | null>(null)
|
||||
|
||||
// Пользователь нажал «Выйти» — ЕДИНСТВЕННЫЙ признак, по которому уход со
|
||||
// страницы считается намеренным. Отдельный флаг нужен потому, что причина
|
||||
// `CLIENT_INITIATED` приходит не только от кнопки: livekit-client вешает
|
||||
// обработчик на событие `freeze` (Page Lifecycle) и при заморозке вкладки
|
||||
// сам зовёт `room.disconnect()` — с той же самой причиной. Android Chrome
|
||||
// фоновую вкладку замораживает, так что без этого флага заснувший телефон
|
||||
// выглядел бы ровно как «пользователь вышел» и уезжал бы в лобби.
|
||||
const leaveRequestedRef = useRef(false)
|
||||
// Когда установилось текущее соединение — чтобы отличить «разрыв после
|
||||
// нормальной работы» от «выбрасывает сразу после входа» (см. AUTO_REJOIN_*).
|
||||
const connectedAtRef = useRef(0)
|
||||
const autoRejoinCountRef = useRef(0)
|
||||
|
||||
const handleLeaveClick = useCallback(() => {
|
||||
leaveRequestedRef.current = true
|
||||
}, [])
|
||||
|
||||
const handleConnected = useCallback(() => {
|
||||
connectedAtRef.current = Date.now()
|
||||
// Мы снова в комнате — намерение выйти, если оно откуда-то осталось
|
||||
// невыполненным, к этому соединению уже не относится.
|
||||
leaveRequestedRef.current = false
|
||||
}, [])
|
||||
|
||||
// useCallback: стабильная ссылка на обработчик — иначе на каждом рендере
|
||||
// RoomPage пересобирался бы объект-пропс `onDisconnected`, а с ним и
|
||||
// внутренний useEffect @livekit/components-react (он в списке зависимостей
|
||||
// хука useLiveKitRoom), лишний раз пересоздавая подписки на события Room.
|
||||
const handleDisconnected = useCallback(() => {
|
||||
navigate(status === 'authenticated' ? '/lobby' : '/join')
|
||||
}, [navigate, status])
|
||||
//
|
||||
// Разрыв ≠ выход. До 0.0.27 любое отключение уводило со страницы, и на
|
||||
// мобильном это ломало обычный сценарий: экран телефона гаснет, Chrome
|
||||
// срезает фоновой вкладке ресурсы, ICE перестаёт отвечать — и LiveKit
|
||||
// закрывает участника через 5 с после потери соединения
|
||||
// (`PEER_CONNECTION_DISCONNECTED`, замерено на проде: 37 с после блокировки
|
||||
// экрана, 23 с после сворачивания браузера). Восстановить сессию после
|
||||
// этого нельзя — участника на сервере уже нет (`could not restart
|
||||
// participant`), нужен полный повторный вход. livekit-client такой вход
|
||||
// пытается сделать сам, но его бюджет повторов (10 попыток, ~44 с) в
|
||||
// фоновой вкладке успевает сгореть — и тогда приходит `Disconnected`,
|
||||
// после которого пользователь оказывался в лобби вместо конференции.
|
||||
//
|
||||
// Теперь непреднамеренный разрыв просто сбрасывает `joinState`, а дальше
|
||||
// работает уже написанный путь авто-перезахода (эффект ниже): страница
|
||||
// молча резолвит конференцию, берёт свежий токен и входит заново. Никакого
|
||||
// второго механизма восстановления не появляется.
|
||||
const handleDisconnected = useCallback(
|
||||
(reason?: DisconnectReason) => {
|
||||
const leaveForGood = () => navigate(status === 'authenticated' ? '/lobby' : '/join')
|
||||
|
||||
if (leaveRequestedRef.current) {
|
||||
leaveForGood()
|
||||
return
|
||||
}
|
||||
|
||||
// Разрывы, после которых возвращаться некуда или нельзя: участника
|
||||
// выгнал организатор, конференцию закрыли, либо этой же личностью вошли
|
||||
// с другого устройства (перезаход устроил бы пинг-понг между ними).
|
||||
if (
|
||||
reason === DisconnectReason.PARTICIPANT_REMOVED ||
|
||||
reason === DisconnectReason.ROOM_DELETED ||
|
||||
reason === DisconnectReason.ROOM_CLOSED ||
|
||||
reason === DisconnectReason.DUPLICATE_IDENTITY
|
||||
) {
|
||||
leaveForGood()
|
||||
return
|
||||
}
|
||||
|
||||
const sessionMs = connectedAtRef.current ? Date.now() - connectedAtRef.current : 0
|
||||
if (sessionMs > AUTO_REJOIN_BUDGET_RESET_MS) {
|
||||
autoRejoinCountRef.current = 0
|
||||
}
|
||||
if (autoRejoinCountRef.current >= AUTO_REJOIN_LIMIT) {
|
||||
leaveForGood()
|
||||
return
|
||||
}
|
||||
|
||||
autoRejoinCountRef.current += 1
|
||||
connectedAtRef.current = 0
|
||||
setJoinState(null)
|
||||
},
|
||||
[navigate, status],
|
||||
)
|
||||
|
||||
useEffect(() => {
|
||||
if (joinState || !slug) return
|
||||
@@ -110,6 +210,7 @@ export function RoomPage() {
|
||||
title: info.title,
|
||||
conferenceId: result.conference_id,
|
||||
chatEnabled: result.chat_enabled,
|
||||
handQueueEnabled: result.hand_queue_enabled,
|
||||
publishQualityCap: result.publish_quality_cap,
|
||||
stageMaxTiles: result.stage_max_tiles,
|
||||
})
|
||||
@@ -162,10 +263,16 @@ export function RoomPage() {
|
||||
const chatVisible = Boolean(joinState?.chatEnabled) && !chat.unavailable
|
||||
|
||||
// Identity участников с поднятой рукой — множеством, для дешёвого `.has()`
|
||||
// на каждой плитке сцены (см. `RoomParticipantTile`).
|
||||
// на каждой плитке сцены (см. `RoomParticipantTile`). Выключенный модуль
|
||||
// (`handQueueEnabled=false`) гасит и эти значки — иначе на плитке мог бы
|
||||
// повиснуть индикатор от руки, поднятой до отключения модуля (сервер
|
||||
// хранит очередь в Redis независимо от тоггла, см. `services/hand_queue.py`).
|
||||
const raisedHandIdentities = useMemo(
|
||||
() => new Set(chat.handQueue.map((entry) => entry.identity)),
|
||||
[chat.handQueue],
|
||||
() =>
|
||||
joinState?.handQueueEnabled
|
||||
? new Set(chat.handQueue.map((entry) => entry.identity))
|
||||
: new Set<string>(),
|
||||
[chat.handQueue, joinState?.handQueueEnabled],
|
||||
)
|
||||
|
||||
// Корневой контейнер комнаты — цель для fullscreen и источник video-элемента
|
||||
@@ -175,6 +282,73 @@ export function RoomPage() {
|
||||
const pip = useRoomPiP(roomRootRef)
|
||||
const [settingsOpen, setSettingsOpen] = useState(false)
|
||||
|
||||
// Топбар и тулбар в полноэкранном режиме — оверлей поверх сцены (см.
|
||||
// `.room-fullscreen-overlay` в room.css), а не часть потока: показываются
|
||||
// по тапу/клику по сцене вне элементов управления и прячутся сами через
|
||||
// FULLSCREEN_CONTROLS_AUTO_HIDE_MS бездействия. На десктопе есть ещё второй
|
||||
// способ показать их — навести мышь в нижнюю полосу экрана (без клика),
|
||||
// как в большинстве видеоплееров; клик остаётся основным способом на
|
||||
// тач-устройствах, где наведения не бывает. Обычный (не полноэкранный)
|
||||
// режим этот стейт не использует вовсе.
|
||||
const [fullscreenControlsVisible, setFullscreenControlsVisible] = useState(true)
|
||||
// Счётчик «попроси показать и отсчитать заново» — растёт на каждый клик/
|
||||
// наведение, даже если панель УЖЕ видима (иначе непрерывное наведение не
|
||||
// продлевало бы таймер: setState(true) поверх уже true не меняет состояние
|
||||
// и не перезапускает эффект ниже).
|
||||
const [fullscreenControlsTick, setFullscreenControlsTick] = useState(0)
|
||||
|
||||
// Показ при входе в полноэкранный режим — «подгонка состояния во время
|
||||
// рендера» (см. тот же приём у `chatSeenCount` выше), а не setState в теле
|
||||
// эффекта (react-hooks/set-state-in-effect): само планирование таймера
|
||||
// авто-скрытия — ниже, отдельным эффектом, и не вызывает setState
|
||||
// синхронно в своём теле.
|
||||
const [prevFullscreenActive, setPrevFullscreenActive] = useState(fullscreen.active)
|
||||
if (fullscreen.active !== prevFullscreenActive) {
|
||||
setPrevFullscreenActive(fullscreen.active)
|
||||
if (fullscreen.active) {
|
||||
setFullscreenControlsVisible(true)
|
||||
setFullscreenControlsTick((tick) => tick + 1)
|
||||
}
|
||||
}
|
||||
|
||||
useEffect(() => {
|
||||
if (!fullscreen.active || !fullscreenControlsVisible) return
|
||||
const timer = setTimeout(() => setFullscreenControlsVisible(false), FULLSCREEN_CONTROLS_AUTO_HIDE_MS)
|
||||
return () => clearTimeout(timer)
|
||||
}, [fullscreen.active, fullscreenControlsVisible, fullscreenControlsTick])
|
||||
|
||||
// Наведение мыши в нижнюю полосу экрана — только десктопный способ показать
|
||||
// элементы управления без клика; на тач-устройствах `mousemove` в таком виде
|
||||
// не приходит, слушатель им не вредит и не мешает.
|
||||
useEffect(() => {
|
||||
if (!fullscreen.active) return
|
||||
function handleMouseMove(e: MouseEvent) {
|
||||
if (window.innerHeight - e.clientY <= FULLSCREEN_FOOTER_HOVER_ZONE_PX) {
|
||||
setFullscreenControlsVisible(true)
|
||||
setFullscreenControlsTick((tick) => tick + 1)
|
||||
}
|
||||
}
|
||||
window.addEventListener('mousemove', handleMouseMove)
|
||||
return () => window.removeEventListener('mousemove', handleMouseMove)
|
||||
}, [fullscreen.active])
|
||||
|
||||
// Клик/тап по сцене переключает видимость — но не по элементам управления
|
||||
// внутри неё (кнопки плиток, булавка закрепления, «Показать остальных» и
|
||||
// т.п.: `closest` поднимается от места клика и гасит переключение, если
|
||||
// по дороге встретился интерактивный элемент) и не по открытой панели чата
|
||||
// (`.chat-panel` — та рендерится внутри того же `.room-main`, но клики по
|
||||
// тексту сообщений не должны прятать/показывать тулбар).
|
||||
const handleStageAreaClick = useCallback(
|
||||
(e: React.MouseEvent<HTMLDivElement>) => {
|
||||
if (!fullscreen.active) return
|
||||
const target = e.target as HTMLElement
|
||||
if (target.closest('button, a, input, select, textarea, [role="dialog"], .chat-panel')) return
|
||||
setFullscreenControlsVisible((visible) => !visible)
|
||||
setFullscreenControlsTick((tick) => tick + 1)
|
||||
},
|
||||
[fullscreen.active],
|
||||
)
|
||||
|
||||
// Вид сцены живёт здесь, а не в `RoomStage`: переключатели — в тулбаре и в
|
||||
// шторке настроек, а сцена их только читает (общий предок).
|
||||
//
|
||||
@@ -208,6 +382,12 @@ export function RoomPage() {
|
||||
// открывал мини-окно на самом пользователе. Подробнее — докстринг `RoomStage`.
|
||||
const [stageFocusKey, setStageFocusKey] = useState<string | null>(null)
|
||||
|
||||
// Закрепление участника (булавка на плитке) — по той же причине и тем же
|
||||
// мостиком, что и `stageFocusKey`: экземпляр `RoomStage` при открытии
|
||||
// мини-плеера пересоздаётся, и до 0.0.25 закрепление, сделанное в основном
|
||||
// окне, в мини-окно не попадало вовсе (там был свой чистый `useState`).
|
||||
const [stagePinnedKey, setStagePinnedKey] = useState<string | null>(null)
|
||||
|
||||
// Сохранённый выбор устройств — читаем через собственный вызов
|
||||
// usePersistentUserChoices (независимый от того, что использует
|
||||
// DeviceSettingsDialog: там свой вызов хука со своим состоянием). ВАЖНО:
|
||||
@@ -275,7 +455,7 @@ export function RoomPage() {
|
||||
}
|
||||
|
||||
return (
|
||||
<div data-theme="room" ref={roomRootRef}>
|
||||
<div data-theme="room" ref={roomRootRef} className={fullscreen.active ? 'room-fullscreen-overlay' : undefined}>
|
||||
<LiveKitRoom
|
||||
serverUrl={joinState.livekitUrl}
|
||||
token={joinState.token}
|
||||
@@ -283,11 +463,32 @@ export function RoomPage() {
|
||||
audio={false}
|
||||
video={false}
|
||||
options={roomOptions}
|
||||
onConnected={handleConnected}
|
||||
onDisconnected={handleDisconnected}
|
||||
>
|
||||
{/* Звук комнаты рендерится ЗДЕСЬ, а не внутри `RoomStage`, и ровно
|
||||
одним экземпляром на всю страницу. `RoomAudioRenderer` — это набор
|
||||
скрытых `<audio>`, к которым LiveKit привязывает чужие аудиотреки
|
||||
(`track.attach(el)`). Пока он жил в сцене, открытие мини-плеера
|
||||
переносило эти элементы в ДРУГОЙ документ (Document PiP — отдельное
|
||||
окно со своим `document`), а возврат — обратно, и после возврата
|
||||
звук чужих участников пропадал: Chrome теряет аудиовыход у
|
||||
remote-трека, переехавшего между документами. Замерено: пакеты
|
||||
продолжают приходить (`packetsReceived` растёт), а
|
||||
`totalSamplesDuration`/`totalAudioEnergy` замирают, и трек молчит
|
||||
даже в свежесозданном `<audio>` со свежим `MediaStream`. Тот же
|
||||
цикл detach/attach В ПРЕДЕЛАХ ОДНОГО документа безвреден — дело
|
||||
именно в переезде. Здесь элементы живут в основном документе
|
||||
непрерывно, весь цикл «открыл мини-окно → вернул» их не касается. */}
|
||||
<RoomAudioRenderer />
|
||||
<div data-lk-theme="default" className="room-shell">
|
||||
<RoomTopbar title={joinState.title ?? null} slug={slug} number={joinState.number} />
|
||||
<div className="room-main">
|
||||
<RoomTopbar
|
||||
title={joinState.title ?? null}
|
||||
slug={slug}
|
||||
number={joinState.number}
|
||||
overlayVisible={fullscreenControlsVisible}
|
||||
/>
|
||||
<div className="room-main" onClick={handleStageAreaClick}>
|
||||
{pip.mode === 'document' ? (
|
||||
// Сцена сейчас рисуется в PiP-окне (через createPortal ниже) —
|
||||
// основное окно вместо неё показывает заглушку с возвратом.
|
||||
@@ -306,6 +507,8 @@ export function RoomPage() {
|
||||
onHideOthers={() => setHideOthers(true)}
|
||||
initialFocusKey={stageFocusKey}
|
||||
onFocusKeyChange={setStageFocusKey}
|
||||
initialPinnedKey={stagePinnedKey}
|
||||
onPinnedKeyChange={setStagePinnedKey}
|
||||
onPinFocus={handlePinFocus}
|
||||
raisedHandIdentities={raisedHandIdentities}
|
||||
conferenceId={joinState.conferenceId}
|
||||
@@ -334,6 +537,7 @@ export function RoomPage() {
|
||||
pipSupported={pip.supported}
|
||||
pipActive={pip.active}
|
||||
onTogglePiP={pip.toggle}
|
||||
handQueueEnabled={Boolean(joinState.handQueueEnabled)}
|
||||
handQueue={chat.handQueue}
|
||||
onRaiseHand={chat.raiseHand}
|
||||
onLowerHand={() => chat.lowerHand()}
|
||||
@@ -342,6 +546,8 @@ export function RoomPage() {
|
||||
onLayoutModeChange={handleLayoutModeChange}
|
||||
hideOthers={hideOthers}
|
||||
onHideOthersChange={setHideOthers}
|
||||
overlayVisible={fullscreenControlsVisible}
|
||||
onLeave={handleLeaveClick}
|
||||
/>
|
||||
</div>
|
||||
{settingsOpen && (
|
||||
@@ -358,10 +564,17 @@ export function RoomPage() {
|
||||
`variant="pip"` — мини-плеер
|
||||
показывает только активное окно (одну плитку), без карусели/грида
|
||||
основного окна. `initialFocusKey` — то, что было крупно в основном
|
||||
окне: без него мини-окно открывалось на самом пользователе. */}
|
||||
окне: без него мини-окно открывалось на самом пользователе;
|
||||
`initialPinnedKey` — закрепление оттуда же. */}
|
||||
{pip.pipWindow &&
|
||||
createPortal(
|
||||
<RoomStage variant="pip" initialFocusKey={stageFocusKey} onFocusKeyChange={setStageFocusKey} />,
|
||||
<RoomStage
|
||||
variant="pip"
|
||||
initialFocusKey={stageFocusKey}
|
||||
onFocusKeyChange={setStageFocusKey}
|
||||
initialPinnedKey={stagePinnedKey}
|
||||
onPinnedKeyChange={setStagePinnedKey}
|
||||
/>,
|
||||
pip.pipWindow.document.body,
|
||||
)}
|
||||
<ForcedMuteWatcher event={chat.lastForcedMute} />
|
||||
|
||||
@@ -16,6 +16,11 @@
|
||||
position: relative;
|
||||
overflow: hidden;
|
||||
border-right: 1px solid var(--color-border);
|
||||
/* Запрос по ширине САМОЙ панели, а не окна: `.layout` — flex 42/58, и на
|
||||
широком окне с узкой панелью `vw` (см. .brand-headline) не отражает
|
||||
реальную доступную ширину — тот же паттерн, что у `.room-tile-avatar`
|
||||
(container-type:size + cqmin, room.css) для аватара участника. */
|
||||
container-type: inline-size;
|
||||
}
|
||||
.brand-panel::after {
|
||||
content: "";
|
||||
@@ -41,6 +46,12 @@
|
||||
.brand-headline {
|
||||
font: var(--text-display-lg);
|
||||
font-family: var(--font-display);
|
||||
/* `cqw` — от ширины `.brand-panel` (её `container-type: inline-size` выше),
|
||||
а не окна: длинное слово «инфраструктура» иначе не помещается именно
|
||||
тогда, когда окно широкое, а панель (42% от него) — узкая. Раньше кегль
|
||||
уменьшался только в @media по ширине ОКНА (узкие экраны) — не спасало
|
||||
от этого случая. */
|
||||
font-size: clamp(20px, 8cqw, 34px);
|
||||
color: var(--color-ink-700);
|
||||
margin: 0 0 var(--space-4);
|
||||
max-width: 460px;
|
||||
@@ -51,7 +62,11 @@
|
||||
max-width: 420px;
|
||||
margin: 0;
|
||||
}
|
||||
.brand-stats { display: flex; gap: var(--space-4); z-index: 1; margin-top: var(--space-8); }
|
||||
/* `flex-wrap` не только на мобильном медиа-запросе (см. ниже) — та же
|
||||
природа бага, что у заголовка: узкая ПАНЕЛЬ (а не узкое окно) не даёт
|
||||
двум плашкам поместиться в ряд, а `overflow:hidden` у `.brand-panel`
|
||||
обрезал вторую вместо переноса. */
|
||||
.brand-stats { display: flex; flex-wrap: wrap; gap: var(--space-4); z-index: 1; margin-top: var(--space-8); }
|
||||
.stat-glass {
|
||||
background: var(--color-surface-glass);
|
||||
backdrop-filter: blur(16px);
|
||||
@@ -248,10 +263,10 @@
|
||||
right: -90px;
|
||||
bottom: -90px;
|
||||
}
|
||||
/* clamp() — на узких экранах слово «инфраструктура» иначе вылезает за
|
||||
край брендовой панели (см. .brand-panel padding ниже и её overflow:hidden,
|
||||
обрезающий текст без переноса вместо уменьшения кегля). */
|
||||
.brand-headline { max-width: none; font-size: clamp(22px, 6.2vw, 34px); }
|
||||
/* Кегль теперь считает `.brand-headline` сама (cqw от ширины панели, см.
|
||||
базовое правило) — здесь снимаем только `max-width:460px`: в сложенной
|
||||
колонкой раскладке панель может стать шире 460px, а дизайн этого хочет. */
|
||||
.brand-headline { max-width: none; }
|
||||
.brand-sub { max-width: none; }
|
||||
.brand-stats { flex-wrap: wrap; }
|
||||
.stat-glass { flex: 1 1 140px; min-width: 0; }
|
||||
|
||||
@@ -133,18 +133,40 @@ video[data-lk-source='screen_share'] { object-fit: contain; background: #000; }
|
||||
* `.stage-tiles` в основном окне) плюс подстраховочный `min-height`, чтобы
|
||||
* плитка не схлопывалась, если видео ещё не выдало реальные размеры.
|
||||
*/
|
||||
.room-single-tile { position: relative; flex: 1; min-height: 0; display: flex; }
|
||||
.room-single-tile {
|
||||
position: relative;
|
||||
flex: 1;
|
||||
min-height: 0;
|
||||
display: flex;
|
||||
/* Ширина ряда кнопок мини-плеера (`.room-pip-controls`): две круглые кнопки
|
||||
по 36px плюс зазор. Живёт на общем предке, а не на самом ряду, потому что
|
||||
от неё считается и отступ плашки с именем участника — иначе подпись
|
||||
(«Второй участник — демонстрация экрана») уезжает ПОД кнопки. Появится
|
||||
третья кнопка — правится одно число, а не два места. */
|
||||
--room-pip-controls-width: calc(2 * 36px + 0.375rem);
|
||||
}
|
||||
.room-single-tile .lk-participant-tile { flex: 1; min-height: 220px; width: 100%; }
|
||||
/* Библиотечная плашка с именем прижата к обоим нижним углам (`left: 4px;
|
||||
right: 4px`) и потому начинается ровно там, где лежат наши кнопки. Сдвигаем
|
||||
её содержимое вправо на ширину ряда — сама плашка прозрачная, подпись внутри
|
||||
со своим фоном, так что двигать надо именно отступ, а не `left`. */
|
||||
.room-single-tile .lk-participant-metadata { padding-left: var(--room-pip-controls-width); }
|
||||
|
||||
/* Кнопка микрофона мини-плеера (задача A5) — своего тулбара в PiP нет,
|
||||
кнопка лежит поверх единственной плитки левым нижним углом (правый занят
|
||||
штатным `.lk-focus-toggle-button`/нашей булавкой закрепления — тут её нет,
|
||||
в PiP закреплять нечего, но геометрия зеркалит `.room-pin-toggle`). */
|
||||
.room-pip-mic-toggle {
|
||||
/* Кнопки мини-плеера (микрофон — задача A5, демонстрация экрана — 0.0.29):
|
||||
своего тулбара в PiP нет, кнопки лежат поверх единственной плитки левым
|
||||
нижним углом (правый занят штатным `.lk-focus-toggle-button`/нашей булавкой
|
||||
закрепления — тут её нет, в PiP закреплять нечего, но геометрия зеркалит
|
||||
`.room-pin-toggle`). Ряд, а не две абсолютно спозиционированные кнопки:
|
||||
так добавление третьей не потребует пересчёта координат. */
|
||||
.room-pip-controls {
|
||||
position: absolute;
|
||||
left: 0.5rem;
|
||||
bottom: 0.5rem;
|
||||
z-index: 5;
|
||||
display: flex;
|
||||
gap: 0.375rem;
|
||||
}
|
||||
.room-pip-btn {
|
||||
width: 36px;
|
||||
height: 36px;
|
||||
border-radius: 50%;
|
||||
@@ -152,12 +174,16 @@ video[data-lk-source='screen_share'] { object-fit: contain; background: #000; }
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
background: var(--color-room-mic-on);
|
||||
color: #10331f;
|
||||
cursor: pointer;
|
||||
}
|
||||
.room-pip-mic-toggle svg { width: 18px; height: 18px; }
|
||||
.room-pip-btn svg { width: 18px; height: 18px; }
|
||||
.room-pip-mic-toggle { background: var(--color-room-mic-on); color: #10331f; }
|
||||
.room-pip-mic-toggle.is-off { background: var(--color-room-danger-bg); color: #fff; }
|
||||
/* Демонстрация — «выключено» это нейтральное состояние (не тревога, в отличие
|
||||
от снятого микрофона), поэтому неактивная кнопка тёмная под цвет плитки, а
|
||||
активная подсвечена тем же зелёным, что включённый микрофон. */
|
||||
.room-pip-share-toggle { background: var(--color-room-tile-hover); color: var(--color-room-text-primary); }
|
||||
.room-pip-share-toggle.is-on { background: var(--color-room-mic-on); color: #10331f; }
|
||||
|
||||
/*
|
||||
* ---------- Колонка миниатюр (кнопка «Скрыть» + карусель) ----------
|
||||
@@ -497,8 +523,14 @@ video[data-lk-source='screen_share'] { object-fit: contain; background: #000; }
|
||||
|
||||
.chat-empty { font: var(--text-body); color: var(--color-room-text-tertiary); margin: auto; text-align: center; }
|
||||
|
||||
/* `min-height: 0` обязателен — тот же приём, что у `.stage-side` (комментарий
|
||||
выше): без него `.chat-panel` (flex-колонка) в Firefox не сжимает
|
||||
`.chat-messages` до высоты `flex:1`, а даёт ей вырасти по контенту
|
||||
(список сообщений) и вылезти за пределы панели — Chrome в этой ситуации
|
||||
более снисходителен, Firefox — нет. */
|
||||
.chat-messages {
|
||||
flex: 1;
|
||||
min-height: 0;
|
||||
overflow-y: auto;
|
||||
padding: var(--space-5);
|
||||
display: flex;
|
||||
@@ -540,6 +572,13 @@ video[data-lk-source='screen_share'] { object-fit: contain; background: #000; }
|
||||
}
|
||||
.chat-input-row textarea {
|
||||
flex: 1;
|
||||
/* Firefox даёт `<textarea>` большую автоматическую минимальную ширину,
|
||||
завязанную на атрибут `cols` (умолчание 20 символов моноширинной
|
||||
метрики), и как flex-item без `min-width:0` отказывается сжиматься
|
||||
ниже нее — панель шириной 320px раздувается вправо. Chrome/Safari
|
||||
считают минимальную ширину textarea мягче, поэтому баг был виден
|
||||
только в Firefox. */
|
||||
min-width: 0;
|
||||
resize: none;
|
||||
background: var(--color-room-tile);
|
||||
border: 1px solid var(--color-room-tile-border);
|
||||
@@ -592,13 +631,18 @@ video[data-lk-source='screen_share'] { object-fit: contain; background: #000; }
|
||||
.chat-emoji-wrap .chat-emoji-trigger:disabled { opacity: 0.5; cursor: default; }
|
||||
|
||||
/* 5 колонок × 6 строк — ровно 30 эмодзи в EMOJI_OPTIONS (ChatPanel.tsx), без
|
||||
неполной последней строки. */
|
||||
неполной последней строки. `max-width` — страховка на случай совсем узкого
|
||||
viewport: фикс-ширина 220px без потолка сама по себе не переполняется при
|
||||
текущей раскладке (триггер у левого края панели, попап растёт вправо в
|
||||
свободное место — проверено геометрией и вживую), но фиксированный размер
|
||||
совсем без ограничителя — плохая практика сама по себе. */
|
||||
.chat-emoji-popover {
|
||||
position: absolute;
|
||||
bottom: calc(100% + var(--space-2));
|
||||
left: 0;
|
||||
z-index: 50;
|
||||
width: 220px;
|
||||
max-width: calc(100vw - 2 * var(--space-4));
|
||||
display: grid;
|
||||
grid-template-columns: repeat(5, 1fr);
|
||||
gap: 4px;
|
||||
@@ -609,14 +653,30 @@ video[data-lk-source='screen_share'] { object-fit: contain; background: #000; }
|
||||
box-shadow: var(--shadow-room-panel);
|
||||
}
|
||||
.chat-emoji-popover .chat-emoji-option {
|
||||
/* Настоящая причина переполнения (найдена по факту, не по догадке —
|
||||
`getBoundingClientRect` показал кнопки 42×42px при колонке ~36px):
|
||||
`.chat-input-row button` (специфичность 0,1,1) задаёт ВСЕМ кнопкам
|
||||
формы `width/height: 42px` — это правило круглой кнопки «Отправить»,
|
||||
а кнопки эмодзи в поповере тоже лежат внутри `.chat-input-row`
|
||||
(см. комментарий выше про гонку специфичности, она чинилась для
|
||||
цвета в 0.0.19, но не для размера). Без явного `width`/`height` здесь
|
||||
побеждает тот 42px, сетка на 5 колонок раздувается за 220px попапа,
|
||||
и последняя колонка уезжает вправо за рамку. `min-width: 0` сам по
|
||||
себе НЕ помогает — конфликт не в авто-минимуме грида, а в explicit
|
||||
width, который обязательно нужно перебить явно. */
|
||||
width: auto;
|
||||
height: auto;
|
||||
min-width: 0;
|
||||
aspect-ratio: 1;
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: center;
|
||||
overflow: hidden;
|
||||
background: none;
|
||||
border: none;
|
||||
font-size: 20px;
|
||||
line-height: 1;
|
||||
white-space: nowrap;
|
||||
border-radius: var(--radius-md);
|
||||
cursor: pointer;
|
||||
}
|
||||
@@ -769,10 +829,16 @@ video[data-lk-source='screen_share'] { object-fit: contain; background: #000; }
|
||||
* Тот же диалог (`DeviceSettingsDialog`), что модалка выше, — только контейнер
|
||||
* снизу вместо центра экрана: `.room-sheet-overlay`/`.room-sheet-panel` вместо
|
||||
* `.room-modal-overlay`/`.room-modal-panel`, разметка полей (`.room-field` и
|
||||
* ниже) общая. Ручка `.room-sheet-handle` — свайп вниз для закрытия (JS считает
|
||||
* смещение пальца и сам решает, закрывать или вернуть панель на место;
|
||||
* `transition` тут — только пружина возврата, во время самого драга
|
||||
* компонент подставляет инлайновый `transition: none`).
|
||||
* ниже) общая. Свайп вниз для закрытия — JS на самой панели (не на ручке —
|
||||
* см. докстринг `DeviceSettingsDialog`) считает смещение пальца и сам решает,
|
||||
* закрывать или вернуть панель на место; `transition` тут — только пружина
|
||||
* возврата, во время самого драга компонент подставляет инлайновый
|
||||
* `transition: none`. `overscroll-behavior-y: contain` — чтобы при свайпе
|
||||
* вниз от самого верха списка устройств iOS/Chrome не показывали заодно
|
||||
* ещё и нативный эффект растяжения скролла поверх нашей анимации панели.
|
||||
* Ручка `.room-sheet-handle` — теперь чисто визуальная подсказка (сама
|
||||
* панель ловит жест где угодно), `touch-action: none` на ней оставлен —
|
||||
* безвредно и снимает системные жесты с этой узкой полоски.
|
||||
*/
|
||||
.room-sheet-overlay {
|
||||
position: fixed;
|
||||
@@ -793,6 +859,7 @@ video[data-lk-source='screen_share'] { object-fit: contain; background: #000; }
|
||||
width: 100%;
|
||||
max-height: 80vh;
|
||||
overflow-y: auto;
|
||||
overscroll-behavior-y: contain;
|
||||
transition: transform 160ms ease-out;
|
||||
}
|
||||
.room-sheet-handle {
|
||||
@@ -1047,22 +1114,79 @@ video[data-lk-source='screen_share'] { object-fit: contain; background: #000; }
|
||||
в самой конференции, а вот чип «№ … / Пригласить» с телефона нужен чаще
|
||||
(скопировать ссылку и позвать участника), поэтому он остаётся.
|
||||
|
||||
Тулбар: демонстрация экрана, полноэкранный режим и мини-окно с телефона
|
||||
практически не нужны, а все 8 кнопок в ширину экрана физически не
|
||||
помещаются — скрываем их и уплотняем оставшиеся пять
|
||||
(микрофон/камера/устройства/чат/выход). `flex-wrap` + `min-width: 0` —
|
||||
страховка на совсем узких экранах, чтобы футер ни при каких подписях не
|
||||
вылезал за ширину окна. */
|
||||
Тулбар: демонстрация экрана и мини-окно с телефона практически не нужны —
|
||||
скрыты. Полноэкранный режим ОСТАЁТСЯ виден, как на десктопе (решение
|
||||
оператора 03.08: вход в него — по аналогии с десктопным приложением, не
|
||||
спрятан в шторку настроек) — вместе с «Рукой» (0.0.16) и опциональными
|
||||
«Очередью» (только организатору)/«Чатом» на мобильном может набраться до
|
||||
7–8 кнопок разом, в один ряд по 360px они уже не помещаются.
|
||||
`.room-toolbar.tb-wrap-grid` — класс считает JS (`RoomToolbar.tsx`, по
|
||||
фактическому числу видимых на мобильном кнопок, а не селекторами
|
||||
`:nth-child` — организатору достаётся ДОПОЛНИТЕЛЬНАЯ обёртка
|
||||
`.tb-menu-wrap` вокруг кнопки «Очередь», из-за неё позиция по DOM «плывёт»)
|
||||
— переключает раскладку на равномерную сетку 4 колонки: 7 кнопок ложатся
|
||||
4+3, 8 — 4+4, а не как получится через `flex-wrap` (например 6+1, если
|
||||
просто позволить браузеру перенести лишние). До 6 кнопок раскладка —
|
||||
обычный flex, они влезают в 360px одним рядом без переноса вовсе. */
|
||||
@media (max-width: 600px) {
|
||||
.room-topbar { padding: var(--space-3) var(--space-4); justify-content: flex-end; }
|
||||
.room-title-block { display: none; }
|
||||
|
||||
.tb-btn--screenshare,
|
||||
.tb-btn--fullscreen,
|
||||
.tb-btn--pip { display: none; }
|
||||
|
||||
.room-toolbar { padding: var(--space-3) var(--space-2); gap: 2px; flex-wrap: wrap; }
|
||||
.room-toolbar.tb-wrap-grid { display: grid; grid-template-columns: repeat(4, 1fr); justify-items: center; }
|
||||
.tb-btn { min-width: 0; padding: 6px 6px; }
|
||||
.tb-btn .icon-shell { width: 40px; height: 40px; }
|
||||
.tb-btn span.label { font-size: 11px; }
|
||||
}
|
||||
|
||||
/*
|
||||
* ---------- Полноэкранный режим: топбар и тулбар прячутся в оверлей ----------
|
||||
* Работает на ЛЮБОЙ ширине экрана (не только мобильной) — как только
|
||||
* `document.fullscreenElement`, корневой контейнер комнаты получает класс
|
||||
* `.room-fullscreen-overlay` (`RoomPage.tsx`, вместе с `useFullscreen`).
|
||||
* Топбар и тулбар выходят из flow-потока `.room-shell` — единственный
|
||||
* оставшийся в потоке `.room-main` (`flex: 1`) сам растягивается на всю
|
||||
* высоту, отдельного правила не нужно — и ложатся оверлеем поверх сцены
|
||||
* сверху/снизу. Появляются по клику/тапу вне элементов управления
|
||||
* (`RoomPage.tsx`, `handleStageAreaClick`) или — на десктопе — при наведении
|
||||
* мыши в нижнюю полосу экрана (`FULLSCREEN_FOOTER_HOVER_ZONE_PX`), прячутся
|
||||
* по повторному клику или сами через `FULLSCREEN_CONTROLS_AUTO_HIDE_MS`
|
||||
* бездействия.
|
||||
*
|
||||
* z-index 150 — выше сцены, но НИЖЕ модалки/шторки настроек (200): если из
|
||||
* уже открытого оверлея снова открыть «Настройки», диалог должен лечь
|
||||
* поверх тулбара, а не под него.
|
||||
*
|
||||
* Кнопка «Экран» (выход) на мобильном видна и без полноэкранного режима
|
||||
* (см. блок выше — по аналогии с десктопом), поэтому здесь её отдельно
|
||||
* возвращать не нужно.
|
||||
*/
|
||||
.room-fullscreen-overlay .room-topbar {
|
||||
position: fixed;
|
||||
top: 0;
|
||||
left: 0;
|
||||
right: 0;
|
||||
z-index: 150;
|
||||
background: rgba(20, 22, 26, 0.92);
|
||||
backdrop-filter: blur(8px);
|
||||
transform: translateY(-100%);
|
||||
transition: transform 200ms ease-out;
|
||||
}
|
||||
.room-fullscreen-overlay .room-topbar.is-visible { transform: translateY(0); }
|
||||
|
||||
.room-fullscreen-overlay .room-toolbar {
|
||||
position: fixed;
|
||||
left: 0;
|
||||
right: 0;
|
||||
bottom: 0;
|
||||
z-index: 150;
|
||||
background: rgba(20, 22, 26, 0.92);
|
||||
backdrop-filter: blur(8px);
|
||||
padding-bottom: calc(var(--space-3) + env(safe-area-inset-bottom));
|
||||
transform: translateY(100%);
|
||||
transition: transform 200ms ease-out;
|
||||
}
|
||||
.room-fullscreen-overlay .room-toolbar.is-visible { transform: translateY(0); }
|
||||
|
||||
Reference in New Issue
Block a user