eUICC API hatalarını işleme

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

eUICC API'leri, uygulamaların ve kullanıcıların eSIM profillerini indirme, etkinleştirme, devre dışı bırakma ve silmeyle ilgili sorunları gidermesine yardımcı olmak için hata kodları sağlar.

Hataları işleme

eUICC API çağrılırken bir hata oluştuğunda bekleyen bir intent geri çağırma işlevi sağlanır ve ayrıntılı hata kodunu almak için EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE anahtarı kullanılır. Android 11'den itibaren, oluşturulan intent'e aşağıdaki dört anahtar ve değer dahil edilir:

• EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE: Neden hata oluştuğu hakkında bilgi sağlar. Örneğin, eSIM profili indirme veya silme. Bu alan hiçbir zaman boş olmaz.

• EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE: Hatanın neden oluştuğuyla ilgili bilgiler. Örneğin, istek zaman aşımına uğradıysa veya cihaz operatör kilitliyse. Aşağıdaki durumlarda bu alan doldurulmaz:

  • İşlem kodu OPERATION_SMDX_SUBJECT_REASON_CODE.
  • Hata, IOException veya InterruptedException gibi düşük düzeyde bir hatadır.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE: EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE ile birlikte kullanılır. Bu iki parametre birlikte GSMA'dan (SGP.22 v2.2) SubjectCode[5.2.6.1] ve ReasonCode[5.2.6.2] değerlerini sağlar. Bu alan yalnızca işlem kodu OPERATION_SMDX_SUBJECT_REASON_CODE olduğunda doldurulur.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE: EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE ile birlikte kullanılır. Bu iki parametre birlikte GSMA'dan (SGP.22 v2.2) SubjectCode[5.2.6.1] ve ReasonCode[5.2.6.2] değerlerini sağlar. Bu alan yalnızca işlem kodu OPERATION_SMDX_SUBJECT_REASON_CODE olduğunda doldurulur.

Bu dört değer, eUICC API'yi çağıran kullanıcının belirli hataları ayrı ayrı ele almasına olanak tanır. Aşağıda, bu hataların nasıl ele alınacağına dair bir örnek verilmiştir.

int operationCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE)
int errorCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE)
String smdxSubjectCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE)
String smdxReasonCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE)

if (operationCode == OPERATION_DOWNLOAD && errorCode == ERROR_CARRIER_LOCKED) {
  // handle specific error i.e. tries to download but the device is carrier locked
} else if (operationCode == OPERATION_SMDX) {
  // handle all SM-DP+/SM-DS errors
} else if (errorCode == ERROR_TIME_OUT) {
  // handle all types of time out issues, regardless of operation.
} else if ("8.1".equals(smdxSubjectCode) && "3.1".equals(smdxReasonCode)) {
  // handle specific subject code and reason code: 8.1 and 4.1 means insufficient memory.
}

Desteklenen işlem ve hata kodu kombinasyonları

Aşağıdaki tabloda, yerel profil asistanı (LPA) tarafından döndürülen işlem ve hata kodlarının desteklenen kombinasyonu açıklanmaktadır.