بسم الله الرحمن الرحيم
السلام عليكم ورحمة الله وبركاته .
كلامنا اليوم عن Broadcast receiver وهو أحد اهم عناصر تطبيق الأندرويد ويستخدم بكثرة في التطبيقات الحديثة والضخمة .
و Broadcast receiver هو مستقبل للبث يقوم بتنفيذ عمل أنت تحدده عند وقوع حدث ما , فمثلا عند ( توصيل الشحن , فصل الشحن , بدء تشغيل الجهاز , …… ) أن يتم عرض رسالة Toast أو بدء منبه أو إرسال رسالة sms أو القيام باتصال أو الخ …
أولا يجب إنشاء ال Broadcast receiver عبر الضغط بنقرة يمنى على مجلد المشروع ومن ثم الضغط على New ثم Other ثم Broadcast Receiver , فيتم إنشاؤه ككلاس جافا يرث BroadcastReceiver ويحوي دالة واحد هي onReceive التي نكتب فيها الكود الذي نريد تنفيذه عند استلام الحدث , شكل الكلاس بشكل عام :
1 2 3 4 5 6 7 8 9 10 11 12 13 |
package com.dev.ms.test; import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; public class Catcher extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { //Your code } } |
- هنا لدينا BroadcastReceiver أسميناه Catcher .
عند إنشاء بالطريقة التي ذكرت في الأعلى فإنه سيتم تعريفه تلفائيا في AndroidManifest.xml أما عند إنشائه بالطريقة الصعبة بإنشاء كلاس جافا و جعله يرث BroadcastReceiver فإنه يتوجب عليك تعريفه في AndroidManifest.xml .
يمكنك إرسال إشارة للمستقبل بشكل عام بالكود فينفذ ما في داخل onReceive :
1 2 |
Intent broadcast = new Intent(this,Catcher.class); sendBroadcast(broadcast); |
- قمنا بتعريف Intent عادي مع وضع المستقبل ضمن الطرف الثاني .
- دالة sendBroadcast لإرسال البث وهي بدل وضع startActivity عند الانتقال لاكتيفيتي أخرى .
والآن سنتحدث عن مثال لكيفية استقبال بث لحدث بدء تشغيل الجهاز :
أولا : سنضيف هذه الصلاحية في AndroidManifest.xml للتمكن من العمل عند بدء تشغيل الجهاز .
1 |
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" /> |
ثانيا : بما انه عند بدء التشغيل سيبث امر وهو عبارة عن اكشن فلا بد من وضع نفس الأكشن في ملف أندرويد مانيفست لل BroadcastReceiver للتمكن من استقبال البث وال action هو :
1 |
<action android:name="android.intent.action.BOOT_COMPLETED" /> |
ثالثا : سنضع toast في دالة onReceive وليكن يحمل رسالة “بدء التشغيل”.
ونجرب إعادة التشغيل او حتى الدخول إلى وضع توفير الطاقة ثم الخروج منه ، ونستطيع أيضا ان نضع الاكشن وصل الطاقة أو حتى فصلها ولا ننسى ان في بعض الحالات سنضطر لإضافة الصلاحيات في ملف AndroidManifest.xml .
المثال كاملا :
- ملف AndroidManifest.xml :
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 |
<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.dev.ms.test"> <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" /> <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme"> <activity android:name=".MainActivity" android:label="@string/app_name"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <receiver android:name=".Catcher" android:enabled="true" android:exported="true"> <intent-filter> <action android:name="android.intent.action.BOOT_COMPLETED" /> </intent-filter> </receiver> </application> </manifest> |
- ملف ال BroadcastReceiver :
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
package com.dev.ms.test; import android.content.BroadcastReceiver; import android.content.Context; import android.content.Intent; import android.widget.Toast; public class Catcher extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { Toast.makeText(context, "بدء التشغيل", Toast.LENGTH_SHORT).show(); } } |
ملاحظة : أحد أكثر استخدامات ال Broadcast Receiver ياتي في ال Alarms والتي سنتطرق لطرق متقدمة فيها في تدوينات قادمة .
أتمنى أن تنال إعجابكم ، دمتم في رعاية الله .
السلام عليكم ورحمة الله وبركاته .