phoneInfo

来自于：开发者立即使用

• Method

getBaseInfo getCpuInfo getMemoryInfo getStorageInfo getDisplayInfo

概述

phoneInfo 封装了获取手机基本信息、CPU 信息、内存信息、存储信息、显示信息等功能，使用 phoneInfo 模块基本上可以获取所有常用的手机设备信息。

getBaseInfo

获取手机基本信息

getBaseInfo(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:                       //操作成功状态值
    brand:                          //品牌
    model:                          //型号
    manufacturer:                //制造商
    version:                     //系统版本
    sdkVersion:                  //系统SDK版本
    id:                             //设备串号
    macAddress:                  //mac地址
    bootTime:                     //开机时间
}

err：

• 类型：JSON 对象
• 内部字段：

{
    msg:""                //错误描述
}

示例代码

var phoneInfo = api.require('phoneInfo');
phoneInfo.getBaseInfo(function(ret, err) {
    if (ret.status) {
        api.alert({
            msg: '品牌：' + ret.brand + '\r\n' +
                '型号：' + ret.model + '\r\n' +
                '制造商：' + ret.manufacturer + '\r\n' +
                'Android版本：' + ret.version + '\r\n' +
                'AndroidSDK版本：' + ret.sdkVersion + '\r\n' +
                '设备串号：' + ret.id + '\r\n' +
                'Mac地址：' + ret.macAddress + '\r\n' +
                '开机时间：' + ret.bootTime + '分钟'
        });
    } else {
        api.alert({ msg: err.msg });
    }
});

可用性

Android系统

可提供的1.0.0及更高版本

getCpuInfo

获取CPU信息

getCpuInfo(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:                       //操作成功状态值
    architecture:                  //CPU架构
    coreNumber:                      //CPU核心数
    minFrequency:                 //CPU最低频率
    maxFrequency:                 //CPU最高频率
}

err：

• 类型：JSON 对象
• 内部字段：

{
    msg:""    //错误描述
}

示例代码

var phoneInfo = api.require('phoneInfo');
phoneInfo.getCpuInfo(function(ret, err) {
    if (ret.status) {
        api.alert({
            msg: 'CPU架构：' + ret.architecture + '\r\n' +
                'CPU核心数：' + ret.coreNumber + '\r\n' +
                'CPU最高频率：' + ret.minFrequency + '\r\n' +
                'CPU最低频率：' + ret.maxFrequency
        });
    } else {
        api.alert({ msg: err.msg });
    }
});

可用性

Android系统

可提供的1.0.0及更高版本

getMemoryInfo

获取内存信息

getMemoryInfo(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:                       //操作成功状态值
    totalMemory:                  //内存总大小
    availableMemory:              //可用内存大小
}

err：

• 类型：JSON 对象
• 内部字段：

{
    msg:""    //错误描述
}

示例代码

var phoneInfo = api.require('phoneInfo');
phoneInfo.getMemoryInfo(function(ret, err) {
    if (ret.status) {
        api.alert({
            msg: '内存大小：' + ret.totalMemory + '\r\n' +
                '可用内存大小：' + ret.availableMemory
        });
    } else {
        api.alert({ msg: err.msg });
    }
});

可用性

Android系统

可提供的1.0.0及更高版本

getStorageInfo

获取手机存储信息

getStorageInfo(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:                   //操作成功状态值
    sdCardStatus:              //SD卡的状态，返回如下值：
                                //1001    未设置SD卡为御载，直接拔出SD卡后的状态
                                //1002    手机正在检测SD卡过程中的状态
                                //1003    SD卡正常使用的状态，并具有读写的权限
                                //1004    SD卡正常使用的状态，但只有读的权限
                                //1005    手动设置SD卡为御载之后，再拔出SD卡之后 的状态
                                //1006    手机连接电脑，SD卡做为U盘使用之后的状态
                                //1007    SD卡不可被安装
                                //1008    手工设置SD卡为御载之后的状态
                                //0        没有获取到SD卡的状态
    sdCardPath:                  //SD卡的路径
    sdCardTotalSize:          //SD卡总大小
    sdCardAvailableSize:    //SD卡可用大小
    romTotalSize:           //手机自身存储大小
    romAvailableSize:        //手机自身可用存储大小
    romPath:                   //手机自身存储路径
}

err：

• 类型：JSON 对象
• 内部字段：

{
    msg:""    //错误描述
}

示例代码

var phoneInfo = api.require('phoneInfo');
phoneInfo.getStorageInfo(function(ret, err) {
    if (ret.status) {
        api.alert({
            msg: 'SD卡状态：' + ret.sdCardStatus + '\r\n' +
                'SD卡路径：' + ret.sdCardPath + '\r\n' +
                'SD总容量：' + ret.sdCardTotalSize + '\r\n' +
                'SD可用容量：' + ret.sdCardAvailableSize + '\r\n' +
                'Rom路径：' + ret.romPath + '\r\n' +
                'Rom总容量：' + ret.romTotalSize + '\r\n' +
                'Rom可用容量：' + ret.romAvailableSize
        });
    } else {
        api.alert({ msg: err.msg });
    }
});

可用性

Android系统

可提供的1.0.0及更高版本

getDisplayInfo

获取手机显示信息

getDisplayInfo(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象
• 内部字段：

{
    status:                   //操作成功状态值
    width:                      //屏幕宽度（单位为像素）
    height:                  //屏幕高度（单位为像素）
    densityDpi:                //屏幕密度（单位为dpi）
}

err：

• 类型：JSON 对象
• 内部字段：

{
    msg:""    //错误描述
}

示例代码

var phoneInfo = api.require('phoneInfo');
phoneInfo.getDisplayInfo(function(ret, err) {
    if (ret.status) {
        api.alert({
            msg: '分辨率：' + ret.width + 'x' + ret.height + '\r\n' +
                '屏幕密度：' + ret.densityDpi + 'dpi'
        });
    } else {
        api.alert({ msg: err.msg });
    }
});

可用性

Android系统

可提供的1.0.0及更高版本