Thông báo nhắc nhở Android

Thứ Hai, 10/04/2023

Tram Ho

Lời mở đầu

Kể từ API 19, tất cả các hàm lặp của AlarmManager đều không chính xác. Việc này tạo ra không ít khó khăn cho các lập trình viên. Sau một thời gian tìm hiểu thì mình đã quyết định dùng setExact để thực hiện gửi thông báo 1 lần. Trong hàm nhận thông báo mình sẽ sử dụng dữ liệu trong room database để cài đặt cho lần thông báo tiếp theo.

1. Cấp quyền

Chúng ta cần quyền SCHEDULE_EXACT_ALARM để hàm AlarmManager.setExact có thể hoạt động.
SCHEDULE_EXACT_ALARM sẽ tự động được cấp đối với API <= 31
Đối với API > 31 chúng ta cần kiểm tra và xin cấp quyền nếu chưa được cho phép.
Kiểm tra quyền:

ContextCompat.checkSelfPermission(context, Manifest.permission.SCHEDULE_EXACT_ALARM)

1 2	ContextCompat.checkSelfPermission(context, Manifest.permission.SCHEDULE_EXACT_ALARM)

Yêu cầu quyền:

val launcher = rememberLauncherForActivityResult(
        ActivityResultContracts.RequestPermission()
    ) {
        // TODO
    }
    
launcher.launch(Manifest.permission.SCHEDULE_EXACT_ALARM)

val launcher = rememberLauncherForActivityResult(

ActivityResultContracts.RequestPermission()

) {

// TODO

}

launcher.launch(Manifest.permission.SCHEDULE_EXACT_ALARM)

2. Tạo ReminderBroadcastReceiver

Chúng ta sử dụng BroadcastReceiver để nhận sự kiện và hiển thị Notification cho user
Sử dụng room để kiểm tra và thực hiển setExact Alarm cho lần tiếp theo

@AndroidEntryPoint
class ReminderBroadcastReceiver : BroadcastReceiver() {

    @Inject
    lateinit var reminderRepository: ReminderRepository

    companion object {
        const val CONTENT_TEXT = "CONTENT_TEXT"
        const val REMINDER_ID = "REMINDER_ID"
    }

    override fun onReceive(context: Context?, intent: Intent?) {
        val ctx = context ?: return
        val notificationManager =
            ctx.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
        if (!notificationManager.areNotificationsEnabled()) return

        val reminderId = intent?.getIntExtra(REMINDER_ID, -1) ?: -1
        if (reminderId != -1) {
            CoroutineScope(Dispatchers.IO).launch {
                reminderRepository.checkToResetReminder(reminderId)
            }
        }

        val notification = NotificationCompat.Builder(ctx, Constants.REMINDER_CHANNEL_ID)
            .setSmallIcon(R.drawable.ic_launcher_foreground)
            .setContentTitle(ctx.getString(R.string.app_name))
            .setContentText(intent?.getStringExtra(CONTENT_TEXT))
            .build()

        if (Build.VERSION.SDK_INT &gt;= Build.VERSION_CODES.O) {
            val channel = NotificationChannel(
                Constants.REMINDER_CHANNEL_ID,
                Constants.REMINDER_CHANNEL_NAME,
                NotificationManager.IMPORTANCE_DEFAULT
            ).apply {
                description = Constants.REMINDER_CHANNEL_DESC
            }
            notificationManager.createNotificationChannel(channel)
        }

        notificationManager.notify(Random.nextInt(), notification)
    }
}

@AndroidEntryPoint

class ReminderBroadcastReceiver : BroadcastReceiver() {

@Inject

lateinit var reminderRepository: ReminderRepository

companion object {

const val CONTENT_TEXT = "CONTENT_TEXT"

const val REMINDER_ID = "REMINDER_ID"

}

override fun onReceive(context: Context?, intent: Intent?) {

val ctx = context ?: return

val notificationManager =

ctx.getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager

if (!notificationManager.areNotificationsEnabled()) return

val reminderId = intent?.getIntExtra(REMINDER_ID, -1) ?: -1

if (reminderId != -1) {

CoroutineScope(Dispatchers.IO).launch {

reminderRepository.checkToResetReminder(reminderId)

}

val notification = NotificationCompat.Builder(ctx, Constants.REMINDER_CHANNEL_ID)

.setSmallIcon(R.drawable.ic_launcher_foreground)

.setContentTitle(ctx.getString(R.string.app_name))

.setContentText(intent?.getStringExtra(CONTENT_TEXT))

.build()

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {

val channel = NotificationChannel(

Constants.REMINDER_CHANNEL_ID,

Constants.REMINDER_CHANNEL_NAME,

NotificationManager.IMPORTANCE_DEFAULT

).apply {

description = Constants.REMINDER_CHANNEL_DESC

}

notificationManager.createNotificationChannel(channel)

}

notificationManager.notify(Random.nextInt(), notification)

}

Nếu reminder trong room chưa bị xóa thì thực hiện set cho lần tiếp theo

override suspend fun checkToResetReminder(id: Int) {
        try {
            val reminder = getReminderById(id.toLong())
             reminderManager.scheduleReminder(
                    content = reminder.label,
                    time = reminder.reminderTime,
                    reminderId = reminder.id.toInt()
                )
        } catch (_: Exception) {
        }
    }

override suspend fun checkToResetReminder(id: Int) {

try {

val reminder = getReminderById(id.toLong())

reminderManager.scheduleReminder(

content = reminder.label,

time = reminder.reminderTime,

reminderId = reminder.id.toInt()

)

} catch (_: Exception) {

}

Thêm vào manifest file

&lt;receiver
            android:name=".ui.reminder_editing.ReminderBroadcastReceiver"
            android:enabled="true" /&gt;

<receiver

android:name=".ui.reminder_editing.ReminderBroadcastReceiver"

android:enabled="true" />

3. Tạo class để quản lý việc thêm và hủy Notification

Ở đây mình dùng requestCode trong pendingIntent bằng với Id của notification trong room để tiện cho việc hủy Notification

class ReminderManager(
    private val context: Context
) {
    fun scheduleReminder(content: String, time: LocalTime, reminderId: Int) {
        val intent = Intent(context, ReminderBroadcastReceiver::class.java)
        intent.putExtra(ReminderBroadcastReceiver.CONTENT_TEXT, content)
        intent.putExtra(ReminderBroadcastReceiver.REMINDER_ID, reminderId)
        val pendingIntent = PendingIntent.getBroadcast(
            context,
            reminderId,
            intent,
            PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
        )
        val notificationTime = Calendar.getInstance().apply {
            set(Calendar.HOUR_OF_DAY, time.hour)
            set(Calendar.MINUTE, time.minute)
            set(Calendar.SECOND, 0)
        }

        // Do not trigger reminder in the pass
        if (Calendar.getInstance().apply {
                add(Calendar.SECOND, 30)
            }.timeInMillis - notificationTime.timeInMillis &gt; 0) {
            notificationTime.add(Calendar.DATE, 1)
        }

        val alarmManager = context.getSystemService(Context.ALARM_SERVICE) as AlarmManager
        alarmManager.setExact(
            AlarmManager.RTC_WAKEUP,
            notificationTime.timeInMillis,
            pendingIntent
        )
    }

    fun cancelReminder(reminderId: Int) {
        val alarmManager = context.getSystemService(Context.ALARM_SERVICE) as AlarmManager
        val intent = Intent(context, ReminderBroadcastReceiver::class.java)
        val pendingIntent = PendingIntent.getBroadcast(
            context,
            reminderId,
            intent,
            PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT
        )
        alarmManager.cancel(pendingIntent)
    }
}

class ReminderManager(

private val context: Context

) {

fun scheduleReminder(content: String, time: LocalTime, reminderId: Int) {

val intent = Intent(context, ReminderBroadcastReceiver::class.java)

intent.putExtra(ReminderBroadcastReceiver.CONTENT_TEXT, content)

intent.putExtra(ReminderBroadcastReceiver.REMINDER_ID, reminderId)

val pendingIntent = PendingIntent.getBroadcast(

context,

reminderId,

intent,

PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT

)

val notificationTime = Calendar.getInstance().apply {

set(Calendar.HOUR_OF_DAY, time.hour)

set(Calendar.MINUTE, time.minute)

set(Calendar.SECOND, 0)

}

// Do not trigger reminder in the pass

if (Calendar.getInstance().apply {

add(Calendar.SECOND, 30)

}.timeInMillis - notificationTime.timeInMillis > 0) {

notificationTime.add(Calendar.DATE, 1)

}

val alarmManager = context.getSystemService(Context.ALARM_SERVICE) as AlarmManager

alarmManager.setExact(

AlarmManager.RTC_WAKEUP,

notificationTime.timeInMillis,

pendingIntent

)

}

fun cancelReminder(reminderId: Int) {

val alarmManager = context.getSystemService(Context.ALARM_SERVICE) as AlarmManager

val intent = Intent(context, ReminderBroadcastReceiver::class.java)

val pendingIntent = PendingIntent.getBroadcast(

context,

reminderId,

intent,

PendingIntent.FLAG_IMMUTABLE or PendingIntent.FLAG_UPDATE_CURRENT

)

alarmManager.cancel(pendingIntent)

}

4. Gọi hàm hiển thị Notification

Thêm Notification vào trong Room Database.
Sử dụng Id trả về để đặt cho notificationId để tiện cho việc sửa và hủy Notification

@Entity(tableName = TABLE_REMINDER)
data class Reminder constructor(
    @PrimaryKey(autoGenerate = true) @ColumnInfo(name = "id") val id: Long = 0,
    @ColumnInfo("label") val label: String,
    @ColumnInfo("activated") val activated: Boolean,
    @ColumnInfo("color") val color: Long,
    @ColumnInfo("reminder_time") val reminderTime: LocalTime,
    @ColumnInfo("id_user") val idUser: String? = null
)

@Dao
interface ReminderDao {
    @Query("SELECT * FROM ${Constants.TABLE_REMINDER}")
    fun getReminderList(): Flow&lt;List&lt;Reminder&gt;&gt;

    @Insert(onConflict = OnConflictStrategy.REPLACE)
    suspend fun addReminder(reminder: Reminder): Long // NotificationId

    @Query("SELECT * FROM ${Constants.TABLE_REMINDER} WHERE id=:id")
    suspend fun getReminder(id: Long): Reminder

    @Query("DELETE FROM ${Constants.TABLE_REMINDER} WHERE id=:id")
    suspend fun deleteReminder(id: Long)
}

@Entity(tableName = TABLE_REMINDER)

data class Reminder constructor(

@PrimaryKey(autoGenerate = true) @ColumnInfo(name = "id") val id: Long = 0,

@ColumnInfo("label") val label: String,

@ColumnInfo("activated") val activated: Boolean,

@ColumnInfo("color") val color: Long,

@ColumnInfo("reminder_time") val reminderTime: LocalTime,

@ColumnInfo("id_user") val idUser: String? = null

)

@Dao

interface ReminderDao {

@Query("SELECT * FROM ${Constants.TABLE_REMINDER}")

fun getReminderList(): Flow<List<Reminder>>

@Insert(onConflict = OnConflictStrategy.REPLACE)

suspend fun addReminder(reminder: Reminder): Long // NotificationId

@Query("SELECT * FROM ${Constants.TABLE_REMINDER} WHERE id=:id")

suspend fun getReminder(id: Long): Reminder

@Query("DELETE FROM ${Constants.TABLE_REMINDER} WHERE id=:id")

suspend fun deleteReminder(id: Long)

}

Trigger

val reminderManager = ReminderManager(context);
reminderManager.scheduleReminder("Hello!", LocalTime(8, 0), NotificationId);

val reminderManager = ReminderManager(context);

reminderManager.scheduleReminder("Hello!", LocalTime(8, 0), NotificationId);

Xử lý reboot

Sau khi điện thoại được khởi động lại. Các hàm trong AlarmManager sẽ được reset. Do đó chúng ta cần bắt sự kiện reboot và đặt lại reminder để hiển thị Notification. Ở đây mình sẽ sử dụng broadcast receiver

class BootReceiver : BroadcastReceiver() {

    override fun onReceive(p0: Context?, p1: Intent?) {
        if (p1?.action == "android.intent.action.BOOT_COMPLETED") {
            // Đặt lại Notification ở đây, dựa vào dữ liệu được lưu trữ trong room
        }
    }
}

class BootReceiver : BroadcastReceiver() {

override fun onReceive(p0: Context?, p1: Intent?) {

if (p1?.action == "android.intent.action.BOOT_COMPLETED") {

// Đặt lại Notification ở đây, dựa vào dữ liệu được lưu trữ trong room

}

Khai báo trong manifest

&lt;receiver
            android:name=".ui.reminder_editing.BootReceiver"
            android:enabled="true"
            android:exported="false"&gt;

            &lt;intent-filter&gt;
                &lt;action android:name="android.intent.action.BOOT_COMPLETED" /&gt;
            &lt;/intent-filter&gt;

        &lt;/receiver&gt;

<receiver

android:name=".ui.reminder_editing.BootReceiver"

android:enabled="true"

android:exported="false">

<intent-filter>

</intent-filter>

</receiver>

Chia sẻ bài viết ngay

Nguồn bài viết : Viblo

Thông báo nhắc nhở Android

Lời mở đầu

1. Cấp quyền

2. Tạo ReminderBroadcastReceiver

3. Tạo class để quản lý việc thêm và hủy Notification

4. Gọi hàm hiển thị Notification

TikTok trở thành nền tảng mảng xã hội lớn thứ hai ở Nam Phi

Mất giá nhanh nhất sau 9 tháng ra mắt, iPhone 14 Pro Max tiếp tục phá đáy tại Việt Nam

Hướng dẫn sử dụng ngôn ngữ R cho người mới bắt đầu

10 plugin cần thiết của SublimeText dành cho các lập trình viên JavaScript