更新记录

1.0.0（2026-03-16）

• 支持统一调用 setBrightness(options)
• 支持查询当前亮度和常亮状态
• 支持恢复默认亮度
• 支持开启 / 关闭屏幕常亮
• 支持打开系统设置入口
• 支持查询当前设备能力
• 提供完整模板页和实际测试页

平台兼容性

uni-app(4.75)

uni-app x(4.75)

austin-screen-control

austin-screen-control 是一个统一的 Android / iOS 屏幕亮度与常亮控制插件。

当前目录下的 index.vue 是完整模板页，演示的是一套新人拿来就能试的亮度与常亮页面，包含：

• 当前亮度状态展示
• 拖动滑块调节亮度
• 常用亮度预设按钮
• 恢复默认亮度
• 开启 / 关闭屏幕常亮
• 打开系统设置
• 完整示例代码

试用说明

• 可以直接点击“试用插件”
• 试用内容就是完整模板页，已经把亮度滑块、常亮开关和常见场景按钮都摆好了
• 页面层不需要区分 Android 和 iOS，直接调用同一套方法即可
• Android 调整的是当前页面亮度，不修改系统全局亮度
• iOS 支持前台屏幕亮度调整和屏幕常亮，设置入口会跳到应用设置页

功能特性

• 支持统一调用 setBrightness(options)
• 支持查询当前亮度和常亮状态
• 支持恢复默认亮度
• 支持开启 / 关闭屏幕常亮
• 支持打开系统设置入口
• 支持查询当前设备能力
• 提供完整模板页和实际测试页

安装

将 uni_modules/austin-screen-control 目录复制到项目的 uni_modules 目录下。

模板页示例：

• index.vue

API

setBrightness(options)

设置亮度。

参数：

• value: 亮度值，范围 0 ~ 1

getScreenState()

获取当前屏幕状态，返回：

• supported
• platform
• brightness
• brightnessPercent
• keepScreenOn
• usingCustomBrightness
• brightnessScope
• supportsBrightness
• supportsKeepScreenOn
• supportsOpenSettings
• settingsTarget
• notes

resetBrightness()

恢复默认亮度。

setKeepScreenOn(enabled)

设置是否保持屏幕常亮。

isKeepScreenOn()

获取当前是否保持屏幕常亮。

openSystemSettings()

打开系统设置入口：

• Android：显示设置
• iOS：当前应用设置页

最小调用

import {
  setBrightness,
  resetBrightness,
  setKeepScreenOn,
  getScreenState,
} from '@/uni_modules/austin-screen-control'

setBrightness({ value: 0.8 })
setKeepScreenOn(true)

const state = getScreenState()
console.log(state)

resetBrightness()

模板页试用方法

1. 点击“试用插件”
2. 先拖动亮度滑块，观察当前亮度变化
3. 再点“扫码更亮”“视频观看”“夜间柔和”这些常见场景按钮
4. 打开“保持屏幕常亮”开关，锁屏前先看当前状态是否已变更
5. 最后点“恢复默认亮度”或“打开系统设置”继续测试

注意事项

• 页面层不需要自己判断平台
• Android 和 iOS 会走同一套调用
• Android 调整的是当前页面亮度，不修改系统全局亮度
• iOS 调整的是前台屏幕亮度，建议在退出相关页面时恢复默认亮度
• 真机效果会因系统策略和设备屏幕不同而有所差异