Bắt đầu

Trước khi bắt đầu

Trước khi bạn bắt đầu viết mã bằng cách sử dụng Nearby Connections API:

Yêu cầu cấp quyền

Trước khi sử dụng Nearby Connections, ứng dụng của bạn phải yêu cầu các quyền thích hợp. Thêm các quyền sau vào 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"/>

Vì ACCESS_FINE_LOCATION, BLUETOOTH_ADVERTISE, BLUETOOTH_CONNECT, BLUETOOTH_SCAN, ACCESS_LOCAL_NETWORK (bắt buộc từ Android 17 đối với các ứng dụng nhắm đến SDK 37 trở lên bằng WIFI_LAN), và READ_EXTERNAL_STORAGE được coi là các quyền hệ thống nguy hiểm, ngoài việc thêm các quyền này vào tệp kê khai, bạn phải yêu cầu các quyền này trong thời gian chạy, như mô tả trong phần Yêu cầu cấp quyền.

Nếu người dùng không cấp tất cả các quyền bắt buộc, Nearby Connections API sẽ từ chối cho phép ứng dụng của bạn bắt đầu quảng cáo hoặc khám phá.