Los gehts

Hinweis

Bevor Sie mit dem Programmieren mit der Nearby Connections API beginnen, sollten Sie Folgendes tun:

Berechtigungen anfordern

Bevor Sie Nearby Connections verwenden können, muss Ihre App die entsprechenden Berechtigungen anfordern. Fügen Sie Ihrem AndroidManifest.xml die folgenden Berechtigungen hinzu:

<!-- Required for Nearby Connections -->
<uses-permission android:maxSdkVersion="31" android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:maxSdkVersion="31" 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="28" android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:minSdkVersion="29" android:maxSdkVersion="31" 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" />
<uses-permission android:minSdkVersion="32" android:name="android.permission.NEARBY_WIFI_DEVICES" />
<uses-permission android:minSdkVersion="37" android:name="android.permission.ACCESS_LOCAL_NETWORK" />
<!-- Optional: only required for FILE payloads -->
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

Da ACCESS_FINE_LOCATION, BLUETOOTH_ADVERTISE, BLUETOOTH_CONNECT, BLUETOOTH_SCAN, ACCESS_LOCAL_NETWORK (ab Android 17 für Apps, die auf SDK 37 oder höher ausgerichtet sind und WIFI_LAN verwenden) und READ_EXTERNAL_STORAGE als gefährliche Systemberechtigungen gelten, müssen Sie diese Berechtigungen nicht nur Ihrem Manifest hinzufügen, sondern auch zur Laufzeit anfordern, wie unter Berechtigungen anfordern beschrieben.

Wenn der Nutzer nicht alle erforderlichen Berechtigungen erteilt, verweigert die Nearby Connections API Ihrer App die Möglichkeit, mit dem Broadcasting oder der Suche zu beginnen.