GsiMaui 1.0.0

GsiMaui

A .NET MAUI library for integrating face detection and document verification capabilities via the GSI (Government Services Integration) SDK on Android and iOS.

Overview

GsiMaui wraps native platform SDKs to provide a unified cross-platform API for:

• Face Detection — capture and analyze facial features
• Document Verification — recognize and validate government IDs and travel documents
• Personal Data Extraction — extract biographical and biometric information (name, PINFL, citizenship, photo, etc.)
• Multi-language Support — Uzbek, English, and Russian

Project Structure

GsiMaui.sln
├── GsiMaui/                    # Shared .NET MAUI library
│   ├── IGsiFaceDetectSdk.cs    # Core interface
│   ├── GsiSdkConfig.cs         # Configuration (SSL, UI, SDK)
│   ├── GsiSdkResult.cs         # Result data models
│   ├── GsiSdkLocale.cs         # Enums (locale, camera shape, styles)
│   └── Platforms/
│       ├── Android/             # Android implementation
│       └── iOS/                 # iOS implementation
├── GsiMaui.Android/            # Android binding library (AAR + NuGet deps)
├── GsiMaui.iOS/                # iOS binding library (xcframework)
└── NativeBridge/               # Swift-to-ObjC bridge for iOS interop

Requirements

• .NET 9.0
• Android API 21+ (Android 5.0)
• iOS 13.0+

Installation

Add project references to your MAUI application:

<ProjectReference Include="..\GsiMaui\GsiMaui.csproj" />

Usage

1. Configure the SDK

var config = new GsiSdkConfig
{
    AccessToken = "your-access-token",
    BaseUrl = "https://api.example.com",
    Locale = GsiSdkLocale.En,
    CameraShape = GsiCameraShape.Oval,
    ResultType = GsiResultType.Standard,
    SslConfig = new GsiSslConfig
    {
        CertificateAlias = "your-cert-alias"
    },
    UiConfig = new GsiUiConfig
    {
        LogoUrl = "https://example.com/logo.png"
    }
};

2. Start Face Detection

IGsiFaceDetectSdk sdk = /* platform-specific instance */;

GsiSdkResult result = await sdk.StartAsync(config);

3. Handle the Result

if (result.Person != null)
{
    var person = result.Person;
    // person.Name, person.Surname, person.Pinfl, person.Photo, etc.
}

if (result.NestedResult != null)
{
    // Enterprise nested result handling
}

Configuration Options

Platform Details

Android

Uses AndroidX Activity Result API with the native facedetectsdk.aar. Key dependencies include Google ML Kit Face Detection, AndroidX Camera, and OkHttp.

iOS

Uses TGFISBIN.xcframework (native Swift SDK) via a custom ObjC bridge (TGFISBINBridge.xcframework). The bridge is built from Swift source in the NativeBridge/ folder using build.sh.

Rebuilding the iOS Bridge

cd NativeBridge
./build.sh

This compiles the Swift bridge for device (arm64) and simulator (arm64 + x86_64), then packages the result as an xcframework.

License

Proprietary. All rights reserved.