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 以在訊號質量測量違反指定的臨界值時接收通知。

若要收到通知，請設定訊號強度更新要求，然後向 PhoneStateListener#LISTEN_SIGNAL_STRENGTHS註冊TelephonyManager#listen(PhoneStateListener, int)。 通知會透過 PhoneStateListener#onSignalStrengthsChanged(SignalStrength)抵達。

若要停止接收超過指定閾值的通知，請將相同的 SignalStrengthUpdateRequest 物件傳遞至 #clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest)。

如果呼叫端行程在沒有呼叫 #clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest)的情況下死亡，系統會清除 SignalStrengthUpdateRequest 。

如果這個 TelephonyManager 物件已使用 #createForSubscriptionId建立，則會套用至指定的 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 屬性授權中所述的詞彙使用。