TelephonyManager.Listen(PhoneStateListener, PhoneStateListenerFlags) 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.
Registra um objeto de ouvinte para receber notificação de alterações em estados de telefonia especificados.
[Android.Runtime.Register("listen", "(Landroid/telephony/PhoneStateListener;I)V", "GetListen_Landroid_telephony_PhoneStateListener_IHandler")]
public virtual void Listen(Android.Telephony.PhoneStateListener? listener, Android.Telephony.PhoneStateListenerFlags events);[<Android.Runtime.Register("listen", "(Landroid/telephony/PhoneStateListener;I)V", "GetListen_Landroid_telephony_PhoneStateListener_IHandler")>]
abstract member Listen : Android.Telephony.PhoneStateListener * Android.Telephony.PhoneStateListenerFlags -> unit
override this.Listen : Android.Telephony.PhoneStateListener * Android.Telephony.PhoneStateListenerFlags -> unitParâmetros
- listener
- PhoneStateListener
O PhoneStateListener objeto a ser registrado (ou cancelado)
- events
- PhoneStateListenerFlags
O(s) estado(s) de telefonia de interesse para o ouvinte, como uma combinação bit a bit OU de sinalizadores de PhoneStateListener LISTEN_.
- Atributos
Comentários
Registra um objeto de ouvinte para receber notificação de alterações em estados de telefonia especificados.
Para registrar um ouvinte, passe um PhoneStateListener e especifique pelo menos um estado de interesse de telefonia no argumento de eventos.
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 ouvinte e passa os valores atuais (atualizados).
Para cancelar o registro de um ouvinte, passe o objeto de ouvinte e defina o argumento events como PhoneStateListener#LISTEN_NONE LISTEN_NONE (0).
Se esse objeto TelephonyManager tiver sido criado com #createForSubscriptionId, aplica-se ao subId fornecido. Caso contrário, aplica-se a SubscriptionManager#getDefaultSubscriptionId(). Para escutar eventos de vários subIds, passe um objeto de ouvinte separado para cada objeto TelephonyManager criado com #createForSubscriptionIdo .
Nota: se você chamar esse método enquanto estiver no meio de uma transação de fichário, você <b>deve< / b> chamar android.os.Binder#clearCallingIdentity() antes de chamar esse método. A SecurityException será lançado de outra forma.
Essa API deve ser usada com moderação -- um grande número de ouvintes causará instabilidade no sistema. Se um processo registrou muitos ouvintes sem cancelá-los, ele pode encontrar um IllegalStateException ao tentar registrar mais ouvintes.
Este membro foi preterido. Use #registerTelephonyCallback(Executor, TelephonyCallback).
Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.