เริ่มใช้งาน

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

ก่อนเริ่มเขียนโค้ดโดยใช้ 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" />
<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"/>

เนื่องจาก ACCESS_FINE_LOCATION, BLUETOOTH_ADVERTISE, BLUETOOTH_CONNECT, BLUETOOTH_SCAN, ACCESS_LOCAL_NETWORK (จำเป็นตั้งแต่ Android 17 สำหรับแอปที่กำหนดเป้าหมายเป็น SDK 37 ขึ้นไปโดยใช้ WIFI_LAN) และ READ_EXTERNAL_STORAGE ถือเป็นสิทธิ์ของระบบที่อันตราย นอกเหนือจากการเพิ่มสิทธิ์เหล่านี้ลงในไฟล์ Manifest แล้ว คุณต้องขอสิทธิ์เหล่านี้ ในรันไทม์ตามที่อธิบายไว้ในหัวข้อการขอ สิทธิ์

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