androidbooster-audio

name	androidbooster-audio
description	HX Audio Player for music and sound playback. Use when implementing music playback, sound effects, HXMusic, HXSound, or audio in AndroidBooster. Uses hxaudio-v331.aar in core/audio.

AndroidBooster Audio (HX Audio Player)

Use HX Audio Player for music and sound in AndroidBooster. The library is in core/audio (hxaudio-v331.aar). Supports Android 2.3+ with workarounds for MediaPlayer/SoundPool bugs.

Audio files: Place audio files in the res/raw/ folder (e.g. res/raw/my_song.mp3 → R.raw.my_song).

Music Playback (HXMusic)

Play from resource:

HXMusic.music()
    .load(R.raw.my_song_name)    // [REQUIRED]
    .title("My Awesome Song")    // [OPTIONAL]
    .artist("Mr. Anonymous")    // [OPTIONAL]
    .date("January 1, 1998")    // [OPTIONAL]
    .at(5)                      // Start position (seconds)
    .gapless(true)              // Gapless playback
    .looped(true)               // Loop
    .play(this)                 // [REQUIRED]

Play from path/URL:

HXMusic.music()
    .load("http://example.com/song.mp3")
    .title("My Awesome Song")
    .play(this)

Control:

• HXMusic.pause() — Pause
• HXMusic.resume(this) — Resume
• HXMusic.stop() — Stop all
• HXMusic.isPlaying() — Boolean
• HXMusic.getPosition() / HXMusic.setPosition(0) — Position
• HXMusic.setListener(this) — HXMusicListener
• HXMusic.getStatus() — Status string
• HXMusic.enable(true) — Enable/disable
• HXMusic.logging(true) — Log output
• HXMusic.clear() — Clear when app is terminating

Lifecycle (Activity/Fragment): When pausing music on background and resuming on foreground:

• onPause() → HXMusic.pause() — Pause when app is backgrounded
• onResume() → HXMusic.resume(this) — Resume when activity/fragment is in foreground
• App terminating → HXMusic.clear() — Clean up when the app is shutting down

Sound Playback (HXSound)

Play sound:

HXSound.sound()
    .load(R.raw.my_sound_effect)  // [REQUIRED]
    .looped(true)                 // [OPTIONAL]
    .play(this)                   // [REQUIRED]

Control:

• HXSound.pause() — Pause looping sounds
• HXSound.resume() — Resume
• HXSound.load() — Pre-load resources
• HXSound.engines(2) — Multiple sound engines (API 9–10)
• HXSound.enable(true) — Enable/disable
• HXSound.reinitialize(this) — Re-init (API 9–10)
• HXSound.logging(true) — Log output
• HXSound.clear() — Clear when no longer needed

Module

Add core:audio dependency. Audio is provided via hxaudio-v331.aar in the audio module.