LDBluetoothSDK的文档
2017-09-22 本文已影响0人
Flypiggy
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）
