美文网首页
LDBluetoothSDK的文档

LDBluetoothSDK的文档

作者: Flypiggy | 来源:发表于2017-09-22 10:54 被阅读0次

    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)

    相关文章

      网友评论

          本文标题:LDBluetoothSDK的文档

          本文链接:https://www.haomeiwen.com/subject/cavxextx.html