כשמפתחים אפליקציית מדיה שמעבדת אודיו או וידאו, חשוב להשתמש בהתראות ובערוצי ההתראות הנכונים. כך אפשר להבטיח שההתראות יכללו את התכונות החשובות הבאות:
- התראות בעדיפות גבוהה
- אי אפשר לסגור אותן
- שימוש במאפייני אודיו לרינגטונים
משתמשים ב-NotificationChannel.Builder כדי להגדיר שני ערוצי התראות: אחד לשיחות נכנסות והשני לשיחות פעילות.
internal companion object { const val TELECOM_NOTIFICATION_ID = 200 const val TELECOM_NOTIFICATION_ACTION = "telecom_action" const val TELECOM_NOTIFICATION_INCOMING_CHANNEL_ID = "telecom_incoming_channel" const val TELECOM_NOTIFICATION_ONGOING_CHANNEL_ID = "telecom_ongoing_channel" private val ringToneUri = RingtoneManager.getDefaultUri(RingtoneManager.TYPE_RINGTONE) }
כדי שההתראה תוצג בכל מקום ויושמע צליל הרינגטון, צריך להגדיר את החשיבות של ערוץ ההתראות לשיחות נכנסות כגבוהה.
val incomingChannel = NotificationChannelCompat.Builder( TELECOM_NOTIFICATION_INCOMING_CHANNEL_ID, NotificationManagerCompat.IMPORTANCE_HIGH, ).setName("Incoming calls") .setDescription("Handles the notifications when receiving a call") .setVibrationEnabled(true).setSound( ringToneUri, AudioAttributes.Builder() .setContentType(AudioAttributes.CONTENT_TYPE_SONIFICATION) .setLegacyStreamType(AudioManager.STREAM_RING) .setUsage(AudioAttributes.USAGE_NOTIFICATION_RINGTONE).build(), ).build()
כדי להשתמש באפשרות "רק שיחות פעילות", צריך להגדיר את החשיבות כברירת מחדל. כדי לאפשר התראות על שיחות נכנסות שלא ניתן לסגור, צריך להשתמש בסגנון הבא של שיחה נכנסת.
val ongoingChannel = NotificationChannelCompat.Builder( TELECOM_NOTIFICATION_ONGOING_CHANNEL_ID, NotificationManagerCompat.IMPORTANCE_DEFAULT, ) .setName("Ongoing calls") .setDescription("Displays the ongoing call notifications") .build()
כדי לטפל במקרים שבהם המכשיר של המשתמש נעול בזמן שיחה נכנסת, צריך להשתמש בהתראה במסך מלא כדי להציג פעילות שתאפשר למשתמש לענות לשיחה.
// on the notification val contentIntent = PendingIntent.getActivity( /* context = */ context, /* requestCode = */ 0, /* intent = */ Intent(context, TelecomCallActivity::class.java), /* flags = */ PendingIntent.FLAG_UPDATE_CURRENT or PendingIntent.FLAG_IMMUTABLE, )
במאמר יצירת התראה בסגנון שיחה לאפליקציות של שיחות מוסבר איך להשתמש ב-CallStyle כדי להבדיל בין התראות על שיחות לבין סוגים אחרים של התראות.