Guía
Cómo usar Brightness en Capacitor
Usando @capgo/capacitor-brightness
Controla el brillo de la pantalla en iOS y Android.
Instalar
bun add @capgo/capacitor-brightness
bunx cap sync
bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.
Importar
import { CapgoBrightness } from '@capgo/capacitor-brightness';
API de un vistazo
| Método | Descripción |
|---|---|
getBrightness |
Obtén el nivel de brillo actual de la pantalla principal del dispositivo. |
setBrightness |
Establece el nivel de brillo de la pantalla principal del dispositivo. |
getSystemBrightness |
Obtén el brillo de pantalla de todo el sistema. |
setSystemBrightness |
Establece el brillo de pantalla de todo el sistema. Requiere permiso WRITE_SETTINGS en Android. Esto también cambia el modo de brillo a MANUAL. |
getSystemBrightnessMode |
Obtén el modo de brillo actual del sistema (automático o manual). Requiere permiso WRITE_SETTINGS en Android. |
setSystemBrightnessMode |
Establece el modo de brillo del sistema (automático o manual). Requiere permiso WRITE_SETTINGS en Android. |
isUsingSystemBrightness |
Comprueba si la actividad actual usa el valor de brillo de todo el sistema. |
restoreSystemBrightness |
Restablece el ajuste de brillo de la actividad actual para usar el valor del sistema. |
isAvailable |
Comprueba si el API de Brightness está disponible en el dispositivo. |
checkPermissions |
Comprueba los permisos del usuario para acceder al brillo del sistema. |
requestPermissions |
Solicita permisos para acceder al brillo del sistema. En Android, esto abre los ajustes del sistema para conceder el permiso WRITE_SETTINGS. |
Ejemplos
getBrightness()
Obtén el nivel de brillo actual de la pantalla principal del dispositivo.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getBrightness();
console.log(result);
setBrightness()
Establece el nivel de brillo de la pantalla principal del dispositivo.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setBrightness({ brightness: 0.5 });
getSystemBrightness()
Obtén el brillo de pantalla de todo el sistema.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightness();
console.log(result);
setSystemBrightness()
Establece el brillo de pantalla de todo el sistema. Requiere permiso WRITE_SETTINGS en Android. Esto también cambia el modo de brillo a MANUAL.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightness({ brightness: 0.5 });
getSystemBrightnessMode()
Obtén el modo de brillo actual del sistema (automático o manual). Requiere permiso WRITE_SETTINGS en Android.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightnessMode();
console.log(result);
setSystemBrightnessMode()
Establece el modo de brillo del sistema (automático o manual). Requiere permiso WRITE_SETTINGS en Android.
import { CapgoBrightness, BrightnessMode } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightnessMode({ mode: BrightnessMode.AUTOMATIC });
La tabla anterior enumera los 11 métodos principales. Los helpers de listener y versión, así como el contrato completo de cada método, están documentados en la repositorio GitHub.
Referencia completa
Continúa desde Uso de @capgo/capacitor-brightness
Si estás usando Uso de @capgo/capacitor-brightness para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con @capgo/capacitor-brightness para los detalles de implementación en @capgo/capacitor-brightness, Primeros pasos para los detalles de implementación en Primeros pasos, Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para el detalle de implementación en @capgo/capacitor-live-activities, y Uso de @capgo/capacitor-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player.