Bevy Kira audio

This bevy plugin is intended to try integrating Kira into Bevy. The goal is to replace or update bevy_audio, if Kira turns out to be a good approach. Currently, this plugin can play ogg, mp3, flac, and wav formats and supports web builds for everything except mp3. It also supports streaming of generated audio.

You can check out the examples directory in this repository for a display of this plugin's functionality.

Usage

Note: bevy_audio is enabled by default and not compatible with this audio plugin. Make sure to not have the bevy_audio feature enabled if you want to use bevy_kira_audio. The same goes for Bevy's mp3 feature.

To initialize the corresponding AssetLoaders, use at least one of the features bevy_kira_audio/ogg, bevy_kira_audio/mp3, bevy_kira_audio/wav, or bevy_kira_audio/flac. The following example assumes that the feature bevy_kira_audio/ogg is enabled.

```rust use bevykiraaudio::{AudioChannel, Audio, AudioPlugin}; use bevy::prelude::*;

fn main() { let mut app = App::build(); app .addplugins(DefaultPlugins) .addplugin(AudioPlugin) .addstartupsystem(startbackgroundaudio.system()); app.run(); }

fn startbackgroundaudio(assetserver: Res, audio: Reslooped(assetserver.load("backgroundaudio.ogg")); } ```

Current state

• [x] play common audio formats
  • [x] ogg
  • [x] mp3
  • [x] wav
  • [x] flac
• [x] web support
  • The features ogg, flac and wav can be build for WASM and used in web builds. There are some differences between browsers:
  • Chrome requires an interaction with the website to play audio (e.g. a button click). This issue can be resolved with a script in your index.html file (usage example).
  • Firefox: The audio might sound distorted (this could be related to overall performance; see issue #9)
• [x] pause/resume and stop tracks
• [x] play a track on repeat
• [x] control volume
• [x] control playback rate
• [ ] control pitch (no change in playback rate)
• [x] control panning
• [ ] get the current status of a track (time elapsed/left)?
• [x] audio streaming

Currently, sound settings are hard to control and usually your audio files get loaded with the default. With the feature settings_loader it is possible to define an audio asset with non-default semantic duration. The semantic_duration example demonstrates loading and playing such an asset. More options will likely be supported in the future.

Compatible Bevy versions

The main branch is up to date with the latest Bevy release. The branch bevy_main tracks the main branch of Bevy.

Compatibility of published bevy_kira_audio versions: | bevy_kira_audio | bevy | | :-- | :-- | | 0.4 - 0.5 | 0.5 | | 0.3 | 0.4 |

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)

at your option.

Assets in the examples might be distributed under different terms. See the readme in the examples directory.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.