<रिसीवर>

सिंटैक्स:

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

इसमें शामिल है:

<application>

इसमें ये शामिल हो सकते हैं:

<intent-filter>
<meta-data>

विवरण:

ब्रॉडकास्ट रिसीवर का एलान करता है, BroadcastReceiver सब-क्लास का इस्तेमाल करें. ब्रॉडकास्ट रिसीवर चालू करें ऐसे इंटेंट पाने के लिए ऐप्लिकेशन जिन्हें सिस्टम या तब भी, जब ऐप्लिकेशन के अन्य कॉम्पोनेंट काम न कर रहे हों.

ब्रॉडकास्ट रिसीवर को सिस्टम के बारे में जानकारी देने के दो तरीके हैं. एक है इस एलिमेंट के साथ मेनिफ़ेस्ट फ़ाइल में इसका एलान करें. दूसरा तरीक़ा है कि पाने वाले को डाइनैमिक रूप से कोड में भेजना होगा और उसे Context.registerReceiver() अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है विधि या ओवरलोडेड वर्शन में से किसी एक पर लागू होती है.

डायनेमिक रूप से रिसीवर बनाने के बारे में अधिक जानकारी के लिए, देखें BroadcastReceiver क्लास ब्यौरा.

अगर यह पाने वाला डिवाइस गैर-सिस्टम ब्रॉडकास्ट मैनेज करता है, तो android:exported के लिए वैल्यू तय करें. अगर आपको पैसे पाने वाला व्यक्ति ये काम करना है, तो इस वैल्यू को "true" पर सेट करें दूसरे ऐप्लिकेशन से कॉन्टेंट पाने वाले व्यक्ति के ब्रॉडकास्ट या "false" चाहते हैं कि आपका रिसीवर आपके अपने ऐप्लिकेशन से ब्रॉडकास्ट प्राप्त करे.

अगर आपको android:permission एट्रिब्यूट को हटाने की ज़रूरत नहीं है, तो पहले ही एलान कर दिया है.

चेतावनी: ब्रॉडकास्ट की संख्या सीमित करें अपने ऐप्लिकेशन में सेट किए गए रिसीवर के लिए. बहुत ज़्यादा ब्रॉडकास्ट रिसीवर होने से आपके ऐप्लिकेशन की परफ़ॉर्मेंस और लोगों की बैटरी लाइफ़ पर असर पड़ता है डिवाइस. उन API के बारे में अधिक जानकारी के लिए जिनका उपयोग आप बैकग्राउंड में होने वाले काम को शेड्यूल करने के लिए BroadcastReceiver क्लास, देखें बैकग्राउंड ऑप्टिमाइज़ेशन.

विशेषताएं:

android:directBootAware

क्या ब्रॉडकास्ट रिसीवर को Direct-Boot जानकारी है यह है कि क्या यह उपयोगकर्ता के डिवाइस को अनलॉक करने से पहले काम करता है.

ध्यान दें: इस दौरान डायरेक्ट बूट, एक ब्रॉडकास्ट आपके ऐप्लिकेशन का प्राप्तकर्ता केवल उसी डेटा को ऐक्सेस कर सकता है जो इसमें संग्रहित है डिवाइस से सुरक्षित स्टोरेज.

डिफ़ॉल्ट वैल्यू "false" है.

android:enabled

क्या ब्रॉडकास्ट रिसीवर को सिस्टम से इंस्टैंशिएट किया जा सकता है. यह समय है अगर हो सकता है, तो "true" और अगर नहीं है, तो "false". डिफ़ॉल्ट वैल्यू "true" है.

<application> एलिमेंट की अपनी खासियत होती है सभी पर लागू होने वाला enabled एट्रिब्यूट ऐप्लिकेशन के कॉम्पोनेंट, जिनमें ब्रॉडकास्ट रिसीवर भी शामिल हैं. कॉन्टेंट बनाने <application> और इसके लिए <receiver> एट्रिब्यूट, दोनों "true" होने चाहिए को चालू किया जाएगा. अगर दोनों में से कोई एक "false" है, तो बंद है और इंस्टैंशिएट नहीं किया जा सकता.

android:exported

ब्रॉडकास्ट पाने वाला व्यक्ति, सिस्टम के अलावा किसी दूसरे सोर्स से मैसेज पा सकता है या नहीं उसके ऐप्लिकेशन के बाहर हो सकता है. अगर हो सके, तो इसका जवाब "true" होगा और "false" अगर नहीं है. अगर "false", सिर्फ़ ब्रॉडकास्ट रिसीवर को मैसेज भेजता है इन्हें पाने का मतलब है कि सिस्टम, उसी ऐप्लिकेशन के कॉम्पोनेंट या ऐप्लिकेशन से भेजा गया हो और एक ही यूज़र आईडी होना चाहिए.

अगर कोई वैल्यू सेट नहीं की गई है, तो डिफ़ॉल्ट वैल्यू इस बात पर निर्भर करती है कि ब्रॉडकास्ट रिसीवर में इंटेंट शामिल है या नहीं फ़िल्टर. अगर पाने वाले के पास कम से कम एक इंटेंट फ़िल्टर है, तो डिफ़ॉल्ट वैल्यू यह होगी "true". ऐसा न होने पर, डिफ़ॉल्ट वैल्यू "false" होती है.

इस एट्रिब्यूट के ज़रिए, ब्रॉडकास्ट रिसीवर के बाहरी एक्सपोज़र को सीमित किया जा सकता है. उन बाहरी इकाइयों की संख्या सीमित करने के लिए भी अनुमति का इस्तेमाल किया जा सकता है जो उसे मैसेज भेज सकती हैं. permission एट्रिब्यूट देखें.

android:icon

ब्रॉडकास्ट रिसीवर का आइकॉन. यह एट्रिब्यूट सेट कर दिया गया है ड्रॉइंग टूल के रेफ़रंस के तौर पर सबमिट किया जा सकता है, जिसमें इमेज की परिभाषा शामिल होती है. अगर इसे सेट नहीं किया जाता है, तो ऐप्लिकेशन के लिए तय किए गए आइकॉन का इस्तेमाल किया जाता है आज़माएं. <application> देखें एलिमेंट का icon एट्रिब्यूट.

ब्रॉडकास्ट रिसीवर का आइकॉन, भले ही उसे यहां सेट किया गया हो या <application> एलिमेंट, पाने वाले के सभी इंटेंट फ़िल्टर के लिए डिफ़ॉल्ट आइकॉन. ज़्यादा जानकारी के लिए, <intent-filter> एलिमेंट icon एट्रिब्यूट की वैल्यू सबमिट करें.

android:label

ब्रॉडकास्ट रिसीवर के लिए ऐसा लेबल जिसे उपयोगकर्ता आसानी से पढ़ सके. अगर यह एट्रिब्यूट तो ऐप्लिकेशन के लिए संपूर्ण रूप से सेट किया गया लेबल का इस्तेमाल किया गया है. <application> एलिमेंट देखें label एट्रिब्यूट की वैल्यू सबमिट करें.

ब्रॉडकास्ट रिसीवर का लेबल, भले ही उसे यहां सेट किया गया हो या <application> एलिमेंट, पाने वाले के सभी इंटेंट फ़िल्टर के लिए डिफ़ॉल्ट लेबल. ज़्यादा जानकारी के लिए, <intent-filter> एलिमेंट label एट्रिब्यूट की वैल्यू सबमिट करें.

लेबल को किसी स्ट्रिंग संसाधन के रेफ़रंस के तौर पर सेट किया जाता है, ताकि इसे यूज़र इंटरफ़ेस की अन्य स्ट्रिंग की तरह ही स्थानीय भाषा में लिखा जा सकता है. हालांकि, ऐप्लिकेशन डेवलप करते समय, आपकी सुविधा के हिसाब से, इसे रॉ स्ट्रिंग के तौर पर भी सेट किया जा सकता है.

android:name

उस क्लास का नाम जो ब्रॉडकास्ट रिसीवर को लागू करती है, एक सब-क्लास BroadcastReceiver. यह पूरी तरह क्वालिफ़ाइड है क्लास का नाम, जैसे "com.example.project.ReportReceiver". हालांकि, अगर नाम का पहला वर्ण एक विराम चिह्न है, तो उदाहरण के लिए, ".ReportReceiver", इसे इसमें दिए गए पैकेज के नाम में जोड़ा जाता है <manifest> एलिमेंट.

अपना ऐप्लिकेशन पब्लिश करने के बाद, यह काम न करें इस नाम को बदलो, जब तक कि आप android:exported="false" सेट न कर दें.

कोई डिफ़ॉल्ट सेटिंग नहीं है. नाम बताना ज़रूरी है.

android:permission

उस अनुमति का नाम जिसकी ज़रूरत ब्रॉडकास्टर को ब्रॉडकास्ट रिसीवर को मैसेज भेजने की अनुमति दें. अगर यह एट्रिब्यूट सेट नहीं किया गया है, तो अनुमति <application> एलिमेंट permission एट्रिब्यूट लागू होता है को ब्रॉडकास्ट मैसेज भेजने के लिए इस्तेमाल किया जाता है. अगर कोई भी विशेषता सेट नहीं है, तो पाने वाला अनुमति से सुरक्षित नहीं किया गया है.

अनुमतियों के बारे में ज़्यादा जानकारी के लिए, यहां जाएं: अनुमतियां सेक्शन पर जाएं और सुरक्षा से जुड़ी सलाह.

android:process

उस प्रोसेस का नाम जिसमें ब्रॉडकास्ट रिसीवर को चलाया जाता है. आम तौर पर, किसी ऐप्लिकेशन के सभी कॉम्पोनेंट, बनाई गई डिफ़ॉल्ट प्रोसेस में चलते हैं आवेदन के लिए. इसका नाम ऐप्लिकेशन पैकेज के नाम के समान है.

कॉन्टेंट बनाने <application> एलिमेंट process एट्रिब्यूट की वैल्यू डिफ़ॉल्ट तौर पर सेट हो जाता है. हालांकि, हर कॉम्पोनेंट, डिफ़ॉल्ट वैल्यू को बदल सकता है इसकी process एट्रिब्यूट की मदद से, कई प्रोसेस में लागू होता है.

अगर इस एट्रिब्यूट को असाइन किया गया नाम कोलन (:) से शुरू होता है, तो एक नया प्रक्रिया, ऐप्लिकेशन के लिए निजी होती है, जिसे ज़रूरत पड़ने पर बनाया जाता है, और इस प्रोसेस में ब्रॉडकास्ट रिसीवर चलता है.

अगर प्रोसेस का नाम अंग्रेज़ी के छोटे अक्षर से शुरू होता है, तो पाने वाला व्यक्ति इन शर्तों को पूरा करता है ग्लोबल प्रोसेस में जोड़ा जा सकता है, बशर्ते उसके पास ऐसा करने की अनुमति हो. इससे अलग-अलग ऐप्लिकेशन के कॉम्पोनेंट, एक प्रोसेस शेयर कर पाते हैं. इससे अलग-अलग ऐप्लिकेशन के कॉम्पोनेंट संसाधन का इस्तेमाल.

इसमें पेश किया गया:

एपीआई लेवल 1