设备信息 device

接口声明

{ "name": "system.device" }

导入模块

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

接口定义

device.getInfo(OBJECT)

获取设备信息

参数：

success 返回值：

示例：

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

device.getId(OBJECT)

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

权限要求

获取手机状态

参数：

success 返回值：

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

fail 返回错误代码

示例：

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

device.getDeviceId(OBJECT) 1000+

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

权限要求

获取手机状态

参数：

success 返回值：

fail 返回错误代码

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+

获取用户唯一标识

参数：

success 返回值：

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+

获取广告唯一标识

参数：

success 返回值：

device.getAdvertisingId({
  success: function(data) {
    console.log(`handling success: ${data.advertisingId}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

device.getSerial(OBJECT) 1040+

获取设备序列号

权限要求

获取手机状态

参数：

success 返回值：

device.getSerial({
  success: function(data) {
    console.log(`handling success: ${data.serial}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

device.getTotalStorage(OBJECT) 1000+

获取存储空间的总大小

参数：

success 返回值：

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+

获取存储空间的可用大小

参数：

success 返回值：

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 信息

参数：

success 返回值：

device.getCpuInfo({
  success: function(data) {
    console.log(`handling success: ${data.cpuInfo}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

device.getOAID(OBJECT) 1060+

返回厂商设备标识符中的 OAID（匿名设备标识符）

参数：

success 返回值：

device.getOAID({
  success: function(data) {
    console.log(`handling success: ${data.oaid}`)
  },
  fail: function(data, code) {
    console.log(`handling fail, code = ${code}`)
  }
})

device.platform1030+

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

返回值：

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

示例：

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

属性 1060+

示例：

var device = require('@system.device')
var allowTrackOAID = device.allowTrackOAID

device.host1070+

同步方法获取宿主信息

返回值：

返回host对象。在应用模式下，返回引擎包名，如 org.hapjs.mockup。卡片模式下，返回加载卡片的宿主信息，包含下列属性

示例：

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

后台运行限制

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