TelephonyManager.Listen(PhoneStateListener, PhoneStateListenerFlags) 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.
Inscrit un objet écouteur pour recevoir la notification des modifications dans les états de téléphonie spécifiés.
[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 -> unitParamètres
- listener
- PhoneStateListener
Objet PhoneStateListener à inscrire (ou annuler l’inscription)
- events
- PhoneStateListenerFlags
État(s) de la téléphonie qui intéresse l’écouteur, sous la forme d’une combinaison or au niveau du bit de PhoneStateListener LISTEN_ indicateurs.
- Attributs
Remarques
Inscrit un objet écouteur pour recevoir la notification des modifications dans les états de téléphonie spécifiés.
Pour inscrire un écouteur, passez un PhoneStateListener état de téléphonie et spécifiez au moins un état d’intérêt de téléphonie dans l’argument d’événements.
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 écouteur et transmet les valeurs actuelles (mises à jour).
Pour annuler l’inscription d’un écouteur, passez l’objet d’écouteur et définissez l’argument d’événements sur PhoneStateListener#LISTEN_NONE LISTEN_NONE (0).
Si cet objet TelephonyManager a été créé avec #createForSubscriptionId, s’applique au sous-id donné. Sinon, s’applique à SubscriptionManager#getDefaultSubscriptionId(). Pour écouter les événements de plusieurs sous-id, passez un objet d’écouteur 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 d’écouteurs entraîne une instabilité du système. Si un processus a enregistré trop d’écouteurs sans les désinscrire, il peut rencontrer une IllegalStateException tentative d’inscription d’autres écouteurs.
Ce membre est déconseillé. Utiliser #registerTelephonyCallback(Executor, TelephonyCallback).
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.