Guía
Cómo usar la Iluminación en Capacitor
Usando @capgo/capacitor-brillo
Controla la intensidad 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 después de cada actualización del plugin.
Importar
import { CapgoBrightness } from '@capgo/capacitor-brightness';
Vista general de API
| Metodo | Descripción |
|---|---|
getBrightness |
Obtenga el nivel de brillo actual de la pantalla principal del dispositivo. |
setBrightness |
Establezca el nivel de brillo de la pantalla principal del dispositivo. |
getSystemBrightness |
Obtenga el brillo de pantalla del sistema. |
setSystemBrightness |
Establecer la intensidad de pantalla del sistema. Requiere permiso WRITE_SETTINGS en Android. Esto también cambia el modo de intensidad a MANUAL. |
getSystemBrightnessMode |
Obtenga el modo de brillo del sistema actual (automático o manual). Requiere permiso WRITE_SETTINGS en Android. |
setSystemBrightnessMode |
Establecer el modo de brillo del sistema (automático o manual). Requiere permiso WRITE_SETTINGS en Android. |
isUsingSystemBrightness |
Verifique si la actividad actual está utilizando el valor de brillo del sistema. |
restoreSystemBrightness |
Restablezca la configuración de brillo de la actividad actual para utilizar el valor del sistema. |
isAvailable |
Verifique si el API de brillo está disponible en el dispositivo actual. |
checkPermissions |
Verifique las permisos del usuario para acceder al brillo del sistema. |
requestPermissions |
Solicite permisos para acceder al brillo del sistema. En Android, esto abre la configuración del sistema para conceder permiso de escritura de configuración. |
Ejemplos
getBrightness()
Obtenga 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()
Establezca el nivel de brillo de la pantalla principal del dispositivo.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setBrightness({ brightness: 0.5 });
getSystemBrightness()
Obtenga el brillo de pantalla del sistema.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightness();
console.log(result);
setSystemBrightness()
Establecer la luminosidad de pantalla del sistema. Requiere permiso WRITE_SETTINGS en Android. También cambia el modo de luminosidad a MANUAL.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightness({ brightness: 0.5 });
getSystemBrightnessMode()
Obtenga el modo de brillo del sistema actual (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()
Establecer 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 muestra los 11 métodos básicos. Los ayudantes de escucha y versión, y la documentación completa de cada método, se encuentran en el repositorio GitHub.
Referencia completa
Continuar desde Using @capgo/capacitor-brightness
Si estás utilizando Usando @capgo/capacitor-brillo Para planificar el comportamiento de medios y interfaz nativa, conecta con @capgo/capacitor-brillo para el detalle de implementación en @capgo/capacitor-brightness Getting Started para el detalle de implementación en Getting Started Usando @capgo/capacitor-actividades-en-vivo para la capacidad nativa en Using @capgo/capacitor-live-activities @capgo/capacitor-actividades en vivo para el detalle de implementación en @capgo/capacitor-actividades-en-vivo, y Usando @capgo/capacitor-reproductor-de-videos para la capacidad nativa en Usando @capgo/capacitor-reproductor-de-videos.