iOS - SDK Sürüm Notları¶
v2.1.2.7011 Sürüm Notları — 04.11.2026¶
[IOS SDK] [CONDITIONAL ACTION] [BACKWARD COMPATIBLE]
1. Sürüm Özeti¶
Bu sürümde, görüntülü görüşme (VideoCall) sırasında telefon (GSM) aramalarıyla ilgili ses sorunları giderilmiştir: telefon araması sonrası görüşme sesi otomatik olarak toparlanmakta, SDK sesleri çalarken görüşme sesinin kesilmesi/kısılması önlenmekte ve aktif bir telefon görüşmesi varken VideoCall başlatılmaya çalışıldığında entegratör yeni bir hata koduyla bilgilendirilmektedir.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Koşullu | VideoCall modülünü kullanan entegrasyonlar etkilenmektedir. |
| Müşteri aksiyonu gerekiyor mu? | Evet | VideoCall başlatma hatalarını (initializeFailed) kullanıcıya gösteren entegrasyonların yeni hata kodunu (1018) ele alması önerilir. |
| Parametre veya konfigürasyon değişikliği var mı? | Hayır | Yeni veya kaldırılan bir parametre bulunmamaktadır. |
| Mevcut entegrasyonlarla uyumlu mu? | Evet | Geriye dönük API uyumluluğu korunmuştur. |
| Test yapılması gerekiyor mu? | Evet | VideoCall sırasında telefon araması gelme/reddetme/sonlandırma senaryoları ve aktif telefon görüşmesi varken VideoCall başlatma test edilmelidir. |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
Aktif Telefon Görüşmesi Varken VideoCall Başlatma Kontrolü
Bileşen: iOS SDK (VideoCall / Core) | Tür: İyileştirme
Ne değişti? Cihazda aktif bir telefon (GSM) görüşmesi varken VideoCall başlatılmaya çalışıldığında, SDK görüşmeyi başlatmamakta ve host uygulamayı initializeFailed callback'i üzerinden yeni InitializationError.activeSystemCall (hata kodu 1018) ile bilgilendirmektedir.
Müşteriyi etkiliyor mu? Koşullu. Yalnızca VideoCall modülünü kullanan entegrasyonlar etkilenmektedir.
Yapılması gereken: initializeFailed callback'inizde hata kodu 1018'i ayrıca ele alın ve kullanıcıya telefon görüşmesini sonlandırıp tekrar denemesi gerektiğini bildirin. Bu hata kodunu özel olarak işlemeyen entegrasyonlarda ek bir implementasyon değişikliği zorunlu değildir.
İşlem yapılmazsa: Hata kodu 1018 ele alınmazsa, kullanıcı VideoCall'un neden başlatılamadığına dair anlamlı bir bilgilendirme görmeyebilir.
Telefon Araması Sonrası Görüşme Sesinin Otomatik Toparlanması
Bileşen: iOS SDK (VideoCall) | Tür: Hata Düzeltmesi
Ne değişti? Görüntülü görüşme sırasında telefon (GSM) araması geldiğinde veya sonlandığında görüşme sesinin kesilip geri gelmemesine neden olan sorun giderilmiştir. Telefon araması sona erdiğinde görüşme sesi artık otomatik olarak toparlanmaktadır.
Müşteriyi etkiliyor mu? Hayır. Değişiklik SDK tarafında otomatik devreye girer.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. VideoCall sırasında telefon araması gelme, reddetme ve sonlandırma senaryolarının test edilmesi önerilir.
SDK Sesleri Çalarken Görüşme Sesinin Kesilmesi Düzeltmesi
Bileşen: iOS SDK (VideoCall / Core) | Tür: Hata Düzeltmesi
Ne değişti? Görüntülü görüşme sırasında SDK sesleri (örneğin temsilci bekleme sesi) çalarken görüşme sesinin kesilebildiği veya kısılabildiği sorun giderilmiştir.
Müşteriyi etkiliyor mu? Hayır. Değişiklik SDK tarafında otomatik devreye girer.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir.
4. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
v2.1.2.7010 Sürüm Notları — 22.10.2026¶
[IOS SDK] [CONDITIONAL ACTION] [CONDITIONAL COMPATIBILITY]
1. Sürüm Özeti¶
Bu sürümde, görüntülü görüşmede Picture in Picture (PiP) modunun başlatılamaması durumunda host uygulamaya bildirim yapılmakta ve PiP kapalıyken yaşanan görüntü donması giderilmektedir. Ayrıca Türkiye kimliği ile pasaportun tek akışta okunabildiği yeni TUR_DEFAULT ülke seçeneği eklenmiş, Public Key ile SSL Pinning'in farklı sertifika türleriyle çalışması sağlanmış, NFC okuma ilerleme göstergesi yenilenmiş ve MRZ ad/soyad okumasında bir OCR düzeltmesi yapılmıştır.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Koşullu | VideoCall (PiP), Public Key ile SSL Pinning, NFC okuma ve OCR akışlarını kullanan entegrasyonlar etkilenmektedir. |
| Müşteri aksiyonu gerekiyor mu? | Evet | videoCallFailed callback'inde varsayılan (default) dalda görüşmeyi sonlandıran entegrasyonların yeni PiP durumunu ayrıca ele alması gerekmektedir. Ayrıca Backend sürüm gereksinimi doğrulanmalıdır. |
| Parametre veya konfigürasyon değişikliği var mı? | Evet | Yeni, opsiyonel countryCode değeri: TUR_DEFAULT. Mevcut değerler değişmemiştir. |
| Mevcut entegrasyonlarla uyumlu mu? | Koşullu | videoCallFailed callback'inin varsayılan dalında görüşmeyi sonlandıran entegrasyonlarda PiP başlatılamadığında davranış değişebilir. Backend gereksinimi doğrulanıyor. |
| Test yapılması gerekiyor mu? | Evet | VideoCall PiP geçişleri (PiP açık/kapalı), Public Key ile SSL Pinning, NFC okuma ve OCR akışları test edilmelidir. |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
PiP Başlatılamadığında Host Uygulamaya Bildirim
Bileşen: iOS SDK (VideoCall) | Tür: İyileştirme
Ne değişti? Görüntülü görüşme sırasında uygulama arka plana alındığında PiP modu başlatılamazsa (örneğin cihaz ayarlarında PiP kapalıysa), SDK artık host uygulamayı videoCallFailed(_:) callback'i üzerinden yeni .failedToStartPiPMode değeriyle bilgilendirmektedir. Bu durumda görüşme SDK tarafından sonlandırılmaz.
Müşteriyi etkiliyor mu? Koşullu. Yalnızca VideoCall'da PiP desteğini kullanan entegrasyonlar etkilenmektedir.
Yapılması gereken: videoCallFailed(_:) callback'inizde .failedToStartPiPMode değerini ayrıca ele alın (örneğin kullanıcıya PiP'in cihaz ayarlarından açılabileceğini bildiren bir uyarı gösterin). Yeni durumun görüşmeyi sonlandırmaması gerekiyorsa, bu değeri görüşmeyi sonlandıran default dalından ayırın.
İşlem yapılmazsa: videoCallFailed(_:) callback'inizin default dalında görüşmeyi sonlandırıyorsanız, PiP başlatılamadığında görüşme beklenmedik şekilde sonlanabilir.
PiP Kapalıyken Arka Plandan Dönüşte Görüntü Donması Düzeltmesi
Bileşen: iOS SDK (VideoCall) | Tür: Hata Düzeltmesi
Ne değişti? Cihaz ayarlarında PiP kapalıyken uygulama arka plana alınıp geri dönüldüğünde görüntülü görüşme ekranının donabildiği sorun giderilmiştir. Ayrıca gelen arama reddedildikten sonra tam ekran görüntü ile PiP penceresinin üst üste binebildiği durum da düzeltilmiştir.
Müşteriyi etkiliyor mu? Hayır. Değişiklik SDK tarafında otomatik devreye girer.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. VideoCall akışının, PiP ayarı açık ve kapalı iken arka plana alma/geri dönme senaryolarıyla test edilmesi önerilir.
TUR_DEFAULT Ülke Seçeneği: Türkiye Kimliği ve Pasaport için Tek Akış
Bileşen: iOS SDK (OCR) | Tür: Yeni Özellik
Ne değişti? OCR modülüne yeni TUR_DEFAULT ülke seçeneği eklenmiştir. Bu seçenekle Türkiye Cumhuriyeti kimlik kartı (TD1) ve herhangi bir ülkenin pasaportu (TD3) tek akışta okunabilmekte, doküman türü okuma sırasında otomatik belirlenmektedir. Bu seçenek, sunucu tarafında ilgili tür kontrolü ayarının açık olmasına bağlıdır; ayar kapalıysa TUR seçeneğiyle aynı şekilde çalışır.
Müşteriyi etkiliyor mu? Koşullu. Yalnızca TUR_DEFAULT seçeneğini kullanmak isteyen entegrasyonlar etkilenmektedir.
Yapılması gereken: TUR_DEFAULT kullanmak isteyen ekiplerin countryCode parametresine bu değeri geçmesi yeterlidir. Diğer ülke kodlarını kullanan entegrasyonlarda değişiklik gerekmemektedir.
Public Key ile SSL Pinning Uyumluluk İyileştirmesi
Bileşen: iOS SDK (Core) | Tür: Hata Düzeltmesi
Ne değişti? Public Key ile SSL Pinning özelliğinin, farklı anahtar türü ve boyutuna sahip sertifikalarla doğru çalışması sağlanmıştır.
Müşteriyi etkiliyor mu? Koşullu. Yalnızca Public Key ile SSL Pinning kullanan entegrasyonlar etkilenmektedir.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. Public Key ile SSL Pinning kullanan ekiplerin bağlantı doğrulamasını test etmesi önerilir.
NFC Okuma İlerleme Göstergesi Yenilendi
Bileşen: iOS SDK (NFC) | Tür: İyileştirme
Ne değişti? NFC okuma sırasında gösterilen ilerleme göstergesi, her veri grubu için yeniden başlayan göstergeler yerine tek ve kesintisiz ilerleyen bir göstergeye dönüştürülmüştür. İlerleme okuma boyunca geriye gitmeden artmaktadır.
Müşteriyi etkiliyor mu? Hayır. Değişiklik SDK tarafında otomatik devreye girer.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir.
MRZ Ad/Soyad Okuma Düzeltmesi
Bileşen: iOS SDK (OCR) | Tür: Hata Düzeltmesi
Ne değişti? MRZ alanından okunan ad ve soyad bilgilerinde OCR'ın bazı harfleri rakam olarak okuması sorunu giderilmiştir.
Müşteriyi etkiliyor mu? Hayır. Değişiklik SDK tarafında otomatik devreye girer.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir.
4. Versiyon ve Uyumluluk¶
| Bileşen | Önceki Versiyon | Yeni Versiyon | Minimum Gereksinim |
|---|---|---|---|
| Backend (OCR model indirme servisi) | — | — | Bağımlılık bilgisi doğrulanıyor |
Bağımlılık bilgisi doğrulanıyor: Bu sürümde OCR modellerinin indirildiği servisin yeni sürümü kullanılmaya başlanmıştır. Bu sürümün çalışması için gereken minimum Backend sürümü netleştirilmelidir; teyit edilene kadar Backend sürümünüzün uyumluluğunu doğrulamadan geçiş yapılmaması önerilir.
5. Geçiş Adımları¶
- Bu SDK sürümü için gereken minimum Backend sürümünü doğrulayın.
- SDK sürümünü yükseltin.
- VideoCall kullanıyorsanız
videoCallFailed(_:)callback'inizde.failedToStartPiPModedeğerini ele alın. - VideoCall PiP geçişlerini, Public Key ile SSL Pinning'i, NFC okuma ve OCR akışlarını uçtan uca test edin.
6. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
v2.1.0.7012-s Sürüm Notları — 21.10.2026¶
[IOS SDK] [CONDITIONAL ACTION] [BACKWARD COMPATIBLE]
1. Sürüm Özeti¶
Bu sürüm, SDK'yı Swift Package Manager (SPM) ile ekleyen projelerde, Xcode 27 ve Tuist birlikte kullanıldığında OCR modülünün (EnQualifyOCR) eklenmesi sırasında oluşan bir entegrasyon hatasını gidermek için yayınlanmış bir düzeltme sürümüdür. SDK'nın işlevlerinde herhangi bir değişiklik bulunmamaktadır.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Koşullu | Yalnızca SDK'yı SPM ile ekleyen ve Xcode 27 ile Tuist kullanan projeler etkilenmektedir. |
| Müşteri aksiyonu gerekiyor mu? | Evet | Yalnızca bu hatayla karşılaşan projelerin SDK paketini bu sürüme güncellemesi gerekmektedir; diğer entegrasyonlarda aksiyon gerekmez. |
| Parametre veya konfigürasyon değişikliği var mı? | Hayır | Yeni veya kaldırılan bir parametre bulunmamaktadır. |
| Mevcut entegrasyonlarla uyumlu mu? | Evet | Geriye dönük uyumluluk korunmuştur. |
| Test yapılması gerekiyor mu? | Evet | Xcode 27 ve Tuist ile SPM üzerinden entegrasyon ve build sürecinin doğrulanması önerilir. |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
Xcode 27 ve Tuist ile SPM Entegrasyon Hatası Düzeltmesi
Bileşen: iOS SDK (OCR / SPM paketi) | Tür: Hata Düzeltmesi
Ne değişti? Xcode 27 ile Tuist kullanan projelerde, OCR modülünün (EnQualifyOCR) SPM üzerinden eklenmesi sırasında dosya yolundaki büyük/küçük harf uyumsuzluğundan kaynaklanan hata giderilmiştir. EnQualifyOCR artık Xcode 27'de sorunsuz entegre edilebilmektedir.
Müşteriyi etkiliyor mu? Koşullu. Yalnızca SDK'yı SPM ile ekleyen ve Xcode 27 ile Tuist kullanan projeler etkilenmektedir. Diğer entegrasyon yöntemlerinde değişiklik yoktur.
Yapılması gereken: Bu hatayla karşılaşan ekiplerin SDK paket bağımlılığını v2.1.0.7012-s sürümüne güncellemesi gerekmektedir. Hatayla karşılaşmayan entegrasyonlarda herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir.
İşlem yapılmazsa: Xcode 27 ve Tuist ile OCR modülü eklenirken aynı hatayla karşılaşılmaya devam edilecektir.
4. Geçiş Adımları¶
- SPM bağımlılığınızı v2.1.0.7012-s sürümüne güncelleyin.
- Projenizi Tuist ile yeniden oluşturup Xcode 27'de build alarak OCR modülünün sorunsuz eklendiğini doğrulayın.
5. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
v2.1.0.11 Sürüm Notları — 06.10.2026¶
[IOS SDK] [NO CUSTOMER ACTION] [BACKWARD COMPATIBLE]
1. Sürüm Özeti¶
Bu sürümde, yeni iPhone modellerinin SDK tarafından doğru tanınması ve bu cihazlarda OCR akışının cihaza özel ayarlarla çalışması desteklenmiştir.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Koşullu | Yeni iPhone modellerinde çalışan uygulamalar etkilenmektedir. |
| Müşteri aksiyonu gerekiyor mu? | Hayır | Değişiklik SDK tarafında otomatik devreye girer. |
| Parametre veya konfigürasyon değişikliği var mı? | Hayır | Yeni veya kaldırılan bir parametre bulunmamaktadır. |
| Mevcut entegrasyonlarla uyumlu mu? | Evet | Geriye dönük API uyumluluğu korunmuştur. |
| Test yapılması gerekiyor mu? | Evet | OCR akışı yeni iPhone modellerinde test edilmelidir. |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
Yeni iPhone Modelleri Desteği
Bileşen: iOS SDK (Core / OCR) | Tür: İyileştirme
Ne değişti? Yeni iPhone modellerinin SDK tarafından doğru şekilde tanınması sağlanmıştır; bu cihazlarda SDK'nın cihaza özel davranışları (OCR dahil) doğru uygulanmaktadır.
Müşteriyi etkiliyor mu? Koşullu. Yalnızca yeni iPhone modellerinde çalışan uygulamalar etkilenmektedir.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. OCR akışının yeni iPhone modellerinde test edilmesi önerilir.
4. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
v2.1.2.7009 Sürüm Notları — 06.10.2026¶
[IOS SDK] [NO CUSTOMER ACTION] [BACKWARD COMPATIBLE]
1. Sürüm Özeti¶
Bu sürümde, NFC okuma süresi aşıldığında (timeout) okuma ekranının düzgün kapanması ve hatanın entegratöre tek seferde bildirilmesi sağlanmış, ayrıca yeni iPhone modellerinin SDK tarafından doğru tanınması desteklenmiştir.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Koşullu | NFC okuma akışını kullanan entegrasyonlar (timeout senaryosu) ve yeni iPhone modellerinde çalışan uygulamalar etkilenmektedir. |
| Müşteri aksiyonu gerekiyor mu? | Hayır | Değişiklikler SDK tarafında otomatik devreye girer. |
| Parametre veya konfigürasyon değişikliği var mı? | Hayır | Yeni veya kaldırılan bir parametre bulunmamaktadır. |
| Mevcut entegrasyonlarla uyumlu mu? | Evet | Geriye dönük API uyumluluğu korunmuştur. |
| Test yapılması gerekiyor mu? | Evet | NFC okuma sırasında zaman aşımı senaryosu test edilmelidir. |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
NFC Zaman Aşımı Sonrası Okuma Ekranı ve Hata Bildirimi Düzeltmesi
Bileşen: iOS SDK (NFC) | Tür: Hata Düzeltmesi
Ne değişti? NFC okuma süresi aşıldığında (timeout) NFC okuma ekranının bazı durumlarda açık kalabildiği ve zaman aşımı hatasının tekrarlı işlenebildiği bir sorun giderilmiştir. Artık zaman aşımında okuma ekranı kapanmakta ve hata entegratöre tek seferde bildirilmektedir.
Müşteriyi etkiliyor mu? Koşullu. Yalnızca NFC okuma akışını kullanan ve zaman aşımı senaryosuyla karşılaşan entegrasyonlar etkilenmektedir.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. NFC okuma akışının zaman aşımı senaryosunda uçtan uca test edilmesi önerilir.
Yeni iPhone Modelleri Desteği
Bileşen: iOS SDK (Core / OCR) | Tür: İyileştirme
Ne değişti? Yeni iPhone modellerinin SDK tarafından doğru şekilde tanınması sağlanmıştır; bu cihazlarda SDK'nın cihaza özel davranışları (OCR dahil) doğru uygulanmaktadır.
Müşteriyi etkiliyor mu? Koşullu. Yalnızca yeni iPhone modellerinde çalışan uygulamalar etkilenmektedir.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir.
4. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
v2.1.2.7008 Sürüm Notları — 01.10.2026¶
[IOS SDK] [CUSTOMER ACTION REQUIRED] [BACKWARD COMPATIBLE]
1. Sürüm Özeti¶
Bu sürüm, v2.1.2.7007'de bulunan ve paketin kod imzasını (code signing) etkileyen bir paketleme sorununu gidermek için yayınlanmış bir düzeltme sürümüdür. v2.1.2.7007 ile aynı değişiklikleri içerir; NFC ile pasaport/kimlik okuma sırasında kısa süreli bağlantı kesintileri otomatik olarak toparlanmakta, görüntülü görüşme (VideoCall) sırasında otomatik video kalitesi ayarlamasının güvenilirliği artırılmış ve OCR kamera ekranındaki başlangıç kılavuz görseliyle ilgili bir görsel düzeltme yapılmıştır.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Koşullu | v2.1.2.7007 kullanan entegrasyonlar kod imzası paketleme sorunundan etkilenmiş olabilir; NFC, VideoCall ve OCR kamera akışlarını kullanan entegrasyonlar davranış değişikliklerinden etkilenmektedir. |
| Müşteri aksiyonu gerekiyor mu? | Evet | v2.1.2.7007 kullanan entegrasyonların v2.1.2.7008'e güncellemesi gerekmektedir. |
| Parametre veya konfigürasyon değişikliği var mı? | Hayır | Yeni veya kaldırılan bir parametre bulunmamaktadır. |
| Mevcut entegrasyonlarla uyumlu mu? | Evet | Geriye dönük API uyumluluğu korunmuştur. |
| Test yapılması gerekiyor mu? | Evet | Build/Archive sırasında kod imzası (code signing) doğrulaması; NFC okuma/bağlantı kesintisi senaryoları; VideoCall sırasında video kalitesi davranışı; OCR kamera ekranı kılavuz görselleri test edilmelidir. |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
Kod İmzası (Code Signing) Paketleme Düzeltmesi
Bileşen: iOS SDK (Core) | Tür: Hata Düzeltmesi
Ne değişti? SDK paketinin kod imzasını (code signing) etkileyen bir paketleme sorunu giderilmiştir. Bu sorun yalnızca v2.1.2.7007 sürümünde bulunmaktaydı.
Müşteriyi etkiliyor mu? Evet. v2.1.2.7007 kullanan entegrasyonlar bu sorundan etkilenmiş olabilir.
Yapılması gereken: v2.1.2.7007 kullanıyorsanız SDK'yı v2.1.2.7008'e güncellemeniz gerekmektedir. v2.1.2.7006 veya önceki bir sürümden geçiş yapıyorsanız doğrudan v2.1.2.7008'e geçebilirsiniz.
İşlem yapılmazsa: v2.1.2.7007 kullanılmaya devam edilirse, build/archive veya dağıtım sırasında kod imzası doğrulamasıyla ilgili hatalarla karşılaşılabilir.
NFC Bağlantı Kesintisi Sonrası Otomatik Devam Etme
Bileşen: iOS SDK (NFC) | Tür: İyileştirme
Ne değişti? NFC ile pasaport/kimlik okuma sırasında, kart okuma tamamlanmadan bağlantı kısa süreliğine kesildiğinde (örneğin kartın telefondan hafifçe uzaklaşması durumunda) okumanın en baştan yeniden başlatılması gerekiyordu. Artık bu tür kısa süreli bağlantı kesintilerinde okuma kaldığı yerden otomatik olarak devam etmektedir.
Müşteriyi etkiliyor mu? Hayır. Değişiklik SDK tarafında otomatik devreye girer.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. NFC okuma akışının, özellikle kart okuma sırasında bağlantı kesintisi senaryolarını da içerecek şekilde test edilmesi önerilir.
VideoCall Otomatik Video Kalitesi Ayarlama Güvenilirliği
Bileşen: iOS SDK (VideoCall) | Tür: Hata Düzeltmesi
Ne değişti? Görüntülü görüşme sırasında ağ koşullarına göre otomatik devreye giren video kalitesi ayarlamasının bazı durumlarda çalışmayabildiği bir sorun giderilmiştir. Ayrıca, görüşme sırasında OCR veya yüz doğrulama gibi kamerayı kullanan adımlar çalışırken bu otomatik ayarlamanın geçici olarak durdurulup adım tamamlandığında kaldığı yerden devam etmesi sağlanmıştır.
Müşteriyi etkiliyor mu? Hayır. Değişiklik SDK tarafında otomatik devreye girer.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. VideoCall akışının, özellikle görüşme içinde OCR/yüz doğrulama adımlarıyla birlikte ve farklı ağ koşullarında test edilmesi önerilir.
OCR Kamera Ekranında Başlangıç Kılavuz Görseli Düzeltmesi
Bileşen: iOS SDK (OCR) | Tür: Hata Düzeltmesi
Ne değişti? OCR kamera ekranı açıldığında, bazı senaryolarda (örneğin arka yüz okuma başlatıldığında) ortadaki kılavuz görselinin ilgili adıma uygun olmayan bir görsel olarak gösterildiği bir sorun giderilmiştir.
Müşteriyi etkiliyor mu? Hayır. Değişiklik SDK tarafında otomatik devreye girer.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir.
4. Geçiş Adımları¶
- v2.1.2.7007 kullanıyorsanız SDK'yı v2.1.2.7008'e güncelleyin ve
pod installile bağımlılıklarınızı yenileyin. - Build/Archive sürecinizi çalıştırarak kod imzası (code signing) doğrulamasını tekrar test edin.
- NFC okuma, VideoCall ve OCR kamera akışlarını uçtan uca test edin.
5. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
v2.1.2.7007 Sürüm Notları — 24.09.2026¶
[IOS SDK] [NO CUSTOMER ACTION] [BACKWARD COMPATIBLE]
1. Sürüm Özeti¶
Bu sürümde, NFC ile pasaport/kimlik okuma sırasında kısa süreli bağlantı kesintileri artık otomatik olarak toparlanmakta ve okuma en baştan başlamak zorunda kalmadan devam edebilmektedir. Ayrıca görüntülü görüşme (VideoCall) sırasında otomatik video kalitesi ayarlamasının güvenilirliği artırılmış ve OCR kamera ekranındaki başlangıç kılavuz görseliyle ilgili bir görsel düzeltme yapılmıştır.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Koşullu | NFC okuma, VideoCall (otomatik video kalitesi) ve OCR kamera akışlarını kullanan entegrasyonlar davranış değişikliklerinden etkilenmektedir. |
| Müşteri aksiyonu gerekiyor mu? | Hayır | Değişiklikler SDK tarafında otomatik devreye girer. |
| Parametre veya konfigürasyon değişikliği var mı? | Hayır | Yeni veya kaldırılan bir parametre bulunmamaktadır. |
| Mevcut entegrasyonlarla uyumlu mu? | Evet | Geriye dönük API uyumluluğu korunmuştur. |
| Test yapılması gerekiyor mu? | Evet | NFC okuma/bağlantı kesintisi senaryoları, VideoCall sırasında video kalitesi davranışı (özellikle görüşme içinde OCR/yüz doğrulama ile birlikte) ve OCR kamera ekranı kılavuz görselleri test edilmelidir. |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
NFC Bağlantı Kesintisi Sonrası Otomatik Devam Etme
Bileşen: iOS SDK (NFC) | Tür: İyileştirme
Ne değişti? NFC ile pasaport/kimlik okuma sırasında, kart okuma tamamlanmadan bağlantı kısa süreliğine kesildiğinde (örneğin kartın telefondan hafifçe uzaklaşması durumunda) okumanın en baştan yeniden başlatılması gerekiyordu. Artık bu tür kısa süreli bağlantı kesintilerinde okuma kaldığı yerden otomatik olarak devam etmektedir.
Müşteriyi etkiliyor mu? Hayır. Değişiklik SDK tarafında otomatik devreye girer.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. NFC okuma akışının, özellikle kart okuma sırasında bağlantı kesintisi senaryolarını da içerecek şekilde test edilmesi önerilir.
VideoCall Otomatik Video Kalitesi Ayarlama Güvenilirliği
Bileşen: iOS SDK (VideoCall) | Tür: Hata Düzeltmesi
Ne değişti? Görüntülü görüşme sırasında ağ koşullarına göre otomatik devreye giren video kalitesi ayarlamasının bazı durumlarda çalışmayabildiği bir sorun giderilmiştir. Ayrıca, görüşme sırasında OCR veya yüz doğrulama gibi kamerayı kullanan adımlar çalışırken bu otomatik ayarlamanın geçici olarak durdurulup adım tamamlandığında kaldığı yerden devam etmesi sağlanmıştır.
Müşteriyi etkiliyor mu? Hayır. Değişiklik SDK tarafında otomatik devreye girer.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. VideoCall akışının, özellikle görüşme içinde OCR/yüz doğrulama adımlarıyla birlikte ve farklı ağ koşullarında test edilmesi önerilir.
OCR Kamera Ekranında Başlangıç Kılavuz Görseli Düzeltmesi
Bileşen: iOS SDK (OCR) | Tür: Hata Düzeltmesi
Ne değişti? OCR kamera ekranı açıldığında, bazı senaryolarda (örneğin arka yüz okuma başlatıldığında) ortadaki kılavuz görselinin ilgili adıma uygun olmayan bir görsel olarak gösterildiği bir sorun giderilmiştir.
Müşteriyi etkiliyor mu? Hayır. Değişiklik SDK tarafında otomatik devreye girer.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir.
4. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
v2.1.0.10 Sürüm Notları — 23.09.2026¶
[IOS SDK] [NO CUSTOMER ACTION] [BACKWARD COMPATIBLE]
1. Sürüm Özeti¶
Bu sürümde, NFC ile pasaport/kimlik okuma sırasında kısa süreli bağlantı kesintileri artık otomatik olarak toparlanmakta ve okuma en baştan başlamak zorunda kalmadan devam edebilmektedir.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Hayır | Değişiklik SDK tarafında otomatik devreye girer. |
| Müşteri aksiyonu gerekiyor mu? | Hayır | — |
| Parametre veya konfigürasyon değişikliği var mı? | Hayır | — |
| Mevcut entegrasyonlarla uyumlu mu? | Evet | — |
| Test yapılması gerekiyor mu? | Evet | NFC okuma sırasında bağlantı kesintisi senaryoları test edilmelidir. |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
NFC Bağlantı Kesintisi Sonrası Otomatik Devam Etme
Bileşen: iOS SDK (NFC) | Tür: İyileştirme
Ne değişti? NFC ile pasaport/kimlik okuma sırasında, kart okuma tamamlanmadan bağlantı kısa süreliğine kesildiğinde (örneğin kartın telefondan hafifçe uzaklaşması durumunda) okumanın en baştan yeniden başlatılması gerekiyordu. Artık bu tür kısa süreli bağlantı kesintilerinde okuma kaldığı yerden otomatik olarak devam etmektedir.
Müşteriyi etkiliyor mu? Hayır. Değişiklik SDK tarafında otomatik devreye girer.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. NFC okuma akışının, özellikle kart okuma sırasında bağlantı kesintisi senaryolarını da içerecek şekilde test edilmesi önerilir.
4. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
v2.1.2.7006 Sürüm Notları — 18.09.2026¶
[IOS SDK] [NO CUSTOMER ACTION] [BACKWARD COMPATIBLE]
1. Sürüm Özeti¶
Bu sürümde, görüntülü görüşme (VideoCall) sırasında yüz ve gülümseme tespitinin tepki süresi kısaltılmıştır.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Koşullu | VideoCall sırasında yüz/gülümseme tespiti özelliğini kullanan entegrasyonlar etkilenmektedir. |
| Müşteri aksiyonu gerekiyor mu? | Hayır | Değişiklik SDK tarafında otomatik devreye girer. |
| Parametre veya konfigürasyon değişikliği var mı? | Hayır | Yeni veya kaldırılan bir parametre bulunmamaktadır. |
| Mevcut entegrasyonlarla uyumlu mu? | Evet | Geriye dönük API uyumluluğu korunmuştur. |
| Test yapılması gerekiyor mu? | Evet | VideoCall sırasında yüz/gülümseme tespiti akışı ve cihaz performansı (CPU/pil tüketimi) test edilmelidir. |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
VideoCall Sırasında Yüz ve Gülümseme Tespiti Hız İyileştirmesi
Bileşen: iOS SDK (Face / VideoCall) | Tür: İyileştirme
Ne değişti? Görüntülü görüşme (VideoCall) sırasında yüz ve gülümseme tespitinin tepki süresi kısaltılmıştır.
Müşteriyi etkiliyor mu? Koşullu. Yalnızca VideoCall sırasında yüz/gülümseme tespiti özelliğini kullanan entegrasyonlar etkilenmektedir.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. VideoCall sırasında yüz/gülümseme tespiti akışının ve cihaz kaynak kullanımının (CPU/pil) uçtan uca test edilmesi önerilir.
4. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
v2.1.0.9 Sürüm Notları — 09.09.2026¶
[IOS SDK] [NO CUSTOMER ACTION] [BACKWARD COMPATIBLE]
1. Sürüm Özeti¶
Bu sürümde, Türkiye'de kullanılan TD1 formatlı kimlik kartlarının kameraya paralel tutulmaması durumunda oluşan düşük kaliteli görüntü yakalama sorunu giderilmiş ve yüz doğrulama (liveness) akışında birden fazla kişi tespit edildiğinde oturumun doğru şekilde başarısız sayılması sağlanmıştır.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Koşullu | TUR TD1 kimlik kartı OCR akışını ve yüz doğrulama (liveness) akışını kullanan entegrasyonlar davranış değişikliklerinden etkilenmektedir. |
| Müşteri aksiyonu gerekiyor mu? | Hayır | Değişiklikler SDK tarafında otomatik devreye girer. |
| Parametre veya konfigürasyon değişikliği var mı? | Hayır | Yeni veya kaldırılan bir parametre bulunmamaktadır; yalnızca dahili varsayılan değerler güncellenmiştir. |
| Mevcut entegrasyonlarla uyumlu mu? | Evet | Geriye dönük API uyumluluğu korunmuştur. |
| Test yapılması gerekiyor mu? | Evet | TUR TD1 kimlik kartı OCR akışı ve yüz doğrulama (özellikle birden fazla kişi senaryosu) test edilmelidir. |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
Türkiye TD1 Kimlik Kartı Okuma Kalitesi Düzeltmesi
Bileşen: iOS SDK (OCR) | Tür: Hata Düzeltmesi
Ne değişti? Türkiye'de kullanılan TD1 formatlı kimlik kartlarının kameraya paralel tutulmaması durumunda düşük kaliteli görüntü yakalanabilmesine neden olan sorun giderilmiştir.
Müşteriyi etkiliyor mu? Koşullu. Yalnızca TUR TD1 kimlik kartı OCR akışını kullanan entegrasyonlar etkilenmektedir.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. TUR TD1 kimlik kartı okuma akışının uçtan uca test edilmesi önerilir.
Yüz Doğrulama Akışında Çoklu Yüz Tespiti ve Kararlılık Düzeltmesi
Bileşen: iOS SDK (Face) | Tür: Hata Düzeltmesi
Ne değişti? Yüz doğrulama (liveness) akışında kamerada birden fazla yüz algılandığında oturumun açıkça başarısız olarak sonlandırılması sağlanmıştır. Ayrıca doğrulama tamamlandıktan veya başarısız olduktan sonra gereksiz kare işlenmesine yol açan bir mantık hatası giderilmiş, olası çift hata tetiklenmesi önlenmiştir.
Müşteriyi etkiliyor mu? Evet. Kamerada birden fazla kişi bulunması durumunda entegrasyon artık faceDetectFailed hata callback'ini alacaktır.
Yapılması gereken: Uygulamanızın mevcut faceDetectFailed hata callback akışını doğru şekilde işlediğinden emin olunması önerilir; ek bir implementasyon değişikliği gerekmemektedir.
4. Versiyon ve Uyumluluk¶
| Bileşen | Önceki Versiyon | Yeni Versiyon | Minimum Gereksinim |
|---|---|---|---|
| GoogleMLKit/FaceDetection (CocoaPods bağımlılığı) | 7.0.0 | 4.0.0 | Bağımlılık bilgisi doğrulanıyor |
| iOS Minimum Deployment Target | iOS 15.5 | iOS 14.0 | — |
Bağımlılık bilgisi doğrulanıyor: Bu sürüm aralığında SDK'nın dahili CocoaPods bağımlılığı (GoogleMLKit/FaceDetection) ve minimum iOS deployment target değeri değişmiştir. Bu değişikliğin kasıtlı bir sürüm kararı mı yoksa geliştirme sürecindeki bir dal (branch) entegrasyonundan kalan bir yapılandırma farkı mı olduğu geliştirici ekip tarafından teyit edilmelidir; teyit sonrası müşteri aksiyonu gerekip gerekmediği netleşecektir.
5. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
v2.1.2.7005 Sürüm Notları — 03.09.2026¶
[IOS SDK] [NO CUSTOMER ACTION] [BACKWARD COMPATIBLE]
1. Sürüm Özeti¶
Bu sürümde, NFC ile pasaport/kimlik okuma sürecinde art arda yapılan yeniden deneme (retry) senaryolarında oluşabilen bir kararlılık sorunu giderilmiş ve daha önce entegratöre hiç bildirilmeyen bazı hata senaryoları artık nfcFailed callback'i üzerinden raporlanır hale getirilmiştir.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Koşullu | NFC ile pasaport/kimlik okuma akışını kullanan entegrasyonlar davranış değişikliklerinden etkilenmektedir. |
| Müşteri aksiyonu gerekiyor mu? | Hayır | Değişiklikler SDK tarafında otomatik devreye girer. |
| Parametre veya konfigürasyon değişikliği var mı? | Hayır | Yeni veya kaldırılan bir parametre bulunmamaktadır. |
| Mevcut entegrasyonlarla uyumlu mu? | Evet | Delegate arayüzünde değişiklik yoktur; geriye dönük uyumludur. |
| Test yapılması gerekiyor mu? | Evet | NFC okuma, art arda yeniden deneme (retry) ve hata senaryoları test edilmelidir. |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
NFC Okuma Yeniden Deneme Kararlılığı Düzeltmesi
Bileşen: iOS SDK (NFC) | Tür: Hata Düzeltmesi
Ne değişti? NFC ile pasaport/kimlik okuma sürecinde, bir önceki okuma denemesinin hemen ardından yeniden okuma başlatıldığında bazı durumlarda oluşabilen okuma başarısızlığı sorunu giderilmiştir.
Müşteriyi etkiliyor mu? Koşullu. Yalnızca NFC okuma ve yeniden deneme (retry) akışını kullanan entegrasyonlar etkilenmektedir.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir. NFC okuma ve art arda yeniden deneme senaryolarının uçtan uca test edilmesi önerilir.
NFC Okumada Bildirilmeyen Hata Senaryolarının Giderilmesi
Bileşen: iOS SDK (NFC) | Tür: Hata Düzeltmesi
Ne değişti? NFC ile pasaport/kimlik okuma sürecinde, daha önce entegratöre herhangi bir hata bildirimi yapılmadan sessizce sonlanabilen bazı hata senaryolarında artık nfcFailed callback'i tetiklenmektedir.
Müşteriyi etkiliyor mu? Evet. Daha önce bu senaryolarda hiçbir callback tetiklenmediği için akış kullanıcı arayüzünde belirsiz kalabiliyordu; artık bu senaryolar da nfcFailed(error:) üzerinden bildirilmektedir.
Yapılması gereken: Uygulamanızın mevcut nfcFailed(error:) callback akışını doğru şekilde işlediğinden emin olunması önerilir; ek bir implementasyon değişikliği gerekmemektedir.
4. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
v2.1.2.7004 Sürüm Notları — 25.08.2026¶
[IOS SDK] [NO CUSTOMER ACTION] [BACKWARD COMPATIBLE]
1. Sürüm Özeti¶
Bu sürümde, Türkiye Cumhuriyeti kimlik kartlarının (TD1) OCR ile okunmasında isim satırı ayrıştırmasında bir hata giderilmiş; NFC ile pasaport/kimlik okuma sürecinde MRZ ve ek kişisel veri alanından gelen ad/soyad bilgilerine ayrı ayrı erişim imkanı eklenmiştir.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Hayır | Mevcut davranış korunmaktadır |
| Müşteri aksiyonu gerekiyor mu? | Hayır | — |
| Parametre veya konfigürasyon değişikliği var mı? | Evet | Yeni, opsiyonel public alanlar eklendi |
| Mevcut entegrasyonlarla uyumlu mu? | Evet | — |
| Test yapılması gerekiyor mu? | Hayır | — |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
Türkiye Cumhuriyeti Kimlik Kartı (TD1) İsim Satırı Okuma Düzeltmesi
Bileşen: iOS SDK (OCR) | Tür: Hata Düzeltmesi
Ne değişti? TD1 formatındaki kimlik kartlarında, isim alanının bazı senaryolarda (kısaltılmış/baş harflere indirgenmiş isimler) okunamaması sorunu giderilmiştir.
Müşteriyi etkiliyor mu? Hayır.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir.
NFC ile Okunan Ad/Soyad Bilgilerine Kaynak Bazlı Erişim
Bileşen: iOS SDK (NFC) | Tür: Yeni Özellik
Ne değişti? NFC ile pasaport/kimlik okuma sonucunda dönen müşteri çip verisine, MRZ alanından ve ek kişisel veri alanından gelen ad/soyad bilgilerine ayrı ayrı erişilebilecek yeni alanlar eklenmiştir.
Müşteriyi etkiliyor mu? Koşullu. Yalnızca bu bilgileri ayrı kaynaklardan okumak isteyen entegrasyonları ilgilendirir.
Yapılması gereken: Kullanmak isteyen ekipler, NFC sonucu dönen müşteri çip nesnesinden getDg1Name(), getDg1Surname(), getDg11Name(), getDg11Surname() alanlarını okuyabilir. Kullanmak istemeyen entegrasyonlarda değişiklik gerekmemektedir.
4. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
v2.1.0.8 Sürüm Notları — 12.08.2026¶
[IOS SDK] [NO CUSTOMER ACTION] [BACKWARD COMPATIBLE]
1. Sürüm Özeti¶
Bu sürümde, yüz doğrulama akışında kullanılan ilerleme göstergesiyle ilgili bir görsel düzeltme yapılmıştır.
2. Müşteri Etkisi¶
| Kontrol | Durum | Açıklama |
|---|---|---|
| Implementasyonu etkiliyor mu? | Hayır | Değişiklik SDK tarafında otomatik devreye girer |
| Müşteri aksiyonu gerekiyor mu? | Hayır | — |
| Parametre veya konfigürasyon değişikliği var mı? | Hayır | — |
| Mevcut entegrasyonlarla uyumlu mu? | Evet | — |
| Test yapılması gerekiyor mu? | Hayır | — |
| Geçiş için son tarih var mı? | Hayır | — |
3. Değişiklikler¶
Yüz Konumlandırma Sırasında İlerleme Göstergesi Güncelleme Düzeltmesi
Bileşen: iOS SDK (Face) | Tür: Hata Düzeltmesi
Ne değişti? Kullanıcının yüzü kamera merkezinin dışına çıktığında ilerleme göstergesinin kırmızıya dönmesi gereken bazı senaryolarda bu görsel güncellemenin gerçekleşmediği bir hata giderilmiştir.
Müşteriyi etkiliyor mu? Hayır.
Yapılması gereken: Herhangi bir implementasyon veya konfigürasyon değişikliği gerekmemektedir.
4. Bilinen Sorunlar¶
Bilinen sorun bulunmamaktadır.
Yeni bir sürüme geçmeden önce "İmplementasyonu Etkiliyor mu?" alanını kontrol edin.
v2.1.2.7003¶
| Alan | Değer |
|---|---|
| Versiyon: | v2.1.2.7003 |
| Yayın Tarihi: | 2026-07-28 |
| Breaking Change: | ❌ |
| Deprecation Planı: | ❌ |
📝 Değişiklikler¶
Core¶
- Sectigo Root Certificate Desteği: SSL sertifika doğrulama altyapısına, cihaza gömülü Sectigo kök sertifikası üzerinden ek bir doğrulama katmanı eklenmiştir. Bu geliştirme, v2.1.2.0 ile eklenen Public Key SSL Pinning desteğini tamamlayıcı niteliktedir.
OCR¶
- Canada AAMVA Driver Licence Desteği: Kanada sürücü belgelerinin (AAMVA standardına uygun) okunması ve doğrulanması için yeni bir doküman işleme stratejisi eklenmiştir.
- Kıbrıs (Cyprus) Kimlik Kartı Düzeltmeleri: Kıbrıs kimlik kartlarında bazı senaryolarda yaşanan hata ve kart numarasının set edilememesi sorunları giderilmiştir.
VideoCall¶
- PiP (Picture in Picture) Mod Düzeltmesi: Kullanıcı PiP modundan uygulamaya geri döndüğünde, PiP modunun aktif kalmaya devam etmesine neden olan hata giderilmiştir.
Face¶
- Kararlılık ve Performans İyileştirmeleri: Yüz doğrulama modülünde aralıklı (intermittent) uygulama çökmelerine neden olan hata giderilmiş, bellek (RAM) tüketimi yaklaşık %49 oranında azaltılmış ve yanlış pozitif (false-trigger) tespit senaryoları iyileştirilmiştir.
🔧 İmplementasyonu Etkiliyor mu?¶
Hayır — Bu sürümdeki tüm değişiklikler SDK tarafında otomatik olarak devreye girer, implementasyon tarafında zorunlu bir değişiklik gerekmez.
Yine de Kanada sürücü belgesi okuma, SSL bağlantı senaryoları, Kıbrıs kimlik okuma, VideoCall PiP geçişleri ve yüz doğrulama akışının regresyon testine dahil edilmesi önerilir.
⚠️ Breaking Changes¶
Bu sürümde breaking change bulunmamaktadır.
v2.1.2.0¶
| Alan | Değer |
|---|---|
| Versiyon: | v2.1.2.0 |
| Yayın Tarihi: | 2026-06-23 |
| Breaking Change: | ❌ |
| Deprecation Planı: | Google MLKit v4.0.0 içeren sürümler |
📝 Değişiklikler¶
Core¶
- Gelişmiş SSL Sertifika Doğrulama Çözümleri: Mevcut Base64 string ve gömülü (embedded)
.dersertifika doğrulama yöntemlerine ek olarak, Public Key (Açık Anahtar) ile sertifika doğrulama (SSL Pinning) desteği entegre edilmiştir.
OCR¶
- Gelişmiş Hizalama (Alignment) Algoritması: Yeni altyapıya geçişle birlikte, kameradan alınan görüntülerin açısal bozukluklarını otomatik olarak düzelten ve kimlik tanıma süreçlerinin bu optimize edilmiş görsellerle devam etmesini sağlayan hizalama iyileştirmeleri yapılmıştır.
- Güvenlik Öğeleri ve Görsel Katman Ayrıştırma: Kimlik üzerindeki güvenlik unsurları ile temel kimlik görsellerinin birbirinden ayrıştırılması sağlanarak, doğrulama ve veri doğruluk kontrol süreçleri derinleştirilmiştir.
- Performans ve Kaynak Optimizasyonu: Kamera çerçeve (frame) ve iş parçacığı (thread) yönetimi yeniden yapılandırılmış; bu sayede cihaz kaynaklarının (CPU/RAM) tüketimi minimize edilmiştir.
- Metin Tanıma (OCR) Doğruluğu: Kimlik üzerinde yer alan karakterlerin ve metin alanlarının okunma sürecinde doğruluk (accuracy) ve hız iyileştirmeleri gerçekleştirilmiştir.
VideoCall¶
- Uzaktan Flaş Kontrolü Yetkinliği: Görüntülü görüşme sırasında müşteri temsilcisi tarafından tetiklenebilen, son kullanıcı onayı mekanizmasıyla çalışan "cihaz flaşı açma/kapama" fonksiyonu modüle dahil edilmiştir.
🔧 İmplementasyonu Etkiliyor mu?¶
Evet — Yeni özelliklerden bazıları ekipler tarafından aksiyon gerektirir.
- Core / SSL Pinning: Public Key ile SSL Pinning kullanmak isteyen ekipler Core yapılandırmasında sertifika doğrulama yöntemini Public Key destekleyecek şekilde güncellemelidir. Mevcut Base64 string veya embedded
.dersertifika doğrulama yöntemini kullanan ekipler için zorunlu bir değişiklik yoktur. - OCR hizalama ve görsel güvenlik iyileştirmeleri: OCR modülünü kullanan ekiplerin ek bir kod değişikliği yapması beklenmez; ancak kimlik ön/arka yüz okuma, güvenlik öğesi doğrulama, hata senaryoları ve düşük ışık/açılı çekim senaryoları uçtan uca test edilmelidir.
- OCR performans optimizasyonları: Kamera frame/thread yönetimi SDK tarafında optimize edildiği için implementasyon tarafında aksiyon gerekmez. Yine de uygulama içi kamera izinleri, akış geçişleri ve farklı cihaz performansları regresyon testine dahil edilmelidir.
- VideoCall uzaktan flaş kontrolü: Bu özelliği kullanacak ekipler VideoCall akışında temsilci tarafından gönderilen flaş açma/kapama talebinin kullanıcı onayıyla yönetildiğini doğrulamalıdır. Uygulama tarafında kamera/flaş izinleri, kullanıcı onay ekranı davranışı ve görüşme sırasında flaş durumunun doğru güncellenmesi test edilmelidir.
⚠️ Breaking Changes¶
Bu sürümde breaking change bulunmamaktadır.
v2.1.0.0¶
| Alan | Değer |
|---|---|
| Versiyon: | v2.1.0.0 |
| Yayın Tarihi: | 2026-01-23 |
| Breaking Change: | ❌ |
| Deprecation Planı: | ❌ |
📝 Değişiklikler¶
➕ Added¶
1) VideoCall – PiP (Picture in Picture) Desteği¶
VideoCall sırasında kullanıcı uygulamayı arka plana aldığında PiP mode devreye girecek şekilde destek eklendi.
Amaç: Görüntülü görüşme deneyiminin arka planda da sürdürülebilmesi.
2) ModelV4 Servisi – Model Yönetimi ve Backoffice Senkronizasyonu¶
ModelV4 servisi eklendi.
Model dosyasının cihaza gömülü gelmesi ve gerekli senaryolarda Backoffice üzerinden indirilebilmesi sağlandı.
Model V4 geliştirmeleri kapsamında:
- threshold değerleri
- mandatory kontroller
- ve benzeri model davranışlarının yönetimi güçlendirildi.
Artık görsel güvenlik öğeleri analizleri ve threshold değerleri Backoffice üzerinden değiştirilebilir hale getirildi.
3) SDK Sesleri – Cihaza Gömme + Backoffice Sync¶
SDK’da kullanılan ses dosyaları cihaza gömüldü.
Backoffice tarafında ilgili ses güncellenirse, cihazın Backoffice ile sync olmasını sağlayan mekanizma eklendi.
4) NFC Sertifikası – Cihaza Gömme + Backoffice Sync¶
NFC sertifikası cihaza eklendi.
Backoffice tarafındaki güncellemelerle cihazın sync durumunu yöneten kod eklendi.
5) Base Model – useEmbeddedLocalSound Parametresi (Global Ses Yönetimi)¶
Tüm modüller tarafından kullanılabilen şekilde Base Model’e useEmbeddedLocalSound: NSNumber parametresi eklendi.
Bu parametre sayesinde:
- Projeye gömülü (embedded) ses dosyaları varsa bunların öncelikli olarak kullanılması garanti altına alındı.
- Gereksiz Backoffice / network üzerinden ses dosyası indirme isteklerinin önüne geçildi.
6) Hold (Bekleme) Videosu¶
Agent Request delegate’i üzerinden artık temsilcinin kamerayı açma ve kapatma durumu takip edilebilmektedir.
Temsilci kamerayı açtığında .camOpen, kapattığında ise .camClose case’leri delegate aracılığıyla iletilir.
Bu mekanizma sayesinde temsilci kamerası kapalıyken müşteriye bekleme (hold) videosu gösterilebilir. Temsilci kamerayı tekrar açtığında ise bekleme videosu otomatik olarak kapatılarak görüşme yeniden canlı olarak devam ettirilebilir.
🔁 Changed¶
- Görsel analiz davranışları (özellikle güvenlik öğeleri ve threshold kontrolleri) daha dinamik hale getirildi; yönetim Backoffice tarafına taşındı (ModelV4 altyapısı ile).
🛠 Fixed¶
- Verbal Consent ekranı için UI düzeltmeleri ve iyileştirmeleri yapıldı.
- NFC akışında uygulama arka plana atıldığında, güvenlik gerekçesiyle işlemin durdurulması sağlandı.
- Çeşitli performans iyileştirmeleri ve hata düzeltmeleri yapıldı.
❌ Removed¶
Bu sürümde kaldırılan bir public API / fonksiyon bulunmamaktadır.
⚠️ Breaking Changes¶
Bu sürümde breaking change bulunmamaktadır.
🔧 İmplementasyonu Etkiliyor mu?¶
Evet — Yeni özellikleri kullanmak isteyen ekipler için aksiyon gerekli.
- PiP: VideoCall modülüne PiP delegate'lerinin eklenmesi gerekiyor. Detay için VideoCall Modülü → PiP sayfasına bakınız.
useEmbeddedLocalSound: Kullanmak isteyen ekipler Base Model'e parametre eklemeli. Zorunlu değil; eklenmezse mevcut davranış değişmez.- Hold videosu:
.camOpen/.camCloseevent'lerini kullanmak isteyen ekipler Agent Request delegate'ini güncellemeli. Zorunlu değil. - ModelV4, sesler, NFC sertifikası: Implementasyon tarafında değişiklik gerekmez; SDK otomatik yönetir.
v2.0.6.4¶
| Alan | Değer |
|---|---|
| Versiyon: | v2.0.6.4(-s,.5) |
| Yayın Tarihi: | 2026-01-08 |
| Tür: | PATH |
| Breaking Change: | ❌ |
| Deprecation Planı: | ❌ |
📝 Değişiklikler¶
1️⃣ VideoCall İçerisinde OCR & Face Tekrarlatma Akışı¶
1.1 Genel Akış¶
VideoCall süreci devam ederken Agent, OCR veya Face doğrulama adımlarının tekrarlanmasını isteyebilir.
Bu durumda ilgili retry akışı SDK tarafından otomatik olarak başlatılır.
1.2 Fail Durumu¶
OCR veya Face retry işlemi Fail durumuna düşerse:
- Kullanıcıya, doğrulama işlemini kendi isteğiyle yeniden başlatabilme imkânı sunulur.
1.3 Retry Fonksiyonları¶
SDK’ya aşağıdaki iki yeni fonksiyon eklenmiştir:
EnQualifyVideoCall.ocrRetry()\nEnQualifyVideoCall.faceRetry()\nEnQualifyVideoCall.nfcRetry()
📌 Kullanım Kuralları
- Bu fonksiyonlar yalnızca aktif bir VideoCall oturumu içerisindeyken çağrılabilir.
- VideoCall dışında çağrılmaları desteklenmez.
1.4 Delegate Akışı¶
Retry fonksiyonu çağrıldıktan sonra SDK tarafından aşağıdaki delegate metotları tetiklenir:
➡️ Bu delegate’lerin implementasyon tarafında karşılanması zorunludur.
2️⃣ Diğer İyileştirmeler & Fixler¶
- BackOffice’te Rotate / Cancel butonları false olarak ayarlandığında, Rotate butonuna basılınca butonların tamamen kaybolmasına neden olan problem giderildi.
- BackOffice tarafından eksik gönderilen loglar tespit edilerek SDK’ya eklendi.
- WiFi ↔ Hücresel ağ geçişleri sırasında oluşan timer problemleri giderildi.
- CallBusinessUID ve businessReference değerlerinin doğru şekilde setlenmesi sağlandı.
🔧 İmplementasyonu Etkiliyor mu?¶
Evet — VideoCall içinde retry akışı kullanacak ekipler için aksiyon gerekli.
Retry fonksiyonları çağrıldıktan sonra aşağıdaki delegate'lerin implement edilmesi zorunludur:
swift
Retry özelliğini kullanmayacaksanız mevcut implementasyonunuzda değişiklik gerekmez.
v2.0.6.2¶
| Alan | Değer |
|---|---|
| Versiyon: | v2.0.6.2 |
| Yayın Tarihi: | 2025-12-08 |
| Tür: | PATH |
| Breaking Change: | ❌ |
| Deprecation Planı: | ❌ |
📝 Değişiklikler¶
🔁 Changed¶
agentRequest(event: VideoCallMoudule.AgentRequestEvent) delegesi aşağıdaki şekilde değiştirilmiştir:
agentRequest(\n event: VideoCallMoudule.AgentRequestEvent,\n lastEvent: VideoCallMoudule.AgentRequestEvent\n)
➕ Added¶
NFC modülüne yeni bir durdurma fonksiyonu olan aşağıdaki method eklenmiştir:
❌ Removed¶
Aşağıdaki fonksiyon VideoCall modülünden tamamen kaldırılmıştır:
🔧 İmplementasyonu Etkiliyor mu?¶
Evet — Bu sürüme geçmeden önce aşağıdaki iki değişikliği yapmanız gerekiyor.
1. VideoCall Modülü Güncellemeleri¶
1.1. Kaldırılan Fonksiyon¶
Aşağıdaki fonksiyon VideoCall modülünden tamamen kaldırılmıştır:
Gerekçe:
Artık VideoCall ekranındaki butonların görünürlüğü Back Office tarafından dinamik olarak yönetilecektir. Bu nedenle SDK tarafında manuel görünürlük kontrolü kaldırılmıştır.
1.2. Güncellenen Delegate Yapısı¶
Eski delegate:
Yeni delegate:
agentRequest(\n event: VideoCallMoudule.AgentRequestEvent,\n lastEvent: VideoCallMoudule.AgentRequestEvent\n)
Açıklama:
Yeni delegate yapısı ile bir önceki event’e erişim sağlanmaktadır.
2. NFC Modülü Güncellemeleri¶
2.1. NFC Durdurma Fonksiyonu¶
NFC modülüne yeni bir durdurma fonksiyonu eklenmiştir:
Fonksiyonun Amacı¶
Başlatılmış olan bir NFC session'ını, belirli geçiş senaryolarında güvenli bir şekilde sonlandırmayı sağlar.
Kullanım Senaryosu (Önemli)¶
Aşağıdaki durum gerçekleştiğinde bu fonksiyon kullanılmalıdır:
- VideoCall sırasında Agent, kullanıcıya bir NFC tekrar okutma (retry) talebi gönderir.
- NFC işlemi henüz devam ederken
BackToVideoCallişlemi tetiklenir. agentRequest(event:lastEvent:)delegesi üzerinden kontrol yapılır:
- NFC hâlen aktif durumda ise aşağıdaki fonksiyon çağırılmalıdır:
v2.0.2.5¶
| Alan | Değer |
|---|---|
| Versiyon: | v2.0.2.5 |
| Yayın Tarihi: | 2025-08-26 |
| Tür: | PATH |
| Breaking Change: | ❌ |
| Deprecation Planı: | ❌ |
📝 Değişiklikler¶
🔁 Changed¶
GoogleMLKitFaceDetection v7.0.0olarak derlenen hali.
➕ Added¶
Bu sürümde eklenen yeni bir özellik bulunmamaktadır.
❌ Removed¶
Bu sürümde kaldırılan bir yapı bulunmamaktadır.
⚠️ Breaking Changes¶
Bu sürümde breaking change bulunmamaktadır.
🔀 Migrasyon Rehberi¶
Ne değişti¶
Bu sürüm özelinde GoogleMLKitFaceDetection v7.0.0 güncellemesi yapılmıştır.
🔧 İmplementasyonu Etkiliyor mu?¶
Hayır — Implementasyon tarafında değişiklik gerekmez.
v2.0.2.3¶
| Alan | Değer |
|---|---|
| Versiyon: | v2.0.2.3 |
| Yayın Tarihi: | 2025-08-21 |
| Tür: | PATH |
| Breaking Change: | ❌ |
| Deprecation Planı: | ❌ |
📝 Değişiklikler¶
🔁 Changed¶
- Camera Preview View'ın garbage olarak kalan layer'ı işlem sonunda remove edildi.
➕ Added¶
Bu sürümde eklenen yeni bir özellik bulunmamaktadır.
❌ Removed¶
Bu sürümde kaldırılan bir yapı bulunmamaktadır.
⚠️ Breaking Changes¶
Bu sürümde breaking change bulunmamaktadır.
🔀 Migrasyon Rehberi¶
Ne değişti¶
Camera Preview ekranı ile ilgili cross platform müşterilerinin etkilendiği bir layer kaldırıldı.
🔧 İmplementasyonu Etkiliyor mu?¶
Hayır — Implementasyon tarafında değişiklik gerekmez. İşlem sonlandırmalarında ve ekran geçişlerinde kullanıcı etkileşimini test etmeniz önerilir.
v2.0.2.2¶
| Alan | Değer |
|---|---|
| Versiyon: | v2.0.2.2 |
| Yayın Tarihi: | 2025-08-18 |
| Tür: | PATH |
| Breaking Change: | ❌ |
| Deprecation Planı: | ❌ |
📝 Değişiklikler¶
🔁 Changed¶
CustomerIdentityDociçerisinde bulunan "Cinsiyet" bilgisinin edinilme yeri ön yüzden alınırken, bu bilginin arka yüzden alınması sağlandı.
➕ Added¶
Bu sürümde eklenen yeni bir özellik bulunmamaktadır.
❌ Removed¶
Bu sürümde kaldırılan bir yapı bulunmamaktadır.
⚠️ Breaking Changes¶
Bu sürümde breaking change bulunmamaktadır.
🔀 Migrasyon Rehberi¶
Ne değişti¶
CustomerIdentityDoc içerisindeki "Cinsiyet" bilgisinin okunma kaynağı güncellendi.
🔧 İmplementasyonu Etkiliyor mu?¶
Hayır — Değişiklik SDK tarafında. Implementasyon tarafında yapılacak bir şey yok.
v2.0.2.1¶
| Alan | Değer |
|---|---|
| Versiyon: | v2.0.2.1 |
| Yayın Tarihi: | 2025-08-12 |
| Tür: | PATH |
| Breaking Change: | ❌ |
| Deprecation Planı: | ❌ |
📝 Değişiklikler¶
🔁 Changed¶
OCR & IDVerification¶
- OCR ve IDVerification tanımlama yapısı tamamen database üzerinden alınacak config yapılandırmasına göre yapıldı.
- Türkiye Cumhuriyeti TD1 Kimlikleri özelinde iyileştirmeler ve ek doğrulamalar yapıldı.
- Görsel Öğelerin analizi ve alınan fotoğraflar ile ilgili iyileştirmeler sağlandı.
Near Field Communication (NFC)¶
- Thermal Heat Detection eklendi ve NFC yapılmadan önce ve esnasında 4 sn aralıklar ile cihaz ısısı takip edildi.
- İşlem esnasında, hata anında ve öncesinde loglama detaylandırıldı.
Face Detection & Liveness Verification¶
- Canlılık esnasında uygulamanın arka plana alınıp ön plana alınmasıdan doğan hatalar giderildi
- Canlılık esnasında sesli yönlendirmeler ile hareket senkronizasyonunda uyum sağlandı.
- Canlılık esnasında kullanıcının ekranda gördüğü ilerleme görseli optimize hale getirildi.
- Arka Plan & Ön Plana alındıktan sonra hata sayfasının birden fazla kez tetiklenmesinin önüne geçildi
- Canlılık esnasında tutulan stateler daha detaylı hale getirildi ve hata sonrasında sıfırlanması sağlandı.
- Canlılık esnasında alınan hata sonrasında tekrar edilen işlem için kayıt edilen veriler temizlendi.
- Canlılık adımı sonrası başarılı işlem sonrasında yapılan tekrarlatma işlemi için kayıt edilen veriler temizlendi
VideoCall¶
- Görüntülü görüşmeye bağlanıldıktan sonra live log'u atılması ile ilgili geliştirmeler yapıldı.
Core¶
- Network tarafındaki loglar üzerinde iyileştirmeler yapıldı.
- Thermal Heat Detection yapacak State Manager eklendi.
➕ Added¶
OCR & IDVerification¶
- Config dosyası ile birlikte ülke ve bölgeye özel yapılandırma getirildi
Face Detection & Liveness Verification¶
- Self Service yapacak olan müşteriler için yüz tanıma ve canlılık esnasında video recording yapısı eklendi.
Utility Module¶
- EnQualify Utility Module eklendi, akışların dışarısında kalan akışlardan önce ve sonra yapılması planlanan EnQualify v2.0 özellikleri bu modül üzerinden yönetilecek hale getirildi.
- Şimdiye kadar yazılmış olan Appointment, CallType, DocumentAdd vb. gibi fonksiyonlar bu modüle üzerine taşındı ve completion yapısı üzerinden haberleşme sağlandı.
- Document Signing özelliği bu modüle üzerine eklendi
❌ Removed¶
- EnQualify OCR & NFC & Face & VideoCall modülleri içerisinde bulunan ve Utility Modüle'e geçirilen fonksiyonlar ve beraberindeki delegate metodları kaldırıldı.
⚠️ Breaking Changes¶
idDocTypeCheckVerifieddelegesinde yapılan değişiklikleridDocFrontVerifieddelegesinde yapılan değişiklikler
🔧 İmplementasyonu Etkiliyor mu?¶
Evet — Utility Module eklenmesi nedeniyle mevcut implementasyonlarda güncelleme gerekiyor.
OCR, NFC, Face ve VideoCall modüllerinden kaldırılan fonksiyon ve delegate'ler Utility Module'e taşındı. Etkilenen başlıca alanlar:
idDocTypeCheckVerifieddelegate'i değiştiidDocFrontVerifieddelegate'i değişti- Appointment, CallType, DocumentAdd vb. fonksiyonlar artık
EnQualifyUtilityüzerinden çağrılmalı
Detaylı kullanım için Utility Modülü sayfasına bakınız.
🧪 Test Yapılırken Dikkat Edilmesi Gerekenler¶
- Akış uçtan uca test edilmeli.