Если разрешение камеры уже предоставлено, перестаньте повторять запрос доступа и проследите цепочку превью: выбранная камера, готовность провайдера, связь 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 на непроверенный набор обходов только ради исчезновения чёрного прямоугольника. Исправление подтверждено, когда кадры устойчиво появляются после запуска, навигации и возврата, а ошибка остаётся наблюдаемой.

Проверенные источники