استقبال النتيجة

تُعيد SDK نتيجة الالتقاط من خلال استدعاءات محددة في واجهة المستمع المستخدمة أثناء جلسة الالتقاط.

UnicoSelfie

onSuccessSelfie

يُستدعى عند التقاط الصورة بنجاح. يُعيد كائن ResultCamera يتضمن:

• base64 — الصورة الملتقطة؛ يمكن استخدامها لعرض معاينة في تطبيقك.
• encrypted — حمولة JWT يجب إرسالها إلى backend الخاص بك لإتمام التحقق البيومتري عبر واجهة برمجة التطبيقات REST.

@override
void onSuccessSelfie(ResultCamera result) {
  final base64 = result.base64;
  final encrypted = result.encrypted; // JWT to send to your backend
}

استخدام encrypted

• السمة encrypted مخصصة حصراً لإرسال الصورة عبر واجهات برمجة التطبيقات الخاصة بالعميل. يجب عدم فتحها أو تسلسلها — قد تتغير خصائصها دون إشعار مسبق. لا تتحمل Unico أي مسؤولية عن الأضرار الناجمة عن التعامل غير السليم معها.
• قد تتفاوت أحجام ملفات base64/encrypted تبعاً لجودة الجهاز وحجم الصورة المنشأة وقواعد عمل Unico. لا تضع حداً لحجم السلسلة التي يولِّدها SDK في منطق البرمجة أو البنية التحتية الخاصة بك.

تحويل Base64 إلى bitmap (Android)

إذا كنت بحاجة إلى تحويل base64 إلى bitmap، فإن الأسلوب القياسي لا يعمل مباشرة على Android — قسِّم السلسلة عند الفاصلة (,) أولاً. راجع كيفية تحويل سلسلة Base64 إلى صورة bitmap لعرضها في ImageView؟.

onErrorSelfie

يُستدعى عند حدوث خطأ أثناء الالتقاط. يُعيد كائن UnicoError مع getCode() وgetDescription(). راجع معالجة الأخطاء للاطلاع على القائمة الكاملة لرموز الأخطاء.

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

UnicoDocument

onSuccessDocument

يُستدعى عند التقاط صورة المستند بنجاح. يُعيد كائن ResultCamera يتضمن:

• base64 — الصورة الملتقطة؛ يمكن استخدامها لعرض معاينة.
• encrypted — حمولة JWT يجب إرسالها إلى backend الخاص بك خلال 10 دقائق ويجب عدم تعديلها أو إلغاء تسلسلها.

@override
void onSuccessDocument(ResultCamera result) {
  final base64 = result.base64;
  final encrypted = result.encrypted; // JWT to send to your backend
}

onErrorDocument

يُستدعى عند حدوث خطأ أثناء التقاط المستند. يُعيد كائن UnicoError. راجع معالجة الأخطاء للاطلاع على القائمة الكاملة لرموز الأخطاء.

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