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方法中调用即可实现拨打电话的功能,调用的是系统的拨号界面