Ana içeriğe geç

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ı

  1. Bu SDK sürümü için gereken minimum Backend sürümünü doğrulayın.
  2. SDK sürümünü yükseltin.
  3. VideoCall kullanıyorsanız videoCallFailed(_:) callback'inizde .failedToStartPiPMode değerini ele alın.
  4. 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ı

  1. SPM bağımlılığınızı v2.1.0.7012-s sürümüne güncelleyin.
  2. 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ı

  1. v2.1.2.7007 kullanıyorsanız SDK'yı v2.1.2.7008'e güncelleyin ve pod install ile bağımlılıklarınızı yenileyin.
  2. Build/Archive sürecinizi çalıştırarak kod imzası (code signing) doğrulamasını tekrar test edin.
  3. 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) .der sertifika 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 .der sertifika 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 / .camClose event'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:

Text Only
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:

Text Only
ocrRetryRequested()\nfaceRetryRequested()\nnfcRetryRequested()

➡️ 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

Text Only
ocrRetryRequested()\nfaceRetryRequested()\nnfcRetryRequested()

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:

Text Only
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:

Text Only
EnQualifyNFC.nfcStopForBacktoVideoCall()

❌ Removed

Aşağıdaki fonksiyon VideoCall modülünden tamamen kaldırılmıştır:

Text Only
setupCallLayout(\n    showRotateButton: Bool,\n    showCancelButton: Bool\n)

🔧 İ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:

Text Only
setupCallLayout(\n    showRotateButton: Bool,\n    showCancelButton: Bool\n)

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:

Text Only
agentRequest(event: VideoCallMoudule.AgentRequestEvent)

Yeni delegate:

Text Only
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:

Text Only
EnQualifyNFC.nfcStopForBacktoVideoCall()

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:

  1. VideoCall sırasında Agent, kullanıcıya bir NFC tekrar okutma (retry) talebi gönderir.
  2. NFC işlemi henüz devam ederken BackToVideoCall işlemi tetiklenir.
  3. agentRequest(event:lastEvent:) delegesi üzerinden kontrol yapılır:
Text Only
event == .BackToVideoCall\nlastEvent == .NFC
  1. NFC hâlen aktif durumda ise aşağıdaki fonksiyon çağırılmalıdır:
Text Only
EnQualifyNFC.nfcStopForBacktoVideoCall()

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.0 olarak 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

  • CustomerIdentityDoc iç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

  • idDocTypeCheckVerified delegesinde yapılan değişiklikler
  • idDocFrontVerified delegesinde 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:

  • idDocTypeCheckVerified delegate'i değişti
  • idDocFrontVerified delegate'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.