Screen Brightness
@capacitor-community/screen-brightness
Capacitor community plugin for controlling screen brightness on iOS and Android devices.
Maintainers
Versions
Installation
npm install @capacitor-community/screen-brightness
npx cap sync
Configuration
No configuration required for this plugin
Usage
import { ScreenBrightness } from '@capacitor-community/screen-brightness';
// Set the brightness:
const brightness = 0.5;
await ScreenBrightness.setBrightness({ brightness });
// Get the current brightness:
const {brightness: currentBrightness} = await ScreenBrightness.getBrightness();
API
setBrightness(...)
setBrightness(options: SetBrightnessOptions) => Promise<void>
Sets the brightness level. On iOS, it sets the system level brightness, and on Android it sets the brightness for the current view.
Since: 1.0.0
getBrightness()
getBrightness() => Promise<GetBrightnessReturnValue>
Returns info than contains the current brightness level
Returns: Promise<GetBrightnessReturnValue>
Interfaces
SetBrightnessOptions
Prop | Type | Description | Since |
---|
brightness | number | The level to set the brightness to, from 0.0 (very dim) to 1.0 (full brightness) On Android, setting the value to -1 restores the user configured brightness. | 1.0.0 |
GetBrightnessReturnValue
Prop | Type | Description | Since |
---|
brightness | number | The current brightness level, from 0.0 (very dim) to 1.0 (full brightness) On Android it returns -1 if the value has not been changed by the app. | 1.0.0 |