HX Audio Player

DEVELOPER: huhx0015

Description

The HX Audio Player is a custom audio wrapper library for Android 5.0 (API 21) and above. Originally designed as an audio library for games, HX Audio Player is an easy-to-use approach to implementing music and sound playback in Android applications.

HX Audio Player has been utilized in apps such as Chrono Maps, Cid's Aerial Views, DexTrail, Dragon Geo, Link to the Map, Map of the Nocturne, Robot Master Database and Suiko Cartography.

The demo application provided with the project provides an example how the HX Audio Player library works.

Instructions

Music Playback

To load and play music files, simply declare the following in your code:

Play Music (Resource):

HXMusic.music()
       .load(R.raw.my_song_name)    // Sets the resource of the song. [REQUIRED]
       .title("My Awesome Song")    // Sets the title of the song. [OPTIONAL]
       .artist("Mr. Anonymous")     // Sets the artist of the song. [OPTIONAL]
       .date("January 1, 1998")     // Sets the date of the song. [OPTIONAL]
       .at(5000)                    // Sets start position in milliseconds. [OPTIONAL]
       .gapless(true)               // Enables gapless playback for this song. [OPTIONAL]
       .looped(true)                // Sets the song to be looped. [OPTIONAL]
       .play(this);                 // Plays the song. [REQUIRED]

Shortcut helpers are also available:

HXMusic.play(this, R.raw.my_song_name);              // Play once.
HXMusic.play(this, R.raw.my_song_name, true);        // Play looped.
HXMusic.playGaplessLoop(this, R.raw.my_song_name);   // Gapless loop helper.

Play Music (Path):

HXMusic.music()
       .load("https://some-fake-url.com/song.mp3")  // Sets the path location of the song. [REQUIRED]
       .title("My Awesome Song")                    // Sets the title of the song. [OPTIONAL]
       .artist("Mr. Anonymous")                     // Sets the artist of the song. [OPTIONAL]
       .date("January 1, 1998")                     // Sets the date of the song. [OPTIONAL]
       .at(5000)                                    // Sets start position in milliseconds. [OPTIONAL]
       .gapless(true)                               // Enables gapless playback for this song. [OPTIONAL]
       .looped(true)                                // Sets the song to be looped. [OPTIONAL]
       .play(this);                                 // Plays the song. [REQUIRED]

Pause Music:

HXMusic.pause();               // Pauses any song that is playing in the background.

Resume Music:

HXMusic.resume(this);          // Resumes playback of the last played song at the position where it left off.

Stop Music:

HXMusic.stop();                // Stops all music playing in the background.

Song Playing

HXMusic.isPlaying();                // Returns a boolean to determine if the song is currently playing or not.

Song Position

HXMusic.getPosition();              // Returns the current position of the song, represented as an int value.

Music Listener

HXMusic.setListener(this);          // Sets a HXMusicListener interface to HXMusic. Use this if you need to monitor events from HXMusic.

HXMusicListener now supports an optional error callback: