TelephonyManager.Listen(PhoneStateListener, PhoneStateListenerFlags) メソッド

定義

名前空間:

Android.Telephony

アセンブリ:

Mono.Android.dll

指定されたテレフォニー状態の変更の通知を受信するリスナー オブジェクトを登録します。

[Android.Runtime.Register("listen", "(Landroid/telephony/PhoneStateListener;I)V", "GetListen_Landroid_telephony_PhoneStateListener_IHandler")]
public virtual void Listen (Android.Telephony.PhoneStateListener? listener, Android.Telephony.PhoneStateListenerFlags events);

[<Android.Runtime.Register("listen", "(Landroid/telephony/PhoneStateListener;I)V", "GetListen_Landroid_telephony_PhoneStateListener_IHandler")>]
abstract member Listen : Android.Telephony.PhoneStateListener * Android.Telephony.PhoneStateListenerFlags -> unit
override this.Listen : Android.Telephony.PhoneStateListener * Android.Telephony.PhoneStateListenerFlags -> unit

パラメーター

listener

PhoneStateListener

PhoneStateListener登録 (または登録解除) するオブジェクト

events

PhoneStateListenerFlags

LISTEN_ フラグのビットごとの OR の組み合わせとして、リスナーが関心を持つテレフォニーの PhoneStateListener 状態。

属性

RegisterAttribute

注釈

指定されたテレフォニー状態の変更の通知を受信するリスナー オブジェクトを登録します。

リスナーを登録するには、イベント引数に PhoneStateListener 少なくとも 1 つのテレフォニー状態を渡して指定します。

登録時に、指定されたテレフォニー状態が変更されると、テレフォニー マネージャーはリスナー オブジェクトに対して適切なコールバック メソッドを呼び出し、現在の (更新された) 値を渡します。

リスナーの登録を解除するには、リスナー オブジェクトを渡し、events 引数を (0) に PhoneStateListener#LISTEN_NONE LISTEN_NONE 設定します。

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

注: バインダー・トランザクションの途中でこのメソッドを呼び出す場合は、<このメソッドを呼び出す前に b>を呼び出android.os.Binder#clearCallingIdentity()す必要があります<>。 それ以外の場合は、A SecurityException がスローされます。

この API は慎重に使用する必要があります。リスナーの数が多い場合、システムが不安定になります。 登録を解除せずに登録したリスナーが多すぎる場合は、リスナーを追加登録しようとすると発生 IllegalStateException する可能性があります。

このメンバーは非推奨です。 #registerTelephonyCallback(Executor, TelephonyCallback) を使用してください。

の Java ドキュメントandroid.telephony.TelephonyManager.listen(android.telephony.PhoneStateListener, int)

このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。