Телефонные обратные вызовы в Android Использование TelephonyManager

Пользовательский класс PhoneStateListener

В этом классе происходит вся магия. Как было сказано ранее, расширяя класс PhoneStateListener , некоторые методы могут быть переопределены.

Чтобы показать содержимое каждого обратного вызова, мы будем использовать класс Log .

 public class PhoneCallback extends PhoneStateListener { //-------------------------------------------------- // Constants //-------------------------------------------------- public static final String LOG_TAG = "PhoneCallback" ; //-------------------------------------------------- // Attributes //-------------------------------------------------- private final TextView mTextView; //-------------------------------------------------- // Constructor //-------------------------------------------------- public PhoneCallback (TextView textView) { mTextView = textView; } //-------------------------------------------------- // Methods //-------------------------------------------------- private String serviceStateToString ( int serviceState) { switch (serviceState) { case ServiceState.STATE_IN_SERVICE: return "STATE_IN_SERVICE" ; case ServiceState.STATE_OUT_OF_SERVICE: return "STATE_OUT_OF_SERVICE" ; case ServiceState.STATE_EMERGENCY_ONLY: return "STATE_EMERGENCY_ONLY" ; case ServiceState.STATE_POWER_OFF: return "STATE_POWER_OFF" ; default : return "UNKNOWN_STATE" ; } } private String callStateToString ( int state) { switch (state) { case TelephonyManager.CALL_STATE_IDLE: return "\nonCallStateChanged: CALL_STATE_IDLE, " ; case TelephonyManager.CALL_STATE_RINGING: return "\nonCallStateChanged: CALL_STATE_RINGING, " ; case TelephonyManager.CALL_STATE_OFFHOOK: return "\nonCallStateChanged: CALL_STATE_OFFHOOK, " ; default : return "\nUNKNOWN_STATE: " + state + ", " ; } } //-------------------------------------------------- // PhoneStateListener //-------------------------------------------------- @Override public void onCellInfoChanged (List<CellInfo> cellInfo) { super .onCellInfoChanged(cellInfo); Log.i(LOG_TAG, "onCellInfoChanged: " + cellInfo); } @Override public void onDataActivity ( int direction) { super .onDataActivity(direction); switch (direction) { case TelephonyManager.DATA_ACTIVITY_NONE: Log.i(LOG_TAG, "onDataActivity: DATA_ACTIVITY_NONE" ); break ; case TelephonyManager.DATA_ACTIVITY_IN: Log.i(LOG_TAG, "onDataActivity: DATA_ACTIVITY_IN" ); break ; case TelephonyManager.DATA_ACTIVITY_OUT: Log.i(LOG_TAG, "onDataActivity: DATA_ACTIVITY_OUT" ); break ; case TelephonyManager.DATA_ACTIVITY_INOUT: Log.i(LOG_TAG, "onDataActivity: DATA_ACTIVITY_INOUT" ); break ; case TelephonyManager.DATA_ACTIVITY_DORMANT: Log.i(LOG_TAG, "onDataActivity: DATA_ACTIVITY_DORMANT" ); break ; default : Log.w(LOG_TAG, "onDataActivity: UNKNOWN " + direction); break ; } } @Override public void onServiceStateChanged (ServiceState serviceState) { super .onServiceStateChanged(serviceState); String message = "onServiceStateChanged: " + serviceState + "\n" ; message += "onServiceStateChanged: getOperatorAlphaLong " + serviceState.getOperatorAlphaLong() + "\n" ; message += "onServiceStateChanged: getOperatorAlphaShort " + serviceState.getOperatorAlphaShort() + "\n" ; message += "onServiceStateChanged: getOperatorNumeric " + serviceState.getOperatorNumeric() + "\n" ; message += "onServiceStateChanged: getIsManualSelection " + serviceState.getIsManualSelection() + "\n" ; message += "onServiceStateChanged: getRoaming " + serviceState.getRoaming() + "\n" ; message += "onServiceStateChanged: " + serviceStateToString(serviceState.getState()); Log.i(LOG_TAG, message); } @Override public void onCallStateChanged ( int state, String incomingNumber) { super .onCallStateChanged(state, incomingNumber); callStateToString(state); String message = callStateToString(state) + "incomingNumber: " + incomingNumber; mTextView.setText(message); } @Override public void onCellLocationChanged (CellLocation location) { super .onCellLocationChanged(location); String message = "" ; if (location instanceof GsmCellLocation) { GsmCellLocation gcLoc = (GsmCellLocation) location; message += "onCellLocationChanged: GsmCellLocation " + gcLoc + "\n" ; message += "onCellLocationChanged: GsmCellLocation getCid " + gcLoc.getCid() + "\n" ; message += "onCellLocationChanged: GsmCellLocation getLac " + gcLoc.getLac() + "\n" ; message += "onCellLocationChanged: GsmCellLocation getPsc" + gcLoc.getPsc(); // Requires min API 9 Log.i(LOG_TAG, message); } else if (location instanceof CdmaCellLocation) { CdmaCellLocation ccLoc = (CdmaCellLocation) location; message += "onCellLocationChanged: CdmaCellLocation " + ccLoc + "\n" ;; message += "onCellLocationChanged: CdmaCellLocation getBaseStationId " + ccLoc.getBaseStationId() + "\n" ;; message += "onCellLocationChanged: CdmaCellLocation getBaseStationLatitude " + ccLoc.getBaseStationLatitude() + "\n" ;; message += "onCellLocationChanged: CdmaCellLocation getBaseStationLongitude" + ccLoc.getBaseStationLongitude() + "\n" ;; message += "onCellLocationChanged: CdmaCellLocation getNetworkId " + ccLoc.getNetworkId() + "\n" ;; message += "onCellLocationChanged: CdmaCellLocation getSystemId " + ccLoc.getSystemId(); Log.i(LOG_TAG, message); } else { Log.i(LOG_TAG, "onCellLocationChanged: " + location); } } @Override public void onCallForwardingIndicatorChanged ( boolean changed) { super .onCallForwardingIndicatorChanged(changed); } @Override public void onMessageWaitingIndicatorChanged ( boolean changed) { super .onMessageWaitingIndicatorChanged(changed); } } 

Наиболее важным методом, реализованным в этом классе, является метод onCallStateChanged() . Этот метод прослушивает изменения состояния вызова. Например, когда телефон начинает звонить, звонок переводится в режим удержания или звонок завершается. В этом методе возможно обнаруживать следующие состояния: TelephonyManager.CALL_STATE_IDLE , TelephonyManager.CALL_STATE_RINGING или TelephonyManager.CALL_STATE_OFFHOOK . Это состояния, которые могут предоставить информацию о том, что происходит с состоянием телефона.

MainActivity class

С разрешениями на чтение состояния телефона и пользовательским классом для прослушивания состояний телефона, исходному коду теперь нужно просто вызвать их вместе. Это будет сделано в классе MainActivity .

 public class MainActivity extends AppCompatActivity { //-------------------------------------------------- // Constants //-------------------------------------------------- private static final String[] PERMISSIONS = { Manifest.permission.READ_PHONE_STATE, Manifest.permission.ACCESS_COARSE_LOCATION }; private static final int PERMISSION_REQUEST = 100 ; //-------------------------------------------------- // Attributes //-------------------------------------------------- private TelephonyManager mTelephonyManager; //-------------------------------------------------- // Activity Life Cycle //-------------------------------------------------- @Override protected void onCreate (Bundle savedInstanceState) { super .onCreate(savedInstanceState); setContentView(R.layout.activity_main); checkPermissions(); } //-------------------------------------------------- // Permissions //-------------------------------------------------- @Override public void onRequestPermissionsResult ( int requestCode, String[] permissions, int [] grantResults) { switch (requestCode) { case PERMISSION_REQUEST: { isPermissionGranted(grantResults); return ; } } } private void isPermissionGranted ( int [] grantResults) { if (grantResults.length > 0 ) { Boolean permissionGranted = grantResults[ 0 ] == PackageManager.PERMISSION_GRANTED; if (permissionGranted) { callPhoneManager(); } else { PermissionUtils.alertAndFinish( this ); } } } private void checkPermissions () { // Checks the Android version of the device. if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) { Boolean canWriteExternalStorage = PermissionUtils.canReadPhoneState( this ); Boolean canReadExternalStorage = PermissionUtils.canAccessCoarseLocation( this ); if (!canWriteExternalStorage || !canReadExternalStorage) { requestPermissions(PERMISSIONS, PERMISSION_REQUEST); } else { // Permission was granted. callPhoneManager(); } } else { // Version is below Marshmallow. callPhoneManager(); } } private void callPhoneManager () { TextView textView = (TextView)findViewById(R.id.id_text_view); mTelephonyManager = (TelephonyManager) getSystemService(TELEPHONY_SERVICE); mTelephonyManager.listen( new PhoneCallback(textView), PhoneStateListener.LISTEN_CALL_STATE | PhoneStateListener.LISTEN_CELL_INFO // Requires API 17 | PhoneStateListener.LISTEN_CELL_LOCATION | PhoneStateListener.LISTEN_DATA_ACTIVITY | PhoneStateListener.LISTEN_DATA_CONNECTION_STATE | PhoneStateListener.LISTEN_SERVICE_STATE | PhoneStateListener.LISTEN_SIGNAL_STRENGTHS | PhoneStateListener.LISTEN_CALL_FORWARDING_INDICATOR | PhoneStateListener.LISTEN_MESSAGE_WAITING_INDICATOR); } } 

В методе checkPermissions() будет вызван метод checkPermissions() . В этом методе будут проверяться разрешения Manifest.permission.ACCESS_COARSE_LOCATION и Manifest.permission.READ_PHONE_STATE .

При первом requestPermissions(PERMISSIONS, PERMISSION_REQUEST) приложения, если приложение не имеет доступа к этим разрешениям, будет requestPermissions(PERMISSIONS, PERMISSION_REQUEST) метод requestPermissions(PERMISSIONS, PERMISSION_REQUEST) . Если приложение имеет доступ к этим разрешениям, callPhoneManager() .

Метод requestPermissions(PERMISSIONS, PERMISSION_REQUEST) перенаправляет поток управления в метод onRequestPermissionsResult() . Этот метод покажет пользователю диалог с просьбой разрешить приложению доступ к запрошенным разрешениям. Если пользователь разрешает разрешения, callPhoneManager() метод callPhoneManager() . Если нет, будет вызван PermissionUtils.alertAndFinish() . Этот метод показывает сообщение для пользователя (сообщает пользователю, что он должен принять разрешения) и закрывает приложение.

Весь этот поток происходит при первом запуске приложения. Но что происходит во второй раз? Если пользователь разрешил разрешения в первый раз, проверка разрешений не будет выполнена во второй раз, и будет вызван метод callPhoneManager() . Если это не было разрешено, то эта проверка также не будет выполнена, и будет вызван PermissionUtils.alertAndFinish() . Если пользователь не выбрал ни одну из этих опций при первом выполнении, диалоговое окно с запросом разрешений будет показано снова.

И последнее, но не менее важное: если пользователь разрешил разрешения, callPhoneManager() метод callPhoneManager() . Это метод, который вызывает наш обратный вызов состояния телефона.

 private void callPhoneManager () { TextView textView = (TextView)findViewById(R.id.id_text_view); mTelephonyManager = (TelephonyManager) getSystemService(TELEPHONY_SERVICE); mTelephonyManager.listen( new PhoneCallback(textView), PhoneStateListener.LISTEN_CALL_STATE | PhoneStateListener.LISTEN_CELL_INFO // Requires API 17 | PhoneStateListener.LISTEN_CELL_LOCATION | PhoneStateListener.LISTEN_DATA_ACTIVITY | PhoneStateListener.LISTEN_DATA_CONNECTION_STATE | PhoneStateListener.LISTEN_SERVICE_STATE | PhoneStateListener.LISTEN_SIGNAL_STRENGTHS | PhoneStateListener.LISTEN_CALL_FORWARDING_INDICATOR | PhoneStateListener.LISTEN_MESSAGE_WAITING_INDICATOR); } 

В этом методе осуществляется доступ к TelephonyManager , вызывая метод listen() . Смотрите конструктор этого метода:

Этот метод получает по своему первому параметру конструктор с TextView (который будет использоваться для печати состояния телефона). И по второму параметру он получает все события, которые будут отслеживаться состоянием телефонного звонка.

Выполнение звонка с помощью эмулятора

Весь исходный код готов. Но не обязательно выполнять звонок для телефона, чтобы активировать обратный вызов состояния телефона.