美文网首页iOS开发杂货铺iOS知识点iOS工程实践
蓝牙API

蓝牙API

作者: travin | 来源:发表于2016-08-24 15:19 被阅读378次

    如果你进来了,点下关注行不行_

    CBCentralManager 中心设备管理类#

    //设置中心设备代理
@property(assign, nonatomic, nullable) id<CBCentralManagerDelegate> delegate;
//中心设备当前状态
@property(readonly) CBCentralManagerState state;
//中心设备是否正在扫描
@property(readonly) BOOL isScanning NS_AVAILABLE(NA, 9_0);

    CBCentralManagerState 设备状态#

    typedef NS_ENUM(NSInteger, CBCentralManagerState) {
    //状态未知
    CBCentralManagerStateUnknown = 0,
    //连接断开 即将重置
    CBCentralManagerStateResetting,
    //该平台不支持蓝牙
    CBCentralManagerStateUnsupported,
    //未授权蓝牙使用
    CBCentralManagerStateUnauthorized,
    //蓝牙关闭
    CBCentralManagerStatePoweredOff,
    //蓝牙正常开启
    CBCentralManagerStatePoweredOn,
};

    初始化CBCentralManager方法#

    //初始化方法
//设置的代理需要遵守CBCentralManagerDelegate协议
//queue可以设置蓝牙扫描的线程 传入nil则为在主线程中进行
- (instancetype)initWithDelegate:(nullable id<CBCentralManagerDelegate>)delegate
queue:(nullable dispatch_queue_t)queue;
//此方法同上 在options字典中用于进行一些管理中心的初始化属性设置
//字典中支持的键值如下
/*
 NSString * const CBCentralManagerOptionShowPowerAlertKey 对应一个NSNumber类型的bool值，用于设置是否在关闭蓝牙时弹出用户提示
 NSString * const CBCentralManagerOptionRestoreIdentifierKey 对应一个NSString对象，设置管理中心的标识符ID
 */
- (instancetype)initWithDelegate:(nullable id<CBCentralManagerDelegate>)delegate
queue:(nullable dispatch_queue_t)queue
options:(nullable NSDictionary<NSString *, id> *)options;

    根据获取连接设备列表#

    //�根据服务NSUUID,获取所有设备,并返回一个列表
- (NSArray<CBPeripheral *> *)retrievePeripheralsWithIdentifiers:(NSArray<NSUUID *> *)identifiers;
//根据服务id获取所有连接的设备
- (NSArray<CBPeripheral *> *)retrieveConnectedPeripheralsWithServices:(NSArray<CBUUID *> *)serviceUUIDs;

    初始化CBCentralManager后,会自动回调代理方法#

    //这个方法中可以获取到管理中心的状态
- (void)centralManagerDidUpdateState:(CBCentralManager *)central;

    扫描蓝牙设备方法#

    // serviceUUIDs     :  用于扫描一个特点ID的外设
// options          :  用于设置一些扫描属性 键值如下
/*
 //是否允许重复扫描 对应NSNumber的bool值，默认为NO，会自动去重
 NSString *const CBCentralManagerScanOptionAllowDuplicatesKey;
 //要扫描的设备UUID 数组 对应NSArray
 NSString *const CBCentralManagerScanOptionSolicitedServiceUUIDsKey;
 */
- (void)scanForPeripheralsWithServices:(nullable NSArray<CBUUID *> *)serviceUUIDs options:(nullable NSDictionary<NSString *, id> *)options;

    停止蓝牙扫描的方法#

    - (void)stopScan;

    扫描成功的方法#

    // peripheral 扫描到的外设
// advertisementData是外设发送的广播数据
// RSSI 是信号强度
- (void)centralManager:(CBCentralManager *)central didDiscoverPeripheral:(CBPeripheral *)peripheral advertisementData:(NSDictionary<NSString *, id> *)advertisementData RSSI:(NSNumber *)RSSI;

    连接设备的方法#

    /*
 options中可以设置一些连接设备的初始属性键值如下
 //对应NSNumber的bool值，设置当外设连接后是否弹出一个警告
 NSString *const CBConnectPeripheralOptionNotifyOnConnectionKey;
 //对应NSNumber的bool值，设置当外设断开连接后是否弹出一个警告
 NSString *const CBConnectPeripheralOptionNotifyOnDisconnectionKey;
 //对应NSNumber的bool值，设置当外设暂停连接后是否弹出一个警告
 NSString *const CBConnectPeripheralOptionNotifyOnNotificationKey;
 */
- (void)connectPeripheral:(CBPeripheral *)peripheral options:(nullable NSDictionary<NSString *, id> *)options;

    取消连接设备的方法#

    //取消一个外设的连接
- (void)cancelPeripheralConnection:(CBPeripheral *)peripheral;

    连接后处理的方法#

    //连接外设成功
- (void)centralManager:(CBCentralManager *)central didConnectPeripheral:(CBPeripheral *)peripheral;
//连接外设失败
- (void)centralManager:(CBCentralManager *)central didFailToConnectPeripheral:(CBPeripheral *)peripheral error:(nullable NSError *)error;
//断开外设连接
- (void)centralManager:(CBCentralManager *)central didDisconnectPeripheral:(CBPeripheral *)peripheral error:(nullable NSError *)error;

    当管理中心恢复时会调用如下方法#

    //dict中会传入如下键值对
/*
 //恢复连接的外设数组
 NSString *const CBCentralManagerRestoredStatePeripheralsKey;
 //恢复连接的服务UUID数组
 NSString *const CBCentralManagerRestoredStateScanServicesKey;
 //恢复连接的外设扫描属性字典数组
 NSString *const CBCentralManagerRestoredStateScanOptionsKey;
 */
- (void)centralManager:(CBCentralManager *)central willRestoreState:(NSDictionary<NSString *, id> *)dict;

    外设的设备的方法,(找服务,找特征)#

    //设置代理
@property(assign, nonatomic, nullable) id<CBPeripheralDelegate> delegate;
//外设name
@property(retain, readonly, nullable) NSString *name;
//信号强度
@property(retain, readonly, nullable) NSNumber *RSSI NS_DEPRECATED(NA, NA, 5_0, 8_0);
//外设状态
/*
 typedef NS_ENUM(NSInteger, CBPeripheralState) {
 CBPeripheralStateDisconnected = 0,//未连接
 CBPeripheralStateConnecting,//正在链接
 CBPeripheralStateConnected,//已经连接
 CBPeripheralStateDisconnecting NS_AVAILABLE(NA, 9_0),//正在断开连接
 } NS_AVAILABLE(NA, 7_0);
 */
@property(readonly) CBPeripheralState state;
//所有的服务数组
@property(retain, readonly, nullable) NSArray<CBService *> *services;
//获取当前信号强度
- (void)readRSSI;
//根据服务UUID寻找服务对象
- (void)discoverServices:(nullable NSArray<CBUUID *> *)serviceUUIDs;
//在服务对象UUID数组中寻找特定服务
- (void)discoverIncludedServices:(nullable NSArray<CBUUID *> *)includedServiceUUIDs forService:(CBService *)service;
//在一个服务中寻找特征值
- (void)discoverCharacteristics:(nullable NSArray<CBUUID *> *)characteristicUUIDs forService:(CBService *)service;
//从一个特征中读取数据
- (void)readValueForCharacteristic:(CBCharacteristic *)characteristic;
//写数据的最大长度
//type枚举如下
/*
 typedef NS_ENUM(NSInteger, CBCharacteristicWriteType) {
 CBCharacteristicWriteWithResponse = 0,//写数据并且接收成功与否回执
 CBCharacteristicWriteWithoutResponse,//写数据不接收回执
 };
 */
- (NSUInteger)maximumWriteValueLengthForType:(CBCharacteristicWriteType)type NS_AVAILABLE(NA, 9_0);
//向某个特征中写数据
- (void)writeValue:(NSData *)data forCharacteristic:(CBCharacteristic *)characteristic type:(CBCharacteristicWriteType)type;
//为制定的特征值设置监听通知
- (void)setNotifyValue:(BOOL)enabled forCharacteristic:(CBCharacteristic *)characteristic;
//寻找特征值的描述
- (void)discoverDescriptorsForCharacteristic:(CBCharacteristic *)characteristic;
//读取特征的描述值
- (void)readValueForDescriptor:(CBDescriptor *)descriptor;
//写特征的描述值
- (void)writeValue:(NSData *)data forDescriptor:(CBDescriptor *)descriptor;

    外设方法的回调,代理方法#

    //外设名称更改时回调的方法
- (void)peripheralDidUpdateName:(CBPeripheral *)peripheral NS_AVAILABLE(NA, 6_0);
//外设服务变化时回调的方法
- (void)peripheral:(CBPeripheral *)peripheral didModifyServices:(NSArray<CBService *> *)invalidatedServices NS_AVAILABLE(NA, 7_0);
//信号强度改变时调用的方法
- (void)peripheralDidUpdateRSSI:(CBPeripheral *)peripheral error:(nullable NSError *)error NS_DEPRECATED(NA, NA, 5_0, 8_0);
//读取信号强度回调的方法
- (void)peripheral:(CBPeripheral *)peripheral didReadRSSI:(NSNumber *)RSSI error:(nullable NSError *)error NS_AVAILABLE(NA, 8_0);
//发现服务时调用的方法
- (void)peripheral:(CBPeripheral *)peripheral didDiscoverServices:(nullable NSError *)error;
//在服务中发现子服务回调的方法
- (void)peripheral:(CBPeripheral *)peripheral didDiscoverIncludedServicesForService:(CBService *)service error:(nullable NSError *)error;
//发现服务的特征值后回调的方法
- (void)peripheral:(CBPeripheral *)peripheral didDiscoverCharacteristicsForService:(CBService *)service error:(nullable NSError *)error;
//特征值更新时回调的方法
- (void)peripheral:(CBPeripheral *)peripheral didUpdateValueForCharacteristic:(CBCharacteristic *)characteristic error:(nullable NSError *)error;
//向特征值写数据时回调的方法
- (void)peripheral:(CBPeripheral *)peripheral didWriteValueForCharacteristic:(CBCharacteristic *)characteristic error:(nullable NSError *)error;
//特征值的通知设置改变时触发的方法
- (void)peripheral:(CBPeripheral *)peripheral didUpdateNotificationStateForCharacteristic:(CBCharacteristic *)characteristic error:(nullable NSError *)error;
//发现特征值的描述信息触发的方法
- (void)peripheral:(CBPeripheral *)peripheral didDiscoverDescriptorsForCharacteristic:(CBCharacteristic *)characteristic error:(nullable NSError *)error;
//特征的描述值更新时触发的方法
- (void)peripheral:(CBPeripheral *)peripheral didUpdateValueForDescriptor:(CBDescriptor *)descriptor error:(nullable NSError *)error;
//写描述信息时触发的方法
- (void)peripheral:(CBPeripheral *)peripheral didWriteValueForDescriptor:(CBDescriptor *)descriptor error:(nullable NSError *)error;

    CBService服务的方法#

    //对应的外设
@property(assign, readonly, nonatomic) CBPeripheral *peripheral;
//是否是初等服务
@property(readonly, nonatomic) BOOL isPrimary;
//包含的自服务
@property(retain, readonly, nullable) NSArray<CBService *> *includedServices;
//服务中的特征值
@property(retain, readonly, nullable) NSArray<CBCharacteristic *> *characteristics;

    Characteristic特征的方法#

    //对应的服务对象
@property(assign, readonly, nonatomic) CBService *service;
//特征值的属性 枚举如下
/*
 typedef NS_OPTIONS(NSUInteger, CBCharacteristicProperties) {
 CBCharacteristicPropertyBroadcast,//允许广播特征
 CBCharacteristicPropertyRead,//可读属性
 CBCharacteristicPropertyWriteWithoutResponse,//可写并且接收回执
 CBCharacteristicPropertyWrite,//可写属性
 CBCharacteristicPropertyNotify,//可通知属性
 CBCharacteristicPropertyIndicate,//可展现的特征值
 CBCharacteristicPropertyAuthenticatedSignedWrites,//允许签名的特征值写入
 CBCharacteristicPropertyExtendedProperties,
 CBCharacteristicPropertyNotifyEncryptionRequired,
 CBCharacteristicPropertyIndicateEncryptionRequired
 };
 */
@property(readonly, nonatomic) CBCharacteristicProperties properties;
//特征值的数据
@property(retain, readonly, nullable) NSData *value;
//特征值的描述
@property(retain, readonly, nullable) NSArray<CBDescriptor *> *descriptors;
//是否是当前广播的特征
@property(readonly) BOOL isBroadcasted;
//是否是正在通知的特征
@property(readonly) BOOL isNotifying;

    相关文章

      网友评论

      • 活久见_db66:能问下车载蓝牙的通话怎么做吗？
      • wujiandao07:蓝牙耳机采集音频数据保存到手机，可行不
        travin:想做录音功能？这方面没有做过，蓝牙交互的数据没有分析过。抱歉

      本文标题：蓝牙API

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

      延伸阅读

      深度阅读

      • 您也可以注册成为美文阅读网的作者，发表您的原创作品、分享您的心情！

      栏目导航

      热点阅读

      iOS开发杂货铺

      iOS知识点

      iOS工程实践

      关于我们|服务条款|联系我们|蓝牙API|投稿指南|网站地图|RSS订阅|排版工具|手机版

      提供经典美文摘抄,优美散文欣赏,现代诗歌精选,短篇小说,心情随笔,表白情书范文,故事会在线阅读欣赏

      Copyright © 2014-2023 Haomeiwen.com All Rights Reserved. 好美文阅读网 版权所有

      备案信息：桂公网安备 45052102000051号 · 桂ICP备13007215号-3

      本站所收录作品、热点评论等信息部分来源互联网，目的只是为了系统归纳学习和传递资讯

      所有作品版权归原创作者所有，与本站立场无关，如不慎侵犯了你的权益，请联系我们告知，我们将做删除处理！