TelephonyManager.Listen(PhoneStateListener, PhoneStateListenerFlags) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Registriert ein Listenerobjekt, um Benachrichtigungen über Änderungen in bestimmten Telefoniezuständen zu erhalten.
[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 -> unitParameter
- listener
- PhoneStateListener
Das PhoneStateListener objekt, das registriert werden soll (oder die Registrierung aufheben)
- events
- PhoneStateListenerFlags
Der Telefoniezustand(n) von Interesse für den Listener, als bitweise ODER Kombination aus PhoneStateListener LISTEN_ Flags.
- Attribute
Hinweise
Registriert ein Listenerobjekt, um Benachrichtigungen über Änderungen in bestimmten Telefoniezuständen zu erhalten.
Um einen Listener zu registrieren, übergeben Sie einen PhoneStateListener Telefoniestatus, und geben Sie mindestens einen Telefoniestatus an, der für das Ereignisargument von Interesse ist.
Bei der Registrierung und beim Ändern eines angegebenen Telefoniezustands ruft der Telefoniemanager die entsprechende Rückrufmethode für das Listenerobjekt auf und übergibt die aktuellen (aktualisierten) Werte.
Um die Registrierung eines Listeners aufzuheben, übergeben Sie das Listenerobjekt, und legen Sie das Ereignisargument auf PhoneStateListener#LISTEN_NONE LISTEN_NONE (0) fest.
Wenn dieses TelefonyManager -Objekt mit #createForSubscriptionIderstellt wurde , gilt für die angegebene SubId. Andernfalls gilt für SubscriptionManager#getDefaultSubscriptionId(). Um Ereignisse für mehrere SubIds zu überwachen, übergeben Sie ein separates Listenerobjekt an jedes telefonyManager-Objekt, das mit #createForSubscriptionId.
Hinweis: Wenn Sie diese Methode während einer Sammelmappentransaktion aufrufen, müssen< Sie <b>/b> aufrufenandroid.os.Binder#clearCallingIdentity(), bevor Sie diese Methode aufrufen. Andernfalls wird ein SecurityException Fehler ausgelöst.
Diese API sollte sparsam verwendet werden – große Anzahl von Listenern führt zu Systeminstabilität. Wenn ein Prozess zu viele Listener registriert hat, ohne die Registrierung aufzuheben, tritt möglicherweise ein IllegalStateException Fehler auf, wenn versucht wird, weitere Listener zu registrieren.
Dieses Mitglied ist veraltet. Verwenden Sie #registerTelephonyCallback(Executor, TelephonyCallback).
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.