docs(call): clarify Android output and Bluetooth proxy ownership

This commit is contained in:
evgeny committed 2026-10-26 20:21:58 +01:00
1 parent 1af86203cc
commit 755ebf2cd4
2 files changed
+32 -8

No files matched your search

+31 -7
View File
@@ -37,6 +37,14 @@ Voice/desktop-профиль30/30, Android timing/trace unit14/14, assembleDebug
Это компонентная проверка и сборка; аппаратный Android-звонок не запускался. Диагностика — раздел13,
внедрение и границы — раздел14 отчёта; полный аудит голосового/платформенного кода ещё не завершён.
Продолжение Android I/O: исправлено владение BluetoothHeadset proxy при позднем callback,
disconnect сервиса и stop/start. Поколение запроса и общий монитор router защищают принятие/закрытие;
disconnect сохраняет владение до closeProfileProxy. Постоянные JVM-регрессии15/15 PASS,
включая64 конкурентных callback/stop; прежний исходник выявляется в трёх отказных сценариях.
Android timing/trace/buffer/recovery26/26, voice/desktop30/30 и assembleDebug для двух ABI PASS.
Это управляемая модель lifecycle API, без Bluetooth/Binder и акустической проверки телефона.
Доказательства, полный профиль и ограничения — раздел15 отчёта; общий аудит остаётся частичным.
## 1. Область
Аудио и видео 1:1. Звонок можно инициировать **из CHAT-группы или из p2p-чата (DM)**.
@@ -245,15 +253,30 @@ ACTIVE запрашивается до создания аудиоустройс
Реальное время запуска/переключения зависит от Android и требует проверки на устройстве.
Маршрутизатор использует один снимок входных/выходных устройств; обновляет его при старте,
событиях устройств/BT-профиля и явной переоценке. По завершении снимок освобождается.
CallAudioRouter используется также MediaAudioController: start может выполняться из I/O, Bluetooth callbacks — на main.
start/stop и принятие/отключение BT-профиля сериализуются существующим монитором router.
Каждый запрос getProfileProxy получает поколение; stop инвалидирует его до освобождения ресурсов.
Поздний connected закрывает полученный proxy через создавший его adapter, не меняя новый lifecycle.
Текущий proxy и adapter сохраняются до stop, в том числе после onServiceDisconnected:
отключение сервиса не отменяет владение, а getConnectedDevices при недоступном сервисе возвращает пустой список.
При stop ссылки отсоединяются до closeProfileProxy; старый disconnected после restart игнорируется.
Пока принятый запрос не доставил proxy, закрыть его через публичный API нельзя: очистка выполняется при позднем connected.
Логи CallAudioRouter содержат поколение, proxy, результат запроса, retained/closed/stale и ошибки API.
INFO-логи Android показывают длительности настройки режима, регистрации callback, BT-профиля, выбора маршрута,
создания/старта устройств, первого чтения микрофона и первой записи в AudioTrack, а также готовность другого направления.
Общий `call_audio` логирует время ожидания первого PCM; запись в AudioTrack может содержать начальную тишину.
Эффективный рабочий буфер AudioTrack на всех поддерживаемых API при старте запрашивается размером
два блока PCM (40мс); на API 31+ стартовый порог следует фактически принятому размеру.
Ёмкость выделенной памяти может быть больше. Ограничение повторяется по callback фактической
смены выхода на main, под trackLock; callback старого AudioTrack игнорируется и снимается при stop.
Подачу PCM задаёт свободное место в AudioTrack, без дополнительного таймера 20мс.
Выход принадлежит playback worker. Для подтверждённого speaker на API31+ сначала пробуется AAudio:
принимаются48кГц mono PCM16, LOW_LATENCY, burst1–480 и запрошенное устройство.
Иначе используется AudioTrack; гарнитуры сразу идут через AudioTrack. Начальная заявка рабочего буфера —
один блок PCM (20мс) для AAudio, два (40мс) для AudioTrack; стартовый порог AudioTrack на API31+ следует принятому размеру.
Ёмкость выделенной памяти может быть больше. Callback на main фиксирует подтверждение выхода;
повторное открытие и настройку выполняет playback worker, callback прежнего AudioTrack игнорируется и снимается при закрытии.
Подачу PCM задаёт свободное место в устройстве, без дополнительного таймера 20мс.
Частичная запись удерживает остаток одного блока до полной передачи; следующий pull ждёт.
При смене устройства или восстанавливаемом отказе сохраняется ещё не принятый устройством хвост блока.
Новый локальный playback head получает базу общего счётчика принятого PCM; прежняя очередь устройства
не переигрывается и не считается доказанно прозвучавшей. Core clock приостанавливается в той же эпохе;
новое подтверждение позиции возобновляет его, JB сохраняется.
Сетевой запас остаётся в адаптивном JB, его рост и SoundTouch-догон не изменены.
Лог `playback buffering` показывает причину настройки, запрошенный/принятый размер, порог и ёмкость;
ежесекундный `audio summary` — queueUs, текущий порог и underruns; новый episode underrun имеет уровень WARN.
@@ -330,10 +353,11 @@ PTS/возраст используют локальный MONOTONIC, интер
После старта, запроса/подтверждения маршрута и увеличения даются 2с на стабилизацию;
после уменьшения первый underrun учитывается немедленно. Отсутствие продвижения head или
пропуск наблюдений >1с обнуляет стабильный участок. Сброс системного счётчика учитывается отдельно.
Фактическая смена выхода начинает подбор с 40мс заново. Непринятая меньшая заявка фиксирует
Открытие нового выхода начинает подбор с начальной заявки backend (AAudio20мс, AudioTrack40мс). Непринятая меньшая заявка фиксирует
нижнюю границу до следующего выхода; ошибки API выключают подбор с WARN/ERROR, сохраняя воспроизведение.
Reporter управляет размером под trackLock независимо от фильтра debug; playback не берёт этот lock.
Нет flush/recreate, частичная запись PCM сохраняется. После смены размера/выхода через секунду
Сам подбор размера не делает flush/recreate; смена выхода переоткрывает backend в playback worker.
Частичная запись PCM сохраняется. После смены размера/выхода через секунду
повторно измеряется задержка для AEC. Ожидание полного буфера и недостача сети не увеличивают его размер.
Лог настройки содержит reason, previous/requested/actualFrames и прирост underruns;
достижение ёмкости предупреждает не чаще раза в 10с. Принятие и стабильность 20мс ещё требуют
@@ -115,7 +115,7 @@ class CallAudioRouter {
@Volatile private var btHeadset: BluetoothHeadset? = null // Владение, не признак подключения сервиса.
private var btProfileAdapter: BluetoothAdapter? = null // Adapter, создавший текущий proxy; под монитором router.
private var btProfileGeneration = 0L // Поколение запроса, инвалидируется до закрытия; под монитором router.
/* Неизменяемый снимок, обновляется на main; capture читает уже найденные устройства. */
/* Неизменяемый снимок после старта/переоценки и событий устройств; capture читает уже найденные устройства. */
@Volatile private var devices: Array<AudioDeviceInfo>? = null
@Synchronized fun start() {