设备信息

接口声明

{"name": "system.device"}

导入模块

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

接口定义

device.getInfo(OBJECT)

获取设备信息

参数:

参数名 类型 必填 说明
success Function 成功回调
fail Function 失败回调
complete Function 执行结束后的回调
success返回值:
参数值 类型 说明
brand String 设备品牌
manufacturer String 设备生产商
model String 设备型号
product String 设备代号
osType String 操作系统名称
osVersionName String 操作系统版本名称
osVersionCode Integer 操作系统版本号
platformVersionName String 运行平台版本名称
platformVersionCode Integer 运行平台版本号
language String 系统语言
region String 系统地区
screenWidth Integer 屏幕宽
screenHeight Integer 屏幕高

示例:

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

device.getId(OBJECT)

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

参数:

参数名 类型 必填 说明
type Array 支持device、mac、user、advertising 正式版本可用四种类型,可提供一至多个
success Function 成功回调
fail Function 失败回调
complete Function 执行结束后的回调
success返回值:

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

参数名 类型 说明
device String 设备唯一标识。在Android上返回IMEI或MEID
mac String 设备的mac地址。在Android M及以上返回固定值:02:00:00:00:00:00
user String 用户唯一标识。在Android上返回androidid
advertising 正式版本可用 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) 正式版本可用

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

参数:

参数名 类型 必填 说明
success Function 成功回调
fail Function 失败回调
complete Function 执行结束后的回调
success返回值:
参数值 类型 说明
deviceId String 设备唯一标识。在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) 正式版本可用

获取用户唯一标识

参数:

参数名 类型 必填 说明
success Function 成功回调
fail Function 失败回调
complete Function 执行结束后的回调
success返回值:
参数值 类型 说明
userId String 设备唯一标识。在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) 正式版本可用

获取广告唯一标识

参数:

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

device.getTotalStorage(OBJECT) 正式版本可用

获取存储空间的总大小

参数:

参数名 类型 必填 说明
success Function 成功回调
fail Function 失败回调
complete Function 执行结束后的回调
success返回值:
参数值 类型 说明
totalStorage Long 存储空间的总大小,单位是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) 正式版本可用

获取存储空间的可用大小

参数:

参数名 类型 必填 说明
success Function 成功回调
fail Function 失败回调
complete Function 执行结束后的回调
success返回值:
参数值 类型 说明
availableStorage Long 存储空间的可用大小,单位是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) 正式版本可用

返回CPU信息

参数:

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

条匹配 "" 的结果

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