回答
在 Hamibot 脚本中,你可以使用 device.keepScreenOn() 或 device.keepScreenDim() 来保持屏幕常亮,取消时调用 device.cancelKeepingAwake() 即可。
1. 完全保持屏幕常亮(推荐使用超时参数)
由于系统省电策略,无参数常亮在其他界面可能失效,建议使用一个很长的超时时间(例如 1 小时)来代替“一直常亮”:
// 文档地址 https://docs.hamibot.com/
device.keepScreenOn(3600 * 1000); // 保持常亮 1 小时
若确实需要一直常亮(可能受系统限制失效),可调用无参版本:
device.keepScreenOn();
2. 保持屏幕常亮但允许变暗(节省电量)
适合定时任务唤醒屏幕但不需用户一直观看的场景:
device.keepScreenDim(3600 * 1000); // 保持常亮 1 小时,允许屏幕变暗
3. 取消屏幕常亮
任务结束后务必取消,避免不必要的电量消耗:
device.cancelKeepingAwake();
注意
- 如果调用时屏幕未点亮,这些函数会自动唤醒屏幕。
- 用户仍可手动按锁屏键关闭屏幕,函数无法阻止物理按键锁屏。
- 如需修改系统亮度或亮度模式,可配合
device.setBrightness/device.setBrightnessMode使用,但需要“修改系统设置”权限。
ℹ️ 内容由 AI 生成,可能不准确,请注意核实