Freigeben über


TelephonyManager.SetSignalStrengthUpdateRequest Methode

Definition

Legen Sie eine Benachrichtigung zum Empfangen fest SignalStrengthUpdateRequest , wenn Signalqualitätsmessungen die angegebenen Schwellenwerte verletzen.

[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

Parameter

request
SignalStrengthUpdateRequest

signalStrengthUpdateRequest, das im System festgelegt werden soll

Attribute

Hinweise

Legen Sie eine Benachrichtigung zum Empfangen fest SignalStrengthUpdateRequest , wenn Signalqualitätsmessungen die angegebenen Schwellenwerte verletzen.

Um benachrichtigt zu werden, legen Sie die Anforderung zur Aktualisierung der Signalstärke fest, und registrieren Sie TelephonyManager#listen(PhoneStateListener, int) sich dann bei PhoneStateListener#LISTEN_SIGNAL_STRENGTHS. Die Benachrichtigung wird durch PhoneStateListener#onSignalStrengthsChanged(SignalStrength).

Um den Empfang der Benachrichtigung über die angegebenen Schwellenwerte zu beenden, übergeben Sie dasselbe SignalStrengthUpdateRequest Objekt an #clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest).

Das System bereinigt den SignalStrengthUpdateRequest Vorgang, wenn der Aufrufervorgang ohne Aufruf #clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest)gestorben ist.

Wenn dieses TelefonyManager -Objekt mit #createForSubscriptionIderstellt wurde , gilt für die angegebene SubId. Andernfalls gilt für SubscriptionManager#getDefaultSubscriptionId(). Um mehrere SubIds anzufordern, übergeben Sie ein Anforderungsobjekt an jedes telefonyManager-Objekt, das mit #createForSubscriptionId.

Erfordert Die Berechtigung: android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE oder die aufrufende App verfügt über Netzbetreiberberechtigungen (siehe TelephonyManager#hasCarrierPrivileges).

Beachten Sie, dass die Schwellenwerte in der Anforderung auf best-effort-Basis verwendet werden; Das System kann Anforderungen an multiplex verschiedene Anforderungsquellen ändern oder den Stromverbrauch optimieren. Der Anrufer sollte nicht erwarten, dass er mit genau den gleichen Schwellenwerten benachrichtigt wird.

Java-Dokumentation für android.telephony.TelephonyManager.setSignalStrengthUpdateRequest(android.telephony.SignalStrengthUpdateRequest).

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.

Gilt für: