uni.setScreenBrightness(OBJECT)

设置屏幕亮度。

平台差异说明

App	HarmonyOS Next	H5	微信小程序	支付宝小程序	百度小程序	抖音小程序	飞书小程序	QQ小程序	快手小程序	京东小程序	元服务	小红书小程序
√	4.81	x	√	√	√	x	√	√	√	√	√	x

OBJECT 参数说明

参数名	类型	必填	说明
value	Number	是	屏幕亮度值，范围 0~1，0 最暗，1 最亮
success	Function	否	接口调用成功的回调
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

示例

uni.setScreenBrightness({
	value: 0.5,
	success: function () {
		console.log('success');
	}
});

Tips: 避免 onshow() 里使用 setScreenBrightness() , 亮度变化会再次触发 onShow() 造成死循环

uni.getScreenBrightness(OBJECT)

获取屏幕亮度。

平台差异说明

App	HarmonyOS Next	H5	微信小程序	支付宝小程序	百度小程序	抖音小程序	飞书小程序	QQ小程序	快手小程序	京东小程序	元服务	小红书小程序
√	4.81	x	√	√	√	x	√	√	√	√	√	x

OBJECT 参数说明

参数名	类型	必填	说明
success	Function	否	接口调用成功的回调
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

success 返回参数说明

参数	类型	说明
value	Number	屏幕亮度值，范围 0~1，0 最暗，1 最亮。

示例

uni.getScreenBrightness({
	success: function (res) {
		console.log('屏幕亮度值：' + res.value);
	}
});

uni.setKeepScreenOn(OBJECT)

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

平台差异说明

App	HarmonyOS Next	H5	微信小程序	支付宝小程序	百度小程序	抖音小程序、飞书小程序	QQ小程序	快手小程序	京东小程序	元服务	小红书小程序
√	4.81	x	√	√	√	√	√	√	√	√	x

OBJECT 参数说明

参数名	类型	必填	说明
keepScreenOn	Boolean	是	是否保持屏幕常亮
success	Function	否	接口调用成功的回调
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

success 返回参数说明

参数	类型	说明
errMsg	String	调用结果

示例

// 保持屏幕常亮
uni.setKeepScreenOn({
	keepScreenOn: true
});