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)
网友评论