Changelog

1.11.1 - 02.10.2026

Changed

• Passport adımında, okunan pasaportun şablon tipi (new / old / unknown) backend'e passport_type alanıyla gönderilir. Front ve Back adımlarının isteği değişmedi.

1.11.0 - 29.09.2026

Changed

• Front, Back ve Passport adımları ortak DocumentStep sınıfından türetildi. identifyTimeout, documentResolution, isGlareDetectionEnable ve glare metin parametreleri (glareDetectedText, tooBrightText, tooDarkText, multipleDocumentsDetectedText) üç adımda ortaktır; varsayılan değerler değişmedi (glare algılama kimlik kartında açık, pasaportta kapalı). Kaynak kodu uyumludur; ancak ikili (binary) imzalar değiştiği için host uygulamanın bu sürümle yeniden derlenmesi gerekir.
• Front, Back ve Passport adımlarının belge çekim ekranları tek bir ortak ekranda birleştirildi; adımların davranışı ve görünümü değişmedi.

1.10.0 - 29.09.2026

Added

• Front, Back ve Passport adımlarına documentResolution(DocumentResolution.LOW | MEDIUM | HIGH | ULTRA) parametresi eklendi. Belge fotoğrafının çekim çözünürlüğünü belirler, varsayılan HIGH.
• Hologram adımına recordingDurationMs (kayıt süresi, varsayılan 10000 ms) ve torchEnabled (kayıt boyunca kamera ışığı, varsayılan false) parametreleri eklendi.

Changed

• Havelsan id_verification SDK'sı rc72'den 2.0.1'e yükseltildi. Eski Camera1 kamera altyapısı kaldırıldı; tüm kamera adımları CameraX üzerinde çalışır.
• Hologram adımı Havelsan'ın yeni hologram video API'sine taşındı. Kayıt arka kamerayla ve sessiz yapılır; bu nedenle adım artık yalnızca kamera izni ister, mikrofon izni istemez.
• enableHighestResolution parametresi deprecated oldu ve artık etkisi yoktur; yerine documentResolution kullanılmalıdır (en yüksek çözünürlük için DocumentResolution.ULTRA).
• Belge adımlarında ve Liveness adımında çekim tamamlandığında, üzerine fotoğraf yerleştirmek yerine kamera önizlemesi son karede dondurulur.

Fixed

• Liveness ve VideoRecord adımlarında yüz fotoğrafları, ekran kaydı ve video/ses kayıtları bellek yerine dosya üzerinden işlenir hale getirildi; büyük kayıtlarda yaşanan bellek yetersizliği (OOM) kaynaklı çökmeler giderildi.
• Liveness ve VideoRecord adımlarında eski bir denemeden gelen geç callback'lerin güncel denemenin durumunu bozması engellendi.
• Liveness adımında boş dönen ekran kaydı sonucunun gerçek kaydı başarısız saymasına neden olan hata giderildi.
• Liveness adımında hata veya tekrar deneme ekranı açıkken uygulama arka plana alınıp geri gelindiğinde akışın baştan başlaması giderildi.
• Host uygulamanın onError callback'inin aynı hata için iki kez çağrılabilmesi giderildi.
• VideoRecord adımında ses kaydı eksik olduğunda önizleme videosunun oluşturulamaması ve kaydın tamamen iptal edilmesi giderildi.

1.6.18 - 23.09.2026

Changed

• SDK manifest'inde NFC özelliği artık zorunlu değil (android.hardware.nfc required="false"); NFC donanımı olmayan cihazlar host uygulamayı Google Play'de filtrelemez. Bu cihazlarda NFC adımına gelindiğinde akış NFCError.DEVICE_NOT_HAVE_NFC ile hata ekranına yönlenir.
• NFC kapalı uyarısına İptal butonu eklendi; buton metni NFC adımının cancelButtonText parametresiyle özelleştirilebilir.

1.6.17 - 18.09.2026

Changed

• KYC akışı süresince cihaz ekranı açık tutulur.

Fixed

• Uzun süren adımlar sırasında ekranın kararması giderildi.

1.6.16 - 16.09.2026

Fixed

• Video görüşme sırasında ekranın kararması giderildi.

1.6.15 - 15.09.2026

Added

• Ekran kaydı içermeyen -no-record artifact varyantları eklendi. Backend'i save_face_match_video bayrağını hiç açmayan entegrasyonlar, Havelsan ekran kaydı izinlerini ve servisini hiç barındırmayan bu paketleri kullanabilir. Varyantlar aynı SDK sürüm numarasını taşır; seçim derleme zamanında yapılır.
• ScreenRecordingError.SCREEN_RECORDING_NOT_AVAILABLE hatası eklendi. -no-record bir artifact kullanılırken backend ekran kaydı gerektirdiğinde Liveness adımı, kamera ve izin isteklerinden önce bu hatayla başarısız olur; gereksinim sessizce atlanmaz.
• NFC adımında doğum yeri bilgisi okunmaya başlandı.

Changed

• Görüntü sıkıştırma davranışı güncellendi.
• Kurulum bölümüne artifact varyantları (video görüşme ve ekran kaydı boyutları) hakkında bilgilendirme eklendi; bağımlılık örneği v1.6.15 sürümüne güncellendi.
• Daha önce dokümante edilmemiş olan aşağıdaki API'ler dokümana eklendi: ttsConfig ve TTSConfig parametreleri, updateUIConfig, NFC adımının metin parametreleri (scanTitle, scanDescription, cancelButtonText, retryTitle, retryDescription, disabledTitle, disabledDescription, disabledButtonText), Passport adımının nationality parametresi, Front ve Back adımlarının enableHighestResolution parametresi ve RuPassportAddressValidation adımı.

Fixed

• Liveness anlık görüntüsünün alınamaması ve siyah bant (letterboxing) sorunu giderildi.
• Liveness anlık görüntüsü artık çözümleme gecikmesi olmadan gösteriliyor.

1.6.11 - 03.09.2026

Added

• UIConfig'e dark mode desteği eklendi: isDarkTheme bayrağı ve opsiyonel darkColors bloğu. Host uygulama kendi dark-mode durumunu bildirdiğinde SDK, verilmişse host'un darkColors paletini, verilmemişse kendi built-in koyu paletini kullanır.
• Yeni KPS (Kimlik Paylaşımı Sistemi) adımı eklendi. Kullanıcının kimlik bilgilerini otomatik olarak doğrular, kendine özgü bir parametresi yoktur.
• Video görüşme sağlayıcısının seçilebilmesi eklendi: videoCallProvider ve roomName parametreleri.
• securityCheckEnabled parametresi eklendi. Etkinleştirildiğinde cihazda root/emülatör/hook tespiti yapılır; tespit her zaman bir SecurityWarning event'i yayınlar ve debug olmayan build'lerde akışı bir hata ekranıyla durdurur. Varsayılan kapalı.
• Ağ, sunucu, zaman aşımı, red, kimlik okuma, belge otomatik algılama, video kaydı, konum izni ve video görüşme hataları için yeni hata enum aileleri eklendi (NetworkError, ServerError, TimeOutError, RejectedError, IdentityReadFailedError, DocumentAutoDetectError, VideoRecordError, PermissionError, VideoCallError). Ayrıca daha önce dokümante edilmemiş olan ekran kaydı hataları (ScreenRecordingError) da dokümana eklendi.

Changed

• [Breaking] Hata tipleri yeniden adlandırıldı, geriye dönük uyumluluk shim'i yoktur: KYCError (enum) → SDKError, KYCCameraError → CameraSourceError, KYCNFCError → NFCError. Bazı hata case'leri de yeniden adlandırıldı/birleştirildi (örn. PERMISSION_NOT_GRANTED + CAMERA_PERMISSION_REQUIRED → CAMERA_PERMISSION_DENIED, FLASH_MODE → FLASH_TOGGLE_FAILED, NOT_ENABLE → NFC_NOT_ENABLED). Detaylar için Hata Yönetimi bölümüne bakınız.
• Havelsan id_verification SDK'sı rc71'e yükseltildi (jmrtd 0.7.42 / BC 1.78.1).

Fixed

• KPS adımının NFC sonrası hemen ateşlenmesi durumunda connection reset ile başarısız olması giderildi.
• Front, Back ve Passport adımlarında kamera hatası sonrası retry'ın belge algılamayı (documentAutoDetection) yeniden başlatmaması giderildi; önceden kamera önizlemesi canlı görünse de algılama bir daha tetiklenmiyordu.
• SDK'nın kullanılmayan launcher icon kaynakları AAR'dan kaldırıldı; host uygulamanın kendi launcher icon'u artık bazı Android 8+ cihazlarda SDK'nınkiyle ezilmiyor.
• Host'un tanımladığı adım listesi backend'in beklediğiyle uyuşmadığında akış artık düzgün bir hata ekranına (APP_IDENTIFIER_STEPS_IS_NOT_SAME_API) yönlendiriyor.
• NFC doğrulaması genel bir sebeple başarısız olduğunda kullanıcıya gösterilecek ayrı, yerelleştirilmiş bir hata metni eklendi.

1.6.0 - 08.07.2026

Added

• İki yeni adım eklendi: Selfie (Özçekim) ve VideoRecord (Sesli Video Doğrulama). VideoRecord adımında kullanıcının okuyacağı metin (prompt_text) backend tarafından iletilir.
• completedScreenTexts parametresi eklendi. Başarı ekranının başlık, açıklama ve buton metinleri özelleştirilebilir hale getirildi.
• language parametresi eklendi. SDK dili tr, en veya ru olarak seçilebilir; İngilizce ve Rusça yerelleştirme eklendi.
• UIConfig'in tüm renk ve şekil ayarları erişime açıldı: 16 renk (primaryColor, surfaceColor, backgroundColor, errorColor, successColor, overlayColor, titleColor, descriptionColor vb.) ve 5 şekil (cardCornerRadius, imageFrameCornerRadius, bottomSheetCornerRadius, cameraOverlayCornerRadius) ayarı artık host uygulamalar tarafından kullanılabilir.

Changed

• ID verification versiyonu güncellendi. (r1.0.0-rc68)

Fixed

• Video görüşme başlatma (video-call-start) isteğinin boş yanıt dönmesi durumunda appointment_id'nin kaybolması ve akışın yarıda kalması giderildi.
• Hızlı adım geçişlerinde sesli yönlendirmenin (TTS) önceki adımdan çalmaya devam etmesi düzeltildi.
• Uygulama arka plana alındığında canlılık (liveness) oturumunun kesintiye uğraması ele alındı.
• Akış sonlandığında entegre uygulamaya dönüş yapılmayan durumlar düzeltildi.
• onProcessFinished ile dönen KYCProcessResult.Failed ve Cancelled sonuçlarına, akışın gerçek başarısızlık/iptal sebebini taşıyan bir reason alanı eklendi.