iOS - SDK Sürüm Notları¶

Yeni bir sürüme geçmeden önce "İmplementasyonu Etkiliyor mu?" alanını kontrol edin.

v2.1.2.7003¶

📝 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¶

📝 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¶

📝 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¶

📝 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()
EnQualifyVideoCall.faceRetry()
EnQualifyVideoCall.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:

ocrRetryRequested()
faceRetryRequested()
nfcRetryRequested()

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

ocrRetryRequested()
faceRetryRequested()
nfcRetryRequested()

Retry özelliğini kullanmayacaksanız mevcut implementasyonunuzda değişiklik gerekmez.

v2.0.6.2¶

📝 Değişiklikler¶

🔁 Changed¶

agentRequest(event: VideoCallMoudule.AgentRequestEvent) delegesi aşağıdaki şekilde değiştirilmiştir:

agentRequest(
    event: VideoCallMoudule.AgentRequestEvent,
    lastEvent: VideoCallMoudule.AgentRequestEvent
)

➕ Added¶

NFC modülüne yeni bir durdurma fonksiyonu olan aşağıdaki method eklenmiştir:

EnQualifyNFC.nfcStopForBacktoVideoCall()

❌ Removed¶

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

setupCallLayout(
    showRotateButton: Bool,
    showCancelButton: Bool
)

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

setupCallLayout(
    showRotateButton: Bool,
    showCancelButton: Bool
)

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:

agentRequest(event: VideoCallMoudule.AgentRequestEvent)

Yeni delegate:

agentRequest(
    event: VideoCallMoudule.AgentRequestEvent,
    lastEvent: VideoCallMoudule.AgentRequestEvent
)

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:

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:

event == .BackToVideoCall
lastEvent == .NFC

1. NFC hâlen aktif durumda ise aşağıdaki fonksiyon çağırılmalıdır:

EnQualifyNFC.nfcStopForBacktoVideoCall()

v2.0.2.5¶

📝 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¶

📝 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¶

📝 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¶

📝 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.