BluetoothAdapter.StartDiscovery Methode

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.

Starten Sie den Remotegeräteermittlungsprozess.

[Android.Runtime.Register("startDiscovery", "()Z", "")]
[Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_SCAN")]
public bool StartDiscovery();

[<Android.Runtime.Register("startDiscovery", "()Z", "")>]
[<Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_SCAN")>]
member this.StartDiscovery : unit -> bool

Gibt zurück

Boolean

true bei Erfolg, false bei Fehler

Attribute: RegisterAttribute RequiresPermissionAttribute

Hinweise

Starten Sie den Remotegeräteermittlungsprozess.

Der Ermittlungsprozess umfasst in der Regel einen Untersuchungsscan von ca. 12 Sekunden, gefolgt von einem Seitenscan jedes neuen Geräts, um seinen Bluetooth-Namen abzurufen.

Dies ist ein asynchroner Aufruf, der sofort zurückgegeben wird. Registrieren Sie sich für #ACTION_DISCOVERY_STARTED und #ACTION_DISCOVERY_FINISHED Absichten, um genau zu bestimmen, wann die Ermittlung beginnt und abgeschlossen ist. Registrieren Sie sich, BluetoothDevice#ACTION_FOUND um als Remote-Bluetooth-Geräte benachrichtigt zu werden.

Die Geräteermittlung ist ein schwergewichtiges Verfahren. Neue Verbindungen mit Remote-Bluetooth-Geräten sollten nicht versucht werden, während die Ermittlung ausgeführt wird, und vorhandene Verbindungen haben begrenzte Bandbreite und hohe Latenz. Wird verwendet #cancelDiscovery() , um eine fortlaufende Ermittlung abzubrechen. Die Ermittlung wird nicht von der Aktivität verwaltet, sondern als Systemdienst ausgeführt. Daher sollte eine Anwendung immer aufgerufen BluetoothAdapter#cancelDiscovery() werden, auch wenn sie nicht direkt eine Ermittlung angefordert hat, nur um sicher zu sein.

Die Geräteermittlung findet nur Remotegeräte, die derzeit auffindbar sind (Untersuchungsscan aktiviert). Viele Bluetooth-Geräte sind standardmäßig nicht auffindbar und müssen in einen speziellen Modus eingegeben werden.

Wenn der Bluetooth-Zustand nicht #STATE_ONist, gibt diese API "false" zurück. Warten Sie #ACTION_STATE_CHANGED#STATE_ON nach dem Aktivieren von Bluetooth auf den aktualisierten Wert.

Wenn ein Gerät derzeit verbunden ist, wird diese Anforderung in die Warteschlange gestellt und ausgeführt, sobald das Gerät die Bindung abgeschlossen hat. Wenn eine Anforderung bereits in die Warteschlange gestellt wird, wird diese Anforderung ignoriert.

Java Dokumentation für android.bluetooth.BluetoothAdapter.startDiscovery().

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.

Gilt für: