codecamp

快应用 设备信息

接口声明

{"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 1000+四种类型,可提供一至多个
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 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+

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

参数:

参数名 类型 必填 说明
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) 1000+

获取用户唯一标识

参数:

参数名 类型 必填 说明
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) 1000+

获取广告唯一标识

参数:

参数名 类型 必填 说明
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) 1000+

获取存储空间的总大小

参数:

参数名 类型 必填 说明
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) 1000+

获取存储空间的可用大小

参数:

参数名 类型 必填 说明
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) 1000+

返回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}`)
  }
})

后台运行限制

无限制。

后台运行详细用法参见 后台运行脚本


快应用 网络状态
快应用 屏幕亮度
温馨提示
下载编程狮App,免费阅读超1000+编程语言教程
取消
确定
目录

快应用 参考手册

快应用 安全

快应用 声音音频

关闭

MIP.setData({ 'pageTheme' : getCookie('pageTheme') || {'day':true, 'night':false}, 'pageFontSize' : getCookie('pageFontSize') || 20 }); MIP.watch('pageTheme', function(newValue){ setCookie('pageTheme', JSON.stringify(newValue)) }); MIP.watch('pageFontSize', function(newValue){ setCookie('pageFontSize', newValue) }); function setCookie(name, value){ var days = 1; var exp = new Date(); exp.setTime(exp.getTime() + days*24*60*60*1000); document.cookie = name + '=' + value + ';expires=' + exp.toUTCString(); } function getCookie(name){ var reg = new RegExp('(^| )' + name + '=([^;]*)(;|$)'); return document.cookie.match(reg) ? JSON.parse(document.cookie.match(reg)[2]) : null; }