有部分开发人员,加群之后,直接问设备扫描不到,服务扫描出错,特性扫描报错,怎么办?
对于这类问题,要严厉批评,都是因为懒,没有用心去看官方文档或者关于CoreBluetooth的教程。
所以对于蓝牙的连接处理流程不清晰的,严重建议先看iOS CoreBluetooth 的使用讲解
自己动手写Demo,把系统的CoreBluetooth的使用,以及蓝牙的流程搞懂了,再开始做蓝牙打印的功能。
该项目中包含两个部分的工具类HLBluetooth
和HLPrinter
,蓝牙操作和打印小票功能。
如果只是做蓝牙打印机打印小票的功能,可以看我的另一个工程SEBLEPrinter
因为系统的蓝牙操作库是用delegate实现的,步骤比较繁多,操作很零散,需要写一堆的代理方法,特别麻烦
所以我用block方式重写了,蓝牙管理的所有代码在HLBluetooth目录中。
又因为项目中要用蓝牙控制打印机打印小票,我又把蓝牙打印机的操作封装了一下,所有代码在HLPrinter目录下。
用block改写后,使用大致分为三步:
- 获取蓝牙模块的状态
- 扫描蓝牙外设
- 连接、扫描服务、扫描特性、扫描描述。
因为连接、扫描服务、扫描特性、扫描描述也是属于不同的阶段,所以在block返回时,也有阶段值返回。
---------------------------------------------------------------------------------------------------------
除了上面这些代理方法改写的block API之外,还有一些操作性方法,
比如:
- 读取特性值
- 读取描述值
- 往特性中写入数据
- 往描述中写入数据
- 读取信号数据
- 取消蓝牙连接 ...
以上这些方法也提供block方式和一般的调用方式。
蓝牙打印机模板可以打印的格式有
- 单行文字格式
[printer appendText:title alignment:HLTextAlignmentCenter fontSize:HLFontSizeTitleBig];
[printer appendText:str1 alignment:HLTextAlignmentCenter];
- 左标题右参数格式
[printer appendTitle:@"时间:" value:@"2016-04-27 10:01:50" valueOffset:150];
[printer appendTitle:@"订单:" value:@"4000020160427100150" valueOffset:150];
[printer appendTitle:@"总计:" value:totalStr];
[printer appendTitle:@"实收:" value:@"100.00"];
- 三列数据格式
[printer appendLeftText:@"商品" middleText:@"数量" rightText:@"单价" isTitle:YES];
[printer appendLeftText:dict[@"name"] middleText:dict[@"amount"] rightText:dict[@"price"] isTitle:NO];
- 分隔线
[printer appendSeperatorLine];
- 图片
[printer appendImage:[UIImage imageNamed:@"ico180"] alignment:HLTextAlignmentCenter maxWidth:300];
- 二维码
[printer appendQRCodeWithInfo:@"www.baidu.com" size:10];
[printer appendQRCodeWithInfo:@"www.baidu.com"];
- 条形码
[printer appendBarCodeWithInfo:@"123456789012"];
关于详细的BLE使用方式和打印小票的功能,在这里有篇文章详细说明 打印机的指令有ASCII、10进制和16进制三种,我使用的是16进制。
Byte QRSize [] = {0x1D,0x28,0x6B,0x03,0x00,0x31,0x43,size}; // 这是16进制,其中最后一个size是10进制数,转换为NSData后,会被转换为16进制。
Byte QRSize [] = {29,40,107,3,0,49,67,size}; // 这是10进制。
据佳博的一技术人员提供的一些参数:
汉字是24 x 24点阵,字符是12 x 24。
58mm 型打印机横向宽度384个点。(可是我用文字设置相对位置测试确实368,囧)
80mm 型打印机横向宽度576个点。
1mm 大概是8个点。
修复部分型号打印乱码,乱码后再次打印没反应的Bug。(2016-06-13)
demo中也有一个使用的例子
如有使用错误或者更好的建议,请issues我。
首先,确定你使用的是标签打印机还是一般的小票打印机。 我写的Demo不支持标签打印机,你可以仿照我的例子,自己封装一下指令(我们并没有采购标签打印机,也没办法测试,抱歉了)。 如果你连接成功,但是发出打印指令后,打印机没反应,很有可能是因为你的打印机一次发送的数据长度小于146,你把146改的更小一点试试看。 我测试的两台佳博打印机,一台没有长度限制,一台最多每次只能发送146个字节,否则会出现打印没反应的情况,需要重启打印机。 不同的打印机,可能对长度的限制不太一样,据群友反应有的打印机只能支持一次发送20个字节,所以你需要将宏里面的146改的更小一点。
目前验证测试的功能有打印文字、图片、条形码、二维码。
以上四个功能全支持的品牌和型号有:
佳博(GP58130IVC、GP58130IC、GP58MBIII、GP-58MBIII)
芯烨(XPrinter 某型号)
(待补充)
支持部分功能的有: (待补充)
为了能便于大家做适配和排查问题,希望你能反馈一下你使用的打印机品牌和型号,先表示感谢了。