語言

TelephonyManager.RegisterTelephonyCallback 方法

定義

多載

名稱 Description
RegisterTelephonyCallback(IExecutor, TelephonyCallback)

註冊回撥物件以接收指定電話狀態變更的通知。

RegisterTelephonyCallback(Int32, IExecutor, TelephonyCallback)

註冊回撥物件以接收指定電話狀態變更的通知。

RegisterTelephonyCallback(IExecutor, TelephonyCallback)

註冊回撥物件以接收指定電話狀態變更的通知。

[Android.Runtime.Register("registerTelephonyCallback", "(Ljava/util/concurrent/Executor;Landroid/telephony/TelephonyCallback;)V", "GetRegisterTelephonyCallback_Ljava_util_concurrent_Executor_Landroid_telephony_TelephonyCallback_Handler", ApiSince=31)]
public virtual void RegisterTelephonyCallback(Java.Util.Concurrent.IExecutor executor, Android.Telephony.TelephonyCallback callback);
[<Android.Runtime.Register("registerTelephonyCallback", "(Ljava/util/concurrent/Executor;Landroid/telephony/TelephonyCallback;)V", "GetRegisterTelephonyCallback_Ljava_util_concurrent_Executor_Landroid_telephony_TelephonyCallback_Handler", ApiSince=31)>]
abstract member RegisterTelephonyCallback : Java.Util.Concurrent.IExecutor * Android.Telephony.TelephonyCallback -> unit
override this.RegisterTelephonyCallback : Java.Util.Concurrent.IExecutor * Android.Telephony.TelephonyCallback -> unit

參數

executor
IExecutor

是回調執行點。

callback
TelephonyCallback

TelephonyCallback要登記的對象。 來電者應該持有回撥的參考。 這個框架只保留一個弱參照。

屬性

備註

註冊回撥物件以接收指定電話狀態變更的通知。

要註冊回調,傳送 a TelephonyCallback 以實作事件介面。 例如,FakeServiceStateCallback 擴充 TelephonyCallback 了實 TelephonyCallback.ServiceStateListener作。

在註冊時,當指定的電話狀態改變時,電話管理器會在回撥物件上呼叫適當的回調方法,並傳遞目前(更新後)的值。

注意:請注意你所實施的聽眾所規定 TelephonyCallback 的權限要求。 你的應用程式必須獲得這些權限才能註冊 a,而 a TelephonyCallback 需要這些權限;如果你未持有所有SecurityException監聽者的所需權限,a TelephonyCallback 將會被拋棄。

如果這個 TelephonyManager 物件是以 所建立,則該 subID 會被建立 #createForSubscriptionId。 否則,適用於 SubscriptionManager#getDefaultSubscriptionId()。 若要為多個子 ID 註冊事件,請將一個獨立的回調物件傳給每個用 S #createForSubscriptionId建立的 TelephonyManager 物件。

注意:如果你在綁定器交易中呼叫此方法,必須<先 b>< 或 b> 呼叫android.os.Binder#clearCallingIdentity(),然後才呼叫此方法。 SecurityException否則A會被擲出。

此 API 應謹慎使用——大量回調會導致系統不穩定。 如果程序註冊了太多回調卻未取消註冊,嘗試註冊更多回調時可能會遇到 。IllegalStateException

Java 文件 android.telephony.TelephonyManager.registerTelephonyCallback(java.util.concurrent.Executor, android.telephony.TelephonyCallback)。

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

適用於

RegisterTelephonyCallback(Int32, IExecutor, TelephonyCallback)

註冊回撥物件以接收指定電話狀態變更的通知。

[Android.Runtime.Register("registerTelephonyCallback", "(ILjava/util/concurrent/Executor;Landroid/telephony/TelephonyCallback;)V", "GetRegisterTelephonyCallback_ILjava_util_concurrent_Executor_Landroid_telephony_TelephonyCallback_Handler", ApiSince=33)]
public virtual void RegisterTelephonyCallback(int includeLocationData, Java.Util.Concurrent.IExecutor executor, Android.Telephony.TelephonyCallback callback);
[<Android.Runtime.Register("registerTelephonyCallback", "(ILjava/util/concurrent/Executor;Landroid/telephony/TelephonyCallback;)V", "GetRegisterTelephonyCallback_ILjava_util_concurrent_Executor_Landroid_telephony_TelephonyCallback_Handler", ApiSince=33)>]
abstract member RegisterTelephonyCallback : int * Java.Util.Concurrent.IExecutor * Android.Telephony.TelephonyCallback -> unit
override this.RegisterTelephonyCallback : int * Java.Util.Concurrent.IExecutor * Android.Telephony.TelephonyCallback -> unit

參數

includeLocationData
Int32

指定來電者是否希望接收與位置相關的資訊。

executor
IExecutor

是回調執行點。

callback
TelephonyCallback

TelephonyCallback要登記的對象。 來電者應該持有回撥的參考。 這個框架只保留一個弱參照。

屬性

備註

註冊回撥物件以接收指定電話狀態變更的通知。

要註冊回調,傳送 a TelephonyCallback 以實作事件介面。 例如,FakeServiceStateCallback 擴充 TelephonyCallback 了實 TelephonyCallback.ServiceStateListener作。

在註冊時,當指定的電話狀態改變時,電話管理器會在回撥物件上呼叫適當的回調方法,並傳遞目前(更新後)的值。

如果這個 TelephonyManager 物件是以 所建立,則該 subID 會被建立 #createForSubscriptionId。 否則,適用於 SubscriptionManager#getDefaultSubscriptionId()。 若要為多個子 ID 註冊事件,請將一個獨立的回調物件傳給每個用 S #createForSubscriptionId建立的 TelephonyManager 物件。

注意:如果你在綁定器交易中呼叫此方法,必須<先 b>< 或 b> 呼叫android.os.Binder#clearCallingIdentity(),然後才呼叫此方法。 SecurityException否則A會被擲出。

此 API 應謹慎使用——大量回調會導致系統不穩定。 如果程序註冊了太多回調卻未取消註冊,嘗試註冊更多回調時可能會遇到 。IllegalStateException

還有另一種用自訂上下文 AttributionSource.Builder#setRenouncedPermissions(Set<String>) 放棄權限的方法,但只限於系統應用程式。 為避免混淆,呼叫此方法會取代放棄權限並設定自訂上下文。

Java 文件 android.telephony.TelephonyManager.registerTelephonyCallback(int, java.util.concurrent.Executor, android.telephony.TelephonyCallback)。

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

適用於