设备信息

接口声明

  1. { "name": "system.device" }

导入模块

  1. import device from '@system.device' 或 const device = require('@system.device')

接口定义

device.getInfo(OBJECT)

获取设备信息

参数：

参数名类型必填说明
successFunction否成功回调
failFunction否失败回调
completeFunction否执行结束后的回调
success 返回值：
参数值类型说明
brandString设备品牌
manufacturerString设备生产商
modelString设备型号
productString设备代号
osTypeString操作系统名称
osVersionNameString操作系统版本名称
osVersionCodeInteger操作系统版本号
platformVersionNameString运行平台版本名称
platformVersionCodeInteger运行平台版本号
languageString系统语言
regionString系统地区
screenWidthInteger屏幕宽
screenHeightInteger屏幕高
windowWidth 1030+Integer可使用窗口宽度
windowHeight 1030+Integer可使用窗口高度
statusBarHeight 1030+Integer状态栏高度
screenDensity 1040+Float设备的屏幕密度

示例：

  1. device.getInfo({
  2.   success: function(ret) {
  3.     console.log(`handling success， brand = ${ret.brand}`)
  4.   }
  5. })

device.getId(OBJECT)

批量获取设备标识，需要用户授权

权限要求

获取手机状态

参数：

参数名类型必填说明
typeArray是支持 device、mac、user、advertising 1000+四种类型，可提供一至多个
successFunction否成功回调
failFunction否失败回调
completeFunction否执行结束后的回调
success 返回值：

按照传入的 type 返回对应的 id，未在 type 中出现的 id 类型不会返回

参数名类型说明
deviceString设备唯一标识。在 Android 上返回 IMEI 或 MEID
macString设备的 mac 地址。在 Android M 及以上返回固定值：02:00:00:00:00:00
userString用户唯一标识。在 Android 上返回 androidid
advertising 1000+String广告唯一标识
fail 返回错误代码
错误码说明
201用户拒绝授权

示例：

  1. device.getId({
  2.   type: ['device', 'mac'],
  3.   success: function(data) {
  4.     console.log(`handling success: ${data.device}`)
  5.   },
  6.   fail: function(data, code) {
  7.     console.log(`handling fail, code = ${code}`)
  8.   }
  9. })

device.getDeviceId(OBJECT) 1000+

获取设备唯一标识。需要用户授权

权限要求

获取手机状态

参数：

参数名类型必填说明
successFunction否成功回调
failFunction否失败回调
completeFunction否执行结束后的回调
success 返回值：
参数值类型说明
deviceIdString设备唯一标识。在 Android 上返回 IMEI 或 MEID
fail 返回错误代码
错误码说明
201用户拒绝授权
  1. device.getDeviceId({
  2.   success: function(data) {
  3.     console.log(`handling success: ${data.deviceId}`)
  4.   },
  5.   fail: function(data, code) {
  6.     console.log(`handling fail, code = ${code}`)
  7.   }
  8. })

device.getUserId(OBJECT) 1000+

获取用户唯一标识

参数：

参数名类型必填说明
successFunction否成功回调
failFunction否失败回调
completeFunction否执行结束后的回调
success 返回值：
参数值类型说明
userIdString设备唯一标识。在 Android 上返回 androidid
  1. device.getUserId({
  2.   success: function(data) {
  3.     console.log(`handling success: ${data.userId}`)
  4.   },
  5.   fail: function(data, code) {
  6.     console.log(`handling fail, code = ${code}`)
  7.   }
  8. })

device.getAdvertisingId(OBJECT) 1000+

获取广告唯一标识

参数：

参数名类型必填说明
successFunction否成功回调
failFunction否失败回调
completeFunction否执行结束后的回调
success 返回值：
参数值类型说明
advertisingIdString广告唯一标识
  1. device.getAdvertisingId({
  2.   success: function(data) {
  3.     console.log(`handling success: ${data.advertisingId}`)
  4.   },
  5.   fail: function(data, code) {
  6.     console.log(`handling fail, code = ${code}`)
  7.   }
  8. })

device.getSerial(OBJECT) 1040+

获取设备序列号

权限要求

获取手机状态

参数：

参数名类型必填说明
successFunction否成功回调
failFunction否失败回调
completeFunction否执行结束后的回调
success 返回值：
参数值类型说明
serialString设备序列号
  1. device.getSerial({
  2.   success: function(data) {
  3.     console.log(`handling success: ${data.serial}`)
  4.   },
  5.   fail: function(data, code) {
  6.     console.log(`handling fail, code = ${code}`)
  7.   }
  8. })

device.getTotalStorage(OBJECT) 1000+

获取存储空间的总大小

参数：

参数名类型必填说明
successFunction否成功回调
failFunction否失败回调
completeFunction否执行结束后的回调
success 返回值：
参数值类型说明
totalStorageLong存储空间的总大小，单位是 Byte。在 Android 上返回的是外部存储的总大小
  1. device.getTotalStorage({
  2.   success: function(data) {
  3.     console.log(`handling success: ${data.totalStorage}`)
  4.   },
  5.   fail: function(data, code) {
  6.     console.log(`handling fail, code = ${code}`)
  7.   }
  8. })

device.getAvailableStorage(OBJECT) 1000+

获取存储空间的可用大小

参数：

参数名类型必填说明
successFunction否成功回调
failFunction否失败回调
completeFunction否执行结束后的回调
success 返回值：
参数值类型说明
availableStorageLong存储空间的可用大小，单位是 Byte。在 Android 上返回的是外部存储的可用大小
  1. device.getAvailableStorage({
  2.   success: function(data) {
  3.     console.log(`handling success: ${data.availableStorage}`)
  4.   },
  5.   fail: function(data, code) {
  6.     console.log(`handling fail, code = ${code}`)
  7.   }
  8. })

device.getCpuInfo(OBJECT) 1000+

返回 CPU 信息

参数：

参数名类型必填说明
successFunction否成功回调
failFunction否失败回调
completeFunction否执行结束后的回调
success 返回值：
参数值类型说明
cpuInfoStringCPU 信息。在 Android 上返回的是/proc/cpuinfo 文件的内容
  1. device.getCpuInfo({
  2.   success: function(data) {
  3.     console.log(`handling success: ${data.cpuInfo}`)
  4.   },
  5.   fail: function(data, code) {
  6.     console.log(`handling fail, code = ${code}`)
  7.   }
  8. })

device.platform1030+

同步方法获取平台版本信息

返回值：

返回 platform 对象，包含下列属性

属性类型说明
versionNameString运行平台版本名称
versionCodeInteger运行平台版本号

示例：

  1. var device = require('@system.device')
  2. var platform = device.platform
  3. var versionName = platform.versionName
  4. var versionCode = platform.versionCode

后台运行限制

无限制。后台运行详细用法参见后台运行 脚本。