# Install via Composer
composer require theunwindfront/nativephp-audio
 
# Publish the plugins provider (if not already done)
php artisan vendor:publish --tag=nativephp-plugins-provider
 
# Register the plugin with NativePHP
php artisan native:plugin:register theunwindfront/nativephp-audio

use Theunwindfront\Audio\Facades\Audio;
 
// 1. Play a single track with metadata
Audio::play('https://example.com/song.mp3', [
    'title'    => 'Midnight City',
    'artist'   => 'M83',
    'artwork'  => 'https://example.com/artwork.jpg',
]);
 
// 2. Play a Local File (Mobile Storage)
// Raw paths from storage_path() are natively supported
Audio::play(storage_path('app/public/recordings/audio.mp3'), [
    'title'  => 'Voice Note',
    'artist' => 'Recorded Local'
]);
 
// 3. Manage a Playlist (Natively handled auto-advance)
Audio::setPlaylist([
    [
        'url'   => 'https://example.com/track1.mp3',
        'title' => 'Track 01',
    ],
    // ... more tracks
], autoPlay: true, startIndex: 0);
 
// 4. Playback Controls
Audio::pause();
Audio::resume();
Audio::next();
Audio::previous();
Audio::skipTo(5); // Skip to index 5 in playlist
 
// 5. State & Settings
$state = Audio::getState();
Audio::setVolume(0.8);
Audio::setPlaybackRate(1.5);
Audio::setShuffleMode(true);
Audio::setRepeatMode('all'); // 'none', 'one', 'all'
 
// 6. Sleep Timer
Audio::setSleepTimer(1800); // 30 minutes

use Theunwindfront\Audio\Facades\Audio;
 
// Play a stream by direct URL
Audio::playStream('https://stream.example.com/live.mp3', [
    'title'   => 'My Radio Station',
    'artist'  => 'Live DJ Set',
    'artwork' => 'https://example.com/radio-logo.jpg',
]);
 
// Play a stream by mountpoint (resolved against a server URL)
Audio::playStream('/live', [
    'serverUrl' => 'https://stream.example.com',
    'title'     => 'Main Channel',
    'artist'    => 'Now Playing',
]);
 
// Update metadata in real-time (e.g., when the current song changes)
Audio::updateStreamMetadata([
    'title'   => 'New Song Title',
    'artist'  => 'New Artist',
    'artwork' => 'https://example.com/new-artwork.jpg',
]);

@include('audio::bridge')

import audio from './resources/js/audio.js';
 
// Play immediately
await audio.play('https://server.com/song.mp3', { title: 'My Song' });
 
// Play a live stream
await audio.playStream('https://stream.example.com/live.mp3', {
    title: 'Live Radio',
    artist: 'DJ Mix'
});
 
// Update stream metadata in real-time
await audio.updateStreamMetadata({
    title: 'New Track Playing',
    artist: 'Featured Artist'
});
 
// Listen for native events on the window
window.addEventListener('audio:playback-progress-updated', (event) => {
    const { position, duration } = event.detail;
    console.log(`Playing: ${position} / ${duration}`);
});
 
// Listen for stream metadata changes
window.addEventListener('audio:stream-metadata-changed', (event) => {
    const { track, metadata } = event.detail;
    console.log(`Now playing: ${track.title} by ${track.artist}`);
});

$missedEvents = Audio::drainEvents();

Audio::play('/storage/emulated/0/Download/my-song.mp3');