Error handling

Flutter SDK के लिए सभी error handling इस section में केंद्रित है। onErrorUnico, onErrorSelfie, और onErrorDocument callbacks एक UnicoError object प्राप्त करते हैं जो getCode() और getDescription() expose करता है।

Error codes

Code	विवरण
73001	Context invalid
73002	कैमरा खोलने की अनुमति नहीं दी
73003	न्यूनतम API स्तर 21 (LOLLIPOP) है
73004	Implementation interface callback iAcessoBioSelfie नहीं मिला
73005	Implementation interface callback iAcessoBioDocument नहीं मिला
73006	Emulators पर कैमरा खोलने में असमर्थ
73100	Internet से connect होने में असमर्थ
73200	कृपया JSON फ़ाइल का नाम बताएं
73202	JSON फ़ाइल parse करने में असमर्थ
73300	Unico authentication object प्राप्त करने में असमर्थ
73301	Object parse करने में असमर्थ
73302	Unico token नहीं मिला
73303	वर्तमान host पंजीकृत नहीं है
73400	कैमरा initialize करने में असमर्थ
73500	Session token प्राप्त करने में असमर्थ — service response error
73501	Object parse करने में असमर्थ
73502	Session token नहीं मिल सका
73701	Active liveness import नहीं मिला
73702	Production mode में active liveness initialize करने में असमर्थ
73703	Active liveness session प्राप्त करने में असमर्थ
73704	उपयोगकर्ता ने cancel बटन दबाया और session पूरा नहीं किया
73705	Session सफलतापूर्वक नहीं हुआ और FaceScan generate नहीं हुआ
73706	Camera access denied — उपयोगकर्ता ने स्पष्ट रूप से अनुमति अस्वीकार की या device policy इसे block करती है
73707	App बंद होने, सोने, OS notification, या background में जाने के कारण session रद्द किया गया
73708	Device landscape mode में होने के कारण session रद्द किया गया
73709	Device reverse portrait mode में होने के कारण session रद्द किया गया
73710	उपयोगकर्ता allotted timeout के भीतर session पूरा करने में असमर्थ होने के कारण रद्द किया गया
73712	Memory pressure / app production में नहीं है, network आवश्यक है के कारण session रद्द किया गया
73713	आपकी key को फिर से validate करने की आवश्यकता है के कारण session रद्द किया गया
73714	Developer-configured encryption key valid नहीं थी के कारण session रद्द किया गया
73715	सभी guidance images configure नहीं होने के कारण session रद्द किया गया
73716	SDK इस device पर कैमरा शुरू करने में असमर्थ होने के कारण session रद्द किया गया
73717	उपयोगकर्ता locked-out state में होने के कारण session रद्द किया गया
73718	Native APIs के सामान्य उपयोग के दौरान अज्ञात और अप्रत्याशित त्रुटि
73719	उपयोगकर्ता ने Get Ready screen subtext message दबाने के कारण session रद्द किया गया
73800	Encrypted key बनाने में असमर्थ

आधिकारिक error catalog

ऊपर के codes Flutter SDK catalog को reflect करते हैं। आधिकारिक cross-platform error code catalog API Reference > Error codes पर उपलब्ध है।

Callback को संभालना

@override
void onErrorUnico(UnicoError error) {
  final code = error.getCode();
  final description = error.getDescription();
  // handle error
}

Lifecycle callbacks

onErrorUnico के अलावा, SDK ये भी trigger करता है:

• onUserClosedCameraManually() — उपयोगकर्ता ने मैन्युअल रूप से कैमरा बंद किया।
• onSystemClosedCameraTimeoutSession() — timeout के कारण session समाप्त (डिफ़ॉल्ट 40 सेकंड, न्यूनतम 40 सेकंड)।
• onSystemChangedTypeCameraTimeoutFaceInference() — face detection 13 सेकंड की सीमा से अधिक हो गई; capture manual mode में बदल जाता है।