Обработка ошибок API eUICC

API-интерфейсы eUICC предоставляют коды ошибок, помогающие приложениям и пользователям устранять неполадки, связанные с загрузкой, включением, отключением и удалением профилей eSIM.

Обработка ошибок

Когда при вызове API eUICC возникает ошибка, предоставляется ожидающий обратный вызов намерения, и EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE используется в качестве ключа для получения подробного кода ошибки. Начиная с Android 11, в результирующее намерение включены следующие четыре ключа и значения:

• EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE : Предоставляет информацию о том, что пошло не так. Например, загрузка или удаление профиля eSIM. Это поле никогда не бывает пустым.

• EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE : Информация о причине возникновения ошибки. Например, истекло время ожидания запроса или устройство заблокировано оператором. Это поле не заполняется в следующих случаях:

  • Код операции — OPERATION_SMDX_SUBJECT_REASON_CODE .
  • Ошибка представляет собой ошибку низкого уровня, такую ​​как IOException или InterruptedException .

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE : Используется с EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE , которые вместе предоставляют SubjectCode[5.2.6.1] и ReasonCode[5.2.6.2] из GSMA (SGP.22 v2.2). Это поле заполняется только тогда, когда код операции равен OPERATION_SMDX_SUBJECT_REASON_CODE .

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE : Используется с EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE , которые вместе предоставляют SubjectCode[5.2.6.1] и ReasonCode[5.2.6.2] из GSMA (SGP.22 v2.2). Это поле заполняется только тогда, когда код операции равен OPERATION_SMDX_SUBJECT_REASON_CODE .

Эти четыре значения позволяют вызывающему API eUICC обрабатывать определенные ошибки индивидуально. Ниже приведен пример того, как обрабатывать эти ошибки.

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

Поддерживаемые комбинации операций и кодов ошибок

В следующей таблице описаны поддерживаемые комбинации кодов операций и ошибок, возвращаемых локальным помощником по профилям (LPA).