Scan QR Code on App

This topic describes how to enable a device with a camera to scan the QR code on the mobile app for pairing.

Initialize IActivator

Parameters

Example

self.pair = ActivatorService.shared.activator(.QRCode)

Get a pairing token

Parameters

Example

// Get the asset activation token.
ActivatorService.shared.activatorToken(assetId: "123456", longitude: "30.1234", latitude: "120.5678", success: { token in
    // The success callback.
    print("The activation token is \(token)")
}, failure: { error in
    // The failure callback.
    print("Failed to get the activation token. Error \(error.localizedDescription)")
})

Generate a QR code

QRCodeDataForQRCodeActivatorMode parameters

Example

self.qrCodeData = ActivatorService.shared.QRCodeDataForQRCodeActivatorMode(ssid: self.ssid, password: self.password, pairToken: self.pairingToken)

if let filter = CIFilter(name: "CIQRCodeGenerator") {
    filter.setValue(self.qrCodeData, forKey: "inputMessage")

    if let output = filter.outputImage {
        let scale = 300 / output.extent.size.width
        let qrImage = output.transformed(by: CGAffineTransform(scaleX: scale, y: scale))
        self.qrCodeImage.image = UIImage(ciImage: qrImage)
    }
}

Register IActivatorListener to listen for pairing result

Parameters

Callbacks

Example

private func start() {
    pair.listener = self
}

extension ViewController: IActivatorListener {
    func onSuccess(deviceModel: IActivatedDevice?, params: ActivatorParams?) {
        SVProgressHUD.dismiss()
        self.navigationController?.popToRootViewController(animated: true)
    }

    func onError(error: Error, params: ActivatorParams?) {
        SVProgressHUD.dismiss()
        SVProgressHUD.showInfo(withStatus: error.localizedDescription)
    }
}

Start pairing

This method starts device pairing.

Parameters

Example

// Create QRCodeActivatorParams instance
let params = QRCodeActivatorParams(ssid: "my_wifi_ssid", password: "my_wifi_password", pairToken: "my_pair_token")

// Start pairing. pair is generated during initialization.
// self.pair = ActivatorService.shared.activator(.QRCode)
pair.startPair(params)

Stop pairing

This method stops device pairing.

Example

// Stop pairing. pair is generated during initialization.
// self.pair = ActivatorService.shared.activator(.QRCode)
pair.stopPair()