جمع بيانات المراقبة

تنفيذ اختياري

جمع بيانات المراقبة اختياري. إذا اعتمدته، فإن استدعاء prepareSelfieCamera فقط هو المتأثر — تبقى جميع الخطوات الأخرى في تدفق الالتقاط (التهيئة، وردود الاستدعاء، ومعالجة النتائج) دون تغيير.

لا تحتاج إلى الكاميرا إطلاقًا؟

تتناول هذه الصفحة setSilentInfo، الذي لا يصبح فعالًا إلا مع استدعاء prepareSelfieCamera/prepareDocumentCamera. إذا كنت تريد التحقق الصامت دون فتح جلسة كاميرا إطلاقًا (مثلاً، شاشة تسجيل الدخول)، استخدم initializeSDK + startSilentValidation بدلاً من ذلك — راجع إعادة التحقق الصامتة. يمكن استخدام الاثنين معًا في نفس الصفحة.

أرفق بيانات المستخدم والتدفق الوصفية بجلسة الالتقاط حتى يمكن ربطها في أدوات المراقبة والرصد على جانب Unico، وحتى يتمكن الخادم الخلفي (backend) من أخذها في الاعتبار ضمن نتيجة إعادة التحقق الصامتة لهذه المعاملة. عند توفيرها، تُرسَل البيانات مع الالتقاط ولا تغيّر سلوك الالتقاط في SDK — لكنها تؤثر على استجابة إنشاء العملية (Create Process): راجع silentAuth.result في إعادة التحقق الصامتة.

setSilentInfo parameters

المعامل	النوع	مطلوب	الوصف
`externalUserId`	`String`	✅	معرّف المستخدم في نظامك. يُجزَّأ تلقائيًا بخوارزمية SHA-256 قبل الإرسال — لا يُرسَل أبدًا كنص عادي.
`useCase`	`String`	—	معرّف التدفق أو السياق الجاري (مثلاً، `"account_opening"`، `"password_recovery"`). يُرسَل كنص عادي.

Implementation

استدعِ setSilentInfo على نسخة الكاميرا المُنشأة قبل استدعاء prepareSelfieCamera. يبقى كل شيء آخر في تدفق الالتقاط كما هو.

import { UnicoCheckBuilder, UnicoConfig, SelfieCameraTypes, SDKEnvironmentTypes } from "@acesso-io/unico-webframe";

const config = new UnicoConfig()
  .setHostname("<YOUR_HOSTNAME>")
  .setHostKey("<YOUR_HOST_KEY>");

const unicoCamera = new UnicoCheckBuilder()
  .setEnvironment(SDKEnvironmentTypes.UAT)
  .build();

unicoCamera.setSilentInfo("external_user_id", "flow_id");

await unicoCamera.prepareSelfieCamera(config, SelfieCameraTypes.SMART);