| **iolib** |
| ========== |
| Classes for playing audio data. |
| |
| ## Abstract |
| (Oboe) **iolib** contains classes implementing streaming audio playback and mixing from multiple sources. It's purpose is to demonstrate best practices and provide reusable code. |
| |
| Note: the more general name of "iolib" was chosen since it is presumed that this project will eventually implement audio capture capability. |
| |
| **iolib** is written in C++ and is intended to be called from Android native code. It is implemented as a static library. |
| |
| # **iolib** project structure |
| * player |
| Contains classes to support streaming playback from (potentially) multiple audio sources. |
| |
| ## player classes |
| ### DataSource |
| Declares the basic interface for audio data sources. |
| |
| ### SampleSource |
| Extends the `DataSource` interface for audio data coming from SampleBuffer objects. |
| |
| ### OneShotSampleSource |
| Extends `SampleSource` to provide data that plays through it's `SampleBuffer` and then provides silence, (i.e. a non-looping sample) |
| |
| ### SampleBuffer |
| Loads and holds (in memory) audio sample data and provides read-only access to that data. |
| |
| ### SimpleMultiPlayer |
| Implements an Oboe audio stream into which it mixes audio from some number of `SampleSource`s. |
| |
| This class demonstrates: |
| * Creation and lifetime management of an Oboe audio stream (`ManagedStream`) |
| * Logic for an Oboe `AudioStreamCallback` interface. |
| * Logic for handling streaming restart on error (i.e. playback device changes) |
