android/dev.kindling.android.natif/BrightnessHelper

BrightnessHelper

class BrightnessHelper(context: Context)(source)

Helper de luminosité centralisé.

Deux portées :

Fenêtre (sans permission) — affecte uniquement l'Activity courante.
Système (permission WRITE_SETTINGS requise) — affecte tout l'appareil.

Enregistrement Koin :

single { BrightnessHelper(androidContext()) }

Utilisation :

// Luminosité fenêtre (pas de permission)
brightnessHelper.setWindowBrightness(activity, BrightnessLevel.High)
brightnessHelper.resetWindowBrightness(activity)

// Luminosité système (nécessite WRITE_SETTINGS — ouvrir les réglages si refusé)
if (brightnessHelper.canWriteSettings(context)) {
    brightnessHelper.setSystemBrightness(context, BrightnessLevel.Medium)
} else {
    brightnessHelper.openWriteSettingsScreen(context)
}

Constructors

BrightnessHelper

constructor(context: Context)

Functions

canWriteSettings

fun canWriteSettings(context: Context): Boolean

true si l'app peut modifier les réglages système.

getSystemBrightness

fun getSystemBrightness(context: Context): Float

Luminosité système courante normalisée 0f..1f.

getWindowBrightness

fun getWindowBrightness(activity: Activity): Float

Luminosité courante de la fenêtre 0f..1f, ou -1f si déléguée au système.

openWriteSettingsScreen

fun openWriteSettingsScreen(context: Context)

resetWindowBrightness

fun resetWindowBrightness(activity: Activity)

Rétablit la luminosité système pour la fenêtre de l'activity.

setSystemBrightness

@RequiresApi(value = 23)

fun setSystemBrightness(context: Context, level: BrightnessLevel)

Applique level au niveau système. Pré-condition : canWriteSettings == true. BrightnessLevel.System est réservé à la fenêtre — utilisez resetWindowBrightness.

setWindowBrightness

fun setWindowBrightness(activity: Activity, level: BrightnessLevel)

Applique level à la fenêtre de l'activity uniquement.