Эта страница переведена с помощью Cloud Translation API.

Экранная вспышка

Экранная вспышка, также называемая передней вспышкой или вспышкой для селфи, использует яркость экрана телефона для освещения объекта при съемке изображений передней камерой в условиях низкой освещенности. Он доступен во многих собственных приложениях камеры и приложениях социальных сетей. Поскольку большинство людей при создании автопортрета держат телефон достаточно близко, этот подход эффективен.

Однако разработчикам сложно правильно реализовать эту функцию и обеспечить постоянное хорошее качество захвата на всех устройствах. В этом руководстве показано, как правильно реализовать эту функцию с помощью Camera2 , низкоуровневого API платформы камеры Android.

Общий рабочий процесс

Для правильной реализации этой функции двумя ключевыми факторами являются использование последовательности предварительной съемки (автоматическая предварительная съемка экспозиции) и время выполнения операций. Общий рабочий процесс показан на рисунке 1.

Блок-схема, показывающая, как пользовательский интерфейс с экранной вспышкой используется в Camera2. — **Рисунок 1.** Общий рабочий процесс реализации вспышки экрана.

Следующие шаги используются, когда изображение необходимо захватить с помощью функции вспышки на экране.

Примените изменения пользовательского интерфейса, необходимые для вспышки экрана, которая может обеспечить достаточно света для фотографирования с помощью экрана устройства. Для общих случаев использования Google предлагает следующие изменения пользовательского интерфейса, которые использовались в наших тестах:
- Экран приложения покрыт накладкой белого цвета.
- Яркость экрана максимальная.
Установите режим автоматической экспозиции (AE) на CONTROL_AE_MODE_ON_EXTERNAL_FLASH , если он поддерживается.
Запустите последовательность измерений предварительного захвата с помощью CONTROL_AE_PRECAPTURE_TRIGGER .
Подождите, пока автоматическая экспозиция (AE) и автоматический баланс белого (AWB) совпадут.
Примечание. Прежде чем проверять конвергенцию AE и AWB, убедитесь, что начинается новый предварительный захват AE, поскольку AE и AWB могут быть сведены с некоторым другим набором состояний, существовавших до триггера предварительного захвата.
После схождения используется обычный процесс захвата фотографий приложения.
Отправьте запрос на захват в платформу.
Дождитесь получения результата захвата.
Сбросьте режим AE, если был установлен CONTROL_AE_MODE_ON_EXTERNAL_FLASH .
Очистите изменения пользовательского интерфейса для вспышки экрана.

Примеры кодов камеры 2

Накройте экран приложения белой накладкой.

Добавьте представление в XML-файл макета вашего приложения. Вид имеет достаточную высоту, чтобы находиться поверх всех остальных элементов пользовательского интерфейса во время захвата экрана. По умолчанию он остается невидимым и становится видимым только при применении изменений пользовательского интерфейса Flash Flash.

В следующем примере кода в качестве примера представления используется белый цвет ( #FFFFFF ). Приложения могут выбирать цвет или предлагать пользователям несколько цветов в зависимости от их требований.

<View
    android:id="@+id/white_color_overlay"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="#FFFFFF"
    android:visibility="invisible"
    android:elevation="8dp" />

Максимизируйте яркость экрана

Существует несколько способов изменить яркость экрана в приложении для Android. Один из прямых способов — изменить параметр screenBrightness WindowManager в справочнике по окну активности .

Котлин

private var previousBrightness: Float = -1.0f

private fun maximizeScreenBrightness() {
    activity?.window?.let { window ->
        window.attributes?.apply {
            previousBrightness = screenBrightness
            screenBrightness = 1f
            window.attributes = this
        }
    }
}

private fun restoreScreenBrightness() {
    activity?.window?.let { window ->
        window.attributes?.apply {
            screenBrightness = previousBrightness
            window.attributes = this
        }
    }
}

Ява

private float mPreviousBrightness = -1.0f;

private void maximizeScreenBrightness() {
    if (getActivity() == null || getActivity().getWindow() == null) {
        return;
    }

    Window window = getActivity().getWindow();
    WindowManager.LayoutParams attributes = window.getAttributes();

    mPreviousBrightness = attributes.screenBrightness;
    attributes.screenBrightness = 1f;
    window.setAttributes(attributes);
}

private void restoreScreenBrightness() {
    if (getActivity() == null || getActivity().getWindow() == null) {
        return;
    }

    Window window = getActivity().getWindow();
    WindowManager.LayoutParams attributes = window.getAttributes();

    attributes.screenBrightness = mPreviousBrightness;
    window.setAttributes(attributes);
}

Установите режим AE на `CONTROL_AE_MODE_ON_EXTERNAL_FLASH`

CONTROL_AE_MODE_ON_EXTERNAL_FLASH доступен с уровнем API 28 или выше. Однако этот режим AE доступен не на всех устройствах, поэтому проверьте, доступен ли режим AE, и установите соответствующее значение. Чтобы проверить доступность, используйте CameraCharacteristics#CONTROL_AE_AVAILABLE_MODES .

Котлин

private val characteristics: CameraCharacteristics by lazy {
    cameraManager.getCameraCharacteristics(cameraId)
}

@RequiresApi(Build.VERSION_CODES.P)
private fun isExternalFlashAeModeAvailable() =
    characteristics.get(CameraCharacteristics.CONTROL_AE_AVAILABLE_MODES)
        ?.contains(CaptureRequest.CONTROL_AE_MODE_ON_EXTERNAL_FLASH) ?: false

Ява

try {
    mCharacteristics = mCameraManager.getCameraCharacteristics(mCameraId);
} catch (CameraAccessException e) {
    e.printStackTrace();
}

@RequiresApi(Build.VERSION_CODES.P)
private boolean isExternalFlashAeModeAvailable() {
    int[] availableAeModes = mCharacteristics.get(CameraCharacteristics.CONTROL_AE_AVAILABLE_MODES);

    for (int aeMode : availableAeModes) {
        if (aeMode == CaptureRequest.CONTROL_AE_MODE_ON_EXTERNAL_FLASH) {
            return true;
        }
    }
    return false;
}

Если в приложении установлен повторяющийся запрос захвата (он необходим для предварительного просмотра), для режима AE необходимо установить повторяющийся запрос. В противном случае он может быть заменен режимом автоэкспозиции по умолчанию или другим заданным пользователем режимом при следующем повторяющемся захвате. Если это произойдет, камере может не хватить времени для выполнения всех операций, которые она обычно выполняет в режиме автоэкспозиции с внешней вспышкой.

Чтобы убедиться, что камера полностью обрабатывает запрос на обновление режима AE, проверьте результат захвата в повторяющемся обратном вызове захвата и дождитесь обновления режима AE в результате.

Захват обратного вызова, который может ожидать обновления режима AE.

Следующий фрагмент кода показывает, как это можно сделать.

Котлин

private val repeatingCaptureCallback = object : CameraCaptureSession.CaptureCallback() {
    private var targetAeMode: Int? = null
    private var aeModeUpdateDeferred: CompletableDeferred? = null

    suspend fun awaitAeModeUpdate(targetAeMode: Int) {
        this.targetAeMode = targetAeMode
        aeModeUpdateDeferred = CompletableDeferred()
        // Makes the current coroutine wait until aeModeUpdateDeferred is completed. It is
        // completed once targetAeMode is found in the following capture callbacks
        aeModeUpdateDeferred?.await()
    }

    private fun process(result: CaptureResult) {
        // Checks if AE mode is updated and completes any awaiting Deferred
        aeModeUpdateDeferred?.let {
            val aeMode = result[CaptureResult.CONTROL_AE_MODE]
            if (aeMode == targetAeMode) {
                it.complete(Unit)
            }
        }
    }

    override fun onCaptureCompleted(
        session: CameraCaptureSession,
        request: CaptureRequest,
        result: TotalCaptureResult
    ) {
        super.onCaptureCompleted(session, request, result)
        process(result)
    }
}

Ява

static class AwaitingCaptureCallback extends CameraCaptureSession.CaptureCallback {
    private int mTargetAeMode;
    private CountDownLatch mAeModeUpdateLatch = null;

    public void awaitAeModeUpdate(int targetAeMode) {
        mTargetAeMode = targetAeMode;
        mAeModeUpdateLatch = new CountDownLatch(1);
        // Makes the current thread wait until mAeModeUpdateLatch is released, it will be
        // released once targetAeMode is found in the capture callbacks below
        try {
            mAeModeUpdateLatch.await();
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }

    private void process(CaptureResult result) {
        // Checks if AE mode is updated and decrements the count of any awaiting latch
        if (mAeModeUpdateLatch != null) {
            int aeMode = result.get(CaptureResult.CONTROL_AE_MODE);
            if (aeMode == mTargetAeMode) {
                mAeModeUpdateLatch.countDown();
            }
        }
    }

    @Override
    public void onCaptureCompleted(@NonNull CameraCaptureSession session,
            @NonNull CaptureRequest request,
            @NonNull TotalCaptureResult result) {
        super.onCaptureCompleted(session, request, result);
        process(result);
    }
}

private final AwaitingCaptureCallback mRepeatingCaptureCallback = new AwaitingCaptureCallback();

Установите повторяющийся запрос на включение или выключение режима AE

При наличии обратного вызова захвата в следующих примерах кода показано, как настроить повторяющийся запрос.

Котлин

/** [HandlerThread] where all camera operations run */
private val cameraThread = HandlerThread("CameraThread").apply { start() }

/** [Handler] corresponding to [cameraThread] */
private val cameraHandler = Handler(cameraThread.looper)

private suspend fun enableExternalFlashAeMode() {
    if (Build.VERSION.SDK_INT >= 28 && isExternalFlashAeModeAvailable()) {
        session.setRepeatingRequest(
            camera.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW).apply {
                addTarget(previewSurface)
                set(
                    CaptureRequest.CONTROL_AE_MODE,
                    CaptureRequest.CONTROL_AE_MODE_ON_EXTERNAL_FLASH
                )
            }.build(), repeatingCaptureCallback, cameraHandler
        )

        // Wait for the request to be processed by camera
        repeatingCaptureCallback.awaitAeModeUpdate(CaptureRequest.CONTROL_AE_MODE_ON_EXTERNAL_FLASH)
    }
}

private fun disableExternalFlashAeMode() {
    if (Build.VERSION.SDK_INT >= 28 && isExternalFlashAeModeAvailable()) {
        session.setRepeatingRequest(
            camera.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW).apply {
                addTarget(previewSurface)
            }.build(), repeatingCaptureCallback, cameraHandler
        )
    }
}

Ява

private void setupCameraThread() {
    // HandlerThread where all camera operations run
    HandlerThread cameraThread = new HandlerThread("CameraThread");
    cameraThread.start();

    // Handler corresponding to cameraThread
    mCameraHandler = new Handler(cameraThread.getLooper());
}

private void enableExternalFlashAeMode() {
    if (Build.VERSION.SDK_INT >= 28 && isExternalFlashAeModeAvailable()) {
        try {
            CaptureRequest.Builder requestBuilder = mCamera.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);
            requestBuilder.addTarget(mPreviewSurface);
            requestBuilder.set(CaptureRequest.CONTROL_AE_MODE, CaptureRequest.CONTROL_AE_MODE_ON_EXTERNAL_FLASH);
            mSession.setRepeatingRequest(requestBuilder.build(), mRepeatingCaptureCallback, mCameraHandler);
        } catch (CameraAccessException e) {
            e.printStackTrace();
        }

        // Wait for the request to be processed by camera
        mRepeatingCaptureCallback.awaitAeModeUpdate(CaptureRequest.CONTROL_AE_MODE_ON_EXTERNAL_FLASH);
    }
}

private void disableExternalFlashAeMode() {
    if (Build.VERSION.SDK_INT >= 28 && isExternalFlashAeModeAvailable()) {
        try {
            CaptureRequest.Builder requestBuilder = mCamera.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);
            requestBuilder.addTarget(mPreviewSurface);
            mSession.setRepeatingRequest(requestBuilder.build(), mRepeatingCaptureCallback, mCameraHandler);
        } catch (CameraAccessException e) {
            e.printStackTrace();
        }
    }
}

Запуск последовательности предварительного захвата

Чтобы запустить последовательность измерения предварительного захвата, вы можете отправить CaptureRequest со значением CONTROL_AE_PRECAPTURE_TRIGGER_START , установленным для запроса. Вам нужно дождаться обработки запроса, а затем дождаться схождения AE и AWB.

Хотя предварительный захват запускается с помощью одного запроса захвата, ожидание конвергенции AE и AWB требует большей сложности. Вы можете отслеживать состояние AE и состояние AWB, используя обратный вызов захвата, настроенный на повторяющийся запрос.

Обновление одного и того же повторяющегося обратного вызова позволяет упростить код. Приложения часто требуют Preview, для чего настраивают повторяющийся запрос при настройке камеры. Таким образом, вы можете один раз установить обратный вызов повторяющегося захвата для этого первоначального повторяющегося запроса, а затем повторно использовать его для проверки результатов и ожидания.

Захват обновления кода обратного вызова для ожидания конвергенции

Чтобы обновить обратный вызов повторяющегося захвата, используйте следующий фрагмент кода.

Котлин

private val repeatingCaptureCallback = object : CameraCaptureSession.CaptureCallback() {
    private var targetAeMode: Int? = null
    private var aeModeUpdateDeferred: CompletableDeferred? = null

    private var convergenceDeferred: CompletableDeferred? = null

    suspend fun awaitAeModeUpdate(targetAeMode: Int) {
        this.targetAeMode = targetAeMode
        aeModeUpdateDeferred = CompletableDeferred()
        // Makes the current coroutine wait until aeModeUpdateDeferred is completed. It is
        // completed once targetAeMode is found in the following capture callbacks
        aeModeUpdateDeferred?.await()
    }

    suspend fun awaitAeAwbConvergence() {
        convergenceDeferred = CompletableDeferred()
        // Makes the current coroutine wait until convergenceDeferred is completed, it will be
        // completed once both AE & AWB are reported as converged in the capture callbacks below
        convergenceDeferred?.await()
    }

    private fun process(result: CaptureResult) {
        // Checks if AE mode is updated and completes any awaiting Deferred
        aeModeUpdateDeferred?.let {
            val aeMode = result[CaptureResult.CONTROL_AE_MODE]
            if (aeMode == targetAeMode) {
                it.complete(Unit)
            }
        }

        // Checks for convergence and completes any awaiting Deferred
        convergenceDeferred?.let {
            val aeState = result[CaptureResult.CONTROL_AE_STATE]
            val awbState = result[CaptureResult.CONTROL_AWB_STATE]

            val isAeReady = (
                    aeState == null // May be null in some devices (e.g. legacy camera HW level)
                            || aeState == CaptureResult.CONTROL_AE_STATE_CONVERGED
                            || aeState == CaptureResult.CONTROL_AE_STATE_FLASH_REQUIRED
                    )

            val isAwbReady = (
                    awbState == null // May be null in some devices (e.g. legacy camera HW level)
                            || awbState == CaptureResult.CONTROL_AWB_STATE_CONVERGED
                    )

            if (isAeReady && isAwbReady) {
                // if any non-null convergenceDeferred is set, complete it
                it.complete(Unit)
            }
        }
    }

    override fun onCaptureCompleted(
        session: CameraCaptureSession,
        request: CaptureRequest,
        result: TotalCaptureResult
    ) {
        super.onCaptureCompleted(session, request, result)
        process(result)
    }
}

Ява

static class AwaitingCaptureCallback extends CameraCaptureSession.CaptureCallback {
    private int mTargetAeMode;
    private CountDownLatch mAeModeUpdateLatch = null;

    private CountDownLatch mConvergenceLatch = null;

    public void awaitAeModeUpdate(int targetAeMode) {
        mTargetAeMode = targetAeMode;
        mAeModeUpdateLatch = new CountDownLatch(1);
        // Makes the current thread wait until mAeModeUpdateLatch is released, it will be
        // released once targetAeMode is found in the capture callbacks below
        try {
            mAeModeUpdateLatch.await();
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }

    public void awaitAeAwbConvergence() {
        mConvergenceLatch = new CountDownLatch(1);
        // Makes the current coroutine wait until mConvergenceLatch is released, it will be
        // released once both AE & AWB are reported as converged in the capture callbacks below
        try {
            mConvergenceLatch.await();
        } catch (InterruptedException e) {
            e.printStackTrace();
        }
    }

    private void process(CaptureResult result) {
        // Checks if AE mode is updated and decrements the count of any awaiting latch
        if (mAeModeUpdateLatch != null) {
            int aeMode = result.get(CaptureResult.CONTROL_AE_MODE);
            if (aeMode == mTargetAeMode) {
                mAeModeUpdateLatch.countDown();
            }
        }

        // Checks for convergence and decrements the count of any awaiting latch
        if (mConvergenceLatch != null) {
            Integer aeState = result.get(CaptureResult.CONTROL_AE_STATE);
            Integer awbState = result.get(CaptureResult.CONTROL_AWB_STATE);

            boolean isAeReady = (
                    aeState == null // May be null in some devices (e.g. legacy camera HW level)
                            || aeState == CaptureResult.CONTROL_AE_STATE_CONVERGED
                            || aeState == CaptureResult.CONTROL_AE_STATE_FLASH_REQUIRED
            );

            boolean isAwbReady = (
                    awbState == null // May be null in some devices (e.g. legacy camera HW level)
                            || awbState == CaptureResult.CONTROL_AWB_STATE_CONVERGED
            );

            if (isAeReady && isAwbReady) {
                mConvergenceLatch.countDown();
                mConvergenceLatch = null;
            }
        }
    }

    @Override
    public void onCaptureCompleted(@NonNull CameraCaptureSession session,
            @NonNull CaptureRequest request,
            @NonNull TotalCaptureResult result) {
        super.onCaptureCompleted(session, request, result);
        process(result);
    }
}

Установите обратный вызов на повторяющийся запрос во время настройки камеры.

Следующий пример кода позволяет настроить обратный вызов на повторяющийся запрос во время инициализации.

Котлин

// Open the selected camera
camera = openCamera(cameraManager, cameraId, cameraHandler)

// Creates list of Surfaces where the camera will output frames
val targets = listOf(previewSurface, imageReaderSurface)

// Start a capture session using our open camera and list of Surfaces where frames will go
session = createCameraCaptureSession(camera, targets, cameraHandler)

val captureRequest = camera.createCaptureRequest(
        CameraDevice.TEMPLATE_PREVIEW).apply { addTarget(previewSurface) }

// This will keep sending the capture request as frequently as possible until the
// session is torn down or session.stopRepeating() is called
session.setRepeatingRequest(captureRequest.build(), repeatingCaptureCallback, cameraHandler)

Ява

// Open the selected camera
mCamera = openCamera(mCameraManager, mCameraId, mCameraHandler);

// Creates list of Surfaces where the camera will output frames
List targets = new ArrayList<>(Arrays.asList(mPreviewSurface, mImageReaderSurface));

// Start a capture session using our open camera and list of Surfaces where frames will go
mSession = createCaptureSession(mCamera, targets, mCameraHandler);

try {
    CaptureRequest.Builder requestBuilder = mCamera.createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);
    requestBuilder.addTarget(mPreviewSurface);

    // This will keep sending the capture request as frequently as possible until the
    // session is torn down or session.stopRepeating() is called
    mSession.setRepeatingRequest(requestBuilder.build(), mRepeatingCaptureCallback, mCameraHandler);
} catch (CameraAccessException e) {
    e.printStackTrace();
}

Запуск и ожидание последовательности предварительного захвата

Если установлен обратный вызов, вы можете использовать следующий пример кода для запуска и ожидания последовательности предварительного захвата.

Котлин

private suspend fun runPrecaptureSequence() {
    // Creates a new capture request with CONTROL_AE_PRECAPTURE_TRIGGER_START
    val captureRequest = session.device.createCaptureRequest(
        CameraDevice.TEMPLATE_PREVIEW
    ).apply {
        addTarget(previewSurface)
        set(
            CaptureRequest.CONTROL_AE_PRECAPTURE_TRIGGER,
            CaptureRequest.CONTROL_AE_PRECAPTURE_TRIGGER_START
        )
    }

    val precaptureDeferred = CompletableDeferred()
    session.capture(captureRequest.build(), object: CameraCaptureSession.CaptureCallback() {
        override fun onCaptureCompleted(
            session: CameraCaptureSession,
            request: CaptureRequest,
            result: TotalCaptureResult
        ) {
            // Waiting for this callback ensures the precapture request has been processed
            precaptureDeferred.complete(Unit)
        }
    }, cameraHandler)

    precaptureDeferred.await()

    // Precapture trigger request has been processed, we can wait for AE & AWB convergence now
    repeatingCaptureCallback.awaitAeAwbConvergence()
}

Ява

private void runPrecaptureSequence() {
    // Creates a new capture request with CONTROL_AE_PRECAPTURE_TRIGGER_START
    try {
        CaptureRequest.Builder requestBuilder =
                mSession.getDevice().createCaptureRequest(CameraDevice.TEMPLATE_PREVIEW);
        requestBuilder.addTarget(mPreviewSurface);
        requestBuilder.set(CaptureRequest.CONTROL_AE_PRECAPTURE_TRIGGER,
                CaptureRequest.CONTROL_AE_PRECAPTURE_TRIGGER_START);

        CountDownLatch precaptureLatch = new CountDownLatch(1);
        mSession.capture(requestBuilder.build(), new CameraCaptureSession.CaptureCallback() {
            @Override
            public void onCaptureCompleted(@NonNull CameraCaptureSession session,
                                           @NonNull CaptureRequest request,
                                           @NonNull TotalCaptureResult result) {
                Log.d(TAG, "CONTROL_AE_PRECAPTURE_TRIGGER_START processed");
                // Waiting for this callback ensures the precapture request has been processed
                precaptureLatch.countDown();
            }
        }, mCameraHandler);

        precaptureLatch.await();

        // Precapture trigger request has been processed, we can wait for AE & AWB convergence now
        mRepeatingCaptureCallback.awaitAeAwbConvergence();
    } catch (CameraAccessException | InterruptedException e) {
        e.printStackTrace();
    }
}

Сшейте все вместе

Когда все основные компоненты готовы, всякий раз, когда необходимо сделать снимок, например, когда пользователь нажимает кнопку захвата, чтобы сделать снимок, все шаги могут выполняться в порядке, указанном в предыдущем обсуждении и примерах кода.

Котлин

// User clicks captureButton to take picture
captureButton.setOnClickListener { v ->
    // Apply the screen flash related UI changes
    whiteColorOverlayView.visibility = View.VISIBLE
    maximizeScreenBrightness()

    // Perform I/O heavy operations in a different scope
    lifecycleScope.launch(Dispatchers.IO) {
        // Enable external flash AE mode and wait for it to be processed
        enableExternalFlashAeMode()

        // Run precapture sequence and wait for it to complete
        runPrecaptureSequence()

        // Start taking picture and wait for it to complete
        takePhoto()

        disableExternalFlashAeMode()
        v.post {
            // Clear the screen flash related UI changes
            restoreScreenBrightness()
            whiteColorOverlayView.visibility = View.INVISIBLE
        }
    }
}

Ява

// User clicks captureButton to take picture
mCaptureButton.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        // Apply the screen flash related UI changes
        mWhiteColorOverlayView.setVisibility(View.VISIBLE);
        maximizeScreenBrightness();

        // Perform heavy operations in a different thread
        Executors.newSingleThreadExecutor().execute(() -> {
            // Enable external flash AE mode and wait for it to be processed
            enableExternalFlashAeMode();

            // Run precapture sequence and wait for it to complete
            runPrecaptureSequence();

            // Start taking picture and wait for it to complete
            takePhoto();

            disableExternalFlashAeMode();

            v.post(() -> {
                // Clear the screen flash related UI changes
                restoreScreenBrightness();
                mWhiteColorOverlayView.setVisibility(View.INVISIBLE);
            });
        });
    }
});

Примеры фотографий

На следующих примерах вы можете увидеть, что происходит, когда вспышка экрана реализована неправильно, и когда она реализована правильно.

Когда сделано неправильно

Если вспышка экрана реализована неправильно, вы получите противоречивые результаты при разных снимках, устройствах и условиях освещения. Часто захваченные изображения имеют плохую экспозицию или проблемы с цветовыми оттенками. Для некоторых устройств подобные ошибки становятся более очевидными в определенных условиях освещения, например, в условиях низкой освещенности, а не в полной темноте.

В следующей таблице показаны примеры таких проблем. Они сделаны в инфраструктуре лаборатории CameraX, при этом источники света остались тепло-белого цвета. Этот источник теплого белого света позволяет увидеть, что синий оттенок является реальной проблемой, а не побочным эффектом источника света.

Среда	Недодержка	Передержка	Цветовой оттенок
Темное окружение (нет источника света, кроме телефона)
Низкая освещенность (дополнительный источник света ~3 люкс)

Когда все сделано правильно

Когда стандартная реализация используется для тех же устройств и условий, результаты можно увидеть в следующей таблице.

Среда	Недоэкспозиция (фиксированная)	Передержка (фиксированная)	Цветовой оттенок (фиксированный)
Темное окружение (нет источника света, кроме телефона)
Низкая освещенность (дополнительный источник света ~3 люкс)

Как замечено, качество изображения значительно улучшается при стандартной реализации.

Экранная вспышка

Общий рабочий процесс

Примеры кодов камеры 2

Накройте экран приложения белой накладкой.

Максимизируйте яркость экрана

Котлин

Ява

Установите режим AE на CONTROL_AE_MODE_ON_EXTERNAL_FLASH

Котлин

Ява

Захват обратного вызова, который может ожидать обновления режима AE.

Котлин

Ява

Установите повторяющийся запрос на включение или выключение режима AE

Котлин

Ява

Запуск последовательности предварительного захвата

Захват обновления кода обратного вызова для ожидания конвергенции

Котлин

Ява

Установите обратный вызов на повторяющийся запрос во время настройки камеры.

Котлин

Ява

Запуск и ожидание последовательности предварительного захвата

Котлин

Ява

Сшейте все вместе

Котлин

Ява

Примеры фотографий

Когда сделано неправильно

Когда все сделано правильно

Установите режим AE на `CONTROL_AE_MODE_ON_EXTERNAL_FLASH`