BluetoothAdapter.StartDiscovery Méthode

Définition

Espace de noms:: Android.Bluetooth

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.

Démarrez le processus de découverte d’appareils distants.

[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

Retours

Boolean

true sur la réussite, false sur l’erreur

Attributs: RegisterAttribute RequiresPermissionAttribute

Remarques

Démarrez le processus de découverte d’appareils distants.

Le processus de découverte implique généralement une analyse d’enquête d’environ 12 secondes, suivie d’une analyse de page de chaque nouvel appareil pour récupérer son nom Bluetooth.

Il s’agit d’un appel asynchrone, il retourne immédiatement. #ACTION_DISCOVERY_STARTED Inscrivez-vous pour #ACTION_DISCOVERY_FINISHED déterminer exactement quand la découverte démarre et se termine. BluetoothDevice#ACTION_FOUND Inscrivez-vous pour être averti en tant qu’appareils Bluetooth distants trouvés.

La découverte d’appareils est une procédure lourde. Les nouvelles connexions aux appareils Bluetooth distants ne doivent pas être tentées pendant que la découverte est en cours, et les connexions existantes subissent une bande passante limitée et une latence élevée. Permet #cancelDiscovery() d’annuler une découverte en cours. La découverte n’est pas gérée par l’activité, mais est exécutée en tant que service système. Par conséquent, une application doit toujours appeler BluetoothAdapter#cancelDiscovery() même si elle n’a pas demandé directement une découverte, juste pour être sûr.

La découverte d’appareils recherche uniquement les appareils distants actuellement détectables (analyse d’enquête activée). De nombreux appareils Bluetooth ne sont pas détectables par défaut et doivent être entrés en mode spécial.

Si l’état Bluetooth n’est pas #STATE_ONle cas, cette API retourne false. Après avoir activé Bluetooth, attendez #ACTION_STATE_CHANGED que #STATE_ON la valeur soit mise à jour.

Si un appareil est actuellement lié, cette demande est mise en file d’attente et exécutée une fois que l’appareil a terminé la liaison. Si une demande est déjà mise en file d’attente, cette demande est ignorée.

Java documentation pour android.bluetooth.BluetoothAdapter.startDiscovery().

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 à