BluetoothLeScanner.StartScan Méthode

Définition

Espace de noms:: Android.Bluetooth.LE

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

Nom	Description
StartScan(ScanCallback)	Démarrez l’analyse Bluetooth LE avec les paramètres par défaut et aucun filtre.
StartScan(IList<ScanFilter>, ScanSettings, PendingIntent)	Démarrez l’analyse Bluetooth LE à l’aide d’un `PendingIntent`.
StartScan(IList<ScanFilter>, ScanSettings, ScanCallback)	Démarrez l’analyse Bluetooth LE.

StartScan(ScanCallback)

Démarrez l’analyse Bluetooth LE avec les paramètres par défaut et aucun filtre.

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

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

Paramètres

callback: ScanCallback

Rappel utilisé pour fournir des résultats d’analyse.

Attributs: RegisterAttribute

Exceptions

IllegalArgumentException

Si callback la valeur est Null.

Remarques

Démarrez l’analyse Bluetooth LE avec les paramètres par défaut et aucun filtre. Les résultats de l’analyse seront remis via callback. Pour les analyses non filtrées, l’analyse est arrêtée à l’écran pour économiser de l’alimentation. L’analyse est reprise lorsque l’écran est à nouveau activé. Pour éviter cela, utilisez #startScan(List, ScanSettings, ScanCallback) avec le choix ScanFilter.

Une application doit avoir android.Manifest.permission#ACCESS_COARSE_LOCATION ACCESS_COARSE_LOCATION l’autorisation d’obtenir des résultats. Une application ciblant Android Q ou version ultérieure doit avoir android.Manifest.permission#ACCESS_FINE_LOCATION ACCESS_FINE_LOCATION l’autorisation d’obtenir des résultats.

Java documentation pour android.bluetooth.le.BluetoothLeScanner.startScan(android.bluetooth.le.ScanCallback).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à

StartScan(IList<ScanFilter>, ScanSettings, PendingIntent)

Démarrez l’analyse Bluetooth LE à l’aide d’un PendingIntent.

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

Paramètres

filters: IList<ScanFilter>

Liste facultative de ScanFilters pour rechercher des appareils BLE exacts.

settings: ScanSettings

Paramètres facultatifs pour l’analyse.

callbackIntent: PendingIntent

PendingIntent à envoyer le résultat.

Retours

Int32

Retourne 0 pour la réussite ou un code d’erreur à partir duquel ScanCallback la demande d’analyse n’a pas pu être envoyée.

Attributs: RegisterAttribute

Remarques

Démarrez l’analyse Bluetooth LE à l’aide d’un PendingIntent. Les résultats de l’analyse sont remis via PendingIntent. Utilisez cette méthode d’analyse si votre processus n’est pas toujours en cours d’exécution et qu’il doit être démarré lorsque les résultats de l’analyse sont disponibles.

Lorsque l’objet PendingIntent est remis, l’intention transmise au récepteur ou à l’activité contient un ou plusieurs des extras #EXTRA_CALLBACK_TYPEet #EXTRA_ERROR_CODE#EXTRA_LIST_SCAN_RESULT indique le résultat de l’analyse.

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

S’applique à

StartScan(IList<ScanFilter>, ScanSettings, ScanCallback)

Démarrez l’analyse Bluetooth LE.

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

Paramètres

filters: IList<ScanFilter>

ScanFilterpour rechercher des appareils BLE exacts.

settings: ScanSettings

Paramètres de l’analyse.

callback: ScanCallback

Rappel utilisé pour fournir des résultats d’analyse.

Attributs: RegisterAttribute

Remarques

Démarrez l’analyse Bluetooth LE. Les résultats de l’analyse seront remis via callback. Pour les analyses non filtrées, l’analyse est arrêtée à l’écran pour économiser de l’alimentation. L’analyse est reprise lorsque l’écran est à nouveau activé. Pour éviter cela, effectuez une analyse filtrée à l’aide de la méthode appropriée ScanFilter.

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

S’applique à