Stay organized with collections
Save and categorize content based on your preferences.
Google Play services offers the Google Low Light Boost library. This
library allows apps to dynamically adjust the camera's brightness in real time
to adapt to low light conditions, even when running on devices that don't
support Low Light Boost AE Mode.
We provide several different ways to capture images in low-light
conditions. To choose the right approach for your app's needs, see Choose the
best low light option.
Key interfaces
There are two main interfaces you need to know about to use Google Low Light
Boost:
LowLightBoostClient lets you confirm that the module is installed
from Google Play services, and install the module if necessary. You also use
the client to create a LowLightBoostSession.
LowLightBoostSession manages the necessary input surfaces and outputs
the brightened camera preview to the surface provided by the app. You use
LowLightBoostSession to turn low light boost on or off.
Google Low Light Boost workflow
To provide preview images in low light conditions, follow this sequence:
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-05-12 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-12 UTC."],[],[],null,["# Understand Google Low Light Boost\n\nGoogle Play services offers the [*Google Low Light Boost library*](https://developers.google.com/android/reference/com/google/android/gms/cameralowlight/package-summary). This\nlibrary allows apps to dynamically adjust the camera's brightness in real time\nto adapt to low light conditions, even when running on devices that don't\nsupport Low Light Boost AE Mode.\n\nWe provide several different ways to capture images in low-light\nconditions. To choose the right approach for your app's needs, see [Choose the\nbest low light option](/media/camera/lowlight/choose-option).\n| **Note:** Google Low Light Boost does not currently work with HLG10. If the client provides an HLG10 input, Google Low Light Boost outputs an error.\n\n### Key interfaces\n\nThere are two main interfaces you need to know about to use Google Low Light\nBoost:\n\n- [`LowLightBoostClient`](https://developers.google.com/android/reference/com/google/android/gms/cameralowlight/LowLightBoostClient) lets you confirm that the module is installed from Google Play services, and install the module if necessary. You also use the client to create a `LowLightBoostSession`.\n- [`LowLightBoostSession`](https://developers.google.com/android/reference/com/google/android/gms/cameralowlight/LowLightBoostSession) manages the necessary input surfaces and outputs the brightened camera preview to the surface provided by the app. You use `LowLightBoostSession` to turn low light boost on or off.\n\n### Google Low Light Boost workflow\n\nTo provide preview images in low light conditions, follow this sequence:\n\n1. [Check whether the device you're on supports Low Light Boost AE Mode](/media/camera/lowlight/hw-low-light-boost#check-availability). If the device supports Low Light Boost AE Mode, use it instead of Google Low Light Boost.\n2. [Create a Camera2 session](/media/camera/camera2). Software LLB works with the Camera2 APIs.\n3. [Create a `LowLightBoostClient`](/media/camera/lowlight/low-light-boost-gp/use-client#create). This object provides essential utilities you'll need to use Google Low Light Boost.\n4. [Check if the low light boost module is installed](/media/camera/lowlight/low-light-boost-gp/use-client#check-installed). Google Low Light Boost is provided by Google Play services, so you'll need to check whether it's already installed on the device. If it isn't, you'll need to [install the module](/media/camera/lowlight/low-light-boost-gp/use-client#install).\n5. [Confirm that the device camera supports Google Low Light\n Boost](/media/camera/lowlight/low-light-boost-gp/use-client#check-supported).\n6. [Create a `LowLightBoostSession`](/media/camera/lowlight/low-light-boost-gp/use-session#create-session). This object lets you turn low light mode on and off.\n7. [Preview or record video](/media/camera/lowlight/low-light-boost-gp/use-session#preview) the way you normally would with Camera2.\n8. When the camera is no longer active, [release the session](/media/camera/lowlight/low-light-boost-gp/use-session#release)."]]