TelephonyManager.RegisterTelephonyCallback 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 | Description |
|---|---|
| RegisterTelephonyCallback(IExecutor, TelephonyCallback) |
Registra um objeto de retorno de chamada para receber a notificação de alterações em estados de telefonia especificados. |
| RegisterTelephonyCallback(Int32, IExecutor, TelephonyCallback) |
Registra um objeto de retorno de chamada para receber a notificação de alterações em estados de telefonia especificados. |
RegisterTelephonyCallback(IExecutor, TelephonyCallback)
Registra um objeto de retorno de chamada para receber a notificação de alterações em estados de telefonia especificados.
[Android.Runtime.Register("registerTelephonyCallback", "(Ljava/util/concurrent/Executor;Landroid/telephony/TelephonyCallback;)V", "GetRegisterTelephonyCallback_Ljava_util_concurrent_Executor_Landroid_telephony_TelephonyCallback_Handler", ApiSince=31)]
public virtual void RegisterTelephonyCallback(Java.Util.Concurrent.IExecutor executor, Android.Telephony.TelephonyCallback callback);
[<Android.Runtime.Register("registerTelephonyCallback", "(Ljava/util/concurrent/Executor;Landroid/telephony/TelephonyCallback;)V", "GetRegisterTelephonyCallback_Ljava_util_concurrent_Executor_Landroid_telephony_TelephonyCallback_Handler", ApiSince=31)>]
abstract member RegisterTelephonyCallback : Java.Util.Concurrent.IExecutor * Android.Telephony.TelephonyCallback -> unit
override this.RegisterTelephonyCallback : Java.Util.Concurrent.IExecutor * Android.Telephony.TelephonyCallback -> unit
Parâmetros
- executor
- IExecutor
O executor de onde o retorno de chamada será executado.
- callback
- TelephonyCallback
O TelephonyCallback objeto a ser registrado. O chamador deve manter uma referência ao retorno de chamada. A estrutura contém apenas uma referência fraca.
- Atributos
Comentários
Registra um objeto de retorno de chamada para receber a notificação de alterações em estados de telefonia especificados.
Para registrar um retorno de chamada, passe um TelephonyCallback que implementa interfaces de eventos. Por exemplo, FakeServiceStateCallback estende TelephonyCallback implementações TelephonyCallback.ServiceStateListener.
No registro e quando um estado de telefonia especificado é alterado, o gerenciador de telefonia invoca o método de retorno de chamada apropriado no objeto de retorno de chamada e passa os valores atuais (atualizados).
Observação: esteja ciente dos requisitos de permissão declarados nos TelephonyCallback ouvintes que você implementa. Seu aplicativo deve receber essas permissões para registrar uma TelephonyCallback que as exija; uma SecurityException será lançada se você não tiver as permissões necessárias para todos os TelephonyCallback ouvintes implementados.
Se esse objeto TelephonyManager tiver sido criado com #createForSubscriptionId, aplica-se à subId fornecida. Caso contrário, aplica-se a SubscriptionManager#getDefaultSubscriptionId(). Para registrar eventos para várias subIds, passe um objeto de retorno de chamada separado para cada objeto TelephonyManager criado com #createForSubscriptionId.
Observação: se você chamar esse método enquanto estiver no meio de uma transação de associador, você <>deverá</b> chamar android.os.Binder#clearCallingIdentity() antes de chamar esse método. Um SecurityException será lançado caso contrário.
Essa API deve ser usada com moderação. Um grande número de retornos de chamada causará instabilidade no sistema. Se um processo tiver registrado muitos retornos de chamada sem cancelá-los, ele poderá encontrar um IllegalStateException ao tentar registrar mais retornos de chamada.
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
RegisterTelephonyCallback(Int32, IExecutor, TelephonyCallback)
Registra um objeto de retorno de chamada para receber a notificação de alterações em estados de telefonia especificados.
[Android.Runtime.Register("registerTelephonyCallback", "(ILjava/util/concurrent/Executor;Landroid/telephony/TelephonyCallback;)V", "GetRegisterTelephonyCallback_ILjava_util_concurrent_Executor_Landroid_telephony_TelephonyCallback_Handler", ApiSince=33)]
public virtual void RegisterTelephonyCallback(int includeLocationData, Java.Util.Concurrent.IExecutor executor, Android.Telephony.TelephonyCallback callback);
[<Android.Runtime.Register("registerTelephonyCallback", "(ILjava/util/concurrent/Executor;Landroid/telephony/TelephonyCallback;)V", "GetRegisterTelephonyCallback_ILjava_util_concurrent_Executor_Landroid_telephony_TelephonyCallback_Handler", ApiSince=33)>]
abstract member RegisterTelephonyCallback : int * Java.Util.Concurrent.IExecutor * Android.Telephony.TelephonyCallback -> unit
override this.RegisterTelephonyCallback : int * Java.Util.Concurrent.IExecutor * Android.Telephony.TelephonyCallback -> unit
Parâmetros
- includeLocationData
- Int32
Especifica se o chamador deseja receber informações relacionadas ao local.
- executor
- IExecutor
O executor de onde o retorno de chamada será executado.
- callback
- TelephonyCallback
O TelephonyCallback objeto a ser registrado. O chamador deve manter uma referência ao retorno de chamada. A estrutura contém apenas uma referência fraca.
- Atributos
Comentários
Registra um objeto de retorno de chamada para receber a notificação de alterações em estados de telefonia especificados.
Para registrar um retorno de chamada, passe um TelephonyCallback que implementa interfaces de eventos. Por exemplo, FakeServiceStateCallback estende TelephonyCallback implementações TelephonyCallback.ServiceStateListener.
No registro e quando um estado de telefonia especificado é alterado, o gerenciador de telefonia invoca o método de retorno de chamada apropriado no objeto de retorno de chamada e passa os valores atuais (atualizados).
Se esse objeto TelephonyManager tiver sido criado com #createForSubscriptionId, aplica-se à subId fornecida. Caso contrário, aplica-se a SubscriptionManager#getDefaultSubscriptionId(). Para registrar eventos para várias subIds, passe um objeto de retorno de chamada separado para cada objeto TelephonyManager criado com #createForSubscriptionId.
Observação: se você chamar esse método enquanto estiver no meio de uma transação de associador, você <>deverá</b> chamar android.os.Binder#clearCallingIdentity() antes de chamar esse método. Um SecurityException será lançado caso contrário.
Essa API deve ser usada com moderação. Um grande número de retornos de chamada causará instabilidade no sistema. Se um processo tiver registrado muitos retornos de chamada sem cancelá-los, ele poderá encontrar um IllegalStateException ao tentar registrar mais retornos de chamada.
Há outra maneira de renunciar às permissões com um contexto AttributionSource.Builder#setRenouncedPermissions(Set<String>) personalizado, mas apenas para aplicativos do sistema. Para evitar confusão, chamar esse método substitui permissões de renomeação com um contexto personalizado.
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.