Contrôlez la luminosité de l'écran de l'appareil par programmation, avec une gestion spécifique à l'app ou au système.
Commencez par getBrightness() et les autres méthodes principales listées ci-dessous.
Plateformes compatibles
Section intitulée « Plateformes compatibles »| Plateforme | Support | Notes |
|---|---|---|
| iOS | Oui | Natif |
| Android | Oui | Natif |
| Web | Non | Sécurisez avec Capacitor.getPlatform() |
Fonctionnalités clés
Section intitulée « Fonctionnalités clés »getBrightness- Récupérer le niveau de luminosité actuel de l'écran principal de l'appareil.setBrightness- Définir le niveau de luminosité de l'écran principal de l'appareil.getSystemBrightness- Obtenir la luminosité de l'écran du système.setSystemBrightness- Définir la luminosité de l'écran au niveau du système. Nécessite la permission WRITE_SETTINGS sur Android. Cela change également le mode de luminosité en MANUAL.
API public
Section intitulée « Public API »| Méthode | Description |
|---|---|
getBrightness | Récupérer le niveau de luminosité actuel de l'écran principal de l'appareil. |
setBrightness | Définir le niveau de luminosité de l'écran principal de l'appareil. |
getSystemBrightness | Obtenez la luminosité de l'écran de l'appareil. |
setSystemBrightness | Règle la luminosité de l'écran pour tout le système. Nécessite la permission WRITE_SETTINGS sur Android. Cela change également le mode de luminosité en MANUAL. |
getSystemBrightnessMode | Récupérer le mode de luminosité actuel du système (automatique ou manuel). Nécessite la permission WRITE_SETTINGS sur Android. |
setSystemBrightnessMode | Définir le mode de luminosité du système (automatique ou manuel). Nécessite la permission WRITE_SETTINGS sur Android. |
isUsingSystemBrightness | Vérifier si l'activité actuelle utilise la valeur de luminosité du système. |
restoreSystemBrightness | Réinitialiser le réglage de luminosité de l'activité actuelle pour utiliser la valeur du système. |
isAvailable | Vérifier si l’API Brightness est disponible sur l'appareil actuel. |
checkPermissions | Vérifier les permissions de l'utilisateur pour accéder à la luminosité du système. |
requestPermissions | Demandez l'autorisation d'accéder à la luminosité du système. Sur Android, cela ouvre les paramètres système pour accorder la permission WRITE_SETTINGS. |
getPluginVersion | Obtenir la version du plugin natif. |
Source de vérité
Section intitulée « Source de vérité »Cette référence est synchronisée depuis src/definitions.ts dans capacitor-brightness.
Continuer avec @capgo/capacitor-brightness
Section intitulée « Continuer avec @capgo/capacitor-brightness »Si vous utilisez @capgo/capacitor-brightness pour planifier le comportement des médias et de l'interface natifs, connectez-l’à Utiliser @capgo/capacitor-brightness pour la capacité native dans l'utilisation de @capgo/capacitor-brightness, Utiliser @capgo/capacitor-live-activities pour la fonctionnalité native de la page Utiliser @capgo/capacitor-live-activities, @capgo/capacitor-live-activities pour le détail d'implémentation dans @capgo/capacitor-live-activities , Utiliser @capgo/capacitor-video-player pour la capacité native dans Utiliser @capgo/capacitor-video-player , et @capgo/capacitor-video-player pour le détail d'implémentation dans @capgo/capacitor-video-player.