TelephonyManager.SetSignalStrengthUpdateRequest メソッド

[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

パラメーター

属性

RegisterAttribute RequiresPermissionAttribute

注釈

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

通知を受け取るために、シグナル強度更新要求を設定し、#registerTelephonyCallbackを介してTelephonyCallback.SignalStrengthsListenerを実装するTelephonyCallbackを登録します。 通知は TelephonyCallback.SignalStrengthsListener#onSignalStrengthsChanged(SignalStrength)経由で到着します。

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

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

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

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

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

Javaドキュメント。

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