🔰 How to Use ・ 🎺 Explore Examples ・ 🚜 How to Build
Content of docs
directory.
Here is how do one essentially "use" this library (code in Kotlin):
class AndroidLauncher : AndroidApplication() {
// Magic happens here:
override fun createAudio(context: Context, config: AndroidApplicationConfiguration): AndroidAudio =
OboeAudio(context.assets)
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
// Create an app like always
val config = AndroidApplicationConfiguration()
initialize(SomeApp(), config)
}
}
Using Oboe library from Google, you can create high-performance audio streams which may plug in and tweak some features in runtime to boost speed even further. This streams are native, so there is no GC that will slow things down. For audio decoding, this library also provide native tools: libavformat and friends (FFmpeg) with MP3, OGG and WAV support only. Such audio decoder is blazing fast, so combining that with oboe streams, we get ourselves responsive and fast Audio implementation.
Here is a table of known goodies and problems for certain features per file format (decoder):
Feature | WAV | OGG | MP3 | |||
---|---|---|---|---|---|---|
🧮 | State | 🧮 | State | 🧮 | State | |
Seek | ⭐️ | Precise, no content lost. | 👌 | Bad initial seek, but dropping frames until PTS is equal to desired seek TS. May lose some content if PTS isn't precise enough. | 👌 | Same as OGG. |
OboeAudio class:
-
newSound
method (With OboeSound); -
newMusic
method (With OboeMusic); -
newAudioDevice
method (With OboeAudioDevice); -
newAudioRecorder
method.
WARN: not marked methods will result in undefined behaviour. (actually, just a crash)