Bagikan melalui

TelephonyManager.Listen(PhoneStateListener, PhoneStateListenerFlags) Metode

  • Referensi

Definisi

Ruang nama:
Android.Telephony
Rakitan:
Mono.Android.dll

Mendaftarkan objek pendengar untuk menerima pemberitahuan perubahan dalam status telepon tertentu.

[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 -> unit

Parameter

listener
PhoneStateListener

Objek PhoneStateListener yang akan didaftarkan (atau tidak terdaftar)

events
PhoneStateListenerFlags

Status telepon yang menarik bagi pendengar, sebagai kombinasi bitwise-OR dari PhoneStateListener bendera LISTEN_.

Atribut
RegisterAttribute

Keterangan

Mendaftarkan objek pendengar untuk menerima pemberitahuan perubahan dalam status telepon tertentu.

Untuk mendaftarkan pendengar, berikan PhoneStateListener dan tentukan setidaknya satu status telepon yang menarik dalam argumen peristiwa.

Pada pendaftaran, dan ketika status telepon tertentu berubah, manajer telepon memanggil metode panggilan balik yang sesuai pada objek pendengar dan meneruskan nilai saat ini (diperbarui).

Untuk membatalkan pendaftaran pendengar, berikan objek pendengar dan atur argumen peristiwa ke PhoneStateListener#LISTEN_NONE LISTEN_NONE (0).

Jika objek TelephonyManager ini telah dibuat dengan #createForSubscriptionId, berlaku untuk subId yang diberikan. Jika tidak, berlaku untuk SubscriptionManager#getDefaultSubscriptionId(). Untuk mendengarkan peristiwa untuk beberapa subId, teruskan objek pendengar terpisah ke setiap objek TelephonyManager yang dibuat dengan #createForSubscriptionId.

Catatan: jika Anda memanggil metode ini saat berada di tengah transaksi binder, Anda <>harus</b> memanggil android.os.Binder#clearCallingIdentity() sebelum memanggil metode ini. A SecurityException akan dilemparkan sebaliknya.

API ini harus digunakan dengan hemat -- sejumlah besar pendengar akan menyebabkan ketidakstabilan sistem. Jika proses telah mendaftarkan terlalu banyak pendengar tanpa membatalkan pendaftarannya, proses mungkin mengalami saat mencoba mendaftarkan lebih banyak IllegalStateException pendengar.

Anggota ini tidak digunakan lagi. Gunakan #registerTelephonyCallback(Executor, TelephonyCallback).

Dokumentasi Java untuk android.telephony.TelephonyManager.listen(android.telephony.PhoneStateListener, int).

Bagian halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Proyek Sumber Terbuka Android dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Atribusi Creative Commons 2.5.

Berlaku untuk