BluetoothAdapter.StartDiscovery Método

Definición

Inicie el proceso de detección de dispositivos remotos.

[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

Devoluciones

true si se ha realizado correctamente, false en caso de error

Atributos

Comentarios

Inicie el proceso de detección de dispositivos remotos.

El proceso de detección normalmente implica un examen de consulta de unos 12 segundos, seguido de un examen de página de cada dispositivo nuevo para recuperar su nombre Bluetooth.

Se trata de una llamada asincrónica, que devolverá inmediatamente. Regístrese para #ACTION_DISCOVERY_STARTED las intenciones y #ACTION_DISCOVERY_FINISHED para determinar exactamente cuándo se inicia y se completa la detección. Regístrese para BluetoothDevice#ACTION_FOUND recibir notificaciones como dispositivos Bluetooth remotos.

La detección de dispositivos es un procedimiento de peso pesado. No se deben intentar nuevas conexiones a dispositivos Bluetooth remotos mientras la detección está en curso y las conexiones existentes experimentarán un ancho de banda limitado y una latencia alta. Use #cancelDiscovery() para cancelar una detección en curso. La detección no la administra la actividad, pero se ejecuta como un servicio del sistema, por lo que una aplicación siempre debe llamar a BluetoothAdapter#cancelDiscovery() aunque no haya solicitado directamente una detección, solo para asegurarse.

La detección de dispositivos solo encontrará dispositivos remotos que se pueden detectar actualmente (examen de consulta habilitado). Muchos dispositivos Bluetooth no se pueden detectar de forma predeterminada y deben introducirse en un modo especial.

Si el estado de Bluetooth no #STATE_ONes , esta API devolverá false. Después de activar Bluetooth, espere #ACTION_STATE_CHANGED#STATE_ON con para obtener el valor actualizado.

Si un dispositivo está enlazando actualmente, esta solicitud se pondrá en cola y se ejecutará una vez que el dispositivo haya terminado de vincularse. Si ya hay una solicitud en cola, esta solicitud se omitirá.

Java documentación para android.bluetooth.BluetoothAdapter.startDiscovery().

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a