Guide
Comment utiliser la luminosité dans Capacitor
Tester sur appareil
Téléchargez l'application Capgo, puis scannez le QR code.
Utiliser @capgo/capacitor-luminosité
Contrôler la luminosité 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 |
Fixez le niveau de luminosité de l'écran principal du dispositif. |
getSystemBrightness |
Obtenez la luminosité d'écran système. |
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. |
getSystemBrightnessMode |
Obtenez la configuration actuelle de la luminosité du système (automatique ou manuelle). Exige la permission WRITE_SETTINGS sur Android. |
setSystemBrightnessMode |
Réglage de la mode de luminosité du système (automatique ou manuel). Exige la permission WRITE_SETTINGS sur Android. |
isUsingSystemBrightness |
Vérifiez si l'activité actuelle utilise la valeur de luminosité système. |
restoreSystemBrightness |
Réinitialisez la valeur de la luminosité de l'activité actuelle pour utiliser la valeur système. |
isAvailable |
Vérifiez si la luminosité API est disponible sur le dispositif actuel. |
checkPermissions |
Vérifiez les permissions de l'utilisateur pour accéder à la luminosité du système. |
requestPermissions |
Demandez les permissions 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é système de l'écran.
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é système actuel (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é 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 aides pour les listeners et les versions, ainsi que le contrat complet de chaque méthode, sont documentés dans 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 Prise en main pour le détail d'implémentation dans Getting Started, Utilisation de @capgo/capacitor-activités-en-vive pour la capacité native dans Utilisation de @capgo/capacitor-activités-en-vive, @capgo/capacitor-activités-en-vive pour le détail d'implémentation dans @capgo/capacitor-activités-en-vive, et Utilisation de @capgo/capacitor-joueur-de-videos pour la capacité native dans Utilisation de @capgo/capacitor-joueur-de-videos.