如何使用 wx.setKeepScreenOn 设置屏幕常亮状态？

推荐答案

// www.javascriptcn.com code example
wx.setKeepScreenOn({
  keepScreenOn: true,
  success(res) {
    console.log('屏幕常亮设置成功', res);
  },
  fail(err) {
    console.error('屏幕常亮设置失败', err);
  }
});

本题详细解读

1. wx.setKeepScreenOn 的作用

wx.setKeepScreenOn 是微信小程序提供的一个 API，用于设置屏幕是否保持常亮状态。通过调用该 API，可以防止屏幕在一段时间后自动熄灭。

2. 参数说明

• keepScreenOn: 布尔值，设置为 true 时，屏幕保持常亮；设置为 false 时，屏幕恢复正常熄灭行为。
• success: 设置成功后的回调函数，返回一个包含成功信息的对象。
• fail: 设置失败后的回调函数，返回一个包含错误信息的对象。

3. 使用场景

• 在需要长时间展示内容的场景下，如视频播放、阅读等，可以使用该 API 保持屏幕常亮，提升用户体验。
• 在不需要常亮时，应及时将 keepScreenOn 设置为 false，以节省电量。

4. 注意事项

• 该 API 仅在当前小程序页面有效，页面切换或小程序进入后台时，屏幕常亮设置会自动失效。
• 频繁调用该 API 可能会影响设备性能，建议在必要时使用。