音声や動画を処理するメディアアプリを作成する場合は、適切な通知と通知チャンネルを使用することが重要です。これにより、通知には次の重要な機能が備わります。
- 通知の優先度を設定する
- 閉じることができない
- 着信音にオーディオ属性を使用する
NotificationChannel.Builder を使用して、着信通話用とアクティブな通話用の 2 つの通知チャンネルを設定します。
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 を使用して着信通知を他の種類の通知と区別する方法については、通話アプリ用の通話スタイルの通知を作成するをご覧ください。