Nearby Connections is a high level protocol on top of Bluetooth/Wi-Fi that acts as a medium-agnostic socket. Devices are able to advertise, scan, and connect with one another over any shared medium (eg. BT <-> BT). Once connected, the two devices share a list of all supported mediums and attempt to upgrade to the one with the highest bandwidth (eg. BT -> Wi-Fi). The connection is encrypted, reliable, and fully duplex. BYTE, FILE, and STREAM payloads are all supported and will be chunked & transferred internally and recombined on the receiving device. See Nearby Connections Overview for more information.
git clone https://github.com/google/nearby cd nearby git submodule update --init --recursive
We support multiple platforms including Linux, iOS & Windows.
NOTE: Linux has no mediums implemented.
Currently we support building from source using bazel. Other BUILD system such as cmake may be added later.
To build the Nearby Connection Core library:
CC=clang CXX=clang++ bazel build -s --check_visibility=false //connections:core --spawn_strategy=standalone --verbose_failures
NOTE: The only medium supported is Wi-Fi LAN.
Currently we support building with Swift Package Manager.
brew install protobuf
.To build the Nearby Connection library:
swift build
Mediums | Advertising | Scanning | Data |
---|---|---|---|
Bluetooth Classic | [x] | [x] | [x] |
BLE (Fast) | [x] | [x] | |
BLE (GATT) | [x] | [x] | [x] |
BLE (Extended) | [x] | [x] | |
BLE (L2CAP) | [x] | ||
Wi-Fi LAN | [x] | [x] | [x] |
Wi-Fi Hotspot | [x] | ||
Wi-Fi Direct | [x] | ||
Wi-Fi Aware | [x] | [x] | [x] |
WebRTC | [x] | ||
NFC | [x] | [x] | [x] |
USB | [x] | [x] | [x] |
AWDL |
Mediums | Advertising | Scanning | Data |
---|---|---|---|
Bluetooth Classic | [x] | [x] | [x] |
BLE (Fast) | [x] | [x] | |
BLE (GATT) | [ ] | [ ] | [ ] |
BLE (Extended) | [ ] | [ ] | |
BLE (L2CAP) | |||
Wi-Fi LAN | [ ] | [x] | [x] |
Wi-Fi Hotspot | [ ] | ||
Wi-Fi Direct | [ ] | ||
Wi-Fi Aware | |||
WebRTC | [x] | ||
NFC | |||
USB | [ ] | [ ] | [ ] |
AWDL |
Mediums | Advertising | Scanning | Data |
---|---|---|---|
Bluetooth Classic | [x] | [x] | |
BLE (Fast) | [x] | [x] | |
BLE (GATT) | [x] | [x] | [ ] |
BLE (Extended) | [x] | [x] | |
BLE (L2CAP) | |||
Wi-Fi LAN | [x] | [x] | [x] |
Wi-Fi Hotspot | [x] | ||
Wi-Fi Direct | [ ] | ||
Wi-Fi Aware | |||
WebRTC | [ ] | ||
NFC | |||
USB | [ ] | [ ] | [ ] |
AWDL |
Mediums | Advertising | Scanning | Data |
---|---|---|---|
Bluetooth Classic | [ ] | [ ] | |
BLE (Fast) | [ ] | [ ] | |
BLE (GATT) | [ ] | [ ] | [ ] |
BLE (Extended) | [ ] | ||
BLE (L2CAP) | [ ] | ||
Wi-Fi LAN | [x] | [x] | [x] |
Wi-Fi Hotspot | [ ] | ||
Wi-Fi Direct | |||
Wi-Fi Aware | |||
WebRTC | [ ] | ||
NFC | [ ] | ||
USB | |||
AWDL | [ ] | [ ] | [ ] |