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