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_旗標的 PhoneStateListener 位 OR 組合。

屬性

RegisterAttribute

備註

註冊接聽程序物件，以接收指定電話語音狀態中變更的通知。

若要註冊接聽程式，請在 events 自變數中傳遞 PhoneStateListener 並指定至少一個感興趣的電話語音狀態。

在註冊時，當指定的電話語音狀態變更時，電話語音管理員會在接聽程式物件上叫用適當的回呼方法，並傳遞目前的 （updated） 值。

若要取消註冊接聽程式，請傳遞接聽程序物件，並將 events 自變數設定為 PhoneStateListener#LISTEN_NONE LISTEN_NONE （0）。

如果這個 TelephonyManager 物件已使用 #createForSubscriptionId建立，則會套用至指定的 subId。 否則，會套用至 SubscriptionManager#getDefaultSubscriptionId()。 若要接聽多個 subId 的事件，請將個別接聽程式對象傳遞至使用 #createForSubscriptionId建立的每個 TelephonyManager 物件。

注意：如果您在系結器交易中間呼叫此方法，則在呼叫此方法之前，您<必須先></b> 呼叫 android.os.Binder#clearCallingIdentity() 。 SecurityException否則會擲回 。

此 API 應該謹慎使用 -- 大量接聽程式會導致系統不穩定。 如果行程已註冊太多接聽程式，但未取消註冊接聽程式，則嘗試註冊更多接聽程式時可能會遇到 IllegalStateException 。

已取代這個成員。 使用 #registerTelephonyCallback(Executor, TelephonyCallback)。

的 android.telephony.TelephonyManager.listen(android.telephony.PhoneStateListener, int)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。