DisconnectCause


public final class DisconnectCause
extends Object

java.lang.Object
   ↳ android.telephony.DisconnectCause


Describes the cause of a disconnected call. Those disconnect causes can be converted into a more generic DisconnectCause object. Used in PhoneStateListener.onCallDisconnectCauseChanged.

Summary

Constants

int ALREADY_DIALING

Indicates that a new outgoing call cannot be placed because there is already an outgoing call dialing out.

int ANSWERED_ELSEWHERE

The call was terminated because it was answered on another device.

int BUSY

Outgoing call to busy line

int CALLING_DISABLED

Indicates that a new outgoing call cannot be placed because calling has been disabled using the ro.telephony.disable-call system property.

int CALL_BARRED

Call was blocked by call barring

int CALL_PULLED

The call was terminated because it was pulled to another device.

int CANT_CALL_WHILE_RINGING

Indicates that a new outgoing call cannot be placed while there is a ringing call.

int CDMA_ACCESS_BLOCKED

Access Blocked by CDMA network

int CDMA_ACCESS_FAILURE

Unable to obtain access to the CDMA system

int CDMA_ALREADY_ACTIVATED

The call was terminated because CDMA phone service and roaming have already been activated.

int CDMA_DROP

Drop call

int CDMA_INTERCEPT

INTERCEPT order received, MS state idle entered

int CDMA_LOCKED_UNTIL_POWER_CYCLE

MS is locked until next power cycle

int CDMA_NOT_EMERGENCY

Not an emergency call

int CDMA_PREEMPTED

Not a preempted call

int CDMA_REORDER

MS has been redirected, call is cancelled

int CDMA_RETRY_ORDER

Requested service is rejected, retry delay is set

int CDMA_SO_REJECT

Service option rejection

int CONGESTION

Outgoing call to congested network

int CS_RESTRICTED

Call was blocked by restricted all voice access

int CS_RESTRICTED_EMERGENCY

Call was blocked by restricted emergency voice access

int CS_RESTRICTED_NORMAL

Call was blocked by restricted normal voice access

int DATA_DISABLED

The call was terminated because cellular data has been disabled.

int DATA_LIMIT_REACHED

The call was terminated because the data policy has disabled cellular data.

int DIALED_CALL_FORWARDING_WHILE_ROAMING

The call being placed was detected as a call forwarding number and was being dialed while roaming on a carrier that does not allow this.

int DIALED_MMI

Our initial phone number was actually an MMI sequence.

int DIAL_LOW_BATTERY

A call was not dialed because the device's battery is too low.

int DIAL_MODIFIED_TO_DIAL

Stk Call Control modified DIAL request to DIAL with modified data.

int DIAL_MODIFIED_TO_DIAL_VIDEO

Stk Call Control modified DIAL request to video DIAL request.

int DIAL_MODIFIED_TO_SS

Stk Call Control modified DIAL request to SS request.

int DIAL_MODIFIED_TO_USSD

Stk Call Control modified DIAL request to USSD request.

int DIAL_VIDEO_MODIFIED_TO_DIAL

Stk Call Control modified Video DIAL request to DIAL request.

int DIAL_VIDEO_MODIFIED_TO_DIAL_VIDEO

Stk Call Control modified Video DIAL request to Video DIAL request.

int DIAL_VIDEO_MODIFIED_TO_SS

Stk Call Control modified Video DIAL request to SS request.

int DIAL_VIDEO_MODIFIED_TO_USSD

Stk Call Control modified Video DIAL request to USSD request.

int EMERGENCY_CALL_OVER_WFC_NOT_AVAILABLE

Indicates that an emergency call cannot be placed over WFC because the service is not available in the current location.

int EMERGENCY_PERM_FAILURE

Emergency call failed with a permanent fail cause and should not be redialed on this slot.

int EMERGENCY_TEMP_FAILURE

Emergency call failed with a temporary fail cause and can be redialed on this slot.

int ERROR_UNSPECIFIED

Unknown error or not specified

int FDN_BLOCKED

Call was blocked by fixed dial number

int ICC_ERROR

No ICC, ICC locked, or other ICC error

int IMEI_NOT_ACCEPTED

The network does not accept the emergency call request because IMEI was used as identification and this cability is not supported by the network.

int IMS_ACCESS_BLOCKED

The call has failed because of access class barring.

int IMS_MERGED_SUCCESSFULLY

The call, which was an IMS call, disconnected because it merged with another call.

int IMS_SIP_ALTERNATE_EMERGENCY_CALL

The network has reported that an alternative emergency number has been dialed, but the user must exit airplane mode to place the call.

int INCOMING_AUTO_REJECTED

Indicates that incoming call was rejected by the modem before the call went in ringing

int INCOMING_MISSED

An incoming call that was missed and never answered

int INCOMING_REJECTED

An incoming call that was rejected

int INVALID_CREDENTIALS

Invalid credentials

int INVALID_NUMBER

Invalid dial string

int LIMIT_EXCEEDED

GSM or CDMA ACM limit exceeded

int LOCAL

Normal; Local hangup

int LOST_SIGNAL

Client went out of network range

int LOW_BATTERY

The call has ended (mid-call) because the device's battery is too low.

int MAXIMUM_NUMBER_OF_CALLS_REACHED

The call was terminated because the maximum allowable number of calls has been reached.

int MEDIA_TIMEOUT

Indicates that the call is dropped due to RTCP inactivity, primarily due to media path disruption.

int MMI

Not presently used

int NORMAL

Normal; Remote hangup

int NORMAL_UNSPECIFIED

This cause is used to report a normal event only when no other cause in the normal class applies.

int NOT_DISCONNECTED

Has not yet disconnected

int NOT_VALID

The disconnect cause is not valid (Not received a disconnect cause)

int NO_PHONE_NUMBER_SUPPLIED

The supplied CALL Intent didn't contain a valid phone number.

int NUMBER_UNREACHABLE

Cannot reach the peer

int OTASP_PROVISIONING_IN_PROCESS

Indicates that a new outgoing call cannot be placed because OTASP provisioning is currently in process.

int OUTGOING_CANCELED

The outgoing call was canceled by the ConnectionService.

int OUTGOING_EMERGENCY_CALL_PLACED

Indicates that an emergency call was placed, which caused the existing connection to be hung up.

int OUTGOING_FAILURE

The outgoing call failed with an unknown cause.

int OUT_OF_NETWORK

Calling from out of network is not allowed

int OUT_OF_SERVICE

Out of service

int POWER_OFF

Radio is turned off explicitly

int SATELLITE_ENABLED

Indicates that the call was unable to be made because the satellite modem is enabled.

int SERVER_ERROR

Server error

int SERVER_UNREACHABLE

Cannot reach the server

int TIMED_OUT

Client timed out

int TOO_MANY_ONGOING_CALLS

Indicates that a new outgoing call cannot be placed because there is currently an ongoing foreground and background call.

int UNOBTAINABLE_NUMBER

Unassigned number

int VIDEO_CALL_NOT_ALLOWED_WHILE_TTY_ENABLED

The call was terminated because it is not possible to place a video call while TTY is enabled.

int VOICEMAIL_NUMBER_MISSING

We tried to call a voicemail: URI but the device has no voicemail number configured.

int WFC_SERVICE_NOT_AVAILABLE_IN_THIS_LOCATION

Indicates that WiFi calling service is not available in the current location.

int WIFI_LOST

A call over WIFI was disconnected because the WIFI signal was lost or became too degraded to continue the call.

Inherited methods

Object clone()

Creates and returns a copy of this object.

boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

void finalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

final Class<?> getClass()

Returns the runtime class of this Object.

int hashCode()

Returns a hash code value for the object.

final void notify()

Wakes up a single thread that is waiting on this object's monitor.

final void notifyAll()

Wakes up all threads that are waiting on this object's monitor.

String toString()

Returns a string representation of the object.

final void wait(long timeoutMillis, int nanos)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait(long timeoutMillis)

Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

final void wait()

Causes the current thread to wait until it is awakened, typically by being notified or interrupted.

Constants

ALREADY_DIALING

Added in API level 31
public static final int ALREADY_DIALING

Indicates that a new outgoing call cannot be placed because there is already an outgoing call dialing out.

Constant Value: 72 (0x00000048)

ANSWERED_ELSEWHERE

Added in API level 31
public static final int ANSWERED_ELSEWHERE

The call was terminated because it was answered on another device.

Constant Value: 52 (0x00000034)

BUSY

Added in API level 31
public static final int BUSY

Outgoing call to busy line

Constant Value: 4 (0x00000004)

CALLING_DISABLED

Added in API level 31
public static final int CALLING_DISABLED

Indicates that a new outgoing call cannot be placed because calling has been disabled using the ro.telephony.disable-call system property.

Constant Value: 74 (0x0000004a)

CALL_BARRED

Added in API level 31
public static final int CALL_BARRED

Call was blocked by call barring

Constant Value: 20 (0x00000014)

CALL_PULLED

Added in API level 31
public static final int CALL_PULLED

The call was terminated because it was pulled to another device.

Constant Value: 51 (0x00000033)

CANT_CALL_WHILE_RINGING

Added in API level 31
public static final int CANT_CALL_WHILE_RINGING

Indicates that a new outgoing call cannot be placed while there is a ringing call.

Constant Value: 73 (0x00000049)

CDMA_ACCESS_BLOCKED

Added in API level 31
public static final int CDMA_ACCESS_BLOCKED

Access Blocked by CDMA network

Constant Value: 35 (0x00000023)

CDMA_ACCESS_FAILURE

Added in API level 31
public static final int CDMA_ACCESS_FAILURE

Unable to obtain access to the CDMA system

Constant Value: 32 (0x00000020)

CDMA_ALREADY_ACTIVATED

Added in API level 31
public static final int CDMA_ALREADY_ACTIVATED

The call was terminated because CDMA phone service and roaming have already been activated.

Constant Value: 49 (0x00000031)

CDMA_DROP

Added in API level 31
public static final int CDMA_DROP

Drop call

Constant Value: 27 (0x0000001b)

CDMA_INTERCEPT

Added in API level 31
public static final int CDMA_INTERCEPT

INTERCEPT order received, MS state idle entered

Constant Value: 28 (0x0000001c)

CDMA_LOCKED_UNTIL_POWER_CYCLE

Added in API level 31
public static final int CDMA_LOCKED_UNTIL_POWER_CYCLE

MS is locked until next power cycle

Constant Value: 26 (0x0000001a)

CDMA_NOT_EMERGENCY

Added in API level 31
public static final int CDMA_NOT_EMERGENCY

Not an emergency call

Constant Value: 34 (0x00000022)

CDMA_PREEMPTED

Added in API level 31
public static final int CDMA_PREEMPTED

Not a preempted call

Constant Value: 33 (0x00000021)

CDMA_REORDER

Added in API level 31
public static final int CDMA_REORDER

MS has been redirected, call is cancelled

Constant Value: 29 (0x0000001d)

CDMA_RETRY_ORDER

Added in API level 31
public static final int CDMA_RETRY_ORDER

Requested service is rejected, retry delay is set

Constant Value: 31 (0x0000001f)

CDMA_SO_REJECT

Added in API level 31
public static final int CDMA_SO_REJECT

Service option rejection

Constant Value: 30 (0x0000001e)

CONGESTION

Added in API level 31
public static final int CONGESTION

Outgoing call to congested network

Constant Value: 5 (0x00000005)

CS_RESTRICTED

Added in API level 31
public static final int CS_RESTRICTED

Call was blocked by restricted all voice access

Constant Value: 22 (0x00000016)

CS_RESTRICTED_EMERGENCY

Added in API level 31
public static final int CS_RESTRICTED_EMERGENCY

Call was blocked by restricted emergency voice access

Constant Value: 24 (0x00000018)

CS_RESTRICTED_NORMAL

Added in API level 31
public static final int CS_RESTRICTED_NORMAL

Call was blocked by restricted normal voice access

Constant Value: 23 (0x00000017)

DATA_DISABLED

Added in API level 31
public static final int DATA_DISABLED

The call was terminated because cellular data has been disabled. Used when in a video call and the user disables cellular data via the settings.

Constant Value: 54 (0x00000036)

DATA_LIMIT_REACHED

Added in API level 31
public static final int DATA_LIMIT_REACHED

The call was terminated because the data policy has disabled cellular data. Used when in a video call and the user has exceeded the device data limit.

Constant Value: 55 (0x00000037)

DIALED_CALL_FORWARDING_WHILE_ROAMING

Added in API level 31
public static final int DIALED_CALL_FORWARDING_WHILE_ROAMING

The call being placed was detected as a call forwarding number and was being dialed while roaming on a carrier that does not allow this.

Constant Value: 57 (0x00000039)

DIALED_MMI

Added in API level 31
public static final int DIALED_MMI

Our initial phone number was actually an MMI sequence.

Constant Value: 39 (0x00000027)

DIAL_LOW_BATTERY

Added in API level 31
public static final int DIAL_LOW_BATTERY

A call was not dialed because the device's battery is too low.

Constant Value: 62 (0x0000003e)

DIAL_MODIFIED_TO_DIAL

Added in API level 31
public static final int DIAL_MODIFIED_TO_DIAL

Stk Call Control modified DIAL request to DIAL with modified data.

Constant Value: 48 (0x00000030)

DIAL_MODIFIED_TO_DIAL_VIDEO

Added in API level 31
public static final int DIAL_MODIFIED_TO_DIAL_VIDEO

Stk Call Control modified DIAL request to video DIAL request.

Constant Value: 66 (0x00000042)

DIAL_MODIFIED_TO_SS

Added in API level 31
public static final int DIAL_MODIFIED_TO_SS

Stk Call Control modified DIAL request to SS request.

Constant Value: 47 (0x0000002f)

DIAL_MODIFIED_TO_USSD

Added in API level 31
public static final int DIAL_MODIFIED_TO_USSD

Stk Call Control modified DIAL request to USSD request.

Constant Value: 46 (0x0000002e)

DIAL_VIDEO_MODIFIED_TO_DIAL

Added in API level 31
public static final int DIAL_VIDEO_MODIFIED_TO_DIAL

Stk Call Control modified Video DIAL request to DIAL request.

Constant Value: 69 (0x00000045)

DIAL_VIDEO_MODIFIED_TO_DIAL_VIDEO

Added in API level 31
public static final int DIAL_VIDEO_MODIFIED_TO_DIAL_VIDEO

Stk Call Control modified Video DIAL request to Video DIAL request.

Constant Value: 70 (0x00000046)

DIAL_VIDEO_MODIFIED_TO_SS

Added in API level 31
public static final int DIAL_VIDEO_MODIFIED_TO_SS

Stk Call Control modified Video DIAL request to SS request.

Constant Value: 67 (0x00000043)

DIAL_VIDEO_MODIFIED_TO_USSD

Added in API level 31
public static final int DIAL_VIDEO_MODIFIED_TO_USSD

Stk Call Control modified Video DIAL request to USSD request.

Constant Value: 68 (0x00000044)

EMERGENCY_CALL_OVER_WFC_NOT_AVAILABLE

Added in API level 31
public static final int EMERGENCY_CALL_OVER_WFC_NOT_AVAILABLE

Indicates that an emergency call cannot be placed over WFC because the service is not available in the current location.

Constant Value: 78 (0x0000004e)

EMERGENCY_PERM_FAILURE

Added in API level 31
public static final int EMERGENCY_PERM_FAILURE

Emergency call failed with a permanent fail cause and should not be redialed on this slot.

Constant Value: 64 (0x00000040)

EMERGENCY_TEMP_FAILURE

Added in API level 31
public static final int EMERGENCY_TEMP_FAILURE

Emergency call failed with a temporary fail cause and can be redialed on this slot.

Constant Value: 63 (0x0000003f)

ERROR_UNSPECIFIED

Added in API level 31
public static final int ERROR_UNSPECIFIED

Unknown error or not specified

Constant Value: 36 (0x00000024)

FDN_BLOCKED

Added in API level 31
public static final int FDN_BLOCKED

Call was blocked by fixed dial number

Constant Value: 21 (0x00000015)

ICC_ERROR

Added in API level 31
public static final int ICC_ERROR

No ICC, ICC locked, or other ICC error

Constant Value: 19 (0x00000013)

IMEI_NOT_ACCEPTED

Added in API level 31
public static final int IMEI_NOT_ACCEPTED

The network does not accept the emergency call request because IMEI was used as identification and this cability is not supported by the network.

Constant Value: 58 (0x0000003a)

IMS_ACCESS_BLOCKED

Added in API level 31
public static final int IMS_ACCESS_BLOCKED

The call has failed because of access class barring.

Constant Value: 60 (0x0000003c)

IMS_MERGED_SUCCESSFULLY

Added in API level 31
public static final int IMS_MERGED_SUCCESSFULLY

The call, which was an IMS call, disconnected because it merged with another call.

Constant Value: 45 (0x0000002d)

IMS_SIP_ALTERNATE_EMERGENCY_CALL

Added in API level 31
public static final int IMS_SIP_ALTERNATE_EMERGENCY_CALL

The network has reported that an alternative emergency number has been dialed, but the user must exit airplane mode to place the call.

Constant Value: 71 (0x00000047)

INCOMING_AUTO_REJECTED

Added in API level 31
public static final int INCOMING_AUTO_REJECTED

Indicates that incoming call was rejected by the modem before the call went in ringing

Constant Value: 81 (0x00000051)

INCOMING_MISSED

Added in API level 31
public static final int INCOMING_MISSED

An incoming call that was missed and never answered

Constant Value: 1 (0x00000001)

INCOMING_REJECTED

Added in API level 31
public static final int INCOMING_REJECTED

An incoming call that was rejected

Constant Value: 16 (0x00000010)

INVALID_CREDENTIALS

Added in API level 31
public static final int INVALID_CREDENTIALS

Invalid credentials

Constant Value: 10 (0x0000000a)

INVALID_NUMBER

Added in API level 31
public static final int INVALID_NUMBER

Invalid dial string

Constant Value: 7 (0x00000007)

LIMIT_EXCEEDED

Added in API level 31
public static final int LIMIT_EXCEEDED

GSM or CDMA ACM limit exceeded

Constant Value: 15 (0x0000000f)

LOCAL

Added in API level 31
public static final int LOCAL

Normal; Local hangup

Constant Value: 3 (0x00000003)

LOST_SIGNAL

Added in API level 31
public static final int LOST_SIGNAL

Client went out of network range

Constant Value: 14 (0x0000000e)

LOW_BATTERY

Added in API level 31
public static final int LOW_BATTERY

The call has ended (mid-call) because the device's battery is too low.

Constant Value: 61 (0x0000003d)

MAXIMUM_NUMBER_OF_CALLS_REACHED

Added in API level 31
public static final int MAXIMUM_NUMBER_OF_CALLS_REACHED

The call was terminated because the maximum allowable number of calls has been reached.

Constant Value: 53 (0x00000035)

MEDIA_TIMEOUT

Added in API level 31
public static final int MEDIA_TIMEOUT

Indicates that the call is dropped due to RTCP inactivity, primarily due to media path disruption.

Constant Value: 77 (0x0000004d)

MMI

Added in API level 31
public static final int MMI

Not presently used

Constant Value: 6 (0x00000006)

NORMAL

Added in API level 31
public static final int NORMAL

Normal; Remote hangup

Constant Value: 2 (0x00000002)

NORMAL_UNSPECIFIED

Added in API level 31
public static final int NORMAL_UNSPECIFIED

This cause is used to report a normal event only when no other cause in the normal class applies.

Constant Value: 65 (0x00000041)

NOT_DISCONNECTED

Added in API level 31
public static final int NOT_DISCONNECTED

Has not yet disconnected

Constant Value: 0 (0x00000000)

NOT_VALID

Added in API level 31
public static final int NOT_VALID

The disconnect cause is not valid (Not received a disconnect cause)

Constant Value: -1 (0xffffffff)

NO_PHONE_NUMBER_SUPPLIED

Added in API level 31
public static final int NO_PHONE_NUMBER_SUPPLIED

The supplied CALL Intent didn't contain a valid phone number.

Constant Value: 38 (0x00000026)

NUMBER_UNREACHABLE

Added in API level 31
public static final int NUMBER_UNREACHABLE

Cannot reach the peer

Constant Value: 8 (0x00000008)

OTASP_PROVISIONING_IN_PROCESS

Added in API level 31
public static final int OTASP_PROVISIONING_IN_PROCESS

Indicates that a new outgoing call cannot be placed because OTASP provisioning is currently in process.

Constant Value: 76 (0x0000004c)

OUTGOING_CANCELED

Added in API level 31
public static final int OUTGOING_CANCELED

The outgoing call was canceled by the ConnectionService.

Constant Value: 44 (0x0000002c)

OUTGOING_EMERGENCY_CALL_PLACED

Added in API level 31
public static final int OUTGOING_EMERGENCY_CALL_PLACED

Indicates that an emergency call was placed, which caused the existing connection to be hung up.

Constant Value: 80 (0x00000050)

OUTGOING_FAILURE

Added in API level 31
public static final int OUTGOING_FAILURE

The outgoing call failed with an unknown cause.

Constant Value: 43 (0x0000002b)

OUT_OF_NETWORK

Added in API level 31
public static final int OUT_OF_NETWORK

Calling from out of network is not allowed

Constant Value: 11 (0x0000000b)

OUT_OF_SERVICE

Added in API level 31
public static final int OUT_OF_SERVICE

Out of service

Constant Value: 18 (0x00000012)

POWER_OFF

Added in API level 31
public static final int POWER_OFF

Radio is turned off explicitly

Constant Value: 17 (0x00000011)

SATELLITE_ENABLED

Added in API level 35
public static final int SATELLITE_ENABLED

Indicates that the call was unable to be made because the satellite modem is enabled.

Constant Value: 82 (0x00000052)

SERVER_ERROR

Added in API level 31
public static final int SERVER_ERROR

Server error

Constant Value: 12 (0x0000000c)

SERVER_UNREACHABLE

Added in API level 31
public static final int SERVER_UNREACHABLE

Cannot reach the server

Constant Value: 9 (0x00000009)

TIMED_OUT

Added in API level 31
public static final int TIMED_OUT

Client timed out

Constant Value: 13 (0x0000000d)

TOO_MANY_ONGOING_CALLS

Added in API level 31
public static final int TOO_MANY_ONGOING_CALLS

Indicates that a new outgoing call cannot be placed because there is currently an ongoing foreground and background call.

Constant Value: 75 (0x0000004b)

UNOBTAINABLE_NUMBER

Added in API level 31
public static final int UNOBTAINABLE_NUMBER

Unassigned number

Constant Value: 25 (0x00000019)

VIDEO_CALL_NOT_ALLOWED_WHILE_TTY_ENABLED

Added in API level 31
public static final int VIDEO_CALL_NOT_ALLOWED_WHILE_TTY_ENABLED

The call was terminated because it is not possible to place a video call while TTY is enabled.

Constant Value: 50 (0x00000032)

VOICEMAIL_NUMBER_MISSING

Added in API level 31
public static final int VOICEMAIL_NUMBER_MISSING

We tried to call a voicemail: URI but the device has no voicemail number configured.

Constant Value: 40 (0x00000028)

WFC_SERVICE_NOT_AVAILABLE_IN_THIS_LOCATION

Added in API level 31
public static final int WFC_SERVICE_NOT_AVAILABLE_IN_THIS_LOCATION

Indicates that WiFi calling service is not available in the current location.

Constant Value: 79 (0x0000004f)

WIFI_LOST

Added in API level 31
public static final int WIFI_LOST

A call over WIFI was disconnected because the WIFI signal was lost or became too degraded to continue the call.

Constant Value: 59 (0x0000003b)