feat(settings): add settings to adjust screen brightness when reading, closes #1532 (#2197)

2026-04-28 19:42:21 +00:00 · 2025-10-11 01:02:35 +08:00 · 2025-10-11 01:02:35 +08:00 · ada427b134
commit ada427b134
parent f696b9a573
54 changed files with 588 additions and 57 deletions
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/android/src/main/java/NativeBridgePlugin.kt
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/android/src/main/java/NativeBridgePlugin.kt
@ -69,6 +69,11 @@ class LockScreenOrientationRequestArgs {
  var orientation: String? = null
 }

+@InvokeArg
+class SetScreenBrightnessRequestArgs {
+  var brightness: Double? = null // 0.0 to 1.0
+}
+
 interface KeyDownInterceptor {
    fun interceptVolumeKeys(enabled: Boolean)
    fun interceptBackKey(enabled: Boolean)
@ -76,7 +81,7 @@ interface KeyDownInterceptor {

@TauriPlugin(
  permissions = [
-    Permission(strings = [Manifest.permission.MANAGE_EXTERNAL_STORAGE], alias = "manageStorage")
+    Permission(strings = [Manifest.permission.MANAGE_EXTERNAL_STORAGE], alias = "manageStorage"),
  ]
 )
 class NativeBridgePlugin(private val activity: Activity): Plugin(activity) {
@ -415,6 +420,44 @@ class NativeBridgePlugin(private val activity: Activity): Plugin(activity) {
        invoke.resolve(ret)
    }

+    @Command
+    fun get_screen_brightness(invoke: Invoke) {
+        val ret = JSObject()
+        try {
+            val brightness = Settings.System.getInt(
+                activity.contentResolver,
+                Settings.System.SCREEN_BRIGHTNESS
+            )
+            val normalizedBrightness = brightness / 255.0
+            ret.put("brightness", normalizedBrightness)
+        } catch (e: Exception) {
+            ret.put("error", e.message)
+            ret.put("brightness", -1.0)
+        }
+        invoke.resolve(ret)
+    }
+
+    @Command
+    fun set_screen_brightness(invoke: Invoke) {
+        val args = invoke.parseArgs(SetScreenBrightnessRequestArgs::class.java)
+        val ret = JSObject()
+        try {
+            val brightness = (args.brightness ?: 0.5).toFloat()
+            if (brightness < 0.0 || brightness > 1.0) {
+                invoke.reject("Brightness must be between 0.0 and 1.0")
+                return
+            }
+            val layoutParams = activity.window.attributes
+            layoutParams.screenBrightness = brightness
+            activity.window.attributes = layoutParams
+            ret.put("success", true)
+        } catch (e: Exception) {
+            ret.put("success", false)
+            ret.put("error", e.message)
+        }
+        invoke.resolve(ret)
+    }
+
    @Command
    fun request_manage_storage_permission(invoke: Invoke) {
        val ret = JSObject()
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/build.rs
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/build.rs
@ -15,6 +15,8 @@ const COMMANDS: &[&str] = &[
    "iap_restore_purchases",
    "get_system_color_scheme",
    "get_safe_area_insets",
+    "get_screen_brightness",
+    "set_screen_brightness",
    "request_manage_storage_permission",
    "checkPermissions",
    "requestPermissions",
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/ios/Sources/NativeBridgePlugin.swift
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/ios/Sources/NativeBridgePlugin.swift
@ -49,6 +49,10 @@ class LockScreenOrientationRequestArgs: Decodable {
  let orientation: String?
 }

+class SetScreenBrightnessRequestArgs: Decodable {
+  let brightness: Float?
+}
+
 struct InitializeRequest: Decodable {
  let publicKey: String?
 }
@ -539,6 +543,28 @@ class NativeBridgePlugin: Plugin {
    let colorScheme = (userInterfaceStyle == .dark) ? "dark" : "light"
    invoke.resolve(["colorScheme": colorScheme])
  }
+
+  @objc public func get_screen_brightness(_ invoke: Invoke) {
+    let brightness = UIScreen.main.brightness
+    invoke.resolve(["brightness": brightness])
+  }
+
+  @objc public func set_screen_brightness(_ invoke: Invoke) {
+    guard let args = try? invoke.parseArgs(SetScreenBrightnessRequestArgs.self) else {
+      return invoke.reject("Failed to parse arguments")
+    }
+
+    let brightness = args.brightness ?? 0.5
+
+    if brightness < 0.0 || brightness > 1.0 {
+      return invoke.reject("Brightness must be between 0.0 and 1.0")
+    }
+
+    DispatchQueue.main.async {
+      UIScreen.main.brightness = CGFloat(brightness)
+    }
+    invoke.resolve(["success": true])
+  }
 }

@_cdecl("init_plugin_native_bridge")
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/permissions/autogenerated/commands/get_screen_brightness.toml
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/permissions/autogenerated/commands/get_screen_brightness.toml
@ -0,0 +1,13 @@
+# Automatically generated - DO NOT EDIT!
+
+"$schema" = "../../schemas/schema.json"
+
+[[permission]]
+identifier = "allow-get-screen-brightness"
+description = "Enables the get_screen_brightness command without any pre-configured scope."
+commands.allow = ["get_screen_brightness"]
+
+[[permission]]
+identifier = "deny-get-screen-brightness"
+description = "Denies the get_screen_brightness command without any pre-configured scope."
+commands.deny = ["get_screen_brightness"]
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/permissions/autogenerated/commands/set_screen_brightness.toml
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/permissions/autogenerated/commands/set_screen_brightness.toml
@ -0,0 +1,13 @@
+# Automatically generated - DO NOT EDIT!
+
+"$schema" = "../../schemas/schema.json"
+
+[[permission]]
+identifier = "allow-set-screen-brightness"
+description = "Enables the set_screen_brightness command without any pre-configured scope."
+commands.allow = ["set_screen_brightness"]
+
+[[permission]]
+identifier = "deny-set-screen-brightness"
+description = "Denies the set_screen_brightness command without any pre-configured scope."
+commands.deny = ["set_screen_brightness"]
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/permissions/autogenerated/reference.md
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/permissions/autogenerated/reference.md
@ -20,6 +20,8 @@ Default permissions for the plugin
 - `allow-iap-restore-purchases`
 - `allow-get-system-color-scheme`
 - `allow-get-safe-area-insets`
+- `allow-get-screen-brightness`
+- `allow-set-screen-brightness`
 - `allow-request-manage-storage-permission`
 - `allow-checkPermissions`
 - `allow-requestPermissions`
@ -166,6 +168,32 @@ Denies the get_safe_area_insets command without any pre-configured scope.
 <tr>
 <td>

+`native-bridge:allow-get-screen-brightness`
+
+</td>
+<td>
+
+Enables the get_screen_brightness command without any pre-configured scope.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
+`native-bridge:deny-get-screen-brightness`
+
+</td>
+<td>
+
+Denies the get_screen_brightness command without any pre-configured scope.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
 `native-bridge:allow-get-status-bar-height`

 </td>
@ -478,6 +506,32 @@ Denies the request_manage_storage_permission command without any pre-configured
 <tr>
 <td>

+`native-bridge:allow-set-screen-brightness`
+
+</td>
+<td>
+
+Enables the set_screen_brightness command without any pre-configured scope.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
+`native-bridge:deny-set-screen-brightness`
+
+</td>
+<td>
+
+Denies the set_screen_brightness command without any pre-configured scope.
+
+</td>
+</tr>
+
+<tr>
+<td>
+
 `native-bridge:allow-set-system-ui-visibility`

 </td>
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/permissions/default.toml
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/permissions/default.toml
@ -17,6 +17,8 @@ permissions = [
  "allow-iap-restore-purchases",
  "allow-get-system-color-scheme",
  "allow-get-safe-area-insets",
+  "allow-get-screen-brightness",
+  "allow-set-screen-brightness",
  "allow-request-manage-storage-permission",
  "allow-checkPermissions",
  "allow-requestPermissions",
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/permissions/schemas/schema.json
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/permissions/schemas/schema.json
@ -354,6 +354,18 @@
          "const": "deny-get-safe-area-insets",
          "markdownDescription": "Denies the get_safe_area_insets command without any pre-configured scope."
        },
+        {
+          "description": "Enables the get_screen_brightness command without any pre-configured scope.",
+          "type": "string",
+          "const": "allow-get-screen-brightness",
+          "markdownDescription": "Enables the get_screen_brightness command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the get_screen_brightness command without any pre-configured scope.",
+          "type": "string",
+          "const": "deny-get-screen-brightness",
+          "markdownDescription": "Denies the get_screen_brightness command without any pre-configured scope."
+        },
        {
          "description": "Enables the get_status_bar_height command without any pre-configured scope.",
          "type": "string",
@ -498,6 +510,18 @@
          "const": "deny-request-manage-storage-permission",
          "markdownDescription": "Denies the request_manage_storage_permission command without any pre-configured scope."
        },
+        {
+          "description": "Enables the set_screen_brightness command without any pre-configured scope.",
+          "type": "string",
+          "const": "allow-set-screen-brightness",
+          "markdownDescription": "Enables the set_screen_brightness command without any pre-configured scope."
+        },
+        {
+          "description": "Denies the set_screen_brightness command without any pre-configured scope.",
+          "type": "string",
+          "const": "deny-set-screen-brightness",
+          "markdownDescription": "Denies the set_screen_brightness command without any pre-configured scope."
+        },
        {
          "description": "Enables the set_system_ui_visibility command without any pre-configured scope.",
          "type": "string",
@ -523,10 +547,10 @@
          "markdownDescription": "Denies the use_background_audio command without any pre-configured scope."
        },
        {
-          "description": "Default permissions for the plugin\n#### This default permission set includes:\n\n- `allow-auth-with-safari`\n- `allow-auth-with-custom-tab`\n- `allow-copy-uri-to-path`\n- `allow-use-background-audio`\n- `allow-install-package`\n- `allow-set-system-ui-visibility`\n- `allow-get-status-bar-height`\n- `allow-get-sys-fonts-list`\n- `allow-intercept-keys`\n- `allow-lock-screen-orientation`\n- `allow-iap-initialize`\n- `allow-iap-fetch-products`\n- `allow-iap-purchase-product`\n- `allow-iap-restore-purchases`\n- `allow-get-system-color-scheme`\n- `allow-get-safe-area-insets`\n- `allow-request-manage-storage-permission`\n- `allow-checkPermissions`\n- `allow-requestPermissions`",
+          "description": "Default permissions for the plugin\n#### This default permission set includes:\n\n- `allow-auth-with-safari`\n- `allow-auth-with-custom-tab`\n- `allow-copy-uri-to-path`\n- `allow-use-background-audio`\n- `allow-install-package`\n- `allow-set-system-ui-visibility`\n- `allow-get-status-bar-height`\n- `allow-get-sys-fonts-list`\n- `allow-intercept-keys`\n- `allow-lock-screen-orientation`\n- `allow-iap-initialize`\n- `allow-iap-fetch-products`\n- `allow-iap-purchase-product`\n- `allow-iap-restore-purchases`\n- `allow-get-system-color-scheme`\n- `allow-get-safe-area-insets`\n- `allow-get-screen-brightness`\n- `allow-set-screen-brightness`\n- `allow-request-manage-storage-permission`\n- `allow-checkPermissions`\n- `allow-requestPermissions`",
          "type": "string",
          "const": "default",
-          "markdownDescription": "Default permissions for the plugin\n#### This default permission set includes:\n\n- `allow-auth-with-safari`\n- `allow-auth-with-custom-tab`\n- `allow-copy-uri-to-path`\n- `allow-use-background-audio`\n- `allow-install-package`\n- `allow-set-system-ui-visibility`\n- `allow-get-status-bar-height`\n- `allow-get-sys-fonts-list`\n- `allow-intercept-keys`\n- `allow-lock-screen-orientation`\n- `allow-iap-initialize`\n- `allow-iap-fetch-products`\n- `allow-iap-purchase-product`\n- `allow-iap-restore-purchases`\n- `allow-get-system-color-scheme`\n- `allow-get-safe-area-insets`\n- `allow-request-manage-storage-permission`\n- `allow-checkPermissions`\n- `allow-requestPermissions`"
+          "markdownDescription": "Default permissions for the plugin\n#### This default permission set includes:\n\n- `allow-auth-with-safari`\n- `allow-auth-with-custom-tab`\n- `allow-copy-uri-to-path`\n- `allow-use-background-audio`\n- `allow-install-package`\n- `allow-set-system-ui-visibility`\n- `allow-get-status-bar-height`\n- `allow-get-sys-fonts-list`\n- `allow-intercept-keys`\n- `allow-lock-screen-orientation`\n- `allow-iap-initialize`\n- `allow-iap-fetch-products`\n- `allow-iap-purchase-product`\n- `allow-iap-restore-purchases`\n- `allow-get-system-color-scheme`\n- `allow-get-safe-area-insets`\n- `allow-get-screen-brightness`\n- `allow-set-screen-brightness`\n- `allow-request-manage-storage-permission`\n- `allow-checkPermissions`\n- `allow-requestPermissions`"
        }
      ]
    }
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/src/commands.rs
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/src/commands.rs
@ -127,6 +127,21 @@ pub(crate) async fn get_safe_area_insets<R: Runtime>(
    app.native_bridge().get_safe_area_insets()
 }

+#[command]
+pub(crate) async fn get_screen_brightness<R: Runtime>(
+    app: AppHandle<R>,
+) -> Result<GetScreenBrightnessResponse> {
+    app.native_bridge().get_screen_brightness()
+}
+
+#[command]
+pub(crate) async fn set_screen_brightness<R: Runtime>(
+    app: AppHandle<R>,
+    payload: SetScreenBrightnessRequest,
+) -> Result<SetScreenBrightnessResponse> {
+    app.native_bridge().set_screen_brightness(payload)
+}
+
 #[command]
 pub(crate) async fn request_manage_storage_permission<R: Runtime>(
    app: AppHandle<R>,
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/src/desktop.rs
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/src/desktop.rs
@ -107,6 +107,17 @@ impl<R: Runtime> NativeBridge<R> {
        Err(crate::Error::UnsupportedPlatformError)
    }

+    pub fn get_screen_brightness(&self) -> crate::Result<GetScreenBrightnessResponse> {
+        Err(crate::Error::UnsupportedPlatformError)
+    }
+
+    pub fn set_screen_brightness(
+        &self,
+        _payload: SetScreenBrightnessRequest,
+    ) -> crate::Result<SetScreenBrightnessResponse> {
+        Err(crate::Error::UnsupportedPlatformError)
+    }
+
    pub fn request_manage_storage_permission(
        &self,
    ) -> crate::Result<RequestManageStoragePermissionResponse> {
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/src/lib.rs
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/src/lib.rs
@ -53,6 +53,8 @@ pub fn init<R: Runtime>() -> TauriPlugin<R> {
            commands::iap_restore_purchases,
            commands::get_system_color_scheme,
            commands::get_safe_area_insets,
+            commands::get_screen_brightness,
+            commands::set_screen_brightness,
            commands::request_manage_storage_permission,
        ])
        .setup(|app, api| {
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/src/mobile.rs
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/src/mobile.rs
@ -170,6 +170,25 @@ impl<R: Runtime> NativeBridge<R> {
    }
 }

+impl<R: Runtime> NativeBridge<R> {
+    pub fn get_screen_brightness(&self) -> crate::Result<GetScreenBrightnessResponse> {
+        self.0
+            .run_mobile_plugin("get_screen_brightness", ())
+            .map_err(Into::into)
+    }
+}
+
+impl<R: Runtime> NativeBridge<R> {
+    pub fn set_screen_brightness(
+        &self,
+        payload: SetScreenBrightnessRequest,
+    ) -> crate::Result<SetScreenBrightnessResponse> {
+        self.0
+            .run_mobile_plugin("set_screen_brightness", payload)
+            .map_err(Into::into)
+    }
+}
+
 impl<R: Runtime> NativeBridge<R> {
    pub fn request_manage_storage_permission(
        &self,
--- a/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/src/models.rs
+++ b/apps/readest-app/src-tauri/plugins/tauri-plugin-native-bridge/src/models.rs
@ -168,6 +168,25 @@ pub struct GetSafeAreaInsetsResponse {
    pub right: f64,
 }

+#[derive(Debug, Deserialize, Serialize)]
+#[serde(rename_all = "camelCase")]
+pub struct GetScreenBrightnessResponse {
+    pub brightness: f64,
+}
+
+#[derive(Debug, Deserialize, Serialize)]
+#[serde(rename_all = "camelCase")]
+pub struct SetScreenBrightnessRequest {
+    pub brightness: f64, // 0.0 to 1.0
+}
+
+#[derive(Debug, Deserialize, Serialize)]
+#[serde(rename_all = "camelCase")]
+pub struct SetScreenBrightnessResponse {
+    pub success: bool,
+    pub error: Option<String>,
+}
+
 #[derive(Debug, Deserialize, Serialize)]
 #[serde(rename_all = "camelCase")]
 pub struct RequestManageStoragePermissionResponse {