Added in API level 31

Summary: Constants | Ctors | Methods | Inherited Methods

TelephonyManager.CallComposerException

Kotlin |Java

public static class TelephonyManager.CallComposerException
extends Exception

java.lang.Object
↳	java.lang.Throwable
	↳	java.lang.Exception
		↳	android.telephony.TelephonyManager.CallComposerException

Exception that may be supplied to the callback in TelephonyManager.uploadCallComposerPicture(InputStream, String, Executor, OutcomeReceiver) if something goes awry.

Summary

Constants
`int`	`ERROR_AUTHENTICATION_FAILED` Indicates that the device failed to authenticate with the carrier when uploading the picture.
`int`	`ERROR_FILE_TOO_LARGE` Indicates that the file or stream supplied exceeds the size limit defined in `TelephonyManager.getMaximumCallComposerPictureSize()`.
`int`	`ERROR_INPUT_CLOSED` Indicates that the `InputStream` passed to `TelephonyManager.uploadCallComposerPicture(InputStream, String, Executor, OutcomeReceiver)` was closed.
`int`	`ERROR_IO_EXCEPTION` Indicates that an `IOException` was encountered while reading the picture.
`int`	`ERROR_NETWORK_UNAVAILABLE` Indicates that the device is currently not connected to a network that's capable of reaching a carrier's RCS servers.
`int`	`ERROR_REMOTE_END_CLOSED` Indicates that the phone process died or otherwise became unavailable while uploading the call composer picture.
`int`	`ERROR_UNKNOWN` Indicates that an unknown error was encountered when uploading the call composer picture.

Public constructors
`CallComposerException(int errorCode, IOException ioException)`

Public methods
`int`	`getErrorCode()` Fetches the error code associated with this exception.
`IOException`	`getIOException()` Fetches the `IOException` that caused the error.

Inherited methods

From class


        
          java.lang.Throwable

`final void`	`addSuppressed(Throwable exception)` Appends the specified exception to the exceptions that were suppressed in order to deliver this exception.
`Throwable`	`fillInStackTrace()` Fills in the execution stack trace.
`Throwable`	`getCause()` Returns the cause of this throwable or `null` if the cause is nonexistent or unknown.
`String`	`getLocalizedMessage()` Creates a localized description of this throwable.
`String`	`getMessage()` Returns the detail message string of this throwable.
`StackTraceElement[]`	`getStackTrace()` Provides programmatic access to the stack trace information printed by `printStackTrace()`.
`final Throwable[]`	`getSuppressed()` Returns an array containing all of the exceptions that were suppressed, typically by the `try`-with-resources statement, in order to deliver this exception.
`Throwable`	`initCause(Throwable cause)` Initializes the cause of this throwable to the specified value.
`void`	`printStackTrace()` Prints this throwable and its backtrace to the standard error stream.
`void`	`printStackTrace(PrintWriter s)` Prints this throwable and its backtrace to the specified print writer.
`void`	`printStackTrace(PrintStream s)` Prints this throwable and its backtrace to the specified print stream.
`void`	`setStackTrace(StackTraceElement[] stackTrace)` Sets the stack trace elements that will be returned by `getStackTrace()` and printed by `printStackTrace()` and related methods.
`String`	`toString()` Returns a short description of this throwable.

From class


        
          java.lang.Object

`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

ERROR_AUTHENTICATION_FAILED

Added in API level 31

public static final int ERROR_AUTHENTICATION_FAILED

Indicates that the device failed to authenticate with the carrier when uploading the picture. Clients that encounter this error should not retry the upload unless a reboot or radio reset has been performed in the interim.

Constant Value: 3 (0x00000003)

ERROR_FILE_TOO_LARGE

Added in API level 31

public static final int ERROR_FILE_TOO_LARGE

Indicates that the file or stream supplied exceeds the size limit defined in TelephonyManager.getMaximumCallComposerPictureSize(). Clients that encounter this error should retry the upload after reducing the size of the picture.

Constant Value: 2 (0x00000002)

ERROR_INPUT_CLOSED

Added in API level 31

public static final int ERROR_INPUT_CLOSED

Indicates that the InputStream passed to TelephonyManager.uploadCallComposerPicture(InputStream, String, Executor, OutcomeReceiver) was closed. The caller should retry if this error is encountered, and be sure to not close the stream before the callback is called this time.

Constant Value: 4 (0x00000004)

ERROR_IO_EXCEPTION

Added in API level 31

public static final int ERROR_IO_EXCEPTION

Indicates that an IOException was encountered while reading the picture. The offending IOException will be available via getIOException(). Clients should use the contents of the exception to determine whether a retry is warranted.

Constant Value: 5 (0x00000005)

ERROR_NETWORK_UNAVAILABLE

Added in API level 31

public static final int ERROR_NETWORK_UNAVAILABLE

Indicates that the device is currently not connected to a network that's capable of reaching a carrier's RCS servers. Clients should prompt the user to remedy the issue by moving to an area with better signal, by connecting to a different network, or to retry at another time.

Constant Value: 6 (0x00000006)

ERROR_REMOTE_END_CLOSED

Added in API level 31

public static final int ERROR_REMOTE_END_CLOSED

Indicates that the phone process died or otherwise became unavailable while uploading the call composer picture. Clients that encounter this error should retry the upload.

Constant Value: 1 (0x00000001)

ERROR_UNKNOWN

Added in API level 31

public static final int ERROR_UNKNOWN

Indicates that an unknown error was encountered when uploading the call composer picture. Clients that encounter this error should retry the upload.

Constant Value: 0 (0x00000000)

Public constructors

CallComposerException

Added in API level 31

public CallComposerException (int errorCode, 
                IOException ioException)

Parameters
`errorCode`	`int`: Value is `ERROR_UNKNOWN`, `ERROR_REMOTE_END_CLOSED`, `ERROR_FILE_TOO_LARGE`, `ERROR_AUTHENTICATION_FAILED`, `ERROR_INPUT_CLOSED`, `ERROR_IO_EXCEPTION`, or `ERROR_NETWORK_UNAVAILABLE`
`ioException`	`IOException`: This value may be `null`.

Public methods

getErrorCode

Added in API level 31

public int getErrorCode ()

Fetches the error code associated with this exception.

Returns
`int`	An error code. Value is `ERROR_UNKNOWN`, `ERROR_REMOTE_END_CLOSED`, `ERROR_FILE_TOO_LARGE`, `ERROR_AUTHENTICATION_FAILED`, `ERROR_INPUT_CLOSED`, `ERROR_IO_EXCEPTION`, or `ERROR_NETWORK_UNAVAILABLE`

getIOException

Added in API level 31

public IOException getIOException ()

Fetches the IOException that caused the error.

Returns
`IOException`	This value may be `null`.