Flutter铃声管理插件flutter_ringtone_manager的使用

flutter_ringtone_manager 是一个用于在 Flutter 应用中播放系统默认铃声和自定义音频文件的插件。该插件支持 Android 和 iOS 平台，允许开发者轻松访问和播放设备上的各种声音效果。

关键特性

• 播放自定义资源文件中的音频。
• 播放系统的铃声、闹钟和通知音效。
• 在 iOS 上通过 ID 播放系统短促音效。

快速开始

自定义资源音频

要播放位于 assets 文件夹下的自定义音频文件，请确保在 pubspec.yaml 中正确配置了资源路径：

flutter:
  assets:
    - assets/audio/test.mp3

然后可以使用如下代码播放音频：

FlutterRingtoneManager().playAudioAsset("audio/test.mp3");

默认警报音效

你可以直接调用以下方法来播放系统默认的声音：

FlutterRingtoneManager().playRingtone();
FlutterRingtoneManager().playAlarm();
FlutterRingtoneManager().playNotification();

iOS 系统声音 ID

在 iOS 上，可以通过指定系统声音 ID 来播放特定的系统音效：

FlutterRingtoneManager().playIosSystemSoundByID(SystemSoundID.mailSent);

系统声音 IDs 列表

更多详细信息请参见官方文档或源码注释。

示例 Demo

以下是完整的示例程序，展示了如何在应用中集成和使用 flutter_ringtone_manager 插件：

import 'dart:async';
import 'dart:io';

import 'package:flutter/material.dart';
import 'package:flutter_ringtone_manager/flutter_ringtone_manager.dart';
import 'package:flutter_ringtone_manager/ios_system_sounds.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 _flutterRingtoneManager = FlutterRingtoneManager();

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

  Future<void> initPlatformState() async {
    if (!mounted) return;
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: SizedBox(
          width: double.infinity,
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            crossAxisAlignment: CrossAxisAlignment.center,
            children: [
              OutlinedButton(
                onPressed: () {
                  _flutterRingtoneManager.playRingtone();
                },
                child: const Text("Play Ringtone"),
              ),
              OutlinedButton(
                onPressed: () => {_flutterRingtoneManager.playAlarm()},
                child: const Text('Play Alarm'),
              ),
              OutlinedButton(
                onPressed: () {
                  _flutterRingtoneManager.playNotification();
                },
                child: const Text("Play Notification"),
              ),
              ElevatedButton(
                onPressed: () {
                  _flutterRingtoneManager.playAudioAsset("audio/test.mp3");
                },
                child: const Text("Play custom Asset"),
              ),
              if (Platform.isIOS)
                OutlinedButton(
                  onPressed: () {
                    _flutterRingtoneManager.playIosSystemSoundByID(SystemSoundID.mailSent);
                  },
                  child: const Text("Play iOS Notification"),
                ),
              ElevatedButton(
                onPressed: () => _flutterRingtoneManager.stop(),
                style: ButtonStyle(
                  foregroundColor: MaterialStateProperty.all(Colors.white),
                  backgroundColor: MaterialStateProperty.all<Color>(Colors.red),
                ),
                child: const Text("Stop"),
              )
            ],
          ),
        ),
      ),
    );
  }
}