Ejemplos de uso

Aquí encontrarás ejemplos prácticos para integrar y utilizar el plugin oficial de Facephi en tus aplicaciones Flutter, compatibles con iOS y Android.

Las aplicaciones de ejemplo se pueden encontrar en el repositorio de GitHub:

GitHub - facephi/sdk-mobile-flutter-samplesGitHub

Ejemplo 1: Core - initSession

Future<Either<Exception, CoreResult>> initSession() async
{
  try
  {
    final Map m = await FphiSdkmobileCore().initSession(widgetConfigurationJSON: CoreConfigurationInitSession(
        //mLicense: (Platform.isAndroid) ? licenseAndroid : licenseIOS,
        mLicenseUrl: licenseUrl,
        mLicenseApiKey: (Platform.isAndroid) ? licenseApiKeyAndroid : licenseApiKeyIOS,
        mEnableTracking: true
    ));
    return Right(CoreResult.fromMap(m));
  } on Exception catch (e) {
    return (Left(e));
  }
}

Notas importantes:

• El parámetro mLicenseUrl lo .

• El parámetro mLicenseApiKey se obtiene desde el Portal de Administración.

---

Ejemplo 2: Core - initOperation

Puedes lanzar un proceso de verificación desde cualquier widget:

Future<Either<Exception, CoreResult>> initOperation() async
{
  try
  {
    final Map m = await FphiSdkmobileCore().initOperation(
      widgetConfigurationJSON: TrackingConfiguration(
        mCustomerId: customerId, 
        mType: TrackingOperationType.ONBOARDING
      ),
    );
    return Right(CoreResult.fromMap(m));
  } on Exception catch (e) {
    return (Left(e));
  }
}

Parámetros:

Parámetro	Descripción	Obligatorio
mType	Tipo de operacion (ej. "ONBOARDING", "AUTHENTICATION", etc.)	✅ Sí
mCustomerId	Identificador unívoco del cliente.	✅ Sí

---

Ejemplo 3: Selphi - launchSelphiAuthenticate

Puedes personalizar el flujo de verificación activando opciones avanzadas:

Future<Either<Exception, SelphiFaceResult>> launchSelphiAuthenticate(SelphiFaceConfiguration config) async
{
  try
  {
    final Map resultJson = await FphiSdkmobileSelphi().startSelphiFaceWidget(
        resourcesPath: resourcesPath, 
        widgetConfigurationJSON: createStandardConfiguration()
    );
    return Right(SelphiFaceResult.fromMap(resultJson));
  }
  on Exception catch (e) {
    return (Left(e));
  }
}

/// Sample of standard plugin configuration
SelphiFaceConfiguration createStandardConfiguration()
{
  SelphiFaceConfiguration cfg   = SelphiFaceConfiguration();
  cfg.livenessMode              = SelphiFaceLivenessMode.LM_PASSIVE; // Liveness mode
  cfg.fullscreen                = true;
  cfg.logImages                 = false;
  cfg.jpgQuality                = 0.95;
  cfg.enableGenerateTemplateRaw = true;
  cfg.showTutorial              = false;
  cfg.showPreviousTip           = false;
  cfg.compressFormat            = SelphiCompressFormat.T_JPEG;
  cfg.debug                     = false;
  cfg.logImages                 = false;
  return cfg;
}

Opciones adicionales:

Parámetro	Descripción	Valor por defecto
resourcesPath	Ruta con el zip de recursos personalizado del cliente.	fphi-selphi-widget-resources-sdk.zip
widgetConfigurationJSON	Objeto SelphiFaceConfiguration que contiene la configuración del plugin	SelphiFaceConfiguration()

Ejemplo 4: Selphid - launchSelphIDCapture

Puedes personalizar el flujo de verificación activando opciones avanzadas:

Future<Either<Exception, SelphIDResult>> launchSelphIDCapture(SelphIDConfiguration config) async {
  try
  {
    final Map resultJson = await FphiSdkmobileSelphid().startSelphIDWidget(
        resourcesPath: resourcesPathSelphid, 
        widgetConfigurationJSON: createStandardConfiguration()
    );
    return Right(SelphIDResult.fromMap(resultJson));
  }
  on Exception catch (e) {
    return (Left(e));
  }
}

/// Sample of standard plugin configuration 
SelphIDConfiguration createStandardConfiguration() {
  SelphIDConfiguration configurationWidget    = SelphIDConfiguration();
  configurationWidget.documentType            = SelphIDDocumentType.DT_IDCARD; // IDCard, Passport, DriverLic or ForeignCard
  configurationWidget.timeout                 = SelphIDTimeout.T_SHORT;
  configurationWidget.scanMode                = SelphIDScanMode.CAP_MODE_SEARCH;
  configurationWidget.specificData            = 'AR|<ALL>';
  configurationWidget.fullscreen              = true;
  configurationWidget.showDiagnostic          = false;
  configurationWidget.wizardMode              = true;
  configurationWidget.showPreviousTip         = true;
  configurationWidget.showResultAfterCapture  = true;
  configurationWidget.showTutorial            = true;
  configurationWidget.debug                   = false;
  return configurationWidget;
}

Opciones adicionales:

Parámetro	Descripción	Valor por defecto
resourcesPath	Ruta con el zip de recursos personalizado del cliente.	fphi-selphid-widget-resources-sdk.zip
widgetConfigurationJSON	Objeto SelphIDConfiguration que contiene la configuración del plugin	SelphIDConfiguration()

---

Recomendaciones clave

• Realiza siempre las pruebas iniciales en entorno sandbox.

• Asegúrate de que los permisos de cámara e internet estén configurados en cada plataforma.

• Valida los resultados en backend, no solo en cliente.

• Consulta el Changelog tras cada actualización.

Para dudas adicionales, contacta con el Soporte Técnico.