Added in API level 31

DisconnectCause

class DisconnectCause
kotlin.Any
   ↳ android.telephony.DisconnectCause

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

Summary

Constants
static Int

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

static Int

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

static Int

Outgoing call to busy line

static Int

Indicates that a new outgoing call cannot be placed because calling has been disabled using the ro.

static Int

Call was blocked by call barring

static Int

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

static Int

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

static Int

Access Blocked by CDMA network

static Int

Unable to obtain access to the CDMA system

static Int

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

static Int

Drop call

static Int

INTERCEPT order received, MS state idle entered

static Int

MS is locked until next power cycle

static Int

Not an emergency call

static Int

Not a preempted call

static Int

MS has been redirected, call is cancelled

static Int

Requested service is rejected, retry delay is set

static Int

Service option rejection

static Int

Outgoing call to congested network

static Int

Call was blocked by restricted all voice access

static Int

Call was blocked by restricted emergency voice access

static Int

Call was blocked by restricted normal voice access

static Int

The call was terminated because cellular data has been disabled.

static Int

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

static Int

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.

static Int

Our initial phone number was actually an MMI sequence.

static Int

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

static Int

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

static Int

Stk Call Control modified DIAL request to video DIAL request.

static Int

Stk Call Control modified DIAL request to SS request.

static Int

Stk Call Control modified DIAL request to USSD request.

static Int

Stk Call Control modified Video DIAL request to DIAL request.

static Int

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

static Int

Stk Call Control modified Video DIAL request to SS request.

static Int

Stk Call Control modified Video DIAL request to USSD request.

static Int

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

static Int

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

static Int

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

static Int

Unknown error or not specified

static Int

Call was blocked by fixed dial number

static Int

No ICC, ICC locked, or other ICC error

static Int

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

static Int

The call has failed because of access class barring.

static Int

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

static Int

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

static Int

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

static Int

An incoming call that was missed and never answered

static Int

An incoming call that was rejected

static Int

Invalid credentials

static Int

Invalid dial string

static Int

GSM or CDMA ACM limit exceeded

static Int

Normal; Local hangup

static Int

Client went out of network range

static Int

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

static Int

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

static Int

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

static Int

Not presently used

static Int

Normal; Remote hangup

static Int

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

static Int

Has not yet disconnected

static Int

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

static Int

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

static Int

Cannot reach the peer

static Int

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

static Int

The outgoing call was canceled by the android.telecom.ConnectionService.

static Int

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

static Int

The outgoing call failed with an unknown cause.

static Int

Calling from out of network is not allowed

static Int

Out of service

static Int

Radio is turned off explicitly

static Int

Server error

static Int

Cannot reach the server

static Int

Client timed out

static Int

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

static Int

Unassigned number

static Int

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

static Int

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

static Int

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

static Int

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

Constants

ALREADY_DIALING

Added in API level 31
static val ALREADY_DIALING: Int

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

Value: 72

ANSWERED_ELSEWHERE

Added in API level 31
static val ANSWERED_ELSEWHERE: Int

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

Value: 52

BUSY

Added in API level 31
static val BUSY: Int

Outgoing call to busy line

Value: 4

CALLING_DISABLED

Added in API level 31
static val CALLING_DISABLED: Int

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

Value: 74

CALL_BARRED

Added in API level 31
static val CALL_BARRED: Int

Call was blocked by call barring

Value: 20

CALL_PULLED

Added in API level 31
static val CALL_PULLED: Int

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

Value: 51

CANT_CALL_WHILE_RINGING

Added in API level 31
static val CANT_CALL_WHILE_RINGING: Int

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

Value: 73

CDMA_ACCESS_BLOCKED

Added in API level 31
static val CDMA_ACCESS_BLOCKED: Int

Access Blocked by CDMA network

Value: 35

CDMA_ACCESS_FAILURE

Added in API level 31
static val CDMA_ACCESS_FAILURE: Int

Unable to obtain access to the CDMA system

Value: 32

CDMA_ALREADY_ACTIVATED

Added in API level 31
static val CDMA_ALREADY_ACTIVATED: Int

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

Value: 49

CDMA_DROP

Added in API level 31
static val CDMA_DROP: Int

Drop call

Value: 27

CDMA_INTERCEPT

Added in API level 31
static val CDMA_INTERCEPT: Int

INTERCEPT order received, MS state idle entered

Value: 28

CDMA_LOCKED_UNTIL_POWER_CYCLE

Added in API level 31
static val CDMA_LOCKED_UNTIL_POWER_CYCLE: Int

MS is locked until next power cycle

Value: 26

CDMA_NOT_EMERGENCY

Added in API level 31
static val CDMA_NOT_EMERGENCY: Int

Not an emergency call

Value: 34

CDMA_PREEMPTED

Added in API level 31
static val CDMA_PREEMPTED: Int

Not a preempted call

Value: 33

CDMA_REORDER

Added in API level 31
static val CDMA_REORDER: Int

MS has been redirected, call is cancelled

Value: 29

CDMA_RETRY_ORDER

Added in API level 31
static val CDMA_RETRY_ORDER: Int

Requested service is rejected, retry delay is set

Value: 31

CDMA_SO_REJECT

Added in API level 31
static val CDMA_SO_REJECT: Int

Service option rejection

Value: 30

CONGESTION

Added in API level 31
static val CONGESTION: Int

Outgoing call to congested network

Value: 5

CS_RESTRICTED

Added in API level 31
static val CS_RESTRICTED: Int

Call was blocked by restricted all voice access

Value: 22

CS_RESTRICTED_EMERGENCY

Added in API level 31
static val CS_RESTRICTED_EMERGENCY: Int

Call was blocked by restricted emergency voice access

Value: 24

CS_RESTRICTED_NORMAL

Added in API level 31
static val CS_RESTRICTED_NORMAL: Int

Call was blocked by restricted normal voice access

Value: 23

DATA_DISABLED

Added in API level 31
static val DATA_DISABLED: Int

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.

Value: 54

DATA_LIMIT_REACHED

Added in API level 31
static val DATA_LIMIT_REACHED: Int

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.

Value: 55

DIALED_CALL_FORWARDING_WHILE_ROAMING

Added in API level 31
static val DIALED_CALL_FORWARDING_WHILE_ROAMING: Int

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.

Value: 57

DIALED_MMI

Added in API level 31
static val DIALED_MMI: Int

Our initial phone number was actually an MMI sequence.

Value: 39

DIAL_LOW_BATTERY

Added in API level 31
static val DIAL_LOW_BATTERY: Int

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

Value: 62

DIAL_MODIFIED_TO_DIAL

Added in API level 31
static val DIAL_MODIFIED_TO_DIAL: Int

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

Value: 48

DIAL_MODIFIED_TO_DIAL_VIDEO

Added in API level 31
static val DIAL_MODIFIED_TO_DIAL_VIDEO: Int

Stk Call Control modified DIAL request to video DIAL request.

Value: 66

DIAL_MODIFIED_TO_SS

Added in API level 31
static val DIAL_MODIFIED_TO_SS: Int

Stk Call Control modified DIAL request to SS request.

Value: 47

DIAL_MODIFIED_TO_USSD

Added in API level 31
static val DIAL_MODIFIED_TO_USSD: Int

Stk Call Control modified DIAL request to USSD request.

Value: 46

DIAL_VIDEO_MODIFIED_TO_DIAL

Added in API level 31
static val DIAL_VIDEO_MODIFIED_TO_DIAL: Int

Stk Call Control modified Video DIAL request to DIAL request.

Value: 69

DIAL_VIDEO_MODIFIED_TO_DIAL_VIDEO

Added in API level 31
static val DIAL_VIDEO_MODIFIED_TO_DIAL_VIDEO: Int

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

Value: 70

DIAL_VIDEO_MODIFIED_TO_SS

Added in API level 31
static val DIAL_VIDEO_MODIFIED_TO_SS: Int

Stk Call Control modified Video DIAL request to SS request.

Value: 67

DIAL_VIDEO_MODIFIED_TO_USSD

Added in API level 31
static val DIAL_VIDEO_MODIFIED_TO_USSD: Int

Stk Call Control modified Video DIAL request to USSD request.

Value: 68

EMERGENCY_CALL_OVER_WFC_NOT_AVAILABLE

Added in API level 31
static val EMERGENCY_CALL_OVER_WFC_NOT_AVAILABLE: Int

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

Value: 78

EMERGENCY_PERM_FAILURE

Added in API level 31
static val EMERGENCY_PERM_FAILURE: Int

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

Value: 64

EMERGENCY_TEMP_FAILURE

Added in API level 31
static val EMERGENCY_TEMP_FAILURE: Int

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

Value: 63

ERROR_UNSPECIFIED

Added in API level 31
static val ERROR_UNSPECIFIED: Int

Unknown error or not specified

Value: 36

FDN_BLOCKED

Added in API level 31
static val FDN_BLOCKED: Int

Call was blocked by fixed dial number

Value: 21

ICC_ERROR

Added in API level 31
static val ICC_ERROR: Int

No ICC, ICC locked, or other ICC error

Value: 19

IMEI_NOT_ACCEPTED

Added in API level 31
static val IMEI_NOT_ACCEPTED: Int

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

Value: 58

IMS_ACCESS_BLOCKED

Added in API level 31
static val IMS_ACCESS_BLOCKED: Int

The call has failed because of access class barring.

Value: 60

IMS_MERGED_SUCCESSFULLY

Added in API level 31
static val IMS_MERGED_SUCCESSFULLY: Int

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

Value: 45

IMS_SIP_ALTERNATE_EMERGENCY_CALL

Added in API level 31
static val IMS_SIP_ALTERNATE_EMERGENCY_CALL: Int

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

Value: 71

INCOMING_AUTO_REJECTED

Added in API level 31
static val INCOMING_AUTO_REJECTED: Int

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

Value: 81

INCOMING_MISSED

Added in API level 31
static val INCOMING_MISSED: Int

An incoming call that was missed and never answered

Value: 1

INCOMING_REJECTED

Added in API level 31
static val INCOMING_REJECTED: Int

An incoming call that was rejected

Value: 16

INVALID_CREDENTIALS

Added in API level 31
static val INVALID_CREDENTIALS: Int

Invalid credentials

Value: 10

INVALID_NUMBER

Added in API level 31
static val INVALID_NUMBER: Int

Invalid dial string

Value: 7

LIMIT_EXCEEDED

Added in API level 31
static val LIMIT_EXCEEDED: Int

GSM or CDMA ACM limit exceeded

Value: 15

LOCAL

Added in API level 31
static val LOCAL: Int

Normal; Local hangup

Value: 3

LOST_SIGNAL

Added in API level 31
static val LOST_SIGNAL: Int

Client went out of network range

Value: 14

LOW_BATTERY

Added in API level 31
static val LOW_BATTERY: Int

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

Value: 61

MAXIMUM_NUMBER_OF_CALLS_REACHED

Added in API level 31
static val MAXIMUM_NUMBER_OF_CALLS_REACHED: Int

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

Value: 53

MEDIA_TIMEOUT

Added in API level 31
static val MEDIA_TIMEOUT: Int

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

Value: 77

MMI

Added in API level 31
static val MMI: Int

Not presently used

Value: 6

NORMAL

Added in API level 31
static val NORMAL: Int

Normal; Remote hangup

Value: 2

NORMAL_UNSPECIFIED

Added in API level 31
static val NORMAL_UNSPECIFIED: Int

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

Value: 65

NOT_DISCONNECTED

Added in API level 31
static val NOT_DISCONNECTED: Int

Has not yet disconnected

Value: 0

NOT_VALID

Added in API level 31
static val NOT_VALID: Int

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

Value: -1

NO_PHONE_NUMBER_SUPPLIED

Added in API level 31
static val NO_PHONE_NUMBER_SUPPLIED: Int

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

Value: 38

NUMBER_UNREACHABLE

Added in API level 31
static val NUMBER_UNREACHABLE: Int

Cannot reach the peer

Value: 8

OTASP_PROVISIONING_IN_PROCESS

Added in API level 31
static val OTASP_PROVISIONING_IN_PROCESS: Int

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

Value: 76

OUTGOING_CANCELED

Added in API level 31
static val OUTGOING_CANCELED: Int

The outgoing call was canceled by the android.telecom.ConnectionService.

Value: 44

OUTGOING_EMERGENCY_CALL_PLACED

Added in API level 31
static val OUTGOING_EMERGENCY_CALL_PLACED: Int

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

Value: 80

OUTGOING_FAILURE

Added in API level 31
static val OUTGOING_FAILURE: Int

The outgoing call failed with an unknown cause.

Value: 43

OUT_OF_NETWORK

Added in API level 31
static val OUT_OF_NETWORK: Int

Calling from out of network is not allowed

Value: 11

OUT_OF_SERVICE

Added in API level 31
static val OUT_OF_SERVICE: Int

Out of service

Value: 18

POWER_OFF

Added in API level 31
static val POWER_OFF: Int

Radio is turned off explicitly

Value: 17

SERVER_ERROR

Added in API level 31
static val SERVER_ERROR: Int

Server error

Value: 12

SERVER_UNREACHABLE

Added in API level 31
static val SERVER_UNREACHABLE: Int

Cannot reach the server

Value: 9

TIMED_OUT

Added in API level 31
static val TIMED_OUT: Int

Client timed out

Value: 13

TOO_MANY_ONGOING_CALLS

Added in API level 31
static val TOO_MANY_ONGOING_CALLS: Int

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

Value: 75

UNOBTAINABLE_NUMBER

Added in API level 31
static val UNOBTAINABLE_NUMBER: Int

Unassigned number

Value: 25

VIDEO_CALL_NOT_ALLOWED_WHILE_TTY_ENABLED

Added in API level 31
static val VIDEO_CALL_NOT_ALLOWED_WHILE_TTY_ENABLED: Int

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

Value: 50

VOICEMAIL_NUMBER_MISSING

Added in API level 31
static val VOICEMAIL_NUMBER_MISSING: Int

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

Value: 40

WFC_SERVICE_NOT_AVAILABLE_IN_THIS_LOCATION

Added in API level 31
static val WFC_SERVICE_NOT_AVAILABLE_IN_THIS_LOCATION: Int

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

Value: 79

WIFI_LOST

Added in API level 31
static val WIFI_LOST: Int

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

Value: 59