Sprache

TelephonyManager.RegisterTelephonyCallback Methode

Definition

Ü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.

Java Dokumentation für android.telephony.TelephonyManager.registerTelephonyCallback(java.util.concurrent.Executor, android.telephony.TelephonyCallback).

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.

Java Dokumentation für android.telephony.TelephonyManager.registerTelephonyCallback(int, java.util.concurrent.Executor, android.telephony.TelephonyCallback).

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: