telephoneInfo

来自于：开发者

getTelephoneInfos getSimInfo getPhoneStateInfo

概述

telephoneInfo模块封装了安卓手机获取手机通讯相关信息，使用此模块可实现对安卓手机设备信息（手机号码、设备id等）、SIM卡信息（SIM卡的序列号等）、网络信息和电话的相关状态信息的获取。暂仅支持 android 平台（android5.0及以上版本）。

getTelephoneInfos

得到手机通讯所有相关信息

getTelephoneInfos(callback(ret, err))

ret：

• 类型：JSON 对象

内部字段：

示例代码

telephoneInfo.getTelephoneInfos(function (ret, err) {
    console.log(JSON.stringify(ret));
    alert("手机通讯所有相关信息" + "\n" +JSON.stringify(ret));
});

补充说明

返回的数据是手机通讯所有相关信息（如无数据，字段返回为空）。

可用性

Android系统

可提供的1.0.0及更高版本

getDeviceInfo

得到设备信息

getDeviceInfo(callback(ret, err))

callback(ret, err)

• 类型：JSON 对象

内部字段：

{
    cellLocation:    //设备当前位置  
    deviceId:    //设备ID  
    deviceSoftwareVersion:    //设备软件版本号  
    line1Number:    //手机号码  
}

示例代码

返回的数据是设备信息（如无数据，字段返回为空）。

可用性

Android系统

可提供的1.0.0及更高版本

getSimInfo

得到SIM卡信息

getSimInfo(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    simCountryIso:    //SIM的ISO国家代码
    simOperator:    //SIM提供商的MCC + MNC
    simSerialNumber:    //SIM卡的序列号
    simState:    //SIM卡的状态
    subscriberId:    //订户ID
}

示例代码

var telephoneInfo = api.require('telephoneInfo');
    console.log(JSON.stringify(ret));
    alert("SIM卡信息" + "\n" + JSON.stringify(ret));
});

补充说明

返回数据是SIM卡信息（如无数据，字段返回为空）。

可用性

Android系统

可提供的1.0.0及更高版本

getNetworkInfo

得到网络信息

ret：

• 类型：JSON 对象

内部字段：

示例代码

var telephoneInfo = api.require('telephoneInfo');
telephoneInfo.getNetworkInfo(function (ret, err) {
    console.log(JSON.stringify(ret));
    alert("网络信息" + "\n" + JSON.stringify(ret));

补充说明

返回的数据是网络信息（如无数据，字段返回为空）。

可用性

Android系统

可提供的1.0.0及更高版本

getPhoneStateInfo

得到电话相关状态信息

getPhoneStateInfo(callback(ret, err))

callback(ret, err)

ret：

• 类型：JSON 对象

内部字段：

{
    callState:     //电话当前状态
    groupIdLevel1:     //GSM电话组标识符级别1
    mmsUAProfUrl:     //MMS用户代理配置文件URL
    mmsUserAgent:     //MMS用户代理
    phoneType:     //电话类型
    voiceMailAlphaTag:     //检索与语音邮件编号关联的字母标识符
    voiceMailNumber:     //语音邮件号码
    hasCarrierPrivileges:     //运营商权限
    hasIccCard:     //ICC卡存在
    isNetworkRoaming:     //是否支持网络上漫游
    isSmsCapable:     //是否支持短信服务

示例代码

返回的数据是电话相关状态信息（如无数据，字段返回为空）。

可用性

Android系统

可提供的1.0.0及更高版本