Document retained call service cleanup, retry policy and native core teardown barriers
This commit is contained in:
1 parent
f0c7258a0c
commit
2eb24a2d0d
2 files changed
+57
-3
No files matched your search
@@ -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 сброшены. Удалённый канал и остановленное
|
||||
ядро не восстанавливаются. Публикация и просмотр трансляции автоматически не возобновляются.
|
||||
|
||||
@@ -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,
|
||||
|
||||
Reference in new issue
Block a user