sintaksis:

<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(). Anda juga dapat menggunakan versi overload Siaran sistem: (penerima, filter) atau Siaran aplikasi: (penerima, filter, tanda). Untuk mengetahui informasi selengkapnya tentang cara membuat penerima secara dinamis, lihat deskripsi class BroadcastReceiver.

Jika penerima ini menangani siaran non-sistem, tentukan nilai untuk android:exported. Setel nilai ini ke true jika Anda ingin penerima dapat menerima siaran dari aplikasi lain, atau false jika Anda hanya ingin agar penerima dapat menerima siaran dari aplikasi Anda sendiri.

Anda tidak perlu menghapus atribut android:permission jika sudah mendeklarasikannya.

Peringatan: Batasi jumlah penerima siaran yang Anda tetapkan 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: Selama Direct Boot, 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 defaultnya adalah "true".

Elemen <application> memiliki atribut enabled 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 dan instance-nya juga tidak dapat dibuat.

android:exported

Apakah penerima siaran dapat menerima pesan dari sumber non-sistem di luar aplikasinya—"true" jika bisa dan "false" jika tidak. Jika ditetapkan ke "false", satu-satunya pesan yang dapat diterima oleh penerima siaran adalah pesan yang dikirim oleh sistem, yaitu komponen aplikasi yang sama atau aplikasi dengan ID pengguna yang sama.

Jika tidak ditentukan, nilai default-nya bergantung pada apakah penerima siaran memuat filter intent atau tidak Jika penerima berisi minimal satu filter intent, nilai default-nya adalah "true". Jika tidak, nilai default-nya adalah "false".

Atribut ini bukanlah satu-satunya cara untuk membatasi eksposur eksternal penerima siaran. Anda juga dapat menggunakan izin untuk membatasi entity eksternal yang bisa mengirim pesan ke penerima siaran (lihat atribut permission).

android:icon

Ikon yang menggambarkan penerima siaran. Atribut ini harus ditetapkan sebagai referensi ke resource drawable yang berisi definisi gambar. Jika tidak, ikon yang ditetapkan untuk aplikasi secara keseluruhan akan digunakan sebagai gantinya (lihat atribut icon elemen <application>).

Ikon penerima siaran, baik yang ditetapkan di sini maupun oleh elemen <application>, juga merupakan ikon default untuk semua filter intent penerima (lihat atribut icon 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 (lihat atribut label elemen <application>).

Label penerima siaran, baik yang ditetapkan di sini maupun oleh elemen <application>, juga merupakan label default untuk semua filter intent penerima (lihat atribut label elemen <intent-filter>).

Label harus ditetapkan sebagai referensi ke resource string sehingga dapat dilokalkan seperti string lain pada 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"), karakter 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 elemen <application> akan diterapkan untuk penerima siaran. Jika tidak ada atribut yang ditetapkan, penerima tidak akan dilindungi oleh izin.

Untuk mengetahui informasi izin selengkapnya, lihat bagian Izin dalam pengantar dan dokumen terpisah yang berjudul Keamanan dan Izin.

android:process

Nama proses tempat penerima siaran seharusnya berjalan. Biasanya, semua komponen aplikasi akan dijalankan dalam proses default yang dibuat untuk aplikasi tersebut. Proses ini memiliki nama yang sama dengan paket aplikasi. Atribut process elemen <application> dapat menetapkan default yang berbeda untuk semua komponen. Namun, setiap komponen dapat mengganti nilai default dengan atribut process-nya sendiri, sehingga Anda dapat menyebarkan 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 di:

API Level 1