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 对象

内部字段：

{
    release:    //系统版本
}

示例代码

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

补充说明

返回的数据是系统版本。

可用性

Android系统

可提供的1.0.0及更高版本

getBrand

得到设备品牌

getBrand(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    brand:    //设备品牌
}

示例代码

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

补充说明

返回的数据是设备品牌。

可用性

Android系统

可提供的1.0.0及更高版本

getModel

得到手机型号

getModel(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    model:    //手机型号
}

示例代码

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

补充说明

返回的数据是手机型号。

可用性

Android系统

可提供的1.0.0及更高版本

getId

得到设备版本号

getId(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    id:    //设备版本号
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getDisplay

得到设备显示版本包

getDisplay(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    display:    //设备显示版本包
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getProduct

得到产品名称

getProduct(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    product:    //产品名称
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getManufacturer

得到设备制造商

getManufacturer(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    manufacturer:    //设备制造商
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getDevice

得到设备驱动名称

getDevice(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    device:    //设备驱动名称
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getHardware

得到设备硬件名称

getHardware(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    hardware:    //设备硬件名称
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getFingerprint

得到设备唯一标识

getFingerprint(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    fingerprint:    //设备唯一标识
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getSerial

得到串口序列号

getSerial(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    serial:    //串口序列号
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getType

得到设备版本类型

getType(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    type:    //设备版本类型
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getTags

得到设备标签

getTags(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    tags:    //设备标签
}

示例代码

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

补充说明

返回的数据是设备标签。

可用性

Android系统

可提供的1.0.0及更高版本

getHost

得到设备主机地址

getHost(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    host:    //设备主机地址
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getUser

得到设备用户名

getUser(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    user:    //设备用户名
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getCodename

得到固件开发版本代号

getCodename(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    codename:    //固件开发版本代号
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getIncremental

得到源码控制版本号

getIncremental(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    incremental:    //源码控制版本号
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getBoard

得到设备基板名称

getBoard(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    board:    //设备基板名称
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getBootloader

得到设备引导程序版本号

getBootloader(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    bootloader:    //设备引导程序版本号
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本

getTime

得到Build时间

getTime(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    time:    //Build时间(为转换的时间)
}

示例代码

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

补充说明

返回的数据是Build时间。

可用性

Android系统

可提供的1.0.0及更高版本

getSdkInt

得到系统的API级别

getSdkInt(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    sdkInt:    //系统的API级别
}

示例代码

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

补充说明

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

可用性

Android系统

可提供的1.0.0及更高版本