AMR Plugin for Flutter #

A Flutter plugin that provides AMR (Adaptive Multi-Rate) audio format conversion capabilities for iOS platform. This plugin supports both AMR-NB and AMR-WB formats and enables bidirectional conversion between AMR and WAV audio formats in your Flutter applications.

Features #

• ✅ AMR-NB Support: Encode and decode AMR-NB audio format
• ✅ AMR-WB Support: Encode and decode AMR-WB audio format
• ✅ WAV to AMR: Convert WAV audio files to AMR-NB/AMR-WB format
• ✅ AMR to WAV: Convert AMR-NB/AMR-WB audio files to WAV format
• ✅ iOS Platform: Optimized for iOS applications
• ✅ High Performance: Built on top of OpenCore AMR libraries
• ✅ Easy to Use: Simple API for audio conversion
• ✅ Memory Efficient: Optimized for mobile applications

Installation #

Add this to your package's pubspec.yaml file:

dependencies:
  amr_plugin: ^0.0.1

Then run:

flutter pub get

iOS Setup #

For iOS, you need to add the following to your ios/Podfile:

platform :ios, '12.0'

The plugin will automatically handle the framework integration.

Platform Support #

This plugin currently supports iOS only. Android support is not available.

Usage #

Basic Example #

import 'package:amr_plugin/amr_plugin.dart';

// Initialize the plugin
final amrPlugin = AmrPlugin();

// Convert WAV file to AMR format
try {
  final resultPath = await amrPlugin.convertWavToAmr(
    '/path/to/input.wav',
    sampleRate: 8000,
    bitRate: 12200,
  );
  if (resultPath != null) {
    print('Conversion successful: $resultPath');
  } else {
    print('Conversion failed');
  }
} catch (e) {
  print('Conversion failed: $e');
}

// Convert AMR file to WAV format
try {
  final resultPath = await amrPlugin.convertAmrToWav(
    '/path/to/input.amr',
    sampleRate: 8000,
  );
  if (resultPath != null) {
    print('Conversion successful: $resultPath');
  } else {
    print('Conversion failed');
  }
} catch (e) {
  print('Conversion failed: $e');
}

Advanced Usage #

// Example: Play converted audio file
// You can use audio_player package to play the converted files
// import 'package:audioplayers/audioplayers.dart';
// 
// final audioPlayer = AudioPlayer();
// await audioPlayer.play(DeviceFileSource(resultPath));

API Reference #

AmrPlugin #

The main class for AMR audio operations.

Methods

• convertWavToAmr(String inputPath, {int sampleRate = 8000, int bitRate = 12200}): Convert WAV file to AMR format
• convertAmrToWav(String inputPath, {int sampleRate = 8000}): Convert AMR file to WAV format

Supported Conversions #

This plugin supports the following format conversions:

• WAV → AMR: Convert WAV audio files to AMR format
• AMR → WAV: Convert AMR audio files to WAV format

Supported Formats #

Input Formats #

• WAV (.wav)

Output Formats #

• AMR (.amr)
• WAV (.wav)

Requirements #

• iOS: 12.0+
• Flutter: 3.0.0+

Dependencies #

This plugin uses the following native libraries:

• OpenCore AMR: For AMR encoding/decoding

Contributing #

We welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

Development Setup #

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License #

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments #

• OpenCore AMR - The underlying AMR codec libraries
• Flutter Team - For the amazing Flutter framework

Support #

If you encounter any issues or have questions, please:

1. Check the Issues page
2. Create a new issue if your problem isn't already reported
3. Join our Discussions for general questions

Changelog #

See CHANGELOG.md for a list of changes and version history.