Android 蓝牙连接 ESC/POS 热敏打印机打印实例（蓝牙连接篇）

2024-02-25 20:15:03 48

公司的一个手机端的CRM项目最近要增加小票打印的功能，就是我们点外卖的时候经常会见到的那种小票。这里主要涉及到两大块的知识：

蓝牙连接及数据传输
ESC/POS打印指令

蓝牙连接不用说了，太常见了，这篇主要介绍这部分的内容。但ESC/POS打印指令是个什么鬼？简单说，我们常见的热敏小票打印机都支持这样一种指令，只要按照指令的格式向打印机发送指令，哪怕是不同型号品牌的打印机也会执行相同的动作。比如打印一行文本，换行，加粗等都有对应的指令，这部分内容放在下一篇介绍。

本篇主要基于官方文档，相比官方文档，省去了大段的说明，更加便于快速上手。

1.蓝牙权限

想要使用蓝牙功能，首先要在AndroidManifest配置文件中声明蓝牙权限：

...

BLUETOOTH权限只允许建立蓝牙连接以及传输数据，但是如果要进行蓝牙设备发现等操作的话，还需要申请BLUETOOTH_ADMIN权限。

2.初始配置

这里主要用到一个类BluetoothAdapter。用法很简单，直接看代码：

BluetoothAdaptermBluetoothAdapter=BluetoothAdapter.getDefaultAdapter();
if(mBluetoothAdapter==null){
//DevicedoesnotsupportBluetooth
}

单例模式，全局只有一个实例，只要为null，就代表设备不支持蓝牙，那么需要有相应的处理。

如果设备支持蓝牙，那么接着检查蓝牙是否打开：

if(!mBluetoothAdapter.isEnabled()){
Intentintent=newIntent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
startActivityForResult(intent,REQUEST_ENABLE_BT);
}

如果蓝牙未打开，那么执行startActivityForResult()后，会弹出一个对话框询问是否要打开蓝牙，点击`是`之后就会自动打开蓝牙。成功打开蓝牙后就会回调到onActivityResult()。

除了主动的打开蓝牙，还可以监听BluetoothAdapter.ACTION_STATE_CHANGED
广播，包含EXTRA_STATE和EXTRA_PREVIOUS_STATE两个extra字段，可能的取值包括STATE_TURNING_ON,STATE_ON,STATE_TURNING_OFF,andSTATE_OFF。含义很清楚了，不解释。

3.发现设备

初始化完成之后，蓝牙打开了，接下来就是扫描附近的设备，只需要一句话：

mBluetoothAdapter.startDiscovery();

不过这样只是开始执行设备发现，这肯定是一个异步的过程，我们需要注册一个广播，监听发现设备的广播，直接上代码：

privatefinalBroadcastReceivermReceiver=newBroadcastReceiver(){
publicvoidonReceive(Contextcontext,Intentintent){
Stringaction=intent.getAction();

//当有设备被发现的时候会收到action==BluetoothDevice.ACTION_FOUND的广播
if(BluetoothDevice.ACTION_FOUND.equals(action)){

//广播的intent里包含了一个BluetoothDevice对象
BluetoothDevicedevice=intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);

//假设我们用一个ListView展示发现的设备，那么每收到一个广播，就添加一个设备到adapter里
mArrayAdapter.add(device.getName()+"\n"+device.getAddress());
}
}
};
//注册广播监听
IntentFilterfilter=newIntentFilter(BluetoothDevice.ACTION_FOUND);
registerReceiver(mReceiver,filter);//Don'tforgettounregisterduringonDestroy

注释已经写的很清楚了，除了BluetoothDevice.EXTRA_DEVICE之外，还有一个extra字段BluetoothDevice.EXTRA_CLASS,可以得到一个BluetoothClass对象，主要用来保存设备的一些额外的描述信息，比如可以知道这是否是一个音频设备。

关于设备发现，有两点需要注意：

startDiscovery()只能扫描到那些状态被设为可发现的设备。安卓设备默认是不可发现的，要改变设备为可发现的状态，需要如下操作：

Intentintent=newIntent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);
//设置可被发现的时间，00s
intent.putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION,300);
startActivity(intent);

执行之后会弹出对话窗询问是否允许设备被设为可发现的状态，点击`是`之后设备即被设为可发现的状态。

startDiscovery()是一个十分耗费资源的操作，所以需要及时的调用cancelDiscovery()来释放资源。比如在进行设备连接之前，一定要先调用cancelDiscovery()

4.设备配对与连接

4.1配对

当与一个设备第一次进行连接操作的时候，屏幕会弹出提示框询问是否允许配对，只有配对成功之后，才能建立连接。

系统会保存所有的曾经成功配对过的设备信息。所以在执行startDiscovery()之前，可以先尝试查找已配对设备，因为这是一个本地信息读取的过程，所以比startDiscovery()要快得多，也避免占用过多资源。如果设备在蓝牙信号的覆盖范围内，就可以直接发起连接了。

查找配对设备的代码如下：

SetpairedDevices=mBluetoothAdapter.getBondedDevices();
if(pairedDevices.size()>0){
for(BluetoothDevicedevice:pairedDevices){
mArrayAdapter.add(device.getName()+"\n"+device.getAddress());
}
}

代码很简单，不解释了，就是调用BluetoothAdapter.getBondedDevices()得到一个Set并遍历取得已配对的设备信息。

4.2连接

蓝牙设备的连接和网络连接的模型十分相似，都是Client-Server模式，都通过一个socket来进行数据传输。那么作为一个Android设备，就存在三种情况：

只作为Client端发起连接
只作为Server端等待别人发起建立连接的请求
同时作为Client和Server

因为是为了下一篇介绍连接热敏打印机打印做铺垫，所以这里先讲Android设备作为Client建立连接的情况。因为打印机是不可能主动跟Android设备建立连接的，所以打印机必然是作为Server被连接。

4.2.1作为Client连接

首先需要获取一个BluetoothDevice对象。获取的方法前面其实已经介绍过了，可以通过调用startDiscovery()并监听广播获得，也可以通过查询已配对设备获得。
通过BluetoothDevice.createRfcommSocketToServiceRecord(UUID)得到BluetoothSocket对象
通过BluetoothSocket.connect()建立连接
异常处理以及连接关闭

废话不多说，上代码：

privateclassConnectThreadextendsThread{
privatefinalBluetoothSocketmmSocket;
privatefinalBluetoothDevicemmDevice;

publicConnectThread(BluetoothDevicedevice){

BluetoothSockettmp=null;
mmDevice=device;
try{
//通过BluetoothDevice获得BluetoothSocket对象
tmp=device.createRfcommSocketToServiceRecord(MY_UUID);
}catch(IOExceptione){}
mmSocket=tmp;
}

@Override
publicvoidrun(){
//建立连接前记得取消设备发现
mBluetoothAdapter.cancelDiscovery();
try{
//耗时操作，所以必须在主线程之外进行
mmSocket.connect();
}catch(IOExceptionconnectException){
//处理连接建立失败的异常
try{
mmSocket.close();
}catch(IOExceptioncloseException){}
return;
}
doSomething(mmSocket);
}

//关闭一个正在进行的连接
publicvoidcancel(){
try{
mmSocket.close();
}catch(IOExceptione){}
}
}

device.createRfcommSocketToServiceRecord(MY_UUID)这里需要传入一个UUID，这个UUID需要格外注意一下。简单的理解，它是一串约定格式的字符串，用来唯一的标识一种蓝牙服务。

Client发起连接时传入的UUID必须要和Server端设置的一样！否则就会报错！

如果是连接热敏打印机这种情况，不知道Server端设置的UUID是什么怎么办？
不用担心，因为一些常见的蓝牙服务协议已经有约定的UUID。比如我们连接热敏打印机是基于SPP串口通信协议，其对应的UUID是"00001101-0000-1000-8000-00805F9B34FB"，所以实际的调用是这样：


device.createRfcommSocketToServiceRecord(UUID.fromString("00001101-0000-1000-8000-00805F9B34FB"))

其他常见的蓝牙服务的UUID大家可以自行搜索。如果只是用于自己的应用之间的通信的话，那么理论上可以随便定义一个UUID，只要server和client两边使用的UUID一致即可。

4.2.2作为Server连接

通过BluetoothAdapter.listenUsingRfcommWithServiceRecord(String,UUID)获取一个BluetoothServerSocket对象。这里传入的第一个参数用来设置服务的名称，当其他设备扫描的时候就会显示这个名称。UUID前面已经介绍过了。
调用BluetoothServerSocket.accept()开始监听连接请求。这是一个阻塞操作，所以当然也要放在主线程之外进行。当该操作成功执行，即有连接建立的时候，会返回一个BluetoothSocket对象。
调用BluetoothServerSocket.close()会关闭监听连接的服务，但是当前已经建立的链接并不会受影响。

还是看代码吧:

privateclassAcceptThreadextendsThread{

privatefinalBluetoothServerSocketmmServerSocket;

publicAcceptThread(){

BluetoothServerSockettmp=null;
try{
//client必须使用一样的UUID!!!
tmp=mBluetoothAdapter.listenUsingRfcommWithServiceRecord(NAME,MY_UUID);
}catch(IOExceptione){}
mmServerSocket=tmp;
}

@Override
publicvoidrun(){
BluetoothSocketsocket=null;
//阻塞操作
while(true){
try{
socket=mmServerSocket.accept();
}catch(IOExceptione){
break;
}
//直到有有连接建立，才跳出死循环
if(socket!=null){
//要在新开的线程执行，因为连接建立后，当前线程可能会关闭
doSomething(socket);
mmServerSocket.close();
break;
}
}
}

publicvoidcancel(){
try{
mmServerSocket.close();
}catch(IOExceptione){}
}
}

5.数据传输

终于经过了前面的4步，万事俱备只欠东风。而最后这一部分其实是最简单的，因为就只是简单的利用InputStream和OutputStream进行数据的收发。

示例代码：

privateclassConnectedThreadextendsThread{
privatefinalBluetoothSocketmmSocket;
privatefinalInputStreammmInStream;
privatefinalOutputStreammmOutStream;

publicConnectedThread(BluetoothSocketsocket){
mmSocket=socket;
InputStreamtmpIn=null;
OutputStreamtmpOut=null;
//通过socket得到InputStream和OutputStream
try{
tmpIn=socket.getInputStream();
tmpOut=socket.getOutputStream();
}catch(IOExceptione){}

mmInStream=tmpIn;
mmOutStream=tmpOut;
}

publicvoidrun(){
byte[]buffer=newbyte[1024];//bufferstoreforthestream
intbytes;//bytesreturnedfromread()

//不断的从InputStream取数据
while(true){
try{
bytes=mmInStream.read(buffer);
mHandler.obtainMessage(MESSAGE_READ,bytes,-1,buffer)
.sendToTarget();
}catch(IOExceptione){
break;
}
}
}

//向Server写入数据
publicvoidwrite(byte[]bytes){
try{
mmOutStream.write(bytes);
}catch(IOExceptione){}
}

publicvoidcancel(){
try{
mmSocket.close();
}catch(IOExceptione){}
}
}

下一篇介绍通过手机操作热敏打印机打印的时候，还会用到这部分内容，所以这里就先不多讲了。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持毛票票。

Android 蓝牙连接 ESC/POS 热敏打印机打印实例（蓝牙连接篇）

热门推荐

随机推荐