Android电话信息相关API

转载自:http://www.linuxidc.com/Linux/2011-10/45049.htm

android平台提供的电话信息系统管理功能,主要包括:获取电话信息(设备信息、SIM信息以及网络信息)、侦听电话状态(呼叫状态、服务状态、信号强度状态等)和调用电话拨号器。

TelephoneManager类

 在Manifest中添加Permission :<uses-permission Android:name="android.permission.READ_PHONE_STATE" />

 

TelephonyManager的获得:TelephonyManager tm = (TelephonyManager) this.getSystemService(TELEPHONY_SERVICE);

Constants

String

ACTION_PHONE_STATE_CHANGED

Broadcast intent action indicating that the call state (cellular) on the device has changed.

int

CALL_STATE_IDLE

Device call state: No activity.

空闲(无呼入或已挂机)

int

CALL_STATE_OFFHOOK

Device call state: Off-hook.

摘机(有呼入)

int

CALL_STATE_RINGING

Device call state: Ringing.

响铃(接听中)

int

DATA_ACTIVITY_DORMANT

Data connection is active, but physical link is down

电话数据活动状态类型:睡眠模式(3.1版本)

int

DATA_ACTIVITY_IN

Data connection activity: Currently receiving IP PPP traffic.

电话数据活动状态类型:数据流入

int

DATA_ACTIVITY_INOUT

Data connection activity: Currently both sending and receiving IP PPP traffic.

电话数据活动状态类型:数据交互

int

DATA_ACTIVITY_NONE

Data connection activity: No traffic.

电话数据活动状态类型:无数据流动

int

DATA_ACTIVITY_OUT

Data connection activity: Currently sending IP PPP traffic.

电话数据活动状态类型:数据流出

int

DATA_CONNECTED

Data connection state: Connected.

数据连接状态类型:已连接

int

DATA_CONNECTING

Data connection state: Currently setting up a data connection.

数据连接状态类型:正在连接

int

DATA_DISCONNECTED

Data connection state: Disconnected.

数据连接状态类型:断开

int

DATA_SUSPENDED

Data connection state: Suspended.

数据连接状态类型:已暂停

String

EXTRA_INCOMING_NUMBER

The lookup key used with the ACTION_PHONE_STATE_CHANGED broadcast for a String containing the incoming phone number.

String

EXTRA_STATE

The lookup key used with the ACTION_PHONE_STATE_CHANGED broadcast for a String containing the new call state.

int

NETWORK_TYPE_1xRTT

Current network is 1xRTT

int

NETWORK_TYPE_CDMA

Current network is CDMA: Either IS95A or IS95B

int

NETWORK_TYPE_EDGE

Current network is EDGE

int

NETWORK_TYPE_EHRPD

Current network is eHRPD

int

NETWORK_TYPE_EVDO_0

Current network is EVDO revision 0

int

NETWORK_TYPE_EVDO_A

Current network is EVDO revision A

int

NETWORK_TYPE_EVDO_B

Current network is EVDO revision B

int

NETWORK_TYPE_GPRS

Current network is GPRS

int

NETWORK_TYPE_HSDPA

Current network is HSDPA

int

NETWORK_TYPE_HSPA

Current network is HSPA

int

NETWORK_TYPE_HSPAP

Current network is HSPA+

int

NETWORK_TYPE_HSUPA

Current network is HSUPA

int

NETWORK_TYPE_IDEN

Current network is iDen

int

NETWORK_TYPE_LTE

Current network is LTE

int

NETWORK_TYPE_UMTS

Current network is UMTS

int

NETWORK_TYPE_UNKNOWN

Network type is unknown

int

PHONE_TYPE_CDMA

Phone radio is CDMA.

int

PHONE_TYPE_GSM

Phone radio is GSM.

int

PHONE_TYPE_NONE

No phone radio.

int

PHONE_TYPE_SIP

Phone is via SIP.

int

SIM_STATE_ABSENT

SIM card state: no SIM card is available in the device

int

SIM_STATE_NETWORK_LOCKED

SIM card state: Locked: requries a network PIN to unlock

int

SIM_STATE_PIN_REQUIRED

SIM card state: Locked: requires the user's SIM PIN to unlock

int

SIM_STATE_PUK_REQUIRED

SIM card state: Locked: requires the user's SIM PUK to unlock

int

SIM_STATE_READY

SIM card state: Ready

int

SIM_STATE_UNKNOWN

SIM card state: Unknown.

Fields

public static final String

EXTRA_STATE_IDLE

Value used with EXTRA_STATE corresponding to CALL_STATE_IDLE.

public static final String

EXTRA_STATE_OFFHOOK

Value used with EXTRA_STATE corresponding to CALL_STATE_OFFHOOK.

public static final String

EXTRA_STATE_RINGING

Value used with EXTRA_STATE corresponding to CALL_STATE_RINGING.

Public Methods

int

getCallState()

Returns a constant indicating the call state (cellular) on the device.

CellLocation

getCellLocation()

Returns the current location of the device.

int

getDataActivity()

Returns a constant indicating the type of activity on a data connection (cellular).

处理侦测到的数据活动的改变事件。通过该函数,可以获取数据活动状态信息。

电话数据活动状态类型定义在TelephoneyManager类中。

DATA_ACTIVITY_NONE            无数据流动

DATA_ACTIVITY_IN数据流入

DATA_ACTIVITY_OUT数据流出

DATA_ACTIVITY_INOUT数据交互

DATA_ACTIVITY_DORMANT     睡眠模式(2.1版本)

int

getDataState()

Returns a constant indicating the current data connection state (cellular).

String

getDeviceId()

Returns the unique device ID, for example, the IMEI for GSM and the MEID or ESN for CDMA phones.

获取设备标识(IMEI)

String

getDeviceSoftwareVersion()

Returns the software version number for the device, for example, the IMEI/SV for GSM phones.

获得软件版本

String

getLine1Number()

Returns the phone number string for line 1, for example, the MSISDN for a GSM phone.

线路1的电话号码

List<NeighboringCellInfo>

getNeighboringCellInfo()

Returns the neighboring cell information of the device.

String

getNetworkCountryIso()

Returns the ISO country code equivalent of the current registered operator's MCC (Mobile Country Code).

获取网络的国家ISO代码

String

getNetworkOperator()

Returns the numeric name (MCC+MNC) of current registered operator.

获取SIM移动国家代码(MCC)和移动网络代码(MNC)

String

getNetworkOperatorName()

Returns the alphabetic name of current registered operator. 

获取服务提供商姓名(中国移动、中国联通等)

int

getNetworkType()

Returns a constant indicating the radio technology (network type) currently in use on the device for data transmission.

获取网络类型

NETWORK_TYPE_UNKNOWN 未知网络

NETWORK_TYPE_GPRS

NETWORK_TYPE_EDGE 通用分组无线服务(2.5G)

NETWORK_TYPE_UMTS全球移动通信系统(3G)

NETWORK_TYPE_HSDPA

NETWORK_TYPE_HSUPA

NETWORK_TYPE_HSPA

NETWORK_TYPE_CDMACDMA网络(2.1版本)

NETWORK_TYPE_EVDO_0CDMA2000EV-DO版本0(2.1版本)

NETWORK_TYPE_EVDO_ACDMA2000EV-DO版本A(2.1版本)

NETWORK_TYPE_EVDO_BCDMA2000EV-DO版本B(2.1版本)

NETWORK_TYPE_1xRTTCDMA20001xRTT(2.1版本)

NETWORK_TYPE_IDEN

NETWORK_TYPE_LTE

NETWORK_TYPE_EHRPD

NETWORK_TYPE_HSPAP

int

getPhoneType()

Returns a constant indicating the device phone type.

电话类型

PHONE_TYPE_NONE   未知

PHONE_TYPE_GSMGSM手机

PHONE_TYPE_CDMACDMA手机(2.1版本)

PHONE_TYPE_SIP         via SIP手机

String

getSimCountryIso()

Returns the ISO country code equivalent for the SIM provider's country code.

获取SIM卡中国家ISO代码

String

getSimOperator()

Returns the MCC+MNC (mobile country code + mobile network code) of the provider of the SIM.

获得SIM卡中移动国家代码(MCC)和移动网络代码(MNC)

String

getSimOperatorName()

Returns the Service Provider Name (SPN).

获取服务提供商姓名(中国移动、中国联通等)

String

getSimSerialNumber()

Returns the serial number of the SIM, if applicable.

SIM卡序列号

int

getSimState()

Returns a constant indicating the state of the device SIM card.

SIM卡状态

SIM_STATE_UNKNOWN                   未知状态

SIM_STATE_ABSENT 未插卡

SIM_STATE_PIN_REQUIRED 需要PIN码,需要SIM卡PIN码解锁

SIM_STATE_PUK_REQUIRED 需要PUK码,需要SIM卡PUK码解锁

SIM_STATE_NETWORK_LOCKED网络被锁定,需要网络PIN解锁

SIM_STATE_READY                           准备就绪

其中:PIN个人识别码 PUK个人解锁码

String

getSubscriberId()

Returns the unique subscriber ID, for example, the IMSI for a GSM phone.

获得客户标识(IMSI)

String

getVoiceMailAlphaTag()

Retrieves the alphabetic identifier associated with the voice mail number.

String

getVoiceMailNumber()

Returns the voice mail number.

boolean

hasIccCard()

boolean

isNetworkRoaming()

Returns true if the device is considered roaming on the current network, for GSM purposes.

void

listen(PhoneStateListener listener, int events)

Registers a listener object to receive notification of changes in specified telephony states.

侦听电话的呼叫状态。

电话管理服务接口支持的侦听类型在PhoneStateListener类中定义。

PhoneStateListener类

Constants

int

LISTEN_CALL_FORWARDING_INDICATOR

Listen for changes to the call-forwarding indicator.

侦听呼叫转移指示器改变事件

int

LISTEN_CALL_STATE

Listen for changes to the device call state.

侦听呼叫状态改变事件

int

LISTEN_CELL_LOCATION

Listen for changes to the device's cell location. Note that this will result in frequent callbacks to the listener.

侦听设备位置改变事件

int

LISTEN_DATA_ACTIVITY

Listen for changes to the direction of data traffic on the data connection (cellular).

侦听数据连接的流向改变事件

int

LISTEN_DATA_CONNECTION_STATE

Listen for changes to the data connection state (cellular).

侦听数据连接状态改变事件

int

LISTEN_MESSAGE_WAITING_INDICATOR

Listen for changes to the message-waiting indicator.

侦听消息等待指示器改变事件

int

LISTEN_NONE

Stop listening for updates.

停止侦听

int

LISTEN_SERVICE_STATE

Listen for changes to the network service state (cellular).

侦听网络服务状态

int

LISTEN_SIGNAL_STRENGTH

This constant is deprecated. by LISTEN_SIGNAL_STRENGTHS

侦听网络信号强度

int

LISTEN_SIGNAL_STRENGTHS

Listen for changes to the network signal strengths (cellular).

Public Constructors

 PhoneStateListener()          

Public Methods

void

onCallForwardingIndicatorChanged(boolean cfi)

Callback invoked when the call-forwarding indicator changes.

void

onCallStateChanged(int state, String incomingNumber)

Callback invoked when device call state changes.

处理侦测到的电话呼叫状态的改变事件。通过该回调事件,可以获取来电号码,而且可以获取电话呼叫状态。即用switch(state){case TelephoneManager.CALL_STATE_……}来判断

void

onCellLocationChanged(CellLocation location)

Callback invoked when device cell location changes.

void

onDataActivity(int direction)

Callback invoked when data activity state changes.

void

onDataConnectionStateChanged(int state)

Callback invoked when connection state changes.

void

onDataConnectionStateChanged(int state, int networkType)

same as above, but with the network type.

处理侦测到的数据连接状态的改变状态。通过该回调函数,可以获取数据连接状态信息。

数据连接类型

DATA_DISCONNECTED    断开

DATA_CONNECTING正在连接

DATA_CONNECTED已连接

DATA_SUSPENDED           已暂停

void

onMessageWaitingIndicatorChanged(boolean mwi)

Callback invoked when the message-waiting indicator changes.

void

onServiceStateChanged(ServiceState serviceState)

Callback invoked when device service state changes.

处理侦测到的服务状态的改变事件。通过该回调函数可以获取服务状态信息。

电话服务状态类型定义在ServiceState类中。

void

onSignalStrengthChanged(int asu)

This method is deprecated. Use onSignalStrengthsChanged(SignalStrength)

处理侦测到的信号强度的改变事件。通过该回调函数,可以获取信号强度类型。

void

onSignalStrengthsChanged(SignalStrength signalStrength)

Callback invoked when network signal strengths changes.

 电话拨号

Uri uri=Uri.parse("tel:"+电话号码);  

Intent intent=new Intent(Intent.ACTION_DIAL,uri);   
startActivity(intent);  

其中的电话号码可以通过EditText中输入获得数据,如editText.getText().toString().trim()来获得

上面的代码可以放在Button的onClick方法中调用即可实现拨打电话的功能,调用的是系统的拨号界面

相关推荐