Flutter手电筒控制插件torch_light的使用

简介

torch_light 是一个简单的Flutter插件，用于管理设备的手电筒/闪光灯。通过该插件，您可以在您的Flutter应用程序中轻松地启用和禁用手电筒功能。

使用步骤

1. 导入库

首先，在您的Dart代码中导入torch_light库：

import 'package:torch_light/torch_light.dart';

2. 检查设备是否支持手电筒

在使用手电筒功能之前，建议先检查设备是否支持手电筒功能：

try {
  final isTorchAvailable = await TorchLight.isTorchAvailable();
  if (isTorchAvailable) {
    // 设备支持手电筒功能
  } else {
    // 设备不支持手电筒功能
  }
} on Exception catch (_) {
  // 处理错误
}

3. 启用/禁用手电筒

根据需要启用手电筒或将其关闭：

// 启用手电筒
try {
  await TorchLight.enableTorch();
} on Exception catch (_) {
  // 处理错误
}

// 禁用手电筒
try {
  await TorchLight.disableTorch();
} on Exception catch (_) {
  // 处理错误
}

如果您希望更精确地处理可能出现的异常，可以捕获特定类型的异常：

// 启用手电筒并处理所有可能的错误
try {
  await TorchLight.enableTorch();
} on EnableTorchExistentUserException catch (e) {
  // 相机正在被使用
} on EnableTorchNotAvailableException catch (e) {
  // 手电筒未检测到
} on EnableTorchException catch (e) {
  // 由于其他原因无法启用手电筒
}

// 禁用手电筒并处理所有可能的错误
try {
  await TorchLight.disableTorch();
} on DisableTorchExistentUserException catch (e) {
  // 相机正在被使用
} on DisableTorchNotAvailableException catch (e) {
  // 手电筒未检测到
} on DisableTorchException catch (e) {
  // 由于其他原因无法禁用手电筒
}

示例Demo

以下是一个完整的示例应用，展示了如何在Flutter应用中使用torch_light插件来控制手电筒：

import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';
import 'package:torch_light/torch_light.dart';

void main() {
  runApp(TorchApp());
}

class TorchApp extends StatefulWidget {
  @override
  _TorchAppState createState() => _TorchAppState();
}

class _TorchAppState extends State<TorchApp> {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      supportedLocales: const [Locale('en', '')],
      localizationsDelegates: const [
        GlobalMaterialLocalizations.delegate,
        GlobalWidgetsLocalizations.delegate,
      ],
      home: TorchController(),
    );
  }
}

class TorchController extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('torch_light example app'),
      ),
      body: FutureBuilder<bool>(
        future: _isTorchAvailable(context),
        builder: (BuildContext context, AsyncSnapshot<bool> snapshot) {
          if (snapshot.hasData && snapshot.data!) {
            return Column(
              children: [
                Expanded(
                  child: Center(
                    child: ElevatedButton(
                      child: const Text('Enable torch'),
                      onPressed: () async {
                        _enableTorch(context);
                      },
                    ),
                  ),
                ),
                Expanded(
                  child: Center(
                    child: ElevatedButton(
                      child: const Text('Disable torch'),
                      onPressed: () {
                        _disableTorch(context);
                      },
                    ),
                  ),
                ),
              ],
            );
          } else if (snapshot.hasData) {
            return const Center(
              child: Text('No torch available.'),
            );
          } else {
            return const Center(
              child: CircularProgressIndicator(),
            );
          }
        },
      ),
    );
  }

  Future<bool> _isTorchAvailable(BuildContext context) async {
    final scaffoldMessenger = ScaffoldMessenger.of(context);

    try {
      return await TorchLight.isTorchAvailable();
    } on Exception catch (_) {
      scaffoldMessenger.showSnackBar(
        const SnackBar(
          content: Text('Could not check if the device has an available torch'),
        ),
      );
      rethrow;
    }
  }

  Future<void> _enableTorch(BuildContext context) async {
    final scaffoldMessenger = ScaffoldMessenger.of(context);

    try {
      await TorchLight.enableTorch();
    } on Exception catch (_) {
      scaffoldMessenger.showSnackBar(
        const SnackBar(
          content: Text('Could not enable torch'),
        ),
      );
    }
  }

  Future<void> _disableTorch(BuildContext context) async {
    final scaffoldMessenger = ScaffoldMessenger.of(context);

    try {
      await TorchLight.disableTorch();
    } on Exception catch (_) {
      scaffoldMessenger.showSnackBar(
        const SnackBar(
          content: Text('Could not disable torch'),
        ),
      );
    }
  }
}

此示例创建了一个包含两个按钮的应用程序：一个用于启用手电筒，另一个用于禁用手电筒。它还检查设备是否支持手电筒，并在不支持时向用户显示消息。