### uni.setScreenBrightness(OBJECT) 设置屏幕亮度。 **平台差异说明** |App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|飞书小程序|QQ小程序|快手小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|x|√|√|√| **OBJECT 参数说明** |参数名|类型|必填|说明| |:-|:-|:-|:-| |value|Number|是|屏幕亮度值,范围 0~1,0 最暗,1 最亮| |success|Function|否|接口调用成功的回调| |fail|Function|否|接口调用失败的回调函数| |complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)| **示例** ```javascript uni.setScreenBrightness({ value: 0.5, success: function () { console.log('success'); } }); ``` >*Tips:* 避免 onshow() 里使用 setScreenBrightness() , 亮度变化会再次触发 onShow() 造成死循环 ### uni.getScreenBrightness(OBJECT) 获取屏幕亮度。 **平台差异说明** |App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序|飞书小程序|QQ小程序|快手小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|x|√|√|√| **OBJECT 参数说明** |参数名|类型|必填|说明| |:-|:-|:-|:-| |success|Function|否|接口调用成功的回调| |fail|Function|否|接口调用失败的回调函数| |complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)| **success 返回参数说明** |参数|类型|说明| |:-|:-|:-| |value|Number|屏幕亮度值,范围 0~1,0 最暗,1 最亮。| **示例** ```javascript uni.getScreenBrightness({ success: function (res) { console.log('屏幕亮度值:' + res.value); } }); ``` ### uni.setKeepScreenOn(OBJECT) 设置是否保持常亮状态。仅在当前应用生效,离开应用后设置失效。 **平台差异说明** |App|H5|微信小程序|支付宝小程序|百度小程序|字节跳动小程序、飞书小程序|QQ小程序|快手小程序| |:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:| |√|x|√|√|√|√|√|√| **OBJECT 参数说明** |参数名|类型|必填|说明| |:-|:-|:-|:-| |keepScreenOn|Boolean|是|是否保持屏幕常亮| |success|Function|否|接口调用成功的回调| |fail|Function|否|接口调用失败的回调函数| |complete|Function|否|接口调用结束的回调函数(调用成功、失败都会执行)| **success 返回参数说明** |参数|类型|说明| |:-|:-|:-| |errMsg|String|调用结果| **示例** ```javascript // 保持屏幕常亮 uni.setKeepScreenOn({ keepScreenOn: true }); ```