چشمک‌زنی صفحه

چشمک‌زنی صفحه، که فلاش جلو یا فلاش سلفی نیز نامیده می‌شود، از روشنایی صفحه‌نمایش تلفن برای روشن کردن سوژه هنگام گرفتن عکس با دوربین جلو در شرایط کم‌نور استفاده می‌کند. این ویژگی در بسیاری از برنامه‌های دوربین بومی و برنامه‌های رسانه‌های اجتماعی دردسترس است. ازآنجایی‌که اکثر افراد هنگام قاب‌بندی سلفی تلفن خود را به‌اندازه کافی نزدیک نگه می‌دارند، این رویکرد مؤثر است.

بااین‌حال، پیاده‌سازی صحیح این ویژگی و حفظ کیفیت ضبط خوب به‌طور مداوم در دستگاه‌های مختلف برای توسعه‌دهندگان دشوار است. این راهنما نشان می‌دهد چگونه این ویژگی را بااستفاده از Camera2، میانای برنامه‌سازی کاربردی چارچوب دوربین Android سطح پایین، به‌درستی پیاده‌سازی کنید.

گردش کار عمومی

برای پیاده‌سازی صحیح این ویژگی، دو عامل کلیدی عبارتند از استفاده از توالی اندازه‌گیری پیش‌از ضبط (پیش‌از ضبط نوردهی خودکار)، و زمان‌بندی عملیات. گردش کار کلی در شکل ۱ دیده می‌شود.

نمودار جریانی که نحوه استفاده از میانای کاربر چشمک‌زنی صفحه را در Camera2 نشان می‌دهد.
شکل ۱. گردش کار کلی برای پیاده‌سازی چشمک‌زنی صفحه.

وقتی لازم است تصویری با ویژگی چشمک‌زنی صفحه گرفته شود، از مراحل زیر استفاده می‌شود.

  1. تغییرات لازم در میانای کاربر را برای چشمک‌زنی صفحه اعمال کنید، که می‌تواند نور کافی برای عکس گرفتن بااستفاده از صفحه دستگاه فراهم کند. برای موارد استفاده عمومی، Google تغییرات میانای کاربر زیر را پیشنهاد می‌کند، همان‌طور که در آزمایش‌های ما استفاده شده است:
    • صفحه برنامه با پوشش رنگ سفید پوشانده شده است.
    • روشنایی صفحه‌نمایش در بیشترین حد است.
  2. حالت نوردهی خودکار (AE) را روی CONTROL_AE_MODE_ON_EXTERNAL_FLASH تنظیم کنید، اگر پشتیبانی می‌شود.
  3. بااستفاده از CONTROL_AE_PRECAPTURE_TRIGGER، توالی اندازه‌گیری پیش‌از ضبط را راه‌اندازی کنید.
  4. منتظر بمانید تا نوردهی خودکار (AE) و تراز سفیدی خودکار (AWB) همگرا شوند.

  5. پس‌از همگرا شدن، از جریان معمول ضبط عکس برنامه استفاده می‌شود.

  6. ارسال درخواست ضبط به چارچوب.

  7. منتظر دریافت نتیجه ضبط بمانید.

  8. اگر CONTROL_AE_MODE_ON_EXTERNAL_FLASH تنظیم شده بود، حالت نوردهی خودکار را بازنشانی کنید.

  9. تغییرات واسط کاربر را برای چشمک‌زنی صفحه پاک کنید.

کدهای نمونه Camera2

پوشاندن صفحه برنامه با رونهاد سفیدرنگ

یک «نما» در فایل XML چیدمان برنامه‌تان اضافه کنید. این نما ارتفاع کافی دارد تا درطول ضبط چشمک‌زنی صفحه، روی همه عناصر دیگر میانای کاربر قرار بگیرد. این دکمه به‌طور پیش‌فرض نامرئی است و فقط زمانی مرئی می‌شود که تغییرات میانای کاربر چشمک‌زنی صفحه اعمال شود.

در نمونه کد زیر، از رنگ سفید (#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 در مرجع Activity Window است.

کاتلین

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);
}

تنظیم حالت نوردهی خودکار روی CONTROL_AE_MODE_ON_EXTERNAL_FLASH

CONTROL_AE_MODE_ON_EXTERNAL_FLASH با سطح میانای برنامه‌سازی کاربردی ۲۸ یا بالاتر دردسترس است. بااین‌حال، این حالت 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 را کاملاً پردازش می‌کند، نتیجه ضبط را در فراخوانی برگشتی ضبط تکراری بررسی کنید و منتظر بمانید تا حالت 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 به پیچیدگی بیشتری نیاز دارد. می‌توانید وضعیت نوردهی خودکار و وضعیت تراز سفیدی خودکار را بااستفاده از تنظیم فراخوانی برگشتی ضبط روی درخواست تکرارشونده پیگیری کنید.

به‌روزرسانی همان فراخوان تکراری به شما امکان می‌دهد کد ساده‌ای داشته باشید. برنامه‌ها اغلب به «پیش‌نمایش» نیاز دارند که برای آن درحین راه‌اندازی دوربین، درخواست تکرار تنظیم می‌کنند. بنابراین، می‌توانید فراخوان ضبط تکرارشونده را یک‌بار روی آن درخواست تکرارشونده اولیه تنظیم کنید و سپس از آن برای بررسی نتیجه و اهداف انتظار مجدداً استفاده کنید.

به‌روزرسانی کد فراخوانی برگشتی ضبط برای انتظار برای همگرایی

برای به‌روزرسانی فراخوانی بازگشتی ضبط تکراری، از تکه‌کد زیر استفاده کنید.

کاتلین

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 گرفته شده‌اند و منابع نوری در رنگ سفید گرم باقی مانده‌اند. این منبع نور سفید گرم به شما نشان می‌دهد که چگونه سایه‌رنگ آبی یک مشکل واقعی است، نه عارضه جانبی منبع نور.

محیط زیست نوردهی کم نوردهی زیاد سایه‌رنگ
محیط تاریک (بدون منبع نور به‌جز تلفن) عکس تقریباً کاملاً تاریک عکس بیش‌ازحد روشن‌شده عکس با سایه‌رنگ ارغوانی
نور کم (منبع نور اضافی حدود ۳ لوکس) عکس تاحدودی تاریک عکس بیش‌ازحد روشن‌شده عکس با ته‌رنگ مایل به آبی

وقتی درست انجام شود

وقتی از پیاده‌سازی استاندارد برای همان دستگاه‌ها و شرایط استفاده می‌شود، می‌توانید نتایج را در جدول زیر ببینید.

محیط زیست نوردهی کم (ثابت) نوردهی بیش‌ازحد (ثابت) سایه‌رنگ (ثابت)
محیط تاریک (بدون منبع نور به‌جز تلفن) پاک کردن عکس پاک کردن عکس عکس واضح بدون هیچ سایه‌رنگی
نور کم (منبع نور اضافی حدود ۳ لوکس) پاک کردن عکس پاک کردن عکس عکس واضح بدون سایه‌رنگ

همان‌طور که مشاهده می‌شود، کیفیت تصویر با پیاده‌سازی استاندارد به‌طور قابل‌توجهی بهبود می‌یابد.