react-native-nearby-api
Getting started
$ yarn add react-native-nearby-api-mrousavy
or $ npm i react-native-nearby-api-mrousavy
Installation
This package supports Autolinking for React Native 0.60 and above.
iOS
-
cd ios/ pod install
- Build and run project
Android
There are no additional steps required for Android
Usage
See the example app for more detail and code examples.
-
Retrieve your API Keys from the Google Console iOS | Android
-
Add the correct permissions to the AndroidManifest.
<!-- Include if wish to use BLE --><!-- Include if wish to use audio --> -
Add the Android API Key in the AndroidManifest .
-
The iOS API key will be supplied through the
connect()
method. -
Add
NSBluetoothPeripheralUsageDescription
to the Info.plist -
Add
NSMicrophoneUsageDescription
to the iOS project's Info.plist if using audio
Important: Ask for Bluetooth permissions first using react-native-permissions!
; const nearbyAPI = true; // Use BLE only, no audio.nearbyAPI;nearbyAPI;nearbyAPI;nearbyAPI;// Android OnlynearbyAPI;// Android OnlynearbyAPI;nearbyAPI;nearbyAPI;nearbyAPI;nearbyAPI; // To connect from Google API ClientnearbyAPI; // To check if the nearby API is connected.nearbyAPI; // To disconnect laternearbyAPI; // To publish to nearby devicesnearbyAPI; // To check if the nearby API is publishing.nearbyAPI; // To subscribe to nearby devices broadcastingnearbyAPI; // To check if the nearby API is subscribing.nearbyAPI; // To unpublishnearbyAPI; // To unsubscribenearbyAPI;
Running the Example
-
Install the dependencies in the root folder
yarn
Google Developer Console
Generate an API Key from the- Go to the Google Developers Console.
- Create or select a project to register your application with.
- Click Continue to Enable the API.
- On the Credentials page, create a new API Key. (No key restrictions are needed for this example)
- Copy/Paste your key in example/index.js and in the example AndroidManifest.xml
Android
- To run the example app, the packager must have the
projectRoots
reordered for the example/ directory. In another terminal window:
yarn start --projectRoots <FULL-PATH-TO-REPO>/react-native-nearby-api/example,<FULL-PATH-TO-REPO>/react-native-nearby-api
yarn run:android
adb reverse tcp:8081 tcp:8081
iOS
cd example ios/
bundle exec pod install
- Open
example.xcworkspace
- Add your IP to
AppDelegate.m
jsCodeLocation = ;
-
In another terminal window:
yarn start
-
Run on device
NOTE: If you receive a
duplicate symbols for architecture
error through Xcode, this is a known issue. A work around is to run./renameLogger.sh
afternode_modules
have been installed and you've attempted to run in Xcode.