Update screen brightness docs and clarify platform support

Fixed example path in ScreenBrightness docs, added documentation for ScreenBrightnessChangeEvent, and updated mkdocs navigation. Clarified that accelerometer, gyroscope, and user accelerometer services are only supported on Android and iOS (not web). Expanded ScreenBrightness docstring with platform notes and Android permission instructions.

Author: FeodorFitsner

sdk/python/packages/flet/docs/controls/screenbrightness.md

@@ -1,6 +1,6 @@
 ---
 class_name: flet.ScreenBrightness
-examples: ../../../../examples/controls/screen_brightness
+examples: ../../examples/controls/screen_brightness
 ---
 
 {{ class_summary(class_name) }}

sdk/python/packages/flet/docs/types/screenbrightnesschangeevent.md

@@ -0,0 +1 @@
+{{ class_all_options("flet.ScreenBrightnessChangeEvent") }}

sdk/python/packages/flet/mkdocs.yml

@@ -441,10 +441,10 @@ nav:
           - Semantics: controls/semantics.md
           - SemanticsService: controls/semanticsservice.md
           - ScreenBrightness: controls/screenbrightness.md
+          - Screenshot: controls/screenshot.md
           - ShaderMask: controls/shadermask.md
           - Shimmer: controls/shimmer.md
           - ShakeDetector: controls/shakedetector.md
-          - Screenshot: controls/screenshot.md
           - Slider: controls/slider.md
           - SnackBar: controls/snackbar.md
           - Stack: controls/stack.md
@@ -890,6 +890,7 @@ nav:
               - ScaleEndEvent: types/scaleendevent.md
               - ScaleStartEvent: types/scalestartevent.md
               - ScaleUpdateEvent: types/scaleupdateevent.md
+              - ScreenBrightnessChangeEvent: types/screenbrightnesschangeevent.md
               - ScrollEvent: types/scrollevent.md
               - TabBarHoverEvent: types/tabbarhoverevent.md
               - TapEvent: types/tapevent.md

sdk/python/packages/flet/src/flet/controls/services/accelerometer.py

@@ -33,7 +33,7 @@ class Accelerometer(Service):
     Accelerometer reports zero acceleration if the device is free falling.
 
     Note:
-        * Supported platforms: Android, iOS, web.
+        * Supported platforms: Android, iOS.
         * Web ignores requested sampling intervals.
     """
 

sdk/python/packages/flet/src/flet/controls/services/gyroscope.py

@@ -19,7 +19,7 @@ class Gyroscope(Service):
     reporting device rotation rate around each axis in `rad/s`.
 
     Note:
-        * Supported platforms: Android, iOS, web.
+        * Supported platforms: Android, iOS.
         * Web ignores requested sampling intervals.
     """
 

sdk/python/packages/flet/src/flet/controls/services/screen_brightness.py

@@ -12,12 +12,28 @@
 @dataclass
 class ScreenBrightnessChangeEvent(Event["ScreenBrightness"]):
     brightness: float
+    """
+    The new screen brightness, in range `0.0..1.0`.
+    """
 
 
 @control("ScreenBrightness")
 class ScreenBrightness(Service):
     """
     Provides access to control and observe system and application screen brightness.
+
+    Note:
+        * Supported platforms: Android, iOS.
+
+    /// admonition | Running on Android
+        type: warning
+    To adjust the system brightness on Android, add the following permission
+    in your `pyproject.toml` file:
+    ```toml
+    [tool.flet.android.permission]
+    "android.permission.WRITE_SETTINGS" = true
+    ```
+    ///
     """
 
     on_system_screen_brightness_change: Optional[

sdk/python/packages/flet/src/flet/controls/services/user_accelerometer.py

@@ -26,7 +26,7 @@ class UserAccelerometer(Service):
     from [`AccelerometerReadingEvent`][flet.].
 
     Note:
-        * Supported platforms: Android, iOS, web.
+        * Supported platforms: Android, iOS.
         * Web ignores requested sampling intervals.
     """