BluetoothAdapter 類別

定義

命名空間:: Android.Bluetooth

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

代表本地裝置的藍牙轉接器。

[Android.Runtime.Register("android/bluetooth/BluetoothAdapter", DoNotGenerateAcw=true)]
public sealed class BluetoothAdapter : Java.Lang.Object

[<Android.Runtime.Register("android/bluetooth/BluetoothAdapter", DoNotGenerateAcw=true)>]
type BluetoothAdapter = class
    inherit Object

繼承: Object

JavaObject

Object
BluetoothAdapter

屬性: RegisterAttribute

備註

代表本地裝置的藍牙轉接器。它 BluetoothAdapter 讓你能執行基本的藍牙任務，例如啟動裝置偵測、查詢綁定（配對）裝置清單、使用已知 MAC 位址實例化 a BluetoothDevice ，以及建立 a BluetoothServerSocket 來監聽其他裝置的連線請求，並開始掃描藍牙 LE 裝置。

要取得代表本地藍牙轉接器的，BluetoothAdapter請呼叫 BluetoothManager#getAdapter 。BluetoothManager JELLY_BEAN_MR1及以下則需要使用靜態 #getDefaultAdapter 方法。

基本上，這是你所有藍牙操作的起點。一旦你有了本地介面卡，你可以取得一組 BluetoothDevice 物件，代表所有配對裝置; #getBondedDevices()開始裝置發現; #startDiscovery()或建立 BluetoothServerSocket 一個來監聽RFComm連線請求 #listenUsingRfcommWithServiceRecord(String, UUID);監聽L2CAP連線導向通道（CoC）連線請求 #listenUsingL2capChannel();或使用 BluetoothLeScanner#startScan(ScanCallback) 掃描器 #getBluetoothLeScanner()開始掃描藍牙LE裝置。

這門課是安全的執行緒。 <div 類別=「特殊參考」>

<h3>開發者指南</h3>

想了解更多藍牙使用資訊，請閱讀藍牙開發者指南。 </div>

Java 文件 android.bluetooth.BluetoothAdapter。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

欄位

名稱	Description
ActionConnectionStateChanged	意圖用於廣播本地藍牙轉接器連線狀態的變化，並廣播給遠端裝置的設定檔。
ActionDiscoveryFinished	廣播動作：本地藍牙轉接器已完成裝置偵測過程。
ActionDiscoveryStarted	廣播動作：本地藍牙轉接器已啟動遠端裝置偵測程序。
ActionLocalNameChanged	廣播動作：本地藍牙轉接器更改了其友善的藍牙名稱。
ActionRequestDiscoverable	活動動作：顯示系統活動請求可發現模式。
ActionRequestEnable	活動動作：顯示系統活動，允許使用者開啟藍牙。
ActionScanModeChanged	廣播動作：表示本地轉接器的藍牙掃描模式已改變。
ActionStateChanged	廣播動作：本地藍牙轉接器的狀態已改變。
Error	此類別的哨兵錯誤值。
ExtraConnectionState	額外使用單位 `#ACTION_CONNECTION_STATE_CHANGED` `This extra represents the current connection state.`
ExtraDiscoverableDuration	作為 intants 中可選的 int 額外欄位 `#ACTION_REQUEST_DISCOVERABLE` ，請求特定持續時間以秒數可偵測。
ExtraLocalName	在意圖中用作字串額外欄位 `#ACTION_LOCAL_NAME_CHANGED` 來請求本地藍牙名稱。
ExtraPreviousConnectionState	額外使用單位 `#ACTION_CONNECTION_STATE_CHANGED` `This extra represents the previous connection state.`
ExtraPreviousScanMode	在 Intents 中用作請求前一個掃描模式的 int 額外欄位 `#ACTION_SCAN_MODE_CHANGED` 。
ExtraPreviousState	在 Intents 中用作請求先前功率狀態的 int 額外欄位 `#ACTION_STATE_CHANGED` 。
ExtraScanMode	在 Intents 中用作請求當前掃描模式的 int 額外欄位 `#ACTION_SCAN_MODE_CHANGED` 。
ExtraState	在 intent 中用作請求當前 power 狀態的 int 額外欄位 `#ACTION_STATE_CHANGED` 。

屬性

名稱	Description
Address	回傳本地藍牙轉接器的硬體位址。
BluetoothLeAdvertiser	回傳 `BluetoothLeAdvertiser` 一個用於藍牙LE廣告操作的物件。
BluetoothLeScanner	回傳 `BluetoothLeScanner` 一個物件用於藍牙 LE 掃描操作。
BondedDevices	將已綁定（配對）的物件集合回 `BluetoothDevice` 回本地介面卡。
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
DefaultAdapter	先取得預設本地藍牙轉接器的控制權。
DiscoverableTimeout	取得SCAN_MODE_CONNECTABLE_DISCOVERABLE的暫停時間。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsDiscovering	如果本地藍牙轉接器目前正在裝置偵測過程中，則回傳 true。
IsEnabled	如果藍牙目前已啟用且準備使用，則回傳 true。
IsLe2MPhySupported	若支援 LE 2M PHY 功能，則回傳 true。
IsLeCodedPhySupported	若支援 LE 編碼 PHY 功能，則回傳 true。
IsLeExtendedAdvertisingSupported	若支援 LE 擴展廣告功能，請回傳 true。
IsLePeriodicAdvertisingSupported	若支援執法定期廣告功能，請回傳真值。
IsMultipleAdvertisementSupported	若晶片組支援多重通告，則回傳 true
IsOffloadedFilteringSupported	若支援卸載濾波器，則回傳 true。
IsOffloadedScanBatchingSupported	若支援卸載掃描批次，則回傳真值
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	代表本地裝置的藍牙轉接器。 (繼承來源 JavaObject)
JniPeerMembers	代表本地裝置的藍牙轉接器。
LeMaximumAdvertisingDataLength	若支援 LE 擴展廣告功能，則回傳最大 LE 廣告資料長度（位元組），否則為 0。
MaxConnectedAudioDevices	取得該裝置每個音訊設定檔中連接裝置的最大數量。
Name	取得本地藍牙轉接器的友善藍牙名稱。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ScanMode	取得本地藍牙轉接器的目前藍牙掃描模式。
State	取得本地藍牙轉接器的現況。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
CancelDiscovery()	取消目前的裝置發現流程。
CheckBluetoothAddress(String)	驗證一個字串藍牙位址，例如 “00：43：A8：23：10：F0”
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
CloseProfileProxy(ProfileType, IBluetoothProfile)	關閉設定檔代理與服務的連線。
Construct(JniObjectReference, JniObjectReferenceOptions)	代表本地裝置的藍牙轉接器。 (繼承來源 JavaObject)
Disable()	關閉本地藍牙轉接器並 mdash;未經明確使用者操作，請勿使用藍牙。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	代表本地裝置的藍牙轉接器。 (繼承來源 JavaObject)
Enable()	開啟本地藍牙轉接器並 mdash;未經明確使用者操作開啟藍牙，請勿使用。
Equals(Object)	代表本地裝置的藍牙轉接器。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetProfileConnectionState(ProfileType)	取得設定檔目前的連線狀態。
GetProfileProxy(Context, IBluetoothProfileServiceListener, ProfileType)	取得與該設定檔關聯的設定檔代理物件。
GetRemoteDevice(Byte[])	取得 `BluetoothDevice` 該藍牙硬體位址的物件。
GetRemoteDevice(String)	取得 `BluetoothDevice` 該藍牙硬體位址的物件。
GetRemoteLeDevice(String, Int32)	取得一個 BluetoothDevice 物件，針對指定的藍牙硬體位址和地址類型。
IsLeAudioBroadcastAssistantSupported()	若支援 LE 音訊廣播助理功能，或`BluetoothStatusCodes#FEATURE_SUPPORTED`不支援此功能，或錯誤代碼，則回傳`BluetoothStatusCodes#FEATURE_NOT_SUPPORTED`。
IsLeAudioBroadcastSourceSupported()	若支援 LE 音訊廣播來源功能、`BluetoothStatusCodes#FEATURE_SUPPORTED`不支援此功能或錯誤代碼，則回傳`BluetoothStatusCodes#FEATURE_NOT_SUPPORTED`。
IsLeAudioSupported()	若支援 LE 音訊功能、`BluetoothStatusCodes#FEATURE_SUPPORTED`不支援此功能或錯誤代碼，則回傳`BluetoothStatusCodes#FEATURE_NOT_SUPPORTED`。
IsLeHighDataThroughputPhySupported()	檢查是否支援LE高資料吞吐量（HDT）PHY。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
ListenUsingInsecureL2capChannel()	建立一個不安全的 L2CAP 連線導向通道（CoC）， `BluetoothServerSocket` 並指派一個動態 PSM 值。
ListenUsingInsecureRfcommWithServiceRecord(String, UUID)	建立一個可竊聽且不安全的 RFCOMM 藍牙插座，並使用服務記錄。
ListenUsingL2capChannel()	建立一個安全的 L2CAP 連線導向通道（CoC）， `BluetoothServerSocket` 並指派動態協定/服務多工器（PSM）值。
ListenUsingRfcommWithServiceRecord(String, UUID)	建立一個可監聽且安全的 RFCOMM 藍牙插座，並搭配服務記錄。
ListenUsingSocketSettings(BluetoothSocketSettings)	建立一個用於藍牙連線的監聽伺服器通道，並依指定 BluetoothSocketSettings（藍牙socketSettings）設定。
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetName(String)	設定本地藍牙轉接器的友善藍牙名稱。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	代表本地裝置的藍牙轉接器。 (繼承來源 JavaObject)
StartDiscovery()	開始遠端裝置發現程序。
StartLeScan(BluetoothAdapter+ILeScanCallback)	已淘汰. 開始掃描藍牙 LE 裝置。
StartLeScan(UUID[], BluetoothAdapter+ILeScanCallback)	已淘汰. 開始掃描藍牙 LE 裝置。
StopLeScan(BluetoothAdapter+ILeScanCallback)	已淘汰. 停止正在進行的藍牙 LE 裝置掃描。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	代表本地裝置的藍牙轉接器。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	代表本地裝置的藍牙轉接器。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	代表本地裝置的藍牙轉接器。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	代表本地裝置的藍牙轉接器。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	代表本地裝置的藍牙轉接器。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	代表本地裝置的藍牙轉接器。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	代表本地裝置的藍牙轉接器。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於