Initializes the list of all smart card readers attached to the device (through getReaders()) and starts monitoring smart card reader events.

Example:

var environment: SCMEnvironment? = nil
group = DispatchGroup()
group.enter()
DispatchQueue.global(qos: .background).async {
    SCMEnvironment.createEnvironment { env, error in
        if let error = error {
        // fail to create the environment
        }
        else {
            environment = env
        }
        group.leave()
    }
}
group.wait()
if let env = environment {
   env.addReaderListener(listener: self)
}

Note:

If the device supports NFC Tag Reading, a NFC Reader named "NFC Interface" will be added to getReaders() array.

Returns the list of all smart card readers attached to the device.

Gets the Reader object with the given name.

Registers a reader event listener.

Removes a reader event listener.

Returns an array of the bluetooth peripherals visible to the device.

Example:

do {
    let peripherals = try env.getDetectedBluetoothPeripherals()
}
catch SCMError.CXR_BT_INITIALIZATION_FAILED {
    // handle failed initialization of bluetooth
}
catch SCMError.CXR_BT_NOT_SCANNING {
    // start scan
}
catch SCMError.CXR_BT_ALREADY_PAIRED {
    // you can't use this function while being connected
}
catch {
    // other error
}

Registers a bluetooth peripheral.

Example:

let peripheral : BluetoothPeripheral //Obtained after getDetectedBluetoothPeripherals()
do {
    let peripherals = try env.registerBluetooth(peripheral.getUuid())
}
catch SCMError.CXR_BT_INITIALIZATION_FAILED {
    // handle failed initialization of bluetooth
}
catch SCMError.CXR_BT_NOT_SCANNING {
    // you must be scanning to register a bluetooth device
}
catch SCMError.CXR_BT_DEVICE_NOT_DETECTED {
    // the uuid does not correspond to any detected device. 
    // This can occur if the device was turned off or went out of range between the call to getDetectedBluetoothPeripherals() and registerBluetooth()
}
catch SCMError.CXR_BT_DEVICE_NOT_SUPPORTED {
    // this device is not supported
}
catch {
    // other error
}

Returns the registered bluetooth peripheral.

Starts the scan for bluetooth devices.

Example:

do {
    let peripherals = try env.startBluetoothScan()
}
catch SCMError.CXR_BT_INITIALIZATION_FAILED {
    // handle failed initialization of bluetooth
}
catch SCMError.CXR_BT_ALREADY_PAIRED {
    // release connected reader before starting a new scan
}
catch {
    // other error
}

Gets if a bluetooth scan is running, for detecting bluetooth peripherals.

Stops scan for bluetooth peripherals.

Example:

do {
    let peripherals = try env.stopBluetoothScan()
}
catch SCMError.CXR_BT_INITIALIZATION_FAILED {
    // handle failed initialization of bluetooth
}
catch SCMError.CXR_BT_ALREADY_PAIRED {
    // release connected reader before starting a new scan
}
catch {
    // other error
}

Disconnects the current bluetooth peripheral

Example:

do {
    let peripherals = try env.releaseBluetooth()
}
catch SCMError.CXR_BT_INITIALIZATION_FAILED {
    // handle failed initialization of bluetooth
}
catch {
    // other error
}

Unregisters the paired bluetooth. This function also disconnects the current connected device.

Starts scanning for NFC tags. After calling this function, iOS will display an alert action sheet waiting to detect tags.

Example:

env.initTagReaderSession(message: "Present your smart card to the phone") { error in
    if let error = error {
        if error.scmError == SCMError.CXR_FUNCTION_TIMED_OUT {
            // the session has timed out
        }
        else if error.scmError == SCMError.CKR_FUNCTION_CANCELED {
            // the session was canceled by the user
        }
        else {
            // other failure reason
        }
    }
    else {
        // the session ended with a call to endTagReaderSession(errorMessage:String?)
    }
)

Closes the NFC Tag reader session and displays a feedback to the user.

Note:

If the session was not successful, a message must be provided, which will be displayed to the user as an error. If the operation was successful, the message must be set to nil. In this case, a positive check mark will be displayed to the user.

Updates the text message that was displayed on the alert action sheet of the NFC Tag Reader Session.

Returns if the device supports NFC Tag Reading.