Android सूचनाएं। स्टेटस बार के जरिए अलर्ट

शुभ दोपहर, खाबरोवस्क निवासी। मैं लंबे समय से एंड्रॉइड का विकास कर रहा हूं और सूचनाओं को बनाने के लिए सही दृष्टिकोण के बारे में समुदाय को बताना चाहूंगा।



एंड्रॉइड के लिए स्टेटस बार में नोटिफिकेशन पर एक लेख पहले से ही है। यह एक मानक पट्टी में एक मानक और विन्यास योग्य लेआउट प्रदर्शित करने की मूल बातें शामिल करता है।

नीचे, पहले से वर्णित के अलावा, हम एक प्रगति पट्टी, अधिसूचना घटनाओं पर क्लिक करके घटनाओं को संसाधित करने, अधिसूचना राज्यों के लिए विभिन्न विकल्पों पर विचार करने पर विचार करेंगे। संगतता लाइब्रेरी अधिसूचना में दूसरे दिन जोड़े जाने पर विचार करें। और यूआई ( डिजाइन दिशानिर्देश ) पर सिफारिशों के बारे में भी बात करते हैं, जो Google अनुशंसा करता है कि आप सूचनाओं का निर्माण करते समय पालन करें।


दिशानिर्देश
जैसा कि एंड्रॉइड डेवलपर्स आधिकारिक दिशानिर्देश में सलाह देते हैं

सूचनाएं कब दिखाएं:

• जब हम अपने संवादों के साथ स्क्रीन को अवरुद्ध करके या सूचना स्क्रीन पर स्विच करके उपयोगकर्ता को विचलित नहीं करना चाहते, तो हम सूचनाएं दिखाते हैं। हम उपयोगकर्ता को विचलित नहीं करते हैं, लेकिन उसे किसी भी समय हमारी अधिसूचना की सामग्री का पता लगाने के अवसर से वंचित नहीं करते हैं।
• सबसे अधिक बार, सूचनाएं अनायास नहीं निकलती हैं, लेकिन तब प्रकट होती हैं जब उपयोगकर्ता एप्लिकेशन से प्रतिक्रिया की उम्मीद करता है।
• सूचनाएं मुख्य रूप से समय पर निर्भर घटनाओं को दर्शाती हैं। कुछ इस तरह: कैलेंडर ईवेंट, आने वाले संदेश, सामाजिक नेटवर्क से अनुरोध।

सूचनाएँ दिखाने के लिए कब नहीं:

1. गैर-महत्वपूर्ण छद्म समय-निर्भर घटनाओं के लिए सूचनाएं दिखाने की आवश्यकता नहीं है। उदाहरण के लिए, सामाजिक नेटवर्क से समाचार।
2. एप्लिकेशन UI में पहले से ही प्रदर्शित क्या है, यह दिखाने की कोई आवश्यकता नहीं है।
3. आपको निम्न स्तर के संचालन की प्रगति को प्रदर्शित नहीं करना चाहिए, जैसे डेटाबेस तक पहुंचना।
4. यदि आवेदन जल्दी से त्रुटि को ठीक कर देता है, तो आपको इस त्रुटि को दिखाने की आवश्यकता नहीं है, खासकर एक अधिसूचना के साथ।
5. उन सेवाओं के बारे में सूचनाएं न दिखाएं जिन्हें उपयोगकर्ता नियंत्रित नहीं कर सकता है।
6. एक खराब दृष्टिकोण बड़ी संख्या में सूचनाएं बनाने के लिए है, ताकि उपयोगकर्ता को एप्लिकेशन के बारे में याद दिलाने के लिए, लगातार अपना आइकन और नाम दिखाया जा सके।

अच्छा अभ्यास:

1. अधिसूचना पर क्लिक करके, उपयोगकर्ता को संबंधित एप्लिकेशन स्क्रीन खोलनी चाहिए। कुछ मामलों में, यह पर्याप्त है कि अधिसूचना केवल क्लिक करके हटा दी गई है।
2. एक अधिसूचना में एक घटना के समय को निर्दिष्ट करना भी एक अच्छा तरीका है।
3. यह एक अधिसूचना में इसी तरह की घटनाओं को जोड़ने के लिए सिफारिश की है, और प्रत्येक घटना के लिए अपना खुद का प्रदर्शन नहीं है।
4. हमेशा स्टेटस बार के नोटिफिकेशन को हटा दें, जिसके साथ उपयोगकर्ता पहले ही उचित कार्रवाई पढ़ चुका है और कर चुका है।
5. जब यह न्यूनतम स्थिति पट्टी में बनाया जाता है, तो अधिसूचना का एक छोटा पूर्वावलोकन दिखाएं
6. उपयोगकर्ता को एप्लिकेशन सेटिंग्स में सूचनाओं को बंद करने की अनुमति दें।
7. यह दर्शाने के लिए कि अधिसूचना किसी विशिष्ट एप्लिकेशन की है या नहीं, आइकनों का उपयोग करें। प्रतीक मोनोक्रोम बनाते हैं। ऐसा करने के लिए, एक विशेष ऑनलाइन संपादक का उपयोग करने की सिफारिश की जाती है
8. यदि घटना को प्रत्यक्ष उपयोगकर्ता प्रतिक्रिया की आवश्यकता होती है, तो सूचनाओं के बजाय संवाद का उपयोग करें।

वास्तुकला:

सूचनाओं के लिए जिम्मेदार उपयोगिता के रूप में, मैं अपने अनुप्रयोगों में सिंगलटन का उपयोग करता हूं, जिसे किसी भी एप्लिकेशन वर्ग से एक्सेस किया जा सकता है, आपको बस संदर्भ के लिए लिंक की आवश्यकता है।

यह हमेशा एप्लिकेशन के संचालन के दौरान बनाई गई सभी सूचनाओं के लिंक को संग्रहीत करता है, जो अभी भी स्थिति पट्टी में प्रदर्शित होते हैं।

और एक नई अधिसूचना के लिए एक अद्वितीय आईडी असाइन करने के लिए, एक निजी पूर्णांक फ़ील्ड तक पहुंचने के लिए एक सरल तंत्र का उपयोग किया जाता है, जो हर बार एक से बढ़ जाता है।

public class NotificationUtils {

private static final String TAG = NotificationUtils. class .getSimpleName();

private static NotificationUtils instance;

private static Context context;
private NotificationManager manager; // ,
private int lastId = 0; // ,
private HashMap<Integer, Notification> notifications; // -


// Singleton
private NotificationUtils(Context context){
this .context = context;
manager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
notifications = new HashMap<Integer, Notification>();
}
/**
*
*/
public static NotificationUtils getInstance(Context context){
if(instance== null ){
instance = new NotificationUtils(context);
} else{
instance.context = context;
}
return instance;
}

* This source code was highlighted with Source Code Highlighter .

NotificationCompat.Builder का उपयोग करके एक अधिसूचना बनाना:
संगतता पुस्तकालय में शामिल वर्गों का लाभ उठाने के लिए, आपको प्रोजेक्ट में /extras/android/support/v4/android-support-v4.jar फ़ोल्डर से लाइब्रेरी को जोड़ना होगा
यदि परियोजना एंड्रॉइड 3.0 और उच्चतर पर लक्षित है, तो आपको कुछ भी जोड़ने की आवश्यकता नहीं है, बस Notification.Builder की ओर मुड़ें

public int createInfoNotification( String message){
Intent notificationIntent = new Intent(context, HomeActivity. class ); // HomeActivity
NotificationCompat.Builder nb = new NotificationCompat.Builder(context)
//NotificationCompat.Builder nb = new NotificationBuilder(context) // Android > 3.0
.setSmallIcon(R.drawable.ic_action_picture) //
.setAutoCancel( true ) //
.setTicker(message) //, -
.setContentText(message) //
.setContentIntent(PendingIntent.getActivity(context, 0, notificationIntent, PendingIntent.FLAG_CANCEL_CURRENT))
.setWhen(System.currentTimeMillis()) //
.setContentTitle( "AppName" ) //
.setDefaults(Notification.DEFAULT_ALL); // ,

Notification notification = nb.getNotification(); //
manager.notify(lastId, notification); // .
notifications.put(lastId, notification); // id
return lastId++;
}

* This source code was highlighted with Source Code Highlighter .

एक कस्टम लेआउट अधिसूचना (कस्टम लेआउट) बनाएँ:

/**
*
* @param fileName - , .
*/
public int createDownloadNotification( String fileName){
String text = context.getString(R. string .notification_downloading).concat( " " ).concat(fileName); //
RemoteViews contentView = createProgressNotification(text, context.getString(R. string .notification_downloading)); //View
contentView.setImageViewResource(R.id.notification_download_layout_image, R.drawable.ic_stat_example); //
return lastId++; // id,
}

/**
* ProgressBar,
*
* @param text
* @param topMessage , -
* @return View .
*/
private RemoteViews createProgressNotification( String text, String topMessage) {
Notification notification = new Notification(R.drawable.ic_stat_example, topMessage, System.currentTimeMillis());
RemoteViews contentView = new RemoteViews(context.getPackageName(), R.layout.notification_download_layout);
contentView.setProgressBar(R.id.notification_download_layout_progressbar, 100, 0, false );
contentView.setTextViewText(R.id.notification_download_layout_title, text);

notification.contentView = contentView;
notification.flags = Notification.FLAG_NO_CLEAR | Notification.FLAG_ONGOING_EVENT | Notification.FLAG_ONLY_ALERT_ONCE;

Intent notificationIntent = new Intent(context, NotificationUtils. class );
PendingIntent contentIntent = PendingIntent.getActivity(context, 0, notificationIntent, 0);
notification.contentIntent = contentIntent;

manager.notify(lastId, notification);
notifications.put(lastId, notification);
return contentView;
}

notification_download_layout.xml:

<? xml version ="1.0" encoding ="utf-8" ? >
< LinearLayout xmlns:android ="http://schemas.android.com/apk/res/android"
android:layout_width ="fill_parent"
android:layout_height ="65sp"
android:padding ="10dp"
android:orientation ="vertical" >

< LinearLayout
android:layout_width ="fill_parent"
android:layout_height ="wrap_content"
android:orientation ="horizontal" >

< ImageView
android:id ="@+id/notification_download_layout_image"
android:layout_width ="wrap_content"
android:layout_height ="wrap_content"
android:src ="@drawable/ic_stat_example"
android:layout_gravity ="center_vertical" />

< TextView
android:id ="@+id/notification_download_layout_title"
style ="@style/NotificationTitle"
android:layout_width ="wrap_content"
android:layout_height ="wrap_content"
android:layout_alignParentTop ="true"
android:layout_marginLeft ="10dip"
android:singleLine ="true"
android:text ="notification_download_layout_title"
android:layout_gravity ="center_vertical" />
</ LinearLayout >

< ProgressBar
android:id ="@+id/notification_download_layout_progressbar"
style ="?android:attr/progressBarStyleHorizontal"
android:layout_width ="fill_parent"
android:layout_height ="wrap_content"
android:layout_marginTop ="4dp"
android:progress ="0" />

</ LinearLayout >

एंड्रॉइड 2.3 और उच्चतर (एपीआई> 10) में, एक विशेष संसाधन बनाया गया था जिसमें सिस्टम विषय अधिसूचना पाठ के रंगों को इंगित करता है। इस वजह से, पुराने संस्करणों में आपको एक बैसाखी का उपयोग करना होगा:

फ़ाइल रेस / मान / स्टाइल.xml में हम लिखते हैं:

<? xml version ="1.0" encoding ="utf-8" ? >
< resources >
< style name ="NotificationText" >
< item name ="android:textColor" > ?android:attr/textColorPrimary </ item >
</ style >
< style name ="NotificationTitle" >
< item name ="android:textColor" > ?android:attr/textColorPrimary </ item >
< item name ="android:textStyle" > bold </ item >
</ style >

</ resources >

और एपीआई> 10 का समर्थन करने के लिए, एक फ़ाइल रेस / वैल्यू-वी 9 / स्टाइल.एक्सएमएल बनाएं और टाइप करें:

<? xml version ="1.0" encoding ="utf-8" ? >
< resources >
< style name ="NotificationText" parent ="android:TextAppearance.StatusBar.EventContent" />
< style name ="NotificationTitle" parent ="android:TextAppearance.StatusBar.EventContent.Title" />
</ resources >

अब, हमारे आवेदन के कोड से, हम उपयोगिता की ओर मुड़ते हैं:

NotificationUtils n = NotificationUtils.getInstance(getActivity());
n.createInfoNotification( "info notification" );


एक प्रगति पट्टी के साथ एक अधिसूचना बनाएँ:

int pbId = NotificationUtils.getInstance(getActivity()).createDownloadNotification( "downloading video" );

और जब थ्रेड निष्पादित हो रहा है, हम लगातार कॉल करके प्रगति को अपडेट करते हैं:

NotificationUtils.getInstance(getActivity()).updateProgress(pbId, YOUR_PROGRESS);

नतीजतन, हम प्राप्त करते हैं:


जैसा कि आप देख सकते हैं - बिल्डर द्वारा उपयोग किए जाने वाले निचले अधिसूचना को किसी भी समय हटाया जा सकता है। प्रगति पट्टी के साथ एक सूचना सूचना के ऊपरी ब्लॉक में स्थित है, जिसमें उपयोगकर्ता सूचनाओं को स्पष्ट नहीं कर सकता है।

और अंत में, एक छोटी सी चाल:

यदि आप एक ही गतिविधि के ढेर पर दोहराव नहीं चाहते हैं - तो वांछित गतिविधि को प्रकट करें
android:launchMode="singleTop"