Flutter音频均衡器插件equalizer_flutter的使用

equalizer_flutter 是一个用于在Flutter应用中打开设备均衡器的插件。您也可以为Android创建自定义均衡器。请注意，该插件目前仅支持Android平台，iOS的支持仍在开发中。

Android 设置

为了创建一个自定义均衡器，在项目的AndroidManifest.xml文件中添加以下权限以允许修改音频设置：

<manifest>
    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
    <application...>
    
    ...
    </application...>
</manifest>

使用示例

导入包

首先，确保您已经在项目中导入了equalizer_flutter包：

import 'package:equalizer_flutter/equalizer_flutter.dart';

打开设备均衡器

您可以使用audioSessionId来打开设备自带的均衡器：

EqualizerFlutter.open(audioSessionId);

初始化和释放资源

• 在initState方法中初始化均衡器：

  EqualizerFlutter.init(audioSessionId);
  

• 在dispose方法中释放资源：

  EqualizerFlutter.release();
  

自定义均衡器操作

启用或禁用自定义均衡器：

EqualizerFlutter.setEnabled(true); // 启用
// 或者
EqualizerFlutter.setEnabled(false); // 禁用

获取频段水平范围、中心频率、预设名称等信息，并进行相应的设置：

await EqualizerFlutter.getBandLevelRange(); // 获取频段水平范围
await EqualizerFlutter.getCenterBandFreqs(); // 获取中心频率
await EqualizerFlutter.getPresetNames(); // 获取可用预设名称
EqualizerFlutter.setPreset('预设名'); // 设置预设

完整示例代码

以下是完整的示例代码，展示了如何使用equalizer_flutter插件：

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

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

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {

  bool enableCustomEQ = false;

  [@override](/user/override)
  void initState() {
    super.initState();
    EqualizerFlutter.init(0);
  }

  [@override](/user/override)
  void dispose() {
    EqualizerFlutter.release();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Equalizer example'),
        ),
        body: ListView(
          children: [
            SizedBox(height: 10.0),
            Center(
              child: Builder(
                builder: (context) {
                  return ElevatedButton.icon(
                    icon: Icon(Icons.equalizer),
                    label: Text('Open device equalizer'),
                    onPressed: () async {
                      try {
                        await EqualizerFlutter.open(0);
                      } on PlatformException catch (e) {
                        final snackBar = SnackBar(
                          behavior: SnackBarBehavior.floating,
                          content: Text('${e.message}\n${e.details}'),
                        );
                        ScaffoldMessenger.of(context).showSnackBar(snackBar);
                      }
                    },
                  );
                },
              ),
            ),
            SizedBox(height: 10.0),
            Container(
              color: Colors.grey.withOpacity(0.1),
              child: SwitchListTile(
                title: Text('Custom Equalizer'),
                value: enableCustomEQ,
                onChanged: (value) {
                  EqualizerFlutter.setEnabled(value);
                  setState(() {
                    enableCustomEQ = value;
                  });
                },
              ),
            ),
            SizedBox(height: 20,),
            FutureBuilder<List<int>>(
              future: EqualizerFlutter.getBandLevelRange(),
              builder: (context, snapshot) {
                return snapshot.connectionState == ConnectionState.done
                    ? CustomEQ(enableCustomEQ, snapshot.data!)
                    : CircularProgressIndicator();
              },
            ),
          ],
        ),
      ),
    );
  }
}

// 其余部分省略...