BluetoothLeScanner.StartScan Metodo

Definizione

Spazio dei nomi:: Android.Bluetooth.LE

Assembly:: Mono.Android.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Overload

Nome	Descrizione
StartScan(ScanCallback)	Avviare l'analisi Bluetooth LE con parametri predefiniti e senza filtri.
StartScan(IList<ScanFilter>, ScanSettings, PendingIntent)	Avviare l'analisi Bluetooth LE usando un oggetto `PendingIntent`.
StartScan(IList<ScanFilter>, ScanSettings, ScanCallback)	Avviare l'analisi Bluetooth LE.

StartScan(ScanCallback)

Avviare l'analisi Bluetooth LE con parametri predefiniti e senza filtri.

[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

Parametri

callback: ScanCallback

Callback usato per recapitare i risultati dell'analisi.

Attributi: RegisterAttribute RequiresPermissionAttribute

Eccezioni

IllegalArgumentException

Se callback è Null.

Commenti

Avviare l'analisi Bluetooth LE con parametri predefiniti e senza filtri. I risultati dell'analisi verranno recapitati tramite callback. Per le analisi non filtrate, l'analisi viene arrestata sullo schermo per risparmiare energia. L'analisi viene ripresa quando lo schermo viene riattivato. Per evitare questo problema, usare con l'oggetto #startScan(List, ScanSettings, ScanCallback) desiderato ScanFilter.

Per ottenere i risultati, un'app deve disporre android.Manifest.permission#ACCESS_COARSE_LOCATION ACCESS_COARSE_LOCATION dell'autorizzazione. Un'app destinata ad Android Q o versione successiva deve disporre android.Manifest.permission#ACCESS_FINE_LOCATION ACCESS_FINE_LOCATION dell'autorizzazione per ottenere risultati.

per android.bluetooth.le.BluetoothLeScanner.startScan(android.bluetooth.le.ScanCallback).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a

StartScan(IList<ScanFilter>, ScanSettings, PendingIntent)

Avviare l'analisi Bluetooth LE usando un oggetto PendingIntent.

[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

Parametri

filters: IList<ScanFilter>

Elenco facoltativo di ScanFilters per trovare i dispositivi BLE esatti.

settings: ScanSettings

Impostazioni facoltative per l'analisi.

callbackIntent: PendingIntent

Oggetto PendingIntent a cui recapitare il risultato.

Valori restituiti

Int32

Restituisce 0 per esito positivo o un codice di errore da ScanCallback se non è stato possibile inviare la richiesta di analisi.

Attributi: RegisterAttribute RequiresPermissionAttribute

Commenti

Avviare l'analisi Bluetooth LE usando un oggetto PendingIntent. I risultati dell'analisi verranno recapitati tramite PendingIntent. Usare questo metodo di analisi se il processo non è sempre in esecuzione e deve essere avviato quando sono disponibili i risultati dell'analisi.

Quando l'oggetto PendingIntent viene recapitato, la finalità passata al ricevitore o all'attività conterrà uno o più elementi aggiuntivi #EXTRA_CALLBACK_TYPE#EXTRA_ERROR_CODE e #EXTRA_LIST_SCAN_RESULT per indicare il risultato dell'analisi.

per android.bluetooth.le.BluetoothLeScanner.startScan(java.util.List<android.bluetooth.le.ScanFilter>, android.bluetooth.le.ScanSettings, android.app.PendingIntent).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a

StartScan(IList<ScanFilter>, ScanSettings, ScanCallback)

Avviare l'analisi Bluetooth LE.

[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

Parametri

filters: IList<ScanFilter>

ScanFilters per trovare dispositivi BLE esatti.

settings: ScanSettings

Impostazioni per l'analisi.

callback: ScanCallback

Callback usato per recapitare i risultati dell'analisi.

Attributi: RegisterAttribute RequiresPermissionAttribute

Commenti

Avviare l'analisi Bluetooth LE. I risultati dell'analisi verranno recapitati tramite callback. Per le analisi non filtrate, l'analisi viene arrestata sullo schermo per risparmiare energia. L'analisi viene ripresa quando lo schermo viene riattivato. Per evitare questo problema, eseguire l'analisi filtrata usando il corretto ScanFilter.

per android.bluetooth.le.BluetoothLeScanner.startScan(java.util.List<android.bluetooth.le.ScanFilter>, android.bluetooth.le.ScanSettings, android.bluetooth.le.ScanCallback).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.

Si applica a