Звук через miniaudio: задержка ~10 мс и ввод (#71) #74

Merged
hamyack merged 1 commit from research/71-audio-backend into main 2026-10-27 00:51:12 +05:00
Owner

Закрывает #71

ADR-0003: звук через miniaudio вместо oto

Статус: принято (2026-10-27). Задача #71.

Контекст

Для записи с микрофона (#70) нужен ввод звука — oto умеет только вывод. Кроме того,
oto держит собственный буфер между программой и картой, и задержку ниже ~50 мс получить
не удалось: маленький системный буфер «голодал» (карта забирала 20–41 тыс. кадров/с вместо 48 000).

Замеры на macOS (miniaudio, дуплекс, драм-кит играет)

период × число кадров/с нагрузка недоборы
3 мс × 2 47 995 4% 0
5 мс × 2 48 069 3% 0
10 мс × 2 47 993 2% 0
5 мс × 2, со входом вывод 47 903, вход 47 903 3% 0

Для сравнения oto: 20 мс + 1536 кадров — ~50 мс задержки; меньше — недобор.

Решение

  • Вывод и ввод — miniaudio через github.com/gen2brain/malgo, один дуплексный колбэк.
  • Ядро рендерит прямо в буфер карты, промежуточной очереди нет. Задержка ≈ период × число периодов:
    малый 5 мс × 2 (~10 мс), средний 10 × 3 (~30 мс), большой 25 × 4 (~100 мс).
  • Пакет audio отделён от engine: ядро по-прежнему без CGo и тестируется без карты.

Последствия

  • Нужен CGo и на Windows. Сборка с Мака: brew install mingw-w64, затем
    CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc wails build -platform windows/amd64.
    В CI — пакет gcc-mingw-w64-x86-64. Готовый exe зависит только от системных
    библиотек Windows 10/11 (UCRT, KERNEL32).
  • Колбэк malgo берёт короткий мьютекс для поиска обработчика — без конкуренции, на замерах не виден.
  • Для записи на macOS понадобится разрешение на микрофон (NSMicrophoneUsageDescription) — в #70.

🤖 Generated with Claude Code

Закрывает #71 # ADR-0003: звук через miniaudio вместо oto Статус: принято (2026-10-27). Задача #71. ## Контекст Для записи с микрофона (#70) нужен ввод звука — oto умеет только вывод. Кроме того, oto держит собственный буфер между программой и картой, и задержку ниже ~50 мс получить не удалось: маленький системный буфер «голодал» (карта забирала 20–41 тыс. кадров/с вместо 48 000). ## Замеры на macOS (miniaudio, дуплекс, драм-кит играет) | период × число | кадров/с | нагрузка | недоборы | |---|---|---|---| | 3 мс × 2 | 47 995 | 4% | 0 | | 5 мс × 2 | 48 069 | 3% | 0 | | 10 мс × 2 | 47 993 | 2% | 0 | | 5 мс × 2, со входом | вывод 47 903, вход 47 903 | 3% | 0 | Для сравнения oto: 20 мс + 1536 кадров — ~50 мс задержки; меньше — недобор. ## Решение - Вывод и ввод — miniaudio через github.com/gen2brain/malgo, один дуплексный колбэк. - Ядро рендерит прямо в буфер карты, промежуточной очереди нет. Задержка ≈ период × число периодов: малый 5 мс × 2 (~10 мс), средний 10 × 3 (~30 мс), большой 25 × 4 (~100 мс). - Пакет `audio` отделён от `engine`: ядро по-прежнему без CGo и тестируется без карты. ## Последствия - Нужен CGo и на Windows. Сборка с Мака: `brew install mingw-w64`, затем `CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc wails build -platform windows/amd64`. В CI — пакет gcc-mingw-w64-x86-64. Готовый exe зависит только от системных библиотек Windows 10/11 (UCRT, KERNEL32). - Колбэк malgo берёт короткий мьютекс для поиска обработчика — без конкуренции, на замерах не виден. - Для записи на macOS понадобится разрешение на микрофон (NSMicrophoneUsageDescription) — в #70. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Замеры на macOS: период 3–10 мс без недоборов, нагрузка 2–4%, вход идёт
с той же скоростью. Ядро рендерит прямо в буфер карты. Windows собирается
кросс-компилятором mingw-w64, exe зависит только от системных библиотек.
Решение — ADR-0003.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
hamyack deleted branch research/71-audio-backend 2026-10-27 00:51:12 +05:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
hamyack/rzr!74
No description provided.