このページは Cloud Translation API によって翻訳されました。

通知グループを作成する

Android 7.0（API レベル 24）以降では、関連する通知をできます。たとえば、アプリで受信メールの通知を表示する場合は、同じグループ内の新着メールに関するすべての通知を表示し、説明します。

古いバージョンをサポートするには、単独で表示される概要通知を追加して、まとめることができます。通常は、受信トレイ形式の通知。

図 1. 折りたたまれた（上）と開いた（下）クリックします。

次のすべての条件に当てはまる場合は、通知グループを使用してください case:

子通知は完全な通知であり、表示することができます。グループの概要は不要です。
子通知を個々に表示する利点がある。次に例を示します。
- 子通知に対して操作が可能で、各通知に固有の操作がある。
- 各通知には、ユーザー向けの詳細情報が含まれています。

通知が上記の条件を満たしていない場合は、既存の通知を更新するメッセージスタイルの文章を作成したり、通知を表示します。 1 つの会話で複数の更新を行うことです。

グループを作成して通知を追加する

通知グループを作成するには、そのグループの一意の識別子文字列を定義します。次に、グループで使用する通知ごとに、 setGroup() グループ名を渡します。例:

Kotlin

val GROUP_KEY_WORK_EMAIL = "com.android.example.WORK_EMAIL"

val newMessageNotification = NotificationCompat.Builder(this@MainActivity, CHANNEL_ID)
        .setSmallIcon(R.drawable.new_mail)
        .setContentTitle(emailObject.getSenderName())
        .setContentText(emailObject.getSubject())
        .setLargeIcon(emailObject.getSenderAvatar())
        .setGroup(GROUP_KEY_WORK_EMAIL)
        .build()

Java

String GROUP_KEY_WORK_EMAIL = "com.android.example.WORK_EMAIL";

Notification newMessageNotification = new NotificationCompat.Builder(MainActivity.this, CHANNEL_ID)
        .setSmallIcon(R.drawable.new_mail)
        .setContentTitle(emailObject.getSenderName())
        .setContentText(emailObject.getSubject())
        .setLargeIcon(emailObject.getSenderAvatar())
        .setGroup(GROUP_KEY_WORK_EMAIL)
        .build();

デフォルトでは、通知は投稿日時順に並べられますが、順序を変更するには、 setSortKey()。

通知のグループのアラートを、別の通知、通話 setGroupAlertBehavior() たとえば、グループの要約だけにノイズを付けたい場合は、には、グループアラートの動作が必須になっている必要があります。 GROUP_ALERT_SUMMARY。その他のオプションは GROUP_ALERT_ALL および GROUP_ALERT_CHILDREN。

グループ概要を設定する

グループ化された通知には、グループとして機能する追加の通知が必要です概要ですグループ化された通知を有効にするには、グループの概要を設定する必要があります。このグループの概要には、他の各通知のテキストの一部を含める必要がありますユーザーがグループの内容を把握できるようにします。グループの活動要約が表示されるかどうかは、Android のバージョンによって異なります。

バージョン 7.0（API レベル 24）より前の Android の場合、ネストされたグループの概要のみが表示されます。その他すべての通知は非表示になります。ユーザーは [グループの概要] アプリを開きます。
Android 7.0 以降では、グループの概要通知が表示されます。ネストされた通知のグループとして、各通知のテキストのスニペットでラベル付けグループ化された通知を表示しますグループで設定したテキストは表示されません。概要通知ネストされた通知グループを展開できるグループ内の個々の通知を確認できます（図 1 を参照）。

新しいバージョンの Android では、グループの概要テキストが表示されない場合でも、 グループ化を有効にするには、サマリーを手動で設定する必要があるできます。グループの概要の動作は、デバイスによって異なる場合があります。ウェアラブルなどのデバイスにも対応していますグループの概要でリッチコンテンツを設定すると、すべてのデバイスとバージョンで快適に使用できます。

グループ概要を追加する手順は次のとおりです。

グループの説明を含む新しい通知を作成する（通常は最適）受信トレイのスタイルで通知をご覧ください。
setGroup() を呼び出して、概要通知をグループに追加します。
次の呼び出しによって、グループサマリーとして使用する必要があることを指定します。 setGroupSummary(true)。

次のコードは、グループサマリーを作成する例を示しています。

Kotlin

// Use constant ID for notifications used as group summary.
val SUMMARY_ID = 0
val GROUP_KEY_WORK_EMAIL = "com.android.example.WORK_EMAIL"

val newMessageNotification1 = NotificationCompat.Builder(this@MainActivity, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_notify_email_status)
        .setContentTitle(emailObject1.getSummary())
        .setContentText("You will not believe...")
        .setGroup(GROUP_KEY_WORK_EMAIL)
        .build()

val newMessageNotification2 = NotificationCompat.Builder(this@MainActivity, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_notify_email_status)
        .setContentTitle(emailObject2.getSummary())
        .setContentText("Please join us to celebrate the...")
        .setGroup(GROUP_KEY_WORK_EMAIL)
        .build()

val summaryNotification = NotificationCompat.Builder(this@MainActivity, CHANNEL_ID)
        .setContentTitle(emailObject.getSummary())
        // Set content text to support devices running API level < 24.
        .setContentText("Two new messages")
        .setSmallIcon(R.drawable.ic_notify_summary_status)
        // Build summary info into InboxStyle template.
        .setStyle(NotificationCompat.InboxStyle()
                .addLine("Alex Faarborg Check this out")
                .addLine("Jeff Chang Launch Party")
                .setBigContentTitle("2 new messages")
                .setSummaryText("janedoe@example.com"))
        // Specify which group this notification belongs to.
        .setGroup(GROUP_KEY_WORK_EMAIL)
        // Set this notification as the summary for the group.
        .setGroupSummary(true)
        .build()

NotificationManagerCompat.from(this).apply {
    notify(emailNotificationId1, newMessageNotification1)
    notify(emailNotificationId2, newMessageNotification2)
    notify(SUMMARY_ID, summaryNotification)
}

Java

// Use constant ID for notifications used as group summary.
int SUMMARY_ID = 0;
String GROUP_KEY_WORK_EMAIL = "com.android.example.WORK_EMAIL";

Notification newMessageNotification1 =
    new NotificationCompat.Builder(MainActivity.this, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_notify_email_status)
        .setContentTitle(emailObject1.getSummary())
        .setContentText("You will not believe...")
        .setGroup(GROUP_KEY_WORK_EMAIL)
        .build();

Notification newMessageNotification2 =
    new NotificationCompat.Builder(MainActivity.this, CHANNEL_ID)
        .setSmallIcon(R.drawable.ic_notify_email_status)
        .setContentTitle(emailObject2.getSummary())
        .setContentText("Please join us to celebrate the...")
        .setGroup(GROUP_KEY_WORK_EMAIL)
        .build();

Notification summaryNotification =
    new NotificationCompat.Builder(MainActivity.this, CHANNEL_ID)
        .setContentTitle(emailObject.getSummary())
        // Set content text to support devices running API level < 24.
        .setContentText("Two new messages")
        .setSmallIcon(R.drawable.ic_notify_summary_status)
        // Build summary info into InboxStyle template.
        .setStyle(new NotificationCompat.InboxStyle()
                .addLine("Alex Faarborg  Check this out")
                .addLine("Jeff Chang    Launch Party")
                .setBigContentTitle("2 new messages")
                .setSummaryText("janedoe@example.com"))
        // Specify which group this notification belongs to.
        .setGroup(GROUP_KEY_WORK_EMAIL)
        // Set this notification as the summary for the group.
        .setGroupSummary(true)
        .build();

NotificationManagerCompat notificationManager = NotificationManagerCompat.from(this);
notificationManager.notify(emailNotificationId1, newMessageNotification1);
notificationManager.notify(emailNotificationId2, newMessageNotification2);
notificationManager.notify(SUMMARY_ID, summaryNotification);

概要通知の ID は、1 回だけ送信し、概要情報に変更があったときに更新できます。それ以降グループに追加された場合、既存の要約を更新する必要があります。

通知を使用するサンプルコードについては、Android の通知サンプルをタップします。

自動グループ化

Android 7.0（API レベル 24）以降では、アプリがグループキーまたはグループサマリーを指定していない場合、自動的にグループ化されます。グループ化された通知が自動的に表示されますテキストの一部でラベル付けされたグループの概要通知が、グループ化できますユーザーはこの概要通知を展開して、通知を個別にグループ化できます。

自動グループ化の動作は、デバイスタイプによって異なる場合があります。最適なユースケースをすべてのデバイスとバージョンで利用できます。グループ化するには、グループキーとグループの概要を指定して、確実にグループ化します。