BluetoothDevice.ConnectGatt Método

Definição

Namespace:: Android.Bluetooth

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

Nome	Description
ConnectGatt(BluetoothGattConnectionSettings, IExecutor, BluetoothGattCallback)	Conecte-se ao servidor GATT hospedado pelo dispositivo especificado.
ConnectGatt(Context, Boolean, BluetoothGattCallback)	Conecte-se ao servidor GATT hospedado por este dispositivo.
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports)	Conecte-se ao servidor GATT hospedado por este dispositivo.
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, BluetoothPhy)	Conecte-se ao servidor GATT hospedado por este dispositivo.
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy)	Obsoleto.
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, BluetoothPhy, Handler)	Conecte-se ao servidor GATT hospedado por este dispositivo.
ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy, Handler)	Obsoleto.

ConnectGatt(BluetoothGattConnectionSettings, IExecutor, BluetoothGattCallback)

Conecte-se ao servidor GATT hospedado pelo dispositivo especificado.

[Android.Runtime.Register("connectGatt", "(Landroid/bluetooth/BluetoothGattConnectionSettings;Ljava/util/concurrent/Executor;Landroid/bluetooth/BluetoothGattCallback;)Landroid/bluetooth/BluetoothGatt;", "", ApiSince=37)]
[Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_CONNECT")]
public Android.Bluetooth.BluetoothGatt? ConnectGatt(Android.Bluetooth.BluetoothGattConnectionSettings gattConnectionSettings, Java.Util.Concurrent.IExecutor executor, Android.Bluetooth.BluetoothGattCallback callback);

[<Android.Runtime.Register("connectGatt", "(Landroid/bluetooth/BluetoothGattConnectionSettings;Ljava/util/concurrent/Executor;Landroid/bluetooth/BluetoothGattCallback;)Landroid/bluetooth/BluetoothGatt;", "", ApiSince=37)>]
[<Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_CONNECT")>]
member this.ConnectGatt : Android.Bluetooth.BluetoothGattConnectionSettings * Java.Util.Concurrent.IExecutor * Android.Bluetooth.BluetoothGattCallback -> Android.Bluetooth.BluetoothGatt

Parâmetros

gattConnectionSettings: BluetoothGattConnectionSettings

BluetoothGattConnectionSettings objetos com configurações de gatt necessárias para a conexão GATT

executor: IExecutor

O executor a ser usado para o retorno de chamada.

callback: BluetoothGattCallback

Manipulador de retorno de chamada GATT que receberá retornos de chamada assíncronos.

Retornos

BluetoothGatt

Uma instância do BluetoothGatt. Você pode usar BluetoothGatt para conduzir operações de cliente GATT.

Atributos: RegisterAttribute RequiresPermissionAttribute

Comentários

Conecte-se ao servidor GATT hospedado pelo dispositivo especificado. O chamador atua como um cliente GATT. BluetoothGattCallback de BluetoothGattConnectionSettings fornecerá resultados ao Chamador, como atualizações de conexão e resultados da operação do cliente GATT. O método retorna uma instância bluetoothGatt. O aplicativo pode usar BluetoothGatt para conduzir operações de cliente GATT. Para aplicativos direcionados Build.VERSION_CODES. S ou superior, isso requer a permissão Manifest.permission.BLUETOOTH_CONNECT que pode ser obtida com android.app.Activity.requestPermissions(String[],int). Requer Manifest.permission.BLUETOOTH_CONNECT

Referência do Android para android.bluetooth.BluetoothDevice.connectGatt.

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.

Aplica-se a

ConnectGatt(Context, Boolean, BluetoothGattCallback)

Conecte-se ao servidor GATT hospedado por este dispositivo.

[Android.Runtime.Register("connectGatt", "(Landroid/content/Context;ZLandroid/bluetooth/BluetoothGattCallback;)Landroid/bluetooth/BluetoothGatt;", "")]
[Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_CONNECT")]
public Android.Bluetooth.BluetoothGatt? ConnectGatt(Android.Content.Context? context, bool autoConnect, Android.Bluetooth.BluetoothGattCallback? callback);

[<Android.Runtime.Register("connectGatt", "(Landroid/content/Context;ZLandroid/bluetooth/BluetoothGattCallback;)Landroid/bluetooth/BluetoothGatt;", "")>]
[<Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_CONNECT")>]
member this.ConnectGatt : Android.Content.Context * bool * Android.Bluetooth.BluetoothGattCallback -> Android.Bluetooth.BluetoothGatt

Parâmetros

context: Context

autoConnect: Boolean

Seja para se conectar diretamente ao dispositivo remoto (false) ou para se conectar automaticamente assim que o dispositivo remoto ficar disponível (true).

callback: BluetoothGattCallback

Manipulador de retorno de chamada GATT que receberá retornos de chamada assíncronos.

Retornos

BluetoothGatt

Atributos: RegisterAttribute RequiresPermissionAttribute

Exceções

IllegalArgumentException

se o retorno de chamada for nulo

Comentários

Conecte-se ao servidor GATT hospedado por este dispositivo. O chamador atua como cliente GATT. O retorno de chamada é usado para fornecer resultados ao Chamador, como o status da conexão, bem como quaisquer outras operações de cliente GATT. O método retorna uma instância bluetoothGatt. Você pode usar BluetoothGatt para conduzir operações de cliente GATT.

Java documentação para android.bluetooth.BluetoothDevice.connectGatt(android.content.Context, boolean, android.bluetooth.BluetoothGattCallback).

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.

Aplica-se a

ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports)

Conecte-se ao servidor GATT hospedado por este dispositivo.

[Android.Runtime.Register("connectGatt", "(Landroid/content/Context;ZLandroid/bluetooth/BluetoothGattCallback;I)Landroid/bluetooth/BluetoothGatt;", "", ApiSince=23)]
[Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_CONNECT")]
public Android.Bluetooth.BluetoothGatt? ConnectGatt(Android.Content.Context? context, bool autoConnect, Android.Bluetooth.BluetoothGattCallback? callback, Android.Bluetooth.BluetoothTransports transport);

[<Android.Runtime.Register("connectGatt", "(Landroid/content/Context;ZLandroid/bluetooth/BluetoothGattCallback;I)Landroid/bluetooth/BluetoothGatt;", "", ApiSince=23)>]
[<Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_CONNECT")>]
member this.ConnectGatt : Android.Content.Context * bool * Android.Bluetooth.BluetoothGattCallback * Android.Bluetooth.BluetoothTransports -> Android.Bluetooth.BluetoothGatt

Parâmetros

context: Context

autoConnect: Boolean

Seja para se conectar diretamente ao dispositivo remoto (false) ou para se conectar automaticamente assim que o dispositivo remoto ficar disponível (true).

callback: BluetoothGattCallback

Manipulador de retorno de chamada GATT que receberá retornos de chamada assíncronos.

transport: BluetoothTransports

transporte preferencial para conexões GATT para dispositivos remotos BluetoothDevice#TRANSPORT_AUTO de modo duplo ou ou BluetoothDevice#TRANSPORT_BREDRBluetoothDevice#TRANSPORT_LE

Retornos

BluetoothGatt

Atributos: RegisterAttribute RequiresPermissionAttribute

Comentários

Java documentação para android.bluetooth.BluetoothDevice.connectGatt(android.content.Context, boolean, android.bluetooth.BluetoothGattCallback, int).

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.

Aplica-se a

ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, BluetoothPhy)

Conecte-se ao servidor GATT hospedado por este dispositivo.

[Android.Runtime.Register("connectGatt", "(Landroid/content/Context;ZLandroid/bluetooth/BluetoothGattCallback;II)Landroid/bluetooth/BluetoothGatt;", "", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_CONNECT")]
public Android.Bluetooth.BluetoothGatt? ConnectGatt(Android.Content.Context? context, bool autoConnect, Android.Bluetooth.BluetoothGattCallback? callback, Android.Bluetooth.BluetoothTransports transport, Android.Bluetooth.BluetoothPhy phy);

[<Android.Runtime.Register("connectGatt", "(Landroid/content/Context;ZLandroid/bluetooth/BluetoothGattCallback;II)Landroid/bluetooth/BluetoothGatt;", "", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_CONNECT")>]
member this.ConnectGatt : Android.Content.Context * bool * Android.Bluetooth.BluetoothGattCallback * Android.Bluetooth.BluetoothTransports * Android.Bluetooth.BluetoothPhy -> Android.Bluetooth.BluetoothGatt

Parâmetros

context: Context

autoConnect: Boolean

Seja para se conectar diretamente ao dispositivo remoto (false) ou para se conectar automaticamente assim que o dispositivo remoto ficar disponível (true).

callback: BluetoothGattCallback

Manipulador de retorno de chamada GATT que receberá retornos de chamada assíncronos.

transport: BluetoothTransports

transporte preferencial para conexões GATT para dispositivos remotos BluetoothDevice#TRANSPORT_AUTO de modo duplo ou ou BluetoothDevice#TRANSPORT_BREDRBluetoothDevice#TRANSPORT_LE

phy: BluetoothPhy

PHY preferencial para conexões com dispositivo LE remoto. OR bit a bit de qualquer um dos BluetoothDevice#PHY_LE_1M_MASK, BluetoothDevice#PHY_LE_2M_MASKe BluetoothDevice#PHY_LE_CODED_MASK. Essa opção não terá efeito se autoConnect estiver definida como true.

Retornos

BluetoothGatt

Atributos: RegisterAttribute RequiresPermissionAttribute

Comentários

Java documentação para android.bluetooth.BluetoothDevice.connectGatt(android.content.Context, boolean, android.bluetooth.BluetoothGattCallback, int, int).

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.

Aplica-se a

ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy)

Cuidado

This method has the wrong enumeration. Use the version that takes an 'Android.Bluetooth.BluetoothPhy' instead.

[System.Obsolete("This method has the wrong enumeration. Use the version that takes an 'Android.Bluetooth.BluetoothPhy' instead.")]
public Android.Bluetooth.BluetoothGatt? ConnectGatt(Android.Content.Context? context, bool autoConnect, Android.Bluetooth.BluetoothGattCallback? callback, Android.Bluetooth.BluetoothTransports transport, Android.Bluetooth.LE.ScanSettingsPhy phy);

[<System.Obsolete("This method has the wrong enumeration. Use the version that takes an 'Android.Bluetooth.BluetoothPhy' instead.")>]
member this.ConnectGatt : Android.Content.Context * bool * Android.Bluetooth.BluetoothGattCallback * Android.Bluetooth.BluetoothTransports * Android.Bluetooth.LE.ScanSettingsPhy -> Android.Bluetooth.BluetoothGatt

Parâmetros

context: Context

autoConnect: Boolean

callback: BluetoothGattCallback

transport: BluetoothTransports

phy: ScanSettingsPhy

Retornos

BluetoothGatt

Atributos: ObsoleteAttribute

Comentários

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.

Aplica-se a

ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, BluetoothPhy, Handler)

Conecte-se ao servidor GATT hospedado por este dispositivo.

[Android.Runtime.Register("connectGatt", "(Landroid/content/Context;ZLandroid/bluetooth/BluetoothGattCallback;IILandroid/os/Handler;)Landroid/bluetooth/BluetoothGatt;", "", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_CONNECT")]
public Android.Bluetooth.BluetoothGatt? ConnectGatt(Android.Content.Context? context, bool autoConnect, Android.Bluetooth.BluetoothGattCallback? callback, Android.Bluetooth.BluetoothTransports transport, Android.Bluetooth.BluetoothPhy phy, Android.OS.Handler? handler);

[<Android.Runtime.Register("connectGatt", "(Landroid/content/Context;ZLandroid/bluetooth/BluetoothGattCallback;IILandroid/os/Handler;)Landroid/bluetooth/BluetoothGatt;", "", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.BLUETOOTH_CONNECT")>]
member this.ConnectGatt : Android.Content.Context * bool * Android.Bluetooth.BluetoothGattCallback * Android.Bluetooth.BluetoothTransports * Android.Bluetooth.BluetoothPhy * Android.OS.Handler -> Android.Bluetooth.BluetoothGatt

Parâmetros

context: Context

autoConnect: Boolean

Seja para se conectar diretamente ao dispositivo remoto (false) ou para se conectar automaticamente assim que o dispositivo remoto ficar disponível (true).

callback: BluetoothGattCallback

Manipulador de retorno de chamada GATT que receberá retornos de chamada assíncronos.

transport: BluetoothTransports

transporte preferencial para conexões GATT para dispositivos remotos BluetoothDevice#TRANSPORT_AUTO de modo duplo ou ou BluetoothDevice#TRANSPORT_BREDRBluetoothDevice#TRANSPORT_LE

phy: BluetoothPhy

PHY preferencial para conexões com dispositivo LE remoto. OR bit a bit de qualquer um dos BluetoothDevice#PHY_LE_1M_MASK, BluetoothDevice#PHY_LE_2M_MASKum dBluetoothDevice#PHY_LE_CODED_MASK. Essa opção não terá efeito se autoConnect estiver definida como true.

handler: Handler

O manipulador a ser usado para o retorno de chamada. Se null, os retornos de chamada ocorrerão em um thread em segundo plano não especificado.

Retornos

BluetoothGatt

Atributos: RegisterAttribute RequiresPermissionAttribute

Comentários

Java documentação para android.bluetooth.BluetoothDevice.connectGatt(android.content.Context, boolean, android.bluetooth.BluetoothGattCallback, int, int, android.os.Handler).

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.

Aplica-se a

ConnectGatt(Context, Boolean, BluetoothGattCallback, BluetoothTransports, ScanSettingsPhy, Handler)

Cuidado

This method has the wrong enumeration. Use the version that takes an 'Android.Bluetooth.BluetoothPhy' instead.

[System.Obsolete("This method has the wrong enumeration. Use the version that takes an 'Android.Bluetooth.BluetoothPhy' instead.")]
public Android.Bluetooth.BluetoothGatt? ConnectGatt(Android.Content.Context? context, bool autoConnect, Android.Bluetooth.BluetoothGattCallback? callback, Android.Bluetooth.BluetoothTransports transport, Android.Bluetooth.LE.ScanSettingsPhy phy, Android.OS.Handler? handler);

[<System.Obsolete("This method has the wrong enumeration. Use the version that takes an 'Android.Bluetooth.BluetoothPhy' instead.")>]
member this.ConnectGatt : Android.Content.Context * bool * Android.Bluetooth.BluetoothGattCallback * Android.Bluetooth.BluetoothTransports * Android.Bluetooth.LE.ScanSettingsPhy * Android.OS.Handler -> Android.Bluetooth.BluetoothGatt

Parâmetros

context: Context

autoConnect: Boolean

callback: BluetoothGattCallback

transport: BluetoothTransports

phy: ScanSettingsPhy

handler: Handler

Retornos

BluetoothGatt

Atributos: ObsoleteAttribute

Comentários

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.

Aplica-se a