Netguru为您提供的易于使用的蓝牙开源库。
🤹🏻♂️ 特性
- 处理远程外设的连接。
- 处理将iPhone作为蓝牙LE外设进行广告。
- 基于闭包的读/写/通知请求。
- 带有
Command包装器的内置数据转换方法。
📲 连接
以下是一个简单的代码示例，展示如何连接到外设。
真的就这么多
let connection = BluetoothConnection.shared
let characteristic = try! Characteristic(uuid: "your_characteristic_uuid", shouldObserveNotification: true)
let service = try! Service(uuid: "your_service_uuid", characteristics: [characteristic])
let configuration = try! Configuration(services: [service], advertisement: "your_advertising_uuid")
let peripheral = Peripheral(configuration: configuration)
connection.connect(peripheral) { error in
// do awesome stuff
}📡 广告模式
以下是一个设置iPhone以便进行蓝牙广告的代码示例。
只需这一步就可以广告一个包含一个特性的服务。
let characteristic = try! Characteristic(uuid: "your_characteristic_uuid")
let service = try! Service(uuid: "your_service_uuid", characteristics: [characteristic])
let configuration = try! Configuration(services: [service], advertisement: "your_service_uuid")
let peripheral = Peripheral(configuration: configuration, advertisementData: [.localName("Test"), .servicesUUIDs("your_service_uuid")])
advertisement.advertise(peripheral: peripheral) { error in
// oh no, something failed in that case
}📟 📲 数据传输
当然，数据传输也是可能的，无论是广告模式还是连接模式！下面有一些基本示例，更多信息请参阅下方的更多用法部分 👇🏻
连接模式
let command = Command.utf8String("Hello world")
peripheral.write(command: command, characteristic: someCharacteristic, handler: { error in
// written!
})
peripheral.read(characteristic, handler: { data, error in
// read!
})广告模式
let command = Command.int8(3)
advertisement.update(command, characteristic: characteristic) { error in
// data updated!
}
advertisement.writeRequestCallback = { characteristic, data in
// written!
}⚙️ 更多用法
有关更多高级用法，请查看以下文档页面的信息： https://netguru.github.io/BlueSwift/。
还可以查看与此仓库捆绑的示例项目！ 👩🏼🏫 👨🏼🏫 这是一个完整的应用程序，允许两个iPhone之间的连接和发送文本消息。
🛠 依赖项管理
BlueSwift 可以拖放到项目目录中，
但更重要的是，它受大多数常用依赖关系管理支持！
只需将以下行添加到您的 Podfile
pod 'BlueSwift'
(但您可能希望将其固定到最近的主要版本，所以 pod 'BlueSwift' , '~> 1.1.5')
与 Cocoapods 相同，将以下行添加到您的 Cartfile
github 'netguru/BlueSwift'
或包括版本来 - github 'netguru/BlueSwift' ~> 1.1.5
📄 许可证
(就像所有酷的开源软件一样，它是...)
在 MIT 许可证下授权。
如果能在我们这里留言，关于您的用法，那就太好了！！