Flutter音频波形展示插件general_audio_waveforms的使用

General Audio Waveforms 是一个用于在 Flutter 应用中添加音频波形的 UI 包。该包是对 pub.dev 上的 flutter_audio_waveforms 包的定制。

特性

• 曲线多边形波形
• 多边形波形
• 脉冲波形
• 矩形波形
• 波浪形波形

你可以从以下选项中选择波形的来源：

• 音频文件源（AudioFileSource）
• 网络音频源（AudioNetworkSource）
• 资源音频源（AudioAssetSource）
• 数据源（AudioDataSource）

该包还提供了缩放选项来调整波形中显示的数据点数量。你可以使用平均或中位数缩放器根据实际数据大小和所需大小创建桶。每个桶的平均值或中位数将作为最终波形的代表。

开始使用

要开始使用 General Audio Waveforms 包，请按照以下步骤操作：

1. 在 pubspec.yaml 文件中添加该包：

dependencies:
  general_audio_waveforms: ^0.0.10

1. 在 Dart 代码中导入该包：

import 'package:general_audio_waveforms/general_audio_waveforms.dart';

使用方法

以下是一个简单的示例，展示了如何在应用中使用 General Audio Waveforms 包：

GeneralAudioWaveform(
  scalingAlgorithmType: ScalingAlgorithmType.average,
  source: AudioAssetSource(path: "assets/sample.mp3"),
  maxSamples: 20,
  waveformType: WaveformType.pulse,
  maxDuration: maxDuration,
  elapsedDuration: elapsedTime,
  elapsedIsChanged: (d) {
    setState(() {
      elapsedTime = d;
    });
  },
),

完整示例代码

import 'dart:async';

import 'package:flutter/material.dart';
import 'package:general_audio_waveforms/general_audio_waveforms.dart';
import 'package:permission_handler/permission_handler.dart';

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

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'General Audio Waveform',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        colorScheme: ColorScheme.fromSeed(seedColor: Colors.deepPurple),
        useMaterial3: true,
      ),
      home: const MyHomePage(title: 'General Audio Waveforms'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  Duration elapsedTime = const Duration(seconds: 0);
  Duration maxDuration = const Duration(seconds: 150);

  String path = "/storage/emulated/0/Download/file_example_MP3_700KB.mp3";

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

  Future<void> requestPermissions() async {
    await [
      Permission.storage,
      Permission.manageExternalStorage,
      Permission.mediaLibrary,
    ].request();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            GeneralAudioWaveform(
              scalingAlgorithmType: ScalingAlgorithmType.average,
              source: AudioAssetSource(path: "assets/sample.mp3"),
              maxSamples: 100,
              waveformType: WaveformType.pulse,
              maxDuration: maxDuration,
              elapsedDuration: elapsedTime,
              waveformStyle: WaveformStyle(
                activeColor: Colors.red
              ),
              elapsedIsChanged: (d) {
                setState(() {
                  elapsedTime = d;
                });
              },
            ),
          ],
        ),
      ),
    );
  }
}