TelephonyManager.RegisterTelephonyCallback Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| Nom | Description |
|---|---|
| RegisterTelephonyCallback(IExecutor, TelephonyCallback) |
Inscrit un objet de rappel pour recevoir la notification des modifications dans les états de téléphonie spécifiés. |
| RegisterTelephonyCallback(Int32, IExecutor, TelephonyCallback) |
Inscrit un objet de rappel pour recevoir la notification des modifications dans les états de téléphonie spécifiés. |
RegisterTelephonyCallback(IExecutor, TelephonyCallback)
Inscrit un objet de rappel pour recevoir la notification des modifications dans les états de téléphonie spécifiés.
[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 -> unitParamètres
- executor
- IExecutor
Exécuteur de l’emplacement d’exécution du rappel.
- callback
- TelephonyCallback
Objet TelephonyCallback à inscrire. L’appelant doit contenir une référence au rappel. Le framework contient uniquement une référence faible.
- Attributs
Remarques
Inscrit un objet de rappel pour recevoir la notification des modifications dans les états de téléphonie spécifiés.
Pour inscrire un rappel, transmettez un TelephonyCallback qui implémente des interfaces d’événements. Par exemple, FakeServiceStateCallback étend les implémentations TelephonyCallbackTelephonyCallback.ServiceStateListener.
Lors de l’inscription et lorsqu’un état de téléphonie spécifié change, le gestionnaire de téléphonie appelle la méthode de rappel appropriée sur l’objet de rappel et transmet les valeurs actuelles (mises à jour).
Remarque : Tenez compte des exigences d’autorisation indiquées sur les TelephonyCallback écouteurs que vous implémentez. Votre application doit disposer de ces autorisations afin d’inscrire un TelephonyCallback élément qui les requiert ; une SecurityException levée sera levée si vous ne détenez pas les autorisations requises pour tous les TelephonyCallback écouteurs que vous implémentez.
Si cet objet TelephonyManager a été créé avec #createForSubscriptionId, s’applique au sous-id donné. Sinon, s’applique à SubscriptionManager#getDefaultSubscriptionId(). Pour inscrire des événements pour plusieurs sous-id, passez un objet de rappel distinct à chaque objet TelephonyManager créé avec #createForSubscriptionId.
Remarque : si vous appelez cette méthode au milieu d’une transaction de classeur, vous<> devez</b> appeler android.os.Binder#clearCallingIdentity() avant d’appeler cette méthode. Une SecurityException sera levée sinon.
Cette API doit être utilisée avec parcimonie : un grand nombre de rappels entraîne une instabilité du système. Si un processus a enregistré trop de rappels sans les désinscrire, il peut rencontrer une IllegalStateException tentative d’inscription d’autres rappels.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.
S’applique à
RegisterTelephonyCallback(Int32, IExecutor, TelephonyCallback)
Inscrit un objet de rappel pour recevoir la notification des modifications dans les états de téléphonie spécifiés.
[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 -> unitParamètres
- includeLocationData
- Int32
Spécifie si l’appelant souhaite recevoir des informations relatives à l’emplacement.
- executor
- IExecutor
Exécuteur de l’emplacement d’exécution du rappel.
- callback
- TelephonyCallback
Objet TelephonyCallback à inscrire. L’appelant doit contenir une référence au rappel. Le framework contient uniquement une référence faible.
- Attributs
Remarques
Inscrit un objet de rappel pour recevoir la notification des modifications dans les états de téléphonie spécifiés.
Pour inscrire un rappel, transmettez un TelephonyCallback qui implémente des interfaces d’événements. Par exemple, FakeServiceStateCallback étend les implémentations TelephonyCallbackTelephonyCallback.ServiceStateListener.
Lors de l’inscription et lorsqu’un état de téléphonie spécifié change, le gestionnaire de téléphonie appelle la méthode de rappel appropriée sur l’objet de rappel et transmet les valeurs actuelles (mises à jour).
Si cet objet TelephonyManager a été créé avec #createForSubscriptionId, s’applique au sous-id donné. Sinon, s’applique à SubscriptionManager#getDefaultSubscriptionId(). Pour inscrire des événements pour plusieurs sous-id, passez un objet de rappel distinct à chaque objet TelephonyManager créé avec #createForSubscriptionId.
Remarque : si vous appelez cette méthode au milieu d’une transaction de classeur, vous<> devez</b> appeler android.os.Binder#clearCallingIdentity() avant d’appeler cette méthode. Une SecurityException sera levée sinon.
Cette API doit être utilisée avec parcimonie : un grand nombre de rappels entraîne une instabilité du système. Si un processus a enregistré trop de rappels sans les désinscrire, il peut rencontrer une IllegalStateException tentative d’inscription d’autres rappels.
Il existe une autre façon de renoncer aux autorisations avec un contexte AttributionSource.Builder#setRenouncedPermissions(Set<String>) personnalisé, mais uniquement pour les applications système. Pour éviter toute confusion, l’appel de cette méthode remplace les autorisations de renoncement à un contexte personnalisé.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.