Flutter蓝牙启用管理插件bluetooth_enable的使用

简介

BluetoothEnable 是一个为 Flutter 开发者设计的蓝牙插件，用于在应用程序中通过编程方式请求开启蓝牙。
此插件旨在允许开发者自定义其应用的工作流程，以便在请求权限时更加灵活。
该插件目前仅支持 Android 平台。

使用方法

启用蓝牙

首先，需要导入 bluetooth_enable 插件并调用其方法来请求开启蓝牙。

import 'package:bluetooth_enable/bluetooth_enable.dart';

// 请求打开蓝牙
BluetoothEnable.enableBluetooth.then((value) {
  if (value == "true") {
    // 蓝牙已成功开启
  } else if (value == "false") {
    // 蓝牙未开启
  }
});

使用自定义弹窗启用蓝牙

此方法允许开发者在 Dart 层面调用一个自定义弹窗。根据用户的操作，蓝牙可以手动开启，或者弹窗关闭而无进一步操作。

参数说明

示例代码

import 'package:bluetooth_enable/bluetooth_enable.dart';

Future<void> customEnableBT(BuildContext context) async {
  String dialogTitle = "嘿！请允许本应用使用蓝牙！";
  bool displayDialogContent = true;
  String dialogContent = "本应用需要蓝牙才能连接设备。";
  // 或者：
  // bool displayDialogContent = false;
  // String dialogContent = "";

  String cancelBtnText = "拒绝";
  String acceptBtnText = "同意";
  double dialogRadius = 10.0;
  bool barrierDismissible = true;

  BluetoothEnable.customBluetoothRequest(
          context,
          dialogTitle,
          displayDialogContent,
          dialogContent,
          cancelBtnText,
          acceptBtnText,
          dialogRadius,
          barrierDismissible)
      .then((result) {
    if (result == "true") {
      // 蓝牙已成功开启
    }
  });
}

完整示例代码

以下是一个完整的示例代码，展示如何使用 bluetooth_enable 插件请求蓝牙开关功能。

import 'package:flutter/material.dart';
import 'package:bluetooth_enable/bluetooth_enable.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: "测试蓝牙插件",
      home: _MyAppState(),
    );
  }
}

class _MyAppState extends StatelessWidget {
  // 请求开启蓝牙
  Future<void> enableBT() async {
    BluetoothEnable.enableBluetooth.then((value) {
      print("蓝牙状态: $value");
    });
  }

  // 自定义请求开启蓝牙
  Future<void> customEnableBT(BuildContext context) async {
    String dialogTitle = "嘿！请允许本应用使用蓝牙！";
    bool displayDialogContent = true;
    String dialogContent = "本应用需要蓝牙才能连接设备。";
    // 或者：
    // bool displayDialogContent = false;
    // String dialogContent = "";

    String cancelBtnText = "拒绝";
    String acceptBtnText = "同意";
    double dialogRadius = 10.0;
    bool barrierDismissible = true;

    BluetoothEnable.customBluetoothRequest(
            context,
            dialogTitle,
            displayDialogContent,
            dialogContent,
            cancelBtnText,
            acceptBtnText,
            dialogRadius,
            barrierDismissible)
        .then((result) {
      print("结果: $result");
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text(
            '蓝牙启用插件示例',
          ),
          centerTitle: true,
        ),
        body: Center(
          child: Column(
            mainAxisSize: MainAxisSize.min,
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              Text("按下按钮请求开启蓝牙"),
              SizedBox(height: 20.0),
              ElevatedButton(
                onPressed: () {
                  enableBT();
                },
                child: Text('请求开启蓝牙'),
              ),
              SizedBox(height: 10.0),
              ElevatedButton(
                onPressed: () {
                  customEnableBT(context);
                },
                child: Text('自定义请求开启蓝牙'),
              ),
            ],
          ),
        ),
      ),
    );
  }
}