Bắt đầu

Trước khi bạn bắt đầu

Trước khi bạn bắt đầu mã hóa bằng Nearby Connections API:

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

Trước khi sử dụng tính năng Kết nối lân cận, ứng dụng của bạn phải yêu cầu các quyền phù hợp. Thêm các quyền sau đây 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" />
<!-- 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 và READ_EXTERNAL_STORAGE được xem là quyền hệ thống nguy hiểm, ngoài việc thêm chúng 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ạy1, 3{/3

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