Zebra RFID API3 Android SDK & Guide

dependencies {
    // Include all AARs in libs but exclude rfidapi3llrplib to avoid duplicate LLRPClient classes
    implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'], exclude: ['rfidapi3llrplib-*.aar'])
    
    // Required networking & async dependencies used by Zebra ZIOTC sled protocols
    implementation 'org.nanohttpd:nanohttpd:2.3.1'
    implementation 'org.java-websocket:Java-WebSocket:1.6.0'
}

package com.rfidsoftwares.demo.zebra

import android.content.Context
import android.util.Log
import com.zebra.rfid.api3.*

class ZebraRfidService(private val context: Context) : RfidEventsListener {

    private var readers: Readers? = null
    private var availableRFIDReaderList: ArrayList<ReaderDevice>? = null
    private var readerDevice: ReaderDevice? = null
    private var rfidReader: RFIDReader? = null
    private var isConnected = false

    fun initialize() {
        Thread {
            try {
                // Discover all attached readers (Internal Serial + Bluetooth Sleds)
                readers = Readers(context, ENUM_TRANSPORT.ALL)
                availableRFIDReaderList = readers?.GetAvailableRFIDReaderList()

                if (!availableRFIDReaderList.isNullOrEmpty()) {
                    // Select first detected reader device
                    readerDevice = availableRFIDReaderList?.get(0)
                    rfidReader = readerDevice?.rfidReader

                    // Establish hardware session
                    rfidReader?.connect()
                    isConnected = true
                    Log.i("ZebraRFID", "Connected to Zebra reader: ${rfidReader?.hostName}")

                    configureReader()
                } else {
                    Log.w("ZebraRFID", "No Zebra RFID readers detected.")
                }
            } catch (e: Exception) {
                Log.e("ZebraRFID", "Hardware connection exception", e)
            }
        }.start()
    }

    private fun configureReader() {
        try {
            // Subscribe to inventory read events & pistol trigger events
            rfidReader?.Events?.addEventsListener(this)
            rfidReader?.Events?.setHandheldEvent(true)
            rfidReader?.Events?.setTagReadEvent(true)
            rfidReader?.Events?.setAttachTagDataWithReadEvent(true)

            // Configure RF Power to 270 (27.0 dBm) on Antenna 1
            val rfConfig = rfidReader?.Config?.Antennas?.getAntennaRfConfig(1)
            rfConfig?.transmitPowerIndex = 270
            rfidReader?.Config?.Antennas?.setAntennaRfConfig(1, rfConfig)
        } catch (e: Exception) {
            Log.e("ZebraRFID", "Error configuring antenna parameters", e)
        }
    }

    fun startInventory() {
        if (!isConnected || rfidReader == null) return
        try {
            rfidReader?.Actions?.Inventory?.perform()
            Log.i("ZebraRFID", "Zebra inventory sweep active.")
        } catch (e: Exception) {
            Log.e("ZebraRFID", "Failed to start inventory", e)
        }
    }

    fun stopInventory() {
        if (!isConnected || rfidReader == null) return
        try {
            rfidReader?.Actions?.Inventory?.stop()
            Log.i("ZebraRFID", "Zebra inventory sweep stopped.")
        } catch (e: Exception) {
            Log.e("ZebraRFID", "Failed to stop inventory", e)
        }
    }

    // Tag read notification callback from Zebra API3 engine
    override fun eventReadNotify(e: RfidReadEvents?) {
        val myTags = rfidReader?.Actions?.getReadTags(100)
        if (myTags != null) {
            for (tag in myTags) {
                val epc = tag.tagID
                val rssi = tag.peakRSSI
                Log.d("ZebraRFID", "Tag Scanned: EPC=$epc | PeakRSSI=$rssi dBm")
            }
        }
    }

    // Hardware status events (including pistol grip trigger clicks)
    override fun eventStatusNotify(statusEvents: RfidStatusEvents?) {
        if (statusEvents?.statusEventType == STATUS_EVENT_TYPE.HANDHELD_TRIGGER_EVENT) {
            val triggerData = statusEvents.handheldTriggerEventData
            if (triggerData.handheldEvent == HANDHELD_TRIGGER_EVENT_TYPE.HANDHELD_TRIGGER_PRESSED) {
                startInventory()
            } else if (triggerData.handheldEvent == HANDHELD_TRIGGER_EVENT_TYPE.HANDHELD_TRIGGER_RELEASED) {
                stopInventory()
            }
        }
    }

    fun disconnect() {
        try {
            if (isConnected) {
                rfidReader?.Events?.removeEventsListener(this)
                rfidReader?.disconnect()
                isConnected = false
            }
        } catch (e: Exception) {
            Log.e("ZebraRFID", "Error disconnecting reader", e)
        }
    }
}