BluetoothAdapter

版本：Android 2.3 r1

?

結(jié)構(gòu)

繼承關(guān)系

public final class BluetoothAdapter extends Object

????????

java.lang.Object

android.bluetooth.BluetoothAdapter

?

類概述

代表本地的藍(lán)牙適配器設(shè)備。BluetoothAdapter類讓用戶能執(zhí)行基本的藍(lán)牙任務(wù)。例如： 初始化設(shè)備的搜索，查詢可匹配的設(shè)備集，使用一個(gè)已知的MAC地址來初始化一個(gè)BluetoothDevice類，創(chuàng)建一個(gè) BluetoothServerSocket類以監(jiān)聽其它設(shè)備對(duì)本機(jī)的連接請(qǐng)求等。

為了得到這個(gè)代表本地藍(lán)牙適配器的 BluetoothAdapter類，調(diào)用getDefaultAdapter()這一靜態(tài)方法。這是所有藍(lán)牙動(dòng)作使用的第一步。當(dāng)擁有本地適配器以后， 用戶可以獲得一系列的BluetoothDevice對(duì)象，這些對(duì)象代表所有擁有getBondedDevice()方法的已經(jīng)匹配的設(shè)備；用 startDiscovery()方法來開始設(shè)備的搜尋；或者創(chuàng)建一個(gè)BluetoothServerSocket類，通過 listenUsingRfcommWithServiceRecord(String, UUID)方法來監(jiān)聽新來的連接請(qǐng)求。

Note：大部分方法需要BLUETOOTH權(quán)限，一些方法同時(shí)需要BLUETOOTH_ADMIN權(quán)限。

參見

?????????????????? BluetoothDevice

?????? BluetoothServerSocket

?

常量

???????? String ???? ACTION_DISCOVERY_FINISHED ??

廣播事件：本地藍(lán)牙適配器已經(jīng)完成設(shè)備的搜尋過程。

需要BLUETOOTH權(quán)限接收。

常量值: "android.bluetooth.adapter.action.DISCOVERY_FINISHED"

?

String ???? ACTION_DISCOVERY_STARTED ???

廣播事件：本地藍(lán)牙適配器已經(jīng)開始對(duì)遠(yuǎn)程設(shè)備的搜尋過程。

它通常牽涉到一個(gè)大概需時(shí)12秒的查詢掃描過程，緊跟著是一個(gè)對(duì)每個(gè)獲取到自身藍(lán)牙名稱的新設(shè)備的頁(yè)面掃描。

???????? 用戶會(huì)發(fā)現(xiàn)一個(gè)把ACTION_FOUND常量通知為遠(yuǎn)程藍(lán)牙設(shè)備的注冊(cè)。
設(shè)備查找是一個(gè)重量級(jí)過程。當(dāng)查找正在進(jìn)行的時(shí)候，用戶不能嘗試對(duì)新的遠(yuǎn)程藍(lán)牙設(shè)備進(jìn)行連接，同時(shí)存在的連接將獲得有限制的帶寬以及高等待時(shí)間。用戶可用cancelDiscovery()類來取消正在執(zhí)行的查找進(jìn)程。

需要BLUETOOTH權(quán)限接收。

常量值: "android.bluetooth.adapter.action.DISCOVERY_STARTED"

?

String ???? ACTION_LOCAL_NAME_CHANGED ?????

廣播活動(dòng)：本地藍(lán)牙適配器已經(jīng)更改了它的藍(lán)牙名稱。

該名稱對(duì)遠(yuǎn)程藍(lán)牙設(shè)備是可見的。

它總是包含了一個(gè)帶有名稱的EXTRA_LOCAL_NAME附加域。

需要BLUETOOTH權(quán)限接收。

常量值: "android.bluetooth.adapter.action.LOCAL_NAME_CHANGED"

?

String ???? ACTION_REQUEST_DISCOVERABLE ?????

Activity活動(dòng)：顯示一個(gè)請(qǐng)求被搜尋模式的系統(tǒng)活動(dòng)。如果藍(lán)牙模塊當(dāng)前未打開，該活動(dòng)也將請(qǐng)求用戶打開藍(lán)牙模塊。

被搜尋模式和SCAN_MODE_CONNECTABLE_DISCOVERABLE等價(jià)。當(dāng)遠(yuǎn)程設(shè)備執(zhí)行查找進(jìn)程的時(shí)候，它允許其發(fā)現(xiàn)該藍(lán)牙適配器。

從隱私安全考慮，Android不會(huì)將被搜尋模式設(shè)置為默認(rèn)狀態(tài)。

該意圖的發(fā)送者可以選擇性地運(yùn)用EXTRA_DISCOVERABLE_DURATION這個(gè)附加域去請(qǐng)求發(fā)現(xiàn)設(shè)備的持續(xù)時(shí)間。普遍來說，對(duì)于每一請(qǐng)求，默認(rèn)的持續(xù)時(shí)間為120秒，最大值則可達(dá)到300秒。

Android 運(yùn)用onActivityResult(int, int, Intent)回收方法來傳遞該活動(dòng)結(jié)果的通知。被搜尋的時(shí)間（以秒為單位）將通過resultCode值來顯示，如果用戶拒絕被搜尋，或者設(shè)備產(chǎn)生了錯(cuò) 誤，則通過RESULT_CANCELED值來顯示。

每當(dāng)掃描模式變化的時(shí)候，應(yīng)用程序可以為通過ACTION_SCAN_MODE_CHANGED值來監(jiān)聽全局的消息通知。比如，當(dāng)設(shè)備停止被搜尋以后，該消息可以被系統(tǒng)通知給應(yīng)用程序。

需要BLUETOOTH權(quán)限

常量值: "android.bluetooth.adapter.action.REQUEST_DISCOVERABLE"

?

String ???? ACTION_REQUEST_ENABLE

Activity活動(dòng)：顯示一個(gè)允許用戶打開藍(lán)牙模塊的系統(tǒng)活動(dòng)。

當(dāng)藍(lán)牙模塊完成打開工作，或者當(dāng)用戶決定不打開藍(lán)牙模塊時(shí)，系統(tǒng)活動(dòng)將返回該值。

Android 運(yùn)用onActivityResult(int, int, Intent)回收方法來傳遞該活動(dòng)結(jié)果的通知。如果藍(lán)牙模塊被打開，將通過resultCode值RESULT_OK來顯示；如果用戶拒絕該請(qǐng)求，或者設(shè)備產(chǎn)生了錯(cuò)誤，則通過RESULT_CANCELED值來顯示。

???????? 每當(dāng)藍(lán)牙模塊被打開或者關(guān)閉，應(yīng)用程序可以為通過ACTION_STATE_CHANGED值來監(jiān)聽全局的消息通知。

需要BLUETOOTH權(quán)限

常量值: "android.bluetooth.adapter.action.REQUEST_ENABLE"

?

String ???? ACTION_SCAN_MODE_CHANGED ???????

廣播活動(dòng)：指明藍(lán)牙掃描模塊或者本地適配器已經(jīng)發(fā)生變化

它總是包含EXTRA_SCAN_MODE和EXTRA_PREVIOUS_SCAN_MODE。這兩個(gè)附加域各自包含了新的和舊的掃描模式。

需要BLUETOOTH權(quán)限

常量值: "android.bluetooth.adapter.action.SCAN_MODE_CHANGED"

?

String ???? ACTION_STATE_CHANGED ??

廣播活動(dòng)：本來的藍(lán)牙適配器的狀態(tài)已經(jīng)改變。

例如：藍(lán)牙模塊已經(jīng)被打開或者關(guān)閉。

它總是包含EXTRA_STATE和EXTRA_PREVIOUS_STATE。這兩個(gè)附加域各自包含了新的和舊的狀態(tài)。

需要BLUETOOTH權(quán)限接收

常量值: "android.bluetooth.adapter.action.STATE_CHANGED"

?

int ? ERROR ??

標(biāo)記該類的錯(cuò)誤值。確保和該類中的任意其它整數(shù)常量不相等。它為需要一個(gè)標(biāo)記錯(cuò)誤值的函數(shù)提供了便利。例如：

Intent.getIntExtra(BluetoothAdapter.EXTRA_STATE, BluetoothAdapter.ERROR)

常量值: -2147483648 (0x80000000)

?

String ???? EXTRA_DISCOVERABLE_DURATION ????

試圖在ACTION_REQUEST_DISCOVERABLE常量中作為一個(gè)可選的整型附加域，來為短時(shí)間內(nèi)的設(shè)備發(fā)現(xiàn)請(qǐng)求一個(gè)特定的持續(xù)時(shí)間。默認(rèn)值為120秒，超過300秒的請(qǐng)求將被限制。這些值是可以變化的。

常量值: "android.bluetooth.adapter.extra.DISCOVERABLE_DURATION"

?

String ???? EXTRA_LOCAL_NAME ??

試圖在ACTION_LOCAL_NAME_CHANGED常量中作為一個(gè)字符串附加域，來請(qǐng)求本地藍(lán)牙的名稱。

常量值: "android.bluetooth.adapter.extra.LOCAL_NAME"

?

String ???? EXTRA_PREVIOUS_SCAN_MODE ?

試圖在ACTION_SCAN_MODE_CHANGED常量中作為一個(gè)整型附加域，來請(qǐng)求以前的掃描模式?？赡苤涤?span lang="EN-US">: SCAN_MODE_NONE, SCAN_MODE_CONNECTABLE, SCAN_MODE_CONNECTABLE_DISCOVERABLE

常量值: "android.bluetooth.adapter.extra.PREVIOUS_SCAN_MODE"

?

String ???? EXTRA_PREVIOUS_STATE ?????

試圖在ACTION_STATE_CHANGED常量中作為一個(gè)整型附加域，來請(qǐng)求以前的供電狀態(tài)。 可能值有: STATE_OFF, STATE_TURNING_ON, STATE_ON, STATE_TURNING_OFF

常量值: "android.bluetooth.adapter.extra.PREVIOUS_STATE"

?

String ???? EXTRA_SCAN_MODE ????

試圖在ACTION_SCAN_MODE_CHANGED常量中作為一個(gè)整型附加域，來請(qǐng)求當(dāng)前的掃描模式.可能值有: SCAN_MODE_NONE, SCAN_MODE_CONNECTABLE, SCAN_MODE_CONNECTABLE_DISCOVERABLE

常量值: "android.bluetooth.adapter.extra.SCAN_MODE"

?

String ???? EXTRA_STATE ????????

試圖在ACTION_STATE_CHANGED常量中作為一個(gè)整型附加域，來請(qǐng)求當(dāng)前的供電狀態(tài)。 可能值有: STATE_OFF, STATE_TURNING_ON, STATE_ON, STATE_TURNING_OFF

常量值: "android.bluetooth.adapter.extra.STATE"

?

int ? SCAN_MODE_CONNECTABLE ??????

指明在本地藍(lán)牙適配器中，查詢掃描功能失效，但頁(yè)面掃描功能有效。因此該設(shè)備不能被遠(yuǎn)程藍(lán)牙設(shè)備發(fā)現(xiàn)，但如果以前曾經(jīng)發(fā)現(xiàn)過該設(shè)備，則遠(yuǎn)程設(shè)備可以對(duì)其進(jìn)行連接。

常量值: 21 (0x00000015)

?

int ? SCAN_MODE_CONNECTABLE_DISCOVERABLE ???

指明在本地藍(lán)牙適配器中，查詢掃描功能和頁(yè)面掃描功能都有效。因此該設(shè)備既可以被遠(yuǎn)程藍(lán)牙設(shè)備發(fā)現(xiàn)，也可以被其連接。

常量值: 23 (0x00000017)

?

int ? SCAN_MODE_NONE ?????

指明在本地藍(lán)牙適配器中，查詢掃描功能和頁(yè)面掃描功能都失效. 因此該設(shè)備既不可以被遠(yuǎn)程藍(lán)牙設(shè)備發(fā)現(xiàn)，也不可以被其連接。

常量值: 20 (0x00000014)

?

int ? STATE_OFF ????

指明本地藍(lán)牙適配器模塊已經(jīng)關(guān)閉

常量值: 10 (0x0000000a)

?

int ? STATE_ON ?????

指明本地藍(lán)牙適配器模塊已經(jīng)打開，并且準(zhǔn)備被使用。

常量值: 12 (0x0000000c)

?

int ? STATE_TURNING_OFF ??

指明本地藍(lán)牙適配器模塊正在關(guān)閉。本地客戶端可以立刻嘗試友好地?cái)嚅_任意外部連接。

常量值: 13 (0x0000000d)

?

int ? STATE_TURNING_ON ???

指明本地藍(lán)牙適配器模塊正在打開. 然而本地客戶在嘗試使用這個(gè)適配器之前需要為STATE_ON狀態(tài)而等待。

常量值: 11 (0x0000000b)

?

公共方法

public boolean cancelDiscovery ()

取消當(dāng)前的設(shè)備發(fā)現(xiàn)查找進(jìn)程

需要BLUETOOTH_ADMIN權(quán)限。

因?yàn)閷?duì)藍(lán)牙適配器而言，查找是一個(gè)重量級(jí)的過程，因此這個(gè)方法必須在嘗試連接到遠(yuǎn)程設(shè)備前使用用connect()方法進(jìn)行調(diào)用。發(fā)現(xiàn)的過程不會(huì)由活動(dòng)來進(jìn)行管理，但是它會(huì)作為一個(gè)系統(tǒng)服務(wù)來運(yùn)行，因此即使它不能直接請(qǐng)求這樣的一個(gè)查詢動(dòng)作，也必需取消該搜索進(jìn)程。

如果藍(lán)牙狀態(tài)不是STATE_ON，這個(gè)API將返回false。藍(lán)牙打開后，等待ACTION_STATE_CHANGED更新成STATE_ON。

返回值

成功則返回true，有錯(cuò)誤則返回false。

?

public static boolean checkBluetoothAddress (String address)

驗(yàn)證皆如"00:43:A8:23:10:F0"之類的藍(lán)牙地址。

字母必須為大寫才有效。

參數(shù)

address 字符串形式的藍(lán)牙模塊地址

返回值

地址正確則返回true，否則返回false。

?

public boolean disable ()

關(guān)閉本地藍(lán)牙適配器—不能在沒有明確關(guān)閉藍(lán)牙的用戶動(dòng)作中使用。

這個(gè)方法友好地停止所有的藍(lán)牙連接，停止藍(lán)牙系統(tǒng)服務(wù)，以及對(duì)所有基礎(chǔ)藍(lán)牙硬件進(jìn)行斷電。

沒有用戶的直接同意，藍(lán)牙永遠(yuǎn)不能被禁止。這個(gè)disable()方法只提供了一個(gè)應(yīng)用，該應(yīng)用包含了一個(gè)改變系統(tǒng)設(shè)置的用戶界面（例如“電源控制”應(yīng)用）。

這 是一個(gè)異步調(diào)用方法：該方法將馬上獲得返回值，用戶要通過監(jiān)聽ACTION_STATE_CHANGED值來獲取隨后的適配器狀態(tài)改變的通知。如果該調(diào)用 返回true值，則該適配器狀態(tài)會(huì)立刻從STATE_ON轉(zhuǎn)向STATE_TURNING_OFF，稍后則會(huì)轉(zhuǎn)為STATE_OFF或者 STATE_ON。如果該調(diào)用返回false，那么系統(tǒng)已經(jīng)有一個(gè)保護(hù)藍(lán)牙適配器被關(guān)閉的問題—比如該適配器已經(jīng)被關(guān)閉了。

需要BLUETOOTH_ADMIN權(quán)限。

?????????????????? 返回值

如果藍(lán)牙適配器的停止進(jìn)程已經(jīng)開啟則返回true，如果產(chǎn)生錯(cuò)誤則返回false。

?

public boolean enable ()

???????? 打開本地藍(lán)牙適配器—不能在沒有明確打開藍(lán)牙的用戶動(dòng)作中使用。

該方法將為基礎(chǔ)的藍(lán)牙硬件供電，并且啟動(dòng)所有的藍(lán)牙系統(tǒng)服務(wù)。

沒有用戶的直接同意，藍(lán)牙永遠(yuǎn)不能被禁止。如果用戶為了創(chuàng)建無線連接而打開了藍(lán)牙模塊，則其需要ACTION_REQUEST_ENABLE值，該值將提出 一個(gè)請(qǐng)求用戶允許以打開藍(lán)牙模塊的會(huì)話。這個(gè)enable()值只提供了一個(gè)應(yīng)用，該應(yīng)用包含了一個(gè)改變系統(tǒng)設(shè)置的用戶界面（例如“電源控制”應(yīng)用）。

這是一個(gè)異步調(diào)用方法：該方法將馬上獲得返回值，用戶要通過監(jiān)聽ACTION_STATE_CHANGED值來獲取隨后的適配器狀態(tài)改變的通知。如果該調(diào)用 返回true值，則該適配器狀態(tài)會(huì)立刻從STATE_OFF轉(zhuǎn)向STATE_TURNING_ON，稍后則會(huì)轉(zhuǎn)為STATE_OFF或者 STATE_ON。如果該調(diào)用返回false，那么說明系統(tǒng)已經(jīng)有一個(gè)保護(hù)藍(lán)牙適配器被打開的問題—比如飛行模式，或者該適配器已經(jīng)被打開。

需要BLUETOOTH_ADMIN權(quán)限。

返回值????

如果藍(lán)牙適配器的打開進(jìn)程已經(jīng)開啟則返回true，如果產(chǎn)生錯(cuò)誤則返回false。

?

public String getAddress ()

返回本地藍(lán)牙適配器的硬件地址

例如： "00:11:22:AA:BB:CC"

需要BLUETOOTH權(quán)限。

返回值????

字符串形式的藍(lán)牙模塊地址

?

public Set<BluetoothDevice> getBondedDevices ()

返回已經(jīng)匹配到本地適配器的BluetoothDevice類的對(duì)象集合

如果藍(lán)牙狀態(tài)不是STATE_ON，這個(gè)API將返回false。藍(lán)牙打開后，等待ACTION_STATE_CHANGED更新成STATE_ON。

需要BLUETOOTH權(quán)限。

返回值

未被修改的BluetoothDevice類的對(duì)象集合，如果有錯(cuò)誤則返回null。

?

public static synchronized BluetoothAdapter getDefaultAdapter ()

獲取對(duì)默認(rèn)本地藍(lán)牙適配器的的操作權(quán)限。

目前Andoird只支持一個(gè)藍(lán)牙適配器，但是API可以被擴(kuò)展為支持多個(gè)適配器。該方法總是返回默認(rèn)的適配器。

返回值

返回默認(rèn)的本地適配器，如果藍(lán)牙適配器在該硬件平臺(tái)上不能被支持，則返回null。

?

public String getName ()

獲取本地藍(lán)牙適配器的藍(lán)牙名稱

這個(gè)名稱對(duì)于外界藍(lán)牙設(shè)備而言是可見的。

需要BLUETOOTH權(quán)限。

返回值

該藍(lán)牙適配器名稱，如果有錯(cuò)誤則返回null

?

public BluetoothDevice getRemoteDevice (String address)

為給予的藍(lán)牙硬件地址獲取一個(gè)BluetoothDevice對(duì)象。

???????? 合法的藍(lán)牙硬件地址必須為大寫，格式類似于"00:11:22:33:AA:BB"。checkBluetoothAddress(String)方法可以用來驗(yàn)證藍(lán)牙地址的正確性。

BluetoothDevice類對(duì)于合法的硬件地址總會(huì)產(chǎn)生返回值，即使這個(gè)適配器從未見過該設(shè)備。

參數(shù)

address 合法的藍(lán)牙MAC地址

異常

IllegalArgumentException ???? 如果地址不合法

?

public int getScanMode ()

獲取本地藍(lán)牙適配器的當(dāng)前藍(lán)牙掃描模式

藍(lán)牙掃描模式?jīng)Q定本地適配器可連接并且/或者可被遠(yuǎn)程藍(lán)牙設(shè)備所連接。

可能值有: SCAN_MODE_NONE, SCAN_MODE_CONNECTABLE, SCAN_MODE_CONNECTABLE_DISCOVERABLE.

如果藍(lán)牙狀態(tài)不是STATE_ON，這個(gè)API將返回false。藍(lán)牙打開后，等待ACTION_STATE_CHANGED更新成STATE_ON。

需要BLUETOOTH權(quán)限。

???????? 返回值

掃描模式

?

public int getState ()

獲取本地藍(lán)牙適配器的當(dāng)前狀態(tài)

可能值有 STATE_OFF, STATE_TURNING_ON, STATE_ON, STATE_TURNING_OFF.
需要BLUETOOTH類

需要BLUETOOTH權(quán)限。

?????????????????? 返回值

current state of Bluetooth adapter

?

public boolean isDiscovering ()

如果當(dāng)前藍(lán)牙適配器正處于設(shè)備發(fā)現(xiàn)查找進(jìn)程中，則返回真值

設(shè)備查找是一個(gè)重量級(jí)過程。當(dāng)查找正在進(jìn)行的時(shí)候，用戶不能嘗試對(duì)新的遠(yuǎn)程藍(lán)牙設(shè)備進(jìn)行連接，同時(shí)存在的連接將獲得有限制的帶寬以及高等待時(shí)間。用戶可用cencelDiscovery()類來取消正在執(zhí)行的查找進(jìn)程。

應(yīng)用程序也可以為ACTION_DISCOVERY_STARTED或者ACTION_DISCOVERY_FINISHED進(jìn)行注冊(cè)，從而當(dāng)查找開始或者完成的時(shí)候，可以獲得通知。

如果藍(lán)牙狀態(tài)不是STATE_ON，這個(gè)API將返回false。藍(lán)牙打開后，等待ACTION_STATE_CHANGED更新成STATE_ON。

需要BLUETOOTH權(quán)限。

?????????????????? 返回值

如果正在查找，則返回true

?

public boolean isEnabled ()

如果藍(lán)牙正處于打開狀態(tài)并可用，則返回真值

與getBluetoothState()==STATE_ON 等價(jià)

需要BLUETOOTH權(quán)限。

?????????????????? 返回值

如果本地適配器已經(jīng)打開，則返回true

?

public BluetoothServerSocket listenUsingRfcommWithServiceRecord (String name, UUID uuid)

創(chuàng)建一個(gè)正在監(jiān)聽的安全的帶有服務(wù)記錄的無線射頻通信（RFCOMM）藍(lán)牙端口。

一個(gè)對(duì)該端口進(jìn)行連接的遠(yuǎn)程設(shè)備將被認(rèn)證，對(duì)該端口的通訊將被加密。

使用accpet（）方法可以獲取從監(jiān)聽BluetoothServerSocket處新來的連接

該系統(tǒng)分配一個(gè)未被使用的無線射頻通信通道來進(jìn)行監(jiān)聽。

該系統(tǒng)也將注冊(cè)一個(gè)服務(wù)探索協(xié)議（SDP）記錄，該記錄帶有一個(gè)包含了特定 的通用唯一識(shí)別碼（Universally Unique Identifier，UUID），服務(wù)器名稱和自動(dòng)分配通道的本地SDP服務(wù)。遠(yuǎn)程藍(lán)牙設(shè)備可以用相同的UUID來查詢自己的SDP服務(wù)器，并搜尋連接 到了哪個(gè)通道上。如果該端口已經(jīng)關(guān)閉，或者如果該應(yīng)用程序異常退出，則這個(gè)SDP記錄會(huì)被移除。

使用createRfcommSocketToServiceRecord(UUID)從另一使用相同UUID的設(shè)備來連接到這個(gè)端口

需要BLUETOOTH權(quán)限。

參數(shù)

name ????? SDP記錄下的服務(wù)器名

uuid ??????? SDP記錄下的UUID

?????????????????? 返回值

一個(gè)正在監(jiān)聽的無線射頻通信藍(lán)牙服務(wù)端口

異常

IOException ?? 產(chǎn)生錯(cuò)誤，比如藍(lán)牙設(shè)備不可用，或者許可無效，或者通道被占用。

?

public boolean setName (String name)

設(shè)置藍(lán)牙或者本地藍(lán)牙適配器的昵稱.

這個(gè)名字對(duì)于外界藍(lán)牙設(shè)備而言是可見的。

合法的藍(lán)牙名稱最多擁有248位UTF-8字符，但是很多外界設(shè)備只能顯示前40個(gè)字符，有些可能只限制前20個(gè)字符。

如果藍(lán)牙狀態(tài)不是STATE_ON，這個(gè)API將返回false。藍(lán)牙打開后，等待ACTION_STATE_CHANGED更新成STATE_ON。

需要BLUETOOTH_ADMIN權(quán)限。

參數(shù)

name ????? 一個(gè)合法的藍(lán)牙名稱

返回值

如果該名稱已被設(shè)定，則返回true，否則返回false

?

public boolean startDiscovery ()

開始對(duì)遠(yuǎn)程設(shè)備進(jìn)行查找的進(jìn)程

它通常牽涉到一個(gè)大概需時(shí)12秒的查詢掃描過程，緊跟著是一個(gè)對(duì)每個(gè)獲取到自身藍(lán)牙名稱的新設(shè)備的頁(yè)面掃描。

這是一個(gè)異步調(diào)用方法：該方法將馬上獲得返回值，注冊(cè)ACTION_DISCOVERY_STARTED and ACTION_DISCOVERY_FINISHED意圖準(zhǔn)確地確定該探索是處于開始階段或者完成階段。注冊(cè)ACTION_FOUND以活動(dòng)遠(yuǎn)程藍(lán)牙設(shè)備 已找到的通知。

設(shè)備查找是一個(gè)重量級(jí)過程。當(dāng)查找正在進(jìn)行的時(shí)候，用戶不能嘗試對(duì)新的遠(yuǎn)程藍(lán)牙設(shè)備進(jìn)行連接，同時(shí)存在的連接將獲得有限制的帶寬以 及高等待時(shí)間。用戶可用cencelDiscovery()類來取消正在執(zhí)行的查找進(jìn)程。發(fā)現(xiàn)的過程不會(huì)由活動(dòng)來進(jìn)行管理，但是它會(huì)作為一個(gè)系統(tǒng)服務(wù)來運(yùn) 行，因此即使它不能直接請(qǐng)求這樣的一個(gè)查詢動(dòng)作，也必需取消該搜索進(jìn)程。

設(shè)備搜尋只尋找已經(jīng)被連接的遠(yuǎn)程設(shè)備。許多藍(lán)牙設(shè)備默認(rèn)不會(huì)被搜尋到，并且需要進(jìn)入到一個(gè)特殊的模式當(dāng)中。

如果藍(lán)牙狀態(tài)不是STATE_ON，這個(gè)API將返回false。藍(lán)牙打開后，等待ACTION_STATE_CHANGED更新成STATE_ON。

需要BLUETOOTH_ADMIN權(quán)限。

返回值

成功返回true，錯(cuò)誤返回false。

?

補(bǔ)充

???????? 文章精選

?????????????????? Android藍(lán)牙開發(fā)淺談

?????????????????? Android藍(lán)牙API之BluetoothAdapter類(1)

?????????????????? Android藍(lán)牙API之BluetoothAdapter類(2)

?????????????????? Ophone平臺(tái)藍(lán)牙編程基礎(chǔ)