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

يعيد SDK نتيجة الالتقاط عبر كائن callback المُمرَّر إلى open(). كلا المعالجَين success وerror إلزاميان.

التقاط السيلفي

success (السيلفي)

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

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

const callback = {
  on: {
    success: (obj) => {
      const base64 = obj.base64;
      const encrypted = obj.encrypted; // JWT to send to your backend
    },
    error: (error) => {
      console.error(error);
    }
  }
};

استخدام encrypted

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

error (السيلفي)

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

error: (error) => {
  const code = error.getCode();
  const description = error.getDescription();
}

التقاط المستندات

success (المستند)

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

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

const callback = {
  on: {
    success: (obj) => {
      const base64 = obj.base64;
      const encrypted = obj.encrypted;
    },
    error: (error) => { /* ... */ }
  }
};

error (المستند)

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