React Native Audio Pro

🚀 Features

• 🎵 Powered by Media3 (Android) & AVFoundation (iOS)
• 🔒 Lock screen controls & background playback
• 🔔 Automatic handling of notification center (Android & iOS)
• 📡 Comprehensive media support:
  • Static remote files
  • Live streams (HLS, DASH, RTSP, RTMP)
  • Local files (audio and artwork)
• 🔊 Isolated ambient audio system for background sounds
• 📦 Built fully in TypeScript – no JS wrappers
• 🧠 Simple React hook & module interface
• ⚡️ Lightweight, fast, and production-ready

🎧 React Hook in Action

import { useAudioPro } from 'react-native-audio-pro';

export default function Player() {
  const { state, duration, position, ...etc } = useAudioPro();
  return (
    <View>
      <Text>State: {state}</Text>
      <Text>Position: {position} / {duration}</Text>
    </View>
  );
}

🧩 Module in Action

import {AudioPro} from 'react-native-audio-pro';

AudioPro.configure({ contentType: 'speech' });

const track = {
  id: 'track-001',
  url: 'https://example.com/audio-book.mp3'
  title: 'The Best Book Ever',
  artwork: 'https://example.com/nice-picture.jpg',
};

AudioPro.play(track);
// or
AudioPro.play(track, {
  autoPlay: false,
  headers: {
    audio: { 'Authorization': 'Bearer token123' },
    artwork: { 'Cache-Control': 'max-age=3600' }
  }
});

🔊 Ambient Audio

Aan isolated ambient audio system for playing background sounds independently from the main player.

import { AudioPro } from 'react-native-audio-pro';

AudioPro.ambientPlay({
  url: 'https://example.com/nature-sounds.mp3',
  loop: true,
});

AudioPro.ambientStop();

AudioPro.ambientSetVolume(0.5);

Documentation

For full setup and API reference, see the GitHub README.

• 📖 Full API for AudioPro module and useAudioPro hook
• 📦 Details on payloads, types, and setup options
• 🧪 Example app demonstrating integration and usage
• 🔧 Platform-specific setup (Android & iOS)

🚀 Ready to build?

Check it out and let us know how you go! If you run into any issues, log an issue — we’ll squash bugs fast. 💪