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

システムに設定する SignalStrengthUpdateRequest

属性

RegisterAttribute RequiresPermissionAttribute

注釈

SignalStrengthUpdateRequest信号品質測定が指定されたしきい値を超えたときに通知を受信するように を設定します。

通知を受け取るために、シグナル強度更新要求を設定し、 にPhoneStateListener#LISTEN_SIGNAL_STRENGTHS登録TelephonyManager#listen(PhoneStateListener, int)します。 通知は を介して PhoneStateListener#onSignalStrengthsChanged(SignalStrength)到着します。

指定したしきい値を超える通知の受信を停止するには、同じ SignalStrengthUpdateRequest オブジェクトを に #clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest)渡します。

呼び出し元プロセスが を呼び出#clearSignalStrengthUpdateRequest(SignalStrengthUpdateRequest)さずに終了した場合、システムは をSignalStrengthUpdateRequestクリーンします。

このテレフォニーManager オブジェクトが で #createForSubscriptionId作成されている場合は、指定された subId に適用されます。 それ以外の場合は、 に適用 SubscriptionManager#getDefaultSubscriptionId()されます。 複数の subId を要求するには、 で作成された各テレフォニーマネージャー オブジェクトに要求オブジェクトを #createForSubscriptionId渡します。

アクセス許可が必要です。 android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE または、呼び出し元アプリに通信事業者特権があることを示します (「」を参照)。TelephonyManager#hasCarrierPrivileges

要求のしきい値はベスト エフォートベースで使用されることに注意してください。システムは、さまざまな要求ソースを多重化したり、電力消費を最適化したりするために要求を変更できます。 呼び出し元は、まったく同じしきい値で通知を受け取ることを想定しないでください。

の Java ドキュメント android.telephony.TelephonyManager.setSignalStrengthUpdateRequest(android.telephony.SignalStrengthUpdateRequest)。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。