uz.tadi.gsi 1.0.2

uz.tadi.gsi — GSI Biometric Identity SDK for .NET MAUI

A .NET MAUI binding library for the GSI biometric identity verification SDK, supporting both Android and iOS.

Requirements

Installation

dotnet add package uz.tadi.gsi

Or in your .csproj:

<PackageReference Include="uz.tadi.gsi" Version="1.0.0" />

Quick Start

1. Create a config

using GsiMauiBinding;
using GsiMauiBinding.Models;

var config = new GsiSdkConfig
{
    Token   = "your-access-token",
    BaseUrl = "https://your-gsi-api.example.com",
    Locale  = "en",  // "en", "uz", or "ru"
};

2. Start face detection

IGsiSdk sdk = new GsiSdkService();

sdk.Start(
    config,
    onSuccess: person =>
    {
        Console.WriteLine($"Name: {person.FirstName} {person.LastName}");
        Console.WriteLine($"PIN:  {person.Pin}");
        Console.WriteLine($"Score: {person.Score}");
    },
    onError: error =>
    {
        Console.WriteLine($"Error: {error}");
    }
);

Android — additional setup

Register the ActivityResultLauncher in your MainActivity before calling Start:

// In MainActivity.cs
var launcher = RegisterForActivityResult(
    new ActivityResultContracts.StartActivityForResult(),
    result => sdk.HandleActivityResult(result.Data)
);

sdk.RegisterLauncher(launcher);

Add permissions to AndroidManifest.xml:

<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.INTERNET" />

Configuration Reference

Result Model

A successful scan returns a GsiPerson object:

public class GsiPerson
{
    public int    Id            { get; set; }
    public string FirstName     { get; set; }
    public string LastName      { get; set; }
    public string Patronym      { get; set; }
    public string Pin           { get; set; }
    public string DocPinfl      { get; set; }
    public string DocSeria      { get; set; }
    public string DocNumber     { get; set; }
    public string BirthDate     { get; set; }
    public string Photo         { get; set; } // Base64 image
    public double Score         { get; set; } // Face match confidence
    public string TransactionId { get; set; }
    public string Citizenship   { get; set; }
    public string Nationality   { get; set; }
    public string BirthPlace    { get; set; }
    public string Capture       { get; set; }
    public string Signature     { get; set; }
}

SSL / Mutual TLS

var config = new GsiSdkConfig
{
    Token   = "your-token",
    BaseUrl = "https://your-api.example.com",
    EnableMutualSsl           = true,
    ClientCertificateBase64   = "BASE64_P12_CERTIFICATE",
    ClientCertificatePassword = "certificate-password",
};

UI Customization

var config = new GsiSdkConfig
{
    Token           = "your-token",
    BaseUrl         = "https://your-api.example.com",
    PrimaryColorHex = "#E4A216",
    CameraShape     = "circle",
    Locale          = "uz",
};

Platform Notes

• Android: Uses FaceDetectionSdk (AAR) with Camera, Internet, and Wake Lock permissions.
• iOS: Uses TGFISBIN.xcframework (pure Swift) via GsiSwiftBridge.xcframework (ObjC bridge). Requires iOS 13+.

License

Proprietary — © uz.tadi. All rights reserved.