BluetoothGatt 類別

定義

命名空間:: Android.Bluetooth

組件:: Mono.Android.dll

重要

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

藍牙 GATT 設定檔的公開 API。

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

[<Android.Runtime.Register("android/bluetooth/BluetoothGatt", DoNotGenerateAcw=true)>]
type BluetoothGatt = class
    inherit Object
    interface IBluetoothProfile
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

繼承: Object

JavaObject

Object
BluetoothGatt

屬性: RegisterAttribute

實作: IBluetoothProfile IJavaObject IJavaPeerable IDisposable

備註

藍牙 GATT 設定檔的公開 API。

此類別提供藍牙 GATT 功能，以實現與藍牙智慧或智慧準備裝置的通訊。

若要連接遠端周邊裝置，建立 a BluetoothGattCallback 和 call BluetoothDevice#connectGatt 以取得此類別的實例。可透過藍牙裝置發現或 BLE 掃描流程發現支援 GATT 的裝置。

Java 文件 android.bluetooth.BluetoothGatt。

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

欄位

名稱	Description
ConnectionPriorityBalanced	已淘汰. 連線參數更新 - 使用藍牙 SIG 推薦的連線參數。
ConnectionPriorityDck	已淘汰. 連線參數更新 - 請求數位車鑰優先權以降低延遲連線。
ConnectionPriorityHigh	已淘汰. 連線參數更新 - 請求一個高優先權、低延遲的連線。
ConnectionPriorityLowPower	已淘汰. 連線參數更新 - 請求低功耗、降低資料速率的連線參數。
GattConnectionCongested	已淘汰. 遠端裝置連線擁塞。
GattConnectionTimeout	已淘汰. GATT 連線超時，可能是因為遠端裝置超出範圍或沒有顯示可連線。
GattFailure	已淘汰. GATT 操作失敗，錯誤除上述外
GattInsufficientAuthentication	已淘汰. 特定操作的認證不足
GattInsufficientAuthorization	已淘汰. 對特定操作授權不足
GattInsufficientEncryption	已淘汰. 對特定操作的加密不足
GattInvalidAttributeLength	已淘汰. 寫入操作超過屬性的最大長度
GattInvalidOffset	已淘汰. 曾請求讀取或寫入操作，但偏移量為無效
GattReadNotPermitted	已淘汰. 不允許進行 GATT 讀取操作
GattRequestNotSupported	已淘汰. 該請求未被支援
GattSuccess	已淘汰. GATT行動成功完成
GattWriteNotPermitted	已淘汰. 不允許 GATT 寫入操作
SubrateModeBalanced	已淘汰. 連接子速率模式 - 請求啟用平衡參數，以在節能與效能間取得折衷。
SubrateModeHigh	已淘汰. 連線子速率模式 - 請求啟用以優化高突發性、增強資料傳輸的參數子速率模式。
SubrateModeLow	已淘汰. 連接子速率模式 - 請求啟用以低突發性、最小功耗優化參數的子速率模式。
SubrateModeNotUpdated	已淘汰. 連線子速率模式 - 因錯誤未套用更新。
SubrateModeOff	已淘汰. 連線子速率模式 - 請求停用子速率模式。
SubrateModeSystemUpdate	已淘汰. 連線子速率模式 - 系統更新。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
ConnectedDevices	此會員已被棄用。
Device	回傳這個 GATT 用戶端所鎖定的遠端藍牙裝置
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	藍牙 GATT 設定檔的公開 API。 (繼承來源 JavaObject)
JniPeerMembers	藍牙 GATT 設定檔的公開 API。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Services	回傳遠端裝置所提供的 GATT 服務清單。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
AbortReliableWrite()	取消對特定裝置的可靠寫入交易。
AbortReliableWrite(BluetoothDevice)	已淘汰. 此會員已被棄用。
BeginReliableWrite()	為特定遠端裝置發起可靠的寫入交易。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Close()	關閉這個藍牙 GATT 用戶端。
Connect()	再連接回遠端裝置。
Construct(JniObjectReference, JniObjectReferenceOptions)	藍牙 GATT 設定檔的公開 API。 (繼承來源 JavaObject)
Disconnect()	斷開已建立的連線，或取消正在進行的連線嘗試。
DiscoverServices()	發現遠端裝置所提供的服務及其特性與描述。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	藍牙 GATT 設定檔的公開 API。 (繼承來源 JavaObject)
Equals(Object)	藍牙 GATT 設定檔的公開 API。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
ExecuteReliableWrite()	執行對特定遠端裝置的可靠寫入交易。
GetConnectionState(BluetoothDevice)	此會員已被棄用。
GetDevicesMatchingConnectionStates(ProfileState[])	此會員已被棄用。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetService(UUID)	如果遠端裝置支援所請求的 UUID，則回傳 `BluetoothGattService`。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
ReadCharacteristic(BluetoothGattCharacteristic)	從相關的遠端裝置讀取所請求的特性。
ReadDescriptor(BluetoothGattDescriptor)	從相關遠端裝置讀取指定描述符的值。
ReadPhy()	讀取連線的當前發射端 PHY 與接收端 PHI。
ReadRemoteRssi()	讀取連接的遠端裝置的 RSSI。
RequestConnectionPriority(GattConnectionPriority)	請求連線參數更新。
RequestMtu(Int32)	請求某個連線使用的 MTU 大小。
RequestSubrateMode(Int32)	請求執法分級模式。
SetCharacteristicNotification(BluetoothGattCharacteristic, Boolean)	啟用或停用特定特徵的通知/指示。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	藍牙 GATT 設定檔的公開 API。 (繼承來源 JavaObject)
SetPreferredPhy(BluetoothPhy, BluetoothPhy, BluetoothPhyOption)	為這個應用程式設定首選的連線 PHY。
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)
WriteCharacteristic(BluetoothGattCharacteristic, Byte[], Int32)	將特定特徵及其值寫入對應的遠端裝置。
WriteCharacteristic(BluetoothGattCharacteristic)	將特定特徵及其值寫入對應的遠端裝置。
WriteDescriptor(BluetoothGattDescriptor, Byte[])	將指定描述符的值寫入對應的遠端裝置。
WriteDescriptor(BluetoothGattDescriptor)	將指定描述符的值寫入對應的遠端裝置。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	藍牙 GATT 設定檔的公開 API。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	藍牙 GATT 設定檔的公開 API。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	藍牙 GATT 設定檔的公開 API。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	藍牙 GATT 設定檔的公開 API。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	藍牙 GATT 設定檔的公開 API。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	藍牙 GATT 設定檔的公開 API。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	藍牙 GATT 設定檔的公開 API。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	藍牙 GATT 設定檔的公開 API。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於