<receiver>

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 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; 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 atribut icon 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 atribut label 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 atribut process 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