deviceInfo

来自于:开发者立即使用

getRelease getBrand getModel getId getDisplay getProduct getManufacturer getDevice getHardware getFingerprint getSerial getType getTags getHost getUser getCodename getIncremental getBoard getBootloader getTime getSdkInt

概述

deviceInfo模块封装了安卓手机获取手机硬件信息功能,使用此模块可实现对安卓手机的系统版本、SDK、设备名称、设备制造商等相关信息的获取。(有些机型未获取到相应参数时返回unknown)暂仅支持 android 平台。

getRelease

得到系统版本

getRelease(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. release: //系统版本
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getRelease(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("release=" + ret.release);
  5. });

补充说明

返回的数据是系统版本。

可用性

Android系统

可提供的1.0.0及更高版本

getBrand

得到设备品牌

getBrand(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. brand: //设备品牌
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getBrand(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("brand=" + ret.brand);
  5. });

补充说明

返回的数据是设备品牌。

可用性

Android系统

可提供的1.0.0及更高版本

getModel

得到手机型号

getModel(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. model: //手机型号
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getModel(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("model=" + ret.model);
  5. });

补充说明

返回的数据是手机型号。

可用性

Android系统

可提供的1.0.0及更高版本

getId

得到设备版本号

getId(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. id: //设备版本号
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getId(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("id=" + ret.id);
  5. });

补充说明

返回的数据是设备版本号。

可用性

Android系统

可提供的1.0.0及更高版本

getDisplay

得到设备显示版本包

getDisplay(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. display: //设备显示版本包
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getDisplay(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("display=" + ret.display);
  5. });

补充说明

返回的数据是设备显示版本包。

可用性

Android系统

可提供的1.0.0及更高版本

getProduct

得到产品名称

getProduct(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. product: //产品名称
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getProduct(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("product=" + ret.product);
  5. });

补充说明

返回的数据是产品名称(有些机型未获取到返回数据unknown)。

可用性

Android系统

可提供的1.0.0及更高版本

getManufacturer

得到设备制造商

getManufacturer(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. manufacturer: //设备制造商
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getManufacturer(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("manufacturer=" + ret.manufacturer);
  5. });

补充说明

返回的数据是设备制造商。

可用性

Android系统

可提供的1.0.0及更高版本

getDevice

得到设备驱动名称

getDevice(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. device: //设备驱动名称
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getDevice(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("device=" + ret.device);
  5. });

补充说明

返回的数据是设备驱动名称。

可用性

Android系统

可提供的1.0.0及更高版本

getHardware

得到设备硬件名称

getHardware(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. hardware: //设备硬件名称
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getHardware(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("hardware=" + ret.hardware);
  5. });

补充说明

返回的数据是设备硬件名称。

可用性

Android系统

可提供的1.0.0及更高版本

getFingerprint

得到设备唯一标识

getFingerprint(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. fingerprint: //设备唯一标识
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getFingerprint(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("fingerprint=" + ret.fingerprint);
  5. });

补充说明

返回的数据是设备唯一标识。

可用性

Android系统

可提供的1.0.0及更高版本

getSerial

得到串口序列号

getSerial(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. serial: //串口序列号
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getSerial(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("serial=" + ret.serial);
  5. });

补充说明

返回的数据是串口序列号。

可用性

Android系统

可提供的1.0.0及更高版本

getType

得到设备版本类型

getType(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. type: //设备版本类型
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getType(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("type=" + ret.type);
  5. });

补充说明

返回的数据是设备版本类型。

可用性

Android系统

可提供的1.0.0及更高版本

getTags

得到设备标签

getTags(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. tags: //设备标签
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getTags(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("tags=" + ret.tags);
  5. });

补充说明

返回的数据是设备标签。

可用性

Android系统

可提供的1.0.0及更高版本

getHost

得到设备主机地址

getHost(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. host: //设备主机地址
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getHost(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("host=" + ret.host);
  5. });

补充说明

返回的数据是设备主机地址。

可用性

Android系统

可提供的1.0.0及更高版本

getUser

得到设备用户名

getUser(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. user: //设备用户名
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getUser(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("user=" + ret.user);
  5. });

补充说明

返回的数据是设备用户名。

可用性

Android系统

可提供的1.0.0及更高版本

getCodename

得到固件开发版本代号

getCodename(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. codename: //固件开发版本代号
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getCodename(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("codename=" + ret.codename);
  5. });

补充说明

返回的数据是固件开发版本代号。

可用性

Android系统

可提供的1.0.0及更高版本

getIncremental

得到源码控制版本号

getIncremental(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. incremental: //源码控制版本号
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getIncremental(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("incremental=" + ret.incremental);
  5. });

补充说明

返回的数据是源码控制版本号。

可用性

Android系统

可提供的1.0.0及更高版本

getBoard

得到设备基板名称

getBoard(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. board: //设备基板名称
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getBoard(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("board=" + ret.board);
  5. });

补充说明

返回的数据是设备基板名称(有些机型未获取到返回数据unknown)。

可用性

Android系统

可提供的1.0.0及更高版本

getBootloader

得到设备引导程序版本号

getBootloader(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. bootloader: //设备引导程序版本号
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getBootloader(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("bootloader=" + ret.bootloader);
  5. });

补充说明

返回的数据是设备引导程序版本号(有些机型未获取到返回数据unknown)。

可用性

Android系统

可提供的1.0.0及更高版本

getTime

得到Build时间

getTime(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. time: //Build时间(为转换的时间)
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getTime(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("time=" + ret.time);
  5. });

补充说明

返回的数据是Build时间。

可用性

Android系统

可提供的1.0.0及更高版本

getSdkInt

得到系统的API级别

getSdkInt(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

  1. {
  2. sdkInt: //系统的API级别
  3. }

示例代码

  1. var deviceInfo= api.require('deviceInfo');
  2. deviceInfo.getSdkInt(function (ret, err) {
  3. console.log(JSON.stringify(ret));
  4. alert("sdkInt=" + ret.sdkInt);
  5. });

补充说明

返回的数据是系统的API级别。

可用性

Android系统

可提供的1.0.0及更高版本