TelephonyManager.Listen(PhoneStateListener, PhoneStateListenerFlags) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Registra un oggetto listener per ricevere la notifica delle modifiche negli stati di telefonia specificati.
[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 -> unitParametri
- listener
- PhoneStateListener
Oggetto PhoneStateListener da registrare (o annullare la registrazione)
- events
- PhoneStateListenerFlags
Gli stati di interesse per il listener di telefonia, come combinazione bit per bit OR di PhoneStateListener flag LISTEN_.
- Attributi
Commenti
Registra un oggetto listener per ricevere la notifica delle modifiche negli stati di telefonia specificati.
Per registrare un listener, passare un PhoneStateListener oggetto e specificare almeno uno stato di interesse per la telefonia nell'argomento eventi.
Al momento della registrazione e quando cambia uno stato di telefonia specificato, il gestore di telefonia richiama il metodo di callback appropriato sull'oggetto listener e passa i valori correnti (aggiornati).
Per annullare la registrazione di un listener, passare l'oggetto listener e impostare l'argomento eventi su PhoneStateListener#LISTEN_NONE LISTEN_NONE (0).
Se questo oggetto TelephonyManager è stato creato con #createForSubscriptionId, si applica al subId specificato. In caso contrario, si applica a SubscriptionManager#getDefaultSubscriptionId(). Per ascoltare gli eventi per più subId, passare un oggetto listener separato a ogni oggetto TelephonyManager creato con #createForSubscriptionId.
Nota: se si chiama questo metodo mentre si trova al centro di una transazione del gestore di associazione, è <necessario/b> chiamare il>metodo prima di chiamare android.os.Binder#clearCallingIdentity()<questo metodo. Verrà generata un'eccezione SecurityException in caso contrario.
Questa API deve essere usata con moderazione: un numero elevato di listener causerà un'instabilità del sistema. Se un processo ha registrato troppi listener senza annullare la registrazione, potrebbe verificarsi quando IllegalStateException si tenta di registrare più listener.
Questo membro è deprecato. Usare #registerTelephonyCallback(Executor, TelephonyCallback).
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.