#$device - 设备信息

• 更新时间:2026-02-08 19:43:36

设备信息

#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

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