device模块提供了与设备有关的信息与操作,例如获取设备宽高,内存使用率,IMEI,调整设备亮度、音量等。
此模块的部分函数,例如调整音量,需要”修改系统设置”的权限。如果没有该权限,会抛出SecurityException
并跳转到权限设置界面。
1、获取设备信息
device.width
设备屏幕分辨率宽度。例如1080。
device.height
设备屏幕分辨率高度。例如1920。
device.buildId
修订版本号,或者诸如"M4-rc20"的标识。
device.broad
设备的主板型号。
device.brand
与产品或硬件相关的厂商品牌,如"Xiaomi", "Huawei"等。
device.device
设备在工业设计中的名称。
deivce.model
设备型号。
device.product
整个产品的名称。
device.bootloader
设备Bootloader的版本。
device.hardware
设备的硬件名称(来自内核命令行或者/proc)。
device.fingerprint
构建(build)的唯一标识码。
device.serial
硬件序列号。
device.sdkInt
安卓系统API版本。例如安卓4.4的sdkInt为19。
device.incremental
device.release
Android系统版本号。例如"5.0", "7.1.1"。
device.baseOS
device.securityPatch
安全补丁程序级别。
device.codename
开发代号,例如发行版是"REL"。
device.getIMEI()
返回设备的IMEI.
device.getAndroidId()
返回设备的Android ID。
Android ID为一个用16进制字符串表示的64位整数,在设备第一次使用时随机生成,之后不会更改,除非恢复出厂设置。
device.getMacAddress()
返回设备的Mac地址。该函数需要在有WLAN连接的情况下才能获取,否则会返回null。
可能的后续修改:未来可能增加有root权限的情况下通过root权限获取,从而在没有WLAN连接的情况下也能返回正确的Mac地址,因此请勿使用此函数判断WLAN连接。
device.getTotalMem()
返回设备内存总量,单位字节(B)。1MB = 1024 * 1024B。
device.getAvailMem()
返回设备当前可用的内存,单位字节(B)。
device.getBattery()
0.0~100.0的浮点数
返回当前电量百分比。
device.isCharging()
返回设备是否正在充电。
2、获取并改变设备亮度
device.getBrightness()
返回当前的(手动)亮度。
device.getBrightnessMode()
返回当前亮度模式,0为手动亮度,1为自动亮度。
device.setBrightness(b)
b {number} 亮度,
如果当前是自动亮度模式,该函数不会影响屏幕的亮度。
此函数需要”修改系统设置”的权限。如果没有该权限,会抛出SecurityException并跳转到权限设置界面。
device.setBrightnessMode(mode)
mode {number} 亮度模式,
0为手动亮度,1为自动亮度 设置当前亮度模式。
此函数需要”修改系统设置”的权限。如果没有该权限,会抛出SecurityException并跳转到权限设置界面。
3、获取并改变设备音量
device.getMusicVolume()
返回当前媒体音量。
device.getNotificationVolume()
返回当前通知音量。
device.getAlarmVolume()
返回当前闹钟音量。
device.getMusicMaxVolume()
返回媒体音量的最大值。
device.getNotificationMaxVolume()
返回通知音量的最大值。
device.getAlarmMaxVolume()
返回闹钟音量的最大值。
device.setMusicVolume(volume)
volume {number} 音量
设置当前媒体音量。
此函数需要”修改系统设置”的权限。如果没有该权限,会抛出SecurityException并跳转到权限设置界面。
device.setNotificationVolume(volume)
volume {number} 音量
设置当前通知音量。
此函数需要”修改系统设置”的权限。如果没有该权限,会抛出SecurityException并跳转到权限设置界面。
device.setAlarmVolume(volume)
volume {number} 音量
设置当前闹钟音量。
此函数需要”修改系统设置”的权限。如果没有该权限,会抛出SecurityException并跳转到权限设置界面。
4、获取并改变设备屏幕状态
device.isScreenOn()
- 返回 {boolean}
返回设备屏幕是否是亮着的。如果屏幕亮着,返回true
; 否则返回false
。
需要注意的是,类似于vivo xplay系列的息屏时钟不属于”屏幕亮着”的情况,虽然屏幕确实亮着但只能显示时钟而且不可交互,此时isScreenOn()
也会返回false
。
device.wakeUp()
唤醒设备。包括唤醒设备CPU、屏幕等。可以用来点亮屏幕。
device.wakeUpIfNeeded()
如果屏幕没有点亮,则唤醒设备。
device.keepScreenOn([timeout])
timeout
{number} 屏幕保持常亮的时间, 单位毫秒。如果不加此参数,则一直保持屏幕常亮。
保持屏幕常亮。
此函数无法阻止用户使用锁屏键等正常关闭屏幕,只能使得设备在无人操作的情况下保持屏幕常亮;
同时,如果此函数调用时屏幕没有点亮,则会唤醒屏幕。
在某些设备上,如果不加参数timeout,只能在Auto.js的界面保持屏幕常亮,在其他界面会自动失效,这是因为设备的省电策略造成的。因此,建议使用比较长的时长来代替”一直保持屏幕常亮”的功能,例如device.keepScreenOn(3600 * 1000)
。
可以使用device.cancelKeepingAwake()
来取消屏幕常亮。
//一直保持屏幕常亮
device.keepScreenOn()
device.keepScreenDim([timeout])
timeout
{number} 屏幕保持常亮的时间, 单位毫秒。如果不加此参数,则一直保持屏幕常亮。
保持屏幕常亮,但允许屏幕变暗来节省电量。
此函数可以用于定时脚本唤醒屏幕操作,不需要用户观看屏幕,可以让屏幕变暗来节省电量。
此函数无法阻止用户使用锁屏键等正常关闭屏幕,只能使得设备在无人操作的情况下保持屏幕常亮;
同时,如果此函数调用时屏幕没有点亮,则会唤醒屏幕。
可以使用device.cancelKeepingAwake()
来取消屏幕常亮。
device.cancelKeepingAwake()
取消设备保持唤醒状态。
用于取消device.keepScreenOn()
, device.keepScreenDim()
等函数设置的屏幕常亮。
5、设置设备震动状态
device.vibrate(millis)
millis
{number} 震动时间,单位毫秒
使设备震动一段时间。
//震动两秒
device.vibrate(2000);
device.cancelVibration()
如果设备处于震动状态,则取消震动。
</br>