Download the PHP package theunwindfront/nativephp-audio without Composer
On this page you can find all versions of the php package theunwindfront/nativephp-audio. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download theunwindfront/nativephp-audio
More information about theunwindfront/nativephp-audio
Files in theunwindfront/nativephp-audio
Package nativephp-audio
Short Description Audio player plugin for NativePHP Mobile apps
License MIT
Informations about the package nativephp-audio
NativePHP Audio Player Plugin
A premium NativePHP plugin for professional audio playback on mobile devices (Android & iOS). This plugin provides deep integration with native OS features like MediaSession, background services, and remote controls.
✨ Features
- 🏆 Native Media Integration - Full support for OS Lock Screen controls, Bluetooth devices, and Android Auto/CarPlay.
- 📱 Background Excellence - Reliable background playback using Foreground Services (Android) and specialized Audio Sessions (iOS).
- 🎶 Advanced Playlist Management - Natively managed queues with Shuffle and Repeat modes.
- 🎧 Audio Focus Intelligence - Gracefully handles interruptions (phone calls, notifications, Siri) with auto-ducking and resuming.
- 🕒 Sleep Timers - Programmatic sleep timers that safely release native resources.
- 📊 Detailed Analytics Events - Granular event reporting for playback progress, track changes, buffering, and remote commands.
- 🖼 Rich Metadata - Support for high-quality artwork, titles, artists, and arbitrary custom metadata.
🚀 Installation
📖 Usage
PHP Interface (Livewire / Controller)
⚡ JavaScript Bridge
If you are building a SPA (Inertia/Vue/React) or using Alpine.js, you can use the JavaScript bridge directly.
First, include the bridge in your layout:
Then, use the audio helper:
📡 Event Synchronization
This plugin dispatches powerful Laravel events that you can listen to in your application:
| Event | Description |
|---|---|
PlaybackStarted |
Fired when audio actually begins playing. |
PlaybackProgressUpdated |
Heartbeat event with position and duration. |
PlaylistTrackChanged |
Fired on auto-advance or manual track skip. |
AudioFocusLost |
Fired when another app takes over audio (e.g. phone call). |
RemotePlayReceived |
Fired when the user hits 'Play' on headphones/lockscreen. |
SleepTimerExpired |
Fired when the scheduled sleep timer hits zero. |
🛠 Advanced Features
Background Sync
When your app returns from the background, you can "drain" any missed events that occurred while the PHP process was suspended:
Absolute Local Paths
Unlike standard web players, this plugin has direct filesystem access. On Android, it even requests READ_MEDIA_AUDIO permissions automatically.
📋 API Reference
| Method | Parameters | Description |
|---|---|---|
play |
string $url, array $options |
Play/Restart audio |
load |
string $url, array $options |
Prepare audio without playing |
setPlaylist |
array $tracks, bool $autoPlay, int $idx |
Set native queue |
next / previous |
- | Navigate playlist |
skipTo |
int $index |
Jump to specific track |
setVolume |
float $level (0.0 - 1.0) |
Set player volume |
setPlaybackRate |
float $rate (0.25 - 4.0) |
Set playback speed |
setSleepTimer |
int $seconds |
Schedule a shutdown |
cancelSleepTimer |
- | Stop the active timer |
getState |
- | Get full status object |
getPlaylist |
- | Get full playlist state |
drainEvents |
- | Get background events |
📱 Version Support
- Android: 5.0 (API 21) or higher.
- iOS: 13.0 or higher.
👥 Credits
- Sagar Pansuriya - Lead Developer
- All Contributors
🤝 Support
For questions or issues, contact [email protected] or open a GitHub Issue.
📄 License
The MIT License (MIT). Please see License File for more information.
All versions of nativephp-audio with dependencies
nativephp/mobile Version ^3.0
illuminate/support Version ^11.0|^12.0|^13.0