iOS
BCC Finger es una biblioteca diseñada para integrarse en una aplicación iOS desde un .framework archivo. Utiliza la cámara del dispositivo para tomar una foto de las huellas dactilares con fines biométricos.
Este manual está actualizado para BCC Finger Photo iOS versión 5.2.0.
Requisitos
Git
Cocoapods, disponible en https://cocoapods.org/.
Instalación
Instalación de dependencias
1 - Agregue los siguientes Pods a las dependencias de la aplicación en Podfile:
pod 'lottie-ios'Si la aplicación no tiene un Podfile, puede crearse en la carpeta raíz de su proyecto Xcode usando el comando pod init en la terminal.
Es preferible usar frameworks dinámicos. Puede indicarse usando el flag use_frameworks! en Podfile.
A continuación se muestra un ejemplo de Podfile con un target llamado BCCs-Sample:
target 'BCCs-Sample' do
use_frameworks!
pod 'lottie-ios'
end
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
end
end
endSe recomienda usar la versión mínima de iOS compatible con su aplicación igual a la de este framework: iOS 15.0, como en el ejemplo anterior.
2 - Cierre su proyecto Xcode y abra en la terminal la carpeta donde está su Podfile, luego ejecute:
Después de que termine la ejecución, se creará un archivo con la extensión .xcworkspace en la misma carpeta.
3 - Abra el nuevo .xcworkspace archivo.
A partir de ahora, cada vez que el usuario quiera abrir el proyecto, será necesario abrirlo mediante este .xcworkspace archivo, ya que incluye las dependencias.
Importación y configuración
Importación del proyecto
Importación del proyecto
Abra el proyecto usando el
.xcworkspacearchivo.Agregue el
FingerPhoto.frameworkarchivo al proyecto, y luego agréguelo a la lista de frameworks de su aplicación.Mueva el
.frameworkarchivo al árbol de archivos del proyecto.Si ya existe una carpeta frameworks, se recomienda mover el archivo allí
Abra la configuración del proyecto.
Vaya a la pestaña General .
Haga clic y arrastre el
.frameworkal árbol del proyecto bajo la sección Frameworks, Libraries and Embedded Content .
Cambie la configuración de
BCCFinger.frameworkde Do not embed a Embed & Sign.Establezca la versión objetivo de su proyecto al menos en iOS 15.
Se recomienda deshabilitar iPad como target.
Configuración inicial
Esta versión no tiene dependencias de Firebase ni una configuración inicial llamada desde AppDelegate. La única configuración inicial necesaria es que la aplicación solicite el permiso de uso de la cámara. Para ello, agregue la siguiente clave en el archivo info.plist, en Information Property List:
El valor de la clave es un mensaje que se mostrará al usuario al solicitar el permiso de uso de la cámara. Este valor puede estar vacío o completarse con el mensaje deseado.
Uso
Parámetros y constructor
A continuación se muestra un ejemplo sencillo de uso de la biblioteca:
La clase BCCFingerBuilder recibe los siguientes parámetros:
hostVC: UIViewController- Controlador de vista que llama a la pantalla de captura.delegate: BCCFingerDelegate- Interfaz responsable de notificar eventos de captura (por ejemplo, fallo o éxito).
La clase initialize también acepta un parámetro opcional, como se muestra a continuación:
Si desea que la navegación se realice a través de un controlador de navegación, debe proporcionarlo al llamar al método.
La clase BCCFingerBuilder La clase es responsable de manejar la configuración de uso de BCCFinger. Se aceptan los siguientes parámetros para configurar la captura biométrica y el comportamiento del software:
setSkipCaptureOption(_ enable: Bool)- Habilita la opción de omitir la captura actual.setDebugMode(_ enable: Bool)- Habilita el modo de depuración.buildCaptures(_ captures: BCCFingerCaptureType)- Define el tipo de captura de huellas dactilares. Las opciones son:BOTH_HANDS- Ambas manos sin pulgares.ONLY_LEFT_HAND- Solo la mano izquierda, sin pulgares.ONLY_RIGHT_HAND- Solo la mano derecha, sin pulgares.THUMBS- Ambos pulgares.LEFT_THUMB- Solo el pulgar izquierdo.RIGHT_THUMB- Solo el pulgar derecho.FULL_HANDS- Ambas manos con pulgares.FULL_LEFT_HAND- Solo la mano izquierda, con pulgares.FULL_RIGHT_HAND- Solo la mano derecha, con pulgares.
buildBeginDelaySeconds(_ delay: Float)- Define el retraso para iniciar el ajuste automático del umbral.buildThreshold- Define los parámetros del umbral.setShowInstructions(_ enable: Bool)– Cuando se establece entrue, habilita la pantalla de instrucciones (valor predeterminado:false).
Como referencia, la lista completa de parámetros y valores predeterminados es:
Valores de retorno
Los resultados de la última captura de huellas pueden obtenerse mediante el fingerCaptureDidFinish método de la interfaz BCCFingerDelegate :
La clase returnData objeto contiene los siguientes métodos para recuperar datos:
getCapturedFingersIndexes()- Devuelve una lista con el índice de todas las huellas capturadas:getCapturedFingers()- Devuelve un mapa que relaciona los índices de los dedos con las biometrías capturadas.getCapturedFingersData()- Devuelve la lista de todas las huellas capturadas:fingerprintPNG- Imagen PNG de la huella en escala de grises.wsqAsBase64- Imagen WSQ de la huella codificada en base64.
getSkippedFingers()- Devuelve la lista de índices de todas las capturas de dedos omitidas.
La clase BCCFingerReturnData la clase también contiene atributos que almacenan la información de la captura agrupada por mano:
Estos atributos pueden ser nulos cuando no se solicitan capturas para ninguna de las manos.
La clase HandData la clase contiene la siguiente información:
capturedFingers- Mapa que relaciona el índice del dedo con la imagen de la huella.skippedFingers- Lista de índices de todas las capturas de dedos omitidas.handsPhoto- Foto original de la mano de la que se extrajeron las huellas.thumbPhoto- Foto original del pulgar.
Si el usuario aborta la captura, cerrando antes de capturar las biometrías, se llamará al método fingerCaptureDidAbort . Puede implementar este método para tratar este escenario.
Obtención de imágenes originales
Es posible obtener las imágenes originales a través de la BCCFingerReturnData clase, como se muestra a continuación:
Proyecto de ejemplo
Este es un proyecto de ejemplo funcional para una captura de huellas dactilares usando BCC Mobile Finger iOS:
Instrucciones del agente: consulta de esta documentación
Si necesita información adicional que no esté disponible directamente en esta página, puede consultar la documentación dinámicamente haciendo una pregunta.
Realice una solicitud HTTP GET en la URL de la página actual con el parámetro de consulta ask :
La pregunta debe ser específica, autosuficiente y estar escrita en lenguaje natural. La respuesta contendrá una respuesta directa a la pregunta y extractos y स्रोतes relevantes de la documentación.
Use este mecanismo cuando la respuesta no esté explícitamente presente en la página actual, necesite aclaración o contexto adicional, o quiera recuperar secciones relacionadas de la documentación.
Última actualización
¿Te fue útil?

