Version: 1.6.15

Changelog

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.

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.

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

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.