# com.monitor 库模块帮助文档

## com.monitor 成员列表 <a id="com.monitor" href="#com.monitor">&#x23;</a>

获取或设置显示器亮度。  
相关的库：sys.monitor, sys.display, sys.ddcci

### com.monitor.getBrightness() <a id="com.monitor.getBrightness" href="#com.monitor.getBrightness">&#x23;</a>
返回显示器亮度数值。  
可选在参数 @1 中指定要查询的设备 ID。  
不指定则返回首个找到的显示器亮度值。  
找不到显示器返回 null

### com.monitor.getBrightnessInfo() <a id="com.monitor.getBrightnessInfo" href="#com.monitor.getBrightnessInfo">&#x23;</a>
返回显示器亮度信息的表对象数组。  
在参数 @1 中指定要查询的设备 ID 则返回单个显示器亮度信息对象。  
关于返回的对象请参考 WMI WmiMonitorBrightness 类文档

### com.monitor.revertToPolicyBrightness(deviceId) <a id="com.monitor.revertToPolicyBrightness" href="#com.monitor.revertToPolicyBrightness">&#x23;</a>
恢复显示器亮度到默认设置，可选用 deviceId 指定设备 ID。

### com.monitor.setALSBrightness <a id="com.monitor.setALSBrightness" href="#com.monitor.setALSBrightness">&#x23;</a>
设置显示器环境光亮度

### com.monitor.setALSBrightness(brightness,deviceId) <a id="com.monitor.setALSBrightness" href="#com.monitor.setALSBrightness">&#x23;</a>
设置显示器环境光亮度  
brightness 为指定亮度百分比的数值。  
可选指定 deviceId，不指定则设置找到的第一个显示器。

### com.monitor.setALSBrightnessState(state,deviceId) <a id="com.monitor.setALSBrightnessState" href="#com.monitor.setALSBrightnessState">&#x23;</a>
state 指定是否启用显示器环境，deviceId 指定设备 ID。

### com.monitor.setBrightness(brightness,deviceId,timeout) <a id="com.monitor.setBrightness" href="#com.monitor.setBrightness">&#x23;</a>
设置显示器亮度。  
brightness 为指定亮度百分比的数值。  
可选指定 deviceId，不指定则设置找到的第一个显示器。  
timeout 指定超时，以秒为单位，可省略。