# uni.setScreenBrightness(OBJECT)

设置屏幕亮度。

平台差异说明

App HarmonyOS Next H5 微信小程序 支付宝小程序 百度小程序 抖音小程序 飞书小程序 QQ小程序 快手小程序 京东小程序
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小程序 快手小程序 京东小程序
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小程序 快手小程序 京东小程序
x x

OBJECT 参数说明

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

success 返回参数说明

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

示例

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