教程 其他 框架 组件 接口

设备信息

接口声明

{ "name": "system.device" }

导入模块

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状态栏高度

示例:

device.getInfo({
  success: function(ret) {
    console.log(`handling success, brand = ${ret.brand}`)
  }
})

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用户拒绝授权

示例:

device.getId({
  type: ['device', 'mac'],
  success: function(data) {
    console.log(`handling success: ${data.device}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

device.getDeviceId(OBJECT) 1000+

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

权限要求

获取手机状态

参数:

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

device.getUserId(OBJECT) 1000+

获取用户唯一标识

参数:

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

device.getAdvertisingId(OBJECT) 1000+

获取广告唯一标识

参数:

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

device.getTotalStorage(OBJECT) 1000+

获取存储空间的总大小

参数:

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

device.getAvailableStorage(OBJECT) 1000+

获取存储空间的可用大小

参数:

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

device.getCpuInfo(OBJECT) 1000+

返回 CPU 信息

参数:

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

device.platform1030+

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

返回值:

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

| 属性 | 类型 | 说明 | | versionName | String | 运行平台版本名称 | | versionCode | Integer | 运行平台版本号 |

示例:

var device = require('@system.device')
var platform = device.platform
var versionName = platform.versionName
var versionCode = platform.versionCode

条匹配 "" 的结果

    没有搜索到与 "" 相关的内容