Home

Awesome

react-native-audio-streaming

THIS PROJECT IS NOT MAINTAINED

react-native-audio-streaming is not maintained anymore. The main purpose was to play shoutcast streams with meta data and display a notification while playing.

Please see other projects like

Features

If you are only looking to play local audio file with app in foreground, please see other audio libs.

Demo iOS Demo android

First installation step (applied for both iOS & Android)

$ npm install react-native-audio-streaming --save

Next installation steps for iOS (choose one of three options below)

1. Cocoapods installation

  1. add pod 'RNAudioStreaming', :path => '../node_modules/react-native-audio-streaming' to Podfile
  2. run pod install

2. Mostly automatic installation

$ react-native link react-native-audio-streaming

Go to node_modulesreact-native-audio-streaming => ios => Pods and drag/drop Pods.xcodeproj to the Libraries folder in your XCode project.

In XCode, in the project navigator, select your project. Add libReactNativeAudioStreaming.a and libStreamingKit.a to your project's Build PhasesLink Binary With Libraries

3. Manual installation

  1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  2. Go to node_modulesreact-native-audio-streaming => ios
    • run pod install to download StreamingKit dependency
    • add ReactNativeAudioStreaming.xcodeproj to the Libraries folder in your XCode project
    • add Pods/Pods.xcodeproj to the Libraries folder in your XCode project
  3. In XCode, in the project navigator, select your project. Add libReactNativeAudioStreaming.a and libStreamingKit.a to your project's Build PhasesLink Binary With Libraries
  4. Run your project (Cmd+R)

Final steps for iOS (required after doing any of three options above)

  1. Make sure $(SRCROOT)/../node_modules/react-native-audio-streaming/ios is added to your project's Header Search Paths within the Build Settings section.

  2. Update Info.plist file of your Xcode project and add audio background mode

    <key>UIBackgroundModes</key>
    <array>
      <string>audio</string>
    </array>

Next installation steps for Android

  1. Open up android/app/src/main/java/[...]/MainApplication.java
  1. Append the following lines to android/settings.gradle:

    include ':react-native-audio-streaming'
    project(':react-native-audio-streaming').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-audio-streaming/android')
    
  2. Insert the following lines inside the dependencies block in android/app/build.gradle:

      compile project(':react-native-audio-streaming')
    
  3. If using Proguard then insert the following rules:

    -keep class com.spoledge.aacdecoder.** {
     *;
    }
    

Usage

Playing sound (similar code used by the player UI)

import { ReactNativeAudioStreaming } from 'react-native-audio-streaming';

const url = "http://lacavewebradio.chickenkiller.com:8000/stream.mp3";
ReactNativeAudioStreaming.pause();
ReactNativeAudioStreaming.resume();
ReactNativeAudioStreaming.play(url, {showIniOSMediaCenter: true, showInAndroidNotifications: true});
ReactNativeAudioStreaming.stop();

For more information see the Example app.

Player UI

import { Player } from 'react-native-audio-streaming';

class PlayerUI extends Component {
  render() {
    return (
        <Player url={"http://lacavewebradio.chickenkiller.com:8000/stream.mp3"} />
    );
  }
}

TODO

Credits

See also the list of contributors who participated in this project.

Contribute

Since symlink support is still lacking on React Native, I use the wml cli tool created by the nice folks at wix.

wml add ~/react-native-audio-streaming ~/react-native-audio-streaming/Example/node_modules/react-native-audio-streaming

Changelog

License

This project is licensed under the MIT License - see the LICENSE file for details