尋找藍牙裝置

使用 BluetoothAdapter,您可以透過裝置探索或查詢配對的裝置清單,尋找遠端藍牙裝置。

嘗試尋找藍牙裝置前,請確認您具備適當的藍牙權限,並為藍牙設定應用程式。

裝置探索是一種掃描程序,可搜尋本機區域中支援藍牙的裝置,並要求每部裝置提供部分資訊。這個程序有時稱為探索、查詢或掃描。只有在目前接受資訊要求且可供偵測時,鄰近的藍牙裝置才會回應探索要求。如果裝置可供偵測,就會回應偵測要求,分享裝置名稱、類別和專屬 MAC 位址等資訊。執行探索程序的裝置可利用這項資訊,選擇與探索到的裝置建立連線。

由於可供偵測的裝置可能會透露使用者的位置資訊,因此裝置偵測程序需要位置存取權。如果應用程式是在搭載 Android 8.0 (API 級別 26) 以上版本的裝置上使用,建議改用 隨附裝置管理工具 API。這個 API 會代表應用程式執行裝置探索,因此應用程式不需要要求位置存取權。

首次連線至遠端裝置時,系統會自動顯示配對要求。配對完成後,系統會儲存裝置的基本資訊 (例如裝置名稱、類別和 MAC 位址),並可透過藍牙 API 讀取。

只要使用配對的裝置的已知 MAC 位址,您隨時可以啟動連線,不必執行探索,前提是裝置仍在範圍內。

請注意,配對和連線不同:

  • 「配對」是指兩部裝置知道彼此的存在、共用可用於驗證的連結金鑰,且能夠彼此建立加密連線。
  • 「已連線」表示裝置目前共用 RFCOMM 管道,且能互相傳輸資料。目前的藍牙 API 要求裝置必須先配對,才能建立 RFCOMM 連線。當您使用藍牙 API 啟動加密連線時,系統會自動執行配對。

以下各節說明如何尋找已配對的裝置,以及如何使用裝置探索功能尋找新裝置。

查詢配對的裝置

執行裝置探索前,建議先查詢配對裝置組合,確認所需裝置是否已在清單中。如要這麼做,請呼叫 getBondedDevices()。這會傳回一組代表配對的裝置的 BluetoothDevice 物件。舉例來說,您可以查詢所有配對的裝置,並取得各裝置的名稱和 MAC 位址,如以下程式碼片段所示:

Kotlin

val pairedDevices: Set<BluetoothDevice>? = bluetoothAdapter?.bondedDevices
pairedDevices?.forEach { device ->
   val deviceName = device.name
   val deviceHardwareAddress = device.address // MAC address
}

Java

Set<BluetoothDevice> pairedDevices = bluetoothAdapter.getBondedDevices();

if (pairedDevices.size() > 0) {
   // There are paired devices. Get the name and address of each paired device.
   for (BluetoothDevice device : pairedDevices) {
       String deviceName = device.getName();
       String deviceHardwareAddress = device.getAddress(); // MAC address
   }
}

如要與藍牙裝置建立連線,相關聯的 BluetoothDevice 物件只需要 MAC 位址,您可以呼叫 getAddress() 擷取該位址。如要進一步瞭解如何建立連線,請參閱「連接藍牙裝置」。

探索裝置

如要開始探索裝置,請呼叫 startDiscovery()。這項程序為非同步,會傳回布林值,指出探索是否已成功啟動。探索程序通常包含約 12 秒的查詢掃描,接著對找到的每個裝置進行頁面掃描,以擷取其藍牙名稱。

如要接收每個偵測到的裝置資訊,應用程式必須為 ACTION_FOUND 意圖註冊 BroadcastReceiver。系統會為每部裝置廣播這項意圖。意圖包含額外欄位 EXTRA_DEVICE 和 EXTRA_CLASS,分別包含 BluetoothDevice 和 BluetoothClass。下列程式碼片段說明如何註冊,以便在偵測到裝置時處理廣播:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
   ...

   // Register for broadcasts when a device is discovered.
   val filter = IntentFilter(BluetoothDevice.ACTION_FOUND)
   registerReceiver(receiver, filter)
}

// Create a BroadcastReceiver for ACTION_FOUND.
private val receiver = object : BroadcastReceiver() {

   override fun onReceive(context: Context, intent: Intent) {
       val action: String = intent.action
       when(action) {
           BluetoothDevice.ACTION_FOUND -> {
               // Discovery has found a device. Get the BluetoothDevice
               // object and its info from the Intent.
               val device: BluetoothDevice =
                       intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE)
               val deviceName = device.name
               val deviceHardwareAddress = device.address // MAC address
           }
       }
   }
}

override fun onDestroy() {
   super.onDestroy()
   ...

   // Don't forget to unregister the ACTION_FOUND receiver.
   unregisterReceiver(receiver)
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
   ...

   // Register for broadcasts when a device is discovered.
   IntentFilter filter = new IntentFilter(BluetoothDevice.ACTION_FOUND);
   registerReceiver(receiver, filter);
}

// Create a BroadcastReceiver for ACTION_FOUND.
private final BroadcastReceiver receiver = new BroadcastReceiver() {
   public void onReceive(Context context, Intent intent) {
       String action = intent.getAction();
       if (BluetoothDevice.ACTION_FOUND.equals(action)) {
           // Discovery has found a device. Get the BluetoothDevice
           // object and its info from the Intent.
           BluetoothDevice device = intent.getParcelableExtra(BluetoothDevice.EXTRA_DEVICE);
           String deviceName = device.getName();
           String deviceHardwareAddress = device.getAddress(); // MAC address
       }
   }
};

@Override
protected void onDestroy() {
   super.onDestroy();
   ...

   // Don't forget to unregister the ACTION_FOUND receiver.
   unregisterReceiver(receiver);
}

如要與藍牙裝置建立連線,請在 BluetoothDevice 上呼叫 getAddress(),擷取相關聯的 MAC 位址。

啟用可偵測性

如要讓其他裝置可偵測到本機裝置,請使用 ACTION_REQUEST_DISCOVERABLE 意圖呼叫 startActivityForResult(Intent, int)。這會發出要求,啟用系統的可偵測模式,而不必前往「設定」應用程式,這會停止您自己的應用程式。根據預設,裝置會在兩分鐘內可供偵測。您可以新增 EXTRA_DISCOVERABLE_DURATION 額外項目,定義不同的時間長度 (最多五分鐘)。

下列程式碼片段會將裝置設為可供偵測五分鐘:

Kotlin

val requestCode = 1;
val discoverableIntent: Intent = Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE).apply {
   putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300)
}
startActivityForResult(discoverableIntent, requestCode)

Java

int requestCode = 1;
Intent discoverableIntent =
       new Intent(BluetoothAdapter.ACTION_REQUEST_DISCOVERABLE);
discoverableIntent.putExtra(BluetoothAdapter.EXTRA_DISCOVERABLE_DURATION, 300);
startActivityForResult(discoverableIntent, requestCode);
系統對話方塊,要求授予權限,讓裝置可供偵測
圖 1. 啟用可偵測性的對話方塊。

系統會顯示對話方塊,要求使用者授予權限,讓裝置可供偵測,如圖 1 所示。如果使用者回應「允許」,裝置就會在指定時間內可供偵測。接著,您的活動會收到對 onActivityResult() 回呼的呼叫,結果代碼等於裝置可供偵測的時間長度。如果使用者回應「Deny」或發生錯誤,結果代碼會是 RESULT_CANCELED。

裝置會在指定時間內保持可供偵測模式,不會發出任何通知。如要在可供偵測模式變更時收到通知,請為 ACTION_SCAN_MODE_CHANGED 意圖註冊 BroadcastReceiver。這個意圖包含額外欄位 EXTRA_SCAN_MODE 和 EXTRA_PREVIOUS_SCAN_MODE,分別提供新舊掃描模式。每個額外項目的可能值如下:

SCAN_MODE_CONNECTABLE_DISCOVERABLE
裝置處於可供偵測模式。
SCAN_MODE_CONNECTABLE
裝置未處於可供偵測模式,但仍可接收連線。
SCAN_MODE_NONE
裝置未設為可供偵測模式,無法接收連線。

如果您要啟動與遠端裝置的連線,則不需要啟用裝置可偵測性。只有在您希望應用程式託管接受傳入連線的伺服器通訊端時,才需要啟用可偵測性,因為遠端裝置必須能夠偵測其他裝置,才能啟動與這些裝置的連線。