public enum CallError

ImplementsComparable<CallError>

Typed error codes carried by every CallException thrown through the failure path of the com.codename1.call APIs. Callers branch on these via CallException.getError() rather than string-matching a message.

The set is deliberately shared between iOS and Android even though the two platforms refuse a call for different reasons and at different layers. CallKit answers a refusal through the NSError handed to reportNewIncomingCall’s completion block; Telecom answers it by calling onCreateIncomingConnectionFailed. Both funnel here, because an app that has to ask which platform it is on to find out why a call did not ring would end up with two code paths and would test only one of them.

Enum constants

`NOT_SUPPORTED`	System call integration is not available on this port, this OS version or this device.
`UNAUTHORIZED`	A permission the operation needed is missing.
`CALL_REFUSED`	The system refused to place or ring this call right now, and may accept the same call later.
`CALL_FILTERED`	The system suppressed the call before it ever rang: Do Not Disturb on iOS, or a number the user has blocked.
`DUPLICATE_CALL`	A call with this identifier is already known to the system.
`INVALID_ID`	The supplied call identifier is not a canonical identifier, or names a call the system no longer has.
`ACTION_TIMEOUT`	The system asked the app to act on a call and the app neither fulfilled nor failed the request in time, so the platform timed it out.
`AUDIO_FAILED`	The audio session could not be configured or was taken away, so the call has no audio even though its state says otherwise.
`PUSH_UNAVAILABLE`	VoIP push registration failed, or the platform revoked it.
`DIRECTORY_FAILED`	The caller-identification or blocking data could not be installed.
`TIMEOUT`	The platform never delivered a completion callback within the safety timeout.
`BUSY`	A conflicting operation is already in progress.
`UNKNOWN`	Nothing more specific is known.
`PROVIDER_RESET`	The system’s call provider was reset while the operation was in flight, so it can never be answered.

Methods

`public static` `CallError[] values()`
`public static` `CallError valueOf(String name)`

Inherited methods

From Enum

clone, setEnumValues, getEnumValues, valueOf, equals, hashCode, toString, compareTo, name, ordinal, getDeclaringClass

From Object

getClass, notify, notifyAll, wait, wait, wait

Enum constant details

NOT_SUPPORTED

NOT_SUPPORTED

System call integration is not available on this port, this OS version or this device. Android self-managed calls need API 26; CallKit is absent from tvOS and watchOS. The capability queries – Calls.isSupported() and Calls.getCapabilities() – let cross-platform code branch before ever seeing this code, and the inert fallback bridge fails every operation with it.

UNAUTHORIZED

UNAUTHORIZED

A permission the operation needed is missing.

Emitted in two places, both Android: a SecurityException out of configure or a report, which means MANAGE_OWN_CALLS was never granted, and an incoming report refused because notifications are off or the incoming-call channel sits below high importance – which is two conditions, not one. POST_NOTIFICATIONS not yet granted on API 33+ IS cleared by asking for PERMISSION_NOTIFICATIONS, and is the usual answer on a first call. Notifications switched off, or the channel lowered, is a setting with no prompt behind it, and neither has MANAGE_OWN_CALLS, which is granted at install. See CallAvailability.NOT_PERMITTED for the same three-way split.

A denied microphone grant and a declined call screening role do NOT arrive here: Calls.requestPermissions(int) resolves with the mask it got and CallDirectory.requestScreeningRole resolves false, so read those results rather than waiting for this.

CALL_REFUSED

CALL_REFUSED

The system refused to place or ring this call right now, and may accept the same call later. An emergency call is in progress, another application holds a self-managed call, or the user has switched this app’s calling off. This is the onCreateIncomingConnectionFailed case, and it is not an error in the app.

CALL_FILTERED

CALL_FILTERED

The system suppressed the call before it ever rang: Do Not Disturb on iOS, or a number the user has blocked. The call was not shown and no action will arrive for it.

DUPLICATE_CALL

DUPLICATE_CALL

A call with this identifier is already known to the system. Reporting the same identifier twice is a hard error on iOS rather than a no-op, so the ports collapse a duplicate report into an update and only surface this when the collision cannot be reconciled.

INVALID_ID

INVALID_ID

The supplied call identifier is not a canonical identifier, or names a call the system no longer has. Acting on a call that has already ended reports this rather than failing silently.

ACTION_TIMEOUT

ACTION_TIMEOUT

The system asked the app to act on a call and the app neither fulfilled nor failed the request in time, so the platform timed it out. See CallAction.

AUDIO_FAILED

AUDIO_FAILED

The audio session could not be configured or was taken away, so the call has no audio even though its state says otherwise.

PUSH_UNAVAILABLE

PUSH_UNAVAILABLE

VoIP push registration failed, or the platform revoked it. On iOS this is permanent for the installed app once the deadline has been missed often enough.

DIRECTORY_FAILED

DIRECTORY_FAILED

The caller-identification or blocking data could not be installed. The extension rejected the file, the entries were out of order, or the store exceeded the platform limit.

TIMEOUT

TIMEOUT

The platform never delivered a completion callback within the safety timeout.

BUSY

BUSY

A conflicting operation is already in progress.

UNKNOWN

UNKNOWN

Nothing more specific is known. Ports use this only when the platform itself gave no usable reason.

PROVIDER_RESET

PROVIDER_RESET

The system’s call provider was reset while the operation was in flight, so it can never be answered. See CallActionListener.providerReset().

Last deliberately, and never sent by a port: it is raised by the facade itself. Every other value crosses the SPI as an ordinal, so a new one has to be appended or every port’s error mapping shifts by one.

Method details

values

public static CallError[] values()

valueOf

public static CallError valueOf(String name)