设备信息-device
稳定device
device 模块提供了与设备有关的信息与操作，例如获取设备宽高，内存使用率，IMEI，调整设备亮度、音量等。
device.width
return{number}
设备屏幕分辨率宽度。例如 1080。
device.height
return{number}
设备屏幕分辨率高度。例如 1920。
device.buildId
return{string}
修订版本号，或者诸如"M4-rc20"的标识。
device.broad
return{string}
The name of the underlying board, like "goldfish".
设备的主板(?)型号。
device.brand
return{string}
The consumer-visible brand with which the product/hardware will be associated, if any.
与产品或硬件相关的厂商品牌，如"Xiaomi", "Huawei"等。
device.device
return{string}
The name of the industrial design.
设备在工业设计中的名称。
device.model
return{string}
The end-user-visible name for the end product.
设备型号。
device.product
return{string}
The name of the overall product.
整个产品的名称。
device.bootloader
return{string}
The system bootloader version number.
设备 Bootloader 的版本。
device.hardware
return{string}
The name of the hardware (from the kernel command line or /proc).
设备的硬件名称(来自内核命令行或者/proc)。
device.fingerprint
return{string}
A string that uniquely identifies this build. Do not attempt to parse this value.
构建(build)的唯一标识码。
device.serial
return{string}
A hardware serial number, if available. Alphanumeric only, case-insensitive.
硬件序列号。
device.sdkInt
return{number}
The user-visible SDK version of the framework; its possible values are defined in Build.VERSION_CODES.
安卓系统 API 版本。例如安卓 4.4 的 sdkInt 为 19。
device.incremental
return{string}
The internal value used by the underlying source control to represent this build. E.g., a perforce changelist number or a git hash.
device.release
return{string}
The user-visible version string. E.g., "1.0" or "3.4b5".
Android 系统版本号。例如"5.0", "7.1.1"。
device.baseOS
return{string}
The base OS build the product is based on.
device.securityPatch
return{string}
The user-visible security patch level.
安全补丁程序级别。
device.codename
return{string}
The current development codename, or the string "REL" if this is a release build.
开发代号，例如发行版是"REL"。
device.getIMEI()
return{string}
返回设备的 IMEI.
device.getAndroidId()
return{string}
返回设备的 Android ID。
Android ID 为一个用 16 进制字符串表示的 64 位整数，在设备第一次使用时随机生成，之后不会更改，除非恢复出厂设置。
device.getMacAddress()
实验return{string}
返回设备的 Mac 地址。该函数需要在有 WLAN 连接的情况下才能获取，否则会返回 null。
可能的后续修改：未来可能增加有 root 权限的情况下通过 root 权限获取，从而在没有 WLAN 连接的情况下也能返回正确的 Mac 地址，因此请勿使用此函数判断 WLAN 连接。
device.getBrightness()
return{number}
返回当前的(手动)亮度。范围为 0~255。
device.getBrightnessMode()
return{number}
返回当前亮度模式，0 为手动亮度，1 为自动亮度。
device.setBrightness(b)
b{number} 亮度，范围 0~255
设置当前手动亮度。如果当前是自动亮度模式，该函数不会影响屏幕的亮度。
此函数需要"修改系统设置"的权限。如果没有该权限，会抛出 SecurityException 并跳转到权限设置界面。
device.setBrightnessMode(mode)
mode{number} 亮度模式，0 为手动亮度，1 为自动亮度
设置当前亮度模式。
此函数需要"修改系统设置"的权限。如果没有该权限，会抛出 SecurityException 并跳转到权限设置界面。
device.getMusicVolume()
return{number} 整数值
返回当前媒体音量。
device.getNotificationVolume()
return{number} 整数值
返回当前通知音量。
device.getAlarmVolume()
return{number} 整数值
返回当前闹钟音量。
device.getMusicMaxVolume()
return{number} 整数值
返回媒体音量的最大值。
device.getNotificationMaxVolume()
return{number} 整数值
返回通知音量的最大值。
device.getAlarmMaxVolume()
return{number} 整数值
返回闹钟音量的最大值。
device.setMusicVolume(volume)
volume{number} 音量
设置当前媒体音量。
此函数需要"修改系统设置"的权限。如果没有该权限，会抛出 SecurityException 并跳转到权限设置界面。
device.setNotificationVolume(volume)
volume{number} 音量
设置当前通知音量。
此函数需要"修改系统设置"的权限。如果没有该权限，会抛出 SecurityException 并跳转到权限设置界面。
device.setAlarmVolume(volume)
volume{number} 音量
设置当前闹钟音量。
此函数需要"修改系统设置"的权限。如果没有该权限，会抛出 SecurityException 并跳转到权限设置界面。
device.getBattery()
return{number} 0.0~100.0 的浮点数
返回当前电量百分比。
device.isCharging()
return{boolean}
返回设备是否正在充电。
device.getTotalMem()
return{number}
返回设备内存总量，单位字节(B)。1MB = 1024 * 1024B。
device.getAvailMem()
return{number}
返回设备当前可用的内存，单位字节(B)。
device.isScreenOn()
return{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()等函数设置的屏幕常亮。
device.vibrate(millis)
millis{number} 震动时间，单位毫秒
使设备震动一段时间。
//震动两秒
device.vibrate(2000);
device.cancelVibration()
v4.2.7+如果设备处于震动状态，则取消震动。
device.checkDeviceHasNavigationBar()
v4.2.7+return{boolean}
设备是否存储虚拟导航栏
device.getVirtualBarHeigh()
v4.2.7+return{number}
返回导航栏的高度 设备虚拟导航栏的高度,可以用设备高度 减去 这个高度，再按一定比例 点击底部附件的坐标