Antes de começar
Antes de começar a codificar usando a API Nearby Connections:
- Instale o SDK do Google Play Services.
- Faça o download e analise as amostras de código da Nearby Connections API.
Solicitar permissões
Antes de usar o Nearby Connections, seu app precisa solicitar as permissões
adequadas. Adicione as seguintes permissões ao 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" /> <!-- Optional: only required for FILE payloads --> <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
Como ACCESS_FINE_LOCATION, BLUETOOTH_ADVERTISE, BLUETOOTH_CONNECT, BLUETOOTH_SCAN e READ_EXTERNAL_STORAGE são considerados permissões perigosas do sistema, além de adicioná-las ao manifesto, você precisa solicitar essas permissões no ambiente de execução.
Se o usuário não conceder todas as permissões necessárias, a API Nearby Connections se recusará a permitir que seu app comece a anunciar ou descobrir.