该项目中包含两个部分的工具类HLBluetooth
和HLPrinter
,蓝牙操作和打印小票功能。
如果只是做蓝牙打印机打印小票的功能,可以看我的另一个工程SEBLEPrinter
因为系统的蓝牙操作库是用delegate实现的,步骤比较繁多,操作很零散,需要写一堆的代理方法,特别麻烦
所以我用block方式重写了,蓝牙管理的所有代码在HLBluetooth目录中。
又因为项目中要用蓝牙控制打印机打印下票,我又把蓝牙打印机的操作封装了一下,所有代码在HLPrinter目录下。
用block改写后,使用大致分为三步:
- 获取蓝牙模块的状态
- 扫描蓝牙外设
- 连接、扫描服务、扫描特性、扫描描述。
因为连接、扫描服务、扫描特性、扫描描述也是属于不同的阶段,所以在block返回时,也有阶段值返回。
---------------------------------------------------------------------------------------------------------
除了上面这些代理方法改写的block API之外,还有一些操作性方法,
比如:
- 读取特性值
- 读取描述值
- 往特性中写入数据
- 往描述中写入数据
- 读取信号数据
- 取消蓝牙连接 ...
以上这些方法也提供block方式和一般的调用方式。
蓝牙打印机模板可以打印的格式有单行文字格式、左标题右参数格式、三列数据格式、分隔线、图片、二维码、条形码等。
现添加了预览效果图,因为打印机的字号和字体与iOS的字号、字体有很大偏差,所以预览效果图与实际效果也有些偏差,出入不大,预览仅供参考。
关于详细的BLE使用方式和打印小票的功能,在这里有篇文章详细说明
附加一个将NSData转换为16进制字符串的方法,因为有人反馈说,同一型号的打印机,有的打印机出来乱码有的正常。 可以在打印前将数据都转换成16进制,与打印机的指令集对比,查找是拼接NSData出错,还是打印机原因。 也可以尝试自己拼接NSData测试打印情况。这里有篇关于蓝牙打印机指令的文章:打印机指令
- (NSString *)hexStringFromData:(NSData *)printerData{
Byte *bytes = (Byte *)[printerData bytes];
NSString *hexStr = @"";
for(int i = 0; i < [printerData length]; i++) {
NSString *newHexStr = [NSString stringWithFormat:@"%x",bytes[i]&0xff];///16进制数
newHexStr = [newHexStr uppercaseString];
if([newHexStr length]==1) {
hexStr = [NSString stringWithFormat:@"%@ 0%@",hexStr,newHexStr];
} else {
hexStr = [NSString stringWithFormat:@"%@ %@",hexStr,newHexStr];
}
}
NSLog(@"%@",hexStr);
return hexStr;
}
demo中也有一个使用的例子
如有使用错误或者更好的建议,请issues我。