TelephonyManager.SetSignalStrengthUpdateRequest 方法

定义

命名空间:

Android.Telephony

程序集:

Mono.Android.dll

设置在 SignalStrengthUpdateRequest 信号质量度量违反指定阈值时接收通知。

[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

参数

request

SignalStrengthUpdateRequest

要设置为 System 的 SignalStrengthUpdateRequest

属性

RegisterAttribute RequiresPermissionAttribute

注解

设置在 SignalStrengthUpdateRequest 信号质量度量违反指定阈值时接收通知。

若要收到通知，请设置信号强度更新请求，然后注册TelephonyManager#listen(PhoneStateListener, int)。PhoneStateListener#LISTEN_SIGNAL_STRENGTHS 通知将通过 PhoneStateListener#onSignalStrengthsChanged(SignalStrength)。

若要停止接收超过指定阈值的通知，请将同一 SignalStrengthUpdateRequest 对象传递给 #clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest)。

如果调用方进程在未调用#clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest)的情况下死亡，SignalStrengthUpdateRequest系统将清理该进程。

如果已使用此 #createForSubscriptionIdTelephonyManager 对象创建，则适用于给定的 subId。 否则，适用于 SubscriptionManager#getDefaultSubscriptionId(). 若要请求多个 subId，请将请求对象传递给创建 #createForSubscriptionId的每个 TelephonyManager 对象。

需要权限： android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE 或调用应用具有运营商权限（请参阅 TelephonyManager#hasCarrierPrivileges）。

请注意，请求中的阈值将尽最大努力使用：系统可以修改对多路复用各种请求源的请求，或优化能耗。 调用方不应收到完全相同的阈值的通知。

适用于 . 的 android.telephony.TelephonyManager.setSignalStrengthUpdateRequest(android.telephony.SignalStrengthUpdateRequest)Java 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。