Add brightness level control to flashlight action

[PabloOQ]

Developer TODO (don't remove)

• update documentation
• Check if this is supported on the device. See documentation for the CameraManager method.

Describe a related problem

When I wake up in the middle of the night, I want to turn the flashlight but at a low level, without leaving the lock screen, so neither blind me. At the same time I want to be able to reuse this shortcut for when I need the flashlight to be really bright.

Describe your suggested feature

Possibility to:

• Toggle flashlight with a default brightness level value
• Increase/decrease flashlight current brightness level value
• A way to tell if the current flashlight level value is the minimum or maximum (for feedback)

Describe alternatives you've considered for your suggested feature

Using apps that expose the controls for brigthness levels (deep link, intent, shortcuts). Sadly I couldn't find any.

Other details

From #1559

[sds100]

See this open source app. Apparently in Android 13+ it is possible but only on some devices https://github.com/cyb3rko/flashdim

[sds100]

Yeah, it would be cool to have this feature. While your flashlight is showing you could remap the volume buttons to go up and down, and then dim again. I want this so I'm doing it now 😂

[githubsterer]

Great idea! But how does the app handle conflicts with constraints? So if I have a No Media Playing constraint on the volume controls and want to adjust the flashlight while playing media, is there some way to prioritize the flashlight constraint over the other?