audio_in_app 2.1.0 audio_in_app: ^2.1.0 copied to clipboard
A Flutter plugin for playing audio files. Ideal for games or applications with sound.
audio_in_app #
A Flutter plugin for playing audio files. Ideal for games or applications with sound.
Getting started and Usage #
1 - We import the Audio_in_app package.
import 'package:audio_in_app/audio_in_app.dart';
2 - We create a variable of the AudioInApp class.
AudioInApp _audioInApp = AudioInApp();
3 - We load the audios that we are going to use later with the createNewAudioCache()
method. Here we will have to insert an id to call it later of type String, the path is of type String where the audio being inside the "assets"
folder and the type of audio, punctual or background. (See following examples).
3.1 - If it is a punctual audio (used in button presses, character jumps or shots).
await _audioInApp.createNewAudioCache(playerId: 'button', route: 'audio/button.wav', audioInAppType: AudioInAppType.determined);
3.2 - If it is background audio (used during gameplay). Background audio has several differences from spot audio. The differences are as follows.
- Only one background audio can be played at the same time. If you start other background audio, the current one will stop and the new one will start.
- The background audio plays infinitely in a loop until you decide to stop it or change it to another audio.
await _audioInApp.createNewAudioCache(playerId: 'intro1', route: 'audio/intro_1.wav', audioInAppType: AudioInAppType.background);
4 - Play audio.
await _audioInApp.play(playerId: 'button');
o
await _audioInApp.play(playerId: 'intro1');
Example #
There is a basic example in the example folder of the project.
But here we add a quick example based on the example that is in the project.
1 - In this case we have a loading page, where we wait 1.5 seconds and then proceed to load all the audios that are going to be used on the next page.
import 'package:audio_in_app/audio_in_app.dart';
import 'package:flutter/material.dart';
class LoadingActivity extends StatefulWidget {
@override
State<LoadingActivity> createState() => _LoadingActivityState();
}
class _LoadingActivityState extends State<LoadingActivity> {
AudioInApp _audioInApp = AudioInApp();
@override
void initState() {
super.initState();
Future.delayed(Duration(milliseconds: 1500)).then((value) => goToMain());
}
@override
Widget build(BuildContext context) {
return Scaffold(
body: Center(
child: Text('Loading Activity'),
),
);
}
Future<void> goToMain() async {
await _audioInApp.createNewAudioCache(playerId: 'intro1', route: 'audio/intro_1.wav', audioInAppType: AudioInAppType.background);
await _audioInApp.createNewAudioCache(playerId: 'intro2', route: 'audio/intro_2.wav', audioInAppType: AudioInAppType.background);
await _audioInApp.createNewAudioCache(playerId: 'button', route: 'audio/button.wav', audioInAppType: AudioInAppType.determined);
Navigator.pushReplacementNamed(context, 'main');
}
}
2 - This would be the next page where these sounds will be used depending on the buttons pressed.
import 'package:audio_in_app/audio_in_app.dart';
import 'package:flutter/material.dart';
class MainActivity extends StatefulWidget {
@override
State<MainActivity> createState() => _MainActivityState();
}
class _MainActivityState extends State<MainActivity> {
AudioInApp _audioInApp = AudioInApp();
@override
void initState() {
super.initState();
}
Future<void> play_intro_1() async {
await _audioInApp.play(playerId: 'intro1');
}
Future<void> play_intro_2() async {
await _audioInApp.play(playerId: 'intro2');
}
Future<void> stop_background() async {
await _audioInApp.stopBackgroun();
}
Future<void> play_button() async {
await _audioInApp.play(playerId: 'button');
}
@override
Widget build(BuildContext context) {
return Scaffold(
body: Center(
child: Column(
mainAxisSize: MainAxisSize.min,
children: [
Container(
margin: EdgeInsets.only(bottom: 30),
child: Text('Main Activity')
),
OutlinedButton(
onPressed: () {
play_intro_1();
},
child: Text("Play background intro 1"),
),
OutlinedButton(
onPressed: () {
play_intro_2();
},
child: Text("Play background intro 2"),
),
OutlinedButton(
onPressed: () {
play_button();
},
child: Text("Play Button Sound"),
),
OutlinedButton(
onPressed: () {
stop_background();
},
child: Text("Stop background sound"),
)
],
),
),
);
}
}
Additional information #
This package uses the audioplayers package and tries to make things easier for new users. I am also not an expert in creating packages and this is the first package that I create. Therefore, feel free to collaborate to add new features or improve part of the code currently created. Any help will be welcome.