FileDocCategorySizeDatePackage
DisconnectCause.javaAPI DocAndroid 5.1 API12575Thu Mar 12 22:22:42 GMT 2015android.telephony

DisconnectCause

public class DisconnectCause extends Object
Contains disconnect call causes generated by the framework and the RIL.
hide

Fields Summary
public static final int
NOT_VALID
The disconnect cause is not valid (Not received a disconnect cause)
public static final int
NOT_DISCONNECTED
Has not yet disconnected
public static final int
INCOMING_MISSED
An incoming call that was missed and never answered
public static final int
NORMAL
Normal; Remote hangup
public static final int
LOCAL
Normal; Local hangup
public static final int
BUSY
Outgoing call to busy line
public static final int
CONGESTION
Outgoing call to congested network
public static final int
MMI
Not presently used
public static final int
INVALID_NUMBER
Invalid dial string
public static final int
NUMBER_UNREACHABLE
Cannot reach the peer
public static final int
SERVER_UNREACHABLE
Cannot reach the server
public static final int
INVALID_CREDENTIALS
Invalid credentials
public static final int
OUT_OF_NETWORK
Calling from out of network is not allowed
public static final int
SERVER_ERROR
Server error
public static final int
TIMED_OUT
Client timed out
public static final int
LOST_SIGNAL
Client went out of network range
public static final int
LIMIT_EXCEEDED
GSM or CDMA ACM limit exceeded
public static final int
INCOMING_REJECTED
An incoming call that was rejected
public static final int
POWER_OFF
Radio is turned off explicitly
public static final int
OUT_OF_SERVICE
Out of service
public static final int
ICC_ERROR
No ICC, ICC locked, or other ICC error
public static final int
CALL_BARRED
Call was blocked by call barring
public static final int
FDN_BLOCKED
Call was blocked by fixed dial number
public static final int
CS_RESTRICTED
Call was blocked by restricted all voice access
public static final int
CS_RESTRICTED_NORMAL
Call was blocked by restricted normal voice access
public static final int
CS_RESTRICTED_EMERGENCY
Call was blocked by restricted emergency voice access
public static final int
UNOBTAINABLE_NUMBER
Unassigned number
public static final int
CDMA_LOCKED_UNTIL_POWER_CYCLE
MS is locked until next power cycle
public static final int
CDMA_DROP
Drop call
public static final int
CDMA_INTERCEPT
INTERCEPT order received, MS state idle entered
public static final int
CDMA_REORDER
MS has been redirected, call is cancelled
public static final int
CDMA_SO_REJECT
Service option rejection
public static final int
CDMA_RETRY_ORDER
Requested service is rejected, retry delay is set
public static final int
CDMA_ACCESS_FAILURE
Unable to obtain access to the CDMA system
public static final int
CDMA_PREEMPTED
Not a preempted call
public static final int
CDMA_NOT_EMERGENCY
Not an emergency call
public static final int
CDMA_ACCESS_BLOCKED
Access Blocked by CDMA network
public static final int
ERROR_UNSPECIFIED
Unknown error or not specified
public static final int
EMERGENCY_ONLY
Only emergency numbers are allowed, but we tried to dial a non-emergency number.
public static final int
NO_PHONE_NUMBER_SUPPLIED
The supplied CALL Intent didn't contain a valid phone number.
public static final int
DIALED_MMI
Our initial phone number was actually an MMI sequence.
public static final int
VOICEMAIL_NUMBER_MISSING
We tried to call a voicemail: URI but the device has no voicemail number configured.
public static final int
CDMA_CALL_LOST
This status indicates that InCallScreen should display the CDMA-specific "call lost" dialog. (If an outgoing call fails, and the CDMA "auto-retry" feature is enabled, *and* the retried call fails too, we display this specific dialog.) TODO: this is currently unused, since the "call lost" dialog needs to be triggered by a *disconnect* event, rather than when the InCallScreen first comes to the foreground. For now we use the needToShowCallLostDialog field for this (see below.)
public static final int
EXITED_ECM
This status indicates that the call was placed successfully, but additionally, the InCallScreen needs to display the "Exiting ECM" dialog. (Details: "Emergency callback mode" is a CDMA-specific concept where the phone disallows data connections over the cell network for some period of time after you make an emergency call. If the phone is in ECM and you dial a non-emergency number, that automatically *cancels* ECM, but we additionally need to warn the user that ECM has been canceled (see bug 4207607.)) TODO: Rethink where the best place to put this is. It is not a notification of a failure of the connection -- it is an additional message that accompanies a successful connection giving the user important information about what happened. {@hide}
public static final int
OUTGOING_FAILURE
The outgoing call failed with an unknown cause.
public static final int
OUTGOING_CANCELED
The outgoing call was canceled by the {@link android.telecom.ConnectionService}.
public static final int
IMS_MERGED_SUCCESSFULLY
The call, which was an IMS call, disconnected because it merged with another call.
public static final int
DIAL_MODIFIED_TO_USSD
Stk Call Control modified DIAL request to USSD request. {@hide}
public static final int
DIAL_MODIFIED_TO_SS
Stk Call Control modified DIAL request to SS request. {@hide}
public static final int
DIAL_MODIFIED_TO_DIAL
Stk Call Control modified DIAL request to DIAL with modified data. {@hide}
public static final int
MINIMUM_VALID_VALUE
Smallest valid value for call disconnect codes.
public static final int
MAXIMUM_VALID_VALUE
Largest valid value for call disconnect codes.
Constructors Summary
private DisconnectCause()
Private constructor to avoid class instantiation.


           
      
        // Do nothing.
Methods Summary
public static java.lang.StringtoString(int cause)
Returns descriptive string for the specified disconnect cause.

        switch (cause) {
        case NOT_DISCONNECTED:
            return "NOT_DISCONNECTED";
        case INCOMING_MISSED:
            return "INCOMING_MISSED";
        case NORMAL:
            return "NORMAL";
        case LOCAL:
            return "LOCAL";
        case BUSY:
            return "BUSY";
        case CONGESTION:
            return "CONGESTION";
        case INVALID_NUMBER:
            return "INVALID_NUMBER";
        case NUMBER_UNREACHABLE:
            return "NUMBER_UNREACHABLE";
        case SERVER_UNREACHABLE:
            return "SERVER_UNREACHABLE";
        case INVALID_CREDENTIALS:
            return "INVALID_CREDENTIALS";
        case OUT_OF_NETWORK:
            return "OUT_OF_NETWORK";
        case SERVER_ERROR:
            return "SERVER_ERROR";
        case TIMED_OUT:
            return "TIMED_OUT";
        case LOST_SIGNAL:
            return "LOST_SIGNAL";
        case LIMIT_EXCEEDED:
            return "LIMIT_EXCEEDED";
        case INCOMING_REJECTED:
            return "INCOMING_REJECTED";
        case POWER_OFF:
            return "POWER_OFF";
        case OUT_OF_SERVICE:
            return "OUT_OF_SERVICE";
        case ICC_ERROR:
            return "ICC_ERROR";
        case CALL_BARRED:
            return "CALL_BARRED";
        case FDN_BLOCKED:
            return "FDN_BLOCKED";
        case CS_RESTRICTED:
            return "CS_RESTRICTED";
        case CS_RESTRICTED_NORMAL:
            return "CS_RESTRICTED_NORMAL";
        case CS_RESTRICTED_EMERGENCY:
            return "CS_RESTRICTED_EMERGENCY";
        case UNOBTAINABLE_NUMBER:
            return "UNOBTAINABLE_NUMBER";
        case CDMA_LOCKED_UNTIL_POWER_CYCLE:
            return "CDMA_LOCKED_UNTIL_POWER_CYCLE";
        case CDMA_DROP:
            return "CDMA_DROP";
        case CDMA_INTERCEPT:
            return "CDMA_INTERCEPT";
        case CDMA_REORDER:
            return "CDMA_REORDER";
        case CDMA_SO_REJECT:
            return "CDMA_SO_REJECT";
        case CDMA_RETRY_ORDER:
            return "CDMA_RETRY_ORDER";
        case CDMA_ACCESS_FAILURE:
            return "CDMA_ACCESS_FAILURE";
        case CDMA_PREEMPTED:
            return "CDMA_PREEMPTED";
        case CDMA_NOT_EMERGENCY:
            return "CDMA_NOT_EMERGENCY";
        case CDMA_ACCESS_BLOCKED:
            return "CDMA_ACCESS_BLOCKED";
        case EMERGENCY_ONLY:
            return "EMERGENCY_ONLY";
        case NO_PHONE_NUMBER_SUPPLIED:
            return "NO_PHONE_NUMBER_SUPPLIED";
        case DIALED_MMI:
            return "DIALED_MMI";
        case VOICEMAIL_NUMBER_MISSING:
            return "VOICEMAIL_NUMBER_MISSING";
        case CDMA_CALL_LOST:
            return "CDMA_CALL_LOST";
        case EXITED_ECM:
            return "EXITED_ECM";
        case DIAL_MODIFIED_TO_USSD:
            return "DIAL_MODIFIED_TO_USSD";
        case DIAL_MODIFIED_TO_SS:
            return "DIAL_MODIFIED_TO_SS";
        case DIAL_MODIFIED_TO_DIAL:
            return "DIAL_MODIFIED_TO_DIAL";
        case ERROR_UNSPECIFIED:
            return "ERROR_UNSPECIFIED";
        case OUTGOING_FAILURE:
            return "OUTGOING_FAILURE";
        case OUTGOING_CANCELED:
            return "OUTGOING_CANCELED";
        case IMS_MERGED_SUCCESSFULLY:
            return "IMS_MERGED_SUCCESSFULLY";
        default:
            return "INVALID: " + cause;
        }