समय के हिसाब से संवेदनशील सूचनाएं दिखाएं

कुछ मामलों में, आपके ऐप्लिकेशन को उपयोगकर्ता का ध्यान तुरंत खींचने की ज़रूरत पड़ सकती है. जैसे, अलार्म बजने या इनकमिंग कॉल आने पर. Android 9 (एपीआई लेवल 28) या उससे पहले के वर्शन पर चलने वाले डिवाइसों को टारगेट करने वाले ऐप्लिकेशन में, ऐप्लिकेशन बैकग्राउंड में होने पर कोई गतिविधि शुरू करके, इस समस्या को हल किया जा सकता है. इस दस्तावेज़ में, Android 10 (एपीआई लेवल 29) से लेकर Android 13 (एपीआई लेवल 33) तक के वर्शन वाले डिवाइसों पर, इस सुविधा को चालू करने का तरीका बताया गया है.

POST_NOTIFICATIONS अनुमति जोड़ना

Android 13 से, अपनी AndroidManifest.xml फ़ाइल में यह लाइन जोड़ें:

<manifest ...>
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
    <application ...>
        ...
    </application>
</manifest>

इसके बाद, सूचना चैनल बनाया जा सकता है.

सूचना चैनल बनाना

सूचनाएं सही तरीके से दिखाने के लिए, सूचना चैनल बनाएं. साथ ही, उपयोगकर्ता को ऐप्लिकेशन की सेटिंग में जाकर सूचनाएं मैनेज करने की सुविधा दें. सूचना चैनलों के बारे में ज़्यादा जानने के लिए, सूचना चैनल बनाना और मैनेज करना लेख पढ़ें.

Application क्लास के onCreate तरीके से, सूचना चैनल बनाएं:

class DACapp : Application() {
    override fun onCreate() {
        super.onCreate()
        val channel = NotificationChannel(
            CHANNEL_ID,
            "High priority notifications",
            NotificationManager.IMPORTANCE_HIGH
        )

        val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        notificationManager.createNotificationChannel(channel)
    }
}

जब कोई उपयोगकर्ता आपके ऐप्लिकेशन को पहली बार चलाता है, तो उसे आपके ऐप्लिकेशन की ऐप्लिकेशन की जानकारी सिस्टम स्क्रीन पर, पहली इमेज जैसी जानकारी दिखती है:

सूचनाओं की अनुमतियां मैनेज करना

Android 13 से, उपयोगकर्ताओं को सूचनाएं दिखाने से पहले, सूचनाओं की अनुमतियों का अनुरोध करें.

कम से कम लागू करने का तरीका ऐसा दिखता है:

val permissionLauncher = rememberLauncherForActivityResult(
    contract = ActivityResultContracts.RequestPermission(),
    onResult = { hasNotificationPermission = it }
)
...
Button(
    onClick = {
        if (!hasNotificationPermission) {
            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
                permissionLauncher.launch(Manifest.permission.POST_NOTIFICATIONS)
            }
        }
    },
) {
    Text(text = "Request permission")
}

अगर आपके डिवाइस में Android 13 वर्शन है, तो Request permission बटन पर टैप करने से, दूसरे चित्र में दिखाया गया डायलॉग बॉक्स दिखता है:

अगर उपयोगकर्ता अनुमति का अनुरोध स्वीकार करता है, तो ऐप्लिकेशन का ऐप्लिकेशन की जानकारी सेक्शन, तीसरे चित्र की तरह दिखता है:

ज़्यादा प्राथमिकता वाली सूचना बनाना

सूचना बनाते समय, उसमें जानकारी देने वाला टाइटल और मैसेज शामिल करें.

इस उदाहरण में एक सूचना शामिल है:

private fun showNotification() {
    val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager

    val notificationBuilder =
        NotificationCompat.Builder(this, CHANNEL_ID)
            .setSmallIcon(R.drawable.baseline_auto_awesome_24)
            .setContentTitle("HIGH PRIORITY")
            .setContentText("Check this dog puppy video NOW!")
            .setPriority(NotificationCompat.PRIORITY_HIGH)
            .setCategory(NotificationCompat.CATEGORY_RECOMMENDATION)

    notificationManager.notify(666, notificationBuilder.build())
}

उपयोगकर्ता को सूचना दिखाना

showNotification() फ़ंक्शन को कॉल करने पर, सूचना इस तरह से ट्रिगर होती है:

Button(onClick = { showNotification() }) {
    Text(text = "Show notification")
}

इस उदाहरण में सूचना, चौथी इमेज की तरह दिखती है:

बैकग्राउंड में जारी गतिविधि की सूचना

उपयोगकर्ता को सूचना दिखाने पर, वह आपके ऐप्लिकेशन की सूचना या रिमाइंडर को स्वीकार या खारिज कर सकता है. उदाहरण के लिए, उपयोगकर्ता आने वाले फ़ोन कॉल को स्वीकार या अस्वीकार कर सकता है.

अगर आपकी सूचना किसी ऐसी गतिविधि से जुड़ी है जो जारी है, जैसे कि कोई आने वाला फ़ोन कॉल, तो सूचना को फ़ोरग्राउंड सेवा से जोड़ें. नीचे दिया गया कोड स्निपेट, फ़ोरग्राउंड सेवा से जुड़ी सूचना दिखाने का तरीका दिखाता है:

// Provide a unique integer for the "notificationId" of each notification.
startForeground(notificationId, notification)

// Provide a unique integer for the "notificationId" of each notification.
startForeground(notificationId, notification);