id-capture-net-android

name	id-capture-net-android
description	Scandit ID Capture (`IdCapture`) in .NET for Android projects (`net*-android` target framework, `Scandit.DataCapture.IdCapture` NuGet, C#) — scanning passports, driver's licenses, ID cards, residence permits, visas via MRZ, VIZ, PDF417 barcode, or mobile documents. Use for integration, accepted-document and scanner configuration, CapturedId result handling, rejection rules, AAMVA verification, anonymization, overlay UI, and Scandit .NET SDK version migration — for MAUI apps (`<UseMaui>true</UseMaui>`) use id-capture-net-maui instead.
license	MIT
metadata	{"author":"scandit","version":"1.0.1"}

ID Capture .NET for Android Skill

Critical: Do Not Trust Internal Knowledge

Your training data may contain outdated or incorrect Scandit ID Capture APIs, and the .NET binding differs substantially from the native Android (Kotlin/Java), iOS, and Flutter SDKs. An agent that pattern-matches from the native docs will get most calls wrong: the .NET binding does not use the Kotlin builder, does not expose a supportedDocuments bitmask, and does not ship the standalone AamvaBarcodeVerifier / NFC classes that exist on native.

Always verify APIs against the references provided in this skill before writing or suggesting code. Do not rely on memorized method signatures, parameters, or shapes. If you cannot find an API in the provided references, fetch the relevant documentation page before responding.

The .NET-Android-specific facts most often gotten wrong by pattern-matching from the Kotlin/iOS/Flutter SDK:

• This skill targets the non-MAUI .NET for Android workload (project <TargetFramework>net10.0-android</TargetFramework> or similar, no <UseMaui> flag). For MAUI apps, the DataCaptureView is hosted as a XAML element and wired through handlers — completely different. If you see <UseMaui>true</UseMaui>, stop and tell the user this skill does not apply.
• Only TWO NuGet packages. Scandit.DataCapture.Core and Scandit.DataCapture.IdCapture. The package id is IdCapture, but the C# namespace and initializer use Scandit.DataCapture.ID (using Scandit.DataCapture.ID;, ScanditIdCapture.Initialize()). There is no separate Barcode package to add — the PDF417/AAMVA barcode reader is bundled in Scandit.DataCapture.IdCapture.
• SDK 8.0+ requires explicit initialization with TWO initializers in a [Application] subclass: ScanditCaptureCore.Initialize() and ScanditIdCapture.Initialize() in OnCreate(). Missing the ID one crashes the first IdCapture.Create(...) call.
• IdCaptureSettings is configured with an object initializer / property sets — NOT a builder and NOT a bitmask. You set AcceptedDocuments (an IList<IIdCaptureDocument>) and Scanner (an IdCaptureScanner). The Kotlin/old supportedDocuments + IdDocumentType bitmask does not exist in .NET.
• Documents are constructed with new, taking an IdCaptureRegion: new Passport(IdCaptureRegion.Any), new DriverLicense(IdCaptureRegion.Us), new IdCard(IdCaptureRegion.Any), new ResidencePermit(...), new HealthInsuranceCard(...), new VisaIcao(...), and new RegionSpecific(RegionSpecificSubtype.X). IdCaptureRegion values are C# PascalCase (Any, Us, EuAndSchengen, …), not the Kotlin underscore style.
• The scanner is a wrapper: new IdCaptureScanner(physicalDocument: <IPhysicalDocumentScanner?>, mobileDocument: <MobileDocumentScanner?>). Physical = new FullDocumentScanner() (front+back, the default choice) or new SingleSideScanner(barcode, machineReadableZone, visualInspectionZone). Mobile = new MobileDocumentScanner(iso180135, ocr). Assign it to settings.Scanner.
• IdCapture is created with a FACTORY, not new: IdCapture.Create(dataCaptureContext, settings) (the constructor is private). There is also a Create(settings) overload.
• You manage the camera yourself, and RecommendedCameraSettings is applied to the camera (not passed to GetDefaultCamera): Camera.GetDefaultCamera(), then camera.ApplySettingsAsync(IdCapture.RecommendedCameraSettings), then dataCaptureContext.SetFrameSourceAsync(camera), then camera.SwitchToDesiredStateAsync(FrameSourceState.On/Off) across the lifecycle. RecommendedCameraSettings is a static property on IdCapture.
• The view is a generic DataCaptureView; the overlay is IdCaptureOverlay.Create(idCapture, dataCaptureView) (a two-arg factory that auto-attaches — unlike some other modes). Then optionally set overlay.IdLayoutStyle = IdLayoutStyle.Square.
• Results come via IIdCaptureListener with TWO callbacks: OnIdCaptured(IdCapture, CapturedId) and OnIdRejected(IdCapture, CapturedId?, RejectionReason) (the idiomatic C# alternative is the IdCaptured / IdRejected events). Both run on a background/arbitrary thread — dispatch UI work to the main thread (view.Post(...) or RunOnUiThread(...)), and set idCapture.Enabled = false while a result dialog is shown, re-enabling it afterwards.
• Read field values via CapturedId: top-level FullName / FirstName / LastName (string?), DateOfBirth / DateOfExpiry / DateOfIssue (a DateResult? with Day/Month/Year ints plus UtcDate / LocalDate), DocumentNumber, Nationality, Sex (raw string) / SexType (Sex enum), Age, Address, and the document via Document?.DocumentType (IdCaptureDocumentType). The richer sub-results are capturedId.Mrz / capturedId.Viz / capturedId.Barcode / capturedId.MobileDocument / capturedId.MobileDocumentOcr (note: properties are Mrz/Viz/Barcode, not MrzResult/VizResult/BarcodeResult), plus capturedId.Images and capturedId.VerificationResult.
• Verification is settings-driven on .NET — there is NO AamvaBarcodeVerifier / DataConsistencyVerifier class. Enable checks via IdCaptureSettings flags (RejectForgedAamvaBarcodes, RejectInconsistentData, RejectNotRealIdCompliant, …) and read the outcome from capturedId.VerificationResult (DataConsistency / AamvaBarcodeVerification). See references/advanced.md.
• NFC chip reading and the deserializer API are NOT in the .NET surface. Do not reference NfcScanner, NfcResult, CapturedId.Nfc, or IdCaptureDeserializer — they don't exist on .NET Android.
• Android SupportedOSPlatformVersion must be ≥ 24; the activity must use a Theme.AppCompat descendant (the CameraPermissionActivity helper inherits from AppCompatActivity); and do not declare <activity> for [Activity]-decorated classes in AndroidManifest.xml. Same Android plumbing as any Scandit .NET Android app — see references/integration.md.

Forbidden APIs (commonly hallucinated — do NOT emit these)

These compile-fail against the real .NET packages. Use the right-hand form:

Do NOT write	Use instead
new IdCapture(...) / IdCapture.ForDataCaptureContext(...)	IdCapture.Create(context, settings)
IdCaptureSettings.builder() / settings.SupportedDocuments / IdDocumentType bitmask	new IdCaptureSettings { AcceptedDocuments = [ … ], Scanner = … }
settings.ScannerType = ...	settings.Scanner = new IdCaptureScanner(physicalDocument: …, mobileDocument: …)
IdCaptureOverlay.NewInstance(...)	IdCaptureOverlay.Create(idCapture, dataCaptureView)
capturedId.MrzResult / capturedId.VizResult / capturedId.BarcodeResult	capturedId.Mrz / capturedId.Viz / capturedId.Barcode
capturedId.IsPassport() / IsDriverLicense() / IsIdCard()	capturedId.Document?.DocumentType (IdCaptureDocumentType) or capturedId.IsRegionSpecific(subtype)
new AamvaBarcodeVerifier(...) / AamvaBarcodeVerifier.Create(...)	settings.RejectForgedAamvaBarcodes = true + read capturedId.VerificationResult.AamvaBarcodeVerification
new DataConsistencyVerifier(...)	settings.RejectInconsistentData = true + read capturedId.VerificationResult.DataConsistency
NfcScanner / NfcResult / capturedId.Nfc	(not available on .NET Android — no NFC API)
capturedId.VisaDetails / PassportType / MobileDocumentDataElement	(not available on .NET Android)
reading capturedId.Viz.DateOfBirth / .Nationality / .DocumentNumber	those VIZ fields aren't on .NET — read them from the top-level capturedId.DateOfBirth / .Nationality / .DocumentNumber

Product Guidance

Apply these rules whenever the user is making a design decision, not just an API question.

• Accept only the documents you actually need. A narrow AcceptedDocuments list (e.g. just new DriverLicense(IdCaptureRegion.Us)) is faster and more accurate than IdCaptureRegion.Any across every document type. Ask the user which documents and regions they expect before defaulting to "everything".
• Pick the scanner that matches the data you need. FullDocumentScanner() reads front and back automatically (best for most ID/DL use cases). SingleSideScanner(barcode, machineReadableZone, visualInspectionZone) reads a single side from the zone(s) you enable — use it when you only need, say, the PDF417 barcode on the back of a US DL, or only the MRZ of a passport. MobileDocumentScanner is for mobile driver's licenses (mDL).
• Handle OnIdRejected, not just OnIdCaptured. Rejections (RejectionReason.Timeout, NotAcceptedDocumentType, DocumentExpired, DocumentVoided, ForgedAamvaBarcode, InconsistentData, …) are how the user learns why a scan didn't succeed. A production integration must surface a message for them.
• Anonymize by default if you don't need every field. IdCaptureSettings.AnonymizationMode and per-field anonymization keep regulated data (document images, sensitive fields) out of the result unless you opt in. Recommend the minimum that satisfies the use case.
• Hand off to the data-capture-sdk skill for non-ID-Capture questions. If the user asks about another Scandit product (Barcode Capture, SparkScan, MatrixScan, Label Capture, etc.) or about choosing between products, defer to the data-capture-sdk skill instead of guessing.

Intent Routing

Based on the user's request, load the appropriate reference file before responding:

• Integrating ID Capture from scratch, configuring accepted documents and the scanner, creating the mode, hosting the DataCaptureView + IdCaptureOverlay, wiring the camera lifecycle, handling captured/rejected IDs, and reading the common CapturedId fields (e.g. "add passport / driver's license scanning to my .NET Android app", "read the holder's name and date of birth in C#", "scan an ID card and show the document number") → read references/integration.md and follow it.
• Tuning the scanner (single-side / mobile docs), rejection rules (expired / voided / underage / expiring / forged-AAMVA / inconsistent), data-consistency & AAMVA verification, anonymization, reading the rich sub-results (MRZ / VIZ / PDF417 barcode / mobile document / images / driving-license details), or customizing the overlay (e.g. "reject expired IDs", "only read the back barcode of a US license", "verify the AAMVA barcode and detect forgeries", "anonymize the document images", "read the full MRZ", "change the viewfinder style") → read references/advanced.md and follow it.
• Upgrading the Scandit .NET SDK version on an existing ID Capture integration (e.g. "migrate ID Capture from 6.x to 7", "update Scandit to the latest version", "we're on 7.x and the build breaks after bumping the packages", "move off the old SupportedDocuments API", code that still uses SupportedDocuments / IdDocumentType / SupportedSides, or an app that crashes at launch after an 8.x update) → read references/migration.md and follow it. ID Capture launched on dotnet.android at 6.16; the 6→7 step is a compile-breaking document/scanner redesign and the 7→8 step requires adding explicit SDK initialization.

API Usage Policy

Only use APIs that are explicitly documented in the Scandit references below. Do not invent or guess method signatures, parameters, property names, or imports. If unsure whether an API exists or how it is called — or if a compile error occurs — fetch the relevant reference page before responding. Do not tell the user to check the docs themselves. After answering, always include the relevant link so the user can explore further.

Never construct or guess documentation URLs. When you need a specific class or property's API page:

1. First check whether the page you already fetched contains a direct hyperlink to it — topic pages link directly to relevant API symbols. Always request links alongside content in your fetch prompt.
2. If no direct link was found, fetch the API index (see Full API reference in the table below), extract the actual link from it, and follow that.

URL structures can vary (e.g. an api/ui/ subdirectory) and guessing will lead to 404s.

References

Direct users to the right resource based on their question:

Topic	Resource
Get Started	Get Started (.NET for Android)
Advanced topics (scanners, rejection, verification, anonymization, overlay)	Advanced Configurations
Migrating / upgrading the SDK version (6→7, 7→8)	references/migration.md · Migrate 6→7 · Migrate 7→8
Full API reference	ID Capture API (.NET Android)

API surface this skill covers

All classes documented with :available: dotnet.android in the official RST docs (docs/source/id-capture/api/**) are addressed in the references. ID Capture is available on dotnet.android since 6.16, but the modern document/scanner API (AcceptedDocuments, IdCaptureScanner, FullDocumentScanner) landed at 7.0–8.0, and the verification result model at 8.0 — so this skill targets a current 8.x stable.

• IdCapture (Scandit.DataCapture.ID.Capture) — static Create(DataCaptureContext?, IdCaptureSettings) / Create(IdCaptureSettings); Context (get); Enabled (get/set — false while a result is shown, true to scan); ApplySettings(IdCaptureSettings); AddListener / RemoveListener(IIdCaptureListener); static RecommendedCameraSettings (property); Feedback (get/set); Reset(); ExternalTransactionId (get/set, 8.0); event EventHandler<IdCapturedEventArgs> IdCaptured; event EventHandler<IdRejectedEventArgs> IdRejected; Dispose().
• IdCaptureSettings — new IdCaptureSettings() then set properties: Scanner (IdCaptureScanner), AcceptedDocuments / RejectedDocuments (IList<IIdCaptureDocument>), RejectVoidedIds, RejectExpiredIds, RejectIdsExpiringIn (Duration?), RejectNotRealIdCompliant, RejectForgedAamvaBarcodes, RejectInconsistentData, RejectHolderBelowAge (int?), DecodeBackOfEuropeanDrivingLicense, AnonymizationMode (IdAnonymizationMode), AnonymizeDefaultFields; methods AddAnonymizedField(doc, IdFieldType), Get/SetShouldPassImageTypeToResult(IdImageType, bool), SetProperty/GetProperty. No builder.
• IdCaptureScanner — new IdCaptureScanner(IPhysicalDocumentScanner? physicalDocument, MobileDocumentScanner? mobileDocument); PhysicalDocument / MobileDocument (get).
• Physical scanners (IPhysicalDocumentScanner): new FullDocumentScanner(); new SingleSideScanner(bool barcode, bool machineReadableZone, bool visualInspectionZone) (props Barcode/MachineReadableZone/VisualInspectionZone).
• MobileDocumentScanner — new MobileDocumentScanner(bool iso180135, bool ocr); Ocr (get). (The ISO getter is bound as GetIso180135 — rarely read.)
• Documents (IIdCaptureDocument, props Region + DocumentType): new IdCard(IdCaptureRegion), new DriverLicense(IdCaptureRegion), new Passport(IdCaptureRegion), new VisaIcao(IdCaptureRegion), new ResidencePermit(IdCaptureRegion), new HealthInsuranceCard(IdCaptureRegion), new RegionSpecific(RegionSpecificSubtype) (also exposes Subtype).
• IdCaptureRegion enum — Any, EuAndSchengen, and ~250 PascalCase country values (Us, Uk, Uae, Germany, …).
• IIdCaptureListener — OnIdCaptured(IdCapture, CapturedId), OnIdRejected(IdCapture, CapturedId?, RejectionReason). IdCapturedEventArgs (IdCapture, CapturedId) / IdRejectedEventArgs (IdCapture, CapturedId?, Reason).
• CapturedId (Scandit.DataCapture.ID.Data) — FirstName/LastName/FullName, Sex/SexType, DateOfBirth/DateOfExpiry/DateOfIssue (DateResult?), Nationality/NationalityISO, Address, Age (int?), Expired (bool?), Document (IIdCaptureDocument?), IssuingCountry/IssuingCountryIso, DocumentNumber/DocumentAdditionalNumber, Barcode/Mrz/Viz/MobileDocument/MobileDocumentOcr (sub-results), Images (IdImages), VerificationResult, UsRealIdStatus, CitizenPassport, AnonymizedFields; methods IsRegionSpecific(subtype), IsAnonymized(field).
• DateResult — Day/Month/Year (int), LocalDate/UtcDate (DateTime).
• Sub-results: MrzResult, VizResult, BarcodeResult (large AAMVA surface), MobileDocumentResult, MobileDocumentOcrResult, DrivingLicenseDetails / DrivingLicenseCategory, ProfessionalDrivingPermit, VehicleRestriction — see references/advanced.md and the docs for full field lists.
• IdImages — Face, Frame, GetCroppedDocument(IdSide), GetFrame(IdSide) (each an Android.Graphics.Bitmap? on Android).
• IdCaptureOverlay (Scandit.DataCapture.ID.UI.Overlay) — static Create(IdCapture, DataCaptureView?) / Create(IdCapture); IdLayoutStyle (Rounded/Square), IdLayoutLineStyle (Bold/Light), TextHintPosition, ShowTextHints, CapturedBrush/LocalizedBrush/RejectedBrush + static Default*Brush; SetFrontSideTextHint/SetBackSideTextHint.
• IdCaptureFeedback — static DefaultFeedback (property); IdCaptured / IdRejected (Feedback).
• Verification (Scandit.DataCapture.ID.Verification) — VerificationResult (DataConsistency / AamvaBarcodeVerification), DataConsistencyResult (AllChecksPassed, FailedChecks/PassedChecks/SkippedChecks as DataConsistencyCheck flags, FrontReviewImage), AamvaBarcodeVerificationResult (AllChecksPassed, Status), AamvaBarcodeVerificationStatus (Authentic/LikelyForged/Forged). No verifier classes — settings-driven.
• Enums: RejectionReason, IdCaptureDocumentType, RegionSpecificSubtype, IdSide, CapturedSides, Sex, UsRealIdStatus, IdAnonymizationMode, IdImageType, IdFieldType. Duration — new Duration(days, months, years).

Documented for other platforms but NOT on dotnet.android — do not use

• NFC (NfcScanner, NfcResult, NfcScannerListener, CapturedId.Nfc) — Android/iOS native only; not in the .NET surface.
• Deserializer (IdCaptureDeserializer, IIdCaptureDeserializerListener) — native Android only.
• Standalone AamvaBarcodeVerifier — web/Xamarin only; on .NET use RejectForgedAamvaBarcodes + CapturedId.VerificationResult.
• CapturedId.VisaDetails / VisaDetails / ApplicationStatus, PassportType, MobileDocumentDataElement / MobileDocumentScanner.ElementsToRetain, LocalizedOnlyId, BarcodeMetadata, IdCaptureTrigger — not available on dotnet.android.
• CapturedId.IsIdCard() / IsPassport() / IsDriverLicense() / … helper methods — not on .NET; use Document?.DocumentType.
• Most name/identity fields on VizResult (Sex, DateOfBirth, Nationality, Address, DocumentNumber, DateOfExpiry, DateOfIssue) — not on dotnet.android; read them from the top-level CapturedId.