カスタム通知レイアウトを作成する

Android のバージョンごとに通知が最適に表示されるようにするには: 標準の通知を使用する テンプレートを使用して、 通知を受け取れます。通知でより多くの内容を提供する場合は、 展開可能な通知の テンプレート。

ただし、システム テンプレートがニーズに合わない場合は、独自のテンプレートを使用できます 通知のレイアウトを作成します。

注意: カスタム通知レイアウトを使用する場合は、 カスタム レイアウトはさまざまなデバイスの向きや解像度で機能します。 この推奨事項はすべての UI レイアウトに当てはまりますが、特に 通知ドロワーのスペースが制限されているため、通知は表示されません。「 カスタム通知レイアウトで使用できる高さは、 できます。一部のバージョンでは、折りたたみビューのレイアウトは、 48 dp、ヘッドアップ ビューのレイアウトは最低 88 dp に制限される 展開表示のレイアウトは、わずか 252 dp に制限されています。

コンテンツ領域用のカスタム レイアウトを作成する

カスタム レイアウトが必要な場合は、 NotificationCompat.DecoratedCustomViewStyle 追加できます。この API を使用すると、コンテンツのカスタム レイアウトを提供できます。 通常はタイトルとテキスト コンテンツによって占有される領域ですが、引き続きシステムを使用 通知アイコン、タイムスタンプ、サブテキスト、操作ボタンの装飾。

この API は、展開可能な通知テンプレートと同様に、基本的な通知に基づいて動作します。 次のようなレイアウトです。

1. 基本的な通知を作成する NotificationCompat.Builder。
2. 発信 setStyle() その関数に NotificationCompat.DecoratedCustomViewStyle。
3. カスタム レイアウトを RemoteViews。
4. 発信 setCustomContentView() 折りたたまれた通知のレイアウトを設定します。
5. 必要に応じて、 setCustomBigContentView() 展開された通知に異なるレイアウトを設定できます。

で確認できます。

注: メディア再生コントロール用にカスタマイズした通知を作成する場合は、 同じ推奨事項に従いますが、 NotificationCompat.DecoratedMediaCustomViewStyle クラスを使用してください。

レイアウトを準備する

small レイアウトと large レイアウトが必要です。この例では、small レイアウトです。 次のようになります。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:orientation="vertical">

    <TextView
        android:id="@+id/notification_title"
        style="@style/TextAppearance.Compat.Notification.Title"
        android:layout_width="wrap_content"
        android:layout_height="0dp"
        android:layout_weight="1"
        android:text="Small notification, showing only a title" />
</LinearLayout>

large レイアウトは次のようになります。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="300dp"
    android:orientation="vertical">

    <TextView
        android:id="@+id/notification_title"
        style="@style/TextAppearance.Compat.Notification.Title"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="Large notification, showing a title and a body." />

    <TextView
        android:id="@+id/notification_body"
        style="@style/TextAppearance.Compat.Notification.Line2"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_weight="1"
        android:text="This is the body. The height is manually forced to 300dp." />
</LinearLayout>

通知をビルドして表示する

レイアウトの準備ができたら、次の例に示すようにそれらを使用できます。

Kotlin

val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager

// Get the layouts to use in the custom notification.
val notificationLayout = RemoteViews(packageName, R.layout.notification_small)
val notificationLayoutExpanded = RemoteViews(packageName, R.layout.notification_large)

// Apply the layouts to the notification.
val customNotification = NotificationCompat.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setStyle(NotificationCompat.DecoratedCustomViewStyle())
        .setCustomContentView(notificationLayout)
        .setCustomBigContentView(notificationLayoutExpanded)
        .build()

notificationManager.notify(666, customNotification)

Java

NotificationManager notificationManager = (NotificationManager) getSystemService(Context.NOTIFICATION_SERVICE);

// Get the layouts to use in the custom notification
RemoteViews notificationLayout = new RemoteViews(getPackageName(), R.layout.notification_small);
RemoteViews notificationLayoutExpanded = new RemoteViews(getPackageName(), R.layout.notification_large);

// Apply the layouts to the notification.
Notification customNotification = new NotificationCompat.Builder(context, CHANNEL_ID)
        .setSmallIcon(R.drawable.notification_icon)
        .setStyle(new NotificationCompat.DecoratedCustomViewStyle())
        .setCustomContentView(notificationLayout)
        .setCustomBigContentView(notificationLayoutExpanded)
        .build();

notificationManager.notify(666, customNotification);

通知の背景色はデバイスによって異なる場合があるので注意してください 管理されます。サポート ライブラリのスタイルを適用します。たとえば、 テキストには TextAppearance_Compat_Notification、 カスタム レイアウトのタイトルには TextAppearance_Compat_Notification_Title 必要があります。これらのスタイルは色のバリエーションに適応するため、 黒地に黒や白の上に白のテキストが 入らないようになります

<TextView
    android:layout_width="wrap_content"
    android:layout_height="match_parent"
    android:layout_weight="1"
    android:text="@string/notification_title"
    android:id="@+id/notification_title"
    style="@style/TextAppearance.Compat.Notification.Title" />

テキストが入力されるため、RemoteViews オブジェクトに背景画像を設定しないようにしてください。 読み取れなくなる可能性があります。

ユーザーがアプリを使用中に通知をトリガーすると、結果は次のようになります。 図 1 のようになります。

図 1. 小さな通知レイアウトが表示される 使用できます。

展開矢印をタップすると、通知が展開されます（図 2 を参照）。

図 2. 大きな通知レイアウトが表示される 使用できます。

通知のタイムアウト時間が経過すると、通知は システムバーが図 3 のようになります。

図 3. 小さな通知レイアウトが がシステムバーに表示されます。

展開矢印をタップすると、通知が展開されます（図 4 を参照）。

図 4. 大きな通知レイアウトが画面に表示され、 クリックします。

フルカスタム通知レイアウトを作成する

注: Android をターゲットとするアプリ 12（API レベル 31） 完全なカスタム通知を作成できません。代わりにシステムは 標準テンプレートとほぼ同じ方法で、 Notification.DecoratedCustomViewStyle。

通知が標準の通知で装飾されたくない場合は、 アイコンとヘッダーを表示するには、前述の手順に沿って操作します。ただし、setStyle() は呼び出さないでください。

注意: 装飾されていない通知の使用はおすすめしません。装飾されていない通知は、 他の通知と一致するため、レイアウトの互換性に関する重大な問題を引き起こす可能性があります。 通知領域に異なるスタイルが適用されているデバイスの場合。