$device - 设备信息#

• 更新时间:2025-12-13 11:58:44

设备信息

const {int} 宽度;#

屏幕的宽度

const {int} 高度;#

屏幕的高度

const {String} buildId;#

Build ID

const {String} buildDisplay;#

Build Display

const {String} 产品;#

产品名称

const {String} 主板;#

主板名称

const {String} 品牌;#

品牌名称

const {String} 设备;#

设备名称

const {String} 型号;#

型号名称

const {String} 引导程序;#

引导加载程序名称

const {String} 硬件;#

硬件名称

const {String} 指纹;#

指纹信息

const {int} sdk版本号;#

SDK版本号

const {String} 内部版本;#

内部版本号

const {String} 发行版;#

Android版本号

const {String} 开发代号;#

开发代号

const {String} 序列号;#

序列号

const {String} 操作系统版本;#

基础操作系统版本

仅在Android 6.0及更高版本中有效

const {String} 安全补丁版本;#

安全补丁版本

仅在Android 6.0及更高版本中有效

获取imei()#

获取IMEI号码

• 返回 : {字符串} IMEI号码

• 版本 : 1.7.0

日志("IMEI:", $设备.获取imei());

获取安卓id()#

获取Android ID

• 返回 : {字符串} Android ID

• 版本 : 1.7.0

日志("Android ID:", $设备.获取安卓id());

获取屏幕亮度()#

获取屏幕亮度

• 返回 : {整数} 屏幕亮度

• 版本 : 1.7.0

日志("屏幕亮度:", $设备.获取屏幕亮度());

获取屏幕亮度模式()#

获取屏幕亮度模式

• 返回 : {整数} 亮度模式

• 版本 : 1.7.0

日志("屏幕亮度模式:", $设备.获取屏幕亮度模式());

获取音乐音量()#

获取音乐音量

• 返回 : {整数} 音乐音量值

• 版本 : 1.7.0

日志("音乐音量:", $设备.获取音乐音量());

获取通知音量()#

获取通知音量

• 返回 : {整数} 通知音量值

• 版本 : 1.7.0

日志("通知音量:", $设备.获取通知音量());

获取闹钟音量()#

获取闹钟音量

• 返回 : {整数} 闹钟音量值

• 版本 : 1.7.0

日志("闹钟音量:", $设备.获取闹钟音量());

获取音乐最大音量()#

获取音乐最大音量

• 返回 : {整数} 音乐最大音量值

• 版本 : 1.7.0

日志("音乐最大音量:", $设备.获取音乐最大音量());

获取通知最大音量()#

获取通知最大音量

• 返回 : {整数} 通知最大音量值

• 版本 : 1.7.0

日志("通知最大音量:", $设备.获取通知最大音量());

获取闹钟最大音量()#

获取闹钟最大音量

• 返回 : {整数} 闹钟最大音量值

• 版本 : 1.7.0

日志("闹钟最大音量:", $设备.获取闹钟最大音量());

获取电量百分比()#

电池电量百分比

• 返回 : {整数} 电池电量百分比

• 版本 : 1.7.0

日志("电池电量百分比:", $设备.获取电量百分比());

获取总内存()#

获取总内存

• 返回 : {长整数} 总内存大小，单位为字节

• 版本 : 1.7.0

日志("总内存:", $设备.获取总内存());

获取可用内存()#

获取可用内存

• 返回 : {长整数} 可用内存大小，单位为字节

• 版本 : 1.7.0

日志("可用内存:", $设备.获取可用内存());

是充电中()#

是否正在充电

• 返回 : {布尔值} 如果设备正在充电则返回true，否则返回false

• 版本 : 1.7.0

日志("是否正在充电:", $设备.是充电中());

是亮屏的()#

判断设备屏幕是否亮起

• 返回 : {布尔值} true:亮起

• 版本 : 1.7.0

日志("是否亮起:", $设备.是亮屏的());

是息屏的()#

判断设备屏幕是否熄灭

• 返回 : {布尔值} true:熄灭

• 版本 : 1.7.0

日志("是否熄灭:", $设备.是息屏的());

唤醒设备()#

唤醒设备屏幕

• 版本 : 1.7.0

// 唤醒设备屏幕
$设备.唤醒设备();

保持屏幕常亮()#

保持设备屏幕常亮

• 版本 : 1.7.0

// 保持屏幕常亮
$设备.保持屏幕常亮();

保持屏幕常亮(timeout)#

保持设备屏幕常亮一段时间

• 参数 : timeout {长整数} 保持屏幕常亮的超时时间，单位为毫秒

• 版本 : 1.7.0

// 保持屏幕常亮
$设备.保持屏幕常亮(1000);

保持屏幕低亮()#

保持设备屏幕处于低亮度状态

• 版本 : 1.7.0

// 保持屏幕低亮
$设备.保持屏幕低亮();

保持屏幕低亮(timeout)#

保持设备屏幕处于低亮度状态

• 版本 : 1.7.0

// 保持屏幕低亮
$设备.保持屏幕低亮(1000);

取消唤醒()#

取消保持唤醒

• 版本 : 1.7.0

// 取消唤醒
$设备.取消唤醒();

震动(时长)#

震动指定时长

• 参数 : 时长 {长整数} 震动的时长，单位:ms

• 版本 : 1.7.0

// 震动
$设备.震动(1000);

取消震动()#

取消震动

• 版本 : 1.7.0

// 取消震动
$设备.取消震动();

获取mac地址()#

获取 MAC 地址 首先尝试从 WifiManager 获取，如果获取到的是伪造的 MAC 地址则视为无效 若无效则尝试通过网络接口获取，若还是无效且系统版本大于等于 Android 7.0（N）， 则尝试从文件中读取

• 返回 : MAC 地址，如果无法获取则返回 null

• 版本 : 1.7.0

// 获取mac地址
日志("mac地址:",$设备.获取mac地址());

有导航栏()#

是否存在导航栏

• 返回 : {布尔值} 是否存在NavigationBar

• 版本 : 1.7.0

// 是否存在导航栏
日志("是否存在导航栏:",$设备.有导航栏());

获取导航栏高度()#

获取虚拟功能键高度

• 返回 : {整数} 虚拟功能键高度

• 版本 : 1.7.0

// 导航栏高度
日志("导航栏高度:",$设备.获取导航栏高度());

是锁定的()#

判断设备是否锁定

• 返回 : {布尔值} 是否锁定

• 版本 : 1.7.0

// 设备是否锁定
日志("设备是否锁定:",$设备.是锁定的());