Zanim zaczniesz
Zanim zaczniesz pisać kod korzystający z Nearby Connections API:
- Zainstaluj pakiet SDK Usług Google Play.
- Pobierz i przejrzyj przykłady kodu Nearby Connections API samples.
Wyślij prośbę o uprawnienia
Zanim zaczniesz korzystać z Nearby Connections, Twoja aplikacja musi poprosić o odpowiednie uprawnienia. Dodaj te uprawnienia do pliku AndroidManifest.xml:
<!-- 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"/>
Uprawnienia
ACCESS_FINE_LOCATION,
BLUETOOTH_ADVERTISE,
BLUETOOTH_CONNECT,
BLUETOOTH_SCAN,
ACCESS_LOCAL_NETWORK
(wymagane od Androida 17 w przypadku aplikacji kierowanych na SDK 37 lub nowsze korzystające z WIFI_LAN),
i
READ_EXTERNAL_STORAGE
są uważane za niebezpieczne uprawnienia systemowe.
Oprócz dodania ich do pliku manifestu musisz poprosić o nie
w czasie działania aplikacji, zgodnie z opisem w artykule Prośba o uprawnienia.
Jeśli użytkownik nie przyzna wszystkich wymaganych uprawnień, Nearby Connections API nie pozwoli aplikacji na rozpoczęcie reklamowania ani wykrywania.