TelephonyManager.Listen(PhoneStateListener, PhoneStateListenerFlags) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Registra un objeto de agente de escucha para recibir notificaciones de cambios en los estados de telefonía 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 -> unit
Parámetros
- listener
- PhoneStateListener
Objeto PhoneStateListener
que se va a registrar (o anular el registro)
- events
- PhoneStateListenerFlags
Estados de telefonía de interés para el agente de escucha, como una combinación or bit a bit de PhoneStateListener
marcas LISTEN_.
- Atributos
Comentarios
Registra un objeto de agente de escucha para recibir notificaciones de cambios en los estados de telefonía especificados.
Para registrar un agente de escucha, pase y PhoneStateListener
especifique al menos un estado de telefonía de interés en el argumento events.
En el registro, y cuando cambia un estado de telefonía especificado, el administrador de telefonía invoca el método de devolución de llamada adecuado en el objeto de escucha y pasa los valores actuales (actualizados).
Para anular el registro de un agente de escucha, pase el objeto listener y establezca el argumento PhoneStateListener#LISTEN_NONE LISTEN_NONE
events en (0).
Si este objeto TelephonyManager se ha creado con #createForSubscriptionId
, se aplica al subId especificado. De lo contrario, se aplica a SubscriptionManager#getDefaultSubscriptionId()
. Para escuchar eventos de varios subIds, pase un objeto de agente de escucha independiente a cada objeto TelephonyManager creado con #createForSubscriptionId
.
Nota: si llama a este método mientras se encuentra en medio de una transacción del enlazador, <debe llamar android.os.Binder#clearCallingIdentity()
a< b>/b> antes de llamar a este método. De SecurityException
lo contrario, se producirá una excepción .
Esta API debe usarse con moderación: un gran número de agentes de escucha provocará inestabilidad del sistema. Si un proceso ha registrado demasiados agentes de escucha sin anular el registro, puede encontrarse con un IllegalStateException
al intentar registrar más agentes de escucha.
Este miembro está en desuso. Use #registerTelephonyCallback(Executor, TelephonyCallback)
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.