Começar

Antes de começar

Antes de começar a programar usando a API Nearby Connections:

• Instale o Google Play Services SDK do Cloud.
• Faça o download e revise o código da API Nearby Connections. de amostra.

Solicitar permissões

Antes de usar a Nearby Connections, seu app precisa solicitar as permissões. 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 sistemas perigosos permissões, além de adicioná-las ao manifesto, é necessário solicitar essas permissões no ambiente de execução, conforme descrito em Como solicitar Permissões.

Se o usuário não conceder todas as permissões necessárias, a API Nearby Connections se recusarão a permitir que seu app comece a anunciar ou fazer descobertas.