BluetoothDevice Klasse

Definition

Namespace:: Android.Bluetooth

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt ein Bluetooth-Remotegerät dar.

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

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

Vererbung: Object

JavaObject

Object
BluetoothDevice

Attribute: RegisterAttribute

Implementiert: IParcelable IJavaObject IJavaPeerable IDisposable

Hinweise

Stellt ein Bluetooth-Remotegerät dar. Mit A BluetoothDevice können Sie eine Verbindung mit dem jeweiligen Gerät herstellen oder Informationen dazu abfragen, z. B. Name, Adresse, Klasse und Bindungszustand.

Diese Klasse ist wirklich nur ein dünner Wrapper für eine Bluetooth-Hardwareadresse. Objekte dieser Klasse sind unveränderlich. Vorgänge für diese Klasse werden auf der Remote-Bluetooth-Hardwareadresse ausgeführt, die BluetoothAdapter zum Erstellen dieses BluetoothDeviceVorgangs verwendet wurde.

Verwenden Sie zum Abrufen eines BluetoothDevice, BluetoothAdapter#getRemoteDevice(String) BluetoothAdapter.getRemoteDevice(String) um ein Gerät einer bekannten MAC-Adresse (die Sie über die Geräteermittlung BluetoothAdaptermit ) darstellen, oder eine aus der Gruppe der gebundenen Geräte abzurufen, die von BluetoothAdapter#getBondedDevices() BluetoothAdapter.getBondedDevices(). Sie können dann eine BluetoothSocket für die Kommunikation mit dem Remotegerät öffnen, über #createRfcommSocketToServiceRecord(UUID) Bluetooth BR/EDR oder über Bluetooth LE verwenden #createL2capChannel(int) .

<h3>Entwicklerhandbücher</h3>

Weitere Informationen zur Verwendung von Bluetooth finden Sie im Bluetooth-Entwicklerhandbuch . </div>

Java Dokumentation für android.bluetooth.BluetoothDevice.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Felder

Name	Beschreibung
ActionAclConnected	Übertragungsaktion: Gibt an, dass eine ACL-Verbindung (Low Level) mit einem Remotegerät hergestellt wurde.
ActionAclDisconnected	Übertragungsaktion: Gibt eine ACL-Verbindung (Low Level) von einem Remotegerät an.
ActionAclDisconnectRequested	Übertragungsaktion: Gibt an, dass eine Verbindung mit niedriger Ebene (ACL) für ein Remotegerät angefordert wurde und bald getrennt wird.
ActionAliasChanged	Übertragungsaktion: Gibt an, dass der Alias eines Remotegeräts geändert wurde.
ActionBondStateChanged	Übertragungsaktion: Gibt eine Änderung des Bindungszustands eines Remotegeräts an.
ActionClassChanged	Übertragungsaktion: Die Bluetooth-Klasse eines Remotegeräts wurde geändert.
ActionEncryptionChange	Übertragungsaktion: Gibt an, dass der Verschlüsselungszustand geändert wurde.
ActionFound	Übertragungsaktion: Remotegerät erkannt.
ActionKeyMissing	Übertragungsaktion: Gibt an, dass zuvor gebundenes Gerät keine Schlüssel zum Herstellen der Verschlüsselung bereitstellen konnte.
ActionLeAppearanceChanged	Stellt ein Bluetooth-Remotegerät dar.
ActionNameChanged	Übertragungsaktion: Gibt den Anzeigenamen eines Remotegeräts an, das zum ersten Mal abgerufen oder seit dem letzten Abruf geändert wurde.
ActionPairingRequest	Übertragungsaktion: Diese Absicht wird verwendet, um eine KOPPLUNGSANFORDERUNG zu übertragen.
ActionUuid	Übertragungsaktion: Diese Absicht wird verwendet, um den `UUID` Umbruch als remotegerät `android.os.ParcelUuid` zu übertragen, nachdem es abgerufen wurde.
AddressTypeAnonymous	Veraltet. Adresstyp, der verwendet wird, um eine anonyme Ankündigung anzugeben.
AddressTypePublic	Veraltet. Hardware-MAC-Adresse des Geräts
AddressTypeRandom	Veraltet. Die Adresse ist entweder auflösend, nicht auflösend oder statisch.
AddressTypeUnknown	Veraltet. Der Adresstyp ist unbekannt oder nicht verfügbar.
BondLossReasonBredrAuthFailure	Veraltet. Gibt den Grund für den Verlust der Anleihe an, dass DIE BREDR-Authentifizierung fehlschlagen soll.
BondLossReasonBredrIncomingPairing	Veraltet. Gibt den Grund für den Verlust der Anleihe an, Kopplungsfehler ist BREDR.
BondLossReasonLeEncryptFailure	Veraltet. Gibt an, warum der Bondverlust LE-Verschlüsselungsfehler ist.
BondLossReasonLeIncomingPairing	Veraltet. Gibt an, warum der Bindungsverlust LE-Kopplungsfehler ist.
BondLossReasonUnknown	Veraltet. Gibt an, warum der Verlust der Anleihe unbekannt ist.
DeviceTypeClassic	Veraltet. Bluetooth-Gerätetyp, Klassisch – BR/EDR-Geräte
DeviceTypeDual	Veraltet. Bluetooth-Gerätetyp, Dual-Modus - BR/EDR/LE
DeviceTypeLe	Veraltet. Bluetooth-Gerätetyp, Low Energy - LE-only
DeviceTypeUnknown	Veraltet. Bluetooth-Gerätetyp, Unbekannt
EncryptionAlgorithmAes	Veraltet. Gibt an, dass der Link mit dem AES-Algorithmus verschlüsselt wurde.
EncryptionAlgorithmE0	Veraltet. Gibt an, dass der Link mit dem E0-Algorithmus verschlüsselt wurde.
EncryptionAlgorithmNone	Veraltet. Gibt an, dass die Verknüpfung nicht mit einem Algorithmus verschlüsselt wurde
EncryptionAlgorithmUnknown	Veraltet. Gibt an, dass der Link mit einem unbekannten Algorithmus verschlüsselt wurde.
Error	Sentinel-Fehlerwert für diese Klasse.
ExtraBondLossReason	Enthält den Grund für den Verlust der Anleihe.
ExtraBondState	Wird als zusätzliches Feld in `#ACTION_BOND_STATE_CHANGED` Absichten verwendet.
ExtraClass	Wird als paketfähiges `BluetoothClass` zusätzliches Feld in `#ACTION_FOUND` und `#ACTION_CLASS_CHANGED` mit Absichten verwendet.
ExtraDevice	Wird in jeder Absicht, die von dieser Klasse gesendet wird, als paketfähiges `BluetoothDevice` zusätzliches Feld verwendet.
ExtraDiscoveryResultType	Wird als ganzzahliges Feld in `#ACTION_FOUND` Absichten verwendet.
ExtraEncryptionAlgorithm	Wird als zusätzliches Feld in `#ACTION_ENCRYPTION_CHANGE` Absichten als der algorithmus verwendet, der für die Verschlüsselung verwendet wird.
ExtraEncryptionEnabled	Wird als boolesches zusätzliches Feld in `#ACTION_ENCRYPTION_CHANGE` Absicht verwendet.
ExtraEncryptionStatus	Wird als zusätzliches Int-Feld in `#ACTION_ENCRYPTION_CHANGE` Absicht verwendet.
ExtraIsCoordinatedSetMember	Wird als boolesches zusätzliches Feld in `#ACTION_FOUND` Intents verwendet.
ExtraKeySize	Wird als zusätzliches Feld in `#ACTION_ENCRYPTION_CHANGE` Absichten als Größe des Verschlüsselungsschlüssels in Byte verwendet.
ExtraLeAppearance	Stellt ein Bluetooth-Remotegerät dar.
ExtraName	Wird als zusätzliches Zeichenfolgenfeld in `#ACTION_NAME_CHANGED` und `#ACTION_FOUND` in Absichten verwendet.
ExtraPairingAlgorithm	Wird als zusätzliches Feld in `#ACTION_PAIRING_REQUEST` Absichten verwendet, das den verwendeten Kopplungsalgorithmus angibt.
ExtraPairingContext	Wird als zusätzliches Feld in `#ACTION_PAIRING_REQUEST` und `#ACTION_BOND_STATE_CHANGED` Absichten verwendet, das den Kopplungskontext angibt.
ExtraPairingKey	Wird als zusätzliches Int-Feld in `#ACTION_PAIRING_REQUEST` Absichten als Wert des Kennungsfelds verwendet.
ExtraPairingVariant	Wird als zusätzliches Feld in `#ACTION_PAIRING_REQUEST` Absichten verwendet, um die verwendete Kopplungsmethode anzugeben.
ExtraPreviousBondState	Wird als zusätzliches Feld in `#ACTION_BOND_STATE_CHANGED` Absichten verwendet.
ExtraRssi	Wird als optionales zusätzliches Feld in `#ACTION_FOUND` Absichten verwendet.
ExtraTransport	Wird als zusätzliches Int-Feld in `#ACTION_ACL_CONNECTED`und `#ACTION_ACL_DISCONNECTED` Absichten verwendet, `#ACTION_ENCRYPTION_CHANGE` um anzugeben, welcher Transport verbunden ist.
ExtraUuid	Enthält die `android.os.ParcelUuid`s des Remotegeräts, das eine paketierbare Version von `UUID`.
ExtraUuidLe	Enthält die `android.os.ParcelUuid`s des Remotegeräts, das eine paketierbare Version von `UUID`.
LeAppearanceUnknown	Wert, der angibt, dass die LE-Darstellung des Geräts unbekannt ist.
PairingAlgorithmBredrLegacy	Veraltet. Gibt die Verwendung des BR/EDR Legacy-Kopplungsalgorithmus an.
PairingAlgorithmBredrSsp	Veraltet. Gibt die Verwendung des BR/EDR Secure Simple Pairing (SSP)-Algorithmus an.
PairingAlgorithmLeLegacy	Veraltet. Gibt die Verwendung des LE Legacy-Kopplungsalgorithmus an.
PairingAlgorithmSc	Veraltet. Gibt die Verwendung des Kopplungsalgorithmus für sichere Verbindungen an, die sowohl für BR/EDR- als auch FÜR LE-Transporte anwendbar sind.
PairingContextRepairing	Signalisiert einen autonomen, vom System initiierten erneuten Kopplungsprozess.
PairingContextUserApprovalRequested	Gibt an, dass der Kopplungsprozess initiiert wird und die Benutzergenehmigung angefordert wird, um den Kopplungsprozess abzuschließen.
PairingContextUserParticipationRequested	Signalisiert eine Anforderung für die Benutzerbeteiligung, den LE Legacy-Kopplungsprozess zu starten.
PairingVariantPasskeyConfirmation	Der Benutzer wird aufgefordert, den auf dem Bildschirm angezeigten Kennung zu bestätigen, oder eine App bestätigt den Kennungsschlüssel für den Benutzer.
PairingVariantPin	Der Benutzer wird aufgefordert, eine Pin einzugeben, oder eine App gibt eine Pin für den Benutzer ein.
PhyLeHdt	Veraltet. Bluetooth LE HDT PHY.
PhyLeHdtMask	Veraltet. Bluetooth LE HDT PHY Mask.

Eigenschaften

Name	Beschreibung
Address	Gibt die Hardwareadresse dieses BluetoothDevice zurück.
AddressType	Gibt den Adresstyp dieses BluetoothDevice, eines von `#ADDRESS_TYPE_PUBLIC`, `#ADDRESS_TYPE_RANDOM`, , `#ADDRESS_TYPE_ANONYMOUS`oder `#ADDRESS_TYPE_UNKNOWN`.
Alias	Rufen Sie den lokal geänderten Namen (Alias) des Bluetooth-Remotegeräts ab.
BluetoothClass	Rufen Sie die Bluetooth-Klasse des Remotegeräts ab.
BondState	Diese API gibt den Bondstatus des Remotegeräts zurück.
Class	Gibt die Laufzeitklasse dieses Werts `Object`zurück. (Geerbt von Object)
Creator
Handle	Das Handle für die zugrunde liegende Android-Instanz. (Geerbt von Object)
IdentityAddressWithType	Gibt den Identitätsadressen- und Identitätsadressentyp dieses BluetoothDevice zurück.
JniIdentityHashCode	Ruft den Identitätshashcode ab, der diesem Java Peer von der Interop-Laufzeit zugewiesen ist. (Geerbt von Object)
JniManagedPeerState	Stellt ein Bluetooth-Remotegerät dar. (Geerbt von JavaObject)
JniPeerMembers	Stellt ein Bluetooth-Remotegerät dar.
KeyMissingCount	Abrufen der Häufigkeit, `ACTION_KEY_MISSING` mit der die Absicht für dieses Gerät ausgelöst wurde, seit der letzten erfolgreichen verschlüsselten Verbindung
LeAppearance	Rufen Sie die Bluetooth LE-Darstellung des Remotegeräts ab.
Name	Rufen Sie den anzeigefähigen Bluetooth-Namen des Remotegeräts ab.
PeerReference	Ruft den JNI-Objektverweis für diesen Java Peer ab. (Geerbt von Object)
ThresholdClass	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object)
ThresholdType	Diese API unterstützt die Mono für Android-Infrastruktur und ist nicht für die direkte Verwendung aus Ihrem Code vorgesehen. (Geerbt von Object)
Type	Rufen Sie den Bluetooth-Gerätetyp des Remotegeräts ab.

Methoden

Name	Beschreibung
CancelBondProcess()	Abbrechen einer laufenden Bindungsanforderung, die mit `#createBond`.
Clone()	Erstellt und gibt eine Kopie dieses Objekts zurück. (Geerbt von Object)
Connect()	Verbindet alle aktivierten und unterstützten Bluetooth-Profile zwischen dem lokalen und Remotegerät.
ConnectGatt(BluetoothGattConnectionSettings, IExecutor, BluetoothGattCallback)	Stellen Sie eine Verbindung mit dem GATT-Server her, der vom angegebenen Gerät gehostet wird.
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, BluetoothPhy, Handler)	Stellen Sie eine Verbindung mit dem GATT-Server her, der von diesem Gerät gehostet wird.
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, BluetoothPhy)	Stellen Sie eine Verbindung mit dem GATT-Server her, der von diesem Gerät gehostet wird.
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy, Handler)	Veraltet. Stellt ein Bluetooth-Remotegerät dar.
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy)	Veraltet. Stellt ein Bluetooth-Remotegerät dar.
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports)	Stellen Sie eine Verbindung mit dem GATT-Server her, der von diesem Gerät gehostet wird.
ConnectGatt(Context, Boolean, BluetoothGattCallback)	Stellen Sie eine Verbindung mit dem GATT-Server her, der von diesem Gerät gehostet wird.
Construct(JniObjectReference, JniObjectReferenceOptions)	Stellt ein Bluetooth-Remotegerät dar. (Geerbt von JavaObject)
CreateBond()	Starten Sie den Bondingprozess (Kopplung) mit dem Remotegerät.
CreateBond(Int32)	Starten Sie den Bonding-Prozess (Kopplung) mit dem Remotegerät mithilfe des angegebenen Transports.
CreateInsecureL2capChannel(Int32)	Erstellen Sie einen Bluetooth L2CAP Connection-oriented Channel (CoC), `BluetoothSocket` der verwendet werden kann, um eine sichere ausgehende Verbindung mit dem Remotegerät mit demselben dynamischen Protokoll-/Dienst-Multiplexerwert (PSM) zu starten.
CreateInsecureRfcommSocketToServiceRecord(UUID)	Erstellen Sie einen RFCOMM-Socket `BluetoothSocket` , der bereit ist, um eine unsichere ausgehende Verbindung mit diesem Remotegerät mithilfe der SDP-Suche von uuid zu starten.
CreateL2capChannel(Int32)	Erstellen Sie einen Bluetooth L2CAP Connection-oriented Channel (CoC), `BluetoothSocket` der verwendet werden kann, um eine sichere ausgehende Verbindung mit dem Remotegerät mit demselben dynamischen Protokoll-/Dienst-Multiplexerwert (PSM) zu starten.
CreateRfcommSocketToServiceRecord(UUID)	Erstellen Sie mithilfe der SDP-Suche von uuid eine `BluetoothSocket` sichere ausgehende Verbindung mit diesem Remotegerät.
CreateUsingSocketSettings(BluetoothSocketSettings)	Erstellt einen Clientsocket, um eine Verbindung mit einem Remote-Bluetooth-Server mit den angegebenen Socketeinstellungen `BluetoothSocketSettings` herzustellen. Diese API wird verwendet, um eine Verbindung mit einem remote gehosteten Server herzustellen `BluetoothAdapter#listenUsingSocketSettings`.
DescribeContents()	Beschreiben Sie die Arten von speziellen Objekten, die in der Marshalldarstellung dieser Paketable enthalten sind.
Disconnect()	Trennt alle verbundenen Bluetooth-Profile zwischen dem lokalen und dem Remotegerät.
DisconnectAcl(BluetoothTransports)	Trennt ACL-Verknüpfungen für dieses Gerät.
Dispose()	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
Dispose(Boolean)	Veröffentlicht die Ressourcen, die von diesem Java Peer gehalten werden. (Geerbt von Object)
DisposeUnlessReferenced()	Stellt ein Bluetooth-Remotegerät dar. (Geerbt von JavaObject)
Equals(Object)	Stellt ein Bluetooth-Remotegerät dar. (Geerbt von JavaObject)
Equals(Object)	Gibt an, ob ein anderes Objekt "gleich" diesem Objekt ist. (Geerbt von Object)
FetchUuids(Int32)	Führt eine Dienstermittlung auf dem Remotegerät aus, um die unterstützten UUIDs abzurufen, sodass der Aufrufer den Transport angeben kann.
FetchUuidsWithSdp()	Führt eine Dienstermittlung auf dem Remotegerät aus, um die unterstützten UUIDs abzurufen.
GetBondStatus(Int32)	Gibt den Bindungsstatus dieses Geräts zurück.
GetEncryptionStatus(Int32)	Rufen Sie den Verschlüsselungsstatus des verbundenen Geräts ab.
GetHashCode()	Gibt einen Hashcodewert für das Objekt zurück. (Geerbt von Object)
GetUuids()	Gibt die unterstützten Features (UUIDs) des Remotegeräts zurück.
IsConnected(Int32)	Gibt zurück, ob im angegebenen Transport eine offene Verbindung mit diesem Gerät vorhanden ist.
JavaFinalize()	Veraltet. Wird vom Garbage Collector für ein Objekt aufgerufen, wenn die Garbage Collection bestimmt, dass keine weiteren Verweise auf das Objekt vorhanden sind. (Geerbt von Object)
Notify()	Aktiviert einen einzelnen Thread, der auf dem Monitor dieses Objekts wartet. (Geerbt von Object)
NotifyAll()	Aktiviert alle Threads, die auf dem Monitor dieses Objekts warten. (Geerbt von Object)
SetAlias(String)	Legt den lokal modifizierbaren Namen (Alias) des Remote-Bluetooth-Geräts fest.
SetHandle(IntPtr, JniHandleOwnership)	Legt die Handle-Eigenschaft fest. (Geerbt von Object)
SetPairingConfirmation(Boolean)	Bestätigen Sie den Kennungsschlüssel für die `#PAIRING_VARIANT_PASSKEY_CONFIRMATION` Kopplung.
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	Stellt ein Bluetooth-Remotegerät dar. (Geerbt von JavaObject)
SetPin(Byte[])	Festlegen des Pins während der Kopplung, wenn die Kopplungsmethode `#PAIRING_VARIANT_PIN`
ToArray<T>()	Erstellt ein verwaltetes Array aus diesem Java Arraywrapper. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolgendarstellung des Objekts zurück. (Geerbt von Object)
UnregisterFromRuntime()	Hebt die Registrierung dieses Java Peers aus der Interop-Laufzeit auf. (Geerbt von Object)
Wait()	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch em benachrichtigt/em< oder >em<unterbrochen>/em<.><> (Geerbt von Object)
Wait(Int64, Int32)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
Wait(Int64)	Bewirkt, dass der aktuelle Thread wartet, bis er wach ist, in der Regel durch <em>benachrichtigt</em> oder <em>unterbrochen</em> oder bis eine bestimmte Menge an Echtzeit verstrichen ist. (Geerbt von Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	Flachen Sie dieses Objekt in ein Paket.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IJavaPeerable.Disposed()	Stellt ein Bluetooth-Remotegerät dar. (Geerbt von JavaObject)
IJavaPeerable.Finalized()	Stellt ein Bluetooth-Remotegerät dar. (Geerbt von JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	Stellt ein Bluetooth-Remotegerät dar. (Geerbt von JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	Stellt ein Bluetooth-Remotegerät dar. (Geerbt von JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	Stellt ein Bluetooth-Remotegerät dar. (Geerbt von JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	Stellt ein Bluetooth-Remotegerät dar. (Geerbt von JavaObject)
IJavaPeerable.UnregisterFromRuntime()	Stellt ein Bluetooth-Remotegerät dar.

Erweiterungsmethoden

Name	Beschreibung
GetJniTypeName(IJavaPeerable)	Ruft den JNI-Namen des Typs der Instanz `self`ab.
JavaAs<TResult>(IJavaPeerable)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.
JavaCast<TResult>(IJavaObject)	Führt eine android-laufzeitgecheckte Typkonvertierung aus.
JavaCast<TResult>(IJavaObject)	Stellt ein Bluetooth-Remotegerät dar.
TryJavaCast<TResult>(IJavaPeerable, TResult)	Versuchen Sie, die Eingabe `self`zu `TResult` erzwingen, und überprüfen Sie, ob die Koersion auf der Java Seite gültig ist.

Gilt für: