ScreenBrightness 继承自：Service, BaseControl

提供对系统屏幕亮度和应用屏幕亮度的控制与观察能力。

注意：

• 支持的平台：Android、iOS。

要在 Android 上调整系统亮度，请在 pyproject.toml 文件中添加以下权限：

[tool.flet.android.permission]
"android.permission.WRITE_SETTINGS" = true

示例

import flet as ft


async def main(page: ft.Page):
    sb = ft.ScreenBrightness()
    page.services.append(sb)

    info = ft.Text()
    system_change = ft.Text()
    app_change = ft.Text()

    level = ft.Slider(min=0, max=1, divisions=20, value=0.5, label="Brightness")
    animate_switch = ft.Switch(
        label="Animate application changes", value=True, on_change=None
    )
    auto_reset_switch = ft.Switch(
        label="Auto-reset application brightness on lifecycle changes",
        value=True,
        on_change=None,
    )

    async def refresh_info():
        system_brightness = await sb.get_system_screen_brightness()
        app_brightness = await sb.get_application_screen_brightness()
        can_change_system = await sb.can_change_system_screen_brightness()

        animate_switch.value = await sb.is_animate()
        auto_reset_switch.value = await sb.is_auto_reset()

        info.value = (
            f"System: {system_brightness:.2f} | "
            f"Application: {app_brightness:.2f} | "
            f"Can change system: {can_change_system}"
        )

    async def set_application_brightness(_):
        await sb.set_application_screen_brightness(level.value)
        await refresh_info()

    async def set_system_brightness(_):
        await sb.set_system_screen_brightness(level.value)
        await refresh_info()

    async def reset_application_brightness(_):
        await sb.reset_application_screen_brightness()
        await refresh_info()

    async def toggle_animate(e: ft.Event[ft.Switch]):
        await sb.set_animate(e.control.value)
        await refresh_info()

    async def toggle_auto_reset(e: ft.Event[ft.Switch]):
        await sb.set_auto_reset(e.control.value)
        await refresh_info()

    async def on_system_change(e: ft.ScreenBrightnessChangeEvent):
        system_change.value = f"System brightness changed: {e.brightness:.2f}"

    async def on_application_change(e: ft.ScreenBrightnessChangeEvent):
        app_change.value = f"Application brightness changed: {e.brightness:.2f}"

    sb.on_system_screen_brightness_change = on_system_change
    sb.on_application_screen_brightness_change = on_application_change

    await refresh_info()

    animate_switch.on_change = toggle_animate
    auto_reset_switch.on_change = toggle_auto_reset

    page.add(
        ft.SafeArea(
            content=ft.Column(
                controls=[
                    ft.Column(
                        [
                            info,
                            level,
                            ft.Row(
                                [
                                    ft.Button(
                                        "Set application",
                                        on_click=set_application_brightness,
                                    ),
                                    ft.Button(
                                        "Set system", on_click=set_system_brightness
                                    ),
                                    ft.TextButton(
                                        "Reset application",
                                        on_click=reset_application_brightness,
                                    ),
                                ],
                                wrap=True,
                            ),
                            animate_switch,
                            auto_reset_switch,
                            ft.Divider(),
                            system_change,
                            app_change,
                        ],
                        spacing=12,
                    )
                ],
            ),
        )
    )


if __name__ == "__main__":
    ft.run(main)

属性

名称	类型	默认值	说明
data	Any	skip_	任意类型的自定义数据。
key	Optional['KeyValue']	None	用于在更新之间保持控件标识稳定的键。

只读属性

名称	类型	默认值	说明
parent	Optional['BaseControl']	—	此控件的直接祖先（父级）。 默认为 None，只有在此控件被挂载（加入页面树）后才有值。 Page 控件（页面树的根）是个例外 —— 它的 parent 始终为 None。
page	'Page'	—	此控件所属的页面。

事件

名称	类型	默认值	说明
on_system_screen_brightness_change	Optional[EventHandler[ScreenBrightnessChangeEvent]]	None	当 系统 屏幕亮度发生变化时调用。
on_application_screen_brightness_change	Optional[EventHandler[ScreenBrightnessChangeEvent]]	None	当 应用 屏幕亮度发生变化时调用。

方法

名称	类型	默认值	说明
get_system_screen_brightness	float	—	返回当前系统屏幕亮度，范围为 0.0..1.0。
can_change_system_screen_brightness	bool	—	返回应用是否被允许更改系统屏幕亮度。
set_system_screen_brightness	—	—	设置系统屏幕亮度。
get_application_screen_brightness	float	—	返回当前应用屏幕亮度，范围为 0.0..1.0。
set_application_screen_brightness	—	—	设置应用屏幕亮度。
reset_application_screen_brightness	—	—	将应用屏幕亮度重置回系统亮度值。
is_animate	bool	—	如果亮度变化带动画效果则返回 True（取决于平台）。
set_animate	—	—	启用或禁用亮度变化的动画效果。
is_auto_reset	bool	—	如果在生命周期变化时自动重置亮度则返回 True。
set_auto_reset	—	—	启用或禁用生命周期变化时自动重置为系统亮度。
before_update	—	—	—
init	—	—	—
is_isolated	—	—	返回此控件是否被标记为隔离。 隔离控件会被排除在父级驱动的更新遍历之外，并需要自行管理更新边界。
build	—	—	在控件初始化期间调用一次，用于定义其子控件。在此方法中 page 属性可用。
before_event	—	—	在事件处理器执行之前拦截事件。 返回 False 可取消分发。返回 True 或 None 则继续正常的事件处理。
did_mount	—	—	在控件挂载到页面树之后调用。 重写此方法以启动需要已挂载页面的资源，例如订阅、定时器或服务监听器。
will_unmount	—	—	在控件从页面树移除之前调用。 重写此方法以释放 did_mount() 中创建的资源，例如订阅、定时器或外部句柄。
get_data_channel	—	—	解析为此 widget 在 Dart 侧分配的 [DataChannel]。模式： on_data_channel_open: Optional[ft.EventHandler[DataChannelOpenEvent]] = None def init(self): self.on_data_channel_open = self._on_open def _on_open(self, e): self._channel = self.get_data_channel(e.channel_id) 幂等 —— 底层的 Connection 会按 id 缓存 DataChannel，因此重复调用会返回同一实例。没有错误路径：该 id 始终来自框架触发的事件，所以当此方法运行时，通道在两端都已存在。
update	None	—	为此控件请求一次 UI 更新。 在更改控件状态或属性后调用。控件必须已挂载到页面且未被标记为冻结。