แสดงการแจ้งเตือนตามช่วงเวลา

แอปของคุณอาจต้องได้รับความสนใจจากผู้ใช้อย่างเร่งด่วนในบางสถานการณ์ เช่น การปลุกที่ดำเนินอยู่หรือสายเรียกเข้า ในแอปที่กำหนดเป้าหมายเป็นอุปกรณ์ที่ใช้ Android 9 (API ระดับ 28) หรือต่ำกว่า คุณอาจจัดการเรื่องนี้ได้โดยเปิดใช้งานกิจกรรมขณะที่แอปทำงานอยู่เบื้องหลัง เอกสารนี้แสดงวิธีทำให้แอปทำงานในลักษณะนี้ในอุปกรณ์ที่ใช้ Android 10 (API ระดับ 29) ถึง Android 13 (API ระดับ 33)

เพิ่มสิทธิ์ POST_NOTIFICATIONS

ตั้งแต่ Android 13 เป็นต้นไป ให้เพิ่มบรรทัดต่อไปนี้ลงในไฟล์ AndroidManifest.xml

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

เมื่อได้ลิงก์แล้ว คุณจะสร้างช่องทางการแจ้งเตือนได้

สร้างช่องทางการแจ้งเตือน

สร้างช่องทางการแจ้งเตือนเพื่อแสดงการแจ้งเตือนอย่างถูกต้องและอนุญาตให้ผู้ใช้จัดการการแจ้งเตือนในการตั้งค่าแอป ดูข้อมูลเพิ่มเติมเกี่ยวกับช่องทางการแจ้งเตือนได้ที่สร้างและจัดการช่องทางการแจ้งเตือน

สร้างช่องทางการแจ้งเตือนในเมธอด onCreate ของคลาส Application โดยทำดังนี้

Kotlin

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

เมื่อผู้ใช้เรียกใช้แอปเป็นครั้งแรก ผู้ใช้จะเห็นข้อมูลดังรูปที่ 1 ในหน้าจอระบบข้อมูลแอปของแอป

รูปภาพแสดงข้อมูลแอปและหน้าจอการแจ้งเตือนของแอป
รูปที่ 1 ส่วนการแจ้งเตือนในหน้าจอข้อมูลแอปของการตั้งค่าระบบของแอป

จัดการสิทธิ์การแจ้งเตือน

ตั้งแต่ Android 13 เป็นต้นไป โปรดขอสิทธิ์การแจ้งเตือนก่อนที่จะแสดงการแจ้งเตือนต่อผู้ใช้

การติดตั้งใช้งานขั้นต่ำจะมีลักษณะดังนี้

Kotlin

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 จะเป็นการทริกเกอร์กล่องโต้ตอบที่แสดงในรูปที่ 2 ดังนี้

รูปภาพแสดงกล่องโต้ตอบคําขอสิทธิ์
รูปที่ 2 กล่องโต้ตอบของระบบสำหรับคำขอสิทธิ์การแจ้งเตือน

หากผู้ใช้ยอมรับคำขอสิทธิ์ ส่วนข้อมูลแอปของแอปจะมีลักษณะเป็นรูปที่ 3

รูปภาพแสดงหน้าจอข้อมูลแอปหลังจากได้รับคำขอสิทธิ์การแจ้งเตือน
รูปที่ 3 สิทธิ์การแจ้งเตือนได้รับอนุมัติแล้ว

สร้างการแจ้งเตือนที่มีลำดับความสำคัญสูง

เมื่อสร้างการแจ้งเตือน ให้ใส่ชื่อและข้อความที่สื่อความหมาย

ตัวอย่างต่อไปนี้มีการแจ้งเตือน

Kotlin

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() จะทำให้มีการแจ้งเตือนดังนี้

Kotlin

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

การแจ้งเตือนในตัวอย่างนี้มีลักษณะดังรูปที่ 4

รูปภาพที่แสดงการแจ้งเตือนที่มีลำดับความสำคัญสูง
รูปที่ 4 การแจ้งเตือนที่มีลำดับความสำคัญสูง

การแจ้งเตือนต่อเนื่อง

เมื่อคุณแสดงการแจ้งเตือนแก่ผู้ใช้ ผู้ใช้จะรับทราบหรือปิดการแจ้งเตือนหรือการช่วยเตือนของแอปได้ เช่น ผู้ใช้สามารถรับหรือปฏิเสธสายเรียกเข้า

หากการแจ้งเตือนเป็นแบบต่อเนื่อง เช่น สายเรียกเข้า ให้เชื่อมโยงการแจ้งเตือนกับบริการที่ทำงานอยู่เบื้องหน้า ข้อมูลโค้ดต่อไปนี้แสดงวิธีแสดงการแจ้งเตือนที่เชื่อมโยงกับบริการที่ทำงานอยู่เบื้องหน้า

Kotlin

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

Java

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