Flutter手电筒功能插件torch_flashlight的使用

torch_flashlight 是一个用于在移动设备上控制手电筒（闪光灯）开关功能的Flutter插件。本文将介绍如何安装和使用该插件，并提供完整的示例代码。

特性

检查手电筒可用性

确定设备是否支持手电筒功能。

启动手电筒

启用设备的手电筒功能。

关闭手电筒

关闭设备的手电筒功能。

定时切换手电筒

以指定间隔定时切换手电筒，实现闪烁效果。

安装

在 pubspec.yaml 文件中添加 torch_flashlight 依赖：

dependencies:
  torch_flashlight: ^0.0.2

运行以下命令安装包：

flutter pub get

在 Dart 代码中导入包：

import 'package:torch_flashlight/torch_flashlight.dart';

使用方法

检查手电筒可用性

bool isAvailable = await TorchFlashlight.isTorchFlashlightAvailable();

启动手电筒

await TorchFlashlight.enableTorchFlashlight();

关闭手电筒

await TorchFlashlight.disableTorchFlashlight();

定时切换手电筒

await TorchFlashlight.torchFlashlightEnableDisablePeriodically(
  onOffInterval: Duration(seconds: 1),
  disableTorchRandomlyInSeconds: true,
);

停止定时切换手电筒

await TorchFlashlight.stopTorchFlashlightPeriodically();

示例代码

以下是一个完整的 Flutter 应用程序示例，演示了如何使用 torch_flashlight 插件来控制手电筒。

import 'package:flutter/material.dart';
import 'dart:async';
import 'package:torch_flashlight/torch_flashlight.dart';

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

class TorchApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: TorchController(),
    );
  }
}

class TorchController extends StatefulWidget {
  @override
  _TorchControllerState createState() => _TorchControllerState();
}

class _TorchControllerState extends State<TorchController> {
  bool isTorchOn = false;
  Timer? _timer;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Torch App'),
      ),
      body: Column(
        children: [
          SizedBox(
            height: 250,
            child: FutureBuilder<bool>(
              future: _isTorchAvailable(),
              builder: (BuildContext context, AsyncSnapshot<bool> snapshot) {
                if (snapshot.connectionState == ConnectionState.waiting) {
                  return const Center(child: CircularProgressIndicator());
                } else if (snapshot.hasData && snapshot.data!) {
                  return Center(
                    child: Column(
                      mainAxisAlignment: MainAxisAlignment.center,
                      children: [
                        IconButton(
                          iconSize: 100,
                          icon: Icon(
                            isTorchOn ? Icons.flashlight_on : Icons.flashlight_off,
                            color: isTorchOn ? Colors.yellow : Colors.grey,
                          ),
                          onPressed: _toggleTorch,
                        ),
                      ],
                    ),
                  );
                } else {
                  return const Center(child: Text('No torch available.'));
                }
              },
            ),
          ),
          const SizedBox(height: 20),
          ElevatedButton.icon(
            icon: Icon(Icons.flash_on),
            label: const Text('Enable Torch'),
            onPressed: () => _enableTorch(),
          ),
          const SizedBox(height: 10),
          ElevatedButton.icon(
            icon: Icon(Icons.flash_off),
            label: const Text('Disable Torch'),
            onPressed: () => _disableTorch(),
          ),
          const SizedBox(height: 10),
          ElevatedButton.icon(
            icon: Icon(Icons.timer),
            label: const Text('Torch Enable Periodically'),
            onPressed: () => _torchEnablePeriodically(),
          ),
          const SizedBox(height: 10),
          ElevatedButton.icon(
            icon: Icon(Icons.timer),
            label: const Text('Stop Torch Enable Periodically'),
            onPressed: () => _torchDisablePeriodically(),
          ),
        ],
      ),
    );
  }

  Future<bool> _isTorchAvailable() async {
    try {
      return await TorchFlashlight.isTorchFlashlightAvailable();
    } catch (e) {
      _showMessage('Could not check if the device has an available torch');
      return false;
    }
  }

  Future<void> _toggleTorch() async {
    if (isTorchOn) {
      await _disableTorch();
    } else {
      await _enableTorch();
    }
  }

  Future<void> _enableTorch() async {
    try {
      await TorchFlashlight.enableTorchFlashlight();
      setState(() {
        isTorchOn = true;
      });
    } catch (e) {
      _showMessage('Could not enable torch');
    }
  }

  Future<void> _disableTorch() async {
    try {
      await TorchFlashlight.disableTorchFlashlight();
      setState(() {
        isTorchOn = false;
      });
    } catch (e) {
      _showMessage('Could not disable torch');
    }
  }

  Future<void> _torchEnablePeriodically() async {
    try {
      await TorchFlashlight.torchFlashlightEnableDisablePeriodically(
        onOffInterval: const Duration(milliseconds: 300),
        disableTorchRandomlyInSeconds: true,
      );
    } catch (e) {
      _showMessage('Could not enable torch periodically');
    }
  }

  Future<void> _torchDisablePeriodically() async {
    await TorchFlashlight.stopTorchFlashlightPeriodically();
  }

  void _showMessage(String message) {
    ScaffoldMessenger.of(context)
        .showSnackBar(SnackBar(content: Text(message)));
  }

  @override
  void dispose() {
    _timer?.cancel();
    super.dispose();
  }
}

通过上述步骤和示例代码，您可以轻松地在 Flutter 应用中集成并使用手电筒功能。