- sintaks:
<receiver android:directBootAware=["true" | "false"] android:enabled=["true" | "false"] android:exported=["true" | "false"] android:icon="drawable resource" android:label="string resource" android:name="string" android:permission="string" android:process="string" > . . . </receiver>
- terdapat dalam:
<application>
- dapat berisi:
<intent-filter>
<meta-data>
- deskripsi:
- Mendeklarasikan penerima siaran (subclass
BroadcastReceiver
) sebagai salah satu komponen aplikasi. Penerima siaran memungkinkan aplikasi menerima intent yang disiarkan oleh sistem atau aplikasi lain, meskipun komponen lain aplikasi tidak sedang berjalan.Terdapat dua cara untuk memperkenalkan penerima siaran ke sistem: Pertama, dengan mendeklarasikannya dalam file manifes menggunakan elemen ini. Kedua, dengan membuat penerima secara dinamis dalam kode dan mendaftarkannya menggunakan metode
Context.registerReceiver()
. Untuk mengetahui informasi selengkapnya tentang cara membuat penerima secara dinamis, lihat deskripsi class
BroadcastReceiver
.Peringatan: Batasi jumlah penerima siaran yang Anda setel dalam aplikasi. Terlalu banyak penerima siaran dapat memengaruhi performa aplikasi dan masa pakai baterai perangkat pengguna. Untuk mengetahui informasi selengkapnya tentang API yang dapat Anda gunakan, bukan class
BroadcastReceiver
untuk menjadwalkan tugas latar belakang, lihat Pengoptimalan Latar Belakang. - atribut:
android:directBootAware
Apakah penerima siaran peka terhadap booting langsung; yaitu, apakah penerima siaran dapat dijalankan sebelum pengguna membuka kunci perangkat.
Catatan: Pada waktu Booting Langsung, penerima siaran dalam aplikasi hanya dapat mengakses data dalam penyimpanan yang dilindungi di perangkat.
Nilai default-nya adalah
"false"
.android:enabled
- Apakah instance penerima siaran dapat dibuat oleh sistem atau tidak; "
true
" jika dapat, dan "false
" jika tidak dapat. Nilai default-nya adalah "true
".Elemen
<application>
memiliki atributenabled
tersendiri yang berlaku untuk semua komponen aplikasi, termasuk penerima siaran. Atribut<application>
dan<receiver>
harus diatur ke "true
" agar penerima siaran diaktifkan. Jika salah satunya disetel ke "false
", penerima siaran akan dinonaktifkan; instance-nya tidak dapat dibuat. android:exported
- Apakah penerima siaran dapat menerima pesan dari sumber di luar aplikasinya atau tidak; "
true
" jika dapat, dan "false
" jika tidak dapat. Jika disetel ke "false
", satu-satunya pesan yang dapat diterima oleh penerima siaran adalah pesan yang dikirim oleh komponen aplikasi yang sama atau aplikasi dengan ID pengguna yang sama.Nilai default-nya bergantung pada apakah penerima siaran memuat filter intent atau tidak. Jika tidak ada filter, penerima siaran hanya dapat dipanggil oleh objek Intent yang menentukan nama class persisnya. Hal ini berarti penerima hanya ditujukan untuk penggunaan internal aplikasi (karena yang lain biasanya tidak mengetahui nama class-nya). Jadi, dalam situasi ini, nilai default-nya adalah "
false
". Di sisi lain, jika ada setidaknya satu filter, artinya penerima siaran ditujukan untuk menerima intent yang disiarkan oleh sistem atau aplikasi lain sehingga nilai default-nya adalah "true
".Atribut ini bukanlah satu-satunya cara untuk membatasi eksposur eksternal penerima siaran. Anda juga dapat menggunakan izin untuk membatasi entitas eksternal yang dapat mengirim pesan padanya (lihat atribut
permission
). android:icon
- Ikon yang menggambarkan penerima siaran. Atribut ini harus ditetapkan sebagai referensi ke resource yang dapat digambar yang berisi definisi gambar.
Jika tidak, ikon yang ditetapkan untuk aplikasi secara keseluruhan akan digunakan sebagai gantinya (lihat atribut
icon
milik elemen<application>
).Ikon penerima siaran, baik yang ditetapkan di sini maupun oleh elemen
<application>
, juga merupakan ikon default untuk semua filter intent penerima (lihat atributicon
milik elemen<intent-filter>
). android:label
- Label yang dapat dibaca pengguna untuk penerima siaran. Jika atribut ini tidak ditetapkan, label yang ditetapkan untuk aplikasi secara keseluruhan akan digunakan sebagai gantinya (lihat atribut
label
milik elemen<application>
).Label penerima siaran, baik yang ditetapkan di sini maupun oleh elemen
<application>
, juga merupakan label default untuk semua filter intent penerima (lihat atributlabel
milik elemen<intent-filter>
).Label ini harus ditetapkan sebagai referensi ke resource string sehingga dapat dilokalkan seperti string lain dalam antarmuka pengguna. Namun, untuk memudahkan Anda mengembangkan aplikasi, label ini juga dapat ditetapkan sebagai string mentah.
android:name
- Nama class yang mengimplementasikan penerima siaran, subclass dari
BroadcastReceiver
. Nama class ini harus sepenuhnya memenuhi syarat (seperti "com.example.project.ReportReceiver
"). Namun, sebagai pintasan, jika karakter pertamanya adalah titik (misalnya ". ReportReceiver
"), nama ini akan ditambahkan ke nama paket yang ditetapkan dalam elemen<manifest>
.Setelah memublikasikan aplikasi, Anda tidak boleh mengubah nama ini (kecuali Anda telah menetapkan
android:exported="false"
).Tidak ada default untuknya. Nama ini harus ditetapkan.
android:permission
- Nama izin yang harus dimiliki penyiar untuk mengirim pesan ke penerima siaran.
Jika atribut ini tidak ditetapkan, izin yang ditetapkan oleh atribut
permission
milik elemen<application>
akan diterapkan untuk penerima siaran. Jika tidak ada atribut yang ditetapkan, penerima tidak akan dilindungi oleh izin.Untuk mengetahui informasi selengkapnya tentang izin, lihat bagian Izin dalam pendahuluan dan dokumen terpisah yang berjudul Keamanan dan Izin.
android:process
- Nama proses tempat penerima siaran harus berjalan.
Biasanya, semua komponen aplikasi akan dijalankan dalam proses default yang dibuat bagi aplikasi tersebut. Proses ini memiliki nama yang sama dengan paket aplikasi. Atribut
process
milik elemen<application>
dapat menetapkan default yang berbeda untuk semua komponen. Namun, setiap komponen dapat mengganti default-nya dengan atributprocess
miliknya sendiri sehingga Anda dapat menyebarluaskan aplikasi ke beberapa proses.Jika nama yang ditetapkan pada atribut ini diawali dengan tanda titik dua (':'), proses baru yang bersifat pribadi untuk aplikasi akan dibuat saat diperlukan, dan penerima siaran akan berjalan dalam proses tersebut. Jika nama proses diawali dengan karakter huruf kecil, penerima akan berjalan dalam proses global nama tersebut, asalkan memiliki izin untuk melakukannya. Hal ini memungkinkan komponen dalam berbagai aplikasi untuk saling berbagi proses sehingga akan mengurangi penggunaan resource.
- diperkenalkan pada:
- API Level 1
Content and code samples on this page are subject to the licenses described in the Content License. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2019-12-27 UTC.