## Before you begin

Before you start to code using the Nearby Connections API:

- Install the [Google Play Services
  SDK](https://developer.android.com/google/play-services/setup.html).
- Download and review the [Nearby Connections API code
  samples](https://github.com/android/connectivity-samples/tree/main/NearbyConnectionsWalkieTalkie).

## Request permissions

Before using Nearby Connections, your app must request the appropriate
permissions. Add the following permissions to your `AndroidManifest.xml`:

```
<!-- Required for Nearby Connections -->
<uses-permission android:maxSdkVersion="32" android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:maxSdkVersion="32" android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:maxSdkVersion="30" android:name="android.permission.BLUETOOTH" />
<uses-permission android:maxSdkVersion="30" android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:maxSdkVersion="32" android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:minSdkVersion="29" android:maxSdkVersion="32" android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:minSdkVersion="31" android:name="android.permission.BLUETOOTH_ADVERTISE" />
<uses-permission android:minSdkVersion="31" android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:minSdkVersion="31" android:name="android.permission.BLUETOOTH_SCAN" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:minSdkVersion="33" android:name="android.permission.NEARBY_WIFI_DEVICES" android:usesPermissionFlags="neverForLocation" />
<uses-permission android:minSdkVersion="37" android:name="android.permission.ACCESS_LOCAL_NETWORK" />

<!-- Optional: only required for FILE payloads -->
<uses-permission android:maxSdkVersion="32" android:name="android.permission.READ_EXTERNAL_STORAGE" />
```

Since
[ACCESS_COARSE_LOCATION](https://developer.android.com/reference/android/Manifest.permission#ACCESS_COARSE_LOCATION),
[ACCESS_FINE_LOCATION](https://developer.android.com/reference/android/Manifest.permission#ACCESS_FINE_LOCATION),
[BLUETOOTH_ADVERTISE](https://developer.android.com/reference/android/Manifest.permission#BLUETOOTH_ADVERTISE),
[BLUETOOTH_CONNECT](https://developer.android.com/reference/android/Manifest.permission#BLUETOOTH_CONNECT),
[BLUETOOTH_SCAN](https://developer.android.com/reference/android/Manifest.permission#BLUETOOTH_SCAN),
[NEARBY_WIFI_DEVICES](https://developer.android.com/reference/android/Manifest.permission#NEARBY_WIFI_DEVICES),
[ACCESS_LOCAL_NETWORK](https://developer.android.com/reference/android/Manifest.permission#ACCESS_LOCAL_NETWORK)
(required starting in Android 17 for apps targeting SDK 37+ using `WIFI_LAN`),
and
[READ_EXTERNAL_STORAGE](https://developer.android.com/reference/android/Manifest.permission#READ_EXTERNAL_STORAGE)
are considered to be [dangerous system
permissions](https://developer.android.com/guide/topics/permissions/requesting.html#normal-dangerous),
in addition to adding them to your manifest, you must request these permissions
at runtime, as described in [Requesting
Permissions](https://developer.android.com/training/permissions/requesting.html).

If the user does not grant all required permissions, the Nearby Connections API
will refuse to allow your app to start advertising or discovering.