เริ่มเลย

ก่อนเริ่มต้น

ก่อนจะเริ่มเขียนโค้ดโดยใช้ API การเชื่อมต่อ Nearby ให้ทำดังนี้

ขอสิทธิ์

ก่อนใช้การเชื่อมต่อใกล้เคียง แอปของคุณต้องขอ สิทธิ์ เพิ่มสิทธิ์ต่อไปนี้ใน 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 จัดว่าเป็นระบบที่อันตราย สิทธิ์ นอกเหนือจากการเพิ่มไฟล์ Manifest ลงในไฟล์ Manifest คุณจะต้องขอสิทธิ์เหล่านี้ ขณะรันไทม์ ตามที่อธิบายไว้ในการส่งคำขอ สิทธิ์

หากผู้ใช้ไม่ได้ให้สิทธิ์ที่จำเป็นทั้งหมด ระบบจะ API การเชื่อมต่อ Nearby จะปฏิเสธที่จะอนุญาตให้แอปของคุณเริ่มโฆษณาหรือการค้นพบ