TelephonyManager.RegisterTelephonyCallback 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.
Überlädt
| Name | Beschreibung |
|---|---|
| RegisterTelephonyCallback(IExecutor, TelephonyCallback) |
Registriert ein Rückrufobjekt, um Benachrichtigungen über Änderungen in bestimmten Telefoniezuständen zu erhalten. |
| RegisterTelephonyCallback(Int32, IExecutor, TelephonyCallback) |
Registriert ein Rückrufobjekt, um Benachrichtigungen über Änderungen in bestimmten Telefoniezuständen zu erhalten. |
RegisterTelephonyCallback(IExecutor, TelephonyCallback)
Registriert ein Rückrufobjekt, um Benachrichtigungen über Änderungen in bestimmten Telefoniezuständen zu erhalten.
[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
Parameter
- executor
- IExecutor
Der Ausführungsausführer, an dem der Rückruf ausgeführt wird.
- callback
- TelephonyCallback
Das TelephonyCallback zu registrierende Objekt. Der Aufrufer sollte einen Verweis auf den Rückruf enthalten. Das Framework enthält nur einen schwachen Verweis.
- Attribute
Hinweise
Registriert ein Rückrufobjekt, um Benachrichtigungen über Änderungen in bestimmten Telefoniezuständen zu erhalten.
Um einen Rückruf zu registrieren, übergeben Sie eine TelephonyCallback Schnittstelle von Ereignissen. Beispielsweise erweitert TelephonyCallback FakeServiceStateCallback Implementierungen TelephonyCallback.ServiceStateListener.
Bei der Registrierung und beim Ändern eines angegebenen Telefoniezustands ruft der Telefoniemanager die entsprechende Rückrufmethode für das Rückrufobjekt auf und übergibt die aktuellen (aktualisierten) Werte.
Hinweis: Beachten Sie die Berechtigungsanforderungen, die für die TelephonyCallback von Ihnen implementierten Listener angegeben sind. Ihre Anwendung muss diese Berechtigungen erhalten, um sie TelephonyCallback zu registrieren, für die sie erforderlich sind. Eine SecurityException wird ausgelöst, wenn Sie nicht die erforderlichen Berechtigungen für alle TelephonyCallback von Ihnen implementierten Listener besitzen.
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 registrieren, übergeben Sie ein separates Rückrufobjekt 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 Rückrufen führt zu Systeminstabilität. Wenn ein Prozess zu viele Rückrufe registriert hat, ohne die Registrierung aufzuheben, tritt möglicherweise ein IllegalStateException Fehler auf, wenn versucht wird, weitere Rückrufe zu registrieren.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.
Gilt für:
RegisterTelephonyCallback(Int32, IExecutor, TelephonyCallback)
Registriert ein Rückrufobjekt, um Benachrichtigungen über Änderungen in bestimmten Telefoniezuständen zu erhalten.
[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
Parameter
- includeLocationData
- Int32
Gibt an, ob der Anrufer standortbezogene Informationen empfangen möchte.
- executor
- IExecutor
Der Ausführungsausführer, an dem der Rückruf ausgeführt wird.
- callback
- TelephonyCallback
Das TelephonyCallback zu registrierende Objekt. Der Aufrufer sollte einen Verweis auf den Rückruf enthalten. Das Framework enthält nur einen schwachen Verweis.
- Attribute
Hinweise
Registriert ein Rückrufobjekt, um Benachrichtigungen über Änderungen in bestimmten Telefoniezuständen zu erhalten.
Um einen Rückruf zu registrieren, übergeben Sie eine TelephonyCallback Schnittstelle von Ereignissen. Beispielsweise erweitert TelephonyCallback FakeServiceStateCallback Implementierungen TelephonyCallback.ServiceStateListener.
Bei der Registrierung und beim Ändern eines angegebenen Telefoniezustands ruft der Telefoniemanager die entsprechende Rückrufmethode für das Rückrufobjekt auf und übergibt die aktuellen (aktualisierten) Werte.
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 registrieren, übergeben Sie ein separates Rückrufobjekt 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 Rückrufen führt zu Systeminstabilität. Wenn ein Prozess zu viele Rückrufe registriert hat, ohne die Registrierung aufzuheben, tritt möglicherweise ein IllegalStateException Fehler auf, wenn versucht wird, weitere Rückrufe zu registrieren.
Es gibt eine andere Möglichkeit, Berechtigungen mit einem benutzerdefinierten Kontext AttributionSource.Builder#setRenouncedPermissions(Set<String>) zurückzugeben, aber nur für System-Apps. Um Verwirrung zu vermeiden, ersetzt das Aufrufen dieser Methode das Entfernen von Berechtigungen mit einem benutzerdefinierten Kontext.
Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.