Ana içeriğe geç

iOS - NFC Modülü

Giriş

NFC Modulü, ICAO 9303 standartına sahip kimlik kartları ve pasaportların içerisinde bulunan, değiştirilemez bilgileri okumak için geliştirilmiştir. Çip içerisindeki bilgileri okuma işlemi, çip otantikasyonunu sağlamak adına gerekli olan 3 parametre ile açılmaktadır. Bu parametreler, kimliğin seri numarası, kimliğin son geçerlilik tarihi ve kimlik sahibinin doğum tarihinin ileride belirtilecek olan uygun formatta sağlanması ile açılmaktadır.

NFC Modülü: Kimlik Kartı ve Pasaport Okuma

NFC modülü, kimlik kartları veya pasaportlar üzerinde bulunan çip verilerini okumak için kullanılmaktadır. NFC okuma işlemi, SDK içinde belirli bir yapıya göre gerçekleştirilir ve işlem başlatmak için bir fonksiyon bulunmaktadır. Bu fonksiyonun sonucuna göre, işlem durumu hakkında bir callback tetiklenir.

Gerekli Veriler:

Chip verilerinin başarıyla okunabilmesi için, aşağıdaki bilgilerin sağlanması gerekmektedir:

  • Seri Numarası (A11A11111)
  • Kimlik Geçerlilik Tarihi (YYMMDD)
  • Doğum Tarihi (YYMMDD)

Eğer bu bilgiler sağlanmazsa, NFC okuma işlemi başarısız olur ve veriler alınamaz. EnQualifyNFCDelegate.nfcFailed üzerinden bacFailure kodu dönülür.

⚠atlassian-warning#FFEBE6

NFC modülünü kullanılmak istendiğinde, Core Modülü projeye eklenmek zorundadır. Bu, modüllerin temel işlevselliklerini sağlamak için gereklidir.


EnQualifyNfc SDK Projeye Entegrasyon Adımları

Bu rehber, EnQualifyNfc SDK'nın projeye nasıl entegre edileceğini açıklamaktadır. Aşağıdaki adımları takip ederek hızlı ve kolay bir şekilde entegrasyonu gerçekleştirebilirsiniz.

Core Modülü Nedir

NFC modülü eklenmeden önce Core Modülü projeye dahil edilmelidir. Core modülünün nasıl ekleneceğini öğrenmek için Core Modülü dokümanını ziyaret edebilirsiniz.

Hızlı İmplementasyon

Projenizde hızlı bir entegrasyon gerçekleştirmek için NFC Modülü Nasıl İmplemente Edilir? bölümüne başvurabilirsiniz.

NFC Modülünün Projeye Eklenmesi

EnQualify iOS SDK, doğrudan projeye entegre edilebilir:

  • Yöntem: SDK'yı doğrudan projeye xcframework embed ederek eklemek ve gerekli olan bağımlılıkları cocoapods üzerinden yüklemek.
Text Only
// target 'MySampleProject' do
  use_frameworks!
  pod 'OpenSSL-Universal','3.3.2000' # CoreModule
end


post_install do |installer|
   installer.pods_project.targets.each do |target|
    target.build_configurations.each do |config|
        config.build_settings['BUILD_LIBRARY_FOR_DISTRIBUTION'] = 'YES'
        config.build_settings['EXPANDED_CODE_SIGN_IDENTITY'] = ""
        config.build_settings['CODE_SIGNING_REQUIRED'] = "NO"
        config.build_settings['CODE_SIGNING_ALLOWED'] = "NO"
        config.build_settings["EXCLUDED_ARCHS[sdk=iphonesimulator*]"] = ""
        config.build_settings['VALID_ARCHS'] = "arm64 x86_64"
        config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.5'
        config.build_settings["ONLY_ACTIVE_ARCH"] = "YES"
    end
  end
end

Kurulum Sonrası Build Ayarları Açıklaması

BUILD_LIBRARY_FOR_DISTRIBUTION = YES:

Framework'ün dağıtım için inşa edilmesini sağlar, böylece başka projelerde ikili (binary) veya paylaşılan framework olarak kullanılabilir. Bu, özellikle XCFramework'ler oluşturulurken faydalıdır.

EXPANDED_CODE_SIGN_IDENTITY = "":

Code Signing Identity temizlenir; böylece build sürecinde belirli bir sertifika kullanılmadığından emin olunur.

CODE_SIGNING_REQUIRED = NO:

Build sürecinde code signing gereksinimini devre dışı bırakır. Bu, test sırasında veya imzalamanın gerekli olmadığı durumlarda kullanışlıdır.

CODE_SIGNING_ALLOWED = NO:

Code Signing tamamen devre dışı bırakıldığından emin olur.

EXCLUDED_ARCHS[sdk=iphonesimulator*] = "":

iPhone simülatörü için önceden hariç tutulan tüm mimarileri kaldırır. Bu ayar, build sürecinde uyumluluğu sağlar.

VALID_ARCHS = "arm64 x86_64":

Build için geçerli mimarileri belirtir. Burada, arm64 (M Serisi) ve x86_64 (intel işlemcili) macler için kullanılır.

IPHONEOS_DEPLOYMENT_TARGET = 14.0:

Uygulama veya framework'ün desteklediği minimum iOS sürümünü ayarlar. Bu, iOS 14.0 ve üzeri cihazlarla uyumluluğu sağlar.

ONLY_ACTIVE_ARCH = YES:

Build sürecini yalnızca aktif build cihazı veya simülatörün mimarisi ile sınırlar. Bu, geliştirme sırasında build süresini hızlandırabilir.

XCFrameworks

  • EnQualify SDK'yı doğrudan projenize entegre etmek için, temel SDK dosyaları olan OCRModule.xcframework, NFCModule.xcframework, FaceModule.xcframework CoreModule.xcframework ve VideoCallModule.xcframework'i doğrudan proje dosyalarınıza ekleyebilirsiniz.
  • Alternatif olarak, XCFramework'leri projenize zaten kopyaladıysanız, bu framework'leri projenize eklemek için Project Settings > General bölümüne gidip Embed and Sign seçeneğini seçebilirsiniz.
  • Bu şekilde eklenen EnQualify SDK'nın bağımlılıkları için, ilgili sürümün "podspec" dosyasında belirtilen veya sağlayıcı tarafından belirlenen sürüm numaraları ile projenize dahil etmeniz gerekmektedir.

iOS - VideoCall Modülü

NFC Modülü nasıl implemente edilir ?

Bu rehber, EnQualifyNFC SDK'yı projeye dahil etmek ve NFC işlemlerini kolayca entegre etmek için gerekli adımları sunar. Aşağıdaki talimatları takip ederek hızlıca implementasyonu yapabilirsiniz.

1. Modüllerin eklenmesi

1.1 Core Modülünün İmplementasyonu

EnQualifyNFC Modülü kullanılmadan önce Core Modülü projeye dahil edilmelidir. Eğer henüz eklemediyseniz, detaylar için Core Modülü dokümantasyonuna bakabilirsiniz.

1.2 NFC Modülünün İmplementasyonu

NFC Modülü projeye eklenmesi için gerekli talimatları NFC Modülünün Projeye Eklenmesi başlığı altında bulabilirsiniz. Bu adımları takip ederek NFC modülünü projeye dahil edilmelidir.


2. İzinler

2.1 Info.plist Dosyasına NFC Kullanım İzni Ekleme

Öncelikle, Info.plist dosyasına NFC izni eklemeniz gerekmektedir. Bu, uygulamanızın kamera donanımına erişebilmesini sağlar.

Text Only
<key>NFCReaderUsageDescription</key>
<string>Uygulamamız NFC etiketlerini okumak için NFC erişimi istiyor</string>
<key>com.apple.developer.nfc.readersession.formats</key>
<array>
    <string>NDEF</string>
    <string>TAG</string>
</array>

2.2 Info.plist Dosyasına ISO 7816 Standartı eklenmesi

Temassız NFC çipinin okunabilmesi için info.plist dosyasına ISO 7816 Standartını içeren ilgili içerik ve değeri eklenmesi gerekmektedir.

Text Only
<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
    <array>
        <string>A0000002471001</string>
    </array>

3. EnQualifyNFCDelegate Arayüzünün Eklenmesi

EnQualifyNFCDelegate, NFC işlemlerini yönetmek için gerekli delegate metotlarını içerir. Bu interface implemente ederek NFC ile ilgili olayları dinleyebilir ve yönetebilirsiniz. Detaylı bilgi için EnQualifyNFC Kullanım Kılavuzu bölümünü inceleyebilirsiniz.

3.1 EnQualifyNFCDelegate 'in Sınıfa Eklenmesi

Text Only
class ViewController: EnQualifyNFCDelegate {

3.2 Delegate Fonksiyonlarının Override Edilmesi

Text Only
class ViewController: EnQualifyNFCDelegate {
    func nfcStart(serialNumber: String, dateOfBirth: String, dateOfExpire: String) {}

    func nfcFailed(error: NFCModule.EnQualifyNFCError) {}

    func nfcCompleted() {}

    func initializeCompleted(moduleName: String) {}

    func initializeFailed(with key: CustomNSError) {}

    func sessionCloseCompleted(status: String) {}

    func sessionCloseFailed() {}

    func tokenCreateCompleted() {}

    func tokenCreateFailed() {}

    func integrationAddCompleted() {}

    func integrationAddFailed() {}

    func sessionAddFailed() {}

    func settingGetFailed() {}

    func signingSetCompleted() {}

    func signingCompleted() {}

    func signingSetFailed(error: String) {}
}

3. EnQualifyNFC 'nın Initialize Edilmesi ve Token, Ayar ve Oturum İşlemleri

Initalize edilmeden önce core;

  • EnQualifyNFCDelegate metodları, hangi UIViewController içerisinde kullanılacak ise o UIViewController 'ın delegate alanına eklenmelidir.
  • SessionModelNFC, NFC başlatmak için kullanılacak parametreleri içeren modeldir ve başlatma işleminde ilgili alana bu model eklenmelidir. Detaylı bilgi için SessionModelNFC bölümünü inceleyebilirsiniz.
  • BaseModelNFC, NFC için gerekli olan sertifika ve temel URL bilgilerini içeren modeldir ve başlatma işleminde ilgili alana bu model eklenmelidir. Detaylı bilgi için BaseModelNFC bölümünü inceleyebilirsiniz.

NFC işlemlerine başlamadan önce, EnQualifyNFC sınıfının initialize edilmesi gerekir. Bu işlem, gerekli olan token, settings, ve session işlemlerinin başlatılmasını sağlar. Ayrıca, kullanıcıya NFC işlemi için hazırlıkların tamamlandığını bildirmek ve ardından işlem sürecini başlatmak önemlidir.

Text Only
func initialize(_ sender: Any?,
                sessionModel: SessionModelNFC? = nil,
                baseModel: BaseModelNFC? = nil) {

Parametreler

Parametre Tip Açıklama
delegate Any? Uygulamanın hangi UIViewController içerisinde kullanılacağını belirlenir.
sessionModel SessionModelNFC NFC işlemi sırasında kullanılacak oturum bilgilerini içerir.
baseModel BaseModelNFC Doğrulama sürecinde temel verileri taşıyan modeldir.

EnQualifyNFC initialize edildikten sonra EnQualifyNFC instance oluşturulur ve ardından token, settings ve session oluşturmak için gerekli işlemleri başlatır. initialize yapıldıktan sonra token, settings ve session sdk tarafından yönetilir.

EnQualifyNFC instance 'ı oluşturulduktan sonra şu adımlar sırasıyla gerçekleştirilir:

  1. Token Oluşturma

  2. EnQualifyNFC, token oluşturma sürecini başlatır.

  3. Eğer token oluşturma işlemi sırasında bir hata oluşursa, tokenCreateFailed delegate'i tetiklenir.
Text Only
func tokenCreateFailed() {}
  • Token başarıyla oluşturulduğunda, bir sonraki adım olan session işlemine geçilir.
  • Oturum İşleminin Başlatılması

  • Token başarılı bir şekilde alındıktan sonra oturum başlatma süreci devreye girer.

  • Eğer oturum başlatma sırasında bir hata oluşursa, sessionAddFailed delegate'i tetiklenir.
Text Only
func sessionAddFailed() {}
  • Oturum işlemi başarıyla tamamlandığında, SDK backoffice ile bağlantıyı kurmuş olur ve işlem başlatmaya hazır hale gelir.
  • Ayarların Alınması

  • Session başarılı bir şekilde oluşturulduktan sonra, backoffice üzerinden tanımlanan ayarların alınma işlemi başlatılır.

  • Eğer bu süreçte bir hata oluşursa, settingsGetFailed delegate'i tetiklenir ve hata mesajı client tarafına iletilir.
Text Only
func settingGetFailed() {}
  • Ayarlar başarıyla alındığında, SDK ilgili konfigürasyonları yapar ve oturum işlemini başlatır.
  • İşlem Tamamlama

  • Tüm adımlar sorunsuz bir şekilde tamamlandığında, initializeCompleted delegate'i tetiklenir. Bu, SDK'nın başarıyla initialize edildiğini ve NFC işlemlerine hazır olduğunu belirtir.

Text Only
func initializeCompleted(moduleName: String) {}

Bu süreç, EnQualifyNFC'nın sağlam bir şekilde çalışmasını sağlamak için tasarlanmıştır. Olası hatalar, ilgili delegate'ler aracılığıyla client veya kullanıcıya iletilerek gerekli aksiyonların alınmasını kolaylaştırır.


4. NFC İşleminin Başlatılması

Bu bölümde, NFC işlemlerinin nasıl başlatılacağını ve yönetileceğini adım adım açıklıyoruz.

4.1. Kullanıcı Bilgilendirme

NFC işlemi başlamadan önce, kullanıcıya bilgilendirme yapılması önerilir. Bunun için bir NFCInfo sayfası oluşturulabilir.
Bu sayfa, kullanıcıya NFC işlemi hakkında bilgi verir ve daha iyi bir deneyim sağlar.

4.2. NFC İşlemleri

NFC fonksiyonlar ve delegate'ler ile ilgili detaylı bilgiyi EnQualifyNFC Kullanım Kılavuzuna göz atabilirsiniz.

  • nfcStart(serialNumber: String, dateOfBirth: String, dateOfExpire: String)
  • sessionClose(finished: Bool)

4.2.1. Çip Okuma İşleminin Yapılması

Çip okuma işlemini başlatmak için nfcStart fonksiyonu kullanılır. Bu işlem, EnQualifyNFC API tarafından yönetilir ve aşağıdaki gibi çağrılır.

Text Only
EnQualifyNFC.nfcStart(serialNumber: String, dateOfBirth: String, dateOfExpire: String)

Delegate Mekanizması

Çip okuma işlemi başarıyla tamamlandığında, okunan datalar backoffice gönderilir ve nfcCompleted() delegate'i tetiklenir.

Text Only
func nfcCompleted() {}

4.2.2. Çip Okuma İşleminin Durdurulması

Başlatılmış olan bir NFC session'ını, belirli geçiş senaryolarında güvenli bir şekilde sonlandırmayı sağlar.

Text Only
EnQualifyNFC.nfcStopForBacktoVideoCall()

Kullanım Senaryosu

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

  4. event == .BackToVideoCall

  5. lastEvent == .NFC
  6. NFC halen aktif durumda

Bu durumda NFC işleminden çıkmak için

Text Only
EnQualifyNFC.nfcStopForBacktoVideoCall()

çağrılmalıdır.

4.2.3. SDK Session'ını Kapatma

Session Kapatma İşleminin Yapılması

SDK'ların backend servislerle iletişim için kullandığı session'ın kapatılması için sessionClose fonksiyonu kullanılır. Bu işlem, EnQualifyCore API tarafından yönetilir, fakat her SDK'nın API tarafında aşağıdaki gibi çağrılır.

⚠atlassian-warning#FFEBE6

Session bir SDK tarafından kapatıldıktan sonra eğer tekrar kullanılacak ise yeniden SDK initialize edilmesi gerekir.

Text Only
EnQualifyNFC.sessionClose(finished: false)

Delegate Mekanizması

Session kapatma işlemi başarıyla tamamlandığında, sessionCloseCompleted delegate'i tetiklenir. Bu delegate içerisinde, işlem sonrasında yapılması gereken diğer işlemler ele alınabilir.

Text Only
func sessionCloseCompleted(status: String) {}

Session kapatma işlemi başarısız olduğunda, sessionCloseFailed delegate'i tetiklenir. Bu delegate içerisinde, işlem sonrasında yapılması gereken diğer işlemler ele alınabilir.

Text Only
func sessionCloseFailed() {}

Not:

Sonuç sayfasında okunan verileri göstermek için CustomerChipbölümünü inceleyebilirsiniz. Bu bölüm, okunan verilerin kullanıcıya düzgün ve anlaşılır bir şekilde sunulmasını sağlar.

EnQualifyNFC Kullanım Kılavuzu

Fonksiyonlar

initialize(...) : EnQualifyNFC

Text Only
func initialize(_ sender: Any?,
                sessionModel: SessionModelNFC? = nil,
                baseModel: BaseModelNFC? = nil) {

Kimlik tanıma işlemlerini yönetmek için EnQualifyNFC başlatılmalıdır. Bu API, initialize edilirken;

  • sender: Any : Uygulamanın delegate metodlarını hangi classın karşılayacağını belirler.
  • sessionModel: SessionModelNFC : NFC işlemi sırasında kullanılacak oturum bilgilerini içerir.
  • baseModel: BaseModelNFC : Doğrulama sürecinde temel verileri taşıyan modeldir.

verilebilir.

API, singleton yapıda çalıştığı için uygulama oturumu boyunca aynı instance üzerinden işlemler gerçekleştirilir. Bu, hem kaynak tasarrufu sağlar hem de işlem tutarlılığını artırır.
Başlatma işlemi, otomatik olarak şu işlemleri gerçekleştirir:

  • Token oluşturma
  • Settings yapılandırma
  • Session başlatma
    Eğer mevcut bir session varsa, yeni bir session oluşturulmaz ve mevcut session kullanılmaya devam edilir.

Delegate'ler

Token / Session / Settings Delegate'leri

tokenCreateCompleted()

  • Token oluşturma işlemi tamamlandığında tetiklenir.
  • Eğer mevcut bir token varsa, yeniden oluşturulmaz ve mevcut token kullanılır.

tokenCreateFailed()

  • Token oluşturulurken hata alınırsa tetiklenir.

settingsGetFailed()

  • Settings bilgilerini çekerken hata alınırsa tetiklenir.

sessionAddFailed()

  • Yeni bir session oluşturulurken hata alınırsa tetiklenir.

sessionCloseCompleted(status: String)

  • Session kapatıldığında tetiklenir.
  • Parametre:

  • status : Session kapandığında session'ın statu bilgisi.


sessionCloseFailed()

  • Session kapatılırken hata alınırsa tetiklenir.

integrationAddCompleted()

  • IntegrationAdd servisine yapılan istek tamamlandığında tetiklenir.

integrationAddFailed()

  • IntegrationAdd servisi istek yapıldığında hata alınırsa tetiklenir.

nfcFailed(error: EnQualifyNFCError)

Text Only
public enum EnQualifyNFCError: String {
    case sessionTimeout = "The chip could not be read within the specified time."
    case idChipSaveError = "The ID information could not be saved"
    case userCancelled = "The user cancel"
    case failedToConnectToTag = "Failed connect to tag"
    case bacFailure = "Incorrect basic access data informaiton"
    case bundleFailure = "Failed to load NFCModule bundle"
    case masterListFailure = "Failed to locate masterList in bundle"

    public var errorMessage: String {
        return self.rawValue
    }
}
  • Çip okuma işlemlerinde bir hata aldığında veya başarısız olduğunda tetiklenir.
  • Parametreler:

  • errorMessage: Hata mesajı.


nfcCompleted()

  • Çip okumayı başlatmak için çağrılan nfcStart fonksiyonunun ardından, çip başarıyla okunduğunda tetiklenir.

Modeller

BaseModelNFC

BaseModelNFC, Doğrulama süreçlerinde kullanılan sertifika bilgilerini ve sunucu bağlantı adresini içeren veri modelidir. Signaling (Haberleşme) ve MAPI (Mobile-Application Programming Interface) sertifikaları hem liste olarak (.der) formatında hem de Base64 string formatta saklanabilir.

Model

Text Only
class BaseModelNFC(
    var signallingCertificateList: [String]? = nil
    var mapiCertificateList: [String]? = nil
    var signallingCertificateBase64List: [String]? = nil
    var mapiCertificateBase64List: [String]? = nil
    var baseURL: String //Zorunlu alan
    var locale: String? = nil
    var mobileUser: String? = nil
    var countryCode: String? = nil
)

Özellikler

Özellik Tip Açıklama
signallingCertificateList [String]? Signalling sertifikalarının dizisi. Sertifikalar dosya (.der) formatında saklanır.
mapiCertificateList [String]? MAPI sertifikalarının dizisi. Sertifikalar dosya (.der) formatında saklanır.
signallingCertificateBase64List [String]? Signalling sertifikalarının Base64 metin formatında kodlanmış halleri.
mapiCertificateBase64List [String]? MAPI sertifikalarının Base64 metin formatında kodlanmış halleri.
*baseURL String API doğrulama işlemleri için kullanılan temel sunucu adresi.
locale String? Sesli yönlendirme mesajlarının hangi dilde olacağını belirler.
mobileUser String? Authorization sağlanırken kullanılan anonymous user bilgisini ifade eder.
countryCode String? Ülke ya da bölge özelinde doğrulama yapılırken, gerekli olan verilerin bölge özelinde edinilmesini sağlamak için kullanılır.

Kullanım Örneği

Aşağıdaki örnekte, BaseModelNFC nesnesi oluşturularak sertifika bilgileri ve sunucu adresi tanımlanmaktadır:

Text Only
var baseModelNFC = BaseModelNFC(
    signallingCertificateList: ["AI_CERT_1", "AI_CERT_2"],
    mapiCertificateList: ["MAPI_CERT_1", "MAPI_CERT_2"],
    signallingCertificateBase64List: ["QUlDRVJU...", "Q0VSVF8y..."],
    mapiCertificateBase64List: ["TU9SRSB...", "Q0VSVF8z..."],
    baseURL: "API_SERVER_URL",
    locale: "TR",
    mobileUser: "mobile",
    countryCode: "TUR"
)

Açıklamalar

  • Sertifikalar (signallingCertificateList, mapiCertificateList): Uygulama içine eklenmiş sertifika dosyalarının isimleri verilir.
  • Base64 Sertifikalar (signallingCertificateBase64List, mapiCertificateBase64List): Sertifikaların Base64 formatına çevrilmiş halleri.
  • Sunucu Bağlantısı (baseURL): Doğrulama veya sertifika işlemlerinin gerçekleştirileceği sunucu URL’si.

SessionModelNFC

SessionModelNFC, Bir çağrı oturumu sırasında kullanıcı ve kimlik bilgilerini içeren veri modelidir. Çağrı türü, kullanıcı detayları, kimlik bilgileri ve oturumla ilgili ek parametreleri içerir.

Model Tanımı

Text Only
class SessionModelNFC(
    var callType: String, // Zorunlu alan
    var userName: String? = nil,
    var surname: String? = nil,
    var phone: String? = nil,
    var email: String? = nil,
    var identityType: String? = nil,
    var identityNo: String? = nil,
    var reference: String, // Zorunlu alan
    var canAutoClose: Bool = false, // Varsayılan: false
    var isContinue: Bool = false, // Varsayılan: false
    var category: String? = nil,
    var taxNumber: String? = nil,
    var businessReference: String? = nil,
    var handicapped: Bool? = false
)

Özellikler

Özellik Tip Açıklama
*callType String Zorunlu. Çağrı türünü belirten parametre (örneğin: "NewCustomer").
userName String? Kullanıcının adı. Boş olabilir.
surname String? Kullanıcının soyadı. Boş olabilir.
phone String? Kullanıcının telefon numarası. Boş olabilir.
email String? Kullanıcının e-posta adresi. Boş olabilir.
identityType String? Kimlik türü (örneğin: "I"(T.C. Kimlik Kartı), "P"(Pasaport)). Boş olabilir.
identityNo String? Kullanıcının kimlik numarası. Boş olabilir.
*reference String Zorunlu. Oturum için referans ID'si.
canAutoClose Bool Oturumun otomatik kapanıp kapanmayacağını belirler. Varsayılan: false.
isContinue Bool Oturumun devam edip etmeyeceğini belirler. Varsayılan: false.
category String? Oturumun ait olduğu kategori. Boş olabilir.
taxNumber String? Kullanıcıya ait vergi numarası. Boş olabilir.
businessReference String? İşletme ile ilgili referans bilgisi. Boş olabilir.
handicapped Bool Kullanıcının engelli olup olmadığını belirten bayrak. Varsayılan: false.

Kullanım Örneği

Aşağıdaki örnekte, SessionModelNFC nesnesi oluşturularak oturum bilgileri tanımlanmaktadır:

Text Only
var sessionModelNFC = SessionModelNFC(
    callType: "NewCustomer",
    userName: "Enqura",
    surname: "Information",
    phone: "+905551234567",
    email: "enqualifyplus@enqura.com",
    identityType: "TC. Kimlik Kartı",
    identityNo: "12345678901",
    reference: "REF123456",
    canAutoClose: true,
    isContinue: true,
    category: "category",
    taxNumber: "9876543210",
    businessReference: "COMPANY",
    handicapped: false
)

Açıklamalar

  • Zorunlu Alanlar: callType ve reference parametreleri mutlaka belirtilmelidir.
  • Kullanıcı Bilgileri: userName, surname, phone, email gibi alanlar isteğe bağlıdır.
  • Kimlik Bilgileri: identityType ve identityNo, NFC doğrulama veya kimlik tanımlama süreçlerinde kullanılabilir.
  • Engellilik Durumu: handicapped parametresi kullanıcının özel gereksinimlere sahip olup olmadığını belirtir.
  • Otomatik Kapanma: canAutoClose, oturumun belirli bir koşul gerçekleştiğinde otomatik olarak kapanmasını sağlayabilir.
  • Devam Durumu: isContinue, oturumun devam eden bir işlem olup olmadığını kontrol eder.

CustomerChip

Bu sınıf, kullanıcının kimlik veya pasaportundaki NFC çipinden okunan verilerin depolandığı veri modelini temsil eder. NFC okuma süreci sırasında elde edilen ilgili doğrulama bilgileri de bu model içerisinde tutulur.

Model

Text Only
@objc public class CustomerChip: NSObject {
    @objc public static let shared = CustomerChip()

    @objc public func getName() -> String? {}

    @objc public func getSurname() -> String? {}

    @objc public func getIdentityNo() -> String? {}

    @objc public func getDocumentNo() -> String? {}

    @objc public func getBirthDate() -> String? {}

    @objc public func getNationality() -> String? {}

    @objc public func getExpireDate() -> String? {}

    @objc public func getGender() -> String? {}

    @objc public func getActiveAuth() -> AnyObject? {}

    @objc public func getPassiveAuth() -> AnyObject? {}

    @objc public func getImage() -> UIImage? {}

    @objc public func getDocumentType() -> String? {}
}