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

torchx 是一个用于控制设备手电筒（闪光灯）的Flutter插件。它支持Android和iOS平台，并允许你设置手电筒的亮度级别。

TorchX Flutter Library

支持的版本

• Android: SDK 23+ (Lollipop)
• iOS: iOS 10+

手电筒亮度级别范围

使用方法

1. 添加依赖

在你的 pubspec.yaml 文件中添加 torchx 依赖：

dependencies:
  torchx: ^latest_version

请确保替换 ^latest_version 为实际的最新版本号。

2. 导入包

在你的 Dart 文件中导入 torchx 包：

import 'package:torchx/torchx.dart';

3. 控制手电筒

开启手电筒

Torch.instance.flashOn();

设置手电筒亮度并开启

double torchLevel = 0.5; // iOS: 0.1 - 1.0, Android: 1 - 5
Torch.instance.flashOnLevel(strengthLevel: torchLevel);

关闭手电筒

Torch.instance.flashOff();

检查手电筒状态

bool isTorched = await Torch.instance.isTorched;

获取当前手电筒亮度级别

double currentLevel = await Torch.instance.getLevel();

设置手电筒亮度级别

double newLevel = 0.7; // iOS: 0.1 - 1.0, Android: 1 - 5
Torch.instance.setLevel(strengthLevel: newLevel);

完整示例代码

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

import 'dart:io';

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

void main() {
  runApp(const ExampleApp());
}

class ExampleApp extends StatefulWidget {
  const ExampleApp({super.key});

  @override
  State<ExampleApp> createState() => _ExampleAppState();
}

class _ExampleAppState extends State<ExampleApp> {
  double level = 0;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('TorchX Example')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: flashOn,
                child: const Text("Flash On"),
              ),
              ElevatedButton(
                onPressed: flashOff,
                child: const Text("Flash Off"),
              ),
              ElevatedButton(
                onPressed: increaseFlashOnLevel,
                child: const Text("Increase Brightness"),
              ),
              ElevatedButton(
                onPressed: decreaseFlashOnLevel,
                child: const Text("Decrease Brightness"),
              ),
              ElevatedButton(
                onPressed: checkTorchLevel,
                child: const Text("Check Current Level"),
              ),
              ElevatedButton(
                onPressed: checkTorchState,
                child: const Text("Check Torch State"),
              ),
            ],
          ),
        ),
      ),
    );
  }

  void flashOn() async {
    Torch.instance.flashOn();
  }

  void flashOff() {
    Torch.instance.flashOff();
  }

  void increaseFlashOnLevel() async {
    if (Platform.isIOS) {
      level += 0.1;
    } else {
      level++;
    }
    debugPrint("increase level:$level");

    if (level >= Torch.maxLevel) {
      level = Torch.maxLevel;
    }

    Torch.instance
        .flashOnLevel(strengthLevel: double.parse(level.toStringAsFixed(1)));
  }

  void decreaseFlashOnLevel() async {
    if (Platform.isIOS) {
      level -= 0.1;
    } else {
      level--;
    }
    debugPrint("decrease level:$level");

    if (level <= Torch.minLevel) {
      level = Torch.minLevel;
    }

    Torch.instance
        .flashOnLevel(strengthLevel: double.parse(level.toStringAsFixed(1)));
  }

  void checkTorchLevel() async {
    level = await Torch.instance.getLevel();
    debugPrint("checkTorchLevel - level:$level");
  }

  void checkTorchState() async {
    bool isTorched = await Torch.instance.isTorched;
    debugPrint("checkTorchState - isTorched:$isTorched");
  }
}

这个示例应用提供了几个按钮，分别用于开启和关闭手电筒、调整亮度级别以及检查当前的手电筒状态和亮度级别。你可以根据需要进一步扩展和自定义这个示例。