बायोमेट्रिक्स

Biometry के साथ पोर्टेबल तरीके से फ़िंगरप्रिंट/चेहरे द्वारा प्रमाणीकरण। परिणाम कॉलबैक के ज़रिए एसिंक्रोनस आता है — इसे onUI(...) के साथ UI पर भेजें।

उपयोग

if (!Biometry.isAvailable()) {
   loginPorSenha();               // जब बायोमेट्रिक्स न हो तो fallback
   return;
}
Biometry.authenticate(
   "Confirme sua identidade",     // reason (उपयोगकर्ता को दिखाया गया)
   "Cancelar",                    // रद्द करें बटन का टेक्स्ट
   false,                         // onlyBiometric: false = fallback के रूप में सिस्टम PIN की अनुमति देता है
   (resultado, mensagem) -> Component.onUI(() -> {
      switch (resultado) {
         case SUCCESS:   abrirAreaSegura(); break;
         case FAILURE:   Hint.show("Não reconhecido", 2000); break;
         case CANCELLED: /* उपयोगकर्ता ने छोड़ दिया */ break;
         case ERROR:     Hint.show("Erro: " + mensagem, 2000); loginPorSenha(); break;
      }
   })
);

API

सदस्य	हस्ताक्षर
`Biometry.isAvailable()`	`static boolean` — क्या हार्डवेयर/पंजीकृत बायोमेट्रिक्स है?
`Biometry.authenticate(...)`	`static void (String reason, String cancel, boolean onlyBiometric, Callback)`
`Callback.onResult(...)`	`(AuthResult result, String message)`
`AuthResult`	`SUCCESS` · `FAILURE` · `CANCELLED` · `ERROR`

onlyBiometric = true बायोमेट्रिक्स की माँग करता है (सिस्टम के PIN/पासवर्ड पर नहीं गिरता); false OS के फ़ॉलबैक की अनुमति देता है।

सुरक्षा

बायोमेट्रिक डेटा कभी डिवाइस से बाहर नहीं जाता — ऐप को केवल SUCCESS/FAILURE/आदि मिलता है, कभी भी फ़िंगरप्रिंट/चेहरा स्वयं नहीं।
हमेशा एक एप्लिकेशन फ़ॉलबैक प्रदान करें (लॉगिन/पासवर्ड) ERROR के लिए और तब के लिए जब isAvailable() false हो।

आम गलतियाँ

सिर्फ़ SUCCESS संभालना और CANCELLED/ERROR नज़रअंदाज़ करना (उपयोगकर्ता फँस जाता है)।
कॉलबैक में सीधे UI छूना — यह पेंट थ्रेड के बाहर आता है; onUI(...) उपयोग करें।
बायोमेट्रिक्स न होने पर कोई वैकल्पिक रास्ता न रखना।

यह भी देखें

ध्वनि और डिवाइस उपयोगिताएँ · प्लेटफ़ॉर्म अनुसार अनुमतियाँ