Anpr.Sdk 1.0.1

Anpr.Sdk

CPU-only Türk plaka tanıma (ANPR) çalışma zamanı — otopark yazılımına (PMS) doğrudan gömülmek için. RTSP kameradan kareyi çeker, plakayı tespit + OCR eder, çok-kareli oylama + TR gramer kısıtlaması + varyant bastırma uygular ve tek bir C# olayı olarak plaka yayınlar. GPU gerektirmez; otopark ofis PC'lerinde çalışacak şekilde tasarlanmıştır.

Modeller (dedektör + Erzurum saha fine-tune OCR + rektifikasyon + SR) pakete gömülüdür ve tüketicinin çıktı dizinine models/ olarak kopyalanır — ekstra dosya taşımak gerekmez.

Gereksinimler

• .NET 8.0+ (x64 / arm64)
• ffmpeg (PATH'te ya da options.Ffmpeg.Path) — RTSP + HEVC çözer

Hızlı başlangıç

using Anpr.Sdk;
using Anpr.Sdk.Configuration;

var runtime = new AnprRuntime(new AnprServiceOptions {
    Cameras = {
        new CameraOptions { Id = "giris", Name = "Giriş",
                            RtspUrl = "rtsp://kullanici:sifre@ip:554/Streaming/Channels/101" },
        new CameraOptions { Id = "cikis", Name = "Çıkış", RtspUrl = "rtsp://..." },
    }
}, loggerFactory);   // ILoggerFactory opsiyonel

runtime.PlateDetected += e => {
    if (e.Scope != "roi") return;               // ROI dışı "gözlem" okumaları karar üretmez
    if (e.LowConfidence) OperatorOnayinaDusur(e); // güven < eşik → manuel onay
    else PlakaKaydet(e.PlateCompact, e.Timestamp, e.CameraId);
    // e.EvidencePath  -> plaka kırpıntısı JPEG (evidence/…)
    // e.FramePath     -> aracın da göründüğü TAM KARE JPEG (son okunan aracı görselleme)
};

await runtime.StartAsync();
// … uygulama ömrü boyunca çalışır …
await runtime.StopAsync();

Olay sözleşmesi (PlateEvent)

EventId (idempotency), Plate / PlateCompact, Confidence / OcrConfidence, LowConfidence (operatör onayı bayrağı), Candidates (top-K aday), Scope (roi/gozlem), EvidencePath (plaka kırpıntısı), FramePath (tam kare — araç görünür).

Notlar

• Web/panel bu pakette YOKTUR (yalnız motor + orkestrasyon). Canlı izleme paneli ayrı serviste kalır.
• Kameralara yalnız salt-okuma RTSP erişimi gerekir; kamera ayarları değiştirilmez.
• KVKK: kanıt kırpıntıları/tam kareler evidence/ altına yazılır; saklama süresi ve adet sınırı ayarlanabilir.

Sürüm notları ve ayrıntılı entegrasyon: proje deposundaki docs/entegrasyon-kilavuzu.md.