Ao criar um app de música que processa áudio ou vídeo, é importante usar as notificações e os canais corretos. Isso garante que as notificações tenham os seguintes recursos valiosos:
- Têm prioridade de notificação
- não dispensáveis;
- Usar atributos de áudio para toques
Use NotificationChannel.Builder
para configurar dois canais de notificação: um para
chamadas recebidas e outro para chamadas ativas.
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)
}
Para exibir a notificação em todos os lugares e permitir que ela reproduza o áudio do toque, defina a importância do canal de notificação recebida como alta.
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()
Somente chamadas ativas exigem que a importância seja definida como padrão. Use o estilo de chamadas recebidas para permitir que as notificações de chamadas recebidas sejam não dispensáveis.
val ongoingChannel = NotificationChannelCompat.Builder(
TELECOM_NOTIFICATION_ONGOING_CHANNEL_ID,
NotificationManagerCompat.IMPORTANCE_DEFAULT,
)
.setName("Ongoing calls")
.setDescription("Displays the ongoing call notifications")
.build()
Para abordar casos de uso em que o dispositivo do usuário fica bloqueado durante uma chamada recebida, use uma notificação em tela cheia para mostrar uma atividade e permitir que o usuário atenda a chamada.
// 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,
)
Leia Criar uma notificação de estilo de chamada para apps de chamadas para instruções sobre
o uso do CallStyle
para distinguir as notificações de chamadas de outros
tipos.