Если разрешение камеры уже предоставлено, перестаньте повторять запрос доступа и проследите цепочку превью: выбранная камера, готовность провайдера, связь Preview с поверхностью и активный lifecycle экрана. Чёрный прямоугольник не доказывает, что камера вообще начала отдавать изображение. Начните с минимального CameraX preview на разрешённом тестовом устройстве.
Официальный пример CameraX связывает Preview с surface provider у PreviewView и привязывает use case через bindToLifecycle. Документация проверена 22 октября 2026 года. Открытый экран с кнопками без этих подтверждённых этапов ещё не означает готовое превью. Сохраняйте результат инициализации и ошибку привязки, а не только сообщение «камера открыта».
Найдите последний подтверждённый этап
| Наблюдение | Следующий шаг |
|---|---|
| Разрешение отсутствует | Вернуться к штатному сценарию доступа |
| Разрешение есть, провайдер не готов | Ошибка инициализации и её обработка |
| Привязка не прошла | Состав use cases и выбранная камера |
| Привязка есть, экран пуст | Поверхность, размеры и видимость PreviewView |
| После возврата чёрный экран | Жизненный цикл и повторное подключение |
Проверяйте представление вместе с камерой
Условный путь до кадра:
допустимый доступ -> готовый provider
камера -> подтверждённый выбор
Preview -> актуальная поверхность PreviewView
lifecycle -> экран действительно активен
представление -> ненулевой размер и отсутствие перекрытия
ошибка -> состояние UI вместо вечного чёрного ожиданияПроверьте, что вид превью не закрыт непрозрачным слоем и относится к текущему экрану. После навигации ссылка на старое представление может остаться в асинхронном callback. Готовность старого provider не даёт права обновлять уже закрытый экран. Сверяйте актуальность запроса и жизненный цикл, особенно при быстром уходе и возврате.
Для нескольких use cases проверьте поддерживаемую комбинацию в своей версии библиотеки и на устройстве. Не лечите отказ случайным удалением всех других функций камеры навсегда. Сначала добейтесь минимального превью, затем возвращайте захват и анализ по одному. Так можно установить, какой шаг меняет рабочий результат, без слепого увеличения задержек.
Возврат из фона выявляет скрытую ошибку
- Первый запуск после предоставления разрешения.
- Повторное открытие экрана без нового запроса доступа.
- Уход в фон и возвращение к превью.
- Смена фронтальной и задней камеры, если поддерживается.
- Быстрое закрытие экрана во время асинхронной подготовки.
Проверку проводите на нескольких обещанных окружениях, фиксируя модель устройства, ОС и версию CameraX. Отличайте физически тёмную сцену от отсутствия отображения: используйте безопасный контрастный тестовый объект без людей и приватных документов. Не сохраняйте изображение в диагностику автоматически, когда достаточно состояний и времён этапов.
Кнопка съёмки должна иметь понятную готовность. Не выдавайте пустой результат за успешное фото, если камера ещё не подготовлена или захват завершился ошибкой. Предусмотрите объяснимое восстановление и повтор по выбору пользователя; бесконечный цикл переподключения может скрывать настоящий отказ и расходовать ресурсы.
Для разбора подготовьте минимальный экран, состояния привязки и последовательность переходов. Не отключайте системную защиту и не заменяйте CameraX на непроверенный набор обходов только ради исчезновения чёрного прямоугольника. Исправление подтверждено, когда кадры устойчиво появляются после запуска, навигации и возврата, а ошибка остаётся наблюдаемой.