An amazing Flutter audio recorder and player at one hand

flutter_sound

When we live in modern society (in the 4.0 era), recording audio has become very familiar. There are many widgets that support recording audio. Below are the instructions on how you can use the Flutter audio recorder and player at one hand.

This is Flutter plugin very useful for sound. Audio recorder and player.

This Flutter plugin supports both android and ios platforms, It provides simple recorder and player functionalities for both android and ios platforms, very convenient for users. This only supports default file extension for each platform. This plugin handles file from remote url. This plugin can handle playback stream from native (To sync exact time with bridging).

Install

To start, to the following guide:

Add flutter_sound as a dependency in pubspec.yaml
For help on adding as a dependency, view the documentation.

Post Installation

On iOS you need to add a usage description to info.plist:

<key>NSMicrophoneUsageDescription</key>
<string>This sample uses the microphone to record your speech and convert it to text.</string>
<key>UIBackgroundModes</key>
<array>
	<string>audio</string>
</array>

On Android you need to add a permission to AndroidManifest.xml:

<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Methods

Some particular methods for you:

Func	Param	Return	Description
setSubscriptionDuration	`double sec`	`String` message	Set subscription timer in seconds. Default is `0.01` if not using this method.
startRecorder	`String uri`	`String` uri	Start recording. This will return uri used.
stopRecorder		`String` message	Stop recording.
startPlayer	`String uri`	`String` message	Start playing.
stopPlayer		`String` message	Stop playing.
pausePlayer		`String` message	Pause playing.
resumePlayer		`String` message	Resume playing.
seekToPlayer	`int milliSecs` position to goTo	`String` message	Seek audio to selected position in seconds. Parameter should be less than audio duration to correctly placed.

Subscriptions

Subscription	Return	Description
onRecorderStateChanged	`<RecordStatus>`	Able to listen to subscription when recorder starts.
onPlayerStateChanged	`<PlayStatus>`	Able to listen to subscription when player starts.

Default uri path

When uri path is not set during the function call in startRecorder or startPlayer, they are saved in below path depending on the platform.

Default path for android
- sdcard/sound.mp4.
Default path for ios
- sound.m4a.

Usage

Creating instance.

FlutterSound flutterSound = new FlutterSound();

Starting recorder with listener.

String path = await flutterSound.startPlayer(null);
print('startPlayer: $path');
_playerSubscription = flutterSound.onPlayerStateChanged.listen((e) {
	if (e != null) {
		DateTime date = new DateTime.fromMillisecondsSinceEpoch(e.currentPosition.toInt());
		String txt = DateFormat('mm:ss:SS', 'en_US').format(date);
		this.setState(() {
			this._isPlaying = true;
			this._playerTxt = txt.substring(0, 8);
		});
	}
});

Stop recorder

String result = await flutterSound.stopRecorder();
print('stopRecorder: $result');

if (_recorderSubscription != null) {
	_recorderSubscription.cancel();
	_recorderSubscription = null;
}

Start player

String path = await flutterSound.startPlayer(null);
print('startPlayer: $path');

_playerSubscription = flutterSound.onPlayerStateChanged.listen((e) {
	if (e != null) {
		DateTime date = new DateTime.fromMillisecondsSinceEpoch(e.currentPosition.toInt());
		String txt = DateFormat('mm:ss:SS', 'en_US').format(date);
		this.setState(() {
			this._isPlaying = true;
			this._playerTxt = txt.substring(0, 8);
		});
	}
});

Stop player

String result = await flutterSound.stopPlayer();
print('stopPlayer: $result');
if (_playerSubscription != null) {
	_playerSubscription.cancel();
	_playerSubscription = null;
}

Pause player

String result = await flutterSound.pausePlayer();

Resume player

String result = await flutterSound.resumePlayer();

Seek player

String result = await flutterSound.seekToPlayer(miliSecs);

Setting subscription duration (Optional). 0.01 is default value when not set.

/// 0.01 is default
flutterSound.setSubscriptionDuration(0.01);

Setting volume.

/// 1.0 is default
/// Currently, volume can be changed when player is running. Try manage this right after player starts.
String path = await flutterSound.startPlayer(null);
await flutterSound.setVolume(0.1);

TODO

[ ] Seeking example in Exmaple project
[x] Volume Control
[x] Sync timing for recorder callback handler

GitHub

https://github.com/dooboolab/flutter_sound