system.setIdleTimer()

类型 函数
system.*
返回值
修订版本 Release 2024.3703
关键字 system timer
另请参见 system.getIdleTimer()

概述

控制是否启用空闲计时器。如果设置为 true,计时器将处于活动状态(默认)或在 false 时处于非活动状态。处于活动状态时,空闲计时器会调暗屏幕并在一段时间内没有用户活动时使设备进入睡眠状态。

陷阱

电池寿命

当大多数应用程序在短时间内没有触摸作为用户输入时,系统会将设备置于屏幕调暗的“睡眠”状态。这样做是为了节电。然而,那些除了加速度计之外没有用户输入的应用程序——例如游戏——可以通过将此属性设置为 false 来禁用“空闲计时器”以避免系统睡眠。

你应该仅在必要时设置此属性,并且务必在不再需要时将其重置为 true。大多数应用程序都应在空闲计时器结束后让系统关闭屏幕。这包括音频应用程序。唯一应禁用空闲计时器的应用程序是映射应用程序、游戏或类似的用户交互零散的程序。

语法

system.setIdleTimer( enabled )
enabled (必需的)

布尔. 传递 true 启用空闲计时器;false 禁用它。

示例

system.setIdleTimer( false )  -- disable (turn off) the idle timer
 
system.setIdleTimer( true )  -- enable (turn on) the idle timer