Audio Player (Mobile) supports single tracks, playlists, albums, podcasts, courses, and audio libraries. It can be used as a full player, a mini player, or a hidden playback engine controlled through Bubble workflows.
## Demo App Editor

A configured test app is available for reviewing the Audio Player (Mobile) plugin setup, workflows, controls, playlist configuration, and mobile view implementation.

.................

**Bubble Editor Test App:**
https://bubble.io/page?id=ankhsmobile&app_type=mobile&tab=Design&name=Audio+Player&version=live&type=page


The test view is named **Audio Player**. It includes the AudioPlayer element, playlist setup, playback controls, queue controls, progress tracking actions, collection actions, and navigation testing.

For the public run-mode demo, use the Marketplace Demo page link.

.................


## Audio Source Setup

### Playlist or database list

Use **Playlist URLs** as the main audio source. Connect it to a dynamic list of direct audio file URLs.

For reliable metadata and progress tracking, also connect these optional lists in the exact same order:

* Playlist Track IDs
* Playlist Titles
* Playlist Artists
* Playlist Artwork URLs

Example:

* Playlist URLs = Search for Songs: each item’s audio file
* Playlist Track IDs = Search for Songs: each item’s unique ID
* Playlist Titles = Search for Songs: each item’s title
* Playlist Artists = Search for Songs: each item’s artist
* Playlist Artwork URLs = Search for Songs: each item’s cover image

No JSON is required.

### Single audio track

Use **Audio source URL**. You may also add Track Title, Artist, Album, and Artwork URL.

## Main Settings

Configure the player in this order:

1. Audio source or Playlist URLs
2. Track IDs and metadata lists
3. Autoplay, autoplay next, loop, shuffle, speed, and volume
4. Progress tracking and Collection ID
5. Player display settings
6. Colors, artwork, controls, and visualizer settings

Useful playback settings include:

* Autoplay
* Autoplay next
* Loop mode: Off, One, or All
* Shuffle
* Playback rate
* Volume
* Start muted
* Start position
* Seek step
* Fade in and fade out
* Crossfade
* Sleep timer

## Full Player and Mini Player

Use the full player for the complete listening experience with artwork, title, artist, waveform, time, visualizer, and controls.

Enable Mini Player mode for a compact player that can be placed in a reusable element, floating group, bottom navigation area, Home view, or another mobile view.

Multiple player elements can reflect the same active playback session. This allows a full player on one view and a mini player on another view.

## Progress and Completion Tracking

Set a stable **Collection ID** for each album, show, playlist, course, or series.

Examples:

* founder-mode-album
* podcast-season-1
* physics-course
* show-unique-id

The plugin can track:

* Current position
* Duration
* Progress percentage
* Current track
* Queue position
* Played and unplayed tracks
* Saved resume position
* Collection completion percentage
* Completed albums, shows, and playlists

Use Playlist Track IDs whenever possible. This ensures progress remains connected to the correct audio item even if URLs change.

## Important Workflow Actions

Use Bubble workflows to control the player.

### Playback

* Play
* Pause
* Stop
* Toggle play/pause
* Replay
* Seek to
* Skip forward or back
* Set volume
* Mute or unmute

### Playlist and Queue

* Load source
* Load playlist
* Next track
* Previous track
* Jump to track
* Toggle shuffle
* Add, remove, move, or clear queue items
* Set collection

### Progress

* Mark current track played
* Mark current track unplayed
* Save position
* Restore position
* Reset collection progress
* Get track information

### Advanced Features

* Set loop mode
* Set playback rate
* Create A-B loops
* Add chapters and bookmarks
* Start sleep timer
* Cache audio for offline use
* Set fades and crossfade

## Useful States and Events

Use states such as:

* Is playing
* Is loaded
* Is buffering
* Progress
* Position
* Duration
* Current track title
* Current track artist
* Current track artwork
* Queue length
* Current index
* Loop mode
* Shuffle state
* Error

Use events such as:

* Playback started
* Playback paused
* Track changed
* Playback ended
* Queue ended
* Position changed
* Track marked played
* Collection completed
* Error occurred

These can be used for analytics, database updates, completed badges, recently played lists, and custom controls.

## Background Playback

Enable **Background playback** and **Play in silent mode** where needed.

Also enable **Background audio playback** in your Bubble native mobile app settings.

The player can continue across mobile view navigation while the app remains open. Test background playback, lock screen behavior, audio interruptions, and cross-view syncing on a real iOS or Android device. Browser preview cannot fully test native audio behavior.

## Device Test Checklist

Before publishing, test:

* Single audio playback
* Playlist playback
* Play, pause, next, previous, shuffle, loop, mute, and volume
* Seek bar dragging
* Autoplay next
* Mini player and full player syncing
* Navigation between views while audio continues
* Background playback
* Resume position
* Track and collection completion
* Invalid audio URL handling

Built with 🤍 by ANKHARA Studios.