docs(call): clarify Android output and Bluetooth proxy ownership
This commit is contained in:
1 parent
1af86203cc
commit
755ebf2cd4
2 files changed
+32
-8
No files matched your search
+31
-7
@@ -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() {
|
||||
|
||||
Reference in new issue
Block a user