TelephonyManager.RegisterTelephonyCallback 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.
Overload
| Nome | Descrizione |
|---|---|
| RegisterTelephonyCallback(IExecutor, TelephonyCallback) |
Registra un oggetto callback per ricevere la notifica delle modifiche negli stati di telefonia specificati. |
| RegisterTelephonyCallback(Int32, IExecutor, TelephonyCallback) |
Registra un oggetto callback per ricevere la notifica delle modifiche negli stati di telefonia specificati. |
RegisterTelephonyCallback(IExecutor, TelephonyCallback)
Registra un oggetto callback per ricevere la notifica delle modifiche negli stati di telefonia specificati.
[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
Parametri
- executor
- IExecutor
Executor di in cui verrà eseguito il callback.
- callback
- TelephonyCallback
Oggetto TelephonyCallback da registrare. Il chiamante deve contenere un riferimento al callback. Il framework contiene solo un riferimento debole.
- Attributi
Commenti
Registra un oggetto callback per ricevere la notifica delle modifiche negli stati di telefonia specificati.
Per registrare un callback, passare un oggetto TelephonyCallback che implementa interfacce di eventi. Ad esempio, FakeServiceStateCallback estende TelephonyCallback implementa TelephonyCallback.ServiceStateListener.
Al momento della registrazione e quando cambia uno stato di telefonia specificato, il gestore di telefonia richiama il metodo di callback appropriato sull'oggetto callback e passa i valori correnti (aggiornati).
Nota: tenere presente i requisiti di autorizzazione indicati nei TelephonyCallback listener implementati. All'applicazione devono essere concesse queste autorizzazioni per registrare un oggetto TelephonyCallback che li richiede. Se non si dispone delle autorizzazioni necessarie per tutti i SecurityException listener implementati, verrà generata un'eccezione TelephonyCallback .
Se questo oggetto TelephonyManager è stato creato con #createForSubscriptionId, si applica al subId specificato. In caso contrario, si applica a SubscriptionManager#getDefaultSubscriptionId(). Per registrare gli eventi per più subId, passare un oggetto callback 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 callback causerà un'instabilità del sistema. Se un processo ha registrato un numero eccessivo di callback senza annullare la registrazione, potrebbe verificarsi quando IllegalStateException si tenta di registrare più callback.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.
Si applica a
RegisterTelephonyCallback(Int32, IExecutor, TelephonyCallback)
Registra un oggetto callback per ricevere la notifica delle modifiche negli stati di telefonia specificati.
[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
Parametri
- includeLocationData
- Int32
Specifica se il chiamante desidera ricevere informazioni correlate alla posizione.
- executor
- IExecutor
Executor di in cui verrà eseguito il callback.
- callback
- TelephonyCallback
Oggetto TelephonyCallback da registrare. Il chiamante deve contenere un riferimento al callback. Il framework contiene solo un riferimento debole.
- Attributi
Commenti
Registra un oggetto callback per ricevere la notifica delle modifiche negli stati di telefonia specificati.
Per registrare un callback, passare un oggetto TelephonyCallback che implementa interfacce di eventi. Ad esempio, FakeServiceStateCallback estende TelephonyCallback implementa TelephonyCallback.ServiceStateListener.
Al momento della registrazione e quando cambia uno stato di telefonia specificato, il gestore di telefonia richiama il metodo di callback appropriato sull'oggetto callback e passa i valori correnti (aggiornati).
Se questo oggetto TelephonyManager è stato creato con #createForSubscriptionId, si applica al subId specificato. In caso contrario, si applica a SubscriptionManager#getDefaultSubscriptionId(). Per registrare gli eventi per più subId, passare un oggetto callback 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 callback causerà un'instabilità del sistema. Se un processo ha registrato un numero eccessivo di callback senza annullare la registrazione, potrebbe verificarsi quando IllegalStateException si tenta di registrare più callback.
Esiste un altro modo per rinunciare alle autorizzazioni con un contesto AttributionSource.Builder#setRenouncedPermissions(Set<String>) personalizzato, ma solo per le app di sistema. Per evitare confusione, la chiamata a questo metodo sostituisce la rinuncia alle autorizzazioni con un contesto personalizzato.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.