uni.getScreenBrightness(options)

获取屏幕亮度。

getScreenBrightness 兼容性

Web	微信小程序	Android	iOS	HarmonyOS	HarmonyOS(Vapor)
x	4.41	5.08	5.08	4.81	5.0

参数

名称	类型	必填	默认值	兼容性	描述
options	GetScreenBrightnessOptions	是	-	Web 微信小程序 Android iOS HarmonyOS x - - - -
名称 类型 必备 默认值 兼容性 描述 success (result: GetScreenBrightnessSuccess) => void 否 - Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) x 4.41 5.08 5.08 4.81 5.0 成功返回的回调函数 fail (result: UniError) => void 否 - Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) x 4.41 5.08 5.08 4.81 5.0 失败的回调函数 complete (result: string) => void 否 - Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) x 4.41 5.08 5.08 4.81 5.0 结束的回调函数（调用成功、失败都会执行）

GetScreenBrightnessSuccess 的属性值

名称	类型	必备	默认值	兼容性	描述
value	number	是	-	Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) x 4.41 5.08 5.08 4.81 5.0	屏幕亮度值，范围 0~1，0 最暗，1 最亮。

的属性值

合法值	兼容性	描述
interface	Web 微信小程序 Android iOS HarmonyOS x - - - -	-
interface	Web 微信小程序 Android iOS HarmonyOS x - - - -	-

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

uni.setScreenBrightness(options)

设置屏幕亮度。

setScreenBrightness 兼容性

Web	微信小程序	Android	iOS	HarmonyOS	HarmonyOS(Vapor)
x	4.41	5.08	5.08	4.81	5.0

参数

名称	类型	必填	默认值	兼容性	描述
options	SetScreenBrightnessOptions	是	-	Web 微信小程序 Android iOS HarmonyOS x - - - -
名称 类型 必备 默认值 兼容性 描述 value number 是 - Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) x 4.41 5.08 5.08 4.81 5.0 屏幕亮度值，范围 0~1，0 最暗，1 最亮 success (result: SetScreenBrightnessSuccess) => void 否 - Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) x 4.41 5.08 5.08 4.81 5.0 接口调用成功的回调函数 fail (result: UniError) => void 否 - Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) x 4.41 5.08 5.08 4.81 5.0 接口调用失败的回调函数 complete (result: string) => void 否 - Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) x 4.41 5.08 5.08 4.81 5.0 接口调用结束的回调函数（调用成功、失败都会执行）

的属性值

合法值	兼容性	描述
interface	Web 微信小程序 Android iOS HarmonyOS x - - - -	-
interface	Web 微信小程序 Android iOS HarmonyOS x - - - -	-

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

uni.setKeepScreenOn(options)

设置是否保持常亮状态。仅在当前应用生效，离开应用后设置失效。

setKeepScreenOn 兼容性

Web	微信小程序	Android	iOS	HarmonyOS	HarmonyOS(Vapor)
5.08	4.41	5.08	5.08	4.81	5.0

参数

名称	类型	必填	默认值	兼容性	描述
options	SetKeepScreenOnOptions	是	-	- Web 微信小程序 Android iOS HarmonyOS - - - - -
名称 类型 必备 默认值 兼容性 描述 keepScreenOn boolean 是 - Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) 5.08 4.41 5.08 5.08 4.81 5.0 是否保持屏幕常亮 success (result: SetKeepScreenOnSuccess) => void 否 - Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) 5.08 4.41 5.08 5.08 4.81 5.0 接口调用成功的回调函数 fail (result: UniError) => void 否 - Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) 5.08 4.41 5.08 5.08 4.81 5.0 接口调用失败的回调函数 complete (result: string) => void 否 - Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) 5.08 4.41 5.08 5.08 4.81 5.0 接口调用结束的回调函数（调用成功、失败都会执行）

SetKeepScreenOnSuccess 的属性值

名称	类型	必备	默认值	兼容性	描述
errMsg	string	是	-	Web 微信小程序 Android iOS HarmonyOS HarmonyOS(Vapor) 5.08 4.41 5.08 5.08 4.81 5.0	调用结果

的属性值

合法值	兼容性	描述
interface	- Web 微信小程序 Android iOS HarmonyOS - - - - -	-
interface	Web 微信小程序 Android iOS HarmonyOS x - - - -	-

参见

• 相关 Bug
• 参见uni-app相关文档
• 微信小程序文档
• 支付宝小程序文档
• 百度小程序文档
• 抖音小程序文档
• 飞书小程序文档
• 钉钉小程序文档
• QQ小程序文档
• 快手小程序文档
• 京东小程序文档
• 华为快应用文档
• 360小程序文档

通用类型

GeneralCallbackResult

名称	类型	必备	默认值	兼容性	描述
errMsg	string	是	-	Web 微信小程序 Android iOS HarmonyOS - 4.41 - - -	错误信息