public class
TelephonyManager
extends Object
java.lang.Object
android.telephony.TelephonyManager
TelephonyManager提供了取得手机基本服务的信息的一种方式。因此应用程序可以使用TelephonyManager来探测手机基本服务的情况。
应用程序也可以注册listener来监听电话状态的改变。
我们不能对TelephonyManager进行实例化，只能通过如下的形式得到对其实例的引用：
Context.getSystemService(Context.TELEPHONY_SERVICE);
注意：对手机的某些信息进行读取是需要一定许可（permission）的。
可以通过在manifest file中添加一定的许可（permission），以便来对对手机的某些信息进行读取。
主要静态成员常量
手机的通话状态
它们对应PhoneStateListener.LISTEN_CALL_STATE所监听到的内容
int CALL_STATE_IDLE Device call state: No activity.
Device call state: No activity.
空闲。没有任何活动。
int CALL_STATE_OFFHOOK Device call state: Off-hook.
Device call state: Off-hook. At least one call exists that is dialing, active, or on hold, and no calls are ringing or waiting.
摘机状态。至少有个电话活动。该活动或是拨打（dialing）或是通话，或是 on hold。并且没有电话是ringing or waiting
注：on hold的意思是暂时挂起。比如在进行通话A的时候，来了个新的电话B，我们暂时挂起通话A，等通话B结束了，才继续进行A的通话。
int CALL_STATE_RINGING Device call state: Ringing.
Device call state: Ringing. A new call arrived and is ringing or waiting. In the latter case, another call is already active.
来电。来电，电话铃声响起的那段时间或正在通话又来新电，新来电话不得不等待的那段时间。
数据连接活动状态
它们对应PhoneStateListener.LISTEN_DATA_ACTIVITY所监听到的内容
int DATA_ACTIVITY_DORMANT
Data connection is active, but physical link is down
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.
数据连接状态
它们对应PhoneStateListener.LISTEN_DATA_CONNECTION_STATE 所监听到的内容
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.
数据传送的网络类型
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_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.
SIM卡状态
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.
手机通话状态在广播中的对应值
public static final String EXTRA_STATE_IDLE
Value used with EXTRA_STATE corresponding to CALL_STATE_IDLE.
它在手机通话状态改变的广播中，用于表示CALL_STATE_IDLE状态
public static final String EXTRA_STATE_OFFHOOK
Value used with EXTRA_STATE corresponding to CALL_STATE_OFFHOOK.
它在手机通话状态改变的广播中，用于表示CALL_STATE_OFFHOOK状态
public static final String EXTRA_STATE_RINGING
Value used with EXTRA_STATE corresponding to CALL_STATE_RINGING.
它在手机通话状态改变的广播中，用于表示CALL_STATE_RINGING状态
String ACTION_PHONE_STATE_CHANGED
Broadcast intent action indicating that the call state (cellular) on the device has changed.
The EXTRA_STATE extra indicates the new call state. If the new state is RINGING, a second extra EXTRA_INCOMING_NUMBER provides the incoming phone number as a String.
Requires the READ_PHONE_STATE permission.
This was a sticky broadcast in version 1.0, but it is no longer sticky. Instead, use getCallState() to synchronously query the current call state.
在广播中用ACTION_PHONE_STATE_CHANGED这个Action来标示通话状态改变的广播（intent）。
注：需要许可READ_PHONE_STATE。
String EXTRA_INCOMING_NUMBER
The lookup key used with the ACTION_PHONE_STATE_CHANGED
broadcast for a String containing the incoming phone number.
在手机通话状态改变的广播，用于从extra取来电号码。
String EXTRA_STATE
The lookup key used with the ACTION_PHONE_STATE_CHANGED
broadcast for a String containing the new call state.
在通话状态改变的广播，用于从extra取来通话状态。
主要成员函数
public int getCallState()
Returns a constant indicating the call state (cellular) on the device.
取得手机的通话状态。
public CellLocation getCellLocation ()
Returns the current location of the device. Return null if current location is not available.
返回手机当前所处的位置。如果当前定位服务不可用，则返回null
注：需要许可（Permission）ACCESS_COARSE_LOCATION or ACCESS_FINE_LOCATION.
public int getDataActivity ()
Returns a constant indicating the type of activity on a data connection (cellular).
返回当前数据连接活动状态的情况。
public int getDataState ()
Returns a constant indicating the current data connection state (cellular).
返回当前数据连接状态的情况。
public String getDeviceId ()
Returns the unique device ID, for example, the IMEI for GSM and the MEID or ESN for CDMA phones. Return null if device ID is not available.
返回手机的设备ID。比如对于GSM的手机来说是IMEI码，对于CDMA的手机来说MEID码或ESN码。如果读取失败，则返回null。
注：需要许可（Permission）READ_PHONE_STATE
注：手机上的IMEI就是手机身份识别号码。IMEI码贴在手机背面的标志上，并且读写于手机内存中。它也是该手机在厂家的"档案"和"身份证号"。
关于IMEI的更多内容参考《手机设备身份识别码之IMEI》
public String getDeviceSoftwareVersion ()
Returns the software version number for the device, for example, the IMEI/SV for GSM phones. Return null if the software version is not available.
返回手机软件版本号。比如对于GSM手机返回的是IMEI/SV码。如果读取失败，则返回null。
注1：需要许可（Permission）READ_PHONE_STATE
String getLine1Number ()
Returns the phone number string for line 1, for example, the MSISDN for a GSM phone. Return null if it is unavailable.
返回手机的Line1Number。比如对于GSM手机返回的是MSISDN码。如果读取失败，则返回null。
注1：需要许可（Permission）READ_PHONE_STATE
注2：关于MSISDN的更多内容请参考《MSISDN（手机号）》
public List<NeighboringCellInfo> getNeighboringCellInfo ()
Returns the neighboring cell information of the device.
Returns
* List of NeighboringCellInfo or null if info unavailable.
返回手机的neighboring cell信息
注：文档上说需要许可（Permission）ACCESS_COARSE_UPDATES，但是在android.Manifest.permission中却找不到该常量。
public String getNetworkCountryIso ()
Returns the ISO country code equivalent of the current registered operator's MCC (Mobile Country Code).
返回网络所在的国家代码（ISO标准形式）
注1: 只有手机注册到了网络，该功能才可用.
注2：如果是在CDMA的网络中，返回的结果可能不可靠（可通过getPhoneType()来判断是否在CDMA网络中）。
public String getNetworkOperator ()
Returns the numeric name (MCC+MNC) of current registered operator.
返回当前网络提供商的数字名字（MCC+MNC的形式）
如果是在CDMA的网络中，返回的结果可能不可靠（可通过getPhoneType()来判断是否在CDMA网络中）。
注：MCC（Mobile Country Code，移动国家号码），用于唯一地标识移动客户属于的国家。它由三位十进制数组成（000-999），例如我国的MCC为460
public String getNetworkOperatorName ()
Returns the alphabetic name of current registered operator.
返回当前网络提供商的名字（字母形式）
如果是在CDMA的网络中，返回的结果可能不可靠（可通过getPhoneType()来判断是否在CDMA网络中）。
public int getNetworkType ()
Returns a constant indicating the radio technology (network type) currently in use on the device for data transmission.
返回用于传输数据的网络的无线类型。比如GPRS
public int getPhoneType ()
Returns a constant indicating the device phone type. This indicates the type of radio used to transmit voice calls.
返回手机用于传输语言的无线类型。比如GSM，CDMA
public String getSimCountryIso ()
Returns the ISO country code equivalent for the SIM provider's country code.
返回SIM卡提供商的国家代码。
public String getSimOperator ()
Returns the MCC+MNC (mobile country code + mobile network code) of the provider of the SIM. 5 or 6 decimal digits.
返回SIM卡的提供商代码，以MCC+MNC的形式(mobile country code + mobile network code)。该码是5或6为的十进制形式。
注：只有SIM的状态是SIM_STATE_READY的时候，该功能才可用。
public String getSimOperatorName ()
Returns the Service Provider Name (SPN).
返回SIM卡服务商的名字。
注：只有SIM的状态是SIM_STATE_READY的时候，该功能才可用。
public String getSimSerialNumber ()
Returns the serial number of the SIM, if applicable. Return null if it is unavailable.
返回SIM卡的编码。如果读取失败，则返回null。
注：需要许可(Permission)READ_PHONE_STATE
public int getSimState ()
Returns a constant indicating the state of the device SIM card.
返回SIM卡的状态
public String getSubscriberId ()
Returns the unique subscriber ID, for example, the IMSI for a GSM phone. Return null if it is unavailable.
返回国际移动用户识别码。对于GSM手机来说是IMSI。如果读取失败，则返回null。
注1：imsi是国际移动用户识别码。它主要是用于国际漫游的。这个对用户来说应该是透明的。
关于imsi的更多内容可参考《国际移动用户识别码imsi》
注2：需要许可（Permission）READ_PHONE_STATE
public String getVoiceMailAlphaTag ()
Retrieves the alphabetic identifier associated with the voice mail number.
使用语言邮箱号得到其字母形式的标识符（和语音邮件相关的标签）
注：需要许可（Permission）READ_PHONE_STATE
public String getVoiceMailNumber ()
Returns the voice mail number. Return null if it is unavailable.
得到语音邮箱码。
注：需要许可（Permission）READ_PHONE_STATE
public boolean hasIccCard ()
Returns
* true if a ICC card is present
ICC卡是否存在
public boolean isNetworkRoaming ()
Returns true if the device is considered roaming on the current network, for GSM purposes.
查看是否在漫游。
注：它只在GSM下使用。
public void listen (PhoneStateListener listener, int events)
Registers a listener object to receive notification of changes in specified telephony states.
To register a listener, pass a PhoneStateListener and specify at least one telephony state of interest in the events argument. At registration, and when a specified telephony state changes, the telephony manager invokes the appropriate callback method on the listener object and passes the current (udpated) values.
To unregister a listener, pass the listener object and set the events argument to LISTEN_NONE (0).
参数
listener The PhoneStateListener object to register (or unregister)
events The telephony state(s) of interest to the listener, as a bitwise-OR combination of PhoneStateListener LISTEN_ flags.
该参数为监听标志，以表示对什么进行监听，它为PhoneStateListener.LISTEN_CALL_STATE等的或运算值。
可以通过PhoneStateListener listener来监听手机的状态。
注1：unregister是通过把events设置为LISTEN_NONE (0)来实现的。
注2：PhoneStateListener除了可以监听手机的通话状态，数据连接活动状态，数据连接状态还可以监听很多状态。
注3：手机的通话状态可以通过Receiver来监听，具体见上面关于ACTION_PHONE_STATE_CHANGED的说明.
使用PhoneStateListener能监听以下它的静态常量标示的所有内容
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.
|
||||||||||
| 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.
|
||||||||||
| void | onMessageWaitingIndicatorChanged(boolean mwi)
Callback invoked when the message-waiting indicator changes.
|
||||||||||
| void | onServiceStateChanged(ServiceState serviceState)
Callback invoked when device service state changes.
|
||||||||||
| void | onSignalStrengthChanged(int asu)
This method is deprecated. Use
onSignalStrengthsChanged(SignalStrength) |
||||||||||
| void | onSignalStrengthsChanged(SignalStrength signalStrength)
Callback invoked when network signal strengths changes.
|
||||||||||
通过向TelephonyManager注册一个listener，就可以监听手机的一些状态的变化。
自定义的监听器：
1 class MyPhoneStateListener extends PhoneStateListener 2 { 3 Context context; 4 public MyPhoneStateListener(Context con) 5 { 6 context = con; 7 } 8 9 public void onCallForwardingIndicatorChanged(boolean cfi) 10 { 11 12 } 13 14 public void onCallStateChanged(int state, String incomingNumber) 15 { 16 switch(state) 17 { 18 case TelephonyManager.CALL_STATE_IDLE: 19 Toast.makeText(context, "call not answer", Toast.LENGTH_LONG).show(); 20 break; 21 22 case TelephonyManager.CALL_STATE_RINGING: 23 Toast.makeText(context, "incoming", Toast.LENGTH_LONG).show(); 24 25 break; 26 27 case TelephonyManager.CALL_STATE_OFFHOOK: 28 Toast.makeText(context, "in a call", Toast.LENGTH_LONG).show(); 29 break; 30 } 31 } 32 33 public void onCellLocationChanged(CellLocation location) {} 34 35 public void onDataActivity(int direction) {} 36 37 public void onDataConnectionStateChanged(int state) {} 38 39 public void onMessageWaitingIndicatorChanged(boolean mwi) {} 40 41 public void onServiceStateChanged(ServiceState serviceState) {} 42 43 public void onSignalStrengthChanged(int asu) {} 44 }
注册自己的监听器：
1 String srvcName = Context.TELEPHONY_SERVICE; 2 TelephonyManager telephonyManager = (TelephonyManager)getSystemService(srvcName); 3 4 MyPhoneStateListener phoneStateListener = new MyPhoneStateListener(this); 5 telephonyManager.listen(phoneStateListener, 6 PhoneStateListener.LISTEN_CALL_FORWARDING_INDICATOR | 7 PhoneStateListener.LISTEN_CALL_STATE | 8 PhoneStateListener.LISTEN_CELL_LOCATION | 9 PhoneStateListener.LISTEN_DATA_ACTIVITY | 10 PhoneStateListener.LISTEN_DATA_CONNECTION_STATE | 11 PhoneStateListener.LISTEN_MESSAGE_WAITING_INDICATOR | 12 PhoneStateListener.LISTEN_SERVICE_STATE | 13 PhoneStateListener.LISTEN_SIGNAL_STRENGTH);
转自：http://blog.csdn.net/skiffloveblue/article/details/7491618
1 private PhoneStateManager mPhoneStateManager; 2 3 mPhoneStateManager = new PhoneStateManager(this, mCallStateListener); 4 5 if (mPhoneStateManager != null) { 6 mPhoneStateManager.stopListen(); 7 } 8 9 private CallStateListener mCallStateListener = new CallStateListener() { 10 11 @Override 12 public void onCallStateChange(int state, String incomingNumber) { 13 // TODO Auto-generated method stub 14 mCurrentModule.onCallStateChanged(state, incomingNumber); 15 if (mPhoneStateManager.getPhoneState() == TelephonyManager.CALL_STATE_IDLE && mPhoneAlertDialog != null && 16 mPhoneAlertDialog.isShowing()) { 17 mPhoneAlertDialog.dismiss(); 18 } 19 if (state != TelephonyManager.CALL_STATE_IDLE) { 20 isPhoneCall = true; 21 } 22 } 23 };