Başlama

Başlamadan önce

Nearby Connections API'yi kullanarak kod yazmaya başlamadan önce:

İzin iste

Yakınlardaki Cihazlara Bağlantı özelliğini kullanmadan önce uygulamanızın uygun izinleri istemesi gerekir. AndroidManifest.xml uygulamanıza aşağıdaki izinleri ekleyin:

<!-- 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 (WIFI_LAN kullanan SDK 37 ve sonraki sürümleri hedefleyen uygulamalar için Android 17'den itibaren zorunlu), ve READ_EXTERNAL_STORAGE tehlikeli sistem izinleri olarak kabul edildiğinden, bunları manifestinize eklemenin yanı sıra İzin İsteğinde Bulunma bölümünde açıklandığı gibi çalışma zamanında da istemeniz gerekir.

Kullanıcı gerekli tüm izinleri vermezse Nearby Connections API, uygulamanızın reklam yayınlamasına veya keşif yapmasına izin vermez.