快速上手 (Kotlin)¶

构建SerialPort实例¶

val serialPort = SerialPortBuilder.build(this)

使用方法 doDiscovery(context) 搜索设备：

serialPort.doDiscovery(this)

使用方法 getPairedDevicesListBD() 和 getUnPairedDevicesListBD() 获取搜索结果：

serialPort.getPairedDevicesListBD()		//获取已配对设备列表
serialPort.getUnPairedDevicesListBD()	//获取未配对设备列表

想要成功的连接设备，并且完成通信，设置正确的UUID是必不可少的一步。

使用 SerialPort 的静态方法 setLegacyUUID(uuid) 设置传统设备的UUID：

SerialPort.setLegacyUUID("00001101-0000-1000-8000-00805F9B34FB")

传统设备一般情况下，可以不用设置UUID，使用默认的即可。

使用 SerialPort 的静态方法 setBleUUID(uuid) 设置BLE设备的UUID：

SerialPort.setBleUUID("0000ffe1-0000-1000-8000-00805f9b34fb")

BLE设备大多数情况下都需要设置UUID，具体的UUID可以查询手册或咨询卖家。

除此之外，也可以使用方法 printPossibleBleUUID() 打印出可行的UUID，自行选择尝试：

serialPort.printPossibleBleUUID()

使用方法 openDiscoveryActivity() 打开内置的搜索页面选择设备进行连接：

serialPort.openDiscoveryActivity()

不想使用内置的搜索页面怎么办？

可以设置自定义的搜索页面或者直接使用设备地址进行连接。详见使用自定义的界面

使用方法 setReceivedDataCallback(receivedDataCallback) 设置一个接收消息监听器：

serialPort.setReceivedDataCallback { data ->

        }

除此之外，你还可以在构建实例时配置监听器：

val serialPort = SerialPortBuilder
            .setReceivedDataCallback { data ->

            }
            .build(this)

使用方法 sendData(data) 发送消息：

serialPort.sendData("Hello World")

至此，你已经可以快速的开发一款能够完成基本收发数据的串口应用了。当然，SerialPort 还有着更多的功能，请继续阅读说明文档。