EuiccManager Class

Definition

EuiccManager is the application interface to eUICCs, or eSIMs/embedded SIMs.

[Android.Runtime.Register("android/telephony/euicc/EuiccManager", ApiSince=28, DoNotGenerateAcw=true)]
public class EuiccManager : Java.Lang.Object
[<Android.Runtime.Register("android/telephony/euicc/EuiccManager", ApiSince=28, DoNotGenerateAcw=true)>]
type EuiccManager = class
    inherit Object
Inheritance
EuiccManager
Attributes

Remarks

EuiccManager is the application interface to eUICCs, or eSIMs/embedded SIMs.

You do not instantiate this class directly; instead, you retrieve an instance through Context#getSystemService(String) and Context#EUICC_SERVICE. This instance will be created using the default eUICC.

On a device with multiple eUICCs, you may want to create multiple EuiccManagers. To do this you can call #createForCardId.

See #isEnabled before attempting to use these APIs.

Java documentation for android.telephony.euicc.EuiccManager.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Constructors

EuiccManager(IntPtr, JniHandleOwnership)

Fields

ActionManageEmbeddedSubscriptions

Intent action to launch the embedded SIM (eUICC) management settings screen.

ActionNotifyCarrierSetupIncomplete

Broadcast Action: The action sent to carrier app so it knows the carrier setup is not completed.

ActionStartEuiccActivation

Intent action sent by a carrier app to launch the eSIM activation flow provided by the LPA UI (LUI).

EmbeddedSubscriptionResultError

Result code for an operation indicating that an unresolvable error occurred.

EmbeddedSubscriptionResultOk

Result code for an operation indicating that the operation succeeded.

EmbeddedSubscriptionResultResolvableError

Result code for an operation indicating that the user must take some action before the operation can continue.

ErrorAddressMissing
Obsolete.

Address is missing e.

ErrorCarrierLocked
Obsolete.

Operation such as downloading/switching to another profile failed due to device being carrier locked.

ErrorCertificateError
Obsolete.

Certificate needed for authentication is not valid or missing.

ErrorConnectionError
Obsolete.

Failure to create a connection.

ErrorDisallowedByPpr
Obsolete.

Failed to load profile onto eUICC due to Profile Policy Rules.

ErrorEuiccInsufficientMemory
Obsolete.

There is no more space available on the eUICC for new profiles.

ErrorEuiccMissing
Obsolete.

eUICC is missing or defective on the device.

ErrorIncompatibleCarrier
Obsolete.

The profile's carrier is incompatible with the LPA.

ErrorInstallProfile
Obsolete.

Failure to load the profile onto the eUICC card.

ErrorInvalidActivationCode
Obsolete.

The activation code(SGP.

ErrorInvalidConfirmationCode
Obsolete.

The confirmation code(SGP.

ErrorInvalidPort
Obsolete.

Failure due to target port is not supported.

ErrorInvalidResponse
Obsolete.

Response format is invalid.

ErrorNoProfilesAvailable
Obsolete.

No profiles available.

ErrorOperationBusy
Obsolete.

The operation is currently busy, try again later.

ErrorSimMissing
Obsolete.

No SIM card is available in the device.

ErrorTimeOut
Obsolete.

Timed out while waiting for an operation to complete.

ErrorUnsupportedVersion
Obsolete.

The eUICC card(hardware) version is incompatible with the software

ExtraEmbeddedSubscriptionDetailedCode

Key for an extra set on PendingIntent result callbacks providing a detailed result code.

ExtraEmbeddedSubscriptionDownloadableSubscription

Key for an extra set on #getDownloadableSubscriptionMetadata PendingIntent result callbacks providing the downloadable subscription metadata.

ExtraEmbeddedSubscriptionErrorCode

Key for an extra set on PendingIntent result callbacks providing a ErrorCode of #EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE, value will be an int.

ExtraEmbeddedSubscriptionOperationCode

Key for an extra set on PendingIntent result callbacks providing a OperationCode of #EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE, value will be an int.

ExtraEmbeddedSubscriptionSmdxReasonCode

Key for an extra set on PendingIntent result callbacks providing a ReasonCode[5.

ExtraEmbeddedSubscriptionSmdxSubjectCode

Key for an extra set on PendingIntent result callbacks providing a SubjectCode[5.

ExtraUseQrScanner

Key for an extra set on actions #ACTION_START_EUICC_ACTIVATION providing a boolean value of whether to start eSIM activation with QR scanner.

MetaDataCarrierIcon

Optional meta-data attribute for a carrier app providing an icon to use to represent the carrier.

OperationApdu
Obsolete.

The exception of failing to execute an APDU command.

OperationDownload
Obsolete.

Download profile error.

OperationEuiccCard
Obsolete.

eUICC card error.

OperationEuiccGsma
Obsolete.

eUICC returned an error defined in GSMA (SGP.

OperationHttp
Obsolete.

HTTP error

OperationMetadata
Obsolete.

Subscription's metadata error

OperationSimSlot
Obsolete.

SIM slot error.

OperationSmdx
Obsolete.

SMDX(SMDP/SMDS) error

OperationSmdxSubjectReasonCode
Obsolete.

SubjectCode[5.

OperationSwitch
Obsolete.

Generic switching profile error

OperationSystem
Obsolete.

Internal system error.

Properties

Class

Returns the runtime class of this Object.

(Inherited from Object)
Eid

Returns the EID identifying the eUICC hardware.

EuiccInfo

Returns information about the eUICC chip/device.

Handle

The handle to the underlying Android instance.

(Inherited from Object)
IsEnabled

Whether embedded subscriptions are currently enabled.

JniIdentityHashCode (Inherited from Object)
JniPeerMembers
PeerReference (Inherited from Object)
ThresholdClass
ThresholdType

Methods

Clone()

Creates and returns a copy of this object.

(Inherited from Object)
CreateForCardId(Int32)

Create a new EuiccManager object pinned to the given card ID.

DeleteSubscription(Int32, PendingIntent)

Deletes the given subscription.

Dispose() (Inherited from Object)
Dispose(Boolean) (Inherited from Object)
DownloadSubscription(DownloadableSubscription, Boolean, PendingIntent)

Attempt to download the given DownloadableSubscription.

Equals(Object)

Indicates whether some other object is "equal to" this one.

(Inherited from Object)
GetHashCode()

Returns a hash code value for the object.

(Inherited from Object)
IsSimPortAvailable(Int32)

Returns whether the passing portIndex is available.

JavaFinalize()

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.

(Inherited from Object)
Notify()

Wakes up a single thread that is waiting on this object's monitor.

(Inherited from Object)
NotifyAll()

Wakes up all threads that are waiting on this object's monitor.

(Inherited from Object)
SetHandle(IntPtr, JniHandleOwnership)

Sets the Handle property.

(Inherited from Object)
StartResolutionActivity(Activity, Int32, Intent, PendingIntent)

Start an activity to resolve a user-resolvable error.

SwitchToSubscription(Int32, Int32, PendingIntent)

Switch to (enable) the given subscription.

SwitchToSubscription(Int32, PendingIntent)

Switch to (enable) the given subscription.

ToArray<T>() (Inherited from Object)
ToString()

Returns a string representation of the object.

(Inherited from Object)
UnregisterFromRuntime() (Inherited from Object)
UpdateSubscriptionNickname(Int32, String, PendingIntent)

Update the nickname for the given subscription.

Wait()

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>.

(Inherited from Object)
Wait(Int64)

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed.

(Inherited from Object)
Wait(Int64, Int32)

Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed.

(Inherited from Object)

Explicit Interface Implementations

IJavaPeerable.Disposed() (Inherited from Object)
IJavaPeerable.DisposeUnlessReferenced() (Inherited from Object)
IJavaPeerable.Finalized() (Inherited from Object)
IJavaPeerable.JniManagedPeerState (Inherited from Object)
IJavaPeerable.SetJniIdentityHashCode(Int32) (Inherited from Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) (Inherited from Object)
IJavaPeerable.SetPeerReference(JniObjectReference) (Inherited from Object)

Extension Methods

JavaCast<TResult>(IJavaObject)

Performs an Android runtime-checked type conversion.

JavaCast<TResult>(IJavaObject)
GetJniTypeName(IJavaPeerable)

Applies to