語言

TelephonyManager.SetSignalStrengthUpdateRequest 方法

定義

命名空間:
Android.Telephony
組件:
Mono.Android.dll

設定 a 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

將 SignalStrengthUpdateRequest 設定到系統中

屬性
RegisterAttribute RequiresPermissionAttribute

備註

設定 a SignalStrengthUpdateRequest 在訊號品質測量超過指定閾值時接收通知。

要收到通知，請設定訊號強度更新請求，然後透過 註冊TelephonyCallback實作TelephonyCallback.SignalStrengthsListener#registerTelephonyCallback。 通知將透過 TelephonyCallback.SignalStrengthsListener#onSignalStrengthsChanged(SignalStrength)。

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

系統會清理 SignalStrengthUpdateRequest 如果呼叫程序在未呼叫 #clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest)時死掉。

如果這個 TelephonyManager 物件是以 所建立，則該 subID 會被建立 #createForSubscriptionId。 否則，適用於 SubscriptionManager#getDefaultSubscriptionId()。 若要請求多個 subId，請將請求物件傳遞給每個以 S #createForSubscriptionId建立的 TelephonyManager 物件。

需要權限： android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE 或呼叫應用程式擁有運營商權限（參見 TelephonyManager#hasCarrierPrivileges）。

請注意，請求中的閾值將以盡力而為（best-effort）方式使用;系統可能會修改請求以多工多個請求來源或優化功耗。 來電者不應期待收到完全相同的通知閾值。

Java 文件 android.telephony.TelephonyManager.setSignalStrengthUpdateRequest(android.telephony.SignalStrengthUpdateRequest)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於