telephoneInfo

来自于:开发者立即使用

来自于:开发者

概述

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

getTelephoneInfos

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

getTelephoneInfos(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

{
    callState:    //电话当前状态
    cellLocation:    //设备当前位置
    dataActivity:    //数据活动类型
    dataState:    //数据连接状态
    deviceId:    //设备ID
    deviceSoftwareVersion:    //设备软件版本号
    groupIdLevel1:    //GSM电话组标识符级别1
    line1Number:    //手机号码
    mmsUAProfUrl:    //MMS用户代理配置文件URL
    mmsUserAgent:    //MMS用户代理
    networkCountryIso:    //网络的ISO国家代码
    networkOperator:    //注册操作员的数字名称
    networkOperatorName:    //注册的操作员的字母名称
    networkType:    //数据连接类型
    phoneType:    //电话类型
    simCountryIso:    //SIM的ISO国家代码
    simOperator:    //SIM提供商的MCC + MNC
    simOperatorName:    //SIM提供者名称(SPN)
    simSerialNumber:    //SIM卡的序列号
    simState:    //SIM卡的状态
    subscriberId:    //订户ID
    voiceMailAlphaTag:    /检索与语音邮件编号关联的字母标识符
    voiceMailNumber:    //语音邮件号码
    hasCarrierPrivileges:    //运营商权限
    hasIccCard:    //ICC卡存在
    isNetworkRoaming:    //是否支持网络上漫游
    isSmsCapable:    //是否支持短信服务
    isVoiceCapable:    //是否支持语音功能
}

示例代码

var telephoneInfo = api.require('telephoneInfo');
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)

ret:

  • 类型:JSON 对象

内部字段:

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

示例代码

var telephoneInfo = api.require('telephoneInfo');
telephoneInfo.getDeviceInfo(function (ret, err) {
    console.log(JSON.stringify(ret));
    alert("设备信息" + "\n" + JSON.stringify(ret)));
});

补充说明

返回的数据是设备信息(如无数据,字段返回为空)。

可用性

Android系统

可提供的1.0.0及更高版本

getSimInfo

得到SIM卡信息

getSimInfo(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:

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

示例代码

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

补充说明

返回数据是SIM卡信息(如无数据,字段返回为空)。

可用性

Android系统

可提供的1.0.0及更高版本

getNetworkInfo

得到网络信息

getNetworkInfo(callback(ret, err))

callback(ret, err)

ret:

  • 类型:JSON 对象

内部字段:


{
    dataActivity:     //数据活动类型
    dataState:     //数据连接状态
    networkCountryIso:     //网络的ISO国家代码
    networkOperator:     //注册操作员的数字名称
    networkOperatorName:     //注册的操作员的字母名称
    networkType:     //数据连接类型
}

示例代码

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:     //是否支持短信服务
    isVoiceCapable:     //是否支持语音功能
}

示例代码

var telephoneInfo = api.require('telephoneInfo');
telephoneInfo.getPhoneStateInfo(function (ret, err) {
    console.log(JSON.stringify(ret));
    alert("电话相关状态信息" + "\n" + JSON.stringify(ret));
});

补充说明

返回的数据是电话相关状态信息(如无数据,字段返回为空)。

可用性

Android系统

可提供的1.0.0及更高版本