$ yarn add react-native-nearby-api or $ npm install react-native-nearby-api --save
$ react-native link react-native-nearby-api
- To utilize the Nearby SDK,
NearbyMessagesneed to be linked to the project. Look to the example for Cocoapods usage.cd ios/ pod init - Add the following pod to the
Podfilein the project's target.pod 'NearbyMessages' - Then
pod installto install dependencies. - Open the newly generated
.xcworkspace. - In
node_modules/react-native-nearby-api/ios, drag and dropRNNearbyApi.xcodeprojinto yourLibrariesgroup. - In Build Phases > Link Binary with Libraries > Click (+) > Add
libRNNearbyApi.a. - Build and run project on device.
- Open up
android/app/src/main/java/[...]/MainActivity.java
- Add
import com.badfeatures.nearby.RNNearbyApiPackage;to the imports at the top of the file - Add
new RNNearbyApiPackage()to the list returned by thegetPackages()method
- Append the following lines to
android/settings.gradle:include ':react-native-nearby-api' project(':react-native-nearby-api').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-nearby-api/android')
- Insert the following lines inside the dependencies block in
android/app/build.gradle:compile project(':react-native-nearby-api')
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 --> <uses-permission android:name="android.permission.BLUETOOTH"/> <uses-permission android:name="android.permission.BLUETOOTH_ADMIN"/> <!-- Include if wish to use audio --> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <uses-permission android:name="android.permission.RECORD_AUDIO" />
-
Add the Android API Key in the AndroidManifest .
<meta-data android:name="com.google.android.nearby.messages.API_KEY" android:value="MY_API_KEY" />
-
The iOS API key will be supplied through the
connect()method. -
Add
NSBluetoothPeripheralUsageDescriptionto the Info.plist -
Add
NSMicrophoneUsageDescriptionto the iOS project's Info.plist if using audio
import NearbyApi from "react-native-nearby-api";
const nearbyAPI = new NearbyAPI(true); // Use BLE only, no audio.
nearbyAPI.onConnected(message => {
console.log(message);
});
nearbyAPI.onDisconnected(message => {
console.log(message);
});
nearbyAPI.onFound(message => {
console.log("Message Found!");
console.log(message);
});
nearbyAPI.onLost(message => {
console.log("Message Lost!");
console.log(message);
});
// Android Only
nearbyAPI.onDistanceChanged((message, value) => {
console.log("Distance Changed!");
console.log(message, value);
});
// Android Only
nearbyAPI.onBLESignalChanged((message, value) => {
console.log("BLE Signal Changed!");
console.log(message, value);
})
nearbyAPI.onPublishSuccess(message => {
console.log(message);
});
nearbyAPI.onPublishFailed(message => {
console.log(message);
});
nearbyAPI.onSubscribeSuccess(() => {});
nearbyAPI.onSubscribeFailed(() => {});
// To connect from Google API Client
nearbyAPI.connect(API_KEY);
// To check if the nearby API is connected.
nearbyAPI.isConnected((connected, error) => {
console.log(connected);
});
// To disconnect later
nearbyAPI.disconnect();
// To publish to nearby devices
nearbyAPI.publish("Hello World!");
// To check if the nearby API is publishing.
nearbyAPI.isPublishing((publishing, error) => {
console.log(publishing);
});
// To subscribe to nearby devices broadcasting
nearbyAPI.subscribe();
// To check if the nearby API is subscribing.
nearbyAPI.isSubscribing((subscribing, error) => {
console.log(subscribing);
});
// To unpublish
nearbyAPI.unpublish();
// To unsubscribe
nearbyAPI.unsubscribe();-
Install the dependencies in the root folder
yarn
Generate an API Key from the Google Developer Console
- 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
- To run the example app, the packager must have the
projectRootsreordered 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
cd example ios/bundle exec pod install- Open
example.xcworkspace - Add your IP to
AppDelegate.m
jsCodeLocation = [NSURL URLWithString:@"http://<IP-ADDRESS>:8081/index.bundle?platform=ios&dev=true"];-
In another terminal window:
yarn start -
Run on device
NOTE: If you receive a
duplicate symbols for architectureerror through Xcode, this is a known issue. A work around is to run./renameLogger.shafternode_moduleshave been installed and you've attempted to run in Xcode.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent