BluetoothAdapter.StartDiscovery Método

[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

Retornos

true no êxito, false no erro

Atributos

RegisterAttribute RequiresPermissionAttribute

Comentários

Inicie o processo de descoberta de dispositivo remoto.

O processo de descoberta geralmente envolve uma verificação de investigação de cerca de 12 segundos, seguida por uma verificação de página de cada novo dispositivo para recuperar seu nome Bluetooth.

Essa é uma chamada assíncrona, ela retornará imediatamente. #ACTION_DISCOVERY_STARTED Registre-se e #ACTION_DISCOVERY_FINISHED intenção de determinar exatamente quando a descoberta é iniciada e concluída. Registre-se para BluetoothDevice#ACTION_FOUND ser notificado à medida que dispositivos Bluetooth remotos forem encontrados.

A descoberta de dispositivos é um procedimento pesado. Novas conexões com dispositivos Bluetooth remotos não devem ser tentadas enquanto a descoberta estiver em andamento, e as conexões existentes terão largura de banda limitada e alta latência. Use #cancelDiscovery() para cancelar uma descoberta em andamento. A descoberta não é gerenciada pela Atividade, mas é executada como um serviço do sistema, portanto, um aplicativo deve sempre chamar BluetoothAdapter#cancelDiscovery() mesmo que não tenha solicitado diretamente uma descoberta, apenas para ter certeza.

A descoberta de dispositivos só encontrará dispositivos remotos que são detectáveis no momento (verificação de consulta habilitada). Muitos dispositivos Bluetooth não são detectáveis por padrão e precisam ser inseridos em um modo especial.

Se o estado bluetooth não #STATE_ONfor, essa API retornará false. Depois de ativar o Bluetooth, aguarde #ACTION_STATE_CHANGED#STATE_ON até obter o valor atualizado.

Se um dispositivo estiver sendo ligado no momento, essa solicitação será enfileirada e executada após a conclusão da vinculação do dispositivo. Se uma solicitação já estiver na fila, essa solicitação será ignorada.

Java documentação para android.bluetooth.BluetoothAdapter.startDiscovery().

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.