LDBluetoothSDK的文档

1.集成准备：

（一）导入SDK：

由于本SDK没有使用其他的第三方，基本用原生构造，无需其他配置，直接将LDBluetooth.framework拖入工程即可。

不过一些版本的xocde可能需要手动添加一下Linked Frameworks and Libraries,如图所示：

4643819C-7EF9-4424-BFA8-6C7210B0CFAE.png

2.基本功能集成使用：

（一）引入头文件：

在需要使用的类中引入头文件：#import <LDBluetooth/LDBluetooth.h >

（二）使用蓝牙操作类：

由于苹果原生的CoreBluetooth的代理方法使用起来，比较复杂，不够清晰，于是SDK在其基础上做了一些封装，将基本的代理方法的调用封在一个操作类里（LDBluetoothOperation），类中有所有代理方法的对应block。使用时，只需实例化一个操作类，对相应的block赋值，再将操作对象注册给管理类（LDBluetoothManager），具体代码示例：

#import "ViewController.h"
#import <LDBluetooth/LDBluetooth.h>

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    LDBluetoothOperation *opt = [[LDBluetoothOperation alloc] init];
    opt.managerDidDiscoverPeripheral = ^(CBPeripheral *p) {
        // 此处可进行相应操作
    };
    [[LDBluetoothManager defaultManager] registerBluetoothOperation:opt];
    // 由于SDK必须保证掌握手机蓝牙的可用性,所以该方法一定必须要调用。
    [[LDBluetoothManager defaultManager] listenCBMangerStateChange:^(CBManagerState state) {
        
    }];
}

（三）使用门禁相关的功能：

门禁的所有功能都已封装好，无需使用上文（二）中所提的操作类，使用过程也比较简单明了，首先要有个实例化的管理类LDBluetoothManager，这个使用者可以自行创建或直接使用SDK的单例 [LDBluetoothManager defaultManager] ，然后要用该管理类监听手机的蓝牙状态，代码如下：

// 由于必须保证掌握手机蓝牙的可用性,所以该方法一定必须要调用。
    [[LDBluetoothManager defaultManager] listenCBMangerStateChange:^(CBManagerState state) {
        
    }];

接着需要扫描设备，直接使用SDK的扫描代码：

    MBProgressHUD *hud = [MBProgressHUD showHUDAddedTo:self.view animated:YES];
    hud.label.text = @"扫描设备...";
    _dataSource = [NSMutableArray array];
    [_manager scanPeripheralsWithSeconds:2000 callBack:^(CBPeripheral *p) {
        if (![self.dataSource containsObject:p]) {
            [self.dataSource addObject:p];
            [self.tableView reloadData];
        }
        [hud hideAnimated:YES];
    }];

1.蓝牙开门：直接调用SDK中的开门方法即可，不过要注意在开门过程中如需停止，可调用：

[[LDBluetoothManager defaultManager] cancelConnectedPeripheral:self.peripheral];

开门的具体代码如下：

[[LDBluetoothManager defaultManager] openTheDoorWithPeripheral:self.peripheral completion:^(BOOL success, LDError *error) {
                isOpening = NO;
                if (success) {
                    [weakSelf showAlertWithTitle:@"开门成功" message:@"门已开启"];
                    weakSelf.tipsLabel.text = @"门已开启";
                }else{
                    // 开门发生的错误处理，这里只简单描述几个，根据开发者需要，自行描述。
                    NSString *errMsg = @"";
                    switch (error.errorCode) {
                        case LDBLEErrorCodeFailToGetOpenKey:
                            errMsg = @"从服务器获取开门秘钥失败";
                            break;
                        case LDBLEErrorCodeTimeout:
                            errMsg = @"连接超时";
                            break;
                        case LDBLEErrorCodeUnknow:
                            errMsg = @"未知错误";
                            break;
                        default:
                            errMsg = @"概括来说就是蓝牙传输错误";
                            break;
                    }
                    [weakSelf showAlertWithTitle:@"开门失败" message:errMsg];
                    weakSelf.tipsLabel.text = @"开门失败";
                }
            }];

2.下发卡：需要对某个具体设备进行操作，获取这个设备的DeviceNumber（连接获取读写特征等步骤都已封装在其中，不需要其他调用。），获取到后再将需要派发的卡和删除的卡写入到设备（需要注意的是，setupICCardWithPeripheral这个方法中传入的需要增加addCardNumbers和需要删除cancelCardNumbers的卡，必须是NSMutableArray，我这里的处理是往设备中写入成功的卡会从该数组中移除，所以结束之后，需要判断原来的NSMutableArray中还剩余几个没有被写入的。），并从设备获取到相关的开门记录，该方法中有过程回调和结果回调，过程回调是为了详细的说明配置门禁到了具体的步骤，其中具体过程用枚举LDSetupICCardStepType判断（注意：因为增删卡是使用者自己传入，所以只返回了有效的剩余数left，总数total默认给的是0，需要使用者自行处理。），结果回调要记得调用[[LDBluetoothManager defaultManager] finishSetupICCard]来结束结束配置。：

    MBProgressHUD *hud = [MBProgressHUD showHUDAddedTo:self.view animated:YES];
    hud.label.text = @"正在获取设备号";
    LDBluetoothManager *manager = [LDBluetoothManager defaultManager];
    [manager getDeviceNumberWithPeripheral:_peripheral completion:^(NSString *deviceNum, LDError *error) {
        
        if (error) {
            NSLog(@"获取设备号失败：%@",error);
            dispatch_async(dispatch_get_main_queue(), ^{
                [hud hideAnimated:YES];
            });
            [self showAlertWithMessage:[NSString stringWithFormat:@"获取设备号失败：%@",error]];
            [manager finishSetupICCard];
            return;
        }
        self.navigationItem.title = [NSString stringWithFormat:@"设备号：%@",deviceNum];
        if (!self.dataSource) {
            [self showAlertWithMessage:@"请先下载卡信息"];
            self.dataSource = [NSMutableArray array];
        }
        NSMutableArray *adds = [NSMutableArray array];
        NSMutableArray *cancels = [NSMutableArray array];
        NSMutableArray *cardList = [NSMutableArray array];
        for (LDCard *card in self.dataSource) {
            if ([card.devHostNum isEqualToString:deviceNum]) {
                if ([card.cardStatus intValue]) {
                    [cancels addObject:card.cardNum];
                }else{
                    [adds addObject:card.cardNum];
                }
                [cardList addObject:card];
            }
        }
        NSLog(@"%@-----%@",adds,cancels);
        hud.label.text = @"正在一键配置门禁";
        [manager setupICCardWithPeripheral:_peripheral deviceNumber:deviceNum addCardNumbers:adds cancelCardNumbers:cancels progress:^(LDSetupICCardStepType stepType, NSUInteger left, NSUInteger total) {
            
        } completion:^(NSArray *data, LDError *error) {
            [[LDBluetoothManager defaultManager] finishSetupICCard];
            if (error) {
                NSLog(@"上传记录失败%ld",error.errorCode);
                [self showAlertWithMessage:[NSString stringWithFormat:@"发生了错误：%ld",error.errorCode]];
            }
            if (data.count) {
                // 拼装数据
                NSArray<LDRecord *> *recordList = data;
                NSMutableArray *swipeRecord = [NSMutableArray array];
                NSMutableDictionary *param = [NSMutableDictionary dictionary];
                param[@"version"] = @"1.0";
                for (LDRecord *model in recordList) {
                    NSMutableDictionary *dict = [NSMutableDictionary dictionary];
                    dict[@"devHostNum"] = model.deviceNum;
                    dict[@"cardNum"] = [model.cardNum substringWithRange:NSMakeRange(0, 8)];
                    dict[@"swipeDatetime"] = model.date;
                    dict[@"inOut"] = model.inOut;
                    [swipeRecord addObject:dict];
                }
                param[@"swipeRecord"] = swipeRecord;
                AFHTTPSessionManager *mgr = [[AFHTTPSessionManager alloc] init];
                mgr.requestSerializer = [[AFJSONRequestSerializer alloc] init];
                [mgr.requestSerializer setValue:@"5e810181-c592-48b6-9ae5-458a26bfbc7f" forHTTPHeaderField:@"guid"];
                [mgr.requestSerializer setValue:@"70396E7391D4EC1CB1FE2A54C63867D1" forHTTPHeaderField:@"password"];
                [mgr POST:@"http://192.168.31.125:7935/api/card/uploadRecord" parameters:param progress:^(NSProgress * _Nonnull uploadProgress) {
                    
                } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
                    NSLog(@"%@",responseObject);
                    [self showAlertWithMessage:[NSString stringWithFormat:@"成功上传开门记录:%@",swipeRecord]];
                } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
                    NSLog(@"%@",error);
                    [self showAlertWithMessage:@"网络失败，无法上传开门记录"];
                }];
                
            }else{
                [self showAlertWithMessage:@"无记录可传！！！"];
            }
            NSMutableArray *Ids = [NSMutableArray array];
            NSMutableArray *failures = [NSMutableArray array];
            NSLog(@"%@-----%@",adds,cancels);
            for (LDCard *card in cardList) {
                if (![adds containsObject:card.cardNum] && ![cancels containsObject:card.cardNum]) {
                    [Ids addObject:card.identity];
                }else{
                    [failures addObject:card.identity];
                }
            }
            AFHTTPSessionManager *mgr = [[AFHTTPSessionManager alloc] init];
            mgr.requestSerializer = [[AFJSONRequestSerializer alloc] init];
            [mgr.requestSerializer setValue:@"5e810181-c592-48b6-9ae5-458a26bfbc7f" forHTTPHeaderField:@"guid"];
            [mgr.requestSerializer setValue:@"70396E7391D4EC1CB1FE2A54C63867D1" forHTTPHeaderField:@"password"];
            [mgr POST:@"http://192.168.31.125:7935/api/card/updateCard" parameters:@{@"version":@"1.0",@"identityList":Ids} progress:^(NSProgress * _Nonnull uploadProgress) {
                
            } success:^(NSURLSessionDataTask * _Nonnull task, id  _Nullable responseObject) {
                NSLog(@"%@",responseObject);
                [self showAlertWithMessage:[NSString stringWithFormat:@"派发增删卡-----成功:%@,-------失败%@",Ids,failures]];
            } failure:^(NSURLSessionDataTask * _Nullable task, NSError * _Nonnull error) {
                NSLog(@"%@",error);
                [self showAlertWithMessage:@"网络失败，无法派发增删卡"];
            }];
            dispatch_async(dispatch_get_main_queue(), ^{
                [hud hideAnimated:YES];
            });
//            [self cancelDo];
        }];
    }];

以上代码中的网络请求，是用来处理后台控制派发卡的，基本的逻辑都在代码中SDK的接口也基本都有注释，更加详尽的内容可以参考demo，如仍有不清楚的请随时向开发人员提问，（工作QQ：884287502）