Guide
Comment utiliser la luminosité dans Capacitor
Utilisez @capgo/capacitor-éclairage
Contrôlez l'éclairage de l'écran sur iOS et Android.
Installer
bun add @capgo/capacitor-brightness
bunx cap sync
bunx cap sync copie le code natif du plugin dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin.
Importer
import { CapgoBrightness } from '@capgo/capacitor-brightness';
API en un coup d'œil
| Méthode | Description |
|---|---|
getBrightness |
Obtenez le niveau de luminosité actuel de l'écran principal du dispositif. |
setBrightness |
Définissez le niveau de luminosité de l'écran principal du dispositif. |
getSystemBrightness |
Obtenez la luminosité d'écran système. |
setSystemBrightness |
Fixer l'éclairement d'écran système. Exige la permission WRITE_SETTINGS sur Android. Cela change également le mode d'éclairement en MANUEL. |
getSystemBrightnessMode |
Obtenez le mode de luminosité système actuel (automatique ou manuel). Exige la permission d'écriture des paramètres sur Android. |
setSystemBrightnessMode |
Définissez le mode de luminosité système (automatique ou manuel). Exige la permission d'écriture des paramètres sur Android. |
isUsingSystemBrightness |
Vérifiez si l'activité actuelle utilise la valeur de luminosité de l'ensemble du système. |
restoreSystemBrightness |
Réinitialisez la valeur de luminosité de l'activité actuelle pour qu'elle utilise la valeur système. |
isAvailable |
Vérifiez si la fonctionnalité de luminosité API est disponible sur le dispositif actuel. |
checkPermissions |
Vérifiez les permissions de l'utilisateur pour accéder à la luminosité de l'écran. |
requestPermissions |
Demandez les autorisations pour accéder à la luminosité système. Sur Android, cela ouvre les paramètres système pour accorder la permission WRITE_SETTINGS. |
Exemples
getBrightness()
Obtenez le niveau de luminosité actuel de l'écran principal du dispositif.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getBrightness();
console.log(result);
setBrightness()
Fixez le niveau de luminosité de l'écran principal du dispositif.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setBrightness({ brightness: 0.5 });
getSystemBrightness()
Obtenez la luminosité d'écran système.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightness();
console.log(result);
setSystemBrightness()
Fixer l'éclairement de l'écran système. Exige la permission WRITE_SETTINGS sur Android. Cela change également le mode d'éclairement en MANUEL.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightness({ brightness: 0.5 });
getSystemBrightnessMode()
Obtenez le mode de luminosité actuel du système (automatique ou manuel). Exigez la permission WRITE_SETTINGS sur Android.
import { CapgoBrightness } from '@capgo/capacitor-brightness';
const result = await CapgoBrightness.getSystemBrightnessMode();
console.log(result);
setSystemBrightnessMode()
Fixez le mode de luminosité du système (automatique ou manuel). Exigez la permission WRITE_SETTINGS sur Android.
import { CapgoBrightness, BrightnessMode } from '@capgo/capacitor-brightness';
await CapgoBrightness.setSystemBrightnessMode({ mode: BrightnessMode.AUTOMATIC });
La table ci-dessus liste les 11 méthodes de base. Les helpers de listener et de version, ainsi que la pleine convention de chaque méthode, sont documentés dans le répertoire GitHub.
Référence complète
Continuez à partir de l'utilisation de @capgo/capacitor-brightness
Si vous utilisez L'utilisation de @capgo/capacitor-brightness pour planifier le comportement des médias et de l'interface native, connectez-l’avec @capgo/capacitor-éclairage pour les détails d'implémentation dans @capgo/capacitor-brightness, Getting Started pour les détails d'implémentation dans Démarrage, L'utilisation de @capgo/capacitor-live-activités pour la capacité native dans L'utilisation de @capgo/capacitor-live-activités, @capgo/capacitor-live-activités pour les détails d'implémentation dans @capgo/capacitor-activités-en-vive, et En utilisant @capgo/capacitor-joueur-de-videos pour la capacité native dans En utilisant @capgo/capacitor-joueur-de-videos.