Bluetooth'u kur
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Uygulamanızın Bluetooth veya Bluetooth Düşük Enerji üzerinden iletişim kurabilmesi için
cihazda Bluetooth'un desteklendiğini doğrulamanız gerekir ve destekleniyorsa
etkin olduğundan emin olun. Bu kontrolün yalnızca
<uses-feature.../>
manifest dosyası girişindeki android:required
özelliği
false
olarak ayarlandı.
Bluetooth desteklenmiyorsa Bluetooth'u düzgünce devre dışı bırakmanız gerekir.
özellikleri. Bluetooth destekleniyor ancak devre dışı bırakılmışsa
kullanıcı, uygulamanızdan ayrılmadan Bluetooth'u etkinleştirebilir.
İlk adım
Bluetooth izinlerini ekleme
manifest dosyanıza ekleyin.
İzinler verildikten sonra Bluetooth kurulumu iki adımda tamamlanır
BluetoothAdapter
kullanarak:
BluetoothAdapter
edinin.
BluetoothAdapter
, tüm Bluetooth etkinlikleri için gereklidir. İlgili içeriği oluşturmak için kullanılan
BluetoothAdapter
, cihazın kendi Bluetooth adaptörünü (
Bluetooth radyo). BluetoothAdapter
almak için öncelikle bir
Context
Elde ettiğiniz verileri
BluetoothManager
örneği
sisteme ait hizmet. BluetoothManager#getAdapter
aranıyor
size BluetoothAdapter
nesnesini verir. getAdapter()
, null döndürürse
Bluetooth'u desteklemiyorsa
Örnek:
Kotlin
val bluetoothManager: BluetoothManager = getSystemService(BluetoothManager::class.java)
val bluetoothAdapter: BluetoothAdapter? = bluetoothManager.getAdapter()
if (bluetoothAdapter == null) {
// Device doesn't support Bluetooth
}
Java
BluetoothManager bluetoothManager = getSystemService(BluetoothManager.class);
BluetoothAdapter bluetoothAdapter = bluetoothManager.getAdapter();
if (bluetoothAdapter == null) {
// Device doesn't support Bluetooth
}
Bluetooth'u etkinleştirin.
Ardından, Bluetooth'un etkinleştirildiğinden emin olmanız gerekir. Telefonla arama
isEnabled()
-
Bluetooth'un şu anda etkin olup olmadığını kontrol edin. Bu yöntem false (yanlış) değerini döndürürse
Bluetooth devre dışı bırakılır. Bluetooth'un etkinleştirilmesini istemek için şu numarayı arayın:
startActivityForResult()
bir
ACTION_REQUEST_ENABLE
intent işlemidir. Bu görüşme, Bluetooth'u etkinleştirmek için bir istek gönderir.
(uygulamanızı durdurmadan) kontrol edin.
Örnek:
Kotlin
if (bluetoothAdapter?.isEnabled == false) {
val enableBtIntent = Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE)
startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT)
}
Java
if (!bluetoothAdapter.isEnabled()) {
Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);
startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT);
}
Aşağıdaki gibi, Bluetooth'u etkinleştirmek için kullanıcı izni isteyen bir iletişim kutusu görünür:
Şekil 1. Kullanıcı izin verirse sistem Bluetooth'u etkinleştirmeye başlar.
ve süreç tamamlandığında (veya başarısız olduğunda) odak uygulamanıza geri döner.
Şekil 1. Bluetooth'u etkinleştirme iletişim kutusu.
REQUEST_ENABLE_BT
sabiti
startActivityForResult()
0'dan büyük veya 0'a eşit olması gereken, yerel olarak tanımlanmış bir tam sayıdır. Sistem
bu sabit bilgiyi size
onActivityResult()
requestCode
parametresi olarak uygulanır.
Bluetooth etkinleştirildiğinde, etkinliğiniz
RESULT_OK
sonuç kodu
onActivityResult()
geri arama. Bluetooth bir hata nedeniyle etkinleştirilmemişse (veya
kullanıcı "Reddet") yanıt verirse sonuç kodu şöyle olur:
RESULT_CANCELED
.
İsteğe bağlı olarak, uygulamanız ayrıca
ACTION_STATE_CHANGED
yayın amacı (Bluetooth durumu her Bluetooth olduğunda sistemin yayınladığı
anlamına gelir. Bu yayın ek alanlar içeriyor
EXTRA_STATE
ve
EXTRA_PREVIOUS_STATE
,
sırasıyla yeni ve eski Bluetooth durumlarını içeren öğeler arasında yer alır. Olası değerler
bu ekstra alanlar
STATE_TURNING_ON
STATE_ON
,
STATE_TURNING_OFF
,
ve STATE_OFF
.
Uygulamanızın çalışma zamanını algılaması gerekiyorsa bu yayını dinlemek faydalı olabilir
Bluetooth durumunda yapılan değişiklikler.
İpucu: Keşfedilebilirlik özelliği etkinleştirildiğinde otomatik olarak
Bluetooth'a dokunun. Güncellemeden önce cihaz bulunabilirliğini sürekli olarak etkinleştirmeyi planlıyorsanız
bir hata alıyorsanız önceki adımlarda verilen 2. adımı atlayabilirsiniz.
Cihazda Bluetooth etkinleştirildikten sonra Bluetooth klasik ve Bluetooth özelliklerini
Bluetooth Düşük Enerji.
Bluetooth klasik için Bluetooth cihazları bulabilirsiniz
ve
Bluetooth cihazlara bağlanma.
Bluetooth Düşük Enerji için BDE cihazlarını bulabilir, bir GATT sunucusuna bağlanabilir ve
BDE verilerini aktarın.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-27 UTC."],[],[],null,["# Set up Bluetooth\n\nBefore your app can communicate over Bluetooth or Bluetooth Low Energy,\nyou need to verify that Bluetooth is supported on the device, and if it is,\nensure that it is enabled. Note that this check is only necessary if the\n`android:required` attribute in the `\u003cuses-feature.../\u003e` manifest file entry is\nset to `false`.\n\nIf Bluetooth isn't supported, then you should gracefully disable any Bluetooth\nfeatures. If Bluetooth is supported, but disabled, then you can request that the\nuser enable Bluetooth without leaving your app.\n\nThe first step is\n[adding the Bluetooth permissions](/develop/connectivity/bluetooth/bt-permissions#declare)\nto your manifest file in order to use the following APIs.\n\nOnce the permissions are in place, Bluetooth setup is accomplished in two steps\nusing the [`BluetoothAdapter`](/reference/android/bluetooth/BluetoothAdapter):\n\n1. Get the `BluetoothAdapter`.\n\n The `BluetoothAdapter` is required for any and all Bluetooth activity. The\n `BluetoothAdapter` represents the device's own Bluetooth adapter (the\n Bluetooth radio). To get a `BluetoothAdapter`, you first need to have a\n [`Context`](/reference/android/content/Context). Use this context to obtain\n an instance of the [`BluetoothManager`](/reference/android/bluetooth/BluetoothManager)\n system service. Calling [`BluetoothManager#getAdapter`](/reference/android/bluetooth/BluetoothManager#getAdapter)\n will give you a `BluetoothAdapter` object. If `getAdapter()` returns null,\n then the device doesn't support Bluetooth.\n\n For example: \n\n ### Kotlin\n\n ```kotlin\n val bluetoothManager: BluetoothManager = getSystemService(BluetoothManager::class.java)\n val bluetoothAdapter: BluetoothAdapter? = bluetoothManager.getAdapter()\n if (bluetoothAdapter == null) {\n // Device doesn't support Bluetooth\n }\n ```\n\n ### Java\n\n ```java\n BluetoothManager bluetoothManager = getSystemService(BluetoothManager.class);\n BluetoothAdapter bluetoothAdapter = bluetoothManager.getAdapter();\n if (bluetoothAdapter == null) {\n // Device doesn't support Bluetooth\n }\n ```\n2. Enable Bluetooth.\n\n Next, you need to ensure that Bluetooth is enabled. Call\n [`isEnabled()`](/reference/android/bluetooth/BluetoothAdapter#isEnabled()) to\n check whether Bluetooth is currently enabled. If this method returns false,\n then Bluetooth is disabled. To request that Bluetooth be enabled, call\n [`startActivityForResult()`](/reference/android/app/Activity#startActivityForResult(android.content.Intent,%20int)),\n passing in an\n [`ACTION_REQUEST_ENABLE`](/reference/android/bluetooth/BluetoothAdapter#ACTION_REQUEST_ENABLE)\n intent action. This call issues a request to enable Bluetooth through the\n system settings (without stopping your app).\n\n For example: \n\n ### Kotlin\n\n ```kotlin\n if (bluetoothAdapter?.isEnabled == false) {\n val enableBtIntent = Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE)\n startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT)\n }\n ```\n\n ### Java\n\n ```java\n if (!bluetoothAdapter.isEnabled()) {\n Intent enableBtIntent = new Intent(BluetoothAdapter.ACTION_REQUEST_ENABLE);\n startActivityForResult(enableBtIntent, REQUEST_ENABLE_BT);\n }\n ```\n\n \u003cbr /\u003e\n\nA dialog appears requesting user permission to enable Bluetooth, as shown in\nfigure 1. If the user grants permission, the system begins to enable Bluetooth,\nand focus returns to your app once the process completes (or fails).\n\n\u003cbr /\u003e\n\n\n**Figure 1.** The enabling Bluetooth dialog.\n\nThe `REQUEST_ENABLE_BT` constant passed to\n[`startActivityForResult()`](/reference/android/app/Activity#startActivityForResult(android.content.Intent,%20int))\nis a locally-defined integer that must be greater than or equal to 0. The system\npasses this constant back to you in your\n[`onActivityResult()`](/reference/android/app/Activity#onActivityResult(int,%20int,%20android.content.Intent))\nimplementation as the `requestCode` parameter.\n\nIf enabling Bluetooth succeeds, your activity receives the\n[`RESULT_OK`](/reference/android/app/Activity#RESULT_OK) result code in the\n`onActivityResult()` callback. If Bluetooth was not enabled due to an error (or\nthe user responded \"Deny\") then the result code is\n[`RESULT_CANCELED`](/reference/android/app/Activity#RESULT_CANCELED).\n\nOptionally, your app can also listen for the\n[`ACTION_STATE_CHANGED`](/reference/android/bluetooth/BluetoothAdapter#ACTION_STATE_CHANGED)\nbroadcast intent, which the system broadcasts whenever the Bluetooth state\nchanges. This broadcast contains the extra fields\n[`EXTRA_STATE`](/reference/android/bluetooth/BluetoothAdapter#EXTRA_STATE) and\n[`EXTRA_PREVIOUS_STATE`](/reference/android/bluetooth/BluetoothAdapter#EXTRA_PREVIOUS_STATE),\ncontaining the new and old Bluetooth states, respectively. Possible values for\nthese extra fields are\n[`STATE_TURNING_ON`](/reference/android/bluetooth/BluetoothAdapter#STATE_TURNING_ON),\n[`STATE_ON`](/reference/android/bluetooth/BluetoothAdapter#STATE_ON),\n[`STATE_TURNING_OFF`](/reference/android/bluetooth/BluetoothAdapter#STATE_TURNING_OFF),\nand [`STATE_OFF`](/reference/android/bluetooth/BluetoothAdapter#STATE_OFF).\nListening for this broadcast can be useful if your app needs to detect runtime\nchanges made to the Bluetooth state. \n**Tip:** Enabling discoverability automatically enables Bluetooth. If you plan to consistently enable device discoverability before performing Bluetooth activity, you can skip step 2 in the earlier steps.\n\nOnce Bluetooth is enabled on the device, you can use both Bluetooth classic and\nBluetooth Low Energy.\n\nFor Bluetooth classic, you can [find Bluetooth devices](/develop/connectivity/bluetooth/find-bluetooth-devices)\nand\n[connect to Bluetooth devices](/develop/connectivity/bluetooth/connect-bluetooth-devices).\n\nFor Bluetooth Low Energy, you can [find BLE devices](/develop/connectivity/bluetooth/find-ble-devices), [connect to a GATT server](/develop/connectivity/bluetooth/connect-gatt-server), and\n[transfer BLE data](/develop/connectivity/bluetooth/transfer-ble-data)."]]