TelephonyManager.RegisterTelephonyCallback メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| Name | 説明 |
|---|---|
| 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
コールバックが実行される場所の Executor。
- callback
- TelephonyCallback
登録する TelephonyCallback オブジェクト。 呼び出し元はコールバックへの参照を保持する必要があります。 フレームワークは弱い参照のみを保持します。
- 属性
注釈
指定されたテレフォニー状態の変更の通知を受信するコールバック オブジェクトを登録します。
コールバックを登録するには、イベントのインターフェイスを実装する TelephonyCallback を渡します。 たとえば、FakeServiceStateCallback はTelephonyCallbackを実装TelephonyCallback.ServiceStateListener拡張します。
登録時に、指定されたテレフォニー状態が変更されると、テレフォニー マネージャーはコールバック オブジェクトに対して適切なコールバック メソッドを呼び出し、現在の (更新された) 値を渡します。
注: 実装する TelephonyCallback リスナーに記載されているアクセス許可の要件に注意してください。 アプリケーションを必要とするTelephonyCallbackを登録するには、これらのアクセス許可をアプリケーションに付与する必要があります。実装するすべてのSecurityException リスナーに必要なアクセス許可を保持していない場合、TelephonyCallbackがスローされます。
このテレフォニーマネージャー オブジェクトが #createForSubscriptionIdで作成されている場合は、指定された subId に適用されます。 それ以外の場合は、 SubscriptionManager#getDefaultSubscriptionId()に適用されます。 複数の subId のイベントを登録するには、 #createForSubscriptionIdで作成された各テレフォニー マネージャー オブジェクトに個別のコールバック オブジェクトを渡します。
注: バインダー・トランザクションの途中でこのメソッドを呼び出した場合、このメソッドを呼び出す前に <b>must</b> 呼び出し android.os.Binder#clearCallingIdentity() 。 それ以外の場合は、 SecurityException がスローされます。
この API は慎重に使用する必要があります。多数のコールバックによってシステムが不安定になります。 登録を解除せずに登録したコールバックが多すぎる場合は、コールバックを追加登録しようとしたときに IllegalStateException が発生する可能性があります。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
適用対象
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
コールバックが実行される場所の Executor。
- callback
- TelephonyCallback
登録する TelephonyCallback オブジェクト。 呼び出し元はコールバックへの参照を保持する必要があります。 フレームワークは弱い参照のみを保持します。
- 属性
注釈
指定されたテレフォニー状態の変更の通知を受信するコールバック オブジェクトを登録します。
コールバックを登録するには、イベントのインターフェイスを実装する TelephonyCallback を渡します。 たとえば、FakeServiceStateCallback はTelephonyCallbackを実装TelephonyCallback.ServiceStateListener拡張します。
登録時に、指定されたテレフォニー状態が変更されると、テレフォニー マネージャーはコールバック オブジェクトに対して適切なコールバック メソッドを呼び出し、現在の (更新された) 値を渡します。
このテレフォニーマネージャー オブジェクトが #createForSubscriptionIdで作成されている場合は、指定された subId に適用されます。 それ以外の場合は、 SubscriptionManager#getDefaultSubscriptionId()に適用されます。 複数の subId のイベントを登録するには、 #createForSubscriptionIdで作成された各テレフォニー マネージャー オブジェクトに個別のコールバック オブジェクトを渡します。
注: バインダー・トランザクションの途中でこのメソッドを呼び出した場合、このメソッドを呼び出す前に <b>must</b> 呼び出し android.os.Binder#clearCallingIdentity() 。 それ以外の場合は、 SecurityException がスローされます。
この API は慎重に使用する必要があります。多数のコールバックによってシステムが不安定になります。 登録を解除せずに登録したコールバックが多すぎる場合は、コールバックを追加登録しようとしたときに IllegalStateException が発生する可能性があります。
カスタム コンテキスト AttributionSource.Builder#setRenouncedPermissions(Set<String>) を使用してアクセス許可を放棄する別の方法がありますが、これはシステム アプリに対してのみ行われます。 混乱を避けるために、このメソッドを呼び出すと、カスタム コンテキストによる権限の放棄よりも優先されます。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。