From 755ebf2cd421d416d066296366c233c3bc5bab40 Mon Sep 17 00:00:00 2001 From: evgeny Date: Mon, 26 Oct 2026 18:17:11 +0100 Subject: [PATCH] docs(call): clarify Android output and Bluetooth proxy ownership --- doc/chat_call_arch.md | 38 +++++++++++++++---- .../com/utun/chat/data/CallAudioRouter.kt | 2 +- 2 files changed, 32 insertions(+), 8 deletions(-) diff --git a/doc/chat_call_arch.md b/doc/chat_call_arch.md index 1092e58aa..86960b70b 100644 --- a/doc/chat_call_arch.md +++ b/doc/chat_call_arch.md @@ -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мс ещё требуют diff --git a/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallAudioRouter.kt b/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallAudioRouter.kt index c12fe67a5..208ad1466 100644 --- a/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallAudioRouter.kt +++ b/tools/chatgui-android/app/src/main/java/com/utun/chat/data/CallAudioRouter.kt @@ -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? = null @Synchronized fun start() {