Sebelum memulai
Sebelum Anda mulai membuat kode menggunakan Nearby Connections API:
- Instal Layanan Google Play SDK.
- Download dan tinjau contoh kode Nearby Connections API samples.
Meminta izin
Sebelum menggunakan Nearby Connections, aplikasi Anda harus meminta izin yang sesuai. Tambahkan izin berikut ke 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"/>
Karena
ACCESS_FINE_LOCATION,
BLUETOOTH_ADVERTISE,
BLUETOOTH_CONNECT,
BLUETOOTH_SCAN,
ACCESS_LOCAL_NETWORK
(diperlukan mulai Android 17 untuk aplikasi yang menargetkan SDK 37+ menggunakan WIFI_LAN),
dan
READ_EXTERNAL_STORAGE
dianggap sebagai izin sistem yang berbahaya,
selain menambahkannya ke manifes, Anda harus meminta izin ini
saat runtime, seperti yang dijelaskan dalam Meminta
Izin.
Jika pengguna tidak memberikan semua izin yang diperlukan, Nearby Connections API akan menolak untuk mengizinkan aplikasi Anda mulai mengiklankan atau menemukan.