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

---

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

Class name	解释	备注
CentralManager	蓝牙中央的管理器,主要功能:蓝牙的搜索链接等操作
BaseParser	基础解析器类	创建自己的解析器时,务必继承此类,可以省掉很多基本操作
BaseCommand	命令的基类,做了很多基础工作,如超时的定时器管理等	任何命令类都必须继承此类
D2PHosting	在命令没开始/结束后，D2PHosting接管代理权,监听设备传向App的数据	这里可以处理设备的请求,如找手机等协议操作
ParserSession	蓝牙解析器的抽象类
CmdConstants	常量管理类

使用

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")
    }