Added in API level 34

CallException

---

Kotlin |Java

class CallException : RuntimeException, Parcelable

kotlin.Any
↳	kotlin.Throwable
	↳	java.lang.Exception
		↳	java.lang.RuntimeException
			↳	android.telecom.CallException

This class defines exceptions that can be thrown when using Telecom APIs with android.os.OutcomeReceivers. Most of these exceptions are thrown when changing a call state with CallControls or CallControlCallbacks.

Summary

Constants
static Int	CODE_CALL_CANNOT_BE_SET_TO_ACTIVE The operation has failed because Telecom cannot set the requested call as the current active call.
static Int	CODE_CALL_IS_NOT_BEING_TRACKED The operation has failed because Telecom has already removed the call from the server side and destroyed all the objects associated with it.
static Int	CODE_CALL_NOT_PERMITTED_AT_PRESENT_TIME The operation has failed because there is either no PhoneAccount registered with Telecom for the given operation, or the limit of calls has been reached.
static Int	CODE_CANNOT_HOLD_CURRENT_ACTIVE_CALL The operation has failed due to Telecom failing to hold the current active call for the call attempting to become the new active call.
static Int	CODE_ERROR_UNKNOWN The operation has failed due to an unknown or unspecified error.
static Int	CODE_OPERATION_TIMED_OUT The operation has failed because the operation failed to complete before the timeout

Inherited constants

From class Parcelable Int CONTENTS_FILE_DESCRIPTOR Descriptor bit used with describeContents(): indicates that the Parcelable object's flattened representation includes a file descriptor. Int PARCELABLE_WRITE_RETURN_VALUE Flag for use with writeToParcel: the object being written is a return value, that is the result of a function such as "Parcelable someFunction()", "void someFunction(out Parcelable)", or "void someFunction(inout Parcelable)". Some implementations may want to release resources at this point.

Public constructors
CallException(message: String?, code: Int) Constructor for a new CallException that has a defined error code in this class

Public methods
Int	describeContents()
Int	getCode()
Unit	writeToParcel(dest: Parcel, flags: Int)

Properties
static Parcelable.Creator<CallException!>	CREATOR Responsible for creating CallAttribute objects for deserialized Parcels.

Constants

CODE_CALL_CANNOT_BE_SET_TO_ACTIVE

Added in API level 34

static val CODE_CALL_CANNOT_BE_SET_TO_ACTIVE: Int

The operation has failed because Telecom cannot set the requested call as the current active call. The client should end the current active call and re-try the operation.

Value: 4

CODE_CALL_IS_NOT_BEING_TRACKED

Added in API level 34

static val CODE_CALL_IS_NOT_BEING_TRACKED: Int

The operation has failed because Telecom has already removed the call from the server side and destroyed all the objects associated with it. The client should re-add the call.

Value: 3

CODE_CALL_NOT_PERMITTED_AT_PRESENT_TIME

Added in API level 34

static val CODE_CALL_NOT_PERMITTED_AT_PRESENT_TIME: Int

The operation has failed because there is either no PhoneAccount registered with Telecom for the given operation, or the limit of calls has been reached. The client should end the current active call and re-try the failed operation.

Value: 5

CODE_CANNOT_HOLD_CURRENT_ACTIVE_CALL

Added in API level 34

static val CODE_CANNOT_HOLD_CURRENT_ACTIVE_CALL: Int

The operation has failed due to Telecom failing to hold the current active call for the call attempting to become the new active call. The client should end the current active call and re-try the failed operation.

Value: 2

CODE_ERROR_UNKNOWN

Added in API level 34

static val CODE_ERROR_UNKNOWN: Int

The operation has failed due to an unknown or unspecified error.

Value: 1

CODE_OPERATION_TIMED_OUT

Added in API level 34

static val CODE_OPERATION_TIMED_OUT: Int

The operation has failed because the operation failed to complete before the timeout

Value: 6

Public constructors

CallException

Added in API level 34

CallException(
    message: String?, 
    code: Int)

Constructor for a new CallException that has a defined error code in this class

Parameters
message	String?: related to why the exception was created This value may be null.
code	Int: defined above that caused this exception to be created Value is android.telecom.CallException#CODE_ERROR_UNKNOWN, android.telecom.CallException#CODE_CANNOT_HOLD_CURRENT_ACTIVE_CALL, android.telecom.CallException#CODE_CALL_IS_NOT_BEING_TRACKED, android.telecom.CallException#CODE_CALL_CANNOT_BE_SET_TO_ACTIVE, android.telecom.CallException#CODE_CALL_NOT_PERMITTED_AT_PRESENT_TIME, or android.telecom.CallException#CODE_OPERATION_TIMED_OUT

Public methods

describeContents

Added in API level 34

fun describeContents(): Int

Return
Int	a bitmask indicating the set of special object types marshaled by this Parcelable object instance. Value is either 0 or android.os.Parcelable#CONTENTS_FILE_DESCRIPTOR

getCode

Added in API level 34

fun getCode(): Int

Return

Int

one of the error codes defined in this class that was passed into the constructor Value is android.telecom.CallException#CODE_ERROR_UNKNOWN, android.telecom.CallException#CODE_CANNOT_HOLD_CURRENT_ACTIVE_CALL, android.telecom.CallException#CODE_CALL_IS_NOT_BEING_TRACKED, android.telecom.CallException#CODE_CALL_CANNOT_BE_SET_TO_ACTIVE, android.telecom.CallException#CODE_CALL_NOT_PERMITTED_AT_PRESENT_TIME, or android.telecom.CallException#CODE_OPERATION_TIMED_OUT

writeToParcel

Added in API level 34

fun writeToParcel(
    dest: Parcel, 
    flags: Int
): Unit

Parameters
dest	Parcel: The Parcel in which the object should be written. This value cannot be null.
flags	Int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE. Value is either 0 or a combination of android.os.Parcelable#PARCELABLE_WRITE_RETURN_VALUE, and android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES

Properties

CREATOR

Added in API level 34

static val CREATOR: Parcelable.Creator<CallException!>

Responsible for creating CallAttribute objects for deserialized Parcels.