chirp-react-native
Use Chirp SDK for transfering data over sound on React Native. Developed based on Chirp + React Native blog post For more info and getting credentials please visit Chirp.io
Getting started
$ npm install chirp-react-native --save
Mostly automatic installation
$ react-native link chirp-react-native
Manual installation
iOS (!!!NOT COMPATIBLE YET!!! Don't have a MAC for testing)
- In XCode, in the project navigator, right click
Libraries
➜Add Files to [your project's name]
- Go to
node_modules
➜chirp-react-native
and addRNChirpReactNative.xcodeproj
- In XCode, in the project navigator, select your project. Add
libRNChirpReactNative.a
to your project'sBuild Phases
➜Link Binary With Libraries
- Run your project (
Cmd+R
)<
Android
- Open up
android/app/src/main/java/[...]/MainActivity.java
- Add
import com.reactlibrary.RNChirpReactNativePackage;
to the imports at the top of the file - Add
new RNChirpReactNativePackage()
to the list returned by thegetPackages()
method
- Append the following lines to
android/settings.gradle
:include ':chirp-react-native' project(':chirp-react-native').projectDir = new File(rootProject.projectDir, '../node_modules/chirp-react-native/android')
- Insert the following lines inside the dependencies block in
android/app/build.gradle
:compile project(':chirp-react-native')
Usage
; RNChirpReactNative; //Initialize the SDK using the credentials given on the Chirp Admin Center https://admin.chirp.io/RNChirpReactNative; //Get the license (On the Admin Center can be set the method used by the SDK for communication. Standard (For audible sound) or Ultrasonic (for inaudible sound))await RNChirpReactNative; //Start the SDKRNChirpReactNativestart; //Send a test sound (If set to Ultrasonic mode, the sound will be inaudible. You can use any app that detects Ultrasonic available on the Play Store for testing)RNChirpReactNative; //Or send an encoded dataRNChirpReactNative; //Register a listener to catch transmited dataconst listener = RNChirpReactNative //Stop the SDK and remove listeners to free up resourcesRNChirpReactNative;RNChirpReactNative; //Removes all listeners (useful for when closing the app or destroying the component)listener; //Remove a single listener (useful for enabling or disabling specific actions)