外观
system.brightness 补充 API
约 266 字小于 1 分钟
2026-07-15
brightness.systembrightnessrecovery()
旧版 brightness feature 的内部恢复入口,用于把快应用修改过的亮度/屏幕状态恢复到系统值。
import app from '@system.app'
import brightness from '@system.brightness'
if (app.canIUse('@system.brightness.systembrightnessrecovery')) {
brightness.systembrightnessrecovery()
}方法无参数,固件未显示返回值或回调。它的职责是恢复由快应用亮度模块修改过的系统亮度/亮屏状态,适合在页面退出后的清理阶段调用。
onDestroy() {
try {
if (app.canIUse('@system.brightness.systembrightnessrecovery')) {
brightness.systembrightnessrecovery()
}
} catch (e) {}
}不要把它理解成“恢复出厂亮度”:它恢复的是 brightness feature 保存的系统状态,具体目标值由系统实现决定。若应用从未修改亮度,通常无需调用。
固件包含独立实现 __brightness_systembrightnessrecovery,但当前公开 JIDL 已不再声明该方法,因此只能视为版本私有兼容接口。
机型可用性
| Xiaomi Smart Band 10 Pro | Xiaomi Watch S4 41mm |
|---|---|
| ✅ | ✅ |
获取源代码
- JIDL:brightness.jidl(当前 JIDL 不再声明恢复入口)
- C++ 实现:brightness_impl.cpp