BluetoothLeScanner.StartScan Methode

[Android.Runtime.Register("startScan", "(Landroid/bluetooth/le/ScanCallback;)V", "")]
[Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_SCAN")]
public void StartScan(Android.Bluetooth.LE.ScanCallback? callback);

[<Android.Runtime.Register("startScan", "(Landroid/bluetooth/le/ScanCallback;)V", "")>]
[<Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_SCAN")>]
member this.StartScan : Android.Bluetooth.LE.ScanCallback -> unit

Parameter

Attribute

RegisterAttribute RequiresPermissionAttribute

Ausnahmen

Hinweise

Starten Sie den Bluetooth LE-Scan mit Standardparametern und keine Filter. Die Scanergebnisse werden durchgestellt callback. Bei ungefilterten Scans wird die Überprüfung auf dem Bildschirm beendet, um Energie zu sparen. Das Scannen wird fortgesetzt, wenn der Bildschirm erneut aktiviert ist. Um dies zu vermeiden, verwenden Sie dies #startScan(List, ScanSettings, ScanCallback) mit den gewünschten ScanFilter.

Eine App muss android.Manifest.permission#ACCESS_COARSE_LOCATION ACCESS_COARSE_LOCATION über die Berechtigung zum Abrufen von Ergebnissen verfügen. Eine App für Android Q oder höher muss android.Manifest.permission#ACCESS_FINE_LOCATION ACCESS_FINE_LOCATION über die Berechtigung zum Abrufen von Ergebnissen verfügen.

Java Dokumentation für android.bluetooth.le.BluetoothLeScanner.startScan(android.bluetooth.le.ScanCallback).

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.

[Android.Runtime.Register("startScan", "(Ljava/util/List;Landroid/bluetooth/le/ScanSettings;Landroid/app/PendingIntent;)I", "", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_SCAN")]
public int StartScan(System.Collections.Generic.IList<Android.Bluetooth.LE.ScanFilter>? filters, Android.Bluetooth.LE.ScanSettings? settings, Android.App.PendingIntent callbackIntent);

[<Android.Runtime.Register("startScan", "(Ljava/util/List;Landroid/bluetooth/le/ScanSettings;Landroid/app/PendingIntent;)I", "", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_SCAN")>]
member this.StartScan : System.Collections.Generic.IList<Android.Bluetooth.LE.ScanFilter> * Android.Bluetooth.LE.ScanSettings * Android.App.PendingIntent -> int

Parameter

Gibt zurück

Gibt 0 für Erfolg oder einen Fehlercode zurück, wenn ScanCallback die Scananforderung nicht gesendet werden konnte.

Attribute

RegisterAttribute RequiresPermissionAttribute

Hinweise

Starten Sie den Bluetooth LE-Scan mit einer PendingIntent. Die Scanergebnisse werden über den PendingIntent übermittelt. Verwenden Sie diese Methode des Scannens, wenn Ihr Prozess nicht immer ausgeführt wird, und es sollte gestartet werden, wenn Scanergebnisse verfügbar sind.

Eine App muss android.Manifest.permission#ACCESS_COARSE_LOCATION ACCESS_COARSE_LOCATION über die Berechtigung zum Abrufen von Ergebnissen verfügen. Eine App für Android Q oder höher muss android.Manifest.permission#ACCESS_FINE_LOCATION ACCESS_FINE_LOCATION über die Berechtigung zum Abrufen von Ergebnissen verfügen.

Wenn der PendingIntent übermittelt wird, enthält der an den Empfänger oder die Aktivität übergebene Intent eines oder mehrere der Extras #EXTRA_CALLBACK_TYPE#EXTRA_ERROR_CODE und #EXTRA_LIST_SCAN_RESULT gibt das Ergebnis des Scans an.

Java Dokumentation für android.bluetooth.le.BluetoothLeScanner.startScan(java.util.List<android.bluetooth.le.ScanFilter>, android.bluetooth.le.ScanSettings, android.app.PendingIntent).

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.

[Android.Runtime.Register("startScan", "(Ljava/util/List;Landroid/bluetooth/le/ScanSettings;Landroid/bluetooth/le/ScanCallback;)V", "")]
[Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_SCAN")]
public void StartScan(System.Collections.Generic.IList<Android.Bluetooth.LE.ScanFilter>? filters, Android.Bluetooth.LE.ScanSettings? settings, Android.Bluetooth.LE.ScanCallback? callback);

[<Android.Runtime.Register("startScan", "(Ljava/util/List;Landroid/bluetooth/le/ScanSettings;Landroid/bluetooth/le/ScanCallback;)V", "")>]
[<Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_SCAN")>]
member this.StartScan : System.Collections.Generic.IList<Android.Bluetooth.LE.ScanFilter> * Android.Bluetooth.LE.ScanSettings * Android.Bluetooth.LE.ScanCallback -> unit

Parameter

Attribute

RegisterAttribute RequiresPermissionAttribute

Hinweise

Starten Sie den Bluetooth LE-Scan. Die Scanergebnisse werden durchgestellt callback. Bei ungefilterten Scans wird die Überprüfung auf dem Bildschirm beendet, um Energie zu sparen. Das Scannen wird fortgesetzt, wenn der Bildschirm erneut aktiviert ist. Um dies zu vermeiden, führen Sie die gefilterte Überprüfung mit der richtigen ScanFilterVerwendung durch.

Eine App muss android.Manifest.permission#ACCESS_COARSE_LOCATION ACCESS_COARSE_LOCATION über die Berechtigung zum Abrufen von Ergebnissen verfügen. Eine App für Android Q oder höher muss android.Manifest.permission#ACCESS_FINE_LOCATION ACCESS_FINE_LOCATION über die Berechtigung zum Abrufen von Ergebnissen verfügen.

Java Dokumentation für android.bluetooth.le.BluetoothLeScanner.startScan(java.util.List<android.bluetooth.le.ScanFilter>, android.bluetooth.le.ScanSettings, android.bluetooth.le.ScanCallback).

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.