จัดการข้อผิดพลาดของ eUICC API

API ของ eUICC จะแสดงรหัสข้อผิดพลาดเพื่อช่วยแอปและผู้ใช้ในการแก้ปัญหาที่เกี่ยวข้องกับการ ดาวน์โหลด การเปิดใช้ การปิดใช้ และการลบโปรไฟล์ eSIM

จัดการข้อผิดพลาด

เมื่อเกิดข้อผิดพลาดขณะเรียกใช้ eUICC API ระบบจะแสดงการเรียกกลับของ Intent รอดำเนินการ และ EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE ใช้เป็นคีย์สำหรับรับรหัสข้อผิดพลาดโดยละเอียด ตั้งแต่ Android 11 เป็นต้นไป ระบบจะรวมคีย์และค่า 4 รายการต่อไปนี้ไว้ใน Intent ที่ได้

• 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

ค่าทั้ง 4 นี้ช่วยให้ผู้เรียกใช้ eUICC API จัดการข้อผิดพลาดที่เฉพาะเจาะจงได้ทีละรายการ ตัวอย่างวิธีจัดการข้อผิดพลาดเหล่านี้

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)