Flutter音频效果插件sound_effect的使用

Flutter音频效果插件sound_effect的使用

sound_effect 是一个用于播放带有简单API和最低延迟的音频效果的Flutter插件。

开始使用

在使用任何其他方法之前，先初始化插件：

import 'package:sound_effect/sound_effect.dart';

void main() async {
  final _soundEffect = SoundEffect();
  await _soundEffect.initialize();
}

加载声音效果

使用唯一标识符和声音文件路径来加载声音效果：

Future<void> loadSound(String soundId) async {
  await _soundEffect.load(soundId, 'assets/sound_effect.mp3');
}

播放声音效果

播放已加载的声音效果：

Future<void> playSound(String soundId) async {
  await _soundEffect.play(soundId);
}

你还可以使用自定义音量播放声音效果：

_soundEffect.play('effect', volume: 0.5);

释放已加载的声音

当不再需要已加载的声音时，释放它们：

_soundEffect.release();

完整示例代码

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

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

import 'package:sound_effect/sound_effect.dart';

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

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

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

class _MyAppState extends State<MyApp> {
  final _soundEffectPlugin = SoundEffect();

  bool _soundLoaded = false;
  String? _loadError;

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

  Future<void> loadSounds() async {
    try {
      await _soundEffectPlugin.initialize();
      await _soundEffectPlugin.load('demo', 'assets/sounds/demo.mp3');
      setState(() {
        _soundLoaded = true;
      });
    } catch (e) {
      setState(() {
        _loadError = e.toString();
      });
    }
  }

  Future<void> releaseSounds() async {
    await _soundEffectPlugin.release();
  }

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('SoundEffect示例应用'),
        ),
        body: Padding(
          padding: const EdgeInsets.all(16.0),
          child: Column(
            crossAxisAlignment: CrossAxisAlignment.stretch,
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              if (_loadError != null)
                Text(_loadError!)
              else if (_soundLoaded) ...[
                ElevatedButton(
                  onPressed: () {
                    _soundEffectPlugin.play('demo');
                  },
                  child: const Text('播放声音'),
                ),
                const SizedBox(height: 16),
                ElevatedButton(
                  onPressed: () {
                    _soundEffectPlugin.play('demo', volume: 0.3);
                  },
                  child: const Text('播放声音（30%音量）'),
                ),
              ] else
                const CircularProgressIndicator(),
            ],
          ),
        ),
      ),
    );
  }
}