TelephonyManager.RegisterTelephonyCallback 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | 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
本頁部分內容為基於 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>) 放棄權限的方法,但只限於系統應用程式。 為避免混淆,呼叫此方法會取代放棄權限並設定自訂上下文。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。