deviceInfo
概述
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及更高版本