Device
模块提供了与设备有关的信息与操作,例如获取设备宽高,内存使用率,IMEI,调整设备亮度、音量等。
此模块的部分函数,例如调整音量,需要"修改系统设置"的权限
// 获取设备长度 返回值 int
var width = Device.width
// 获取设备高度 返回值 int
var height = Device.height
// 获取设备的Android ID,返回值,string
var id = Device.getAndroidId()
// 获取设备的IMEI. 返回值,string
var imei = Device.getIMEI()
// 获取mac地址 返回值,string。wifi开启才有值
var macaddress = Device.getMacAddress()
// 设备屏幕亮度 返回值 int
var brightness= Device.getBrightness()
// 设置屏幕亮度
Device.setBrightness(int v)
// 获取屏幕亮度模式 返回值int, 0-手动调节,1-自动调节
var mode = Device.getBrightnessMode()
// 设置屏幕亮度模式
Device.setBrightnessMode(int v)
// 获取媒体音量,返回值 int
var volume = Device.getMusicVolume()
// 设置媒体音量
Device.setMusicVolume(int v)
// 获取媒体最大音量
var max = Device.getMusicMaxVolume()
// 获取通知音量,返回值 int
var volume = Device.getNotificationVolume()
// 设置通知音量
Device.setNotificationVolume(int v)
// 获取通知最大音量
var max = Device.setNotificationVolume()
// 返回当前电量百分比, 返回值 0.0~100.0的浮点数
var battery = Device.getBattery()
/**
返回设备屏幕是否是亮着的。如果屏幕亮着,返回true; 否则返回false。
需要注意的是,类似于vivo xplay系列的息屏时钟不属于"屏幕亮着"的情况,虽然屏幕确实亮着但只能显示时钟而且不可交互,此时isScreenOn()也会返回false。
*/
var isOn = Device.isScreenOn()
// 唤醒设备。包括唤醒设备CPU、屏幕等。可以用来点亮屏幕。
Device.wakeUp()
// 如果屏幕没有点亮,则唤醒设备。
Device.wakeUpIfNeeded()
/**
屏幕保持常亮的时间, 单位毫秒。如果不加此参数,则一直保持屏幕常亮。此函数无法阻止用户使用锁屏键等正常关闭屏幕,只能使得设备在无人操作的情况下保持屏幕常亮;同时,如果此函数调用时屏幕没有点亮,则会唤醒屏幕。
在某些设备上,如果不加参数timeout,只能在Aj的界面保持屏幕常亮,在其他界面会自动失效,这是因为设备的省电策略造成的。因此,建议使用比较长的时长来代替"一直保持屏幕常
*/
Device.keepScreenOn(int timeout)
/**
屏幕保持常亮的时间, 单位毫秒。如果不加此参数,则一直保持屏幕常亮。
保持屏幕常亮,但允许屏幕变暗来节省电量。此函数可以用于定时脚本唤醒屏幕操作,不需要用户观看屏幕,可以让屏幕变暗来节省电量。
此函数无法阻止用户使用锁屏键等正常关闭屏幕,只能使得设备在无人操作的情况下保持屏幕常亮;同时,如果此函数调用时屏幕没有点亮,则会唤醒屏幕。
可以使用Device.cancelKeepingAwake()来取消屏幕常亮。
*/
Device.keepScreenDim(int timeout)
/**
取消设备保持唤醒状态。用于取消device.keepScreenOn(), device.keepScreenDim()等函数设置的屏幕常亮。
*/
Device.cancelKeepingAwake()
/**
使设备震动一段时间。震动时间,单位毫秒
*/
Device.vibrate(int time)
// 如果设备处于震动状态,则取消震动。
Device.cancelVibration()