my.setkeepscreenon(object object)
基础库 或更高版本； 且 支付宝客户端 10.1.8 或更高版本； 若版本较低，建议采取 兼容处理 。
支小宝客户端 支持
安诊儿客户端 支持
主体： 企业支付宝小程序 、 个人支付宝小程序
设置是否保持屏幕常亮。
常亮设置仅对当前小程序生效，离开小程序后自动失效。
object object
查看示例
| 属性 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|
| keepscreenon | boolean | false | 否 | 是否保持屏幕常亮状态 |
| success | function | - | 否 | 调用成功的回调函数 |
| fail | function | - | 否 | 调用失败的回调函数 |
| complete | function | - | 否 | 调用结束的回调函数（调用成功、失败都会执行）。 |
代码示例
扫码体验
js 代码
my.setkeepscreenon({
keepscreenon: true,
success: function (res) {
console.log(res);
},
fail: function (err) {
console.log(err);
}
});
-
tipmy.choosecity、my.choosevideo 等 api 会唤起外部的组件页面，因而会暂时解除 my.setkeepscreenon 设置的常亮状态，当关闭这类组件页面返回到小程序后，之前设置的常亮状态会恢复。
-
bug当 keepscreenon 传空或类型错误时，该 api 不会报错，而是执行 success 回调。使用时，请确保传入正确的 keepscreenon 值。