Document retained call service cleanup, retry policy and native core teardown barriers

This commit is contained in:
evgeny committed 2026-10-29 13:34:23 +01:00
1 parent f0c7258a0c
commit 2eb24a2d0d
2 files changed
+57 -3

No files matched your search

+14 -3
View File
@@ -436,7 +436,9 @@ Desktop-звонок и рация проверяют поступление к
codec/jitter освобождаются отдельно через `call_audio_stop/release` после остановки устройства.
Android с `UTUN_WITH_VOICE` регистрирует voice в worker до SERVICE_STARTED и снимает привязку перед destroy
при stop/restart и ошибке частичного запуска. Main вызывает только start DSP; без живой привязки start отклоняется.
NativeLib перед stop/restart синхронно сбрасывает CallController на main, останавливая audio workers.
NativeLib перед stop/restart сбрасывает CallController на main и требует подтверждённую очистку CallService,
а также завершение mediaPreparation. Отказ stop API не разрешает разрушить используемое ядро;
Handler остаётся доступен для повторной очистки, следующий stop/restart повторяет проверку.
Диагностика и проверки исправления — разделы18–19 `doc/call_audit_findings.txt`.
Секунда без данных отключает TX и фиксирует понятную ошибку в GUI; цифровая тишина является данными.
RX продолжает работать, рация снимает PTT, автоматического переоткрытия неисправного входа нет.
@@ -505,8 +507,15 @@ GUI не уничтожает живой QProcess. При отказе новы
wake lock: перед исходящим вызовом или принятием входящего запускается foreground
режим `phoneCall|microphone`, затем сигналинг и аудио. Завершение сначала
останавливает I/O и дожидается аудиопотоков, затем освобождает native-аудио,
wake lock и сервис. Перед `NativeLib.stop/restart/destroy` выполняется тот же
порядок; новый звонок разрешается после `SERVICE_STARTED` нового ядра.
wake lock и сервис. Ошибочные операции сохраняют владельцев и повторяются независимо
с задержкой 250 мс..30 с; process-ссылка удерживает их также после onDestroy.
Успешный Deferred от shutdown подтверждает stop API audio/video и очистку receiver,
wake lock, токенов, foreground/stopSelf. Video подтверждает RX join/native close
и постановку camera cleanup, которая завершается асинхронно на video worker.
Отказ поста или join оставляет stop повторяемым. Отмена Deferred не снимает владельцев.
Перед `NativeLib.stop/restart/destroy` проверяется подтверждение очистки сервиса и
окончание подготовки чужого media; ошибка блокирует native stop. Новый звонок
нового ядра разрешается после `SERVICE_STARTED`.
Активность ядра задаётся явно: видимая Activity или незавершённый звонок удерживают
ACTIVE и выключают Android standby. Состояние не истекает по таймеру. После
@@ -520,6 +529,8 @@ ACTIVE и выключают Android standby. Состояние не истек
сигналинг и звонковое аудио. Foreground-сервис резервируется сразу из видимой Activity.
Отмена во время освобождения не запускает устаревший звонок.
До окончания звонка повторное включение рации/трансляции заблокировано.
До подтверждённой очистки сервиса blocksMedia сохраняется также после ENDED карточки.
Восстановление рации ждёт Deferred shutdown и завершения mediaPreparation.
После закрытия звонкового аудио и Telecom Connection ранее включённая рация
возвращается в прежний канал; удержания PTT сброшены. Удалённый канал и остановленное
ядро не восстанавливаются. Публикация и просмотр трансляции автоматически не возобновляются.
+43
View File
@@ -374,6 +374,41 @@ Demand ограничивает батч viewer; GAP/CLOSED требуют сб
## Фон и диагностика
`CallService` на main владеет audio/video движками, PARTIAL_WAKE_LOCK, power receiver,
foreground-уведомлением 1002 и собственными PendingIntent. Запуск сначала
подтверждает `phoneCall|microphone`, CPU lock и receiver, затем сообщает serviceReady.
Ошибка канала в onCreate логируется; onStart повторяет её до захвата ресурсов.
Ошибка диагностического чтения канала не отменяет успешный create. Null от
startForegroundService считается отказом, а отменённый запрос завершает
foreground-handshake без микрофона/CPU lock и останавливается.
Владельцы сохраняются до IPC: частичные acquire/register/promote получают rollback.
startAudio проверяет свой ID и CPU lock; повтор не заменяет живые движки.
Ошибка audio start/video constructor откатывает сервис. Неудачный camera promote
сохраняет последний подтверждённый флаг; caller не меняет capture при false.
Notification update/язык и power diagnostics ловят ошибки независимо от media.
Токены open/END имеют identity своего звонка, повторно используются при обновлении
и отменяются при shutdown. Старый END не завершает другой звонок; после stop
уведомление не публикуется. Chronometer использует startedAtElapsedRealtime из controller.
Shutdown независимо пытается остановить video/audio, снять receiver, CPU lock и
токены. Успешные операции не повторяются, отказавшие владельцы сохраняются.
IllegalArgumentException от unregister подтверждает отсутствие receiver; отказ
release после эффекта подтверждается следующим isHeld=false. Foreground и
stopSelf(lastStartId) снимаются после успешных stop API обоих движков. Последний
owned call ID сохраняется отдельно для serviceLost после локального освобождения.
Video stop подтверждает RX join/native close и принятие cleanup камерой/encoder
worker; окончательная camera cleanup асинхронна. Ошибка RX join или post допускает повтор stop.
Shutdown возвращает Deferred, успешный результат означает подтверждение всех
владельцев сервиса. При отказе process-ссылка удерживает экземпляр даже после
onDestroy, Handler повторяет попытку с задержкой 250 мс..30 с. Отказ post не теряет
владельца: shutdown/requireReleased повторяет очистку явно. Отмена Deferred
не подтверждает освобождение. CallController снимает карточку независимо от
retry, blocksMedia запрещает другой audio, а восстановление рации ждёт Deferred
и mediaPreparation. NativeLib перед stop/restart требует подтверждённый сервис
и завершённую подготовку media; иначе возвращает ошибку без разрушения ядра.
`RadioOverlayService` на main обеспечивает foreground-режим микрофона при активной
рации и включённом оверлее либо автоматике. Сам PCM захватывает RadioAudioEngine;
разрешённый экран/фоновое окно по-прежнему проверяются движком. Старт FGS
@@ -589,6 +624,14 @@ CoreActivity и гудки. Управляемые Android/JNI/repository-гра
публикации результатов. IncomingCallLifecycleTest также использует настоящий
рационный контроллер при доставке DECLINE. Радиоэфир и C-сигналинг в JVM не
запускаются; native-протокол проверяется отдельным test_radio.
CallServiceLifecycleTest в `:call-service-tests` использует настоящие CallService,
CallController, CallState, CoreActivity и router. Управляемые OS/DSP/camera/Telecom
границы воспроизводят частичные startup/stop, независимую очистку, повтор после
onDestroy, отказ очереди retry и отмену Deferred. Проверяются запрет другого
media/core teardown, ожидание восстановления рации, старая identity callbacks,
повторное использование notification tokens, camera flag и conversation clock.
Настоящие codec/камеры, Telecom и ограничения FGS/OEM в JVM не запускаются.
`:app:testDebugUnitTest` включает этот модуль как зависимость задачи, без host-классов в APK.
RadioOverlayLifecycleTest использует настоящие overlay service, RadioAudioEngine,
микрофонные подписки и MediaAudioController. Host-модели service/window IPC
проверяют частичные add/remove, повторную очистку, отказы channel/promote/stop,