开始使用

准备工作

开始使用 Nearby Connections API 进行编码之前，请执行以下操作：

请求权限

在使用 Nearby Connections 之前，您的应用必须先请求适当的 权限。向您的 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"/>

开始时间 ACCESS_FINE_LOCATION、 BLUETOOTH_ADVERTISE、 BLUETOOTH_CONNECT、 BLUETOOTH_SCAN 和 READ_EXTERNAL_STORAGE 被视为危险的系统 权限， 除了将其添加到清单中外，您还必须请求这些权限 如请求 权限。

如果用户未授予所有必需的权限，则 Nearby Connections API 会拒绝允许您的应用开始投放广告或让用户发现您的应用。