TelephonyManager.SetSignalStrengthUpdateRequest 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.
Impostare un SignalStrengthUpdateRequest
oggetto per ricevere una notifica quando le misurazioni della qualità del segnale violano le soglie specificate.
[Android.Runtime.Register("setSignalStrengthUpdateRequest", "(Landroid/telephony/SignalStrengthUpdateRequest;)V", "GetSetSignalStrengthUpdateRequest_Landroid_telephony_SignalStrengthUpdateRequest_Handler", ApiSince=31)]
[Android.Runtime.RequiresPermission("android.permission.MODIFY_PHONE_STATE")]
public virtual void SetSignalStrengthUpdateRequest (Android.Telephony.SignalStrengthUpdateRequest request);
[<Android.Runtime.Register("setSignalStrengthUpdateRequest", "(Landroid/telephony/SignalStrengthUpdateRequest;)V", "GetSetSignalStrengthUpdateRequest_Landroid_telephony_SignalStrengthUpdateRequest_Handler", ApiSince=31)>]
[<Android.Runtime.RequiresPermission("android.permission.MODIFY_PHONE_STATE")>]
abstract member SetSignalStrengthUpdateRequest : Android.Telephony.SignalStrengthUpdateRequest -> unit
override this.SetSignalStrengthUpdateRequest : Android.Telephony.SignalStrengthUpdateRequest -> unit
Parametri
- request
- SignalStrengthUpdateRequest
SignalStrengthUpdateRequest da impostare nel sistema
- Attributi
Commenti
Impostare un SignalStrengthUpdateRequest
oggetto per ricevere una notifica quando le misurazioni della qualità del segnale violano le soglie specificate.
Per ricevere una notifica, impostare la richiesta di aggiornamento del livello di segnale e quindi registrarsi TelephonyManager#listen(PhoneStateListener, int)
con PhoneStateListener#LISTEN_SIGNAL_STRENGTHS
. La notifica arriverà tramite PhoneStateListener#onSignalStrengthsChanged(SignalStrength)
.
Per interrompere la ricezione della notifica sulle soglie specificate, passare lo stesso SignalStrengthUpdateRequest
oggetto a #clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest)
.
Il sistema pulisce se SignalStrengthUpdateRequest
il processo del chiamante è morto senza chiamare #clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest)
.
Se questo oggetto TelephonyManager è stato creato con #createForSubscriptionId
, si applica al subId specificato. In caso contrario, si applica a SubscriptionManager#getDefaultSubscriptionId()
. Per richiedere più subId, passare un oggetto richiesta a ogni oggetto TelephonyManager creato con #createForSubscriptionId
.
Richiede l'autorizzazione: android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE
o che l'app chiamante disponga dei privilegi del gestore telefonico (vedere TelephonyManager#hasCarrierPrivileges
).
Si noti che le soglie nella richiesta verranno usate in modo ottimale; il sistema può modificare le richieste a varie origini di richiesta multiplex o per ottimizzare il consumo energetico. Il chiamante non dovrebbe ricevere una notifica con le stesse soglie.
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.