Obsługa błędów interfejsu eUICC API

Interfejsy eUICC API udostępniają kody błędów, które pomagają aplikacjom i użytkownikom rozwiązywać problemy związane z pobieraniem, włączaniem, wyłączaniem i usuwaniem profili eSIM.

Obsługa błędów

Jeśli podczas wywoływania interfejsu eUICC API wystąpi błąd, przekazane zostanie oczekujące wywołanie zwrotne intencji, a EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE jest używany jako klucz do uzyskania szczegółowego kodu błędu. Od Androida 11 w wynikającym zamiarze są uwzględniane 4 klucze i wartości:

• EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE: zawiera informacje o wystąpieniu błędu. Dotyczy to na przykład pobrania lub usuwania profilu eSIM. To pole nigdy nie jest puste.

• EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE: informacja o przyczynie wystąpienia błędu. Na przykład może to być spowodowane wygaśnięciem żądania lub zablokowaniem urządzenia przez operatora. To pole nie jest wypełniane w tych przypadkach:

  • Kod operacji to: OPERATION_SMDX_SUBJECT_REASON_CODE.
  • Jest to błąd niskiego poziomu, np. IOException lub InterruptedException.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE: używany z EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE, które razem podają kod SubjectCode[5.2.6.1] i ReasonCode[5.2.6.2] z GSMA (SGP.22 v2.2). To pole jest wypełniane tylko wtedy, gdy kod operacji to OPERATION_SMDX_SUBJECT_REASON_CODE.

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE: używany z EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE, które razem podają kod SubjectCode[5.2.6.1] i ReasonCode[5.2.6.2] z GSMA (SGP.22 v2.2). To pole jest wypełniane tylko wtedy, gdy kod operacji to OPERATION_SMDX_SUBJECT_REASON_CODE.

Te 4 wartości pozwalają elementowi wywołującemu interfejs eUICC API na pojedynczą obsługę konkretnych błędów. Poniżej pokazujemy, jak należy postępować w przypadku tych błędów.

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.
}

Obsługiwane kombinacje operacji i kodów błędów

W tabeli poniżej znajdziesz obsługiwaną kombinację operacji i kodów błędów zwracanych przez asystenta profilu lokalnego (LPA).