系统函数

设备信息

12 个函数

获取屏幕状态

System.screenState(): (integer, integer)

读取屏幕是否点亮，以及设备是否处于锁屏状态。

参数无参数
返回值返回值可以不接收
序号名称类型返回说明
1 屏幕点亮 整 屏幕点亮返回1，熄灭返回0。
2 设备锁定 整 设备已锁定返回1，未锁定返回0。

获取设备信息

System.device(key: string): string

按信息项返回设备资料。mac表示当前可读取的WLAN或Wi-Fi网卡地址；系统隐藏或随机化地址时可能返回空字符串或随机地址，不能用作永久设备唯一标识。

参数1 项
序号名称类型参数说明
1 key 字 要读取的设备信息项。
返回值返回值可以不接收
序号名称类型返回说明
1 设备信息 字 返回所选设备信息；信息项无效时返回空字符串。

获取屏幕分辨率

System.screen(): (integer, integer)

返回设备完整显示区域的像素宽度和高度，顺序固定为宽、高。

参数无参数
返回值返回值可以不接收
序号名称类型返回说明
1 屏幕宽 整 屏幕像素宽度，查询失败返回0。
2 屏幕高 整 屏幕像素高度，查询失败返回0。

获取屏幕亮度

System.brightness(): integer

读取设备当前屏幕亮度设置，数值范围为0到255。

参数无参数
返回值返回值可以不接收
序号名称类型返回说明
1 屏幕亮度 整 成功返回0到255，读取失败返回-1。

获取自动熄屏时间

System.screenTimeout(): integer

读取设备无操作后自动熄屏的等待时间。

参数无参数
返回值返回值可以不接收
序号名称类型返回说明
1 等待时间 整 成功返回毫秒数，读取失败返回-1。

获取系统日期

System.date(): (integer, integer, integer, integer)

返回设备当前时区下的年、月、日和星期。星期一为1，依次递增，星期日为7。

参数无参数
返回值返回值可以不接收
序号名称类型返回说明
1 年 整 四位年份。
2 月 整 月份，范围1到12。
3 日 整 当月日期，范围1到31。
4 星期 整 星期一为1，星期日为7。

获取系统时间

System.time(): (integer, integer, integer, integer)

返回设备当前时区下的时、分、秒和毫秒，使用24小时制。

参数无参数
返回值返回值可以不接收
序号名称类型返回说明
1 时 整 小时，范围0到23。
2 分 整 分钟，范围0到59。
3 秒 整 秒，范围0到59。
4 毫秒 整 当前秒内的毫秒，范围0到999。

获取系统时间戳

System.timeMillis(): integer

返回设备当前系统时间对应的13位Unix毫秒时间戳。修改设备日期时间后，这个值会随系统时钟变化。

参数无参数
返回值返回值可以不接收
序号名称类型返回说明
1 毫秒时间戳 整 从1970-01-01 00:00:00 UTC开始计算的整数毫秒数。

获取完整日期时间

System.dateTime(): string

返回设备当前时区下的日期时间，固定格式为yyyy-MM-dd HH:mm:ss。

参数无参数
返回值返回值可以不接收
序号名称类型返回说明
1 日期时间 字 固定格式示例：2026-07-24 12:30:45。

判断网络是否连接

System.isConnected(): integer

判断设备当前是否存在具备互联网能力的活动网络。

参数无参数
返回值返回值可以不接收
序号名称类型返回说明
1 连接状态 整 已连接返回1，未连接返回0，查询失败返回-1。

判断互联网是否可用

System.isValidated(): integer

判断当前网络是否已经通过系统的互联网连通性验证。网络已连接但无法访问互联网时返回0。

参数无参数
返回值返回值可以不接收
序号名称类型返回说明
1 可用状态 整 互联网可用返回1，不可用返回0，查询失败返回-1。

判断Wi-Fi是否开启

System.isWifiEnabled(): integer

读取设备当前的Wi-Fi开关状态。

参数无参数
返回值返回值可以不接收
序号名称类型返回说明
1 开启状态 整 Wi-Fi已开启返回1，已关闭返回0，查询失败返回-1。