From 2eb24a2d0d1dfda6e1cdfa4a0b87f7d9d31fd5fe Mon Sep 17 00:00:00 2001 From: evgeny Date: Wed, 28 Oct 2026 21:50:16 +0100 Subject: [PATCH] Document retained call service cleanup, retry policy and native core teardown barriers --- doc/service_lifecycle.md | 17 +++++++-- tools/chatgui-android/doc/ARCHITECTURE.md | 43 +++++++++++++++++++++++ 2 files changed, 57 insertions(+), 3 deletions(-) diff --git a/doc/service_lifecycle.md b/doc/service_lifecycle.md index e9c67550d..110aa6a33 100644 --- a/doc/service_lifecycle.md +++ b/doc/service_lifecycle.md @@ -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 сброшены. Удалённый канал и остановленное ядро не восстанавливаются. Публикация и просмотр трансляции автоматически не возобновляются. diff --git a/tools/chatgui-android/doc/ARCHITECTURE.md b/tools/chatgui-android/doc/ARCHITECTURE.md index 6a78bb8c5..369e2294c 100644 --- a/tools/chatgui-android/doc/ARCHITECTURE.md +++ b/tools/chatgui-android/doc/ARCHITECTURE.md @@ -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,