iOS 蓝牙开发(ble4.0) -swift版

迷南。 2022-06-13 02:13 297阅读 0赞

# CmdBluetooth #

[本文来自简书，原文地址:http://www.jianshu.com/p/0a09171b5b86][http_www.jianshu.com_p_0a09171b5b86]

> 项目地址：[https://github.com/ZeroFengLee/CmdBluetooth][https_github.com_ZeroFengLee_CmdBluetooth]

CmdBluetooth是一个针对于iOS的轻量级可扩展框架,Core内部将蓝牙周边抽象化，用户无需关注蓝牙内的操作细节与流程，仅需要你们自己的蓝牙协议，创造出自己的命令对象。

以往的蓝牙协议都是集中式处理，出现逻辑复杂且混乱的现象，以至于扩展困难。CmdBluetooth将蓝牙的每条协议封装成不同命令对象，将复杂的逻辑分发下去，使得代码可读性增强，这也使得CmdBluetooth可以轻松的处理蓝牙协议的串行操作。

我们团队当前开发使用的是OC版本，已经适用于5套以上不同的蓝牙协议。swift版本在完善中，如果你有好的建议，欢迎提交你的PR。

## 开始使用 ##

*  将文件夹 "CmdBluetoothCore"导入到项目中
 *  参照文件夹 "CMDS" 根据具体的蓝牙协议封装命令
 *  参照 "ViewController"中使用框架

## 框架结构 ##

### CmdBluetoothCore ###

*  `CentralManager`
 *  `BaseParser`
 *  `BaseCommand`
 *  `D2PHosting`
 *  `ParserSession`
 *  `CmdConstants`

### CMDS ###

> 下面文件是使用者需要修改和扩展的，MyParser继承于BaseParser，SynTimeCmd继承于BaseCommand

*  `MyParser`
 *  `SynTimeCmd`

--------------------

> 下面是每个类文件的角色解释

<table style="border-collapse:collapse; border-spacing:0px; width:620px; margin-bottom:20px; border-top:1px solid rgb(221,221,221); border-right:1px solid rgb(221,221,221); border-bottom:1px solid rgb(221,221,221); border-left:none; word-break:normal; color:rgb(47,47,47); font-size:16px"> 
 <thead style=""> 
  <tr style=""> 
   <th style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> <span style="">Class name</span></th> 
   <th style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> <span style="">解释</span></th> 
   <th style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> <span style="">备注</span></th> 
  </tr> 
 </thead> 
 <tbody style=""> 
  <tr style=""> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> CentralManager</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> 蓝牙中央的管理器,主要功能:蓝牙的搜索链接等操作</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> &nbsp;</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> BaseParser</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> 基础解析器类</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> 创建自己的解析器时,务必继承此类,可以省掉很多基本操作</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> BaseCommand</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> 命令的基类,做了很多基础工作,如超时的定时器管理等</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> 任何命令类都必须继承此类</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> D2PHosting</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> 在命令没开始/结束后，D2PHosting接管代理权,监听设备传向App的数据</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> 这里可以处理设备的请求,如找手机等协议操作</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> ParserSession</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> 蓝牙解析器的抽象类</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> &nbsp;</td> 
  </tr> 
  <tr style=""> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> CmdConstants</td> 
   <td style="padding:8px; border:1px solid rgb(221,221,221); line-height:20px; vertical-align:middle"> 常量管理类</td> 
  </tr> 
 </tbody> 
</table>

### 使用 ###

1.  拥有自己的解析器
    
    > 你只需要继承BaseParser类,并创建你的写入方法,请参照MyParser.swift

/** define types for writing data to BLE device, like this */
        func writeDataWithResponse(data: NSData) {
    
            super.writeData(data, characterUuidStr: "fff6", withResponse: true)
        }
    
        func writeDataWithoutResponse(data: NSData) {
    
            super.writeData(data, characterUuidStr: "ff10", withResponse: false)
        }
    
        //......Many....many ^_^!

1.  创建蓝牙命令 (假如你有20个蓝牙命令,那你需要20个这样的文件)
    
    > 请参照SynTimeCmd(时间同步命令),蓝牙主要是问答式的。
2.  在命令开始前，一定要调用父类的start()方法去判断解析器是否可用。
    
        if !super.start() {
              //...
          }
3.  在调用start()方法前，你可以设置超时时间(default:4)
    
        super.timeoutInterval = 5
4.  在往蓝牙写数据时,记得把parserSession转成自己的解析器
    
        (self.parserSession! as! MyParser).writeDataWithResponse(self.testData())
5.  复写父类的failure()方法,并调用super.failure()。检测超时失败的情况
    
        override func failure() {
        
              super.failure()
          }
6.  在成功后调用父类的finish()刷新解析器的状态
    
        case 1:
              closureSuccess!()
              super.finish()
              break
7.  使用CentralManager类来进行蓝牙的扫描链接等
    
    > 比较简单,请参照Demo.  
    > 注意点:一定要传入自己的解析器对象,否则连接的周边无法被解析
    > 
    >     centerManager.parser = MyParser()
8.  发送蓝牙协议
    
        SynTimeCmd().setCurrentTime({ () -> Void in
        
             print("suc")
         ) { () -> Void in
        
             print("fail")
         }

[http_www.jianshu.com_p_0a09171b5b86]: http://www.jianshu.com/p/0a09171b5b86
[https_github.com_ZeroFengLee_CmdBluetooth]: https://github.com/ZeroFengLee/CmdBluetooth