搜尋套件、儲存庫與 APP 分類

GitHub 儲存庫truongsinh/flutter_bluetooth

flutter_bluetooth

Flutter 的藍牙外掛程式

flutter_bluetooth 專案封面
星標
20
分支
13
最近推送(UTC)
2020年5月2日
專案狀態
未封存

原始 README

以下為英文專案原文快照,最新內容請造訪 GitHub。

pub package

Introduction

Type-safe, minimalistic Buetooth plugin for Flutter, a fork from orignal "FlutterBlue" plugin.

Cross-Platform Bluetooth LE

This plugin aims to offer the most from both platforms (iOS and Android).

Using the FlutterBlue instance, you can scan for and connect to nearby devices (BluetoothDevice). Once connected to a device, the BluetoothDevice object can discover services (BluetoothService), characteristics (BluetoothCharacteristic), and descriptors (BluetoothDescriptor). The BluetoothDevice object is then used to directly interact with characteristics and descriptors.

Usage

Obtain an instance
FlutterBlue flutterBlue = FlutterBlue.instance;
Scan for devices
/// Start scanning
var scanSubscription = flutterBlue.scan().listen((scanResult) {
    // do something with scan result
});

/// Stop scanning
scanSubscription.cancel();
Connect to a device
/// Create a connection to the device
var deviceConnection = flutterBlue.connect(device).listen((s) {
    if(s == BluetoothDeviceState.connected) {
        // device is connected, do something
    }
});

/// Disconnect from device
deviceConnection.cancel();
Discover services
List<BluetoothService> services = await device.discoverServices();
services.forEach((service) {
    // do something with service
});
Read and write characteristics
// Reads all characteristics
var characteristics = service.characteristics;
for(BluetoothCharacteristic c in characteristics) {
    List<int> value = await device.readCharacteristic(c);
    print(value);
}

// Writes to a characteristic
await device.writeCharacteristic(c, [0x12, 0x34])
Read and write descriptors
// Reads all descriptors
var descriptors = characteristic.descriptors;
for(BluetoothDescriptor d in descriptors) {
    List<int> value = await device.readDescriptor(d);
    print(value);
}

// Writes to a descriptor
await device.writeDescriptor(d, [0x12, 0x34])
Set notifications
await device.setNotifyValue(characteristic, true);
device.onValueChanged(characteristic).listen((value) {
    // do something with new value
});

Reference

FlutterBlue API
Android iOS Description
scan :white_check_mark: :white_check_mark: Starts a scan for Bluetooth Low Energy devices.
connect :white_check_mark: :white_check_mark: Establishes a connection to the Bluetooth Device.
state :white_check_mark: :white_check_mark: Gets the current state of the Bluetooth Adapter.
onStateChanged :white_check_mark: :white_check_mark: Stream of state changes for the Bluetooth Adapter.
BluetoothDevice API
Android iOS Description
discoverServices :white_check_mark: :white_check_mark: Discovers services offered by the remote device as well as their characteristics and descriptors.
services :white_check_mark: :white_check_mark: Gets a list of services. Requires that discoverServices() has completed.
readCharacteristic :white_check_mark: :white_check_mark: Retrieves the value of a specified characteristic.
readDescriptor :white_check_mark: :white_check_mark: Retrieves the value of a specified descriptor.
writeCharacteristic :white_check_mark: :white_check_mark: Writes the value of a characteristic.
writeDescriptor :white_check_mark: :white_check_mark: Writes the value of a descriptor.
setNotifyValue :white_check_mark: :white_check_mark: Sets notifications or indications on the specified characteristic.
onValueChanged :white_check_mark: :white_check_mark: Notifies when the characteristic's value has changed.
state :white_check_mark: :white_check_mark: Gets the current state of the Bluetooth Device.
onStateChanged :white_check_mark: :white_check_mark: Notifies of state changes for the Bluetooth Device.

Troubleshooting

Scanning for service UUID's doesn't return any results

Make sure the device is advertising which service UUID's it supports. This is found in the advertisement packet as UUID 16 bit complete list or UUID 128 bit complete list.

TruongSinh Tran-Nguyen GitHub avatar
GitHub 作者

TruongSinh Tran-Nguyen ↗

@inspectorioinc Ho Chi Minh
語言Objective-CDartJavaRuby

此儲存庫發佈的套件

使用的依賴

依賴清單 8 項

  • flutter{"sdk":"flutter"}
  • convert^2.1.1
  • protobuf^0.13.4
  • uuid_enhanced^3.0.2
  • collection^1.14.11
  • meta^1.1.6
  • pedantic開發依賴^1.5.0
  • flutter_test開發依賴{"sdk":"flutter"}

如何選擇適合專案的儲存庫?

先依使用情境篩選,再比較專案活躍情況,最後到原始儲存庫確認使用要求。

  1. 透過儲存庫名稱、作者或描述搜尋,再依技術分類縮小範圍。
  2. 綜合星標、分支與最近推送比較專案;星標反映社群關注,不保證品質。
  3. 使用前在 GitHub 確認 README、授權條款與 Issues。

來源與維護

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗