CompanionDeviceManager.Associate Método
Definição
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 | Descrição |
|---|---|
| Associate(AssociationRequest, CompanionDeviceManager+Callback, Handler) |
Associe este aplicativo a um dispositivo complementar, selecionado pelo usuário |
| Associate(AssociationRequest, IExecutor, CompanionDeviceManager+Callback) |
Solicite associar esse aplicativo a um dispositivo complementar. |
Associate(AssociationRequest, CompanionDeviceManager+Callback, Handler)
Associe este aplicativo a um dispositivo complementar, selecionado pelo usuário
[Android.Runtime.Register("associate", "(Landroid/companion/AssociationRequest;Landroid/companion/CompanionDeviceManager$Callback;Landroid/os/Handler;)V", "", ApiSince=26)]
public void Associate(Android.Companion.AssociationRequest request, Android.Companion.CompanionDeviceManager.Callback callback, Android.OS.Handler? handler);
[<Android.Runtime.Register("associate", "(Landroid/companion/AssociationRequest;Landroid/companion/CompanionDeviceManager$Callback;Landroid/os/Handler;)V", "", ApiSince=26)>]
member this.Associate : Android.Companion.AssociationRequest * Android.Companion.CompanionDeviceManager.Callback * Android.OS.Handler -> unit
Parâmetros
- request
- AssociationRequest
detalhes específicos sobre essa solicitação
- callback
- CompanionDeviceManager.Callback
será chamado quando houver pelo menos um dispositivo encontrado para o usuário escolher
- handler
- Handler
Um manipulador para controlar em qual thread o retorno de chamada será entregue ou nulo para entregá-lo no thread principal
- Atributos
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
Associate(AssociationRequest, IExecutor, CompanionDeviceManager+Callback)
Solicite associar esse aplicativo a um dispositivo complementar.
[Android.Runtime.Register("associate", "(Landroid/companion/AssociationRequest;Ljava/util/concurrent/Executor;Landroid/companion/CompanionDeviceManager$Callback;)V", "", ApiSince=33)]
public void Associate(Android.Companion.AssociationRequest request, Java.Util.Concurrent.IExecutor executor, Android.Companion.CompanionDeviceManager.Callback callback);
[<Android.Runtime.Register("associate", "(Landroid/companion/AssociationRequest;Ljava/util/concurrent/Executor;Landroid/companion/CompanionDeviceManager$Callback;)V", "", ApiSince=33)>]
member this.Associate : Android.Companion.AssociationRequest * Java.Util.Concurrent.IExecutor * Android.Companion.CompanionDeviceManager.Callback -> unit
Parâmetros
- request
- AssociationRequest
Um objeto de solicitação que descreve os detalhes da solicitação. Esse valor não pode ser nulo.
- executor
- IExecutor
O executor que será usado para invocar o retorno de chamada. Esse valor não pode ser nulo.
- callback
- CompanionDeviceManager.Callback
O retorno de chamada usado para notificar o aplicativo quando a associação é criada. Esse valor não pode ser nulo.
- Atributos
Comentários
Solicite associar esse aplicativo a um dispositivo complementar.
Observe que, antes de criar uma associação de estabelecimento, o sistema pode precisar mostrar a interface do usuário para coletar a confirmação do usuário.
Se o aplicativo precisar ser excluído das otimizações de bateria (executadas em segundo plano) ou ter acesso irrestrito a dados (usar dados em segundo plano), ele deverá declarar o uso de Manifest.permission.REQUEST_COMPANION_RUN_IN_BACKGROUND e Manifest.permission.REQUEST_COMPANION_USE_DATA_IN_BACKGROUND em seu AndroidManifest.xml, respectivamente. Observe que esses recursos especiais têm um efeito negativo sobre a bateria do dispositivo e o uso de dados do usuário, portanto, você deve solicitá-los quando absolutamente necessário.
O aplicativo pode usar getMyAssociations() para recuperar a lista de objetos AssociationInfo atualmente, que representam suas associações existentes. Os aplicativos também podem usar disassociate(int) para remover uma associação e é recomendável fazer quando uma associação não é mais relevante para evitar bateria desnecessária e/ou esvaziamento de dados resultante de privilégios especiais que a associação fornece
Observe que, se você usar essa api para associar a um dispositivo Bluetooth, cancele sua própria descoberta de Bluetooth antes de chamar essa api, caso contrário, o retorno de chamada poderá não retornar o dispositivo desejado.
Chamar essa API requer uma declaração de PackageManager.FEATURE_COMPANION_DEVICE_SETUP de recursos de uso no manifesto
Referência do Android para android.companion.CompanionDeviceManager.associate.
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.