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

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)