Xử lý lỗi API eUICC

API eUICC cung cấp mã lỗi để giúp ứng dụng và người dùng khắc phục sự cố liên quan đến việc tải xuống, bật, tắt và xóa cấu hình eSIM.

Xử lý lỗi

Khi xảy ra lỗi khi gọi API eUICC, lệnh gọi lại có mục đích đang chờ xử lý sẽ được cung cấp và EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE được sử dụng làm khóa để nhận mã lỗi chi tiết. Bắt đầu từ Android 11, bốn khóa và giá trị sau được đưa vào mục đích tạo ra:

• EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE : Cung cấp thông tin về sự cố. Ví dụ: tải xuống hoặc xóa hồ sơ eSIM. Trường này không bao giờ trống.

• EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE : Thông tin về lý do xảy ra lỗi. Ví dụ: yêu cầu đã hết thời gian chờ hoặc thiết bị bị nhà mạng khóa. Trường này không được điền trong các trường hợp sau:

  • Mã hoạt động là OPERATION_SMDX_SUBJECT_REASON_CODE .
  • Lỗi là lỗi cấp độ thấp như IOException hoặc InterruptedException .

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE : Được sử dụng với EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE , cùng cung cấp Mã chủ đề[5.2.6.1] và Mã lý do[5.2.6.2] từ GSMA (SGP.22 v2.2). Trường này chỉ được điền khi mã thao tác là OPERATION_SMDX_SUBJECT_REASON_CODE .

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE : Được sử dụng với EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE , cùng cung cấp Mã chủ đề[5.2.6.1] và Mã lý do[5.2.6.2] từ GSMA (SGP.22 v2.2). Trường này chỉ được điền khi mã thao tác là OPERATION_SMDX_SUBJECT_REASON_CODE .

Bốn giá trị này cho phép lệnh gọi API eUICC xử lý riêng các lỗi cụ thể. Sau đây là một ví dụ về cách xử lý các lỗi này.

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

Hỗ trợ hoạt động và kết hợp mã lỗi

Bảng sau đây mô tả sự kết hợp hoạt động được hỗ trợ và mã lỗi được trả về từ trợ lý hồ sơ cục bộ (LPA).