release: версия 0.0.7

На ширине ≤600px (брейкпоинт комнаты) DeviceSettingsDialog рендерит те же
поля не модалкой по центру, а шторкой снизу (`room-sheet-overlay`/
`room-sheet-panel`) — по образцу решения оператора: так быстрее и привычнее
с телефона. Десктоп не меняется.

Закрытие — клик вне панели (было и раньше), Escape и возврат фокуса через
существующий useModalDismiss, и свайп вниз за ручку (JS считает смещение
пальца и либо закрывает панель, либо возвращает её на место пружиной).

.env.example

@@ -98,7 +98,7 @@ SMTP_TIMEOUT_S=30
 # --- Версия инстанса (релиз v0.0.1) ---
 # install.sh копирует значение из корневого файла VERSION при каждой
 # установке/обновлении — руками менять не нужно.
-VIDCONF_VERSION=0.0.6
+VIDCONF_VERSION=0.0.7
 
 # --- Профили compose. Дефолт ниже (`media,monitoring`) — только для ручного
 # `docker compose up` БЕЗ install.sh: медиа (LiveKit+coturn) + мониторинг,

CHANGELOG.md

@@ -3,6 +3,27 @@
 Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/),
 проект придерживается [семантического версионирования](https://semver.org/lang/ru/).
 
+## [0.0.7] — 2026-07-27
+
+Настройки устройств: выбор аудиовывода и компактная шторка на мобильном.
+
+### Добавлено
+- Выбор устройства аудиовывода (динамики/наушники/Bluetooth-гарнитура) в
+  «Настройках устройств» рядом с микрофоном и камерой. Выбор переживает
+  перезаход в комнату. Список показывается только там, где браузер умеет
+  им управлять (Android Chrome и другие Chromium на десктопе/мобильном);
+  в iOS Safari поддержки нет вовсе — вместо списка короткая подсказка, что
+  переключение звука там на стороне системы.
+- На мобильной ширине «Настройки устройств» открываются компактной шторкой
+  снизу вместо модалки по центру экрана — закрывается свайпом вниз, тапом
+  вне панели или Escape. На десктопе поведение не изменилось.
+
+### Примечания по эксплуатации
+- Управлять маршрутизацией звука (принудительно включить громкую связь или
+  перекинуть звук на Bluetooth) из браузера нельзя в принципе — это делает
+  ОС, веб-страница может только выбрать устройство вывода там, где браузер
+  это позволяет (`setSinkId`).
+
 ## [0.0.6] — 2026-07-27
 
 Управление фокусом основного окна конференции: участника можно закрепить, а
@@ -162,6 +183,7 @@
 
 Первоначальная версия VidConf.
 
+[0.0.7]: https://github.com/MaxRonzhin/vidconf_rel/releases/tag/v0.0.7
 [0.0.6]: https://github.com/MaxRonzhin/vidconf_rel/releases/tag/v0.0.6
 [0.0.5]: https://github.com/MaxRonzhin/vidconf_rel/releases/tag/v0.0.5
 [0.0.4]: https://github.com/MaxRonzhin/vidconf_rel/releases/tag/v0.0.4

VERSION

@@ -1 +1 @@
-0.0.6
+0.0.7

deploy/docker-compose.yml

@@ -82,7 +82,7 @@ services:
       MEDIA_ROOT: ${MEDIA_ROOT:-/app/media}
       # Версия инстанса (релиз v0.0.1) — install.sh копирует значение
       # из файла VERSION (корень репозитория) в .env; отдаётся в GET /api/health.
-      VIDCONF_VERSION: ${VIDCONF_VERSION:-0.0.6}
+      VIDCONF_VERSION: ${VIDCONF_VERSION:-0.0.7}
     # config/ лежит в корне репозитория и не попадает в образ (контекст сборки —
     # только backend/), поэтому plugins.yaml монтируется отдельно.
     volumes:

frontend/src/components/room/DeviceSettingsDialog.tsx

@@ -1,23 +1,51 @@
+import { useEffect, useRef, useState } from 'react'
 import { X } from 'lucide-react'
 import { useMediaDeviceSelect, usePersistentUserChoices } from '@livekit/components-react'
 import { useToast } from '@/components/ui/ToastProvider'
+import { useModalDismiss } from '@/hooks/useModalDismiss'
+import { isAudioOutputSelectable, saveAudioOutputDeviceId } from '@/lib/audioOutputDevice'
 
 interface DeviceSettingsDialogProps {
   onClose: () => void
 }
 
+/** Совпадает с мобильным брейкпоинтом комнаты (`room.css`, `max-width: 600px`) — ниже него панель рендерится шторкой снизу вместо модалки. */
+const COMPACT_VIEWPORT_QUERY = '(max-width: 600px)'
+/** Свайп ручки шторки вниз дальше этого порога (px) закрывает панель, меньше — она возвращается на место. */
+const SHEET_DISMISS_THRESHOLD_PX = 80
+
 /** Человекочитаемая подпись пункта списка устройств — `label` пуст, пока нет разрешения на медиа. */
 function deviceLabel(device: MediaDeviceInfo, index: number, fallback: string): string {
   return device.label || `${fallback} ${index + 1}`
 }
 
+/** Живое отслеживание мобильной ширины — та же схема, что системная тема в `useTheme.ts` (matchMedia + change-листенер). */
+function useIsCompactViewport(): boolean {
+  const [isCompact, setIsCompact] = useState(() => window.matchMedia(COMPACT_VIEWPORT_QUERY).matches)
+
+  useEffect(() => {
+    const media = window.matchMedia(COMPACT_VIEWPORT_QUERY)
+    const handleChange = (event: MediaQueryListEvent) => setIsCompact(event.matches)
+    media.addEventListener('change', handleChange)
+    return () => media.removeEventListener('change', handleChange)
+  }, [])
+
+  return isCompact
+}
+
 /**
- * Диалог «Настройки устройств» — два селекта
- * на хуках `@livekit/components-react`: список устройств и переключение —
- * целиком в `useMediaDeviceSelect` (сама подписана на
- * `RoomEvent.MediaDevicesChanged`), персист выбора — в `usePersistentUserChoices`
- * (localStorage, читается заново при следующем входе в комнату — см.
- * `RoomPage.tsx`, `options` пропс `LiveKitRoom`).
+ * Панель «Настройки устройств» — три селекта на хуках `@livekit/components-react`:
+ * список устройств и переключение целиком в `useMediaDeviceSelect` (сама
+ * подписана на `RoomEvent.MediaDevicesChanged`), персист выбора микрофона/камеры —
+ * в `usePersistentUserChoices` (localStorage, читается заново при следующем
+ * входе в комнату — см. `RoomPage.tsx`, `options` пропс `LiveKitRoom`).
+ * Аудиовыход персистится отдельно (`lib/audioOutputDevice.ts`) — `LocalUserChoices`
+ * LiveKit про него не знает, а `RoomOptions.audioOutput` читает сохранённый
+ * `deviceId` при следующем подключении.
+ *
+ * На мобильной ширине (`useIsCompactViewport`) рендерится шторкой снизу вместо
+ * модалки — по клику вне, Escape (`useModalDismiss`) и свайпу вниз за ручку.
+ * Десктоп не меняется.
  *
  * ДОЛЖЕН рендериться внутри `<LiveKitRoom>`: `useMediaDeviceSelect` без явно
  * переданного `room` берёт активную комнату из `RoomContext` — вне контекста
@@ -29,6 +57,15 @@ export function DeviceSettingsDialog({ onClose }: DeviceSettingsDialogProps) {
   const { saveAudioInputDeviceId, saveVideoInputDeviceId } = usePersistentUserChoices()
   const mic = useMediaDeviceSelect({ kind: 'audioinput' })
   const camera = useMediaDeviceSelect({ kind: 'videoinput' })
+  const speaker = useMediaDeviceSelect({ kind: 'audiooutput' })
+  const speakerSelectable = isAudioOutputSelectable()
+  const isCompact = useIsCompactViewport()
+
+  useModalDismiss(onClose)
+
+  const dragStartYRef = useRef<number | null>(null)
+  const [dragOffset, setDragOffset] = useState(0)
+  const [isDragging, setIsDragging] = useState(false)
 
   async function handleMicChange(deviceId: string) {
     try {
@@ -49,15 +86,62 @@ export function DeviceSettingsDialog({ onClose }: DeviceSettingsDialogProps) {
     }
   }
 
+  async function handleSpeakerChange(deviceId: string) {
+    try {
+      await speaker.setActiveMediaDevice(deviceId)
+      saveAudioOutputDeviceId(deviceId)
+    } catch {
+      toast.show('Не удалось переключить вывод звука — устройство занято или отключено', 'error')
+    }
+  }
+
+  function handleHandleTouchStart(e: React.TouchEvent<HTMLDivElement>) {
+    dragStartYRef.current = e.touches[0].clientY
+    setIsDragging(true)
+  }
+
+  function handleHandleTouchMove(e: React.TouchEvent<HTMLDivElement>) {
+    if (dragStartYRef.current === null) return
+    const delta = e.touches[0].clientY - dragStartYRef.current
+    if (delta > 0) setDragOffset(delta)
+  }
+
+  function handleHandleTouchEnd() {
+    if (dragOffset > SHEET_DISMISS_THRESHOLD_PX) {
+      onClose()
+      return
+    }
+    dragStartYRef.current = null
+    setIsDragging(false)
+    setDragOffset(0)
+  }
+
   return (
     <div
-      className="room-modal-overlay"
+      className={isCompact ? 'room-sheet-overlay' : 'room-modal-overlay'}
       role="dialog"
       aria-modal="true"
       aria-labelledby="device-settings-title"
       onClick={onClose}
     >
-      <div className="room-modal-panel" onClick={(e) => e.stopPropagation()}>
+      <div
+        className={isCompact ? 'room-sheet-panel' : 'room-modal-panel'}
+        onClick={(e) => e.stopPropagation()}
+        style={
+          isCompact && dragOffset
+            ? { transform: `translateY(${dragOffset}px)`, transition: isDragging ? 'none' : undefined }
+            : undefined
+        }
+      >
+        {isCompact && (
+          <div
+            className="room-sheet-handle"
+            onTouchStart={handleHandleTouchStart}
+            onTouchMove={handleHandleTouchMove}
+            onTouchEnd={handleHandleTouchEnd}
+          />
+        )}
+
         <div className="room-modal-head">
           <h2 id="device-settings-title">Настройки устройств</h2>
           <button type="button" className="room-modal-close" aria-label="Закрыть" onClick={onClose}>
@@ -104,6 +188,34 @@ export function DeviceSettingsDialog({ onClose }: DeviceSettingsDialogProps) {
             ))}
           </select>
         </div>
+
+        {speakerSelectable ? (
+          <div className="room-field">
+            <label htmlFor="device-settings-speaker">Динамики</label>
+            <select
+              id="device-settings-speaker"
+              value={speaker.activeDeviceId}
+              onChange={(e) => void handleSpeakerChange(e.target.value)}
+            >
+              <option value="" disabled>
+                Определяется…
+              </option>
+              {speaker.devices.map((device, index) => (
+                <option key={device.deviceId} value={device.deviceId}>
+                  {deviceLabel(device, index, 'Динамик')}
+                </option>
+              ))}
+            </select>
+          </div>
+        ) : (
+          <div className="room-field">
+            <span className="room-field-label">Динамики</span>
+            <p className="room-field-hint">
+              Вывод звука (динамик, наушники, Bluetooth) переключается средствами системы — этот
+              браузер не позволяет управлять им со страницы.
+            </p>
+          </div>
+        )}
       </div>
     </div>
   )

frontend/src/lib/audioOutputDevice.ts

@@ -0,0 +1,33 @@
+const STORAGE_KEY = 'vidconf-audio-output-device'
+
+/**
+ * Поддержка выбора устройства аудиовывода — определяем по наличию
+ * `setSinkId` в рантайме, НЕ по User-Agent: в iOS Safari метода нет вообще
+ * (маршрутизация звука там целиком на стороне ОС), в Android Chrome есть.
+ */
+export function isAudioOutputSelectable(): boolean {
+  return typeof HTMLMediaElement !== 'undefined' && 'setSinkId' in HTMLMediaElement.prototype
+}
+
+/**
+ * Персист выбранного устройства вывода — отдельно от `usePersistentUserChoices`
+ * LiveKit: их `LocalUserChoices` знает только про вход (микрофон/камера),
+ * поля для аудиовыхода там нет.
+ */
+export function loadAudioOutputDeviceId(): string {
+  try {
+    return localStorage.getItem(STORAGE_KEY) ?? ''
+  } catch {
+    // localStorage недоступен (приватный режим/политики браузера) — без
+    // сохранённого выбора, устройство по умолчанию.
+    return ''
+  }
+}
+
+export function saveAudioOutputDeviceId(deviceId: string): void {
+  try {
+    localStorage.setItem(STORAGE_KEY, deviceId)
+  } catch {
+    // Сохранение недоступно — выбор продержится до конца сессии в комнате.
+  }
+}

frontend/src/pages/RoomPage.tsx

@@ -17,6 +17,7 @@ import { RoomStage } from '@/components/room/RoomStage'
 import { RoomToolbar } from '@/components/room/RoomToolbar'
 import { ChatPanel } from '@/components/room/ChatPanel'
 import { DeviceSettingsDialog } from '@/components/room/DeviceSettingsDialog'
+import { loadAudioOutputDeviceId } from '@/lib/audioOutputDevice'
 
 interface RoomJoinState {
   livekitUrl: string
@@ -163,6 +164,12 @@ export function RoomPage() {
     () => ({
       audioCaptureDefaults: { deviceId: userChoices.audioDeviceId || undefined },
       videoCaptureDefaults: { deviceId: userChoices.videoDeviceId || undefined },
+      // Аудиовыход (колонки/наушники/bluetooth) — отдельный персист, не через
+      // usePersistentUserChoices: LocalUserChoices LiveKit про него не знает
+      // (см. lib/audioOutputDevice.ts). Читаем один раз при монтировании —
+      // как и с audio/videoDeviceId, смена применяется через DeviceSettingsDialog
+      // (setActiveMediaDevice), а не пересозданием roomOptions.
+      audioOutput: { deviceId: loadAudioOutputDeviceId() || undefined },
     }),
     [userChoices],
   )

frontend/src/styles/room.css

@@ -378,6 +378,48 @@ video[data-lk-source='screen_share'] { object-fit: contain; background: #000; }
   font-family: var(--font-body);
 }
 .room-field select:focus { outline: none; border-color: var(--color-room-focus-ring); }
+.room-field-label { display: block; font: var(--text-body); font-weight: 600; color: var(--color-room-text-primary); margin-bottom: var(--space-2); }
+.room-field-hint { font: var(--text-body); color: var(--color-room-text-secondary); margin: 0; }
+
+/*
+ * ---------- Шторка «Настройки устройств» на мобильном ----------
+ * Тот же диалог (`DeviceSettingsDialog`), что модалка выше, — только контейнер
+ * снизу вместо центра экрана: `.room-sheet-overlay`/`.room-sheet-panel` вместо
+ * `.room-modal-overlay`/`.room-modal-panel`, разметка полей (`.room-field` и
+ * ниже) общая. Ручка `.room-sheet-handle` — свайп вниз для закрытия (JS считает
+ * смещение пальца и сам решает, закрывать или вернуть панель на место;
+ * `transition` тут — только пружина возврата, во время самого драга
+ * компонент подставляет инлайновый `transition: none`).
+ */
+.room-sheet-overlay {
+  position: fixed;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.55);
+  display: flex;
+  align-items: flex-end;
+  justify-content: center;
+  z-index: 200;
+}
+.room-sheet-panel {
+  background: var(--color-room-surface-raised);
+  border: 1px solid var(--color-room-tile-border);
+  border-bottom: none;
+  border-radius: var(--radius-lg) var(--radius-lg) 0 0;
+  box-shadow: var(--shadow-room-panel);
+  padding: var(--space-4) var(--space-6) calc(var(--space-6) + env(safe-area-inset-bottom));
+  width: 100%;
+  max-height: 80vh;
+  overflow-y: auto;
+  transition: transform 160ms ease-out;
+}
+.room-sheet-handle {
+  width: 40px;
+  height: 4px;
+  border-radius: 2px;
+  background: var(--color-room-tile-border);
+  margin: 0 auto var(--space-4);
+  touch-action: none;
+}
 
 /*
  * ---------- Чип «Вы демонстрируете экран» ----------