【Android】Notification.deleteIntentの使い方を徹底解説！通知削除を検知する方法

Androidアプリ開発において、Notification.deleteIntentは「ユーザーが通知を削除（スワイプして消去）した瞬間」を検知できる非常に便利な仕組みです。本記事では、deleteIntentを実際に使ったサンプルアプリを通じて、その実装手順をステップごとにわかりやすく解説します。

deleteIntentとは？

deleteIntentにPendingIntentを設定しておくと、ユーザーが通知を消去した際にシステムがそのPendingIntentを発行してくれます。これにより、「通知を閉じたらデータをクリアする」「削除されたことをログに記録する」といった処理を実現できます。

それでは、実際の実装を見ていきましょう。

ステップ1：新規プロジェクトを作成する

まず、Android Studioで新しいプロジェクトを作成します。メニューからFile → New Projectを選択し、必要な項目を入力してプロジェクトを作成してください。

ステップ2：activity_main.xmlにコードを追加する

次に、res/layout/activity_main.xmlに以下のコードを記述します。画面中央に「create notification」ボタンを配置するシンプルなレイアウトです。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:padding="16dp"
    tools:context=".MainActivity">

    <Button
        android:onClick="createNotification"
        android:text="create notification"
        android:layout_centerInParent="true"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</RelativeLayout>

ステップ3：MainActivity.javaにコードを追加する

src/MainActivity.javaに以下のコードを追加します。ポイントはsetDeleteIntent()メソッドです。ここで削除検知用のPendingIntentを通知に設定しています。

package app.tutorialspoint.com.notifyme;

import android.app.NotificationChannel;
import android.app.NotificationManager;
import android.app.PendingIntent;
import android.content.Intent;
import android.os.Bundle;
import android.support.v4.app.NotificationCompat;
import android.support.v7.app.AppCompatActivity;
import android.view.View;

public class MainActivity extends AppCompatActivity {

    public static final String NOTIFICATION_CHANNEL_ID = "10001";
    private final static String default_notification_channel_id = "default";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }

    public void createNotification(View view) {
        Intent notificationIntent = new Intent(getApplicationContext(), MainActivity.class);
        notificationIntent.putExtra("fromNotification", true);
        notificationIntent.setFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP | Intent.FLAG_ACTIVITY_SINGLE_TOP);
        PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, notificationIntent, 0);

        NotificationManager mNotificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
        NotificationCompat.Builder mBuilder = new
                NotificationCompat.Builder(getApplicationContext(), default_notification_channel_id);
        mBuilder.setContentTitle("My Notification");
        mBuilder.setContentIntent(pendingIntent);
        mBuilder.setContentText("Notification Listener Service Example");
        mBuilder.setSmallIcon(R.drawable.ic_launcher_foreground);
        mBuilder.setAutoCancel(true);
        mBuilder.setDeleteIntent(getDeleteIntent());

        if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
            int importance = NotificationManager.IMPORTANCE_HIGH;
            NotificationChannel notificationChannel = new NotificationChannel(NOTIFICATION_CHANNEL_ID, "NOTIFICATION_CHANNEL_NAME", importance);
            mBuilder.setChannelId(NOTIFICATION_CHANNEL_ID);
            assert mNotificationManager != null;
            mNotificationManager.createNotificationChannel(notificationChannel);
        }
        assert mNotificationManager != null;
        mNotificationManager.notify((int) System.currentTimeMillis(), mBuilder.build());
    }

    protected PendingIntent getDeleteIntent() {
        Intent intent = new Intent(MainActivity.this, NotificationBroadcastReceiver.class);
        intent.setAction("notification_cancelled");
        return PendingIntent.getBroadcast(MainActivity.this, 0, intent, PendingIntent.FLAG_CANCEL_CURRENT);
    }
}

ステップ4：NotificationBroadcastReceiver.javaを作成する

次に、src/NotificationBroadcastReceiver.javaを作成し、以下のコードを追加します。この BroadcastReceiver が、通知が削除されたときにブロードキャストされるアクション「notification_cancelled」を受け取り、トーストでメッセージを表示します。

package app.tutorialspoint.com.notifyme;

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.widget.Toast;

public class NotificationBroadcastReceiver extends BroadcastReceiver {

    @Override
    public void onReceive(Context context, Intent intent) {
        String action = intent.getAction();
        if (action.equals("notification_cancelled")) {
            Toast.makeText(context, "Notification Removed", Toast.LENGTH_SHORT).show();
        }
    }
}

ステップ5：AndroidManifest.xmlにコードを追加する

最後に、AndroidManifest.xmlに作成したBroadcastReceiverを登録します。receiverタグ内に以下のように記述してください。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android"
    package="app.tutorialspoint.com.notifyme">

    <uses-permission android:name="android.permission.VIBRATE" />
    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">

        <receiver
            android:name=".NotificationBroadcastReceiver"
            android:enabled="true"
            android:exported="true">
        </receiver>

        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>

    </application>
</manifest>

アプリを実行して動作を確認しよう

それでは、アプリを実行してみましょう。実機のAndroidスマートフォンをPCに接続している状態で、Android StudioのツールバーからRunアイコンをクリックし、接続したデバイスを選択してアプリを起動します。

起動すると以下のような画面が表示されます。

ボタンをタップして通知を表示させたら、その通知をスワイプして削除してみてください。「Notification Removed」というトーストメッセージが表示されれば、deleteIntentによる削除検知が正常に動作しています。

まとめ

Notification.deleteIntentを使えば、ユーザーが通知を削除したタイミングを簡単に検知できます。通知の消去に合わせてリソースを解放したり、バッジカウントを更新したりと、さまざまな場面で活用できるので、ぜひ実装方法をマスターしておきましょう。