Устройства macOS: экспериментальный API
Включите WUI_ENABLE_MEDIA=ON в CMake и линкуйте приложение с wui.
Заголовок — wui/media/devices.hpp; включённая сборка экспортирует
WUI_HAS_NATIVE_MEDIA=1. По умолчанию модуль выключен. Реализаций для
Windows и Linux пока нет.
API перечисляет микрофоны, динамики и камеры с постоянными системными ID, захватывает микрофон, воспроизводит PCM, получает видео камеры и основного экрана. Он не включает RTP, кодеки, AEC, AGC и шумоподавление — они остаются в приложении. Пустой ID выбирает системное устройство по умолчанию.
Аудио
audio_stream использует signed 16-bit interleaved stereo PCM, 48 кГц.
Playback callback заполняет 1920 отсчётов: 960 стереокадров, или 20 мс.
Capture может возвращать короткие блоки: при необходимости приложение собирает
из них блок нужного размера. Перед playback callback буфер очищается.
Каждый поток владеет отдельной AudioQueue; start_* сначала останавливает
предыдущий поток. Метод error() возвращает описание ошибки запуска.
Камера и экран
video_capture::start_camera() выбирает точное разрешение и согласует целевую
частоту кадров с диапазонами камеры. Выбирается наибольшая доступная частота
не выше запрошенной; если такой нет — наименьшая выше неё. Например, камера
с частотами 30/24/20 FPS запускается на 24 FPS при запросе 25 FPS.
Неподдерживаемое разрешение возвращает ошибку, а не заменяется другим.
Видео передаётся как BGRA сверху вниз со stride: строки могут содержать отступы.
start_screen() масштабирует основной экран до запрошенного размера.
Захват экрана использует ScreenCaptureKit и требует macOS 12.3+.
Разрешения, потоки и время жизни
В Info.plist нужны NSCameraUsageDescription и NSMicrophoneUsageDescription.
При ещё не выданном разрешении запуск запрашивает его и возвращает false;
повторите запуск после согласия пользователя. Для экрана нужно системное
разрешение Screen Recording.
Callbacks работают на потоках устройств; переданные буферы действительны только
до возврата из callback. Не бросайте исключения и не меняйте WUI-контролы напрямую:
передавайте действие в UI через window::emit_event().
stop() и деструктор синхронно дожидаются callbacks. Не вызывайте их из callback
этого же потока. Запуск, остановку и смену устройств приложение должно
сериализовать на своём управляющем потоке. Уведомления о hotplug и runtime-ошибках
в текущий media API не входят.
Проверка сборки
cmake -S . -B build-media -DWUI_ENABLE_MEDIA=ON -DWUI_BUILD_TESTS=ON -DWUI_BUILD_EXAMPLES=OFF
cmake --build build-media --target wui_macos_test wui_macos_media_test
ctest --test-dir build-media -R '^macos_(integration|media)$' --output-on-failure
Проверка media перечисляет устройства, проверяет неверные аргументы и тихое воспроизведение. Она не заменяет ручную проверку захвата, разрешений и hotplug на целевых устройствах.