| /** |
| * Copyright (C) 2014 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package com.android.services.telephony; |
| |
| import android.content.Context; |
| import android.media.ToneGenerator; |
| import android.telecom.DisconnectCause; |
| |
| import com.android.phone.PhoneGlobals; |
| import com.android.phone.common.R; |
| |
| public class DisconnectCauseUtil { |
| |
| /** |
| * Converts from a disconnect code in {@link android.telephony.DisconnectCause} into a more generic |
| * {@link android.telecom.DisconnectCause}.object, possibly populated with a localized message |
| * and tone. |
| * |
| * @param context The context. |
| * @param telephonyDisconnectCause The code for the reason for the disconnect. |
| */ |
| public static DisconnectCause toTelecomDisconnectCause(int telephonyDisconnectCause) { |
| return toTelecomDisconnectCause(telephonyDisconnectCause, null /* reason */); |
| } |
| |
| /** |
| * Converts from a disconnect code in {@link android.telephony.DisconnectCause} into a more generic |
| * {@link android.telecom.DisconnectCause}.object, possibly populated with a localized message |
| * and tone. |
| * |
| * @param context The context. |
| * @param telephonyDisconnectCause The code for the reason for the disconnect. |
| * @param reason Description of the reason for the disconnect, not intended for the user to see.. |
| */ |
| public static DisconnectCause toTelecomDisconnectCause( |
| int telephonyDisconnectCause, String reason) { |
| Context context = PhoneGlobals.getInstance(); |
| return new DisconnectCause( |
| toTelecomDisconnectCauseCode(telephonyDisconnectCause), |
| toTelecomDisconnectCauseLabel(context, telephonyDisconnectCause), |
| toTelecomDisconnectCauseDescription(context, telephonyDisconnectCause), |
| toTelecomDisconnectReason(telephonyDisconnectCause, reason), |
| toTelecomDisconnectCauseTone(telephonyDisconnectCause)); |
| } |
| |
| /** |
| * Convert the {@link android.telephony.DisconnectCause} disconnect code into a |
| * {@link android.telecom.DisconnectCause} disconnect code. |
| * @return The disconnect code as defined in {@link android.telecom.DisconnectCause}. |
| */ |
| private static int toTelecomDisconnectCauseCode(int telephonyDisconnectCause) { |
| switch (telephonyDisconnectCause) { |
| case android.telephony.DisconnectCause.LOCAL: |
| return DisconnectCause.LOCAL; |
| |
| case android.telephony.DisconnectCause.NORMAL: |
| return DisconnectCause.REMOTE; |
| |
| case android.telephony.DisconnectCause.OUTGOING_CANCELED: |
| return DisconnectCause.CANCELED; |
| |
| case android.telephony.DisconnectCause.INCOMING_MISSED: |
| return DisconnectCause.MISSED; |
| |
| case android.telephony.DisconnectCause.INCOMING_REJECTED: |
| return DisconnectCause.REJECTED; |
| |
| case android.telephony.DisconnectCause.BUSY: |
| return DisconnectCause.BUSY; |
| |
| case android.telephony.DisconnectCause.CALL_BARRED: |
| case android.telephony.DisconnectCause.CDMA_ACCESS_BLOCKED: |
| case android.telephony.DisconnectCause.CDMA_NOT_EMERGENCY: |
| case android.telephony.DisconnectCause.CS_RESTRICTED: |
| case android.telephony.DisconnectCause.CS_RESTRICTED_EMERGENCY: |
| case android.telephony.DisconnectCause.CS_RESTRICTED_NORMAL: |
| case android.telephony.DisconnectCause.EMERGENCY_ONLY: |
| case android.telephony.DisconnectCause.FDN_BLOCKED: |
| case android.telephony.DisconnectCause.LIMIT_EXCEEDED: |
| return DisconnectCause.RESTRICTED; |
| |
| case android.telephony.DisconnectCause.CDMA_ACCESS_FAILURE: |
| case android.telephony.DisconnectCause.CDMA_CALL_LOST: |
| case android.telephony.DisconnectCause.CDMA_DROP: |
| case android.telephony.DisconnectCause.CDMA_INTERCEPT: |
| case android.telephony.DisconnectCause.CDMA_LOCKED_UNTIL_POWER_CYCLE: |
| case android.telephony.DisconnectCause.CDMA_PREEMPTED: |
| case android.telephony.DisconnectCause.CDMA_REORDER: |
| case android.telephony.DisconnectCause.CDMA_RETRY_ORDER: |
| case android.telephony.DisconnectCause.CDMA_SO_REJECT: |
| case android.telephony.DisconnectCause.CONGESTION: |
| case android.telephony.DisconnectCause.ICC_ERROR: |
| case android.telephony.DisconnectCause.INVALID_CREDENTIALS: |
| case android.telephony.DisconnectCause.INVALID_NUMBER: |
| case android.telephony.DisconnectCause.LOST_SIGNAL: |
| case android.telephony.DisconnectCause.NO_PHONE_NUMBER_SUPPLIED: |
| case android.telephony.DisconnectCause.NUMBER_UNREACHABLE: |
| case android.telephony.DisconnectCause.OUTGOING_FAILURE: |
| case android.telephony.DisconnectCause.OUT_OF_NETWORK: |
| case android.telephony.DisconnectCause.OUT_OF_SERVICE: |
| case android.telephony.DisconnectCause.POWER_OFF: |
| case android.telephony.DisconnectCause.SERVER_ERROR: |
| case android.telephony.DisconnectCause.SERVER_UNREACHABLE: |
| case android.telephony.DisconnectCause.TIMED_OUT: |
| case android.telephony.DisconnectCause.UNOBTAINABLE_NUMBER: |
| case android.telephony.DisconnectCause.VOICEMAIL_NUMBER_MISSING: |
| case android.telephony.DisconnectCause.ERROR_UNSPECIFIED: |
| return DisconnectCause.ERROR; |
| |
| case android.telephony.DisconnectCause.DIALED_MMI: |
| case android.telephony.DisconnectCause.EXITED_ECM: |
| case android.telephony.DisconnectCause.MMI: |
| return DisconnectCause.OTHER; |
| |
| case android.telephony.DisconnectCause.NOT_VALID: |
| case android.telephony.DisconnectCause.NOT_DISCONNECTED: |
| return DisconnectCause.UNKNOWN; |
| |
| default: |
| throw new IllegalStateException("Unrecognized Telephony DisconnectCause"); |
| } |
| } |
| |
| /** |
| * Returns a label for to the disconnect cause to be shown to the user. |
| */ |
| private static CharSequence toTelecomDisconnectCauseLabel( |
| Context context, int telephonyDisconnectCause) { |
| if (context == null ) { |
| return ""; |
| } |
| |
| Integer resourceId = null; |
| switch (telephonyDisconnectCause) { |
| case android.telephony.DisconnectCause.BUSY: |
| resourceId = R.string.callFailed_userBusy; |
| break; |
| |
| case android.telephony.DisconnectCause.CONGESTION: |
| resourceId = R.string.callFailed_congestion; |
| break; |
| |
| case android.telephony.DisconnectCause.TIMED_OUT: |
| resourceId = R.string.callFailed_timedOut; |
| break; |
| |
| case android.telephony.DisconnectCause.SERVER_UNREACHABLE: |
| resourceId = R.string.callFailed_server_unreachable; |
| break; |
| |
| case android.telephony.DisconnectCause.NUMBER_UNREACHABLE: |
| resourceId = R.string.callFailed_number_unreachable; |
| break; |
| |
| case android.telephony.DisconnectCause.INVALID_CREDENTIALS: |
| resourceId = R.string.callFailed_invalid_credentials; |
| break; |
| |
| case android.telephony.DisconnectCause.SERVER_ERROR: |
| resourceId = R.string.callFailed_server_error; |
| break; |
| |
| case android.telephony.DisconnectCause.OUT_OF_NETWORK: |
| resourceId = R.string.callFailed_out_of_network; |
| break; |
| |
| case android.telephony.DisconnectCause.LOST_SIGNAL: |
| case android.telephony.DisconnectCause.CDMA_DROP: |
| resourceId = R.string.callFailed_noSignal; |
| break; |
| |
| case android.telephony.DisconnectCause.LIMIT_EXCEEDED: |
| resourceId = R.string.callFailed_limitExceeded; |
| break; |
| |
| case android.telephony.DisconnectCause.POWER_OFF: |
| resourceId = R.string.callFailed_powerOff; |
| break; |
| |
| case android.telephony.DisconnectCause.ICC_ERROR: |
| resourceId = R.string.callFailed_simError; |
| break; |
| |
| case android.telephony.DisconnectCause.OUT_OF_SERVICE: |
| resourceId = R.string.callFailed_outOfService; |
| break; |
| |
| case android.telephony.DisconnectCause.INVALID_NUMBER: |
| case android.telephony.DisconnectCause.UNOBTAINABLE_NUMBER: |
| resourceId = R.string.callFailed_unobtainable_number; |
| break; |
| |
| default: |
| break; |
| } |
| return resourceId == null ? "" : context.getResources().getString(resourceId); |
| } |
| |
| /** |
| * Returns a description of the disconnect cause to be shown to the user. |
| */ |
| private static CharSequence toTelecomDisconnectCauseDescription( |
| Context context, int telephonyDisconnectCause) { |
| if (context == null ) { |
| return ""; |
| } |
| |
| Integer resourceId = null; |
| switch (telephonyDisconnectCause) { |
| case android.telephony.DisconnectCause.CALL_BARRED: |
| resourceId = R.string.callFailed_cb_enabled; |
| break; |
| |
| case android.telephony.DisconnectCause.FDN_BLOCKED: |
| resourceId = R.string.callFailed_fdn_only; |
| break; |
| |
| case android.telephony.DisconnectCause.CS_RESTRICTED: |
| resourceId = R.string.callFailed_dsac_restricted; |
| break; |
| |
| case android.telephony.DisconnectCause.CS_RESTRICTED_EMERGENCY: |
| resourceId = R.string.callFailed_dsac_restricted_emergency; |
| break; |
| |
| case android.telephony.DisconnectCause.CS_RESTRICTED_NORMAL: |
| resourceId = R.string.callFailed_dsac_restricted_normal; |
| break; |
| |
| case android.telephony.DisconnectCause.OUTGOING_FAILURE: |
| // We couldn't successfully place the call; there was some |
| // failure in the telephony layer. |
| // TODO: Need UI spec for this failure case; for now just |
| // show a generic error. |
| resourceId = R.string.incall_error_call_failed; |
| break; |
| |
| case android.telephony.DisconnectCause.POWER_OFF: |
| // Radio is explictly powered off, presumably because the |
| // device is in airplane mode. |
| // |
| // TODO: For now this UI is ultra-simple: we simply display |
| // a message telling the user to turn off airplane mode. |
| // But it might be nicer for the dialog to offer the option |
| // to turn the radio on right there (and automatically retry |
| // the call once network registration is complete.) |
| resourceId = R.string.incall_error_power_off; |
| break; |
| |
| case android.telephony.DisconnectCause.EMERGENCY_ONLY: |
| // Only emergency numbers are allowed, but we tried to dial |
| // a non-emergency number. |
| resourceId = R.string.incall_error_emergency_only; |
| break; |
| |
| case android.telephony.DisconnectCause.OUT_OF_SERVICE: |
| // No network connection. |
| resourceId = R.string.incall_error_out_of_service; |
| break; |
| |
| case android.telephony.DisconnectCause.NO_PHONE_NUMBER_SUPPLIED: |
| // The supplied Intent didn't contain a valid phone number. |
| // (This is rare and should only ever happen with broken |
| // 3rd-party apps.) For now just show a generic error. |
| resourceId = R.string.incall_error_no_phone_number_supplied; |
| break; |
| |
| case android.telephony.DisconnectCause.VOICEMAIL_NUMBER_MISSING: |
| // TODO: Need to bring up the "Missing Voicemail Number" dialog, which |
| // will ultimately take us to the Call Settings. |
| resourceId = R.string.incall_error_missing_voicemail_number; |
| break; |
| |
| case android.telephony.DisconnectCause.OUTGOING_CANCELED: |
| // We don't want to show any dialog for the canceled case since the call was |
| // either canceled by the user explicitly (end-call button pushed immediately) |
| // or some other app canceled the call and immediately issued a new CALL to |
| // replace it. |
| default: |
| break; |
| } |
| return resourceId == null ? "" : context.getResources().getString(resourceId); |
| } |
| |
| private static String toTelecomDisconnectReason(int telephonyDisconnectCause, String reason) { |
| String causeAsString = android.telephony.DisconnectCause.toString(telephonyDisconnectCause); |
| if (reason == null) { |
| return causeAsString; |
| } else { |
| return reason + ", " + causeAsString; |
| } |
| } |
| |
| /** |
| * Returns the tone to play for the disconnect cause, or UNKNOWN if none should be played. |
| */ |
| private static int toTelecomDisconnectCauseTone(int telephonyDisconnectCause) { |
| switch (telephonyDisconnectCause) { |
| case android.telephony.DisconnectCause.BUSY: |
| return ToneGenerator.TONE_SUP_BUSY; |
| |
| case android.telephony.DisconnectCause.CONGESTION: |
| return ToneGenerator.TONE_SUP_CONGESTION; |
| |
| case android.telephony.DisconnectCause.CDMA_REORDER: |
| return ToneGenerator.TONE_CDMA_REORDER; |
| |
| case android.telephony.DisconnectCause.CDMA_INTERCEPT: |
| return ToneGenerator.TONE_CDMA_ABBR_INTERCEPT; |
| |
| case android.telephony.DisconnectCause.CDMA_DROP: |
| case android.telephony.DisconnectCause.OUT_OF_SERVICE: |
| return ToneGenerator.TONE_CDMA_CALLDROP_LITE; |
| |
| case android.telephony.DisconnectCause.UNOBTAINABLE_NUMBER: |
| return ToneGenerator.TONE_SUP_ERROR; |
| |
| case android.telephony.DisconnectCause.ERROR_UNSPECIFIED: |
| case android.telephony.DisconnectCause.LOCAL: |
| case android.telephony.DisconnectCause.NORMAL: |
| return ToneGenerator.TONE_PROP_PROMPT; |
| |
| default: |
| return ToneGenerator.TONE_UNKNOWN; |
| } |
| } |
| } |
